PageRenderTime 22ms CodeModel.GetById 12ms app.highlight 6ms RepoModel.GetById 2ms app.codeStats 0ms

/documentation/manual/de/module_specs/Zend_Barcode-Renderers.xml

https://github.com/decaoz/zf1
XML | 258 lines | 212 code | 44 blank | 2 comment | 0 complexity | 12fd295a4a196a526645f35b4eb7be75 MD5 | raw file
  1<?xml version="1.0" encoding="UTF-8"?>
  2<!-- EN-Revision: 20764 -->
  3<!-- Reviewed: no -->
  4<sect1 id="zend.barcode.renderers">
  5    <title>Zend_Barcode Renderer</title>
  6
  7    <para>
  8        Renderer haben einige gemeinsame Optionen. Diese Optionen können auf vier Wegen gesetzt
  9        werden:
 10    </para>
 11
 12    <itemizedlist>
 13        <listitem>
 14            <para>
 15                Als Array oder <classname>Zend_Config</classname> Objekt das dem Constructor
 16                übergeben wird.
 17            </para>
 18        </listitem>
 19
 20        <listitem>
 21            <para>
 22                Als Array das der <methodname>setOptions()</methodname> Methode übergeben wird.
 23            </para>
 24        </listitem>
 25
 26        <listitem>
 27            <para>
 28                Als <classname>Zend_Config</classname> Objekt das der
 29                <methodname>setConfig()</methodname> Methode übergeben wird.
 30            </para>
 31        </listitem>
 32
 33        <listitem>
 34            <para>Als diskreter Wert der an individuelle Setter übergeben wird.</para>
 35        </listitem>
 36    </itemizedlist>
 37
 38    <example id="zend.barcode.renderers.configuration">
 39        <title>Unterschiedliche Wegen ein Renderer Objekt zu parametrisieren</title>
 40
 41        <programlisting language="php"><![CDATA[
 42$options = array('topOffset' => 10);
 43
 44// Fall 1
 45$renderer = new Zend_Barcode_Renderer_Pdf($options);
 46
 47// Fall 2
 48$renderer = new Zend_Barcode_Renderer_Pdf();
 49$renderer->setOptions($options);
 50
 51// Fall 3
 52$config   = new Zend_Config($options);
 53$renderer = new Zend_Barcode_Renderer_Pdf();
 54$renderer->setConfig($config);
 55
 56// Fall 4
 57$renderer = new Zend_Barcode_Renderer_Pdf();
 58$renderer->setTopOffset(10);
 59]]></programlisting>
 60    </example>
 61
 62    <sect2 id="zend.barcode.renderers.common.options">
 63        <title>Gemeinsame Optionen</title>
 64
 65        <para>
 66            In der folgenden Liste haben die Werte keine Einheit; wir werden den Ausdruck "Einheit"
 67            verwenden. Zum Beispiel, ist der Standardwert "dünner Balken" genau "1 Einheit". Die
 68            echte Einheit hängt von der Unterstützung beim Darstellen ab. Die individuellen Setter
 69            werden erkannt indem der erste Buchstabe der Option großgeschrieben und dem Namen
 70            "set" vorangestellt wird (z.B. "barHeight" => "setBarHeight"). Alle Optionen haben einen
 71            entsprechenden Getter dem "get" vorangestellt ist (z.B. "getBarHeight"). Die vorhandenen
 72            Optionen sind:
 73        </para>
 74
 75        <table id="zend.barcode.renderers.common.options.table">
 76            <title>Gemeinsame Optionen</title>
 77
 78            <tgroup cols="4">
 79                <thead>
 80                    <row>
 81                        <entry>Option</entry>
 82                        <entry>Daten Typ</entry>
 83                        <entry>Standardwert</entry>
 84                        <entry>Beschreibung</entry>
 85                    </row>
 86                </thead>
 87
 88                <tbody>
 89                    <row>
 90                        <entry><emphasis>rendererNamespace</emphasis></entry>
 91                        <entry><type>String</type></entry>
 92                        <entry><classname>Zend_Barcode_Renderer</classname></entry>
 93
 94                        <entry>
 95                            Namespace des Renderers; zum Beispiel wenn man den Renderer erweitern
 96                            muss
 97                        </entry>
 98                    </row>
 99
