PHP Classes

File: vendor/jackbooted/3rdparty/PHPExcelCreator/Worksheet.php

Recommend this page to a friend!
  Classes of Brett Dutton   JackBooted PHP Framework   vendor/jackbooted/3rdparty/PHPExcelCreator/Worksheet.php   Download  
File: vendor/jackbooted/3rdparty/PHPExcelCreator/Worksheet.php
Role: Class source
Content type: text/plain
Description: Class source
Class: JackBooted PHP Framework
Web application framework using simplified MVC
Author: By
Last change:
Date: 8 years ago
Size: 112,169 bytes
 

Contents

Class file image Download
<?php /* * Module written/ported by Xavier Noguer <xnoguer@rezebra.com> * * The majority of this is _NOT_ my code. I simply ported it from the * PERL Spreadsheet::WriteExcel module. * * The author of the Spreadsheet::WriteExcel module is John McNamara * <jmcnamara@cpan.org> * * I _DO_ maintain this code, and John McNamara has nothing to do with the * porting of this code to PHP. Any questions directly related to this * class library should be directed to me. * * License Information: * * Spreadsheet_Excel_Writer: A library for generating Excel Spreadsheets * Copyright (c) 2002-2003 Xavier Noguer xnoguer@rezebra.com * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ require_once dirname ( __FILE__ ) . '/Parser.php'; require_once dirname ( __FILE__ ) . '/BIFFwriter.php'; /** * Class for generating Excel Spreadsheets * * @author Xavier Noguer <xnoguer@rezebra.com> * @category FileFormats * @package Spreadsheet_Excel_Writer */ class Spreadsheet_Excel_Writer_Worksheet extends Spreadsheet_Excel_Writer_BIFFwriter { /** * Name of the Worksheet * @var string */ var $name; /** * Index for the Worksheet * @var integer */ var $index; /** * Reference to the (default) Format object for URLs * @var object Format */ var $_url_format; /** * Reference to the parser used for parsing formulas * @var object Format */ var $_parser; /** * Filehandle to the temporary file for storing data * @var resource */ var $_filehandle; /** * Boolean indicating if we are using a temporary file for storing data * @var bool */ var $_using_tmpfile; /** * Maximum number of rows for an Excel spreadsheet (BIFF5) * @var integer */ var $_xls_rowmax; /** * Maximum number of columns for an Excel spreadsheet (BIFF5) * @var integer */ var $_xls_colmax; /** * Maximum number of characters for a string (LABEL record in BIFF5) * @var integer */ var $_xls_strmax; /** * First row for the DIMENSIONS record * @var integer * @see _storeDimensions() */ var $_dim_rowmin; /** * Last row for the DIMENSIONS record * @var integer * @see _storeDimensions() */ var $_dim_rowmax; /** * First column for the DIMENSIONS record * @var integer * @see _storeDimensions() */ var $_dim_colmin; /** * Last column for the DIMENSIONS record * @var integer * @see _storeDimensions() */ var $_dim_colmax; /** * Array containing format information for columns * @var array */ var $_colinfo; /** * Array containing the selected area for the worksheet * @var array */ var $_selection; /** * Array containing the panes for the worksheet * @var array */ var $_panes; /** * The active pane for the worksheet * @var integer */ var $_active_pane; /** * Bit specifying if panes are frozen * @var integer */ var $_frozen; /** * Bit specifying if the worksheet is selected * @var integer */ var $selected; /** * The paper size (for printing) (DOCUMENT!!!) * @var integer */ var $_paper_size; /** * Bit specifying paper orientation (for printing). 0 => landscape, 1 => portrait * @var integer */ var $_orientation; /** * The page header caption * @var string */ var $_header; /** * The page footer caption * @var string */ var $_footer; /** * The horizontal centering value for the page * @var integer */ var $_hcenter; /** * The vertical centering value for the page * @var integer */ var $_vcenter; /** * The margin for the header * @var float */ var $_margin_head; /** * The margin for the footer * @var float */ var $_margin_foot; /** * The left margin for the worksheet in inches * @var float */ var $_margin_left; /** * The right margin for the worksheet in inches * @var float */ var $_margin_right; /** * The top margin for the worksheet in inches * @var float */ var $_margin_top; /** * The bottom margin for the worksheet in inches * @var float */ var $_margin_bottom; /** * First row to reapeat on each printed page * @var integer */ var $title_rowmin; /** * Last row to reapeat on each printed page * @var integer */ var $title_rowmax; /** * First column to reapeat on each printed page * @var integer */ var $title_colmin; /** * First row of the area to print * @var integer */ var $print_rowmin; /** * Last row to of the area to print * @var integer */ var $print_rowmax; /** * First column of the area to print * @var integer */ var $print_colmin; /** * Last column of the area to print * @var integer */ var $print_colmax; /** * Whether to use outline. * @var integer */ var $_outline_on; /** * Auto outline styles. * @var bool */ var $_outline_style; /** * Whether to have outline summary below. * @var bool */ var $_outline_below; /** * Whether to have outline summary at the right. * @var bool */ var $_outline_right; /** * Outline row level. * @var integer */ var $_outline_row_level; /** * Whether to fit to page when printing or not. * @var bool */ var $_fit_page; /** * Number of pages to fit wide * @var integer */ var $_fit_width; /** * Number of pages to fit high * @var integer */ var $_fit_height; /** * Reference to the total number of strings in the workbook * @var integer */ var $_str_total; /** * Reference to the number of unique strings in the workbook * @var integer */ var $_str_unique; /** * Reference to the array containing all the unique strings in the workbook * @var array */ var $_str_table; /** * Merged cell ranges * @var array */ var $_merged_ranges; /** * Charset encoding currently used when calling writeString() * @var string */ var $_input_encoding; /** * Constructor * * @param string $name The name of the new worksheet * @param integer $index The index of the new worksheet * @param mixed &$activesheet The current activesheet of the workbook we belong to * @param mixed &$firstsheet The first worksheet in the workbook we belong to * @param mixed &$url_format The default format for hyperlinks * @param mixed &$parser The formula parser created for the Workbook * @access private */ function Spreadsheet_Excel_Writer_Worksheet($BIFF_version, $name, $index, &$activesheet, &$firstsheet, &$str_total, &$str_unique, &$str_table, &$url_format, &$parser) { // It needs to call its parent's constructor explicitly $this->Spreadsheet_Excel_Writer_BIFFwriter(); $this->_BIFF_version = $BIFF_version; $rowmax = 65536; // 16384 in Excel 5 $colmax = 256; $this->name = $name; $this->index = $index; $this->activesheet = &$activesheet; $this->firstsheet = &$firstsheet; $this->_str_total = &$str_total; $this->_str_unique = &$str_unique; $this->_str_table = &$str_table; $this->_url_format = &$url_format; $this->_parser = &$parser; //$this->ext_sheets = array(); $this->_filehandle = ''; $this->_using_tmpfile = true; //$this->fileclosed = 0; //$this->offset = 0; $this->_xls_rowmax = $rowmax; $this->_xls_colmax = $colmax; $this->_xls_strmax = 255; $this->_dim_rowmin = $rowmax + 1; $this->_dim_rowmax = 0; $this->_dim_colmin = $colmax + 1; $this->_dim_colmax = 0; $this->_colinfo = array(); $this->_selection = array(0,0,0,0); $this->_panes = array(); $this->_active_pane = 3; $this->_frozen = 0; $this->selected = 0; $this->_paper_size = 0x0; $this->_orientation = 0x1; $this->_header = ''; $this->_footer = ''; $this->_hcenter = 0; $this->_vcenter = 0; $this->_margin_head = 0.50; $this->_margin_foot = 0.50; $this->_margin_left = 0.75; $this->_margin_right = 0.75; $this->_margin_top = 1.00; $this->_margin_bottom = 1.00; $this->title_rowmin = null; $this->title_rowmax = null; $this->title_colmin = null; $this->title_colmax = null; $this->print_rowmin = null; $this->print_rowmax = null; $this->print_colmin = null; $this->print_colmax = null; $this->_print_gridlines = 1; $this->_screen_gridlines = 1; $this->_print_headers = 0; $this->_fit_page = 0; $this->_fit_width = 0; $this->_fit_height = 0; $this->_hbreaks = array(); $this->_vbreaks = array(); $this->_protect = 0; $this->_password = null; $this->col_sizes = array(); $this->_row_sizes = array(); $this->_zoom = 100; $this->_print_scale = 100; $this->_outline_row_level = 0; $this->_outline_style = 0; $this->_outline_below = 1; $this->_outline_right = 1; $this->_outline_on = 1; $this->_merged_ranges = array(); $this->_input_encoding = ''; $this->_dv = array(); $this->_initialize(); } /** * Open a tmp file to store the majority of the Worksheet data. If this fails, * for example due to write permissions, store the data in memory. This can be * slow for large files. * * @access private */ function _initialize() { // Open tmp file for storing Worksheet data $fh = tmpfile(); if ($fh) { // Store filehandle $this->_filehandle = $fh; } else { // If tmpfile() fails store data in memory $this->_using_tmpfile = false; } } /** * Add data to the beginning of the workbook (note the reverse order) * and to the end of the workbook. * * @access public * @see Spreadsheet_Excel_Writer_Workbook::storeWorkbook() * @param array $sheetnames The array of sheetnames from the Workbook this * worksheet belongs to */ function close($sheetnames) { $num_sheets = count($sheetnames); /*********************************************** * Prepend in reverse order!! */ // Prepend the sheet dimensions $this->_storeDimensions(); // Prepend the sheet password $this->_storePassword(); // Prepend the sheet protection $this->_storeProtect(); // Prepend the page setup $this->_storeSetup(); /* FIXME: margins are actually appended */ // Prepend the bottom margin $this->_storeMarginBottom(); // Prepend the top margin $this->_storeMarginTop(); // Prepend the right margin $this->_storeMarginRight(); // Prepend the left margin $this->_storeMarginLeft(); // Prepend the page vertical centering $this->_storeVcenter(); // Prepend the page horizontal centering $this->_storeHcenter(); // Prepend the page footer $this->_storeFooter(); // Prepend the page header $this->_storeHeader(); // Prepend the vertical page breaks $this->_storeVbreak(); // Prepend the horizontal page breaks $this->_storeHbreak(); // Prepend WSBOOL $this->_storeWsbool(); // Prepend GRIDSET $this->_storeGridset(); // Prepend GUTS if ($this->_BIFF_version == 0x0500) { $this->_storeGuts(); } // Prepend PRINTGRIDLINES $this->_storePrintGridlines(); // Prepend PRINTHEADERS $this->_storePrintHeaders(); // Prepend EXTERNSHEET references if ($this->_BIFF_version == 0x0500) { for ($i = $num_sheets; $i > 0; $i--) { $sheetname = $sheetnames[$i-1]; $this->_storeExternsheet($sheetname); } } // Prepend the EXTERNCOUNT of external references. if ($this->_BIFF_version == 0x0500) { $this->_storeExterncount($num_sheets); } // Prepend the COLINFO records if they exist if (!empty($this->_colinfo)) { $colcount = count($this->_colinfo); for ($i = 0; $i < $colcount; $i++) { $this->_storeColinfo($this->_colinfo[$i]); } $this->_storeDefcol(); } // Prepend the BOF record $this->_storeBof(0x0010); /* * End of prepend. Read upwards from here. ***********************************************/ // Append $this->_storeWindow2(); $this->_storeZoom(); if (!empty($this->_panes)) { $this->_storePanes($this->_panes); } $this->_storeSelection($this->_selection); $this->_storeMergedCells(); /* TODO: add data validity */ /*if ($this->_BIFF_version == 0x0600) { $this->_storeDataValidity(); }*/ $this->_storeEof(); } /** * Retrieve the worksheet name. * This is usefull when creating worksheets without a name. * * @access public * @return string The worksheet's name */ function getName() { return $this->name; } /** * Retrieves data from memory in one chunk, or from disk in $buffer * sized chunks. * * @return string The data */ function getData() { $buffer = 4096; // Return data stored in memory if (isset($this->_data)) { $tmp = $this->_data; unset($this->_data); $fh = $this->_filehandle; if ($this->_using_tmpfile) { fseek($fh, 0); } return $tmp; } // Return data stored on disk if ($this->_using_tmpfile) { if ($tmp = fread($this->_filehandle, $buffer)) { return $tmp; } } // No data to return return ''; } /** * Sets a merged cell range * * @access public * @param integer $first_row First row of the area to merge * @param integer $first_col First column of the area to merge * @param integer $last_row Last row of the area to merge * @param integer $last_col Last column of the area to merge */ function setMerge($first_row, $first_col, $last_row, $last_col) { if (($last_row < $first_row) || ($last_col < $first_col)) { return; } // don't check rowmin, rowmax, etc... because we don't know when this // is going to be called $this->_merged_ranges[] = array($first_row, $first_col, $last_row, $last_col); } /** * Set this worksheet as a selected worksheet, * i.e. the worksheet has its tab highlighted. * * @access public */ function select() { $this->selected = 1; } /** * Set this worksheet as the active worksheet, * i.e. the worksheet that is displayed when the workbook is opened. * Also set it as selected. * * @access public */ function activate() { $this->selected = 1; $this->activesheet = $this->index; } /** * Set this worksheet as the first visible sheet. * This is necessary when there are a large number of worksheets and the * activated worksheet is not visible on the screen. * * @access public */ function setFirstSheet() { $this->firstsheet = $this->index; } /** * Set the worksheet protection flag * to prevent accidental modification and to * hide formulas if the locked and hidden format properties have been set. * * @access public * @param string $password The password to use for protecting the sheet. */ function protect($password) { $this->_protect = 1; $this->_password = $this->_encodePassword($password); } /** * Set the width of a single column or a range of columns. * * @access public * @param integer $firstcol first column on the range * @param integer $lastcol last column on the range * @param integer $width width to set * @param mixed $format The optional XF format to apply to the columns * @param integer $hidden The optional hidden atribute * @param integer $level The optional outline level */ function setColumn($firstcol, $lastcol, $width, $format = null, $hidden = 0, $level = 0) { $this->_colinfo[] = array($firstcol, $lastcol, $width, &$format, $hidden, $level); // Set width to zero if column is hidden $width = ($hidden) ? 0 : $width; for ($col = $firstcol; $col <= $lastcol; $col++) { $this->col_sizes[$col] = $width; } } /** * Set which cell or cells are selected in a worksheet * * @access public * @param integer $first_row first row in the selected quadrant * @param integer $first_column first column in the selected quadrant * @param integer $last_row last row in the selected quadrant * @param integer $last_column last column in the selected quadrant */ function setSelection($first_row,$first_column,$last_row,$last_column) { $this->_selection = array($first_row,$first_column,$last_row,$last_column); } /** * Set panes and mark them as frozen. * * @access public * @param array $panes This is the only parameter received and is composed of the following: * 0 => Vertical split position, * 1 => Horizontal split position * 2 => Top row visible * 3 => Leftmost column visible * 4 => Active pane */ function freezePanes($panes) { $this->_frozen = 1; $this->_panes = $panes; } /** * Set panes and mark them as unfrozen. * * @access public * @param array $panes This is the only parameter received and is composed of the following: * 0 => Vertical split position, * 1 => Horizontal split position * 2 => Top row visible * 3 => Leftmost column visible * 4 => Active pane */ function thawPanes($panes) { $this->_frozen = 0; $this->_panes = $panes; } /** * Set the page orientation as portrait. * * @access public */ function setPortrait() { $this->_orientation = 1; } /** * Set the page orientation as landscape. * * @access public */ function setLandscape() { $this->_orientation = 0; } /** * Set the paper type. Ex. 1 = US Letter, 9 = A4 * * @access public * @param integer $size The type of paper size to use */ function setPaper($size = 0) { $this->_paper_size = $size; } /** * Set the page header caption and optional margin. * * @access public * @param string $string The header text * @param float $margin optional head margin in inches. */ function setHeader($string,$margin = 0.50) { if (strlen($string) >= 255) { //carp 'Header string must be less than 255 characters'; return; } $this->_header = $string; $this->_margin_head = $margin; } /** * Set the page footer caption and optional margin. * * @access public * @param string $string The footer text * @param float $margin optional foot margin in inches. */ function setFooter($string,$margin = 0.50) { if (strlen($string) >= 255) { //carp 'Footer string must be less than 255 characters'; return; } $this->_footer = $string; $this->_margin_foot = $margin; } /** * Center the page horinzontally. * * @access public * @param integer $center the optional value for centering. Defaults to 1 (center). */ function centerHorizontally($center = 1) { $this->_hcenter = $center; } /** * Center the page vertically. * * @access public * @param integer $center the optional value for centering. Defaults to 1 (center). */ function centerVertically($center = 1) { $this->_vcenter = $center; } /** * Set all the page margins to the same value in inches. * * @access public * @param float $margin The margin to set in inches */ function setMargins($margin) { $this->setMarginLeft($margin); $this->setMarginRight($margin); $this->setMarginTop($margin); $this->setMarginBottom($margin); } /** * Set the left and right margins to the same value in inches. * * @access public * @param float $margin The margin to set in inches */ function setMargins_LR($margin) { $this->setMarginLeft($margin); $this->setMarginRight($margin); } /** * Set the top and bottom margins to the same value in inches. * * @access public * @param float $margin The margin to set in inches */ function setMargins_TB($margin) { $this->setMarginTop($margin); $this->setMarginBottom($margin); } /** * Set the left margin in inches. * * @access public * @param float $margin The margin to set in inches */ function setMarginLeft($margin = 0.75) { $this->_margin_left = $margin; } /** * Set the right margin in inches. * * @access public * @param float $margin The margin to set in inches */ function setMarginRight($margin = 0.75) { $this->_margin_right = $margin; } /** * Set the top margin in inches. * * @access public * @param float $margin The margin to set in inches */ function setMarginTop($margin = 1.00) { $this->_margin_top = $margin; } /** * Set the bottom margin in inches. * * @access public * @param float $margin The margin to set in inches */ function setMarginBottom($margin = 1.00) { $this->_margin_bottom = $margin; } /** * Set the rows to repeat at the top of each printed page. * * @access public * @param integer $first_row First row to repeat * @param integer $last_row Last row to repeat. Optional. */ function repeatRows($first_row, $last_row = null) { $this->title_rowmin = $first_row; if (isset($last_row)) { //Second row is optional $this->title_rowmax = $last_row; } else { $this->title_rowmax = $first_row; } } /** * Set the columns to repeat at the left hand side of each printed page. * * @access public * @param integer $first_col First column to repeat * @param integer $last_col Last column to repeat. Optional. */ function repeatColumns($first_col, $last_col = null) { $this->title_colmin = $first_col; if (isset($last_col)) { // Second col is optional $this->title_colmax = $last_col; } else { $this->title_colmax = $first_col; } } /** * Set the area of each worksheet that will be printed. * * @access public * @param integer $first_row First row of the area to print * @param integer $first_col First column of the area to print * @param integer $last_row Last row of the area to print * @param integer $last_col Last column of the area to print */ function printArea($first_row, $first_col, $last_row, $last_col) { $this->print_rowmin = $first_row; $this->print_colmin = $first_col; $this->print_rowmax = $last_row; $this->print_colmax = $last_col; } /** * Set the option to hide gridlines on the printed page. * * @access public */ function hideGridlines() { $this->_print_gridlines = 0; } /** * Set the option to hide gridlines on the worksheet (as seen on the screen). * * @access public */ function hideScreenGridlines() { $this->_screen_gridlines = 0; } /** * Set the option to print the row and column headers on the printed page. * * @access public * @param integer $print Whether to print the headers or not. Defaults to 1 (print). */ function printRowColHeaders($print = 1) { $this->_print_headers = $print; } /** * Set the vertical and horizontal number of pages that will define the maximum area printed. * It doesn't seem to work with OpenOffice. * * @access public * @param integer $width Maximun width of printed area in pages * @param integer $height Maximun heigth of printed area in pages * @see setPrintScale() */ function fitToPages($width, $height) { $this->_fit_page = 1; $this->_fit_width = $width; $this->_fit_height = $height; } /** * Store the horizontal page breaks on a worksheet (for printing). * The breaks represent the row after which the break is inserted. * * @access public * @param array $breaks Array containing the horizontal page breaks */ function setHPagebreaks($breaks) { foreach ($breaks as $break) { array_push($this->_hbreaks, $break); } } /** * Store the vertical page breaks on a worksheet (for printing). * The breaks represent the column after which the break is inserted. * * @access public * @param array $breaks Array containing the vertical page breaks */ function setVPagebreaks($breaks) { foreach ($breaks as $break) { array_push($this->_vbreaks, $break); } } /** * Set the worksheet zoom factor. * * @access public * @param integer $scale The zoom factor */ function setZoom($scale = 100) { // Confine the scale to Excel's range if ($scale < 10 || $scale > 400) { $this->raiseError("Zoom factor $scale outside range: 10 <= zoom <= 400"); $scale = 100; } $this->_zoom = floor($scale); } /** * Set the scale factor for the printed page. * It turns off the "fit to page" option * * @access public * @param integer $scale The optional scale factor. Defaults to 100 */ function setPrintScale($scale = 100) { // Confine the scale to Excel's range if ($scale < 10 || $scale > 400) { $this->raiseError("Print scale $scale outside range: 10 <= zoom <= 400"); $scale = 100; } // Turn off "fit to page" option $this->_fit_page = 0; $this->_print_scale = floor($scale); } /** * Map to the appropriate write method acording to the token recieved. * * @access public * @param integer $row The row of the cell we are writing to * @param integer $col The column of the cell we are writing to * @param mixed $token What we are writing * @param mixed $format The optional format to apply to the cell */ function write($row, $col, $token, $format = null) { // Check for a cell reference in A1 notation and substitute row and column /*if ($_[0] =~ /^\D/) { @_ = $this->_substituteCellref(@_); }*/ if (preg_match("/^([+-]?)(?=\d|\.\d)\d*(\.\d*)?([Ee]([+-]?\d+))?$/", $token)) { // Match number return $this->writeNumber($row, $col, $token, $format); } elseif (preg_match("/^[fh]tt?p:\/\//", $token)) { // Match http or ftp URL return $this->writeUrl($row, $col, $token, '', $format); } elseif (preg_match("/^mailto:/", $token)) { // Match mailto: return $this->writeUrl($row, $col, $token, '', $format); } elseif (preg_match("/^(?:in|ex)ternal:/", $token)) { // Match internal or external sheet link return $this->writeUrl($row, $col, $token, '', $format); } elseif (preg_match("/^=/", $token)) { // Match formula return $this->writeFormula($row, $col, $token, $format); } elseif (preg_match("/^@/", $token)) { // Match formula return $this->writeFormula($row, $col, $token, $format); } elseif ($token == '') { // Match blank return $this->writeBlank($row, $col, $format); } else { // Default: match string return $this->writeString($row, $col, $token, $format); } } /** * Write an array of values as a row * * @access public * @param integer $row The row we are writing to * @param integer $col The first col (leftmost col) we are writing to * @param array $val The array of values to write * @param mixed $format The optional format to apply to the cell * @return mixed PEAR_Error on failure */ function writeRow($row, $col, $val, $format = null) { $retval = ''; if (is_array($val)) { foreach ($val as $v) { if (is_array($v)) { $this->writeCol($row, $col, $v, $format); } else { $this->write($row, $col, $v, $format); } $col++; } } else { $retval = new PEAR_Error('$val needs to be an array'); } return($retval); } /** * Write an array of values as a column * * @access public * @param integer $row The first row (uppermost row) we are writing to * @param integer $col The col we are writing to * @param array $val The array of values to write * @param mixed $format The optional format to apply to the cell * @return mixed PEAR_Error on failure */ function writeCol($row, $col, $val, $format = null) { $retval = ''; if (is_array($val)) { foreach ($val as $v) { $this->write($row, $col, $v, $format); $row++; } } else { $retval = new PEAR_Error('$val needs to be an array'); } return($retval); } /** * Returns an index to the XF record in the workbook * * @access private * @param mixed &$format The optional XF format * @return integer The XF record index */ function _XF(&$format) { if ($format) { return($format->getXfIndex()); } else { return(0x0F); } } /****************************************************************************** ******************************************************************************* * * Internal methods */ /** * Store Worksheet data in memory using the parent's class append() or to a * temporary file, the default. * * @access private * @param string $data The binary data to append */ function _append($data) { if ($this->_using_tmpfile) { // Add CONTINUE records if necessary if (strlen($data) > $this->_limit) { $data = $this->_addContinue($data); } fwrite($this->_filehandle, $data); $this->_datasize += strlen($data); } else { parent::_append($data); } } /** * Substitute an Excel cell reference in A1 notation for zero based row and * column values in an argument list. * * Ex: ("A4", "Hello") is converted to (3, 0, "Hello"). * * @access private * @param string $cell The cell reference. Or range of cells. * @return array */ function _substituteCellref($cell) { $cell = strtoupper($cell); // Convert a column range: 'A:A' or 'B:G' if (preg_match("/([A-I]?[A-Z]):([A-I]?[A-Z])/", $cell, $match)) { list($no_use, $col1) = $this->_cellToRowcol($match[1] .'1'); // Add a dummy row list($no_use, $col2) = $this->_cellToRowcol($match[2] .'1'); // Add a dummy row return(array($col1, $col2)); } // Convert a cell range: 'A1:B7' if (preg_match("/\$?([A-I]?[A-Z]\$?\d+):\$?([A-I]?[A-Z]\$?\d+)/", $cell, $match)) { list($row1, $col1) = $this->_cellToRowcol($match[1]); list($row2, $col2) = $this->_cellToRowcol($match[2]); return(array($row1, $col1, $row2, $col2)); } // Convert a cell reference: 'A1' or 'AD2000' if (preg_match("/\$?([A-I]?[A-Z]\$?\d+)/", $cell)) { list($row1, $col1) = $this->_cellToRowcol($match[1]); return(array($row1, $col1)); } // TODO use real error codes $this->raiseError("Unknown cell reference $cell", 0, PEAR_ERROR_DIE); } /** * Convert an Excel cell reference in A1 notation to a zero based row and column * reference; converts C1 to (0, 2). * * @access private * @param string $cell The cell reference. * @return array containing (row, column) */ function _cellToRowcol($cell) { preg_match("/\$?([A-I]?[A-Z])\$?(\d+)/",$cell,$match); $col = $match[1]; $row = $match[2]; // Convert base26 column string to number $chars = split('', $col); $expn = 0; $col = 0; while ($chars) { $char = array_pop($chars); // LS char first $col += (ord($char) -ord('A') +1) * pow(26,$expn); $expn++; } // Convert 1-index to zero-index $row--; $col--; return(array($row, $col)); } /** * Based on the algorithm provided by Daniel Rentz of OpenOffice. * * @access private * @param string $plaintext The password to be encoded in plaintext. * @return string The encoded password */ function _encodePassword($plaintext) { $password = 0x0000; $i = 1; // char position // split the plain text password in its component characters $chars = preg_split('//', $plaintext, -1, PREG_SPLIT_NO_EMPTY); foreach ($chars as $char) { $value = ord($char) << $i; // shifted ASCII value $rotated_bits = $value >> 15; // rotated bits beyond bit 15 $value &= 0x7fff; // first 15 bits $password ^= ($value | $rotated_bits); $i++; } $password ^= strlen($plaintext); $password ^= 0xCE4B; return($password); } /** * This method sets the properties for outlining and grouping. The defaults * correspond to Excel's defaults. * * @param bool $visible * @param bool $symbols_below * @param bool $symbols_right * @param bool $auto_style */ function setOutline($visible = true, $symbols_below = true, $symbols_right = true, $auto_style = false) { $this->_outline_on = $visible; $this->_outline_below = $symbols_below; $this->_outline_right = $symbols_right; $this->_outline_style = $auto_style; // Ensure this is a boolean vale for Window2 if ($this->_outline_on) { $this->_outline_on = 1; } } /****************************************************************************** ******************************************************************************* * * BIFF RECORDS */ /** * Write a double to the specified row and column (zero indexed). * An integer can be written as a double. Excel will display an * integer. $format is optional. * * Returns 0 : normal termination * -2 : row or column out of range * * @access public * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @param float $num The number to write * @param mixed $format The optional XF format * @return integer */ function writeNumber($row, $col, $num, $format = null) { $record = 0x0203; // Record identifier $length = 0x000E; // Number of bytes to follow $xf = $this->_XF($format); // The cell format // Check that row and col are valid and store max and min values if ($row >= $this->_xls_rowmax) { return(-2); } if ($col >= $this->_xls_colmax) { return(-2); } if ($row < $this->_dim_rowmin) { $this->_dim_rowmin = $row; } if ($row > $this->_dim_rowmax) { $this->_dim_rowmax = $row; } if ($col < $this->_dim_colmin) { $this->_dim_colmin = $col; } if ($col > $this->_dim_colmax) { $this->_dim_colmax = $col; } $header = pack("vv", $record, $length); $data = pack("vvv", $row, $col, $xf); $xl_double = pack("d", $num); if ($this->_byte_order) { // if it's Big Endian $xl_double = strrev($xl_double); } $this->_append($header.$data.$xl_double); return(0); } /** * Write a string to the specified row and column (zero indexed). * NOTE: there is an Excel 5 defined limit of 255 characters. * $format is optional. * Returns 0 : normal termination * -2 : row or column out of range * -3 : long string truncated to 255 chars * * @access public * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @param string $str The string to write * @param mixed $format The XF format for the cell * @return integer */ function writeString($row, $col, $str, $format = null) { if ($this->_BIFF_version == 0x0600) { return $this->writeStringBIFF8($row, $col, $str, $format); } $strlen = strlen($str); $record = 0x0204; // Record identifier $length = 0x0008 + $strlen; // Bytes to follow $xf = $this->_XF($format); // The cell format $str_error = 0; // Check that row and col are valid and store max and min values if ($row >= $this->_xls_rowmax) { return(-2); } if ($col >= $this->_xls_colmax) { return(-2); } if ($row < $this->_dim_rowmin) { $this->_dim_rowmin = $row; } if ($row > $this->_dim_rowmax) { $this->_dim_rowmax = $row; } if ($col < $this->_dim_colmin) { $this->_dim_colmin = $col; } if ($col > $this->_dim_colmax) { $this->_dim_colmax = $col; } if ($strlen > $this->_xls_strmax) { // LABEL must be < 255 chars $str = substr($str, 0, $this->_xls_strmax); $length = 0x0008 + $this->_xls_strmax; $strlen = $this->_xls_strmax; $str_error = -3; } $header = pack("vv", $record, $length); $data = pack("vvvv", $row, $col, $xf, $strlen); $this->_append($header . $data . $str); return($str_error); } /** * Sets Input Encoding for writing strings * * @access public * @param string $encoding The encoding. Ex: 'UTF-16LE', 'utf-8', 'ISO-859-7' */ function setInputEncoding($encoding) { if ($encoding != 'UTF-16LE' && !function_exists('iconv')) { $this->raiseError("Using an input encoding other than UTF-16LE requires PHP support for iconv"); } $this->_input_encoding = $encoding; } /** * Write a string to the specified row and column (zero indexed). * This is the BIFF8 version (no 255 chars limit). * $format is optional. * Returns 0 : normal termination * -2 : row or column out of range * -3 : long string truncated to 255 chars * * @access public * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @param string $str The string to write * @param mixed $format The XF format for the cell * @return integer */ function writeStringBIFF8($row, $col, $str, $format = null) { if ($this->_input_encoding == 'UTF-16LE') { $strlen = function_exists('mb_strlen') ? mb_strlen($str, 'UTF-16LE') : (strlen($str) / 2); $encoding = 0x1; } elseif ($this->_input_encoding != '') { $str = iconv($this->_input_encoding, 'UTF-16LE', $str); $strlen = function_exists('mb_strlen') ? mb_strlen($str, 'UTF-16LE') : (strlen($str) / 2); $encoding = 0x1; } else { $strlen = strlen($str); $encoding = 0x0; } $record = 0x00FD; // Record identifier $length = 0x000A; // Bytes to follow $xf = $this->_XF($format); // The cell format $str_error = 0; // Check that row and col are valid and store max and min values if ($this->_checkRowCol($row, $col) == false) { return -2; } $str = pack('vC', $strlen, $encoding).$str; /* check if string is already present */ if (!isset($this->_str_table[$str])) { $this->_str_table[$str] = $this->_str_unique++; } $this->_str_total++; $header = pack('vv', $record, $length); $data = pack('vvvV', $row, $col, $xf, $this->_str_table[$str]); $this->_append($header.$data); return $str_error; } /** * Check row and col before writing to a cell, and update the sheet's * dimensions accordingly * * @access private * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @return boolean true for success, false if row and/or col are grester * then maximums allowed. */ function _checkRowCol($row, $col) { if ($row >= $this->_xls_rowmax) { return false; } if ($col >= $this->_xls_colmax) { return false; } if ($row < $this->_dim_rowmin) { $this->_dim_rowmin = $row; } if ($row > $this->_dim_rowmax) { $this->_dim_rowmax = $row; } if ($col < $this->_dim_colmin) { $this->_dim_colmin = $col; } if ($col > $this->_dim_colmax) { $this->_dim_colmax = $col; } return true; } /** * Writes a note associated with the cell given by the row and column. * NOTE records don't have a length limit. * * @access public * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @param string $note The note to write */ function writeNote($row, $col, $note) { $note_length = strlen($note); $record = 0x001C; // Record identifier $max_length = 2048; // Maximun length for a NOTE record //$length = 0x0006 + $note_length; // Bytes to follow // Check that row and col are valid and store max and min values if ($row >= $this->_xls_rowmax) { return(-2); } if ($col >= $this->_xls_colmax) { return(-2); } if ($row < $this->_dim_rowmin) { $this->_dim_rowmin = $row; } if ($row > $this->_dim_rowmax) { $this->_dim_rowmax = $row; } if ($col < $this->_dim_colmin) { $this->_dim_colmin = $col; } if ($col > $this->_dim_colmax) { $this->_dim_colmax = $col; } // Length for this record is no more than 2048 + 6 $length = 0x0006 + min($note_length, 2048); $header = pack("vv", $record, $length); $data = pack("vvv", $row, $col, $note_length); $this->_append($header . $data . substr($note, 0, 2048)); for ($i = $max_length; $i < $note_length; $i += $max_length) { $chunk = substr($note, $i, $max_length); $length = 0x0006 + strlen($chunk); $header = pack("vv", $record, $length); $data = pack("vvv", -1, 0, strlen($chunk)); $this->_append($header.$data.$chunk); } return(0); } /** * Write a blank cell to the specified row and column (zero indexed). * A blank cell is used to specify formatting without adding a string * or a number. * * A blank cell without a format serves no purpose. Therefore, we don't write * a BLANK record unless a format is specified. * * Returns 0 : normal termination (including no format) * -1 : insufficient number of arguments * -2 : row or column out of range * * @access public * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @param mixed $format The XF format */ function writeBlank($row, $col, $format) { // Don't write a blank cell unless it has a format if (!$format) { return(0); } $record = 0x0201; // Record identifier $length = 0x0006; // Number of bytes to follow $xf = $this->_XF($format); // The cell format // Check that row and col are valid and store max and min values if ($row >= $this->_xls_rowmax) { return(-2); } if ($col >= $this->_xls_colmax) { return(-2); } if ($row < $this->_dim_rowmin) { $this->_dim_rowmin = $row; } if ($row > $this->_dim_rowmax) { $this->_dim_rowmax = $row; } if ($col < $this->_dim_colmin) { $this->_dim_colmin = $col; } if ($col > $this->_dim_colmax) { $this->_dim_colmax = $col; } $header = pack("vv", $record, $length); $data = pack("vvv", $row, $col, $xf); $this->_append($header . $data); return 0; } /** * Write a formula to the specified row and column (zero indexed). * The textual representation of the formula is passed to the parser in * Parser.php which returns a packed binary string. * * Returns 0 : normal termination * -1 : formula errors (bad formula) * -2 : row or column out of range * * @access public * @param integer $row Zero indexed row * @param integer $col Zero indexed column * @param string $formula The formula text string * @param mixed $format The optional XF format * @return integer */ function writeFormula($row, $col, $formula, $format = null) { $record = 0x0006; // Record identifier // Excel normally stores the last calculated value of the formula in $num. // Clearly we are not in a position to calculate this a priori. Instead // we set $num to zero and set the option flags in $grbit to ensure // automatic calculation of the formula when the file is opened. // $xf = $this->_XF($format); // The cell format $num = 0x00; // Current value of formula $grbit = 0x03; // Option flags $unknown = 0x0000; // Must be zero // Check that row and col are valid and store max and min values if ($this->_checkRowCol($row, $col) == false) { return -2; } // Strip the '=' or '@' sign at the beginning of the formula string if (preg_match("/^=/", $formula)) { $formula = preg_replace("/(^=)/", "", $formula); } elseif (preg_match("/^@/", $formula)) { $formula = preg_replace("/(^@)/", "", $formula); } else { // Error handling $this->writeString($row, $col, 'Unrecognised character for formula'); return -1; } // Parse the formula using the parser in Parser.php $error = $this->_parser->parse($formula); if ($this->isError($error)) { $this->writeString($row, $col, $error->getMessage()); return -1; } $formula = $this->_parser->toReversePolish(); if ($this->isError($formula)) { $this->writeString($row, $col, $formula->getMessage()); return -1; } $formlen = strlen($formula); // Length of the binary string $length = 0x16 + $formlen; // Length of the record data $header = pack("vv", $record, $length); $data = pack("vvvdvVv", $row, $col, $xf, $num, $grbit, $unknown, $formlen); $this->_append($header . $data . $formula); return 0; } /** * Write a hyperlink. * This is comprised of two elements: the visible label and * the invisible link. The visible label is the same as the link unless an * alternative string is specified. The label is written using the * writeString() method. Therefore the 255 characters string limit applies. * $string and $format are optional. * * The hyperlink can be to a http, ftp, mail, internal sheet (not yet), or external * directory url. * * Returns 0 : normal termination * -2 : row or column out of range * -3 : long string truncated to 255 chars * * @access public * @param integer $row Row * @param integer $col Column * @param string $url URL string * @param string $string Alternative label * @param mixed $format The cell format * @return integer */ function writeUrl($row, $col, $url, $string = '', $format = null) { // Add start row and col to arg list return($this->_writeUrlRange($row, $col, $row, $col, $url, $string, $format)); } /** * This is the more general form of writeUrl(). It allows a hyperlink to be * written to a range of cells. This function also decides the type of hyperlink * to be written. These are either, Web (http, ftp, mailto), Internal * (Sheet1!A1) or external ('c:\temp\foo.xls#Sheet1!A1'). * * @access private * @see writeUrl() * @param integer $row1 Start row * @param integer $col1 Start column * @param integer $row2 End row * @param integer $col2 End column * @param string $url URL string * @param string $string Alternative label * @param mixed $format The cell format * @return integer */ function _writeUrlRange($row1, $col1, $row2, $col2, $url, $string = '', $format = null) { // Check for internal/external sheet links or default to web link if (preg_match('[^internal:]', $url)) { return($this->_writeUrlInternal($row1, $col1, $row2, $col2, $url, $string, $format)); } if (preg_match('[^external:]', $url)) { return($this->_writeUrlExternal($row1, $col1, $row2, $col2, $url, $string, $format)); } return($this->_writeUrlWeb($row1, $col1, $row2, $col2, $url, $string, $format)); } /** * Used to write http, ftp and mailto hyperlinks. * The link type ($options) is 0x03 is the same as absolute dir ref without * sheet. However it is differentiated by the $unknown2 data stream. * * @access private * @see writeUrl() * @param integer $row1 Start row * @param integer $col1 Start column * @param integer $row2 End row * @param integer $col2 End column * @param string $url URL string * @param string $str Alternative label * @param mixed $format The cell format * @return integer */ function _writeUrlWeb($row1, $col1, $row2, $col2, $url, $str, $format = null) { $record = 0x01B8; // Record identifier $length = 0x00000; // Bytes to follow if (!$format) { $format = $this->_url_format; } // Write the visible label using the writeString() method. if ($str == '') { $str = $url; } $str_error = $this->writeString($row1, $col1, $str, $format); if (($str_error == -2) || ($str_error == -3)) { return $str_error; } // Pack the undocumented parts of the hyperlink stream $unknown1 = pack("H*", "D0C9EA79F9BACE118C8200AA004BA90B02000000"); $unknown2 = pack("H*", "E0C9EA79F9BACE118C8200AA004BA90B"); // Pack the option flags $options = pack("V", 0x03); // Convert URL to a null terminated wchar string $url = join("\0", preg_split("''", $url, -1, PREG_SPLIT_NO_EMPTY)); $url = $url . "\0\0\0"; // Pack the length of the URL $url_len = pack("V", strlen($url)); // Calculate the data length $length = 0x34 + strlen($url); // Pack the header data $header = pack("vv", $record, $length); $data = pack("vvvv", $row1, $row2, $col1, $col2); // Write the packed data $this->_append($header . $data . $unknown1 . $options . $unknown2 . $url_len . $url); return($str_error); } /** * Used to write internal reference hyperlinks such as "Sheet1!A1". * * @access private * @see writeUrl() * @param integer $row1 Start row * @param integer $col1 Start column * @param integer $row2 End row * @param integer $col2 End column * @param string $url URL string * @param string $str Alternative label * @param mixed $format The cell format * @return integer */ function _writeUrlInternal($row1, $col1, $row2, $col2, $url, $str, $format = null) { $record = 0x01B8; // Record identifier $length = 0x00000; // Bytes to follow if (!$format) { $format = $this->_url_format; } // Strip URL type $url = preg_replace('/^internal:/', '', $url); // Write the visible label if ($str == '') { $str = $url; } $str_error = $this->writeString($row1, $col1, $str, $format); if (($str_error == -2) || ($str_error == -3)) { return $str_error; } // Pack the undocumented parts of the hyperlink stream $unknown1 = pack("H*", "D0C9EA79F9BACE118C8200AA004BA90B02000000"); // Pack the option flags $options = pack("V", 0x08); // Convert the URL type and to a null terminated wchar string $url = join("\0", preg_split("''", $url, -1, PREG_SPLIT_NO_EMPTY)); $url = $url . "\0\0\0"; // Pack the length of the URL as chars (not wchars) $url_len = pack("V", floor(strlen($url)/2)); // Calculate the data length $length = 0x24 + strlen($url); // Pack the header data $header = pack("vv", $record, $length); $data = pack("vvvv", $row1, $row2, $col1, $col2); // Write the packed data $this->_append($header . $data . $unknown1 . $options . $url_len . $url); return($str_error); } /** * Write links to external directory names such as 'c:\foo.xls', * c:\foo.xls#Sheet1!A1', '../../foo.xls'. and '../../foo.xls#Sheet1!A1'. * * Note: Excel writes some relative links with the $dir_long string. We ignore * these cases for the sake of simpler code. * * @access private * @see writeUrl() * @param integer $row1 Start row * @param integer $col1 Start column * @param integer $row2 End row * @param integer $col2 End column * @param string $url URL string * @param string $str Alternative label * @param mixed $format The cell format * @return integer */ function _writeUrlExternal($row1, $col1, $row2, $col2, $url, $str, $format = null) { // Network drives are different. We will handle them separately // MS/Novell network drives and shares start with \\ if (preg_match('[^external:\\\\]', $url)) { return; //($this->_writeUrlExternal_net($row1, $col1, $row2, $col2, $url, $str, $format)); } $record = 0x01B8; // Record identifier $length = 0x00000; // Bytes to follow if (!$format) { $format = $this->_url_format; } // Strip URL type and change Unix dir separator to Dos style (if needed) // $url = preg_replace('/^external:/', '', $url); $url = preg_replace('/\//', "\\", $url); // Write the visible label if ($str == '') { $str = preg_replace('/\#/', ' - ', $url); } $str_error = $this->writeString($row1, $col1, $str, $format); if (($str_error == -2) or ($str_error == -3)) { return $str_error; } // Determine if the link is relative or absolute: // relative if link contains no dir separator, "somefile.xls" // relative if link starts with up-dir, "..\..\somefile.xls" // otherwise, absolute $absolute = 0x02; // Bit mask if (!preg_match("/\\\/", $url)) { $absolute = 0x00; } if (preg_match("/^\.\.\\\/", $url)) { $absolute = 0x00; } $link_type = 0x01 | $absolute; // Determine if the link contains a sheet reference and change some of the // parameters accordingly. // Split the dir name and sheet name (if it exists) /*if (preg_match("/\#/", $url)) { list($dir_long, $sheet) = split("\#", $url); } else { $dir_long = $url; } if (isset($sheet)) { $link_type |= 0x08; $sheet_len = pack("V", strlen($sheet) + 0x01); $sheet = join("\0", split('', $sheet)); $sheet .= "\0\0\0"; } else { $sheet_len = ''; $sheet = ''; }*/ $dir_long = $url; if (preg_match("/\#/", $url)) { $link_type |= 0x08; } // Pack the link type $link_type = pack("V", $link_type); // Calculate the up-level dir count e.g.. (..\..\..\ == 3) $up_count = preg_match_all("/\.\.\\\/", $dir_long, $useless); $up_count = pack("v", $up_count); // Store the short dos dir name (null terminated) $dir_short = preg_replace("/\.\.\\\/", '', $dir_long) . "\0"; // Store the long dir name as a wchar string (non-null terminated) //$dir_long = join("\0", split('', $dir_long)); $dir_long = $dir_long . "\0"; // Pack the lengths of the dir strings $dir_short_len = pack("V", strlen($dir_short) ); $dir_long_len = pack("V", strlen($dir_long) ); $stream_len = pack("V", 0);//strlen($dir_long) + 0x06); // Pack the undocumented parts of the hyperlink stream $unknown1 = pack("H*",'D0C9EA79F9BACE118C8200AA004BA90B02000000' ); $unknown2 = pack("H*",'0303000000000000C000000000000046' ); $unknown3 = pack("H*",'FFFFADDE000000000000000000000000000000000000000'); $unknown4 = pack("v", 0x03 ); // Pack the main data stream $data = pack("vvvv", $row1, $row2, $col1, $col2) . $unknown1 . $link_type . $unknown2 . $up_count . $dir_short_len. $dir_short . $unknown3 . $stream_len ;/*. $dir_long_len . $unknown4 . $dir_long . $sheet_len . $sheet ;*/ // Pack the header data $length = strlen($data); $header = pack("vv", $record, $length); // Write the packed data $this->_append($header. $data); return($str_error); } /** * This method is used to set the height and format for a row. * * @access public * @param integer $row The row to set * @param integer $height Height we are giving to the row. * Use null to set XF without setting height * @param mixed $format XF format we are giving to the row * @param bool $hidden The optional hidden attribute * @param integer $level The optional outline level for row, in range [0,7] */ function setRow($row, $height, $format = null, $hidden = false, $level = 0) { $record = 0x0208; // Record identifier $length = 0x0010; // Number of bytes to follow $colMic = 0x0000; // First defined column $colMac = 0x0000; // Last defined column $irwMac = 0x0000; // Used by Excel to optimise loading $reserved = 0x0000; // Reserved $grbit = 0x0000; // Option flags $ixfe = $this->_XF($format); // XF index // set _row_sizes so _sizeRow() can use it $this->_row_sizes[$row] = $height; // Use setRow($row, null, $XF) to set XF format without setting height if ($height != null) { $miyRw = $height * 20; // row height } else { $miyRw = 0xff; // default row height is 256 } $level = max(0, min($level, 7)); // level should be between 0 and 7 $this->_outline_row_level = max($level, $this->_outline_row_level); // Set the options flags. fUnsynced is used to show that the font and row // heights are not compatible. This is usually the case for WriteExcel. // The collapsed flag 0x10 doesn't seem to be used to indicate that a row // is collapsed. Instead it is used to indicate that the previous row is // collapsed. The zero height flag, 0x20, is used to collapse a row. $grbit |= $level; if ($hidden) { $grbit |= 0x0020; } $grbit |= 0x0040; // fUnsynced if ($format) { $grbit |= 0x0080; } $grbit |= 0x0100; $header = pack("vv", $record, $length); $data = pack("vvvvvvvv", $row, $colMic, $colMac, $miyRw, $irwMac,$reserved, $grbit, $ixfe); $this->_append($header.$data); } /** * Writes Excel DIMENSIONS to define the area in which there is data. * * @access private */ function _storeDimensions() { $record = 0x0200; // Record identifier $row_min = $this->_dim_rowmin; // First row $row_max = $this->_dim_rowmax + 1; // Last row plus 1 $col_min = $this->_dim_colmin; // First column $col_max = $this->_dim_colmax + 1; // Last column plus 1 $reserved = 0x0000; // Reserved by Excel if ($this->_BIFF_version == 0x0500) { $length = 0x000A; // Number of bytes to follow $data = pack("vvvvv", $row_min, $row_max, $col_min, $col_max, $reserved); } elseif ($this->_BIFF_version == 0x0600) { $length = 0x000E; $data = pack("VVvvv", $row_min, $row_max, $col_min, $col_max, $reserved); } $header = pack("vv", $record, $length); $this->_prepend($header.$data); } /** * Write BIFF record Window2. * * @access private */ function _storeWindow2() { $record = 0x023E; // Record identifier if ($this->_BIFF_version == 0x0500) { $length = 0x000A; // Number of bytes to follow } elseif ($this->_BIFF_version == 0x0600) { $length = 0x0012; } $grbit = 0x00B6; // Option flags $rwTop = 0x0000; // Top row visible in window $colLeft = 0x0000; // Leftmost column visible in window // The options flags that comprise $grbit $fDspFmla = 0; // 0 - bit $fDspGrid = $this->_screen_gridlines; // 1 $fDspRwCol = 1; // 2 $fFrozen = $this->_frozen; // 3 $fDspZeros = 1; // 4 $fDefaultHdr = 1; // 5 $fArabic = 0; // 6 $fDspGuts = $this->_outline_on; // 7 $fFrozenNoSplit = 0; // 0 - bit $fSelected = $this->selected; // 1 $fPaged = 1; // 2 $grbit = $fDspFmla; $grbit |= $fDspGrid << 1; $grbit |= $fDspRwCol << 2; $grbit |= $fFrozen << 3; $grbit |= $fDspZeros << 4; $grbit |= $fDefaultHdr << 5; $grbit |= $fArabic << 6; $grbit |= $fDspGuts << 7; $grbit |= $fFrozenNoSplit << 8; $grbit |= $fSelected << 9; $grbit |= $fPaged << 10; $header = pack("vv", $record, $length); $data = pack("vvv", $grbit, $rwTop, $colLeft); // FIXME !!! if ($this->_BIFF_version == 0x0500) { $rgbHdr = 0x00000000; // Row/column heading and gridline color $data .= pack("V", $rgbHdr); } elseif ($this->_BIFF_version == 0x0600) { $rgbHdr = 0x0040; // Row/column heading and gridline color index $zoom_factor_page_break = 0x0000; $zoom_factor_normal = 0x0000; $data .= pack("vvvvV", $rgbHdr, 0x0000, $zoom_factor_page_break, $zoom_factor_normal, 0x00000000); } $this->_append($header.$data); } /** * Write BIFF record DEFCOLWIDTH if COLINFO records are in use. * * @access private */ function _storeDefcol() { $record = 0x0055; // Record identifier $length = 0x0002; // Number of bytes to follow $colwidth = 0x0008; // Default column width $header = pack("vv", $record, $length); $data = pack("v", $colwidth); $this->_prepend($header . $data); } /** * Write BIFF record COLINFO to define column widths * * Note: The SDK says the record length is 0x0B but Excel writes a 0x0C * length record. * * @access private * @param array $col_array This is the only parameter received and is composed of the following: * 0 => First formatted column, * 1 => Last formatted column, * 2 => Col width (8.43 is Excel default), * 3 => The optional XF format of the column, * 4 => Option flags. * 5 => Optional outline level */ function _storeColinfo($col_array) { if (isset($col_array[0])) { $colFirst = $col_array[0]; } if (isset($col_array[1])) { $colLast = $col_array[1]; } if (isset($col_array[2])) { $coldx = $col_array[2]; } else { $coldx = 8.43; } if (isset($col_array[3])) { $format = $col_array[3]; } else { $format = 0; } if (isset($col_array[4])) { $grbit = $col_array[4]; } else { $grbit = 0; } if (isset($col_array[5])) { $level = $col_array[5]; } else { $level = 0; } $record = 0x007D; // Record identifier $length = 0x000B; // Number of bytes to follow $coldx += 0.72; // Fudge. Excel subtracts 0.72 !? $coldx *= 256; // Convert to units of 1/256 of a char $ixfe = $this->_XF($format); $reserved = 0x00; // Reserved $level = max(0, min($level, 7)); $grbit |= $level << 8; $header = pack("vv", $record, $length); $data = pack("vvvvvC", $colFirst, $colLast, $coldx, $ixfe, $grbit, $reserved); $this->_prepend($header.$data); } /** * Write BIFF record SELECTION. * * @access private * @param array $array array containing ($rwFirst,$colFirst,$rwLast,$colLast) * @see setSelection() */ function _storeSelection($array) { list($rwFirst,$colFirst,$rwLast,$colLast) = $array; $record = 0x001D; // Record identifier $length = 0x000F; // Number of bytes to follow $pnn = $this->_active_pane; // Pane position $rwAct = $rwFirst; // Active row $colAct = $colFirst; // Active column $irefAct = 0; // Active cell ref $cref = 1; // Number of refs if (!isset($rwLast)) { $rwLast = $rwFirst; // Last row in reference } if (!isset($colLast)) { $colLast = $colFirst; // Last col in reference } // Swap last row/col for first row/col as necessary if ($rwFirst > $rwLast) { list($rwFirst, $rwLast) = array($rwLast, $rwFirst); } if ($colFirst > $colLast) { list($colFirst, $colLast) = array($colLast, $colFirst); } $header = pack("vv", $record, $length); $data = pack("CvvvvvvCC", $pnn, $rwAct, $colAct, $irefAct, $cref, $rwFirst, $rwLast, $colFirst, $colLast); $this->_append($header . $data); } /** * Store the MERGEDCELLS record for all ranges of merged cells * * @access private */ function _storeMergedCells() { // if there are no merged cell ranges set, return if (count($this->_merged_ranges) == 0) { return; } $record = 0x00E5; $length = 2 + count($this->_merged_ranges) * 8; $header = pack('vv', $record, $length); $data = pack('v', count($this->_merged_ranges)); foreach ($this->_merged_ranges as $range) { $data .= pack('vvvv', $range[0], $range[2], $range[1], $range[3]); } $this->_append($header . $data); } /** * Write BIFF record EXTERNCOUNT to indicate the number of external sheet * references in a worksheet. * * Excel only stores references to external sheets that are used in formulas. * For simplicity we store references to all the sheets in the workbook * regardless of whether they are used or not. This reduces the overall * complexity and eliminates the need for a two way dialogue between the formula * parser the worksheet objects. * * @access private * @param integer $count The number of external sheet references in this worksheet */ function _storeExterncount($count) { $record = 0x0016; // Record identifier $length = 0x0002; // Number of bytes to follow $header = pack("vv", $record, $length); $data = pack("v", $count); $this->_prepend($header . $data); } /** * Writes the Excel BIFF EXTERNSHEET record. These references are used by * formulas. A formula references a sheet name via an index. Since we store a * reference to all of the external worksheets the EXTERNSHEET index is the same * as the worksheet index. * * @access private * @param string $sheetname The name of a external worksheet */ function _storeExternsheet($sheetname) { $record = 0x0017; // Record identifier // References to the current sheet are encoded differently to references to // external sheets. // if ($this->name == $sheetname) { $sheetname = ''; $length = 0x02; // The following 2 bytes $cch = 1; // The following byte $rgch = 0x02; // Self reference } else { $length = 0x02 + strlen($sheetname); $cch = strlen($sheetname); $rgch = 0x03; // Reference to a sheet in the current workbook } $header = pack("vv", $record, $length); $data = pack("CC", $cch, $rgch); $this->_prepend($header . $data . $sheetname); } /** * Writes the Excel BIFF PANE record. * The panes can either be frozen or thawed (unfrozen). * Frozen panes are specified in terms of an integer number of rows and columns. * Thawed panes are specified in terms of Excel's units for rows and columns. * * @access private * @param array $panes This is the only parameter received and is composed of the following: * 0 => Vertical split position, * 1 => Horizontal split position * 2 => Top row visible * 3 => Leftmost column visible * 4 => Active pane */ function _storePanes($panes) { $y = $panes[0]; $x = $panes[1]; $rwTop = $panes[2]; $colLeft = $panes[3]; if (count($panes) > 4) { // if Active pane was received $pnnAct = $panes[4]; } else { $pnnAct = null; } $record = 0x0041; // Record identifier $length = 0x000A; // Number of bytes to follow // Code specific to frozen or thawed panes. if ($this->_frozen) { // Set default values for $rwTop and $colLeft if (!isset($rwTop)) { $rwTop = $y; } if (!isset($colLeft)) { $colLeft = $x; } } else { // Set default values for $rwTop and $colLeft if (!isset($rwTop)) { $rwTop = 0; } if (!isset($colLeft)) { $colLeft = 0; } // Convert Excel's row and column units to the internal units. // The default row height is 12.75 // The default column width is 8.43 // The following slope and intersection values were interpolated. // $y = 20*$y + 255; $x = 113.879*$x + 390; } // Determine which pane should be active. There is also the undocumented // option to override this should it be necessary: may be removed later. // if (!isset($pnnAct)) { if ($x != 0 && $y != 0) { $pnnAct = 0; // Bottom right } if ($x != 0 && $y == 0) { $pnnAct = 1; // Top right } if ($x == 0 && $y != 0) { $pnnAct = 2; // Bottom left } if ($x == 0 && $y == 0) { $pnnAct = 3; // Top left } } $this->_active_pane = $pnnAct; // Used in _storeSelection $header = pack("vv", $record, $length); $data = pack("vvvvv", $x, $y, $rwTop, $colLeft, $pnnAct); $this->_append($header . $data); } /** * Store the page setup SETUP BIFF record. * * @access private */ function _storeSetup() { $record = 0x00A1; // Record identifier $length = 0x0022; // Number of bytes to follow $iPaperSize = $this->_paper_size; // Paper size $iScale = $this->_print_scale; // Print scaling factor $iPageStart = 0x01; // Starting page number $iFitWidth = $this->_fit_width; // Fit to number of pages wide $iFitHeight = $this->_fit_height; // Fit to number of pages high $grbit = 0x00; // Option flags $iRes = 0x0258; // Print resolution $iVRes = 0x0258; // Vertical print resolution $numHdr = $this->_margin_head; // Header Margin $numFtr = $this->_margin_foot; // Footer Margin $iCopies = 0x01; // Number of copies $fLeftToRight = 0x0; // Print over then down $fLandscape = $this->_orientation; // Page orientation $fNoPls = 0x0; // Setup not read from printer $fNoColor = 0x0; // Print black and white $fDraft = 0x0; // Print draft quality $fNotes = 0x0; // Print notes $fNoOrient = 0x0; // Orientation not set $fUsePage = 0x0; // Use custom starting page $grbit = $fLeftToRight; $grbit |= $fLandscape << 1; $grbit |= $fNoPls << 2; $grbit |= $fNoColor << 3; $grbit |= $fDraft << 4; $grbit |= $fNotes << 5; $grbit |= $fNoOrient << 6; $grbit |= $fUsePage << 7; $numHdr = pack("d", $numHdr); $numFtr = pack("d", $numFtr); if ($this->_byte_order) { // if it's Big Endian $numHdr = strrev($numHdr); $numFtr = strrev($numFtr); } $header = pack("vv", $record, $length); $data1 = pack("vvvvvvvv", $iPaperSize, $iScale, $iPageStart, $iFitWidth, $iFitHeight, $grbit, $iRes, $iVRes); $data2 = $numHdr.$numFtr; $data3 = pack("v", $iCopies); $this->_prepend($header . $data1 . $data2 . $data3); } /** * Store the header caption BIFF record. * * @access private */ function _storeHeader() { $record = 0x0014; // Record identifier $str = $this->_header; // header string $cch = strlen($str); // Length of header string if ($this->_BIFF_version == 0x0600) { $encoding = 0x0; // TODO: Unicode support $length = 3 + $cch; // Bytes to follow } else { $length = 1 + $cch; // Bytes to follow } $header = pack("vv", $record, $length); if ($this->_BIFF_version == 0x0600) { $data = pack("vC", $cch, $encoding); } else { $data = pack("C", $cch); } $this->_prepend($header.$data.$str); } /** * Store the footer caption BIFF record. * * @access private */ function _storeFooter() { $record = 0x0015; // Record identifier $str = $this->_footer; // Footer string $cch = strlen($str); // Length of footer string if ($this->_BIFF_version == 0x0600) { $encoding = 0x0; // TODO: Unicode support $length = 3 + $cch; // Bytes to follow } else { $length = 1 + $cch; } $header = pack("vv", $record, $length); if ($this->_BIFF_version == 0x0600) { $data = pack("vC", $cch, $encoding); } else { $data = pack("C", $cch); } $this->_prepend($header . $data . $str); } /** * Store the horizontal centering HCENTER BIFF record. * * @access private */ function _storeHcenter() { $record = 0x0083; // Record identifier $length = 0x0002; // Bytes to follow $fHCenter = $this->_hcenter; // Horizontal centering $header = pack("vv", $record, $length); $data = pack("v", $fHCenter); $this->_prepend($header.$data); } /** * Store the vertical centering VCENTER BIFF record. * * @access private */ function _storeVcenter() { $record = 0x0084; // Record identifier $length = 0x0002; // Bytes to follow $fVCenter = $this->_vcenter; // Horizontal centering $header = pack("vv", $record, $length); $data = pack("v", $fVCenter); $this->_prepend($header . $data); } /** * Store the LEFTMARGIN BIFF record. * * @access private */ function _storeMarginLeft() { $record = 0x0026; // Record identifier $length = 0x0008; // Bytes to follow $margin = $this->_margin_left; // Margin in inches $header = pack("vv", $record, $length); $data = pack("d", $margin); if ($this->_byte_order) { // if it's Big Endian $data = strrev($data); } $this->_prepend($header . $data); } /** * Store the RIGHTMARGIN BIFF record. * * @access private */ function _storeMarginRight() { $record = 0x0027; // Record identifier $length = 0x0008; // Bytes to follow $margin = $this->_margin_right; // Margin in inches $header = pack("vv", $record, $length); $data = pack("d", $margin); if ($this->_byte_order) { // if it's Big Endian $data = strrev($data); } $this->_prepend($header . $data); } /** * Store the TOPMARGIN BIFF record. * * @access private */ function _storeMarginTop() { $record = 0x0028; // Record identifier $length = 0x0008; // Bytes to follow $margin = $this->_margin_top; // Margin in inches $header = pack("vv", $record, $length); $data = pack("d", $margin); if ($this->_byte_order) { // if it's Big Endian $data = strrev($data); } $this->_prepend($header . $data); } /** * Store the BOTTOMMARGIN BIFF record. * * @access private */ function _storeMarginBottom() { $record = 0x0029; // Record identifier $length = 0x0008; // Bytes to follow $margin = $this->_margin_bottom; // Margin in inches $header = pack("vv", $record, $length); $data = pack("d", $margin); if ($this->_byte_order) { // if it's Big Endian $data = strrev($data); } $this->_prepend($header . $data); } /** * Merges the area given by its arguments. * This is an Excel97/2000 method. It is required to perform more complicated * merging than the normal setAlign('merge'). * * @access public * @param integer $first_row First row of the area to merge * @param integer $first_col First column of the area to merge * @param integer $last_row Last row of the area to merge * @param integer $last_col Last column of the area to merge */ function mergeCells($first_row, $first_col, $last_row, $last_col) { $record = 0x00E5; // Record identifier $length = 0x000A; // Bytes to follow $cref = 1; // Number of refs // Swap last row/col for first row/col as necessary if ($first_row > $last_row) { list($first_row, $last_row) = array($last_row, $first_row); } if ($first_col > $last_col) { list($first_col, $last_col) = array($last_col, $first_col); } $header = pack("vv", $record, $length); $data = pack("vvvvv", $cref, $first_row, $last_row, $first_col, $last_col); $this->_append($header.$data); } /** * Write the PRINTHEADERS BIFF record. * * @access private */ function _storePrintHeaders() { $record = 0x002a; // Record identifier $length = 0x0002; // Bytes to follow $fPrintRwCol = $this->_print_headers; // Boolean flag $header = pack("vv", $record, $length); $data = pack("v", $fPrintRwCol); $this->_prepend($header . $data); } /** * Write the PRINTGRIDLINES BIFF record. Must be used in conjunction with the * GRIDSET record. * * @access private */ function _storePrintGridlines() { $record = 0x002b; // Record identifier $length = 0x0002; // Bytes to follow $fPrintGrid = $this->_print_gridlines; // Boolean flag $header = pack("vv", $record, $length); $data = pack("v", $fPrintGrid); $this->_prepend($header . $data); } /** * Write the GRIDSET BIFF record. Must be used in conjunction with the * PRINTGRIDLINES record. * * @access private */ function _storeGridset() { $record = 0x0082; // Record identifier $length = 0x0002; // Bytes to follow $fGridSet = !($this->_print_gridlines); // Boolean flag $header = pack("vv", $record, $length); $data = pack("v", $fGridSet); $this->_prepend($header . $data); } /** * Write the GUTS BIFF record. This is used to configure the gutter margins * where Excel outline symbols are displayed. The visibility of the gutters is * controlled by a flag in WSBOOL. * * @see _storeWsbool() * @access private */ function _storeGuts() { $record = 0x0080; // Record identifier $length = 0x0008; // Bytes to follow $dxRwGut = 0x0000; // Size of row gutter $dxColGut = 0x0000; // Size of col gutter $row_level = $this->_outline_row_level; $col_level = 0; // Calculate the maximum column outline level. The equivalent calculation // for the row outline level is carried out in setRow(). $colcount = count($this->_colinfo); for ($i = 0; $i < $colcount; $i++) { // Skip cols without outline level info. if (count($col_level) >= 6) { $col_level = max($this->_colinfo[$i][5], $col_level); } } // Set the limits for the outline levels (0 <= x <= 7). $col_level = max(0, min($col_level, 7)); // The displayed level is one greater than the max outline levels if ($row_level) { $row_level++; } if ($col_level) { $col_level++; } $header = pack("vv", $record, $length); $data = pack("vvvv", $dxRwGut, $dxColGut, $row_level, $col_level); $this->_prepend($header.$data); } /** * Write the WSBOOL BIFF record, mainly for fit-to-page. Used in conjunction * with the SETUP record. * * @access private */ function _storeWsbool() { $record = 0x0081; // Record identifier $length = 0x0002; // Bytes to follow $grbit = 0x0000; // The only option that is of interest is the flag for fit to page. So we // set all the options in one go. // /*if ($this->_fit_page) { $grbit = 0x05c1; } else { $grbit = 0x04c1; }*/ // Set the option flags $grbit |= 0x0001; // Auto page breaks visible if ($this->_outline_style) { $grbit |= 0x0020; // Auto outline styles } if ($this->_outline_below) { $grbit |= 0x0040; // Outline summary below } if ($this->_outline_right) { $grbit |= 0x0080; // Outline summary right } if ($this->_fit_page) { $grbit |= 0x0100; // Page setup fit to page } if ($this->_outline_on) { $grbit |= 0x0400; // Outline symbols displayed } $header = pack("vv", $record, $length); $data = pack("v", $grbit); $this->_prepend($header . $data); } /** * Write the HORIZONTALPAGEBREAKS BIFF record. * * @access private */ function _storeHbreak() { // Return if the user hasn't specified pagebreaks if (empty($this->_hbreaks)) { return; } // Sort and filter array of page breaks $breaks = $this->_hbreaks; sort($breaks, SORT_NUMERIC); if ($breaks[0] == 0) { // don't use first break if it's 0 array_shift($breaks); } $record = 0x001b; // Record identifier $cbrk = count($breaks); // Number of page breaks if ($this->_BIFF_version == 0x0600) { $length = 2 + 6*$cbrk; // Bytes to follow } else { $length = 2 + 2*$cbrk; // Bytes to follow } $header = pack("vv", $record, $length); $data = pack("v", $cbrk); // Append each page break foreach ($breaks as $break) { if ($this->_BIFF_version == 0x0600) { $data .= pack("vvv", $break, 0x0000, 0x00ff); } else { $data .= pack("v", $break); } } $this->_prepend($header.$data); } /** * Write the VERTICALPAGEBREAKS BIFF record. * * @access private */ function _storeVbreak() { // Return if the user hasn't specified pagebreaks if (empty($this->_vbreaks)) { return; } // 1000 vertical pagebreaks appears to be an internal Excel 5 limit. // It is slightly higher in Excel 97/200, approx. 1026 $breaks = array_slice($this->_vbreaks,0,1000); // Sort and filter array of page breaks sort($breaks, SORT_NUMERIC); if ($breaks[0] == 0) { // don't use first break if it's 0 array_shift($breaks); } $record = 0x001a; // Record identifier $cbrk = count($breaks); // Number of page breaks if ($this->_BIFF_version == 0x0600) { $length = 2 + 6*$cbrk; // Bytes to follow } else { $length = 2 + 2*$cbrk; // Bytes to follow } $header = pack("vv", $record, $length); $data = pack("v", $cbrk); // Append each page break foreach ($breaks as $break) { if ($this->_BIFF_version == 0x0600) { $data .= pack("vvv", $break, 0x0000, 0xffff); } else { $data .= pack("v", $break); } } $this->_prepend($header . $data); } /** * Set the Biff PROTECT record to indicate that the worksheet is protected. * * @access private */ function _storeProtect() { // Exit unless sheet protection has been specified if ($this->_protect == 0) { return; } $record = 0x0012; // Record identifier $length = 0x0002; // Bytes to follow $fLock = $this->_protect; // Worksheet is protected $header = pack("vv", $record, $length); $data = pack("v", $fLock); $this->_prepend($header.$data); } /** * Write the worksheet PASSWORD record. * * @access private */ function _storePassword() { // Exit unless sheet protection and password have been specified if (($this->_protect == 0) || (!isset($this->_password))) { return; } $record = 0x0013; // Record identifier $length = 0x0002; // Bytes to follow $wPassword = $this->_password; // Encoded password $header = pack("vv", $record, $length); $data = pack("v", $wPassword); $this->_prepend($header . $data); } /** * Insert a 24bit bitmap image in a worksheet. * * @access public * @param integer $row The row we are going to insert the bitmap into * @param integer $col The column we are going to insert the bitmap into * @param string $bitmap The bitmap filename * @param integer $x The horizontal position (offset) of the image inside the cell. * @param integer $y The vertical position (offset) of the image inside the cell. * @param integer $scale_x The horizontal scale * @param integer $scale_y The vertical scale */ function insertBitmap($row, $col, $bitmap, $x = 0, $y = 0, $scale_x = 1, $scale_y = 1) { $bitmap_array = $this->_processBitmap($bitmap); if ($this->isError($bitmap_array)) { $this->writeString($row, $col, $bitmap_array->getMessage()); return; } list($width, $height, $size, $data) = $bitmap_array; //$this->_processBitmap($bitmap); // Scale the frame of the image. $width *= $scale_x; $height *= $scale_y; // Calculate the vertices of the image and write the OBJ record $this->_positionImage($col, $row, $x, $y, $width, $height); // Write the IMDATA record to store the bitmap data $record = 0x007f; $length = 8 + $size; $cf = 0x09; $env = 0x01; $lcb = $size; $header = pack("vvvvV", $record, $length, $cf, $env, $lcb); $this->_append($header.$data); } /** * Calculate the vertices that define the position of the image as required by * the OBJ record. * * +------------+------------+ * | A | B | * +-----+------------+------------+ * | |(x1,y1) | | * | 1 |(A1)._______|______ | * | | | | | * | | | | | * +-----+----| BITMAP |-----+ * | | | | | * | 2 | |______________. | * | | | (B2)| * | | | (x2,y2)| * +---- +------------+------------+ * * Example of a bitmap that covers some of the area from cell A1 to cell B2. * * Based on the width and height of the bitmap we need to calculate 8 vars: * $col_start, $row_start, $col_end, $row_end, $x1, $y1, $x2, $y2. * The width and height of the cells are also variable and have to be taken into * account. * The values of $col_start and $row_start are passed in from the calling * function. The values of $col_end and $row_end are calculated by subtracting * the width and height of the bitmap from the width and height of the * underlying cells. * The vertices are expressed as a percentage of the underlying cell width as * follows (rhs values are in pixels): * * x1 = X / W *1024 * y1 = Y / H *256 * x2 = (X-1) / W *1024 * y2 = (Y-1) / H *256 * * Where: X is distance from the left side of the underlying cell * Y is distance from the top of the underlying cell * W is the width of the cell * H is the height of the cell * * @access private * @note the SDK incorrectly states that the height should be expressed as a * percentage of 1024. * @param integer $col_start Col containing upper left corner of object * @param integer $row_start Row containing top left corner of object * @param integer $x1 Distance to left side of object * @param integer $y1 Distance to top of object * @param integer $width Width of image frame * @param integer $height Height of image frame */ function _positionImage($col_start, $row_start, $x1, $y1, $width, $height) { // Initialise end cell to the same as the start cell $col_end = $col_start; // Col containing lower right corner of object $row_end = $row_start; // Row containing bottom right corner of object // Zero the specified offset if greater than the cell dimensions if ($x1 >= $this->_sizeCol($col_start)) { $x1 = 0; } if ($y1 >= $this->_sizeRow($row_start)) { $y1 = 0; } $width = $width + $x1 -1; $height = $height + $y1 -1; // Subtract the underlying cell widths to find the end cell of the image while ($width >= $this->_sizeCol($col_end)) { $width -= $this->_sizeCol($col_end); $col_end++; } // Subtract the underlying cell heights to find the end cell of the image while ($height >= $this->_sizeRow($row_end)) { $height -= $this->_sizeRow($row_end); $row_end++; } // Bitmap isn't allowed to start or finish in a hidden cell, i.e. a cell // with zero eight or width. // if ($this->_sizeCol($col_start) == 0) { return; } if ($this->_sizeCol($col_end) == 0) { return; } if ($this->_sizeRow($row_start) == 0) { return; } if ($this->_sizeRow($row_end) == 0) { return; } // Convert the pixel values to the percentage value expected by Excel $x1 = $x1 / $this->_sizeCol($col_start) * 1024; $y1 = $y1 / $this->_sizeRow($row_start) * 256; $x2 = $width / $this->_sizeCol($col_end) * 1024; // Distance to right side of object $y2 = $height / $this->_sizeRow($row_end) * 256; // Distance to bottom of object $this->_storeObjPicture($col_start, $x1, $row_start, $y1, $col_end, $x2, $row_end, $y2); } /** * Convert the width of a cell from user's units to pixels. By interpolation * the relationship is: y = 7x +5. If the width hasn't been set by the user we * use the default value. If the col is hidden we use a value of zero. * * @access private * @param integer $col The column * @return integer The width in pixels */ function _sizeCol($col) { // Look up the cell value to see if it has been changed if (isset($this->col_sizes[$col])) { if ($this->col_sizes[$col] == 0) { return(0); } else { return(floor(7 * $this->col_sizes[$col] + 5)); } } else { return(64); } } /** * Convert the height of a cell from user's units to pixels. By interpolation * the relationship is: y = 4/3x. If the height hasn't been set by the user we * use the default value. If the row is hidden we use a value of zero. (Not * possible to hide row yet). * * @access private * @param integer $row The row * @return integer The width in pixels */ function _sizeRow($row) { // Look up the cell value to see if it has been changed if (isset($this->_row_sizes[$row])) { if ($this->_row_sizes[$row] == 0) { return(0); } else { return(floor(4/3 * $this->_row_sizes[$row])); } } else { return(17); } } /** * Store the OBJ record that precedes an IMDATA record. This could be generalise * to support other Excel objects. * * @access private * @param integer $colL Column containing upper left corner of object * @param integer $dxL Distance from left side of cell * @param integer $rwT Row containing top left corner of object * @param integer $dyT Distance from top of cell * @param integer $colR Column containing lower right corner of object * @param integer $dxR Distance from right of cell * @param integer $rwB Row containing bottom right corner of object * @param integer $dyB Distance from bottom of cell */ function _storeObjPicture($colL,$dxL,$rwT,$dyT,$colR,$dxR,$rwB,$dyB) { $record = 0x005d; // Record identifier $length = 0x003c; // Bytes to follow $cObj = 0x0001; // Count of objects in file (set to 1) $OT = 0x0008; // Object type. 8 = Picture $id = 0x0001; // Object ID $grbit = 0x0614; // Option flags $cbMacro = 0x0000; // Length of FMLA structure $Reserved1 = 0x0000; // Reserved $Reserved2 = 0x0000; // Reserved $icvBack = 0x09; // Background colour $icvFore = 0x09; // Foreground colour $fls = 0x00; // Fill pattern $fAuto = 0x00; // Automatic fill $icv = 0x08; // Line colour $lns = 0xff; // Line style $lnw = 0x01; // Line weight $fAutoB = 0x00; // Automatic border $frs = 0x0000; // Frame style $cf = 0x0009; // Image format, 9 = bitmap $Reserved3 = 0x0000; // Reserved $cbPictFmla = 0x0000; // Length of FMLA structure $Reserved4 = 0x0000; // Reserved $grbit2 = 0x0001; // Option flags $Reserved5 = 0x0000; // Reserved $header = pack("vv", $record, $length); $data = pack("V", $cObj); $data .= pack("v", $OT); $data .= pack("v", $id); $data .= pack("v", $grbit); $data .= pack("v", $colL); $data .= pack("v", $dxL); $data .= pack("v", $rwT); $data .= pack("v", $dyT); $data .= pack("v", $colR); $data .= pack("v", $dxR); $data .= pack("v", $rwB); $data .= pack("v", $dyB); $data .= pack("v", $cbMacro); $data .= pack("V", $Reserved1); $data .= pack("v", $Reserved2); $data .= pack("C", $icvBack); $data .= pack("C", $icvFore); $data .= pack("C", $fls); $data .= pack("C", $fAuto); $data .= pack("C", $icv); $data .= pack("C", $lns); $data .= pack("C", $lnw); $data .= pack("C", $fAutoB); $data .= pack("v", $frs); $data .= pack("V", $cf); $data .= pack("v", $Reserved3); $data .= pack("v", $cbPictFmla); $data .= pack("v", $Reserved4); $data .= pack("v", $grbit2); $data .= pack("V", $Reserved5); $this->_append($header . $data); } /** * Convert a 24 bit bitmap into the modified internal format used by Windows. * This is described in BITMAPCOREHEADER and BITMAPCOREINFO structures in the * MSDN library. * * @access private * @param string $bitmap The bitmap to process * @return array Array with data and properties of the bitmap */ function _processBitmap($bitmap) { // Open file. $bmp_fd = @fopen($bitmap,"rb"); if (!$bmp_fd) { $this->raiseError("Couldn't import $bitmap"); } // Slurp the file into a string. $data = fread($bmp_fd, filesize($bitmap)); // Check that the file is big enough to be a bitmap. if (strlen($data) <= 0x36) { $this->raiseError("$bitmap doesn't contain enough data.\n"); } // The first 2 bytes are used to identify the bitmap. $identity = unpack("A2ident", $data); if ($identity['ident'] != "BM") { $this->raiseError("$bitmap doesn't appear to be a valid bitmap image.\n"); } // Remove bitmap data: ID. $data = substr($data, 2); // Read and remove the bitmap size. This is more reliable than reading // the data size at offset 0x22. // $size_array = unpack("Vsa", substr($data, 0, 4)); $size = $size_array['sa']; $data = substr($data, 4); $size -= 0x36; // Subtract size of bitmap header. $size += 0x0C; // Add size of BIFF header. // Remove bitmap data: reserved, offset, header length. $data = substr($data, 12); // Read and remove the bitmap width and height. Verify the sizes. $width_and_height = unpack("V2", substr($data, 0, 8)); $width = $width_and_height[1]; $height = $width_and_height[2]; $data = substr($data, 8); if ($width > 0xFFFF) { $this->raiseError("$bitmap: largest image width supported is 65k.\n"); } if ($height > 0xFFFF) { $this->raiseError("$bitmap: largest image height supported is 65k.\n"); } // Read and remove the bitmap planes and bpp data. Verify them. $planes_and_bitcount = unpack("v2", substr($data, 0, 4)); $data = substr($data, 4); if ($planes_and_bitcount[2] != 24) { // Bitcount $this->raiseError("$bitmap isn't a 24bit true color bitmap.\n"); } if ($planes_and_bitcount[1] != 1) { $this->raiseError("$bitmap: only 1 plane supported in bitmap image.\n"); } // Read and remove the bitmap compression. Verify compression. $compression = unpack("Vcomp", substr($data, 0, 4)); $data = substr($data, 4); //$compression = 0; if ($compression['comp'] != 0) { $this->raiseError("$bitmap: compression not supported in bitmap image.\n"); } // Remove bitmap data: data size, hres, vres, colours, imp. colours. $data = substr($data, 20); // Add the BITMAPCOREHEADER data $header = pack("Vvvvv", 0x000c, $width, $height, 0x01, 0x18); $data = $header . $data; return (array($width, $height, $size, $data)); } /** * Store the window zoom factor. This should be a reduced fraction but for * simplicity we will store all fractions with a numerator of 100. * * @access private */ function _storeZoom() { // If scale is 100 we don't need to write a record if ($this->_zoom == 100) { return; } $record = 0x00A0; // Record identifier $length = 0x0004; // Bytes to follow $header = pack("vv", $record, $length); $data = pack("vv", $this->_zoom, 100); $this->_append($header . $data); } /** * FIXME: add comments */ function setValidation($row1, $col1, $row2, $col2, &$validator) { $this->_dv[] = $validator->_getData() . pack("vvvvv", 1, $row1, $row2, $col1, $col2); } /** * Store the DVAL and DV records. * * @access private */ function _storeDataValidity() { $record = 0x01b2; // Record identifier $length = 0x0012; // Bytes to follow $grbit = 0x0002; // Prompt box at cell, no cached validity data at DV records $horPos = 0x00000000; // Horizontal position of prompt box, if fixed position $verPos = 0x00000000; // Vertical position of prompt box, if fixed position $objId = 0xffffffff; // Object identifier of drop down arrow object, or -1 if not visible $header = pack('vv', $record, $length); $data = pack('vVVVV', $grbit, $horPos, $verPos, $objId, count($this->_dv)); $this->_append($header.$data); $record = 0x01be; // Record identifier foreach ($this->_dv as $dv) { $length = strlen($dv); // Bytes to follow $header = pack("vv", $record, $length); $this->_append($header . $dv); } } }