Parcourir la source

[MANUAL] Brazilian Portuguese:

- add translations


git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20171 44c647ce-9c0f-0410-b52a-842ac1e357ba
mauriciofauth il y a 16 ans
Parent
commit
1b6b254852
20 fichiers modifiés avec 1734 ajouts et 0 suppressions
  1. BIN
      documentation/manual/pt-br/figures/zend.barcode.introduction.example-1.png
  2. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.code25.png
  3. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.ean13.png
  4. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.ean2.png
  5. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.ean5.png
  6. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.ean8.png
  7. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.error.png
  8. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.identcode.png
  9. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.int25.png
  10. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.itf14.png
  11. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.leitcode.png
  12. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.planet.png
  13. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.postnet.png
  14. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.royalmail.png
  15. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.upca.png
  16. BIN
      documentation/manual/pt-br/figures/zend.barcode.objects.details.upce.png
  17. 201 0
      documentation/manual/pt-br/module_specs/Zend_Barcode-Creation.xml
  18. 449 0
      documentation/manual/pt-br/module_specs/Zend_Barcode-Objects.xml
  19. 793 0
      documentation/manual/pt-br/module_specs/Zend_Barcode-Objects_Details.xml
  20. 291 0
      documentation/manual/pt-br/module_specs/Zend_Barcode-Renderers.xml

BIN
documentation/manual/pt-br/figures/zend.barcode.introduction.example-1.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.code25.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.ean13.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.ean2.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.ean5.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.ean8.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.error.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.identcode.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.int25.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.itf14.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.leitcode.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.planet.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.postnet.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.royalmail.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.upca.png


BIN
documentation/manual/pt-br/figures/zend.barcode.objects.details.upce.png


+ 201 - 0
documentation/manual/pt-br/module_specs/Zend_Barcode-Creation.xml

