repo_zf1/documentation/manual/pt-br/module_specs/Zend_Barcode-Objects_Details.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 21667 -->
<!-- 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>

            <para>
                A opção <property>withQuietZones</property> não afeta este código de barras.
            </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>

            <para>
                A opção <property>withQuietZones</property> não afeta este código de barras.
            </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>

            <para>
                A opção <property>withQuietZones</property> não afeta este código de barras.
            </para>
        </note>
    </sect3>
</sect2>