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

<?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>