100                    <row>
101                        <entry><emphasis>horizontalPosition</emphasis></entry>
102                        <entry><type>String</type></entry>
103                        <entry>"left"</entry>
104
105                        <entry>
106                            Kann "left", "center" oder "right" sein. Das kann bei
107                            <acronym>PDF</acronym> nützlich sein, oder wenn die
108                            <methodname>setWidth()</methodname> Methode mit einem Image Renderer
109                            verwendet wird.
110                        </entry>
111                    </row>
112
113                    <row>
114                        <entry><emphasis>verticalPosition</emphasis></entry>
115                        <entry><type>String</type></entry>
116                        <entry>"top"</entry>
117
118                        <entry>
119                            Kann "top", "middle" oder "bottom" sein. Das kann bei
120                            <acronym>PDF</acronym> nützlich sein, oder wenn die
121                            <methodname>setHeight()</methodname> Methode mit einem Image Renderer
122                            verwendet wird.
123                        </entry>
124                    </row>
125
126                    <row>
127                        <entry><emphasis>leftOffset</emphasis></entry>
128                        <entry><type>Integer</type></entry>
129                        <entry>0</entry>
130
131                        <entry>
132                            Oberste Position des Barcodes innerhalb des Renderers. Wenn er verwendet
133                            wird, überschreibt dieser Wert die Option "horizontalPosition".
134                        </entry>
135                    </row>
136
137                    <row>
138                        <entry><emphasis>topOffset</emphasis></entry>
139                        <entry><type>Integer</type></entry>
140                        <entry>0</entry>
141
142                        <entry>
143                            Oberste Position des Barcodes innerhalb des Renderers. Wenn er verwendet
144                            wird, überschreibt dieser Wert die Option "verticalPosition".
145                        </entry>
146                    </row>
147
148                    <row>
149                        <entry><emphasis>automaticRenderError</emphasis></entry>
150                        <entry><type>Boolean</type></entry>
151                        <entry><constant>TRUE</constant></entry>
152
153                        <entry>
154                            Ob Fehler automatisch dargestellt werden sollen oder nicht. Wenn eine
155                            Exception stattfindet, wird das angegebene Barcode Objekt mit einer
156                            Repräsentation des Fehlers ersetzt. Es ist zu beachten das einige Fehler
157                            (oder Exceptions) nicht dargestellt werden können.
158                        </entry>
159                    </row>
160
161                    <row>
162                        <entry><emphasis>moduleSize</emphasis></entry>
163                        <entry><type>Float</type></entry>
164                        <entry>1</entry>
165                        <entry>Größe eines darstellenden Moduls im Support.</entry>
166                    </row>
167
168                    <row>
169                        <entry><emphasis>barcode</emphasis></entry>
170                        <entry><classname>Zend_Barcode_Object</classname></entry>
171                        <entry><constant>NULL</constant></entry>
172                        <entry>Das Barcode Objekt welches dargestellt werden soll.</entry>
173                    </row>
174                </tbody>
175            </tgroup>
176        </table>
177
178        <para>
179            Es existiert ein zusätzlicher Getter: <methodname>getType()</methodname>. Er gibt den
180            Namen der Renderer Klasse ohne den Namespace zurück (z.B. gibt
181            <classname>Zend_Barcode_Renderer_Image</classname> "image" zurück.
182        </para>
183    </sect2>
184
185    <sect2 id="zend.barcode.renderers.image">
186        <title>Zend_Barcode_Renderer_Image</title>
187
188        <para>
189            Der Image Renderer zeichnet die Anweisungsliste des Barcode Obejekts in eine Bild
190            Ressource. Die Komponente benötigt die GD Erweiterung. Die Standardbreite eines
191            Moduls ist 1 Pixel.
192        </para>
193
194        <para>Vorhandene Optionen sind:</para>
195
196        <table id="zend.barcode.renderers.image.table">
197            <title>Zend_Barcode_Renderer_Image Optionen</title>
198
199            <tgroup cols="4">
200                <thead>
201                    <row>
202                        <entry>Option</entry>
203                        <entry>Daten Typ</entry>
204                        <entry>Standardwert</entry>
205                        <entry>Beschreibung</entry>
206                    </row>
207                </thead>
208
209                <tbody>
210                    <row>
211                        <entry><emphasis>height</emphasis></entry>
212                        <entry><type>Integer</type></entry>
213                        <entry>0</entry>
214
215                        <entry>
216                            Erlaubt es die Höhe des ergebenen Bildes zu spezifizieren. Wenn diese
217                            "0" ist wird die Höhe vom Barcode Objekt kalkuliert.
218                        </entry>
219                    </row>
220
221                    <row>
222                        <entry><emphasis>width</emphasis></entry>
223                        <entry><type>Integer</type></entry>
224                        <entry>0</entry>
225
226                        <entry>
227                            Erlaubt es die Breite des ergebenden Bildes zu spezifizieren. Wenn diese
228                            "0" ist wird die Breite vom Barcode Objekt kalkuliert.
229                        </entry>
230                    </row>
231
232                    <row>
233                        <entry><emphasis>imageType</emphasis></entry>
234                        <entry><type>String</type></entry>
235                        <entry>"png"</entry>
236
237                        <entry>
238                            Spezifiziert das Bildformat. Kann "png", "jpeg", "jpg" oder "gif" sein.
239                        </entry>
240                    </row>
241                </tbody>
242            </tgroup>
243        </table>
244    </sect2>
245
246    <sect2 id="zend.barcode.renderers.pdf">
247        <title>Zend_Barcode_Renderer_Pdf</title>
248
249        <para>
250            Der <acronym>PDF</acronym> Renderer zeichnet die Anweisungsliste des Barcode Objekts in
251            ein <acronym>PDF</acronym> Dokument. Die Standardbreite eines Moduls ist 0.5 Punkt.
252        </para>
253
254        <para>
255            Es gibt keine speziellen Optionen für diesen Renderer.
256        </para>
257    </sect2>
258</sect1>