@@ -0,0 +1,201 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.creation">
+    <title>Criação de código de barras usando a classe Zend_Barcode</title>
+
+    <sect2 id="zend.barcode.creation.configuration">
+        <title>Usando o Zend_Barcode::factory</title>
+
+        <para>
+            <classname>Zend_Barcode</classname> utiliza um método de fábrica para criar uma
+            instância de um renderizador que estende
+            <classname>Zend_Barcode_Renderer_RendererAbstract</classname>. O método de fábrica
+            aceita cinco argumentos.
+        </para>
+
+        <orderedlist>
+            <listitem>
+                <para>
+                    O nome do formato de código de barras (por exemplo, "code39") (obrigatório)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>O nome do renderizador (por exemplo, "image") (obrigatório)</para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    As opções do objeto código de barras (uma matriz ou objeto
+                    <classname>Zend_Config</classname>) (opcional)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    As opções do objeto renderizador (uma matriz ou objeto
+                    <classname>Zend_Config</classname>) (opcional)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Booleano indicando se a renderização automática dos erros está ativada. Se
+                    ocorrer uma exceção, o objeto código de barras fornecido será substituído por
+                    uma representação de erro (opcional, padrão <constant>TRUE</constant>)
+                </para>
+            </listitem>
+        </orderedlist>
+
+        <example id="zend.barcode.creation.configuration.example-1">
+            <title>Recuperando um Renderizador com Zend_Barcode::factory()</title>
+
+            <para>
+                <methodname>Zend_Barcode::factory()</methodname> instancia objetos código de barras
+                e renderizadores no mesmo laço. Neste primeiro exemplo, vamos usar o tipo código de
+                barras <emphasis>Code39</emphasis>, juntamente com o renderizador
+                <emphasis>Image</emphasis>.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Somente o texto a ser escrito é necessário
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Não há opções necessárias
+$rendererOptions = array();
+$renderer = Zend_Barcode::factory(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+);
+]]></programlisting>
+        </example>
+
+        <example id="zend.barcode.creation.configuration.example-2">
+            <title>Usando o Zend_Barcode::factory() com objetos Zend_Config</title>
+
+            <para>
+                Você pode passar um objeto <classname>Zend_Config</classname> para a fábrica, a fim
+                de criar os objetos necessários. O exemplo a seguir é funcionalmente equivalente
+                ao anterior.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Usando apenas um objeto Zend_Config
+$config = new Zend_Config(array(
+    'barcode'        => 'code39',
+    'barcodeParams'  => array('text' => 'ZEND-FRAMEWORK'),
+    'renderer'       => 'image',
+    'rendererParams' => array('imageType' => 'gif'),
+));
+
+$renderer = Zend_Barcode::factory($config);
+]]></programlisting>
+        </example>
+    </sect2>
+
+    <sect2 id="zend.barcode.creation.drawing">
+        <title>Desenhando um código de barras</title>
+
+        <para>
+            Quando você <emphasis>desenha</emphasis> o código de barras, você recuperar o recurso em
+            que o código de barras é desenhado. Para desenhar um código de barras, você pode chamar
+            o método <methodname>draw()</methodname> do renderizador ou simplesmente usar o método
+            de proxy fornecido pelo <classname>Zend_Barcode</classname>.
+        </para>
+
+        <example id="zend.barcode.creation.drawing.example-1">
+            <title>Desenhando um código de barras com o objeto rendererizador</title>
+
+            <programlisting language="php"><![CDATA[
+// Somente o texto a ser escrito é necessário
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Não há opções necessárias
+$rendererOptions = array();
+
+// Desenha o código de barras em uma nova imagem
+$imageResource = Zend_Barcode::factory(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+)->draw();
+]]></programlisting>
+        </example>
+
+        <example id="zend.barcode.creation.drawing.example-2">
+            <title>Desenhando um código de barras com Zend_Barcode::draw()</title>
+
+            <programlisting language="php"><![CDATA[
+// Somente o texto a ser escrito é necessário
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Não há opções necessárias
+$rendererOptions = array();
+
+// Desenha o código de barras em uma nova imagem
+$imageResource = Zend_Barcode::draw(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+);
+]]></programlisting>
+        </example>
+    </sect2>
+
+    <sect2 id="zend.barcode.creation.renderering">
+        <title>Renderizando um código de barras</title>
+
+        <para>
+            Quando você renderiza um código de barras, você desenha o código de barras, envia os
+            cabeçalhos e envia também o recurso (à um navegador, por exemplo). Para renderizar um
+            código de barras, você pode chamar o método <methodname>render()</methodname> do
+            renderizador ou simplesmente usar o método de proxy fornecido pelo
+            <classname>Zend_Barcode</classname>.
+        </para>
+
+        <example id="zend.barcode.creation.renderering.example-1">
+            <title>Renderizando um código de barras com o objeto renderizador</title>
+
+            <programlisting language="php"><![CDATA[
+// Somente o texto a ser escrito é necessário
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Não há opções necessárias
+$rendererOptions = array();
+
+// Desenha o código de barras em uma nova imagem,
+// enviar os cabeçalhos e a imagem
+Zend_Barcode::factory(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+)->render();
+]]></programlisting>
+
+            <para>
+                Isso gerará este código de barras:
+            </para>
+
+            <para>
+                <inlinegraphic width="275" align="center" valign="middle"
+                    fileref="figures/zend.barcode.introduction.example-1.png" format="PNG"/>
+            </para>
+        </example>
+
+        <example id="zend.barcode.creation.renderering.example-2">
+            <title>Renderizando um código de barras com Zend_Barcode::render()</title>
+
+            <programlisting language="php"><![CDATA[
+// Somente o texto a ser escrito é necessário
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Não há opções necessárias
+$rendererOptions = array();
+
+// Desenha o código de barras em uma nova imagem,
+// enviar os cabeçalhos e a imagem
+Zend_Barcode::render(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+);
+]]></programlisting>
+
+            <para>
+                Isso gerará o mesmo código de barras do exemplo anterior.
+            </para>
+        </example>
+    </sect2>
+</sect1>

+ 449 - 0
documentation/manual/pt-br/module_specs/Zend_Barcode-Objects.xml

