| blob | 06926795f2c34eb6d16e8b11f61171cebc6fc94f |
1 <sect1 id="zend.pdf.drawing">
2 <title>Rysowanie</title>
4 <sect2 id="zend.pdf.drawing.geometry">
5 <title>Geometria</title>
6 <para>
7 PDF używa takiej samej geometrii jak PostScript. Zaczyna z lewego dolnego
8 rogu strony, a jednostka domyślnie jest wyrażana w punktach (1/72 cala).
9 </para>
10 <para>
11 Rozmiar strony może być pobrany z obiektu strony:
12 </para>
13 <para>
14 <programlisting role="php"><![CDATA[
15 $width = $pdfPage->getWidth();
16 $height = $pdfPage->getHeight();
17 ]]>
18 </programlisting>
19 </para>
20 </sect2>
22 <sect2 id="zend.pdf.drawing.color">
23 <title>Kolory</title>
24 <para>
25 PDF ma bardzo rozbudowane możliwości reprezentowania kolorów. Zend_Pdf
26 wspiera palety Grey Scale, RGB oraz CMYK. Każda z nich może być użyta
27 wszędzie, gdzie jest wymagany obiekt <code>Zend_Pdf_Color</code>. Klasy
28 <code>Zend_Pdf_Color_GrayScale</code>, <code>Zend_Pdf_Color_Rgb</code> oraz
29 <code>Zend_Pdf_Color_Cmyk</code> zapewniają taką funkcjonalność:
30 </para>
31 <programlisting role="php"><![CDATA[
32 // $grayLevel (liczba zmiennoprzecinkowa)
33 // 0.0 (czarny) - 1.0 (biały)
34 $color1 = new Zend_Pdf_Color_GrayScale($grayLevel);
36 // $r, $g, $b (liczby zmiennoprzecinkowe)
37 // 0.0 (minimalna intensywność) - 1.0 (maksymalna intensywność)
38 $color2 = new Zend_Pdf_Color_Rgb($r, $g, $b);
40 // $c, $m, $y, $k (liczby zmiennoprzecinkowe)
41 // 0.0 (minimalna intensywność) - 1.0 (maksymalna intensywność)
42 $color3 = new Zend_Pdf_Color_Cmyk($c, $m, $y, $k);
43 ]]>
44 </programlisting>
46 <para>
47 HTML style colors are also provided with <code>Zend_Pdf_Color_Html</code> class:
48 </para>
49 <programlisting role="php"><![CDATA[
50 $color1 = new Zend_Pdf_Color_Html('#3366FF');
51 $color2 = new Zend_Pdf_Color_Html('silver');
52 $color3 = new Zend_Pdf_Color_Html('forestgreen');
53 ]]>
54 </programlisting>
55 </sect2>
58 <sect2 id="zend.pdf.drawing.shape-drawing">
59 <title>Rysowanie figur</title>
60 <para>
61 Wszystkie operacje rysowania mogą być przeprowadzone w kontekście strony PDF.
62 </para>
63 <para>
64 Klasa <code>Zend_Pdf_Page</code> zapewnia zestaw podstawowych operacji rysowania:
65 </para>
66 <programlisting role="php"><![CDATA[
67 /**
68 * Rysuje linię z punktu x1,y1 do x2,y2.
69 *
70 * @param float $x1
71 * @param float $y1
72 * @param float $x2
73 * @param float $y2
74 */
75 public function drawLine($x1, $y1, $x2, $y2);
76 ]]>
77 </programlisting>
78 <programlisting role="php"><![CDATA[
79 /**
80 * Rysuje prostokąt.
81 *
82 * Typy wypełnienia:
83 * Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE - wypełnia i obramowuje
84 * prostokąt (domyślnie)
85 * Zend_Pdf_Page::SHAPE_DRAW_STROKE - obramowuje prostokąt
86 * Zend_Pdf_Page::SHAPE_DRAW_FILL - wypełnia prostokąt
87 *
88 * @param float $x1
89 * @param float $y1
90 * @param float $x2
91 * @param float $y2
92 * @param integer $fillType
93 */
94 public function drawRectangle($x1, $y1, $x2, $y2,
95 $fillType = Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE);
96 ]]>
97 </programlisting>
98 <programlisting role="php"><![CDATA[
99 /**
100 * Rysuje wielokąt.
101 *
102 * Jeśli $fillType ma wartość Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE
103 * lub Zend_Pdf_Page::SHAPE_DRAW_FILL, wtedy wielokąt jest automatycznie
104 * zamknięty. Zobacz szczegółową dokumentację tych metod w dokumentacji
105 * PDF (sekcja 4.4.2 Path painting Operators, Filling)
106 *
107 * @param array $x - array of float (the X co-ordinates of the vertices)
108 * @param array $y - array of float (the Y co-ordinates of the vertices)
109 * @param integer $fillType
110 * @param integer $fillMethod
111 */
112 public function drawPolygon($x, $y,
113 $fillType =
114 Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE,
115 $fillMethod =
116 Zend_Pdf_Page::FILL_METHOD_NON_ZERO_WINDING);
117 ]]>
118 </programlisting>
119 <programlisting role="php"><![CDATA[
120 /**
121 * Rysuje okrąg o środku w punkcie $x, $y o promieniu $radius.
122 *
123 * Kąty są określane w radianach.
124 *
125 * Sygnatury metod:
126 * drawCircle($x, $y, $radius);
127 * drawCircle($x, $y, $radius, $fillType);
128 * drawCircle($x, $y, $radius, $startAngle, $endAngle);
129 * drawCircle($x, $y, $radius, $startAngle, $endAngle, $fillType);
130 *
131 *
132 * Nie jest to do końca okrąg, ponieważ PDF obsługuje jedynie
133 * kubiczne krzywe Beziera. Ale jest to bardzo dobre przybliżenie.
134 * Różni się od realnego okręgu maksymalnie o 0.00026 promienia
135 * (przy kątach PI/8, 3*PI/8, 5*PI/8, 7*PI/8, 9*PI/8, 11*PI/8,
136 * 13*PI/8 oraz 15*PI/8). Przy kątach 0, PI/4, PI/2, 3*PI/4, PI,
137 * 5*PI/4, 3*PI/2 oraz 7*PI/4 jest to dokładny okrąg.
138 *
139 * @param float $x
140 * @param float $y
141 * @param float $radius
142 * @param mixed $param4
143 * @param mixed $param5
144 * @param mixed $param6
145 */
146 public function drawCircle($x,
147 $y,
148 $radius,
149 $param4 = null,
150 $param5 = null,
151 $param6 = null);
152 ]]>
153 </programlisting>
154 <programlisting role="php"><![CDATA[
155 /**
156 * Rysuje elipsę wewnątrz określonego prostokąta.
157 *
158 * Sygnatury metod:
159 * drawEllipse($x1, $y1, $x2, $y2);
160 * drawEllipse($x1, $y1, $x2, $y2, $fillType);
161 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
162 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle, $fillType);
163 *
164 * Kąty są określane w radianach
165 *
166 * @param float $x1
167 * @param float $y1
168 * @param float $x2
169 * @param float $y2
170 * @param mixed $param5
171 * @param mixed $param6
172 * @param mixed $param7
173 */
174 public function drawEllipse($x1, $y1, $x2, $y2, $param5 = null, $param6 = null, $param7 = null);
175 ]]>
176 </programlisting>
177 </sect2>
179 <sect2 id="zend.pdf.drawing.text-drawing">
180 <title>Wypisywanie tekstu</title>
181 <para>
182 Operacje wypisywania tekstu także są przeprowadzone w kontekście strony PDF
183 Możesz wypisać pojedynczą linię tekstu w dowolnym miejscu na stronie podając
184 współrzędne x oraz y linii bazowej. W operacjach wypisywania tekstu używana
185 jest czcionka o aktualnie ustawionym kroju oraz rozmiarze (zobacz poniżej
186 szczegółowy opis).
187 </para>
188 <programlisting role="php"><![CDATA[
189 /**
190 * Wypisuje linię tekstu w określonym miejscu.
191 *
192 * @param string $text
193 * @param float $x
194 * @param float $y
195 * @param string $charEncoding (opcjonalny) Kodowanie znaków
196 * tekstu. Domyślnie według ustawień lokalizacji.
197 * @throws Zend_Pdf_Exception
198 */
199 public function drawText($text, $x, $y, $charEncoding = '');
200 ]]>
201 </programlisting>
202 <example id="zend.pdf.drawing.text-drawing.example-1">
203 <title>Wypisywanie tekstu na stronie</title>
204 <programlisting role="php"><![CDATA[
205 ...
206 $pdfPage->drawText('Hello world!', 72, 720);
207 ...
208 ]]>
209 </programlisting>
210 </example>
211 <para>
212 Domyślnie, łańcuchy znaków są interpretowane przy użyciu metod kodowania
213 znaków biężacych ustawień lokalnych. Jeśli masz łańcuch znaków używający
214 innych metod kodowania (na przykład dane jako łańcuch znaków UTF-8 odczytany
215 z pliku na dysku, lub łańcuch znaków MacRoman pobrany z bazy danych),
216 możesz wskazać kodowanie znaków podczas wypisywania tekstu i Zend_Pdf
217 przeprowadzi dla ciebie konwersję. Możesz użyć źródłowego łańcucha znaków
218 w dowolnym kodowaniu obsługiwanym przez funkcję PHP <code><ulink url="http://www.php.net/manual/function.iconv.php">iconv()</ulink></code>:
219 </para>
220 <example id="zend.pdf.drawing.text-drawing.example-2">
221 <title>Wypisywanie tekstu zakodowanego w UTF-8 na stronie</title>
222 <programlisting role="php"><![CDATA[
223 ...
224 // Odczytaj z dysku tekst zakodowany w UTF-8.
225 $unicodeString = fread($fp, 1024);
227 // Wypisz tekst na stronie
228 $pdfPage->drawText($unicodeString, 72, 720, 'UTF-8');
229 ...
230 ]]>
231 </programlisting>
232 </example>
233 </sect2>
235 <sect2 id="zend.pdf.drawing.using-fonts">
236 <title>Użycie czcionek</title>
237 <para>
238 Metoda <code>Zend_Pdf_Page::drawText()</code> używa bieżącego kroju
239 oraz rozmiaru czcionki dla strony, które ustawia się za pomocą metody
240 <code>Zend_Pdf_Page::setFont()</code>:
241 </para>
242 <programlisting role="php"><![CDATA[
243 /**
244 * Ustawia bieżącą czcionkę.
245 *
246 * @param Zend_Pdf_Resource_Font $font
247 * @param float $fontSize
248 */
249 public function setFont(Zend_Pdf_Resource_Font $font, $fontSize);
250 ]]>
251 </programlisting>
252 <para>
253 Dokumenty PDF obsługują czionki PostScript Type 1 oraz TrueType, tak samo
254 dobrze jak dwa wyspecjalizowane typy PDF, Type 3 oraz czcionki złożone Type 0. Jest
255 także 14 standardowych czcionek Type 1 wbudowanych w każdą przeglądarkę PDF:
256 Courier (4 style), Helvetica (4 style), Times (4 style), Symbol, and Zapf Dingbats.
257 </para>
258 <para>
259 Zend_Pdf obecnie obsługuje 14 standardowych czcionek PDF tak samo dobrze
260 jak twoje własne czcionki TrueType. Obiekty czcionek są obsługiwane za pomocą
261 jednej z dwóch metod fabryk: <code>Zend_Pdf_Font::fontWithName($fontName)</code>
262 dla 14 standardowych czcionek PDF lub <code>Zend_Pdf_Font::fontWithPath($filePath)</code>
263 dla własnych czcionek.
264 </para>
265 <example id="zend.pdf.drawing.using-fonts.example-1">
266 <title>Tworzenie standardowej czcionki</title>
267 <programlisting role="php"><![CDATA[
268 ...
269 // Utwórz nową czcionkę
270 $font = Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_HELVETICA);
272 // Ustaw czcionkę
273 $pdfPage->setFont($font, 36);
274 ...
275 ]]>
276 </programlisting>
277 </example>
278 <para>
279 Stałe dla nazwa 14 standardowych czcionek PDF są zdefiniowane w klasie <code>Zend_Pdf_Font</code>:
280 <itemizedlist>
281 <listitem>
282 <para>Zend_Pdf_Font::FONT_COURIER</para>
283 </listitem>
284 <listitem>
285 <para>Zend_Pdf_Font::FONT_COURIER_BOLD</para>
286 </listitem>
287 <listitem>
288 <para>Zend_Pdf_Font::FONT_COURIER_ITALIC</para>
289 </listitem>
290 <listitem>
291 <para>Zend_Pdf_Font::FONT_COURIER_BOLD_ITALIC</para>
292 </listitem>
293 <listitem>
294 <para>Zend_Pdf_Font::FONT_TIMES</para>
295 </listitem>
296 <listitem>
297 <para>Zend_Pdf_Font::FONT_TIMES_BOLD</para>
298 </listitem>
299 <listitem>
300 <para>Zend_Pdf_Font::FONT_TIMES_ITALIC</para>
301 </listitem>
302 <listitem>
303 <para>Zend_Pdf_Font::FONT_TIMES_BOLD_ITALIC</para>
304 </listitem>
305 <listitem>
306 <para>Zend_Pdf_Font::FONT_HELVETICA</para>
307 </listitem>
308 <listitem>
309 <para>Zend_Pdf_Font::FONT_HELVETICA_BOLD</para>
310 </listitem>
311 <listitem>
312 <para>Zend_Pdf_Font::FONT_HELVETICA_ITALIC</para>
313 </listitem>
314 <listitem>
315 <para>Zend_Pdf_Font::FONT_HELVETICA_BOLD_ITALIC</para>
316 </listitem>
317 <listitem>
318 <para>Zend_Pdf_Font::FONT_SYMBOL</para>
319 </listitem>
320 <listitem>
321 <para>Zend_Pdf_Font::FONT_ZAPFDINGBATS</para>
322 </listitem>
323 </itemizedlist>
324 </para>
325 <para>
326 Możesz także użyć dowolnej czcionki TrueType (która najcześciej ma rozszerzenie
327 '.ttf') lub czcionki OpenType (rozszerzenie '.otf') jeśli zawiera czcionke
328 zrobioną według wytycznych TrueType. Obecnie nieobsługiwane, ale planowane
329 w przyszłych wersjach są pliki czcionek Mac OS X .dfont oraz pliki Microsoft
330 TrueType Collection (rozszerzenie '.ttc').
331 </para>
332 <para>
333 Aby użyć czcionki TrueType, musisz podać pełną ścieżke do pliku czcionki.
334 Jeśli z jakiegoś powodu nie może on być odczytany, lub nie jest to czcionka
335 TrueType, metoda fabryki wyrzuci wyjątek:
336 </para>
337 <example id="zend.pdf.drawing.using-fonts.example-2">
338 <title>Tworzenie czcionki TrueType</title>
339 <programlisting role="php"><![CDATA[
340 ...
341 // Utwórz nową czcionkę
342 $goodDogCoolFont = Zend_Pdf_Font::fontWithPath('/path/to/GOODDC__.TTF');
344 // Ustaw czcionkę
345 $pdfPage->setFont($goodDogCoolFont, 36);
346 ...
347 ]]>
348 </programlisting>
349 </example>
350 <para>
351 Domyślnie własne czcionki będą osadzone w wynikowym dokumencie PDF. To
352 pozwala odbiorcom oglądać stronę taką, jaka była zamierzona, nawet gdy
353 nie mają zainstalowanych w systemie potrzebnych czcionek. Jeśli ważny
354 jest dla ciebie rozmiar pliku, możesz zażądać, aby plik czcionki nie
355 był osadzony przekazując opcję 'nie osadzaj' do metody fabryki:
356 </para>
357 <example id="zend.pdf.drawing.using-fonts.example-3">
358 <title>Tworzenie czcionki TrueType, ale bez osadzania jej w dokumencie PDF.</title>
359 <programlisting role="php"><![CDATA[
360 ...
361 // Utwórz nową czcionkę
362 $goodDogCoolFont = Zend_Pdf_Font::fontWithPath('/path/to/GOODDC__.TTF',
363 Zend_Pdf_Font::EMBED_DONT_EMBED);
365 // Ustaw czcionkę
366 $pdfPage->setFont($goodDogCoolFont, 36);
367 ...
368 ]]>
369 </programlisting>
370 </example>
371 <para>
372 Jeśli plik czcionki nie jest osadzony, ale odbiorca pliku PDF posiada taką
373 czcionkę zainstalowaną w swoim systemie, zobaczy on dokument w sposób
374 identyczny z zamierzonym. Jeśli nie ma zainstalowanej odpowiedniej czcionki,
375 przeglądarka PDF użyje najlepszej aby zastąpić czcionkę.
376 </para>
377 <para>
378 Niektóre czcionki mają bardzo specyficzne zasady licencjonowania, które
379 uniemożliwiają osadzenie ich w dokumentach PDF. Także nie złamiesz tych
380 zasad, ponieważ gdy spróbujesz użyć czcionkę, która nie może być osadzona
381 metoda fabryki wyrzuci wyjątek.
382 </para>
383 <para>
384 Możesz wciąż użyć tych czcionek, ale musisz przekazać odpowiedni parametr
385 w celu nieosadzenia czcionki, lub w prosty sposób zignorować wyjątek:
386 </para>
387 <example id="zend.pdf.drawing.using-fonts.example-4">
388 <title>Nie wyrzucanie wyjątku dla czcionek które nie mogą być osadzone.</title>
389 <programlisting role="php"><![CDATA[
390 ...
391 $font = Zend_Pdf_Font::fontWithPath(
392 '/path/to/unEmbeddableFont.ttf',
393 Zend_Pdf_Font::EMBED_SUPPRESS_EMBED_EXCEPTION
394 );
395 ...
396 ]]>
397 </programlisting>
398 </example>
399 <para>
400 Ta technika zignorowania wyjątku jest przydatna, gdy pozwalasz użytkownikowi
401 końcowemu wybierać własne czcionki. Czcionki, ktore mogą być osadzone,
402 będą osadzone w dokumencie PDF; te które nie mogą, nie będą.
403 </para>
404 <para>
405 Pliki czcionek mogą być duże, czasem osiągająć dziesiątki megabajtów.
406 Domyślnie wszystkie osadzane czcionki są kompresowane przy użyciu
407 schematu kompresji Flate, co powoduje zaoszczędzenie średnio 50% miejsca.
408 Jeśli z jakiegoś powodu nie chcesz kompresować plików czcionek, możesz
409 to zablokować opcją:
410 </para>
411 <example id="zend.pdf.drawing.using-fonts.example-5">
412 <title>Nie kompresowanie osadzonych czcionek.</title>
413 <programlisting role="php"><![CDATA[
414 ...
415 $font = Zend_Pdf_Font::fontWithPath('/path/to/someReallyBigFont.ttf',
416 Zend_Pdf_Font::EMBED_DONT_COMPRESS);
417 ...
418 ]]>
419 </programlisting>
420 </example>
421 <para>
422 Ostatecznie, jeśli potrzebujesz, możesz łączyć opcje osadzania czcionek
423 używając bitowego operatora LUB:
424 </para>
425 <example id="zend.pdf.drawing.using-fonts.example-6">
426 <title>Łączenie opcji osadzania czcionki.</title>
427 <programlisting role="php"><![CDATA[
428 ...
429 $font = Zend_Pdf_Font::fontWithPath(
430 $someUserSelectedFontPath,
431 (Zend_Pdf_Font::EMBED_SUPPRESS_EMBED_EXCEPTION |
432 Zend_Pdf_Font::EMBED_DONT_COMPRESS));
433 ...
434 ]]>
435 </programlisting>
436 </example>
437 </sect2>
439 <sect2 id="zend.pdf.drawing.extracting-fonts">
440 <title>Począwszy od 1.5, wyciąganie czcionek.</title>
441 <para>
442 Moduł <code>Zend_Pdf</code> zapewnia możliwość wyciągania czcionek z
443 załadowanych dokumentów.
444 </para>
446 <para>
447 Może być to użyteczne przy inkrementalnych aktualizacjach dokumentów.
448 Bez tej funkcjonalności musiałbyś dołączać czcionkę do dokumentu za każdym
449 razem gdy go aktualizujesz.
450 </para>
452 <para>
453 Obiekty <code>Zend_Pdf</code> oraz <code>Zend_Pdf_Page</code> zapewniają
454 specjalne metody do wyciągania czcionek użytych w dokumencie lub stronie:
455 </para>
456 <example id="zend.pdf.drawing.extracting-fonts.example-1">
457 <title>Wyciąganie czcionek z załadowanego dokumentu.</title>
458 <programlisting role="php"><![CDATA[
459 ...
460 $pdf = Zend_Pdf::load($documentPath);
461 ...
462 // Pobieramy wszystkie czcionki z dokumentu
463 $fontList = $pdf->extractFonts();
464 $pdf->pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4));
465 $yPosition = 700;
466 foreach ($fontList as $font) {
467 $page->setFont($font, 15);
468 $page->drawText(
469 $font->getFontName(Zend_Pdf_Font::NAME_POSTSCRIPT, 'en', 'UTF-8') .
470 ': The quick brown fox jumps over the lazy dog', 100, $yPosition, 'UTF-8');
471 $yPosition -= 30;
472 }
473 ...
474 // Pobieramy czcionki z pierwszej strony dokumentu
475 $firstPage = reset($pdf->pages);
476 $firstPageFonts = $firstPage->extractFonts();
477 ...
478 ]]>
479 </programlisting>
480 </example>
481 <example id="zend.pdf.drawing.extracting-fonts.example-2">
482 <title>Wyciąganie czcionki z załadowanego dokumentu określając jej nazwę.</title>
483 <programlisting role="php"><![CDATA[
484 ...
485 $pdf = new Zend_Pdf();
486 ...
487 $pdf->pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4));
489 $font = Zend_Pdf_Font::fontWithPath($fontPath);
490 $page->setFont($font, $fontSize);
491 $page->drawText($text, $x, $y);
492 ...
493 // Nazwa tej czcionki powinna zostać gdzieś zapisana
494 $fontName = $font->getFontName(Zend_Pdf_Font::NAME_POSTSCRIPT,
495 'en',
496 'UTF-8');
497 ...
498 $pdf->save($docPath);
499 ...
500 ]]>
501 </programlisting>
502 <programlisting role="php"><![CDATA[
503 ...
504 $pdf = Zend_Pdf::load($docPath);
505 ...
506 $pdf->pages[] = ($page = $pdf->newPage(Zend_Pdf_Page::SIZE_A4));
508 /* $srcPage->extractFont($fontName) can also be used here */
509 $font = $pdf->extractFont($fontName);
511 $page->setFont($font, $fontSize);
512 $page->drawText($text, $x, $y);
513 ...
514 $pdf->save($docPath, true /* incremental update mode */);
515 ...
516 ]]>
517 </programlisting>
518 </example>
520 <para>
521 Wyciągnięte czcionki mogą być użyte w miejscu dowolnej innej czcionki
522 z następującymi ograniczeniami:
523 <itemizedlist>
524 <listitem><para>Wyciągnieta czcionka może być użyta tylko w kontekście
525 dokumentu z którego została wyciągnięta.</para></listitem>
526 <listitem>
527 <para>
528 Osadzona czcionka nie jest wyciągnięta.
529 Wyciągnięta czcionka nie może być użyta do obliczenia
530 poprawnych rozmiarów więc do tych obliczeń powinna być
531 użyta oryginalna czcionka.
532 <programlisting role="php"><![CDATA[
533 ...
534 $font = $pdf->extractFont($fontName);
535 $originalFont = Zend_Pdf_Font::fontWithPath($fontPath);
537 $page->setFont($font /* używamy wyciągniętej czcionki do rysowania */, $fontSize);
538 $xPosition = $x;
539 for ($charIndex = 0; $charIndex < strlen($text); $charIndex++) {
540 $page->drawText($text[$charIndex], xPosition, $y);
542 // Używamy oryginalnej czcionki do obliczenia szerokości tekstu
543 $width = $originalFont->widthForGlyph(
544 $originalFont->glyphNumberForCharacter($text[$charIndex])
545 );
546 $xPosition += $width/$originalFont->getUnitsPerEm()*$fontSize;
547 }
548 ...
549 ]]>
550 </programlisting>
551 </para>
552 </listitem>
553 </itemizedlist>
554 </para>
555 </sect2>
557 <sect2 id="zend.pdf.drawing.image-drawing">
558 <title>Wstawianie obrazów</title>
559 <para>
560 Klasa <code>Zend_Pdf_Page</code>zapewnia metodę drawImage() do wstawiania
561 obrazów:
562 </para>
563 <programlisting role="php"><![CDATA[
564 /**
565 * Wstawia obraz w określonym miejscu na stronie.
566 *
567 * @param Zend_Pdf_Resource_Image $image
568 * @param float $x1
569 * @param float $y1
570 * @param float $x2
571 * @param float $y2
572 */
573 public function drawImage(Zend_Pdf_Resource_Image $image, $x1, $y1, $x2, $y2);
574 ]]>
575 </programlisting>
576 <para>
577 Obiekty obrazów powinny być tworzone za pomocą metody
578 <code>Zend_Pdf_Image::imageWithPath($filePath)</code> (obecnie
579 obsługiwane są obrazy JPG, PNG oraz TIFF):
580 </para>
581 <example id="zend.pdf.drawing.image-drawing.example-1">
582 <title>Wstawianie obrazów</title>
583 <programlisting role="php"><![CDATA[
584 ...
585 // łądujemy obraz
586 $image = Zend_Pdf_Image::imageWithPath('my_image.jpg');
588 $pdfPage->drawImage($image, 100, 100, 400, 300);
589 ...
590 ]]>
591 </programlisting>
592 </example>
594 <para>
595 <emphasis>Ważne! Obsługa JPEG wymaga rozszerzenia PHP GD.</emphasis>
596 <emphasis>Ważne! Obsługa PNG wymaga rozszerzenia ZLIB skonfigurowanego do obsługi obrazów z kanałem Alpha.</emphasis>
597 </para>
598 <para>
599 Sprawdź dokumentację PHP aby znaleźć bardziej szczegółowe informacje.
600 (<ulink url="http://www.php.net/manual/en/ref.image.php">http://www.php.net/manual/en/ref.image.php</ulink>).
601 (<ulink url="http://www.php.net/manual/en/ref.zlib.php">http://www.php.net/manual/en/ref.zlib.php</ulink>).
602 </para>
603 </sect2>
605 <sect2 id="zend.pdf.drawing.line-drawing-style">
606 <title>Styl rysowania linii</title>
607 <para>
608 Styl rysowania linii jest zdefiniowany przez grubość, kolor linii oraz
609 ozdobny wzór linii. Wszystkie te parametry mogą być zdefiniowane za pomocą
610 metod klasy <code>Zend_Pdf_Page</code>:
611 </para>
612 <programlisting role="php"><![CDATA[
613 /** Ustaw kolor linii. */
614 public function setLineColor(Zend_Pdf_Color $color);
616 /** Ustaw grubość linii. */
617 public function setLineWidth(float $width);
619 /**
620 * Ustawia ozdobny wzór linii.
621 *
622 * Wzór jest tablicą liczb zmiennoprzecinkowych:
623 * array(dlugosc_on, dlugosc_off, dlugosc_on, dlugosc_off, ...)
624 * Faza jest przesunięciem od początku linii.
625 *
626 * @param array $pattern
627 * @param array $phase
628 */
629 public function setLineDashingPattern($pattern, $phase = 0);
630 ]]>
631 </programlisting>
632 </sect2>
634 <sect2 id="zend.pdf.drawing.fill-style">
635 <title>Styl wypełnienia</title>
636 <para>
637 Metody <code>Zend_Pdf_Page::drawRectangle()</code>, <code>Zend_Pdf_Page::drawPolygon()</code>,
638 <code>Zend_Pdf_Page::drawCircle()</code> oraz <code>Zend_Pdf_Page::drawEllipse()</code>
639 przyjmują argument <code>$fillType</code> jako opcjonalny parametr. Może
640 on mieć wartość:
641 </para>
643 <itemizedlist>
644 <listitem>
645 <para>Zend_Pdf_Page::SHAPE_DRAW_STROKE - obrysowuje figurę</para>
646 </listitem>
647 <listitem>
648 <para>Zend_Pdf_Page::SHAPE_DRAW_FILL - tylko wypełnia</para>
649 </listitem>
650 <listitem>
651 <para>Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE - obrysowuje i wypełnia (domyślnie)</para>
652 </listitem>
653 </itemizedlist>
655 <para>
656 Metoda <code>Zend_Pdf_Page::drawPolygon()</code> przyjmuje także dodatkowy
657 parametr <code>$fillMethod</code>:
658 </para>
659 <itemizedlist>
660 <listitem>
661 <para>Zend_Pdf_Page::FILL_METHOD_NON_ZERO_WINDING (domyślnie)</para>
662 <para>
663 <citetitle>Dokumentacja PDF</citetitle> opisuje tą zasadę w ten sposób:
664 <blockquote>
665 <para>
666 Zasada nonzero winding number określa whether a given point is inside a
667 path by conceptually drawing a ray from that point to infinity in any direction
668 and then examining the places where a segment of the path crosses the ray. Starting
669 with a count of 0, the rule adds 1 each time a path segment crosses the ray
670 from left to right and subtracts 1 each time a segment crosses from right to left.
671 After counting all the crossings, if the result is 0 then the point is outside the path;
672 otherwise it is inside.
674 Nota: Opisana właśnie metoda nie określa what to do if a path segment coincides
675 with or is tangent to the chosen ray. Since the direction of the ray is arbitrary,
676 the rule simply chooses a ray that does not encounter such problem intersections.
677 For simple convex paths, the nonzero winding number rule defines the inside
678 and outside as one would intuitively expect. The more interesting cases are those
679 involving complex or self-intersecting paths like the ones shown in Figure 4.10
680 (w dokumentacji PDF).
682 For a path consisting of a five-pointed star, drawn with five connected straight
683 line segments intersecting each other, the rule considers the inside to be the entire
684 area enclosed by the star, including the pentagon in the center. For a path composed
685 of two concentric circles, the areas enclosed by both circles are considered
686 to be inside, provided that both are drawn in the same direction. If the circles are
687 drawn in opposite directions, only the "doughnut" shape between them is inside,
688 according to the rule; the "doughnut hole" is outside.
689 </para>
690 </blockquote>
691 </para>
692 </listitem>
693 <listitem>
694 <para>Zend_Pdf_Page::FILL_METHOD_EVEN_ODD</para>
695 <para>
696 <citetitle>Dokumentacja PDF</citetitle> opisuje tą zasadę w ten sposób:
697 <blockquote>
698 <para>
699 An alternative to the nonzero winding number rule is the even-odd rule. This rule
700 determines the "insideness" of a point by drawing a ray from that point in any
701 direction and simply counting the number of path segments that cross the ray,
702 regardless of direction. If this number is odd, the point is inside; if even, the point
703 is outside. This yields the same results as the nonzero winding number rule for
704 paths with simple shapes, but produces different results for more complex
705 shapes.
707 Figure 4.11 (w dokumentacji PDF) shows the effects of applying the even-odd rule
708 to complex paths. For the five-pointed star, the rule considers the triangular
709 points to be inside the path, but not the pentagon in the center. For the two
710 concentric circles, only the "doughnut" shape between the two circles is considered inside,
711 regardless of the directions in which the circles are drawn.
712 </para>
713 </blockquote>
714 </para>
715 </listitem>
716 </itemizedlist>
717 </sect2>
719 <sect2 id="zend.pdf.drawing.rotations">
720 <title>Obracanie</title>
721 <para>
722 Strony PDF mogą być obracane zanim zostaną wykonane jakiekolwiek
723 operacje rysowania. Może być to zrobione za pomocą metody
724 <code>Zend_Pdf_Page::rotate()</code>:
725 </para>
726 <programlisting role="php"><![CDATA[
727 /**
728 * Obraca stronę dookoła punktu ($x, $y) o określony kąt (w radianach).
729 *
730 * @param float $angle
731 */
732 public function rotate($x, $y, $angle);
733 ]]>
734 </programlisting>
735 </sect2>
737 <sect2 id="zend.pdf.drawing.save-restore">
738 <title>Zapisywanie/odczytywanie stanu grafiki</title>
739 <para>
740 W dowolnej chwili stan grafiki (bieżąca czcionka, rozmiar czcionki, kolor linii,
741 kolor wypełnienia, styl linii, obrót strony, obszar przycinania) może być zapisany
742 a potem przywrócony. Operacja zapisu zapisuje dane na stos stanu grafiki,
743 operacja przywrócenia przywraca je ze stosu.
744 </para>
745 <para>
746 Są dwie metody w klasie <code>Zend_Pdf_Page</code> do tych operacji:
747 </para>
748 <programlisting role="php"><![CDATA[
749 /**
750 * Zapisuje stan grafiki danej strony.
751 * Zapisuje obecny styl, pozycję, obszar przycinania
752 * oraz ewetualny obrót/translację/skalowanie
753 * które są zastosowane.
754 */
755 public function saveGS();
757 /**
758 * Przywraca stan grafiki który był zapisany
759 * ostatnim wywołaniem metody saveGS().
760 */
761 public function restoreGS();
762 ]]>
763 </programlisting>
764 </sect2>
766 <sect2 id="zend.pdf.drawing.clipping">
767 <title>Przycięcie obszaru rysowania</title>
768 <para>
769 PDF oraz moduł Zend_Pdf obsługują przycięcie obszaru rysowania. Obecny
770 przycięty obszar ogranicza obszar strony, na który wpływają operacje
771 rysowania. Na początku jest to cała strona.
772 </para>
773 <para>
774 Klasa <code>Zend_Pdf_Page</code> zapewnia zestaw metod dla operacji przycinania.
775 </para>
776 <programlisting role="php"><![CDATA[
777 /**
778 * Przycięcie obszaru za pomocą prostokąta.
779 *
780 * @param float $x1
781 * @param float $y1
782 * @param float $x2
783 * @param float $y2
784 */
785 public function clipRectangle($x1, $y1, $x2, $y2);
786 ]]>
787 </programlisting>
788 <programlisting role="php"><![CDATA[
789 /**
790 * Przycięcie obszaru za pomocą wielokąta.
791 *
792 * @param array $x - tablica wartości zmiennoprzecinkowych (współrzędne X)
793 * @param array $y - tablica wartości zmiennoprzecinkowych (współrzędne Y)
794 * @param integer $fillMethod
795 */
796 public function clipPolygon($x,
797 $y,
798 $fillMethod =
799 Zend_Pdf_Page::FILL_METHOD_NON_ZERO_WINDING);
800 ]]>
801 </programlisting>
802 <programlisting role="php"><![CDATA[
803 /**
804 * Przycięcie obszaru za pomocą okręgu.
805 *
806 * @param float $x
807 * @param float $y
808 * @param float $radius
809 * @param float $startAngle
810 * @param float $endAngle
811 */
812 public function clipCircle($x,
813 $y,
814 $radius,
815 $startAngle = null,
816 $endAngle = null);
817 ]]>
818 </programlisting>
819 <programlisting role="php"><![CDATA[
820 /**
821 * Przycięcie obszaru za pomocą elipsy.
822 *
823 * Sygnatury metod:
824 * drawEllipse($x1, $y1, $x2, $y2);
825 * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
826 *
827 * @todo obsłużyć przypadki gdy $x2-$x1 == 0 lub $y2-$y1 == 0
828 *
829 * @param float $x1
830 * @param float $y1
831 * @param float $x2
832 * @param float $y2
833 * @param float $startAngle
834 * @param float $endAngle
835 */
836 public function clipEllipse($x1,
837 $y1,
838 $x2,
839 $y2,
840 $startAngle = null,
841 $endAngle = null);
842 ]]>
843 </programlisting>
844 </sect2>
846 <sect2 id="zend.pdf.drawing.styles">
847 <title>Style</title>
848 <para>
849 Klasa <code>Zend_Pdf_Style</code> zapewnia funkcjonalność styli.
850 </para>
851 <para>
852 Styles mogą być użyte w celu przechowania zestawu parametrów stanu grafiki
853 i następnie zastosowania go na stronie PDF za pomocą jednej operacji:
854 </para>
855 <programlisting role="php"><![CDATA[
856 /**
857 * Ustawia styl dla przyszłych operacji rysowania na tej stronie
858 *
859 * @param Zend_Pdf_Style $style
860 */
861 public function setStyle(Zend_Pdf_Style $style);
863 /**
864 * Zwraca styl zastosowany dla strony.
865 *
866 * @return Zend_Pdf_Style|null
867 */
868 public function getStyle();
869 ]]>
870 </programlisting>
872 <para>
873 Klasa <code>Zend_Pdf_Style</code> zapewnia zestaw metod do ustawiania oraz pobierania różnych parametrów stanu grafiki:
874 </para>
875 <programlisting role="php"><![CDATA[
876 /**
877 * Ustawia kolor linii.
878 *
879 * @param Zend_Pdf_Color $color
880 */
881 public function setLineColor(Zend_Pdf_Color $color);
882 ]]>
883 </programlisting>
884 <programlisting role="php"><![CDATA[
885 /**
886 * Pobiera kolor linii.
887 *
888 * @return Zend_Pdf_Color|null
889 */
890 public function getLineColor();
891 ]]>
892 </programlisting>
893 <programlisting role="php"><![CDATA[
894 /**
895 * Ustawia grubość linii.
896 *
897 * @param float $width
898 */
899 public function setLineWidth($width);
900 ]]>
901 </programlisting>
902 <programlisting role="php"><![CDATA[
903 /**
904 * Pobiera grubość linii.
905 *
906 * @return float
907 */
908 public function getLineWidth();
909 ]]>
910 </programlisting>
911 <programlisting role="php"><![CDATA[
912 /**
913 * Ustawia ozdobny wzór linii
914 *
915 * @param array $pattern
916 * @param float $phase
917 */
918 public function setLineDashingPattern($pattern, $phase = 0);
919 ]]>
920 </programlisting>
921 <programlisting role="php"><![CDATA[
922 /**
923 * Pobiera ozdobny wzór linii
924 *
925 * @return array
926 */
927 public function getLineDashingPattern();
928 ]]>
929 </programlisting>
930 <programlisting role="php"><![CDATA[
931 /**
932 * Pobiera okres ozdobnej fazy.
933 *
934 * @return float
935 */
936 public function getLineDashingPhase();
937 ]]>
938 </programlisting>
939 <programlisting role="php"><![CDATA[
940 /**
941 * Ustawia kolor wypełnienia.
942 *
943 * @param Zend_Pdf_Color $color
944 */
945 public function setFillColor(Zend_Pdf_Color $color);
946 ]]>
947 </programlisting>
948 <programlisting role="php"><![CDATA[
949 /**
950 * Pobiera kolor wypełnienia.
951 *
952 * @return Zend_Pdf_Color|null
953 */
954 public function getFillColor();
955 ]]>
956 </programlisting>
957 <programlisting role="php"><![CDATA[
958 /**
959 * Ustawia bieżącą czcionkę.
960 *
961 * @param Zend_Pdf_Resource_Font $font
962 * @param float $fontSize
963 */
964 public function setFont(Zend_Pdf_Resource_Font $font, $fontSize);
965 ]]>
966 </programlisting>
967 <programlisting role="php"><![CDATA[
968 /**
969 * Zmienia rozmiar bieżącej czcionki
970 *
971 * @param float $fontSize
972 */
973 public function setFontSize($fontSize);
974 ]]>
975 </programlisting>
976 <programlisting role="php"><![CDATA[
977 /**
978 * Pobiera bieżącą czcionkę.
979 *
980 * @return Zend_Pdf_Resource_Font $font
981 */
982 public function getFont();
983 ]]>
984 </programlisting>
985 <programlisting role="php"><![CDATA[
986 /**
987 * Pobiera rozmiar bieżącej czcionki
988 *
989 * @return float $fontSize
990 */
991 public function getFontSize();
992 ]]>
993 </programlisting>
994 </sect2>
996 <sect2 id="zend.pdf.drawing.alpha">
997 <title>Przezroczystość</title>
998 <para>
999 Moduł <code>Zend_Pdf</code> pozwala na obsługę przezroczystości.
1000 </para>
1001 <para>
1002 Przezroczystość może być ustawiona za pomocą metody <code>Zend_Pdf_Page::setAlpha()</code>:
1003 <programlisting role="php"><![CDATA[
1004 /**
1005 * Ustawia przezroczystość
1006 *
1007 * $alpha == 0 - przezroczysty
1008 * $alpha == 1 - nieprzezroczysty
1009 *
1010 * Tryby przezroczystości obsługiwane przez PDF:
1011 * Normal (default), Multiply, Screen, Overlay, Darken,
1012 * Lighten, ColorDodge, ColorBurn, HardLight,
1013 * SoftLight, Difference, Exclusion
1014 *
1015 * @param float $alpha
1016 * @param string $mode
1017 * @throws Zend_Pdf_Exception
1018 */
1019 public function setAlpha($alpha, $mode = 'Normal');
1020 ]]>
1021 </programlisting>
1022 </para>
1023 </sect2>
1024 </sect1>