documentation/manual/ru/module_specs/Zend_Pdf-Drawing.xml

   1 <sect1 id="zend.pdf.drawing">
   2     <title>Рисование<!-- Drawing. --></title>
   3
   4     <sect2 id="zend.pdf.drawing.geometry">
   5         <title>Геометрия<!-- Geometry.--></title>
   6         <para>
   7         PDF использует ту же самую геометрию, что и PostScript. Она начинается с
   8         нижнего левого угла страницы и по умолчанию измеряется в пойнтах (1/72 дюйма).
   9 <!--
  10         PDF uses the same geometry as PostScript. It starts from bottom-left corner of page
  11         and by default is measured in points (1/72 of an inch).
  12 -->
  13         </para>
  14         <para>
  15         Размер страницы может быть получен из объекта страницы:
  16 <!--
  17         Page size can be retrieved from a page object:
  18 -->
  19         </para>
  20         <programlisting language="php"><![CDATA[<?php
  21 $width  = $pdfPage->getWidth();
  22 $height = $pdfPage->getHeight();]]>
  23         </programlisting>
  24     </sect2>
  25
  26     <sect2 id="zend.pdf.drawing.color">
  27         <title>Цвета<!-- Colors. --></title>
  28         <para>
  29         PDF имеет мощные возможности для представления цветов. Модуль Zend_Pdf
  30         поддерживает шкалу серого цвета, цветовые пространства RGB и CMYK.
  31         Они могут использоваться в любом месте, где требуется объект
  32         <code>Zend_Pdf_Color</code>. Классы <code>Zend_Pdf_Color_GrayScale</code>,
  33         <code>Zend_Pdf_Color_RGB</code> и <code>Zend_Pdf_Color_CMYK</code>
  34         предоставляют этот функционал:
  35 <!--
  36         PDF has a powerful capabilities for colors representation. Zend_Pdf module supports Gray Scale,
  37         RGB and CMYK color spaces. Any of them can be used in any place, where <code>Zend_Pdf_Color</code>
  38         object is required. <code>Zend_Pdf_Color_GrayScale</code>, <code>Zend_Pdf_Color_RGB</code> and
  39         <code>Zend_Pdf_Color_CMYK</code> classes provide this functionality:
  40 -->
  41         </para>
  42         <programlisting language="php"><![CDATA[<?php
  43 // $grayLevel (число с плавающей точкой)
  44 // 0.0 (черный) - 1.0 (белый)
  45 $color1 = new Zend_Pdf_Color_GrayScale($grayLevel);
  46
  47 // $r, $g, $b (числа с плавающей точкой)
  48 // 0.0 (минимальная интенсивность) - 1.0 (максимальная интенсивность)
  49 $color2 = new Zend_Pdf_Color_RGB($r, $g, $b);
  50
  51 // $c, $m, $y, $k (числа с плавающей точкой)
  52 // 0.0 (минимальная интенсивность) - 1.0 (максимальная интенсивность)
  53 $color3 = new Zend_Pdf_Color_CMYK($c, $m, $y, $k);]]>
  54         </programlisting>
  55     </sect2>
  56
  57
  58     <sect2 id="zend.pdf.drawing.shape-drawing">
  59         <title>Рисование фигур<!-- Shape Drawing. --></title>
  60         <para>
  61         Все операции прорисовки могут быть выполнены в контексте страницы PDF.
  62 <!--
  63         All drawing operations can be done in a context of PDF page.
  64 -->
  65         </para>
  66         <para>
  67         Класс <code>Zend_Pdf_Page</code> предоставляет набор примитивов для рисования:
  68 <!--
  69         <code>Zend_Pdf_Page</code> class provides a set of drawing primitives:
  70 -->
  71         </para>
  72         <programlisting language="php"><![CDATA[<?php
  73 /**
  74  * Рисует линию от x1,y1 до x2,y2.
  75  *
  76  * @param float $x1
  77  * @param float $y1
  78  * @param float $x2
  79  * @param float $y2
  80  */
  81 public function drawLine($x1, $y1, $x2, $y2);]]>
  82         </programlisting>
  83         <programlisting language="php"><![CDATA[<?php
  84 /**
  85  * Рисует прямоугольник.
  86  *
  87  * Fill types:
  88  * Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE - заполнить прямоугольник и заштриховать (значение по умолчанию)
  89  * Zend_Pdf_Const::SHAPEDRAW_STROKE      - заштриховать прямоугольник
  90  * Zend_Pdf_Const::SHAPEDRAW_FILL        - заполнить прямоугольник
  91  *
  92  * @param float $x1
  93  * @param float $y1
  94  * @param float $x2
  95  * @param float $y2
  96  * @param integer $fillType
  97  */
  98 public function drawRectangle($x1, $y1, $x2, $y2, $fillType = Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE);]]>
  99         </programlisting>
 100         <programlisting language="php"><![CDATA[<?php
 101 /**
 102  * Риcует многоугольник.
 103  *
 104  * Если $fillType (тип заполнения) равен Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE
 105  * или Zend_Pdf_Const::SHAPEDRAW_FILL, то многоугольник будет автоматически замкнут.
 106  * См. более подробное описание этих методов в документации PDF
 107  * (section 4.4.2 Path painting Operators, Filling)
 108  *
 109  * @param array $x  - массив чисел с плавающей точкой (X-координаты вершин)
 110  * @param array $y  - массив чисел с плавающей точкой (Y-координаты вершин)
 111  * @param integer $fillType
 112  * @param integer $fillMethod
 113  */
 114 public function drawPolygon($x, $y,
 115                             $fillType = Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE,
 116                             $fillMethod = Zend_Pdf_Const::FILLMETHOD_NONZEROWINDING);]]>
 117         </programlisting>
 118         <programlisting language="php"><![CDATA[<?php
 119 /**
 120  * Рисует окружность, центр которой находится в точке с координатами x и y,
 121  * с радиусом radius.
 122  *
 123  * Углы задаются в радианах.
 124  *
 125  * Сигнатуры метода:
 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  * Это не настоящая окружность, так как PDF поддерживает только кубические кривые Безье.
 133  * Но в очень хорошем приближении.
 134  * Она отличается от реальной окружности максимум на 0.00026 доли радиуса
 135  * (на углах PI/8, 3*PI/8, 5*PI/8, 7*PI/8, 9*PI/8, 11*PI/8, 13*PI/8 и 15*PI/8).
 136  * На углах 0, PI/4, PI/2, 3*PI/4, PI, 5*PI/4, 3*PI/2 и 7*PI/4 это точная касательная к окружности.
 137  *
 138  * @param float $x
 139  * @param float $y
 140  * @param float $radius
 141  * @param mixed $param4
 142  * @param mixed $param5
 143  * @param mixed $param6
 144  */
 145 public function  drawCircle($x, $y, $radius, $param4 = null, $param5 = null, $param6 = null);]]>
 146         </programlisting>
 147         <programlisting language="php"><![CDATA[<?php
 148 /**
 149  * Рисует эллипс внутри заданного прямоугольника.
 150  *
 151  * Сигнатуры метода:
 152  * drawEllipse($x1, $y1, $x2, $y2);
 153  * drawEllipse($x1, $y1, $x2, $y2, $fillType);
 154  * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
 155  * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle, $fillType);
 156  *
 157  * Углы задаются в радианах.
 158  *
 159  * @param float $x1
 160  * @param float $y1
 161  * @param float $x2
 162  * @param float $y2
 163  * @param mixed $param5
 164  * @param mixed $param6
 165  * @param mixed $param7
 166  */
 167 public function drawEllipse($x1, $y1, $x2, $y2, $param5 = null, $param6 = null, $param7 = null);]]>
 168         </programlisting>
 169     </sect2>
 170
 171     <sect2 id="zend.pdf.drawing.text-drawing">
 172         <title>Написание текста<!-- Text Drawing.--></title>
 173         <para>
 174         Операции по написанию текста также существуют в контексте страницы PDF.
 175 <!--
 176         Text drawing operations are also exist in a context of PDF page:
 177 -->
 178         </para>
 179         <programlisting language="php"><![CDATA[<?php
 180 /**
 181  * Выводит строку текста в заданной позиции.
 182  *
 183  * @param string $text
 184  * @param float $x
 185  * @param float $y
 186  * @throws Zend_Pdf_Exception
 187  */
 188 public function drawText($text, $x, $y );]]>
 189         </programlisting>
 190         <para>
 191         Для написания текста используются текущий шрифт и его текущий размер. См.
 192         подробное описание ниже.
 193 <!--
 194         Current font and current font size are used for text drawing operations. See detailed description below.
 195 -->
 196         </para>
 197     </sect2>
 198
 199     <sect2 id="zend.pdf.drawing.using-fonts">
 200         <title>Применение шрифтов<!-- Using fonts. --></title>
 201         <para>
 202         Метод <code>Zend_Pdf_Page::drawText()</code> использует текущий шрифт,
 203         который может быть установлен методом <code>Zend_Pdf_Page::setFont()</code>:
 204 <!--
 205         <code>Zend_Pdf_Page::drawText()</code> method uses current font, which can be assigned
 206         by <code>Zend_Pdf_Page::setFont()</code> method:
 207 -->
 208         </para>
 209         <programlisting language="php"><![CDATA[<?php
 210 /**
 211  * Устанавливает текущий шрифт.
 212  *
 213  * @param Zend_Pdf_Font $font
 214  * @param float $fontSize
 215  */
 216 public function setFont(Zend_Pdf_Font $font, $fontSize);]]>
 217         </programlisting>
 218         <para>
 219         PDF поддерживает Type1, TrueType, Type3 и составные шрифты. Он предоставляет еще
 220         14 стандартных шрифтов Type1. На данный момент модуль <code>Zend_Pdf</code>
 221         предусматривает только эти стандартные шрифты. Они могут быть получены
 222         с помощью класса <code>Zend_Pdf_Font_Standard</code>. Конкретный шрифт
 223         указывается в качестве аргумента конструктора.
 224 <!--
 225         PDF supports Type1, TrueType, Type3 and composite fonts. There are also 14 standard Type1 fonts
 226         provided by PDF. Zend_Pdf module provides only these standard fonts now. They can be obtained by using
 227         <code>Zend_Pdf_Font_Standard</code> class. Concrete font is specified as a constructor argument:
 228 -->
 229         </para>
 230         <example>
 231             <title>Создание стандартного шрифта<!-- Create standard font.--></title>
 232             <programlisting language="php"><![CDATA[<?php
 233 ...
 234 // Создание нового шрифта
 235 $font = new Zend_Pdf_Font_Standard(Zend_Pdf_Const::FONT_HELVETICA);
 236
 237 // Применение шрифта
 238 $pdfPage->setFont($font, 36);
 239 ...
 240 ?>]]>
 241             </programlisting>
 242         </example>
 243         <para>
 244         Константы для 14 стандартных шрифтов определены с помощью
 245         класса <code>Zend_Pdf_Const</code>:
 246 <!--
 247         Font constants for 14 standard fonts are defined within <code>Zend_Pdf_Const</code> class:
 248 -->
 249         <itemizedlist>
 250             <listitem>
 251                 <para>Zend_Pdf_Const::FONT_TIMES_ROMAN</para>
 252             </listitem>
 253             <listitem>
 254                 <para>Zend_Pdf_Const::FONT_TIMES_BOLD</para>
 255             </listitem>
 256             <listitem>
 257                 <para>Zend_Pdf_Const::FONT_TIMES_ITALIC</para>
 258             </listitem>
 259             <listitem>
 260                 <para>Zend_Pdf_Const::FONT_TIMES_BOLDITALIC</para>
 261             </listitem>
 262             <listitem>
 263                 <para>Zend_Pdf_Const::FONT_HELVETICA</para>
 264             </listitem>
 265             <listitem>
 266                 <para>Zend_Pdf_Const::FONT_HELVETICA_BOLD</para>
 267             </listitem>
 268             <listitem>
 269                 <para>Zend_Pdf_Const::FONT_HELVETICA_ITALIC</para>
 270             </listitem>
 271             <listitem>
 272                 <para>Zend_Pdf_Const::FONT_HELVETICA_BOLDITALIC</para>
 273             </listitem>
 274             <listitem>
 275                 <para>Zend_Pdf_Const::FONT_COURIER</para>
 276             </listitem>
 277             <listitem>
 278                 <para>Zend_Pdf_Const::FONT_COURIER_BOLD</para>
 279             </listitem>
 280             <listitem>
 281                 <para>Zend_Pdf_Const::FONT_COURIER_ITALIC</para>
 282             </listitem>
 283             <listitem>
 284                 <para>Zend_Pdf_Const::FONT_COURIER_BOLDITALIC</para>
 285             </listitem>
 286             <listitem>
 287                 <para>Zend_Pdf_Const::FONT_SYMBOL</para>
 288             </listitem>
 289             <listitem>
 290                 <para>Zend_Pdf_Const::FONT_ZAPFDINGBATS</para>
 291             </listitem>
 292         </itemizedlist>
 293         </para>
 294     </sect2>
 295
 296     <sect2 id="zend.pdf.drawing.image-drawing">
 297         <title>Рисование изображений<!-- Image Drawing. --></title>
 298         <para>
 299         Класс предоставляет метод <code>drawImage()</code> для рисования изображений.
 300 <!--
 301         <code>Zend_Pdf_Page</code> class provides drawImage() method to draw image:
 302 -->
 303         </para>
 304         <programlisting language="php"><![CDATA[<?php
 305 /**
 306  * Рисует изображение в заданной позиции на странице.
 307  *
 308  * @param Zend_Pdf_Resource_Image $image
 309  * @param float $x1
 310  * @param float $y1
 311  * @param float $x2
 312  * @param float $y2
 313  */
 314 public function drawImage(Zend_Pdf_Resource_Image $image, $x1, $y1, $x2, $y2);]]>
 315         </programlisting>
 316         <para>
 317             Объекты изображений должны создаваться через метод
 318             <code>Zend_Pdf_Image::imageWithPath($filePath)</code>
 319             (сейчас поддерживаются изображения JPG, PNG и TIFF):
 320 <!--
 321         Image objects should be created with <code>Zend_Pdf_Image::imageWithPath($filePath)</code> method
 322         (JPG, PNG and TIFF images are supported now):
 323 -->
 324         </para>
 325         <example>
 326             <title>Рисование изображения<!-- Image drawing.--></title>
 327             <programlisting language="php"><![CDATA[<?php
 328 ...
 329 // Загрузка изображения
 330 $image = Zend_Pdf_Image::imageWithPath('my_image.jpg');
 331
 332 $pdfPage->drawImage($image, 100, 100, 400, 300);
 333 ...
 334 ?>]]>
 335             </programlisting>
 336         </example>
 337
 338         <para>
 339             <emphasis>Важно! Для поддержки JPEG необходимо сконфигурировать
 340             расширение GD.</emphasis>
 341             <emphasis>Важно! Для поддержки PNG необходимо сконфигурировать
 342             расширение ZLIB для работы с изображениями с Альфа-каналом.</emphasis>
 343 <!--
 344             <emphasis>Important! JPEG support requires PHP GD extension to be configured.</emphasis>
 345             <emphasis>Important! PNG support requires ZLIB extension to be configured to work with Alpha channel images.</emphasis>
 346 -->
 347         </para>
 348         <para>
 349             См. документацию PHP за более подробной информацией
 350             (<ulink url="http://www.php.net/manual/en/ref.image.php">http://www.php.net/manual/en/ref.image.php</ulink>).
 351             (<ulink url="http://www.php.net/manual/en/ref.zlib.php">http://www.php.net/manual/en/ref.zlib.php</ulink>).
 352 <!--
 353             Refer to the PHP documentation for detailed information
 354             (<ulink url="http://www.php.net/manual/en/ref.image.php">http://www.php.net/manual/en/ref.image.php</ulink>).
 355             (<ulink url="http://www.php.net/manual/en/ref.zlib.php">http://www.php.net/manual/en/ref.zlib.php</ulink>).
 356 -->
 357         </para>
 358     </sect2>
 359
 360     <sect2 id="zend.pdf.drawing.line-drawing-style">
 361         <title>Стили рисования линий<!-- Line drawing style.--></title>
 362         <para>
 363         Стили рисования линий определяются толщиной линии, цветом линии и шаблоном
 364         пунктира. Все эти параметры могут быть определены методами класса
 365         <code>Zend_Pdf_Page</code>.
 366 <!--
 367         Line drawing style is defined by line width, line color and line dashing pattern.
 368         All of this parameters can be assigned by <code>Zend_Pdf_Page</code>
 369         class methods:
 370 -->
 371         </para>
 372         <programlisting language="php"><![CDATA[<?php
 373 /** Установка цвета линии. */
 374 public function setLineColor(Zend_Pdf_Color $color);
 375
 376 /** Установка толщины линии. */
 377 public function setLineWidth(float $width);
 378
 379 /**
 380  * Установка шаблона пунктира.
 381  *
 382  * $pattern (шаблон) является массивом чисел с плавающей точкой:
 383  * array(on_length, off_length, on_length, off_length, ...)
 384  * $phase (фаза) является сдвигом от начала линии.
 385  *
 386  * @param array $pattern
 387  * @param array $phase
 388  */
 389 public function setLineDashingPattern($pattern, $phase = 0);]]>
 390         </programlisting>
 391     </sect2>
 392
 393     <sect2 id="zend.pdf.drawing.fill-style">
 394         <title>Стиль заполнения<!-- Fill style.--></title>
 395         <para>
 396         Методы <code>Zend_Pdf_Page::drawRectangle()</code>, <code>Zend_Pdf_Page::drawPoligon()</code>,
 397         <code>Zend_Pdf_Page::drawCircle()</code> и <code>Zend_Pdf_Page::drawEllipse()</code>
 398         принимают аргумент <varname>$fillType</varname> как необязательный параметр.
 399         Это может быть:
 400 <!--
 401         <code>Zend_Pdf_Page::drawRectangle()</code>, <code>Zend_Pdf_Page::drawPoligon()</code>,
 402         <code>Zend_Pdf_Page::drawCircle()</code> and <code>Zend_Pdf_Page::drawEllipse()</code> methods take
 403         <varname>$fillType</varname> argument as an optional parameter. It can be:
 404 -->
 405         </para>
 406
 407         <itemizedlist>
 408             <listitem>
 409                 <para>
 410                 Zend_Pdf_Const::SHAPEDRAW_STROKE - штрихует фигуру <!-- stroke shape -->
 411                 </para>
 412             </listitem>
 413             <listitem>
 414                 <para>
 415                 Zend_Pdf_Const::SHAPEDRAW_FILL - заполняет фигуру <!-- only fill shape-->
 416                 </para>
 417             </listitem>
 418             <listitem>
 419                 <para>
 420                 Zend_Pdf_Const::SHAPEDRAW_FILLNSTROKE - заполняет и штрихует (поведение по умолчанию)
 421                 <!-- fill and stroke (default behavior)-->
 422                 </para>
 423             </listitem>
 424         </itemizedlist>
 425
 426         <para>
 427         Метод <code>Zend_Pdf_Page::drawPoligon()</code> принимает дополнительный
 428         параметр <varname>$fillMethod</varname>:
 429 <!--
 430         <code>Zend_Pdf_Page::drawPoligon()</code> methods also takes an additional parameter
 431         <varname>$fillMethod</varname>:
 432 -->
 433         </para>
 434         <itemizedlist>
 435             <listitem>
 436                 <para>
 437                 Zend_Pdf_Const::FILLMETHOD_NONZEROWINDING (поведение по умолчанию)
 438                 <!-- (default behavior)-->
 439                 </para>
 440                 <para>
 441                 <citetitle>Справка по PDF</citetitle> описывает это правило
 442                 следующим образом:
 443                 <blockquote>
 444                     <para>
 445                         Правило ненулевого количества витков определяет, находится ли
 446                         данная точка внутри траектории путем мысленного
 447                         проведения луча из этой точки в бесконечность в любом направлении
 448                         и последующего определения мест, где участок траектории пересекает луч.
 449                         Начиная отсчет с нуля, правило добавляет 1 каждый раз, когда
 450                         участок траектории пересекает луч слева направо и отнимает 1
 451                         каждый раз, когда участок траектории пересекает участок справа налево.
 452                         Если после подсчета всех пересечений результатом будет 0, то точка
 453                         находится вне траектории, иначе — внутри траектории.
 454
 455                         Примечание: Метод не указывает, что делать, если участок траектории
 456                         совпадает или является касательной к выбранному лучу. Поскольку
 457                         направление луча является произвольным, правило просто выбирает
 458                         луч, который не создает таких пересечений. Для простых выпуклых
 459                         траекторий правило ненулевого количества витков определяет
 460                         внутреннюю и внешнюю части так, как это интуитивно предполагается.
 461                         Более интересными случаями являются те, которые включают в себя
 462                         сложные или самопересекающиеся траектории, как, например,
 463                         на Рис. 4.10 (в справке по PDF).
 464
 465                         Для траектории, представляющую собой пятиконечную звезду,
 466                         состоящую из пяти соединенных отрезков, правило считает внутренней
 467                         частью всю площадь, окруженную звездой, включая пятиугольник в
 468                         центре. Для траектории, состоящей из двух концентрических
 469                         окружностей, площадь, окруженная обеими окружностями,
 470                         считается внутренней в том случае, если обе окружности нарисованы
 471                         в одном и том же направлении. Если окружности нарисованы в противоположных
 472                         направлениях, то, согласно правилу, только фигура в виде
 473                         баранки между ними будет внутренней частью, "дырка"
 474                         будет внешней частью.
 475                     </para>
 476                 </blockquote>
 477 <!--
 478                 <citetitle>PDF reference</citetitle> describes this rule as follows:
 479                 <blockquote>
 480 The nonzero winding number rule determines whether a given point is inside a
 481 path by conceptually drawing a ray from that point to infinity in any direction
 482 and then examining the places where a segment of the path crosses the ray. Starting
 483 with a count of 0, the rule adds 1 each time a path segment crosses the ray
 484 from left to right and subtracts 1 each time a segment crosses from right to left.
 485 After counting all the crossings, if the result is 0 then the point is outside the path;
 486 otherwise it is inside.
 487
 488 Note: The method just described does not specify what to do if a path segment coincides
 489 with or is tangent to the chosen ray. Since the direction of the ray is arbitrary,
 490 the rule simply chooses a ray that does not encounter such problem intersections.
 491 For simple convex paths, the nonzero winding number rule defines the inside
 492 and outside as one would intuitively expect. The more interesting cases are those
 493 involving complex or self-intersecting paths like the ones shown in Figure 4.10
 494 (in a PDF Reference).
 495
 496 For a path consisting of a five-pointed star, drawn with five connected straight
 497 line segments intersecting each other, the rule considers the inside to be the entire
 498 area enclosed by the star, including the pentagon in the center. For a path composed
 499 of two concentric circles, the areas enclosed by both circles are considered
 500 to be inside, provided that both are drawn in the same direction. If the circles are
 501 drawn in opposite directions, only the "doughnut" shape between them is inside,
 502 according to the rule; the "doughnut hole" is outside.
 503             </blockquote>
 504 -->
 505             </para>
 506             </listitem>
 507             <listitem>
 508                 <para>Zend_Pdf_Const::FILLMETHOD_EVENODD</para>
 509                 <para>
 510                 <citetitle>Справка по PDF</citetitle> описывает это правило
 511                 следующим образом:
 512                 <blockquote>
 513                     <para>
 514                         Альтернативой правилу ненулевого количества витков является правило
 515                         чета-нечета. Это правило определяет нахождение точки
 516                         проведением луча из этой точки в любом направлении и простым подсчетом
 517                         количества пересечений частей траектории с этим лучом, независимо от
 518                         направления пересечения. Если число нечетное, то точка находится
 519                         во внутренней части; если четное, то точка находится снаружи. Это
 520                         правило дает такой же результат, как и правило ненулевого
 521                         количества витков для траекторий с простыми фигурами, но дает
 522                         разные результаты в случае более сложных фигур.
 523
 524                         Рис. 4.11 (в справке по PDF) показывает результаты применения
 525                         правила чета-нечета к сложным фигурам. В случае пятиконечной
 526                         звезды правило считает точки треугольников находящимися
 527                         внутри траектории, но не пятиугольник в центре. Для двух
 528                         концентрических окружностей только фигура в виде баранки будет
 529                         считаться внутренней частью, независимо от направлений, в которых
 530                         нарисованы окружности.
 531                     </para>
 532                 </blockquote>
 533 <!--
 534                 <citetitle>PDF reference</citetitle> describes this rule as follows:
 535                 <blockquote>
 536 An alternative to the nonzero winding number rule is the even-odd rule. This rule
 537 determines the "insideness" of a point by drawing a ray from that point in any
 538 direction and simply counting the number of path segments that cross the ray,
 539 regardless of direction. If this number is odd, the point is inside; if even, the point
 540 is outside. This yields the same results as the nonzero winding number rule for
 541 paths with simple shapes, but produces different results for more complex
 542 shapes.
 543
 544 Figure 4.11 (in a PDF Reference) shows the effects of applying the even-odd rule
 545 to complex paths. For the five-pointed star, the rule considers the triangular
 546 points to be inside the path, but not the pentagon in the center. For the two
 547 concentric circles, only the "doughnut" shape between the two circles is considered inside,
 548 regardless of the directions in which the circles are drawn.
 549                 </blockquote>
 550 -->
 551             </para>
 552             </listitem>
 553         </itemizedlist>
 554     </sect2>
 555
 556     <sect2 id="zend.pdf.drawing.rotations">
 557         <title>Поворот<!-- Rotations. --></title>
 558         <para>
 559         Страница PDF может быть повернута перед применением любых операций рисования.
 560         Это может быть сделано методом <code>Zend_Pdf_Page::rotate()</code>:
 561 <!--
 562         PDF page can be rotated before applying any draw operation.
 563         It can be done by <code>Zend_Pdf_Page::rotate()</code> method:
 564 -->
 565         </para>
 566         <programlisting language="php"><![CDATA[<?php
 567 /**
 568  * Поворачивает страницу вокруг точки ($x, $y) на заданный угол (в радианах).
 569  *
 570  * @param float $angle
 571  */
 572 public function rotate($x, $y, $angle);]]>
 573         </programlisting>
 574     </sect2>
 575
 576     <sect2 id="zend.pdf.drawing.save-restore">
 577         <title>Сохранение/восстановление графического состояния<!-- Save/restore graphics state.--></title>
 578         <para>
 579         В любое время графическое состояние страницы (текущий шрифт, размер шрифта,
 580         цвет линии, цвет заполнения, стиль линии, поворот страницы, область ограничения) может
 581         быть сохранено и после восстановлено. Операция сохранения сохраняет данные
 582         в стек графического состояния, операция восстановления извлекает данные из стека.
 583 <!--
 584         At any time page graphics state (current font, font size, line color, fill color,
 585         line style, page rotation, clip area) can be saved and then restored. Save operation puts
 586         data to a graphics state stack, restore operation retrieves it from there.
 587 -->
 588         </para>
 589         <para>
 590         Методы в классе <code>Zend_Pdf_Page</code> для этих операций:
 591 <!--
 592         There are to methods in <code>Zend_Pdf_Page</code> class for these operations:
 593 -->
 594         </para>
 595         <programlisting language="php"><![CDATA[<?php
 596 /**
 597  * Сохраняет графическое состояние данной страницы.
 598  * Выполняет снимок используемых на данный момент стилей, положений, ... и всех
 599  * поворотов/преобразований/масштабирований которые были применены.
 600  * This takes a snapshot of the currently applied style, position, clipping area and
 601  * any rotation/translation/scaling that has been applied.
 602  */
 603 public function saveGS();
 604
 605 /**
 606  * Восстанавливает графическое состояние, которое было сохранено последним
 607  * вызовом saveGS().
 608  */
 609 public function restoreGS();]]>
 610         </programlisting>
 611     </sect2>
 612
 613     <sect2 id="zend.pdf.drawing.clipping">
 614         <title>Ограничение области рисования<!-- Clipping draw area. --></title>
 615         <para>
 616         PDF и модуль Zend_Pdf поддерживают ограничение области рисования.
 617         Ограничение определяет область страницы, затрагиваемой
 618         операциями рисования. Вначале эта область представляет собой всю
 619         страницу.
 620 <!--
 621         PDF and Zend_Pdf module support clipping of draw area.
 622         Current clip area limits the regions of the page affected by painting operators. It's a whole page initially.
 623 -->
 624         </para>
 625         <para>
 626         Класс <code>Zend_Pdf_Page</code> предоставляет набор методов для операций ограничения.
 627 <!--
 628         <code>Zend_Pdf_Page</code> class provides a set of methods for clipping operations.
 629 -->
 630         </para>
 631         <programlisting language="php"><![CDATA[<?php
 632 /**
 633  * Делит текущую площадь ограничения с помощью прямоугольника.
 634  *
 635  * @param float $x1
 636  * @param float $y1
 637  * @param float $x2
 638  * @param float $y2
 639  */
 640 public function clipRectangle($x1, $y1, $x2, $y2);]]>
 641         </programlisting>
 642         <programlisting language="php"><![CDATA[<?php
 643 /**
 644  * Делит текущую площадь ограничения с помощью многоугольника.
 645  *
 646  * @param array $x  - массив чисел с плавающей точкой (X-координаты верхушек)
 647  * @param array $y  - массив чисел с плавающей точкой (Y-координаты верхушек)
 648  * @param integer $fillMethod
 649  */
 650 public function clipPolygon($x, $y, $fillMethod = Zend_Pdf_Const::FILLMETHOD_NONZEROWINDING);]]>
 651         </programlisting>
 652         <programlisting language="php"><![CDATA[<?php
 653 /**
 654  * Делит текущую площадь ограничения с помощью окружности.
 655  *
 656  * @param float $x
 657  * @param float $y
 658  * @param float $radius
 659  * @param float $startAngle
 660  * @param float $endAngle
 661  */
 662 public function clipCircle($x, $y, $radius, $startAngle = null, $endAngle = null);]]>
 663         </programlisting>
 664         <programlisting language="php"><![CDATA[<?php
 665 /**
 666  * Делит текущую площадь ограничения с помощью эллипса.
 667  *
 668  * Сигнатуры метода:
 669  * drawEllipse($x1, $y1, $x2, $y2);
 670  * drawEllipse($x1, $y1, $x2, $y2, $startAngle, $endAngle);
 671  *
 672  * @todo обрабатывать случаи, когда $x2-$x1 == 0 или $y2-$y1 == 0
 673  *
 674  * @param float $x1
 675  * @param float $y1
 676  * @param float $x2
 677  * @param float $y2
 678  * @param float $startAngle
 679  * @param float $endAngle
 680  */
 681 public function clipEllipse($x1, $y1, $x2, $y2, $startAngle = null, $endAngle = null);]]>
 682         </programlisting>
 683     </sect2>
 684
 685     <sect2 id="zend.pdf.drawing.styles">
 686         <title>Стили<!-- Styles. --></title>
 687         <para>
 688         Класс <code>Zend_Pdf_Style</code> предоставляет набор функциональных
 689         возможностей для работы со стилями.
 690 <!--
 691         <code>Zend_Pdf_Style</code> class provides styles functionality.
 692 -->
 693         </para>
 694         <para>
 695         Стили могут использоваться для сохранения набора параметров графического
 696         состояния и применять их к странице PDF одной операцией:
 697 <!--
 698         Styles can be used to store a set of graphic state parameters and apply it to a PDF page by one operation:
 699 -->
 700         </para>
 701         <programlisting language="php"><![CDATA[<?php
 702 /**
 703  * Установить стиль для будущих операций рисования на данной странице
 704  *
 705  * @param Zend_Pdf_Style $style
 706  */
 707 public function setStyle(Zend_Pdf_Style $style);
 708
 709 /**
 710  * Возвращает стили, используемые на странице
 711  *
 712  * @return Zend_Pdf_Style|null
 713  */
 714 public function getStyle();]]>
 715         </programlisting>
 716
 717         <para>
 718         Класс <code>Zend_Pdf_Style</code> предоставляет набор методов для установки
 719         или получения различных параметров графического состояния:
 720 <!--
 721         <code>Zend_Pdf_Style</code> class provides a set of methods to set or get different graphics state parameters:
 722 -->
 723         </para>
 724         <programlisting language="php"><![CDATA[<?php
 725 /**
 726  * Устанавливает цвет линии.
 727  *
 728  * @param Zend_Pdf_Color $color
 729  */
 730 public function setLineColor(Zend_Pdf_Color $color);]]>
 731         </programlisting>
 732         <programlisting language="php"><![CDATA[<?php
 733 /**
 734  * Возвращает цвет линии.
 735  *
 736  * @return Zend_Pdf_Color|null
 737  */
 738 public function getLineColor();]]>
 739         </programlisting>
 740         <programlisting language="php"><![CDATA[<?php
 741 /**
 742  * Устанавливает толщину линии.
 743  *
 744  * @param float $width
 745  */
 746 public function setLineWidth($width);]]>
 747         </programlisting>
 748         <programlisting language="php"><![CDATA[<?php
 749 /**
 750  * Возвращает толщину линии.
 751  *
 752  * @return float
 753  */
 754 public function getLineWidth();]]>
 755         </programlisting>
 756         <programlisting language="php"><![CDATA[<?php
 757 /**
 758  * Устанавливает шаблон пунктира.
 759  *
 760  * @param array $pattern
 761  * @param float $phase
 762  */
 763 public function setLineDashingPattern($pattern, $phase = 0);]]>
 764         </programlisting>
 765         <programlisting language="php"><![CDATA[<?php
 766 /**
 767  * Возвращает шаблон пунктира.
 768  *
 769  * @return array
 770  */
 771 public function getLineDashingPattern();]]>
 772         </programlisting>
 773         <programlisting language="php"><![CDATA[<?php
 774 /**
 775  * Возвращает фазу пунктира.
 776  *
 777  * @return float
 778  */
 779 public function getLineDashingPhase();]]>
 780         </programlisting>
 781         <programlisting language="php"><![CDATA[<?php
 782 /**
 783  * Устанавливает цвет заполнения.
 784  *
 785  * @param Zend_Pdf_Color $color
 786  */
 787 public function setFillColor(Zend_Pdf_Color $color);]]>
 788         </programlisting>
 789         <programlisting language="php"><![CDATA[<?php
 790 /**
 791  * Возвращает цвет заполнения.
 792  *
 793  * @return Zend_Pdf_Color|null
 794  */
 795 public function getFillColor();]]>
 796         </programlisting>
 797         <programlisting language="php"><![CDATA[<?php
 798 /**
 799  * Устанавливает текущий шрифт.
 800  *
 801  * @param Zend_Pdf_Font $font
 802  * @param float $fontSize
 803  */
 804 public function setFont(Zend_Pdf_Font $font, $fontSize);]]>
 805         </programlisting>
 806         <programlisting language="php"><![CDATA[<?php
 807 /**
 808  * Изменяет текущий размер шрифта
 809  *
 810  * @param float $fontSize
 811  */
 812 public function setFontSize($fontSize);]]>
 813         </programlisting>
 814         <programlisting language="php"><![CDATA[<?php
 815 /**
 816  * Возвращает текущий шрифт.
 817  *
 818  * @return Zend_Pdf_Font $font
 819  */
 820 public function getFont();]]>
 821         </programlisting>
 822         <programlisting language="php"><![CDATA[<?php
 823 /**
 824  * Возвращает текущий размер шрифта.
 825  *
 826  * @return float $fontSize
 827  */
 828 public function getFontSize();]]>
 829         </programlisting>
 830     </sect2>
 831
 832 </sect1>
 833 <!--
 834 vim:se ts=4 sw=4 et:
 835 -->