@@ -0,0 +1,449 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.objects" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <title>Objetos Zend_Barcode</title>
+
+    <para>
+        Os objetos código de barras te permitem gerar códigos de barras independentemente do suporte
+        de renderização. Após a geração, você pode recuperar o código de barras como uma matriz de
+        instruções de desenho que você pode fornecer a um renderizador.
+    </para>
+
+    <para>
+        Os objetos têm um grande número de opções. A maioria deles são comuns a todos os objetos.
+        Essas opções podem ser definidas em quatro formas:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                Como uma matriz ou um objeto <classname>Zend_Config</classname> passado ao
+                construtor.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Como uma matriz passada ao método <methodname>setOptions()</methodname>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Como um objeto <classname>Zend_Config</classname> passado ao método
+                <methodname>setConfig()</methodname>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>Através de setters individuais para cada tipo de configuração.</para>
+        </listitem>
+    </itemizedlist>
+
+    <example id="zend.barcode.objects.configuration">
+        <title>Diferentes maneiras de parametrizar um objeto código de barras</title>
+
+        <programlisting language="php"><![CDATA[
+$options = array('text' => 'ZEND-FRAMEWORK', 'barHeight' => 40);
+
+// Caso 1: construtor
+$barcode = new Zend_Barcode_Object_Code39($options);
+
+// Caso 2: setOptions()
+$barcode = new Zend_Barcode_Object_Code39();
+$barcode->setOptions($options);
+
+// Caso 3: setConfig()
+$config  = new Zend_Config($options);
+$barcode = new Zend_Barcode_Object_Code39();
+$barcode->setConfig($config);
+
+// Caso 4: setters individuais
+$barcode = new Zend_Barcode_Object_Code39();
+$barcode->setText('ZEND-FRAMEWORK')
+        ->setBarHeight(40);
+]]></programlisting>
+    </example>
+
+    <sect2 id="zend.barcode.objects.common.options">
+        <title>Opções Comuns</title>
+
+        <para>
+            Na lista seguinte, os valores não têm unidades; usaremos o termo "unidade". Por exemplo,
+            o valor padrão da "barra fina" é "1 unidade". As unidades reais dependem do suporte de
+            renderização (veja <link linkend="zend.barcode.renderers">a documentação dos
+                renderizadores</link> para mais informações). Os setters são nomeados mudando a
+            letra inicial da opção para maiúscula e colocando o prefixo "set" (por exemplo
+            "barHeight" se torna "setBarHeight"). Todas as opções têm um getter correspondente com
+            prefixo "get" (por exemplo "getBarHeight"). As opções disponíveis são:
+        </para>
+
+        <table id="zend.barcode.objects.common.options.table">
+            <title>Opções Comuns</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Opção</entry>
+
+                        <entry>Tipo de Dado</entry>
+
+                        <entry>Valor Padrão</entry>
+
+                        <entry>Descrição</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>barcodeNamespace</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry><classname>Zend_Barcode_Object</classname></entry>
+
+                        <entry>
+                            Namespace do código de barras; por exemplo, se você precisar estender
+                            os objetos incorporados
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>barHeight</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>50</entry>
+
+                        <entry>Altura das barras</entry>
+                    </row>
+                    <row>
+                        <entry><emphasis>barThickWidth</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>3</entry>
+
+                        <entry>Largura da barra grossa</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>barThinWidth</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>1</entry>
+
+                        <entry>Largura da barra fina</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>factor</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>1</entry>
+
+                        <entry>
+                            Fator com o qual a largura das barras e o tamanho das fontes
+                            são multiplicados
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>foreColor</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0 (preto)</entry>
+
+                        <entry>
+                            Cor da barra e do texto. Poderia ser fornecido como um inteiro ou como
+                            um valor em <acronym>HTML</acronym> (por exemplo "#333333")
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>backgroundColor</emphasis></entry>
+
+                        <entry><type>Integer</type> ou <type>String</type></entry>
+
+                        <entry>16777125 (branco)</entry>
+
+                        <entry>
+                            Cor do fundo. Poderia ser fornecido como um inteiro ou como um valor
+                            em <acronym>HTML</acronym> (por exemplo "#333333")
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>reverseColor</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>Permite-lhe trocar a cor da barra e do fundo</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>orientation</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>Orientação do código de barras</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>font</emphasis></entry>
+
+                        <entry><type>String</type> ou <type>Integer</type></entry>
+
+                        <entry><constant>NULL</constant></entry>
+
+                        <entry>
+                            Caminho para uma fonte <acronym>TTF</acronym> ou um número entre 1 e 5,
+                            caso esteja utilizando a geração de imagem com o GD (fontes internas)
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>fontSize</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>10</entry>
+
+                        <entry>Tamanho da fonte (não aplicável à fontes numéricas)</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>withBorder</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Desenhar uma borda em torno do código de barras e dos espaços vazios
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>drawText</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>TRUE</constant></entry>
+
+                        <entry>Define se o texto será mostrado abaixo do código de barras</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>stretchText</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Especifica se o texto será esticado ao longo do código de barras
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>withChecksum</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Indica se o checksum será adicionado automaticamente ao código de barras
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>withChecksumInText</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>Indica se o checksum será exibido na representação textual</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>text</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry><constant>NULL</constant></entry>
+
+                        <entry>O texto que será reproduzido como um código de barras</entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <sect3 id="zend.barcode.objects.common.options.barcodefont">
+            <title>O caso particular do setBarcodeFont() estático</title>
+
+            <para>
+                Você pode definir uma fonte comum para todos os seus objetos usando o método
+                estático <methodname>Zend_Barcode_Object::setBarcodeFont()</methodname>. Este valor
+                pode ser substituído por objetos individuais usando o método
+                <methodname>setFont()</methodname>.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Em seu arquivo bootstrap:
+Zend_Barcode_Object::setBarcodeFont('my_font.ttf');
+
+// Depois em seu código:
+Zend_Barcode::render(
+    'code39',
+    'pdf',
+    array('text' => 'ZEND-FRAMEWORK')
+); // utilizará 'my_font.ttf'
+
+// or:
+Zend_Barcode::render(
+    'code39',
+    'image',
+    array(
+        'text' => 'ZEND-FRAMEWORK',
+        'font' => 3
+    )
+); // utilizará a terceira fonte interna do GD
+]]></programlisting>
+        </sect3>
+    </sect2>
+
+    <sect2 id="zend.barcode.objects.common.getters">
+        <title>Getters Adicionais Comuns</title>
+
+        <para></para>
+
+        <table id="zend.barcode.objects.common.getters.table">
+            <title>Getters Comuns</title>
+
+            <tgroup cols="3">
+                <thead>
+                    <row>
+                        <entry>Getter</entry>
+
+                        <entry>Tipo de Dado</entry>
+
+                        <entry>Descrição</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><methodname>getType()</methodname></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>
+                            Retorna o nome da classe de código de barras sem o namespace
+                            (por exemplo, <classname>Zend_Barcode_Object_Code39</classname> retorna
+                            simplesmente "code39")
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getRawText()</methodname></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>
+                            Retorna o texto original fornecido pelo objeto
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getTextToDisplay()</methodname></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>
+                            Retorna o texto a ser exibido, incluindo, se ativado,
+                            o valor do checksum
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getQuietZone()</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Retornar a quantidade de espaço necessário antes e depois do código
+                            de barras sem nenhum desenho
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getInstructions()</methodname></entry>
+
+                        <entry><type>Array</type></entry>
+
+                        <entry>
+                            Retorna as instruções de desenho como uma matriz
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getHeight($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Retorna a altura do código de barras calculado após uma
+                            possível rotação
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getWidth($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Retorna a largura do código de barras calculado após uma
+                            possível rotação
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getOffsetTop($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Retorna a posição do topo do código de barras calculado após
+                            uma possível rotação
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getOffsetLeft($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Retorna a posição da esquerda do código de barras calculado após
+                            uma possível rotação
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+    </sect2>
+
+    <xi:include href="Zend_Barcode-Objects_Details.xml" />
+</sect1>

+ 793 - 0
documentation/manual/pt-br/module_specs/Zend_Barcode-Objects_Details.xml

@@ -0,0 +1,793 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20091 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.barcode.objects.details">
+    <title>Descrição dos códigos de barras embarcados</title>
+
+    <para>
+        Você encontrará abaixo informações detalhadas sobre todos os tipos de códigos de barras
+        embarcados por padrão com o Zend Framework.
+    </para>
+
+    <sect3 id="zend.barcode.objects.details.error">
+        <title>Zend_Barcode_Object_Error</title>
+
+        <para>
+            <inlinegraphic width="400" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.error.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras é um caso especial. É utilizado internamente para automaticamente
+            renderizar uma exceção capturada pelo componente <classname>Zend_Barcode</classname>.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.code25">
+        <title>Zend_Barcode_Object_Code25</title>
+
+        <para>
+            <inlinegraphic width="152" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.code25.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Código 25 (ou Código 2 de 5 ou Código 25 Industrial)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> opcional (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> variável
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.code25interleaved">
+        <title>Zend_Barcode_Object_Code25interleaved</title>
+
+        <para>
+            <inlinegraphic width="101" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.int25.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Code25</classname>
+            (Código 2 de 5), e tem os mesmos detalhes e opções, e acrescenta o seguinte:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Código 2 de 5 Intercalado
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> opcional (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> variável (sempre o mesmo número de caracteres)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            As opções disponíveis incluem:
+        </para>
+
+        <table id="zend.barcode.objects.details.code25interleaved.table">
+            <title>Opções do Zend_Barcode_Object_Code25interleaved</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Opção</entry>
+
+                        <entry>Tipo de Dado</entry>
+
+                        <entry>Valor Padrão</entry>
+
+                        <entry>Descrição</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>withBearerBars</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Desenha uma barra grossa em cima e em baixo do código de barras.
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <note>
+            <para>
+                Se o número de caracteres não for mesmo, o
+                <classname>Zend_Barcode_Object_Code25interleaved</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.ean2">
+        <title>Zend_Barcode_Object_Ean2</title>
+
+        <para>
+            <inlinegraphic width="41" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.ean2.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Ean5</classname>
+            (<acronym>EAN</acronym> 5), e tem os mesmos detalhes e opções, e acrescenta o seguinte:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>EAN</acronym>-2
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> utilizado apenas internamente, mas não exibido
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 2 caracteres
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 2, o
+                <classname>Zend_Barcode_Object_Ean2</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.ean5">
+        <title>Zend_Barcode_Object_Ean5</title>
+
+        <para>
+            <inlinegraphic width="68" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.ean5.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Ean13</classname>
+            (<acronym>EAN</acronym> 13), e tem os mesmos detalhes e opções, e acrescenta o seguinte:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>EAN</acronym>-5
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> utilizado apenas internamente, mas não exibido
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 5 caracteres
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 5, o
+                <classname>Zend_Barcode_Object_Ean5</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.ean8">
+        <title>Zend_Barcode_Object_Ean8</title>
+
+        <para>
+            <inlinegraphic width="82" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.ean8.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Ean13</classname>
+            (<acronym>EAN</acronym> 13), e tem os mesmos detalhes e opções, e acrescenta o seguinte:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>EAN</acronym>-8
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 8 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 8, o
+                <classname>Zend_Barcode_Object_Ean8</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.ean13">
+        <title>Zend_Barcode_Object_Ean13</title>
+
+        <para>
+            <inlinegraphic width="113" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.ean13.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>EAN</acronym>-13
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 13 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 13, o
+                <classname>Zend_Barcode_Object_Ean13</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.code39">
+        <title>Zend_Barcode_Object_Code39</title>
+
+        <para>
+            <inlinegraphic width="275" align="center" valign="middle"
+                fileref="figures/zend.barcode.introduction.example-1.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Código 39
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis>
+                    '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ -.$/+%'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> opcional (módulo 43)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> variável
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <note>
+            <para>
+                <classname>Zend_Barcode_Object_Code39</classname> adicionará automaticamente no
+                início e no fim o caractere ('*').
+            </para>
+        </note>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.identcode">
+        <title>Zend_Barcode_Object_Identcode</title>
+
+        <para>
+            <inlinegraphic width="137" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.identcode.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende
+            <classname>Zend_Barcode_Object_Code25interleaved</classname>
+            (Código 2 de 5 Intercalado), e herda algumas das suas capacidades, mas possui também
+            suas próprias características.
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Identcode (Deutsche Post Identcode)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10 diferente do Código 25)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 12 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 12, o
+                <classname>Zend_Barcode_Object_Identcode</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.itf14">
+        <title>Zend_Barcode_Object_Itf14</title>
+
+        <para>
+            <inlinegraphic width="155" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.itf14.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende
+            <classname>Zend_Barcode_Object_Code25interleaved</classname>
+            (Código 2 de 5 Intercalado), e herda algumas das suas capacidades, mas possui também
+            suas próprias características.
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>ITF</acronym>-14
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 14 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 14, o
+                <classname>Zend_Barcode_Object_Itf14</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.leitcode">
+        <title>Zend_Barcode_Object_Leitcode</title>
+
+        <para>
+            <inlinegraphic width="155" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.leitcode.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Identcode</classname>
+            (Deutsche Post Identcode), e herda algumas das suas capacidades, mas possui também
+            suas próprias características.
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Leitcode (Deutsche Post Leitcode)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10 diferente do Código 25)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 14 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 14, o
+                <classname>Zend_Barcode_Object_Leitcode</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.planet">
+        <title>Zend_Barcode_Object_Planet</title>
+
+        <para>
+            <inlinegraphic width="286" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.planet.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Planet (PostaL Alpha Numeric Encoding Technique)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 12 ou 14 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.postnet">
+        <title>Zend_Barcode_Object_Postnet</title>
+
+        <para>
+            <inlinegraphic width="286" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.postnet.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Postnet (POSTal Numeric Encoding Technique)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis>
+                    6, 7, 10 ou 12 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.royalmail">
+        <title>Zend_Barcode_Object_Royalmail</title>
+
+        <para>
+            <inlinegraphic width="158" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.royalmail.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> Royal Mail ou <acronym>RM4SCC</acronym> (Royal Mail
+                    4-State Customer Code)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> variável
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.upca">
+        <title>Zend_Barcode_Object_Upca</title>
+
+        <para>
+            <inlinegraphic width="115" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.upca.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Ean13</classname>
+            (<acronym>EAN</acronym>-13), e herda algumas das suas capacidades, mas possui também
+            suas próprias características.
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>UPC</acronym>-A (Universal Product Code)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 12 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 12, o
+                <classname>Zend_Barcode_Object_Upca</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.upce">
+        <title>Zend_Barcode_Object_Upce</title>
+
+        <para>
+            <inlinegraphic width="71" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.upce.png" format="PNG"/>
+        </para>
+
+        <para>
+            Este código de barras estende <classname>Zend_Barcode_Object_Upca</classname>
+            (<acronym>UPC</acronym>-A), e herda algumas das suas capacidades, mas possui também
+            suas próprias características. O primeiro caractere do texto a ser codificado
+            é o sistema (0 ou 1).
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Nome:</emphasis> <acronym>UPC</acronym>-E (Universal Product Code)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Caracteres permitidos:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> obrigatório (módulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Comprimento:</emphasis> 8 caracteres (incluindo o checksum)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Não existem opções específicas para este código de barras.
+        </para>
+
+        <note>
+            <para>
+                Se o número de caracteres for menor que 8, o
+                <classname>Zend_Barcode_Object_Upce</classname> adicionará
+                automaticamente na frente do texto do código de barras os zeros faltantes.
+            </para>
+        </note>
+
+        <note>
+            <para>
+                Se o primeiro caractere do texto a ser codificado não for 0 ou 1, o
+                <classname>Zend_Barcode_Object_Upce</classname> irá automaticamente
+                substituí-lo por 0.
+            </para>
+        </note>
+    </sect3>
+</sect2>

+ 291 - 0
documentation/manual/pt-br/module_specs/Zend_Barcode-Renderers.xml

@@ -0,0 +1,291 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.renderers">
+    <title>Renderizadores do Zend_Barcode</title>
+
+    <para>
+        Os renderizadores tem algumas opções em comum. Essas opções podem ser definidas em
+        quatro formas:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                Como uma matriz ou um objeto <classname>Zend_Config</classname> passado ao
+                construtor.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Como uma matriz passada ao método <methodname>setOptions()</methodname>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Como um objeto <classname>Zend_Config</classname> passado ao método
+                <methodname>setConfig()</methodname>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>Como valores distintos passados à setters individuais.</para>
+        </listitem>
+    </itemizedlist>
+
+    <example id="zend.barcode.renderers.configuration">
+        <title>Diferentes maneiras de parametrizar um objeto renderizador</title>
+
+        <programlisting language="php"><![CDATA[
+$options = array('topOffset' => 10);
+
+// Caso 1
+$renderer = new Zend_Barcode_Renderer_Pdf($options);
+
+// Caso 2
+$renderer = new Zend_Barcode_Renderer_Pdf();
+$renderer->setOptions($options);
+
+// Caso 3
+$config   = new Zend_Config($options);
+$renderer = new Zend_Barcode_Renderer_Pdf();
+$renderer->setConfig($config);
+
+// Caso 4
+$renderer = new Zend_Barcode_Renderer_Pdf();
+$renderer->setTopOffset(10);
+]]></programlisting>
+    </example>
+
+    <sect2 id="zend.barcode.renderers.common.options">
+        <title>Opções Comuns</title>
+
+        <para>
+            Na lista seguinte, os valores não têm unidades; usaremos o termo "unidade". Por exemplo,
+            o valor padrão da "barra fina" é "1 unidade". As unidades reais dependem do suporte de
+            renderização. Os setters individuais são obtidos mudando a letra inicial da opção para
+            maiúscula e colocando o prefixo "set" (por exemplo "barHeight" => "setBarHeight").
+            Todas as opções têm um getter correspondente com prefixo "get" (por exemplo
+            "getBarHeight"). As opções disponíveis são:
+        </para>
+
+        <table id="zend.barcode.renderers.common.options.table">
+            <title>Opções Comuns</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Opção</entry>
+
+                        <entry>Tipo de Dado</entry>
+
+                        <entry>Valor Padrão</entry>
+
+                        <entry>Descrição</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>rendererNamespace</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry><classname>Zend_Barcode_Renderer</classname></entry>
+                        <entry>
+                            Namespace do renderizador; por exemplo, caso precise estender os
+                            renderizadores.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>horizontalPosition</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>"left"</entry>
+
+                        <entry>
+                            Pode ser "left", "center" ou "right". Pode ser útil com o formato
+                            <acronym>PDF</acronym> ou se o método
+                            <methodname>setWidth()</methodname> for usado com um
+                            renderizador de imagem.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>verticalPosition</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>"top"</entry>
+
+                        <entry>
+                            Pode ser "top", "middle" ou "bottom". Pode ser útil com o formato
+                            <acronym>PDF</acronym> ou se o método
+                            <methodname>setHeight()</methodname> for usado com um
+                            renderizador de imagem.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>leftOffset</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Posição superior do código de barras no interior do renderizador. Se
+                            usado, este valor substituirá a opção "horizontalPosition".
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>topOffset</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Posição superior do código de barras no interior do renderizador. Se
+                            usado, este valor substituirá a opção "verticalPosition".
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>automaticRenderError</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>TRUE</constant></entry>
+
+                        <entry>
+                            Ativa a renderização automática dos erros. Se ocorrer uma exceção, o
+                            objeto código de barras fornecido será substituído por uma representação
+                            de erro. Observe que alguns erros (ou exceções) não podem ser
+                            renderizados.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>moduleSize</emphasis></entry>
+
+                        <entry><type>Float</type></entry>
+
+                        <entry>1</entry>
+
+                        <entry>
+                            Tamanho de um módulo de renderização no suporte.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>barcode</emphasis></entry>
+
+                        <entry><classname>Zend_Barcode_Object</classname></entry>
+
+                        <entry><constant>NULL</constant></entry>
+
+                        <entry>
+                            O objeto código de barras a ser renderizado.
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <para>
+            Existe um getter adicional: <methodname>getType()</methodname>. Ele retorna o nome da
+            classe de renderização sem o namespace (por exemplo,
+            <classname>Zend_Barcode_Renderer_Image</classname> retorna "image").
+        </para>
+    </sect2>
+
+    <sect2 id="zend.barcode.renderers.image">
+        <title>Zend_Barcode_Renderer_Image</title>
+
+        <para>
+            O renderizador Image irá desenhar a lista de instruções do objeto código de barras em
+            um recurso de imagem. O componente requer a extensão GD. A largura padrão de um módulo
+            é de 1 pixel.
+        </para>
+
+        <para>As opções disponíveis são:</para>
+
+        <table id="zend.barcode.renderers.image.table">
+            <title>Opções do Zend_Barcode_Renderer_Image</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Opção</entry>
+
+                        <entry>Tipo de Dado</entry>
+
+                        <entry>Valor Padrão</entry>
+
+                        <entry>Descrição</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>height</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Permite-lhe especificar a altura da imagem resultante. Se for "0",
+                            a altura será calculada pelo objeto código de barras.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>width</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Permite-lhe especificar a largura da imagem resultante. Se for "0",
+                            a largura será calculada pelo objeto código de barras.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>imageType</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>"png"</entry>
+
+                        <entry>
+                            Especifica o formato da imagem. Pode ser "png", "jpeg", "jpg" ou "gif".
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+    </sect2>
+
+    <sect2 id="zend.barcode.renderers.pdf">
+        <title>Zend_Barcode_Renderer_Pdf</title>
+
+        <para>
+            O renderizador de <acronym>PDF</acronym> irá desenhar a lista de instruções do objeto
+            código de barras em um documento <acronym>PDF</acronym>. A largura padrão de um módulo
+            é de 0,5 point.
+        </para>
+
+        <para>
+            Não existem opções específicas para este renderizador.
+        </para>
+    </sect2>
+</sect1>