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

   1 <sect1 id="zend.pdf.create">
   2     <title>Создание и загрузка документов PDF<!--Creating and loading PDF documents.--></title>
   3     <para>
   4     Класс <code>Zend_Pdf</code> представляет документ PDF и обеспечивает
   5     функциональность для работы на уровне документа.
   6 <!--
   7     <code>Zend_Pdf</code> class represents PDF document itself and provides document level
   8     functionality.
   9 -->
  10     </para>
  11
  12     <para>
  13     Для того, чтобы создать новый документ, нужно создать новый объект <code>Zend_Pdf</code>.
  14 <!--
  15     To create new document new <code>Zend_Pdf</code> object should be created.
  16 -->
  17     </para>
  18
  19     <para>
  20     Класс <code>Zend_Pdf</code> также предоставляет два статических метода для
  21     загрузки существующих документов PDF. Это методы <code>Zend_Pdf::load()</code>
  22     и <code>Zend_Pdf::parse()</code>. Оба метода возвращают объект <code>Zend_Pdf</code>
  23     в качестве результата или генерируют исключение в случае ошибки.
  24 <!--
  25     <code>Zend_Pdf</code> class also provides two static methods to load existing PDF.
  26     These are <code>Zend_Pdf::load()</code> and <code>Zend_Pdf::parse()</code> methods.
  27     Both of them return Zend_Pdf object as a result or throw an exception if error occurs.
  28 -->
  29     </para>
  30
  31     <example>
  32         <title>
  33         Создание нового или загрузка существующего документа PDF
  34         <!-- Create new or load existing PDF document.-->
  35         </title>
  36         <programlisting language="php"><![CDATA[<?php
  37 ...
  38 // Создание нового документа PDF
  39 $pdf1 = new Zend_Pdf();
  40
  41 // Загрузка документа PDF из файла
  42 $pdf2 = Zend_Pdf::load($fileName);
  43
  44 // Загрузка документа PDF из строки
  45 $pdf3 = Zend_Pdf::parse($pdfString);
  46 ...
  47 ?>]]></programlisting>
  48     </example>
  49
  50     <para>
  51     Формат файла PDF поддерживает постепенное обновление документа. Таким образом,
  52     каждый раз, когда документ обновляется, создается новая версия документа.
  53 <!--
  54     PDF file format supports incremental document update. Thus each time when document
  55     is updated, then new revision of the document is created.
  56     Zend_Pdf module supports retrieving of specified revision.
  57 -->
  58     </para>
  59     <para>
  60     Версия может быть указана в качестве второго параметра для методов
  61     <code>Zend_Pdf::load()</code> и <code>Zend_Pdf::parse()</code> или получается
  62     методом <code>Zend_Pdf::rollback()</code>.
  63 <!--
  64      Revision can be specified as a second parameter for <code>Zend_Pdf::load()</code> and
  65     <code>Zend_Pdf::parse()</code> methods or requested by <code>Zend_Pdf::rollback()</code>
  66 -->
  67         <footnote>
  68             <para>
  69             Метод <code>Zend_Pdf::rollback()</code> должен вызываться до того,
  70             как будут производиться любые изменения[накладываемые на документ].
  71 <!--
  72             <code>Zend_Pdf::rollback()</code> method must be invoked before any changes, applied to the document.
  73             Otherwise behavior is undefined.
  74 -->
  75             </para>
  76         </footnote>
  77     call.
  78     </para>
  79
  80     <example>
  81         <title>Извлечение определенной версии документа PDF<!--Requesting specified revision of the PDF document.--></title>
  82         <programlisting language="php"><![CDATA[<?php
  83 ...
  84 // Загрузка предыдущей версии документа PDF
  85 $pdf1 = Zend_Pdf::load($fileName, 1);
  86
  87 // Загрузка предыдущей версии документа PDF
  88 $pdf2 = Zend_Pdf::parse($pdfString, 1);
  89
  90 // Загрузка первой версии документа
  91 $pdf3 = Zend_Pdf::load($fileName);
  92 $revisions = $pdf3->revisions();
  93 $pdf3->rollback($revisions - 1);
  94 ...
  95 ?>]]></programlisting>
  96     </example>
  97
  98 </sect1>
  99 <!--
 100 vim:se ts=4 sw=4 et:
 101 -->