g the current * one. * * @param int $object */ public function stop_object($object) { $this->_pdf->stopObject($object); } /** * Serialize the pdf object's current state for retrieval later */ public function serialize_object($id) { return $this->_pdf->serializeObject($id); } public function reopen_serialized_object($obj) { return $this->_pdf->restoreSerializedObject($obj); } //........................................................................ public function get_width() { return $this->_width; } public function get_height() { return $this->_height; } public function get_page_number() { return $this->_page_number; } public function get_page_count() { return $this->_page_count; } /** * Sets the current page number * * @param int $num */ public function set_page_number($num) { $this->_page_number = $num; } public function set_page_count($count) { $this->_page_count = $count; } /** * Sets the stroke color * * See {@link Style::set_color()} for the format of the color array. * * @param array $color */ protected function _set_stroke_color($color) { $this->_pdf->setStrokeColor($color); $alpha = isset($color["alpha"]) ? $color["alpha"] : 1; $alpha *= $this->_current_opacity; $this->_set_line_transparency("Normal", $alpha); } /** * Sets the fill colour * * See {@link Style::set_color()} for the format of the colour array. * * @param array $color */ protected function _set_fill_color($color) { $this->_pdf->setColor($color); $alpha = isset($color["alpha"]) ? $color["alpha"] : 1; $alpha *= $this->_current_opacity; $this->_set_fill_transparency("Normal", $alpha); } /** * Sets line transparency * @see Cpdf::setLineTransparency() * * Valid blend modes are (case-sensitive): * * Normal, Multiply, Screen, Overlay, Darken, Lighten, * ColorDodge, ColorBurn, HardLight, SoftLight, Difference, * Exclusion * * @param string $mode the blending mode to use * @param float $opacity 0.0 fully transparent, 1.0 fully opaque */ protected function _set_line_transparency($mode, $opacity) { $this->_pdf->setLineTransparency($mode, $opacity); } /** * Sets fill transparency * @see Cpdf::setFillTransparency() * * Valid blend modes are (case-sensitive): * * Normal, Multiply, Screen, Overlay, Darken, Lighten, * ColorDogde, ColorBurn, HardLight, SoftLight, Difference, * Exclusion * * @param string $mode the blending mode to use * @param float $opacity 0.0 fully transparent, 1.0 fully opaque */ protected function _set_fill_transparency($mode, $opacity) { $this->_pdf->setFillTransparency($mode, $opacity); } /** * Sets the line style * * @see Cpdf::setLineStyle() * * @param float $width * @param string $cap * @param string $join * @param array $dash */ protected function _set_line_style($width, $cap, $join, $dash) { $this->_pdf->setLineStyle($width, $cap, $join, $dash); } public function set_opacity(float $opacity, string $mode = "Normal"): void { $this->_set_line_transparency($mode, $opacity); $this->_set_fill_transparency($mode, $opacity); $this->_current_opacity = $opacity; } public function set_default_view($view, $options = []) { array_unshift($options, $view); call_user_func_array([$this->_pdf, "openHere"], $options); } /** * Remaps y coords from 4th to 1st quadrant * * @param float $y * @return float */ protected function y($y) { return $this->_height - $y; } public function line($x1, $y1, $x2, $y2, $color, $width, $style = [], $cap = "butt") { $this->_set_stroke_color($color); $this->_set_line_style($width, $cap, "", $style); $this->_pdf->line($x1, $this->y($y1), $x2, $this->y($y2)); $this->_set_line_transparency("Normal", $this->_current_opacity); } public function arc($x, $y, $r1, $r2, $astart, $aend, $color, $width, $style = [], $cap = "butt") { $this->_set_stroke_color($color); $this->_set_line_style($width, $cap, "", $style); $this->_pdf->ellipse($x, $this->y($y), $r1, $r2, 0, 8, $astart, $aend, false, false, true, false); $this->_set_line_transparency("Normal", $this->_current_opacity); } public function rectangle($x1, $y1, $w, $h, $color, $width, $style = [], $cap = "butt") { $this->_set_stroke_color($color); $this->_set_line_style($width, $cap, "", $style); $this->_pdf->rectangle($x1, $this->y($y1) - $h, $w, $h); $this->_set_line_transparency("Normal", $this->_current_opacity); } public function filled_rectangle($x1, $y1, $w, $h, $color) { $this->_set_fill_color($color); $this->_pdf->filledRectangle($x1, $this->y($y1) - $h, $w, $h); $this->_set_fill_transparency("Normal", $this->_current_opacity); } public function clipping_rectangle($x1, $y1, $w, $h) { $this->_pdf->clippingRectangle($x1, $this->y($y1) - $h, $w, $h); } public function clipping_roundrectangle($x1, $y1, $w, $h, $rTL, $rTR, $rBR, $rBL) { $this->_pdf->clippingRectangleRounded($x1, $this->y($y1) - $h, $w, $h, $rTL, $rTR, $rBR, $rBL); } public function clipping_polygon(array $points): void { // Adjust y values for ($i = 1; $i < count($points); $i += 2) { $points[$i] = $this->y($points[$i]); } $this->_pdf->clippingPolygon($points); } public function clipping_end() { $this->_pdf->clippingEnd(); } public function save() { $this->_pdf->saveState(); } public function restore() { $this->_pdf->restoreState(); } public function rotate($angle, $x, $y) { $this->_pdf->rotate($angle, $x, $y); } public function skew($angle_x, $angle_y, $x, $y) { $this->_pdf->skew($angle_x, $angle_y, $x, $y); } public function scale($s_x, $s_y, $x, $y) { $this->_pdf->scale($s_x, $s_y, $x, $y); } public function translate($t_x, $t_y) { $this->_pdf->translate($t_x, $t_y); } public function transform($a, $b, $c, $d, $e, $f) { $this->_pdf->transform([$a, $b, $c, $d, $e, $f]); } public function polygon($points, $color, $width = null, $style = [], $fill = false) { $this->_set_fill_color($color); $this->_set_stroke_color($color); if (!$fill && isset($width)) { $this->_set_line_style($width, "square", "miter", $style); } // Adjust y values for ($i = 1; $i < count($points); $i += 2) { $points[$i] = $this->y($points[$i]); } $this->_pdf->polygon($points, $fill); $this->_set_fill_transparency("Normal", $this->_current_opacity); $this->_set_line_transparency("Normal", $this->_current_opacity); } public function circle($x, $y, $r, $color, $width = null, $style = [], $fill = false) { $this->_set_fill_color($color); $this->_set_stroke_color($color); if (!$fill && isset($width)) { $this->_set_line_style($width, "round", "round", $style); } $this->_pdf->ellipse($x, $this->y($y), $r, 0, 0, 8, 0, 360, 1, $fill); $this->_set_fill_transparency("Normal", $this->_current_opacity); $this->_set_line_transparency("Normal", $this->_current_opacity); } /** * Convert image to a PNG image * * @param string $image_url * @param string $type * * @return string|null The url of the newly converted image */ protected function _convert_to_png($image_url, $type) { $filename = Cache::getTempImage($image_url); if ($filename !== null && file_exists($filename)) { return $filename; } $func_name = "imagecreatefrom$type"; set_error_handler([Helpers::class, "record_warnings"]); if (!function_exists($func_name)) { if (!method_exists(Helpers::class, $func_name)) { throw new Exception("Function $func_name() not found. Cannot convert $type image: $image_url. Please install the image PHP extension."); } $func_name = [Helpers::class, $func_name]; } try { $im = call_user_func($func_name, $image_url); if ($im) { imageinterlace($im, false); $tmp_dir = $this->_dompdf->getOptions()->getTempDir(); $tmp_name = @tempnam($tmp_dir, "{$type}_dompdf_img_"); @unlink($tmp_name); $filename = "$tmp_name.png"; imagepng($im, $filename); imagedestroy($im); } else { $filename = null; } } finally { restore_error_handler(); } if ($filename !== null) { Cache::addTempImage($image_url, $filename); } return $filename; } public function image($img, $x, $y, $w, $h, $resolution = "normal") { [$width, $height, $type] = Helpers::dompdf_getimagesize($img, $this->get_dompdf()->getHttpContext()); $debug_png = $this->_dompdf->getOptions()->getDebugPng(); if ($debug_png) { print "[image:$img|$width|$height|$type]"; } switch ($type) { case "jpeg": if ($debug_png) { print '!!!jpg!!!'; } $this->_pdf->addJpegFromFile($img, $x, $this->y($y) - $h, $w, $h); break; case "webp": /** @noinspection PhpMissingBreakStatementInspection */ case "gif": /** @noinspection PhpMissingBreakStatementInspection */ case "bmp": if ($debug_png) print "!!!{$type}!!!"; $img = $this->_convert_to_png($img, $type); if ($img === null) { if ($debug_png) print '!!!conversion to PDF failed!!!'; $this->image(Cache::$broken_image, $x, $y, $w, $h, $resolution); break; } case "png": if ($debug_png) print '!!!png!!!'; $this->_pdf->addPngFromFile($img, $x, $this->y($y) - $h, $w, $h); break; case "svg": if ($debug_png) print '!!!SVG!!!'; $this->_pdf->addSvgFromFile($img, $x, $this->y($y) - $h, $w, $h); break; default: if ($debug_png) print '!!!unknown!!!'; } } public function select($x, $y, $w, $h, $font, $size, $color = [0, 0, 0], $opts = []) { $pdf = $this->_pdf; $font .= ".afm"; $pdf->selectFont($font); if (!isset($pdf->acroFormId)) { $pdf->addForm(); } $ft = \Dompdf\Cpdf::ACROFORM_FIELD_CHOICE; $ff = \Dompdf\Cpdf::ACROFORM_FIELD_CHOICE_COMBO; $id = $pdf->addFormField($ft, rand(), $x, $this->y($y) - $h, $x + $w, $this->y($y), $ff, $size, $color); $pdf->setFormFieldOpt($id, $opts); } public function textarea($x, $y, $w, $h, $font, $size, $color = [0, 0, 0]) { $pdf = $this->_pdf; $font .= ".afm"; $pdf->selectFont($font); if (!isset($pdf->acroFormId)) { $pdf->addForm(); } $ft = \Dompdf\Cpdf::ACROFORM_FIELD_TEXT; $ff = \Dompdf\Cpdf::ACROFORM_FIELD_TEXT_MULTILINE; $pdf->addFormField($ft, rand(), $x, $this->y($y) - $h, $x + $w, $this->y($y), $ff, $size, $color); } public function input($x, $y, $w, $h, $type, $font, $size, $color = [0, 0, 0]) { $pdf = $this->_pdf; $font .= ".afm"; $pdf->selectFont($font); if (!isset($pdf->acroFormId)) { $pdf->addForm(); } $ft = \Dompdf\Cpdf::ACROFORM_FIELD_TEXT; $ff = 0; switch ($type) { case 'text': $ft = \Dompdf\Cpdf::ACROFORM_FIELD_TEXT; break; case 'password': $ft = \Dompdf\Cpdf::ACROFORM_FIELD_TEXT; $ff = \Dompdf\Cpdf::ACROFORM_FIELD_TEXT_PASSWORD; break; case 'submit': $ft = \Dompdf\Cpdf::ACROFORM_FIELD_BUTTON; break; } $pdf->addFormField($ft, rand(), $x, $this->y($y) - $h, $x + $w, $this->y($y), $ff, $size, $color); } public function text($x, $y, $text, $font, $size, $color = [0, 0, 0], $word_space = 0.0, $char_space = 0.0, $angle = 0.0) { $pdf = $this->_pdf; $this->_set_fill_color($color); $is_font_subsetting = $this->_dompdf->getOptions()->getIsFontSubsettingEnabled(); $pdf->selectFont($font . '.afm', '', true, $is_font_subsetting); $pdf->addText($x, $this->y($y) - $pdf->getFontHeight($size), $size, $text, $angle, $word_space, $char_space); $this->_set_fill_transparency("Normal", $this->_current_opacity); } public function javascript($code) { $this->_pdf->addJavascript($code); } //........................................................................ public function add_named_dest($anchorname) { $this->_pdf->addDestination($anchorname, "Fit"); } public 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->addInternalLink($name, $x, $y, $x + $width, $y + $height); } } else { $this->_pdf->addLink($url, $x, $y, $x + $width, $y + $height); } } /** * @throws FontNotFoundException */ public function get_text_width($text, $font, $size, $word_spacing = 0.0, $char_spacing = 0.0) { $this->_pdf->selectFont($font, '', true, $this->_dompdf->getOptions()->getIsFontSubsettingEnabled()); return $this->_pdf->getTextWidth($size, $text, $word_spacing, $char_spacing); } /** * @throws FontNotFoundException */ public function get_font_height($font, $size) { $options = $this->_dompdf->getOptions(); $this->_pdf->selectFont($font, '', true, $options->getIsFontSubsettingEnabled()); return $this->_pdf->getFontHeight($size) * $options->getFontHeightRatio(); } /*function get_font_x_height($font, $size) { $this->_pdf->selectFont($font); $ratio = $this->_dompdf->getOptions()->getFontHeightRatio(); return $this->_pdf->getFontXHeight($size) * $ratio; }*/ /** * @throws FontNotFoundException */ public function get_font_baseline($font, $size) { $ratio = $this->_dompdf->getOptions()->getFontHeightRatio(); return $this->get_font_height($font, $size) / $ratio; } /** * Processes a callback or script on every page. * * The callback function receives the four parameters `int $pageNumber`, * `int $pageCount`, `Canvas $canvas`, and `FontMetrics $fontMetrics`, in * that order. If a script is passed as string, the variables `$PAGE_NUM`, * `$PAGE_COUNT`, `$pdf`, and `$fontMetrics` are available instead. Passing * a script as string is deprecated and will be removed in a future version. * * This function can be used to add page numbers to all pages after the * first one, for example. * * @param callable|string $callback The callback function or PHP script to process on every page */ public function page_script($callback): void { if (is_string($callback)) { $this->processPageScript(function ( int $PAGE_NUM, int $PAGE_COUNT, self $pdf, FontMetrics $fontMetrics ) use ($callback) { eval($callback); }); return; } $this->processPageScript($callback); } public function page_text($x, $y, $text, $font, $size, $color = [0, 0, 0], $word_space = 0.0, $char_space = 0.0, $angle = 0.0) { $this->processPageScript(function (int $pageNumber, int $pageCount) use ($x, $y, $text, $font, $size, $color, $word_space, $char_space, $angle) { $text = str_replace( ["{PAGE_NUM}", "{PAGE_COUNT}"], [$pageNumber, $pageCount], $text ); $this->text($x, $y, $text, $font, $size, $color, $word_space, $char_space, $angle); }); } public function page_line($x1, $y1, $x2, $y2, $color, $width, $style = []) { $this->processPageScript(function () use ($x1, $y1, $x2, $y2, $color, $width, $style) { $this->line($x1, $y1, $x2, $y2, $color, $width, $style); }); } /** * @return int */ public function new_page() { $this->_page_number++; $this->_page_count++; $ret = $this->_pdf->newPage(); $this->_pages[] = $ret; return $ret; } protected function processPageScript(callable $callback): void { $pageNumber = 1; foreach ($this->_pages as $pid) { $this->reopen_object($pid); $fontMetrics = $this->_dompdf->getFontMetrics(); $callback($pageNumber, $this->_page_count, $this, $fontMetrics); $this->close_object(); $pageNumber++; } } public function stream($filename = "document.pdf", $options = []) { if (headers_sent()) { die("Unable to stream pdf: headers already sent"); } if (!isset($options["compress"])) $options["compress"] = true; if (!isset($options["Attachment"])) $options["Attachment"] = true; $debug = !$options['compress']; $tmp = ltrim($this->_pdf->output($debug)); header("Cache-Control: private"); header("Content-Type: application/pdf"); header("Content-Length: " . mb_strlen($tmp, "8bit")); $filename = str_replace(["\n", "'"], "", basename($filename, ".pdf")) . ".pdf"; $attachment = $options["Attachment"] ? "attachment" : "inline"; header(Helpers::buildContentDispositionHeader($attachment, $filename)); echo $tmp; flush(); } public function output($options = []) { if (!isset($options["compress"])) $options["compress"] = true; $debug = !$options['compress']; return $this->_pdf->output($debug); } /** * Returns logging messages generated by the Cpdf class * * @return string */ public function get_messages() { return $this->_pdf->messages; } }