SELFPHP-Druckversion

SELFPHP-Druckversion
Original Adresse dieser Seite:
http://www.selfphp.de/funktionsreferenz/pdf_funktionen/pdf_scale.php
© 2001-2024

SELFPHP Inh. Damir Enseleit, info@selfphp.de

pdf_scale

Befehl

bool PDF_scale ( resource $p, float $sx, float $sy )

Version

(PHP 4, PECL pdflib:1.0-2.1.2)

Beschreibung

Mit pdf_scale() setzt man innerhalb eines PDF-Dokuments (PDF-Dokument) einen Skalierungsfaktor, welcher sich auf alle nachfolgenden Funktionen auswirkt. Dabei wird mittels der Werte x-Skalierung und y-Skalierung festgelegt, um welchen Faktor die X- und Y-Koordinatenpunkte skaliert werden sollen. Durch die Skalierung wird nicht nur das gezeichnete Objekt vergrößert bzw. verkleinert, sondern auch um den Skalierungsfaktor verschoben. Es ist darauf zu achten, dass der Skalierungsfaktor nicht 0 sein darf, da es sonst zu einer Fehlermeldung kommen wird.

Folgende Skalierungswerte sind zulässig:

• 0.1 ' 0.9 - Verkleinerung des Objekts
• 1 - Normale Ansicht des Objekts
• 1.1 ' ~ - Vergrößerung des Objekts

Im unten stehenden Beispiel wurden zwei Linien exakt auf die gleichen Koordinaten und mit der gleichen Länge gezeichnet. Bei einer Linie wurden allerdings horizontale und vertikale Skalierungsfaktoren von jeweils 4.5 angegeben. Diese Linie ist daher um das 4,5fache vergrößert und um das 4,5fache verschoben.

Siehe auch:

• pdf_lineto()
• pdf_moveto()
• pdf_stroke()

Beispiel



<?PHP

$file = fopen ( 'php.pdf', 'w' );



$dokument = pdf_open ( $file );



pdf_begin_page ( $dokument, 200, 100 );



pdf_moveto ( $dokument, 0, 15 );



pdf_lineto ( $dokument, 40, 15 );



pdf_stroke ( $dokument );



pdf_scale ( $dokument, 4.5, 4.5 );



pdf_moveto ( $dokument, 0, 15 );



pdf_lineto ( $dokument, 40, 15 );



pdf_stroke ( $dokument );



pdf_end_page ( $dokument );



pdf_close ( $dokument );



fclose ( $file );

?>

Ausgabe

Achtung: Bei der Ausgabe des Befehls wird im Browser nichts zurückgegeben. Die obenstehende Grafik wurde im Acrobat-Reader geöffnet um die Wirkungsweise des Befehls zu zeigen.