PhpDig.net

What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.




cpdf_save

Name

cpdf_save — Saves current enviroment

Synopsis

bool cpdf_save(pdfdoc);
resource pdfdoc: PDF document identifier

Returns

TRUE on success or FALSE on error

Description

Saves the current graphical state of the PDF document. This includes graphics parameters such as clipping path, coordinate system, current point, dash pattern, flatness, line cap style, line join style, line width, miter limit and color parameters like fill and stroke colors. In addition, some PDF parameters are saved including character spacing, word spacing, horizontal scaling, leading, font, fontsize, text rendering and text rise.

In the example below, try commenting out the lines calling cpdf_save() and cpdf_restore() to measure the effect of saving and restoring the environment.

Version

Since versions 3.0.8 and 4.0

Example

Example 148. Save and restore text state

// start a PDF document
$cpdf = cpdf_open(0, "test.pdf");

// create a 600x400 page
cpdf_page_init($cpdf, 1, 0, 600, 400, 1);

// display text in document
cpdf_begin_text($cpdf);
cpdf_set_font($cpdf, "Helvetica", 15, "WinAnsiEncoding");
cpdf_set_text_pos($cpdf, 50, 300);
cpdf_show($cpdf, "This is horizontal text");

// save the current document state
cpdf_save($cpdf);

// move and rotate the coordinate system
cpdf_translate($cpdf, 20, 20); 
cpdf_rotate($cpdf, 90); 

// move drawing position
cpdf_set_text_pos($cpdf, 10, 10);

// display text
cpdf_show($cpdf, "vertical text");

// restore the documents previous state
cpdf_restore($cpdf);

// draw more horizontal text
// note use of cpdf_continue_text() for effect
cpdf_set_leading($cpdf, 15);
cpdf_continue_text($cpdf, "horizontal text continues");

cpdf_end_text($cpdf);

// close and write document
cpdf_finalize($cpdf);
cpdf_close($cpdf);



PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.

Powered by: vBulletin Version 3.0.7
Copyright ©2000 - 2005, Jelsoft Enterprises Ltd.
Copyright © 2001 - 2005, ThinkDing LLC. All Rights Reserved.