<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20764 -->
<!-- Reviewed: no -->
<sect1 id="zend.barcode.renderers">
    <title>Zend_Barcode Renderer</title>

    <para>
        Renderer haben einige gemeinsame Optionen. Diese Optionen können auf vier Wegen gesetzt
        werden:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                Als Array oder <classname>Zend_Config</classname> Objekt das dem Constructor
                übergeben wird.
            </para>
        </listitem>

        <listitem>
            <para>
                Als Array das der <methodname>setOptions()</methodname> Methode übergeben wird.
            </para>
        </listitem>

        <listitem>
            <para>
                Als <classname>Zend_Config</classname> Objekt das der
                <methodname>setConfig()</methodname> Methode übergeben wird.
            </para>
        </listitem>

        <listitem>
            <para>Als diskreter Wert der an individuelle Setter übergeben wird.</para>
        </listitem>
    </itemizedlist>

    <example id="zend.barcode.renderers.configuration">
        <title>Unterschiedliche Wegen ein Renderer Objekt zu parametrisieren</title>

        <programlisting language="php"><![CDATA[
$options = array('topOffset' => 10);

// Fall 1
$renderer = new Zend_Barcode_Renderer_Pdf($options);

// Fall 2
$renderer = new Zend_Barcode_Renderer_Pdf();
$renderer->setOptions($options);

// Fall 3
$config   = new Zend_Config($options);
$renderer = new Zend_Barcode_Renderer_Pdf();
$renderer->setConfig($config);

// Fall 4
$renderer = new Zend_Barcode_Renderer_Pdf();
$renderer->setTopOffset(10);
]]></programlisting>
    </example>

    <sect2 id="zend.barcode.renderers.common.options">
        <title>Gemeinsame Optionen</title>

        <para>
            In der folgenden Liste haben die Werte keine Einheit; wir werden den Ausdruck "Einheit"
            verwenden. Zum Beispiel, ist der Standardwert "dünner Balken" genau "1 Einheit". Die
            echte Einheit hängt von der Unterstützung beim Darstellen ab. Die individuellen Setter
            werden erkannt indem der erste Buchstabe der Option großgeschrieben und dem Namen
            "set" vorangestellt wird (z.B. "barHeight" => "setBarHeight"). Alle Optionen haben einen
            entsprechenden Getter dem "get" vorangestellt ist (z.B. "getBarHeight"). Die vorhandenen
            Optionen sind:
        </para>

        <table id="zend.barcode.renderers.common.options.table">
            <title>Gemeinsame Optionen</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Daten Typ</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><emphasis>rendererNamespace</emphasis></entry>
                        <entry><type>String</type></entry>
                        <entry><classname>Zend_Barcode_Renderer</classname></entry>

                        <entry>
                            Namespace des Renderers; zum Beispiel wenn man den Renderer erweitern
                            muss
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>horizontalPosition</emphasis></entry>
                        <entry><type>String</type></entry>
                        <entry>"left"</entry>

                        <entry>
                            Kann "left", "center" oder "right" sein. Das kann bei
                            <acronym>PDF</acronym> nützlich sein, oder wenn die
                            <methodname>setWidth()</methodname> Methode mit einem Image Renderer
                            verwendet wird.
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>verticalPosition</emphasis></entry>
                        <entry><type>String</type></entry>
                        <entry>"top"</entry>

                        <entry>
                            Kann "top", "middle" oder "bottom" sein. Das kann bei
                            <acronym>PDF</acronym> nützlich sein, oder wenn die
                            <methodname>setHeight()</methodname> Methode mit einem Image Renderer
                            verwendet wird.
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>leftOffset</emphasis></entry>
                        <entry><type>Integer</type></entry>
                        <entry>0</entry>

                        <entry>
                            Oberste Position des Barcodes innerhalb des Renderers. Wenn er verwendet
                            wird, überschreibt dieser Wert die Option "horizontalPosition".
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>topOffset</emphasis></entry>
                        <entry><type>Integer</type></entry>
                        <entry>0</entry>

                        <entry>
                            Oberste Position des Barcodes innerhalb des Renderers. Wenn er verwendet
                            wird, überschreibt dieser Wert die Option "verticalPosition".
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>automaticRenderError</emphasis></entry>
                        <entry><type>Boolean</type></entry>
                        <entry><constant>TRUE</constant></entry>

                        <entry>
                            Ob Fehler automatisch dargestellt werden sollen oder nicht. Wenn eine
                            Exception stattfindet, wird das angegebene Barcode Objekt mit einer
                            Repräsentation des Fehlers ersetzt. Es ist zu beachten das einige Fehler
                            (oder Exceptions) nicht dargestellt werden können.
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>moduleSize</emphasis></entry>
                        <entry><type>Float</type></entry>
                        <entry>1</entry>
                        <entry>Größe eines darstellenden Moduls im Support.</entry>
                    </row>

                    <row>
                        <entry><emphasis>barcode</emphasis></entry>
                        <entry><classname>Zend_Barcode_Object</classname></entry>
                        <entry><constant>NULL</constant></entry>
                        <entry>Das Barcode Objekt welches dargestellt werden soll.</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <para>
            Es existiert ein zusätzlicher Getter: <methodname>getType()</methodname>. Er gibt den
            Namen der Renderer Klasse ohne den Namespace zurück (z.B. gibt
            <classname>Zend_Barcode_Renderer_Image</classname> "image" zurück.
        </para>
    </sect2>

    <sect2 id="zend.barcode.renderers.image">
        <title>Zend_Barcode_Renderer_Image</title>

        <para>
            Der Image Renderer zeichnet die Anweisungsliste des Barcode Obejekts in eine Bild
            Ressource. Die Komponente benötigt die GD Erweiterung. Die Standardbreite eines
            Moduls ist 1 Pixel.
        </para>

        <para>Vorhandene Optionen sind:</para>

        <table id="zend.barcode.renderers.image.table">
            <title>Zend_Barcode_Renderer_Image Optionen</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Daten Typ</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><emphasis>height</emphasis></entry>
                        <entry><type>Integer</type></entry>
                        <entry>0</entry>

                        <entry>
                            Erlaubt es die Höhe des ergebenen Bildes zu spezifizieren. Wenn diese
                            "0" ist wird die Höhe vom Barcode Objekt kalkuliert.
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>width</emphasis></entry>
                        <entry><type>Integer</type></entry>
                        <entry>0</entry>

                        <entry>
                            Erlaubt es die Breite des ergebenden Bildes zu spezifizieren. Wenn diese
                            "0" ist wird die Breite vom Barcode Objekt kalkuliert.
                        </entry>
                    </row>

                    <row>
                        <entry><emphasis>imageType</emphasis></entry>
                        <entry><type>String</type></entry>
                        <entry>"png"</entry>

                        <entry>
                            Spezifiziert das Bildformat. Kann "png", "jpeg", "jpg" oder "gif" sein.
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.barcode.renderers.pdf">
        <title>Zend_Barcode_Renderer_Pdf</title>

        <para>
            Der <acronym>PDF</acronym> Renderer zeichnet die Anweisungsliste des Barcode Objekts in
            ein <acronym>PDF</acronym> Dokument. Die Standardbreite eines Moduls ist 0.5 Punkt.
        </para>

        <para>
            Es gibt keine speziellen Optionen für diesen Renderer.
        </para>
    </sect2>
</sect1>
