*
* 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 in the file LICENSE.LGPL; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
* 02111-1307 USA
*
* Alternatively, you may distribute this software under the terms of the
* PHP License, version 3.0 or later. A copy of this license should have
* been distributed with this file in the file LICENSE.PHP . If this is not
* the case, you can obtain a copy at http://www.php.net/license/3_0.txt.
*
* The latest version of DOMPDF might be available at:
* http://www.dompdf.com/
*
* @link http://www.dompdf.com/
* @copyright 2004 Benj Carson
* @author Benj Carson
* @contributor Helmut Tischer
* @package dompdf
*
* Changes
* @contributor Helmut Tischer
* @version 0.5.1.htischer.20090507
* - Clarify temp file name, optional debug output for temp file tracking
*/
/* $Id: pdflib_adapter.cls.php 217 2010-03-11 23:03:57Z ryan.masten $ */
/**
* PDF rendering interface
*
* PDFLib_Adapter provides a simple, stateless interface to the one
* provided by PDFLib.
*
* Unless otherwise mentioned, all dimensions are in points (1/72 in).
* The coordinate origin is in the top left corner and y values
* increase downwards.
*
* See {@link http://www.pdflib.com/} for more complete documentation
* on the underlying PDFlib functions.
*
* @package dompdf
*/
class PDFLib_Adapter implements Canvas {
/**
* Dimensions of paper sizes in points
*
* @var array;
*/
static public $PAPER_SIZES = array(); // Set to
// CPDF_Adapter::$PAPER_SIZES below.
/**
* Fudge factor to adjust reported font heights
*
* CPDF reports larger font heights than PDFLib. This factor
* adjusts the height reported by get_font_height().
*
* @var float
*/
const FONT_HEIGHT_SCALE = 1.2;
/**
* Whether to create PDFs in memory or on disk
*
* @var bool
*/
static $IN_MEMORY = true;
/**
* Instance of PDFLib class
*
* @var PDFlib
*/
private $_pdf;
/**
* Name of temporary file used for PDFs created on disk
*
* @var string
*/
private $_file;
/**
* PDF width, in points
*
* @var float
*/
private $_width;
/**
* PDF height, in points
*
* @var height
*/
private $_height;
/**
* Last fill colour used
*
* @var array
*/
private $_last_fill_color;
/**
* Last stroke colour used
*
* @var array
*/
private $_last_stroke_color;
/**
* Cache of image handles
*
* @var array
*/
private $_imgs;
/**
* Cache of font handles
*
* @var array
*/
private $_fonts;
/**
* List of objects (templates) to add to multiple pages
*
* @var array
*/
private $_objs;
/**
* Current page number
*
* @var int
*/
private $_page_number;
/**
* Total number of pages
*
* @var int
*/
private $_page_count;
/**
* Text to display on every page
*
* @var array
*/
private $_page_text;
/**
* Array of pages for accesing after rendering is initially complete
*
* @var array
*/
private $_pages;
/**
* Class constructor
*
* @param mixed $paper The size of paper to use either a string (see {@link CPDF_Adapter::$PAPER_SIZES}) or
* an array(xmin,ymin,xmax,ymax)
* @param string $orientation The orientation of the document (either 'landscape' or 'portrait')
*/
function __construct($paper = "letter", $orientation = "portrait") {
if ( is_array($paper) )
$size = $paper;
else if ( isset(self::$PAPER_SIZES[mb_strtolower($paper)]) )
$size = self::$PAPER_SIZES[mb_strtolower($paper)];
else
$size = self::$PAPER_SIZES["letter"];
if ( mb_strtolower($orientation) === "landscape" ) {
$a = $size[3];
$size[3] = $size[2];
$size[2] = $a;
}
$this->_width = $size[2] - $size[0];
$this->_height= $size[3] - $size[1];
$this->_pdf = new PDFLib();
if ( defined("DOMPDF_PDFLIB_LICENSE") )
$this->_pdf->set_parameter( "license", DOMPDF_PDFLIB_LICENSE);
$this->_pdf->set_parameter("textformat", "utf8");
$this->_pdf->set_parameter("fontwarning", "false");
$this->_pdf->set_info("Creator", "DOMPDF Converter");
// Silence pedantic warnings about missing TZ settings
if ( function_exists("date_default_timezone_get") ) {
$tz = @date_default_timezone_get();
date_default_timezone_set("UTC");
$this->_pdf->set_info("Date", date("Y-m-d"));
date_default_timezone_set($tz);
} else {
$this->_pdf->set_info("Date", date("Y-m-d"));
}
if ( self::$IN_MEMORY )
$this->_pdf->begin_document("","");
else {
$this->_file = tempnam(DOMPDF_TEMP_DIR, "libdompdf_pdf_").'.pdf';
$this->_pdf->begin_document($this->_file,"");
}
$this->_pdf->begin_page_ext($this->_width, $this->_height, "");
$this->_page_number = $this->_page_count = 1;
$this->_page_text = array();
$this->_imgs = array();
$this->_fonts = array();
$this->_objs = array();
// Set up font paths
$families = Font_Metrics::get_font_families();
foreach ($families as $family => $files) {
foreach ($files as $style => $file) {
$face = basename($file);
// Prefer ttfs to afms
if ( file_exists($file.".ttf") ) {
$outline = "$file.ttf";
$afm = null;
} else if ( file_exists($file .".TTF") ) {
$outline = "$file.TTF";
$afm = null;
} else if ( file_exists($file . ".pfb") ) {
$outline = "$file.pfb";
if ( file_exists($file . ".afm") )
$afm = "$file.afm";
} else if ( file_exists($file . ".PFB") ) {
$outline = "$file.PFB";
if ( file_exists($file . ".AFM") )
$afm = "$file.AFM";
} else
continue;
$this->_pdf->set_parameter("FontOutline", "\{$face\}=\{$outline\}");
if ( !is_null($afm) )
$this->_pdf->set_parameter("FontAFM", "\{$face\}=\{$afm\}");
}
}
}
/**
* Close the pdf
*/
protected function _close() {
$this->_place_objects();
// Close all pages
$this->_pdf->suspend_page("");
for ($p = 1; $p <= $this->_page_count; $p++) {
$this->_pdf->resume_page("pagenumber=$p");
$this->_pdf->end_page_ext("");
}
$this->_pdf->end_document("");
}
/**
* Returns the PDFLib instance
*
* @return PDFLib
*/
function get_pdflib() { return $this->_pdf; }
/**
* Add meta information to the PDF
*
* @param string $label label of the value (Creator, Producter, etc.)
* @param string $value the text to set
*/
function add_info($label, $value) {
$this->_pdf->set_info($label, $value);
}
/**
* Opens a new 'object' (template in PDFLib-speak)
*
* While an object is open, all drawing actions are recorded to the
* object instead of being drawn on the current page. Objects can
* be added later to a specific page or to several pages.
*
* The return value is an integer ID for the new object.
*
* @see PDFLib_Adapter::close_object()
* @see PDFLib_Adapter::add_object()
*
* @return int
*/
function open_object() {
$this->_pdf->suspend_page("");
$ret = $this->_pdf->begin_template($this->_width, $this->_height);
$this->_pdf->save();
$this->_objs[$ret] = array("start_page" => $this->_page_number);
return $ret;
}
/**
* Reopen an existing object (NOT IMPLEMENTED)
*
* PDFLib does not seem to support reopening templates.
*
* @param int $object the ID of a previously opened object
*/
function reopen_object($object) {
throw new DOMPDF_Exception("PDFLib does not support reopening objects.");
}
/**
* Close the current template
*
* @see PDFLib_Adapter::open_object()
*/
function close_object() {
$this->_pdf->restore();
$this->_pdf->end_template();
$this->_pdf->resume_page("pagenumber=".$this->_page_number);
}
/**
* Adds the specified object to the document
*
* $where can be one of:
* - 'add' add to current page only
* - 'all' add to every page from the current one onwards
* - 'odd' add to all odd numbered pages from now on
* - 'even' add to all even numbered pages from now on
* - 'next' add the object to the next page only
* - 'nextodd' add to all odd numbered pages from the next one
* - 'nexteven' add to all even numbered pages from the next one
*
* @param int $object the object handle returned by open_object()
* @param string $where
*/
function add_object($object, $where = 'all') {
if ( mb_strpos($where, "next") !== false ) {
$this->_objs[$object]["start_page"]++;
$where = str_replace("next", "", $where);
if ( $where == "" )
$where = "add";
}
$this->_objs[$object]["where"] = $where;
}
/**
* Stops the specified template from appearing in the document.
*
* The object will stop being displayed on the page following the
* current one.
*
* @param int $object
*/
function stop_object($object) {
if ( !isset($this->_objs[$object]) )
return;
$start = $this->_objs[$object]["start_page"];
$where = $this->_objs[$object]["where"];
// Place the object on this page if required
if ( $this->_page_number >= $start &&
(($this->_page_number % 2 == 0 && $where === "even") ||
($this->_page_number % 2 == 1 && $where === "odd") ||
($where === "all")) )
$this->_pdf->fit_image($object,0,0,"");
unset($this->_objs[$object]);
}
/**
* Add all active objects to the current page
*/
protected function _place_objects() {
foreach ( $this->_objs as $obj => $props ) {
$start = $props["start_page"];
$where = $props["where"];
// Place the object on this page if required
if ( $this->_page_number >= $start &&
(($this->_page_number % 2 == 0 && $where === "even") ||
($this->_page_number % 2 == 1 && $where === "odd") ||
($where === "all")) ) {
$this->_pdf->fit_image($obj,0,0,"");
}
}
}
function get_width() { return $this->_width; }
function get_height() { return $this->_height; }
function get_page_number() { return $this->_page_number; }
function get_page_count() { return $this->_page_count; }
function set_page_number($num) { $this->_page_number = (int)$num; }
function set_page_count($count) { $this->_page_count = (int)$count; }
/**
* Sets the line style
*
* @param float width
* @param string corner
* @param string join
* @param array dash
*/
protected function _set_line_style($width, $cap, $join, $dash) {
if ( count($dash) == 1 )
$dash[] = $dash[0];
if ( count($dash) > 1 )
$this->_pdf->setdashpattern("dasharray={" . join(" ", $dash) . "}");
else
$this->_pdf->setdash(0,0);
switch ( $join ) {
case "miter":
$this->_pdf->setlinejoin(0);
break;
case "round":
$this->_pdf->setlinejoin(1);
break;
case "bevel":
$this->_pdf->setlinejoin(2);
break;
default:
break;
}
switch ( $cap ) {
case "butt":
$this->_pdf->setlinecap(0);
break;
case "round":
$this->_pdf->setlinecap(1);
break;
case "square":
$this->_pdf->setlinecap(2);
break;
default:
break;
}
$this->_pdf->setlinewidth($width);
}
/**
* Sets the line color
*
* @param array $color array(r,g,b)
*/
protected function _set_stroke_color($color) {
if($this->_last_stroke_color == $color)
return;
$this->_last_stroke_color = $color;
list($r,$g,$b) = $color;
$this->_pdf->setcolor("stroke", "rgb", $r, $g, $b, 0);
}
/**
* Sets the fill color
*
* @param array $color array(r,g,b)
*/
protected function _set_fill_color($color) {
if($this->_last_fill_color == $color)
return;
$this->_last_fill_color = $color;
list($r,$g,$b) = $color;
$this->_pdf->setcolor("fill", "rgb", $r, $g, $b, 0);
}
/**
* Loads a specific font and stores the corresponding descriptor.
*
* @param string $font
* @return int the font descriptor for the font
*/
protected function _load_font($font, $encoding = null, $options = "") {
// Check if the font is a native PDF font
// Embed non-native fonts
$native_fonts = array("courier", "courier-bold", "courier-oblique", "courier-boldoblique",
"helvetica", "helvetica-bold", "helvetica-oblique", "helvetica-boldoblique",
"times-roman", "times-bold", "times-italic", "times-bolditalic",
"symbol", "zapfdinbats");
$test = strtolower(basename($font));
if ( in_array($test, $native_fonts) ) {
$font = basename($font);
} else {
// Embed non-native fonts
$options .= " embedding=true";
}
if ( is_null($encoding) ) {
// Unicode encoding is only available for the commerical
// version of PDFlib and not PDFlib-Lite
if ( defined("DOMPDF_PDFLIB_LICENSE") )
$encoding = "unicode";
else
$encoding = "auto";
}
$key = $font .":". $encoding .":". $options;
if ( isset($this->_fonts[$key]) )
return $this->_fonts[$key];
else {
$this->_fonts[$key] = $this->_pdf->load_font($font, $encoding, $options);
return $this->_fonts[$key];
}
}
/**
* Remaps y coords from 4th to 1st quadrant
*
* @param float $y
* @return float
*/
protected function y($y) { return $this->_height - $y; }
//........................................................................
function line($x1, $y1, $x2, $y2, $color, $width, $style = null) {
$this->_set_line_style($width, "butt", "", $style);
$this->_set_stroke_color($color);
$y1 = $this->y($y1);
$y2 = $this->y($y2);
$this->_pdf->moveto($x1,$y1);
$this->_pdf->lineto($x2, $y2);
$this->_pdf->stroke();
}
//........................................................................
function rectangle($x1, $y1, $w, $h, $color, $width, $style = null) {
$this->_set_stroke_color($color);
$this->_set_line_style($width, "square", "miter", $style);
$y1 = $this->y($y1) - $h;
$this->_pdf->rect($x1, $y1, $w, $h);
$this->_pdf->stroke();
}
//........................................................................
function filled_rectangle($x1, $y1, $w, $h, $color) {
$this->_set_fill_color($color);
$y1 = $this->y($y1) - $h;
$this->_pdf->rect($x1, $y1, $w, $h);
$this->_pdf->fill();
}
//........................................................................
function polygon($points, $color, $width = null, $style = null, $fill = false) {
$this->_set_fill_color($color);
$this->_set_stroke_color($color);
if ( !$fill && isset($width) )
$this->_set_line_style($width, "square", "miter", $style);
$y = $this->y(array_pop($points));
$x = array_pop($points);
$this->_pdf->moveto($x,$y);
while (count($points) > 1) {
$y = $this->y(array_pop($points));
$x = array_pop($points);
$this->_pdf->lineto($x,$y);
}
if ( $fill )
$this->_pdf->fill();
else
$this->_pdf->closepath_stroke();
}
//........................................................................
function circle($x, $y, $r, $color, $width = null, $style = null, $fill = false) {
$this->_set_fill_color($color);
$this->_set_stroke_color($color);
if ( !$fill && isset($width) )
$this->_set_line_style($width, "round", "round", $style);
$y = $this->y($y);
$this->_pdf->circle($x, $y, $r);
if ( $fill )
$this->_pdf->fill();
else
$this->_pdf->stroke();
}
//........................................................................
function image($img_url, $img_type, $x, $y, $w, $h) {
$w = (int)$w;
$h = (int)$h;
$img_type = strtolower($img_type);
if ( $img_type === "jpg" )
$img_type = "jpeg";
if ( isset($this->_imgs[$img_url]) )
$img = $this->_imgs[$img_url];
else {
$img = $this->_imgs[$img_url] = $this->_pdf->load_image($img_type, $img_url, "");
}
$y = $this->y($y) - $h;
$this->_pdf->fit_image($img, $x, $y, 'boxsize={'. "$w $h" .'} fitmethod=entire');
}
//........................................................................
function text($x, $y, $text, $font, $size, $color = array(0,0,0), $adjust = 0, $angle = 0) {
$fh = $this->_load_font($font);
$this->_pdf->setfont($fh, $size);
$this->_set_fill_color($color);
$y = $this->y($y) - Font_Metrics::get_font_height($font, $size);
$adjust = (float)$adjust;
$angle = -(float)$angle;
$this->_pdf->fit_textline($text, $x, $y, "rotate=$angle wordspacing=$adjust");
}
//........................................................................
function javascript($code) {
// Not implemented
}
//........................................................................
/**
* Add a named destination (similar to ... in html)
*
* @param string $anchorname The name of the named destination
*/
function add_named_dest($anchorname) {
$this->_pdf->add_nameddest($anchorname,"");
}
//........................................................................
/**
* Add a link to the pdf
*
* @param string $url The url to link to
* @param float $x The x position of the link
* @param float $y The y position of the link
* @param float $width The width of the link
* @param float $height The height of the link
*/
function add_link($url, $x, $y, $width, $height) {
$y = $this->y($y) - $height;
if ( strpos($url, '#') === 0 ) {
// Local link
$name = substr($url,1);
if ( $name )
$this->_pdf->create_annotation($x, $y, $x + $width, $y + $height, 'Link', "contents={$url} destname=". substr($url,1) . " linewidth=0");
} else {
list($proto, $host, $path, $file) = explode_url($url);
if ( $proto == "" || $proto === "file://" )
return; // Local links are not allowed
$url = build_url($proto, $host, $path, $file);
$url = '{' . rawurldecode($url) . '}';
$action = $this->_pdf->create_action("URI", "url=" . $url);
$this->_pdf->create_annotation($x, $y, $x + $width, $y + $height, 'Link', "contents={$url} action={activate=$action} linewidth=0");
}
}
//........................................................................
function get_text_width($text, $font, $size, $spacing = 0) {
$fh = $this->_load_font($font);
// Determine the additional width due to extra spacing
$num_spaces = mb_substr_count($text," ");
$delta = $spacing * $num_spaces;
return $this->_pdf->stringwidth($text, $fh, $size) + $delta;
}
//........................................................................
function get_font_height($font, $size) {
$fh = $this->_load_font($font);
$this->_pdf->setfont($fh, $size);
$asc = $this->_pdf->get_value("ascender", $fh);
$desc = $this->_pdf->get_value("descender", $fh);
// $desc is usually < 0,
return self::FONT_HEIGHT_SCALE * $size * ($asc - $desc);
}
//........................................................................
/**
* Writes text at the specified x and y coordinates on every page
*
* The strings '{PAGE_NUM}' and '{PAGE_COUNT}' are automatically replaced
* with their current values.
*
* See {@link Style::munge_colour()} for the format of the colour array.
*
* @param float $x
* @param float $y
* @param string $text the text to write
* @param string $font the font file to use
* @param float $size the font size, in points
* @param array $color
* @param float $adjust word spacing adjustment
* @param float $angle angle to write the text at, measured CW starting from the x-axis
*/
function page_text($x, $y, $text, $font, $size, $color = array(0,0,0),
$adjust = 0, $angle = 0, $blend = "Normal", $opacity = 1.0) {
$_t = "text";
$this->_page_text[] = compact("_t", "x", "y", "text", "font", "size", "color", "adjust", "angle");
}
//........................................................................
/**
* Processes a script on every page
*
* The variables $pdf, $PAGE_NUM, and $PAGE_COUNT are available.
*
* This function can be used to add page numbers to all pages
* after the first one, for example.
*
* @param string $code the script code
* @param string $type the language type for script
*/
function page_script($code, $type = "text/php") {
$_t = "script";
$this->_page_text[] = compact("_t", "code", "type");
}
//........................................................................
function new_page() {
// Add objects to the current page
$this->_place_objects();
$this->_pdf->suspend_page("");
$this->_pdf->begin_page_ext($this->_width, $this->_height, "");
$this->_page_number = ++$this->_page_count;
}
//........................................................................
/**
* Add text to each page after rendering is complete
*/
protected function _add_page_text() {
if ( !count($this->_page_text) )
return;
$this->_pdf->suspend_page("");
for ($p = 1; $p <= $this->_page_count; $p++) {
$this->_pdf->resume_page("pagenumber=$p");
foreach ($this->_page_text as $pt) {
extract($pt);
switch ($_t) {
case "text":
$text = str_replace(array("{PAGE_NUM}","{PAGE_COUNT}"),
array($p, $this->_page_count), $text);
$this->text($x, $y, $text, $font, $size, $color, $adjust, $angle);
break;
case "script":
if (!$eval) {
$eval = new PHP_Evaluator($this);
}
$eval->evaluate($code, array('PAGE_NUM' => $p, 'PAGE_COUNT' => $this->_page_count));
break;
}
}
$this->_pdf->suspend_page("");
}
$this->_pdf->resume_page("pagenumber=".$this->_page_number);
}
//........................................................................
function stream($filename, $options = null) {
// Add page text
$this->_add_page_text();
if ( isset($options["compress"]) && $options["compress"] != 1 )
$this->_pdf->set_value("compress", 0);
else
$this->_pdf->set_value("compress", 6);
$this->_close();
if ( self::$IN_MEMORY ) {
$data = $this->_pdf->get_buffer();
$size = strlen($data);
} else
$size = filesize($this->_file);
$filename = str_replace(array("\n","'"),"", $filename);
$attach = (isset($options["Attachment"]) && $options["Attachment"]) ? "attachment" : "inline";
header("Cache-Control: private");
header("Content-type: application/pdf");
header("Content-Disposition: $attach; filename=\"$filename\"");
//header("Content-length: " . $size);
if ( self::$IN_MEMORY )
echo $data;
else {
// Chunked readfile()
$chunk = (1 << 21); // 2 MB
$fh = fopen($this->_file, "rb");
if ( !$fh )
throw new DOMPDF_Exception("Unable to load temporary PDF file: " . $this->_file);
while ( !feof($fh) )
echo fread($fh,$chunk);
fclose($fh);
//debugpng
if (DEBUGPNG) print '[pdflib stream unlink '.$this->_file.']';
if (!DEBUGKEEPTEMP)
unlink($this->_file);
$this->_file = null;
}
flush();
}
//........................................................................
function output($options = null) {
// Add page text
$this->_add_page_text();
if ( isset($options["compress"]) && $options["compress"] != 1 )
$this->_pdf->set_value("compress", 0);
else
$this->_pdf->set_value("compress", 6);
$this->_close();
if ( self::$IN_MEMORY )
$data = $this->_pdf->get_buffer();
else {
$data = file_get_contents($this->_file);
//debugpng
if (DEBUGPNG) print '[pdflib output unlink '.$this->_file.']';
if (!DEBUGKEEPTEMP)
unlink($this->_file);
$this->_file = null;
}
return $data;
}
}
// Workaround for idiotic limitation on statics...
PDFLib_Adapter::$PAPER_SIZES = CPDF_Adapter::$PAPER_SIZES;