Los renderizadores tienen algunas opciones comunes. Estas opciones se pueden establecer de cuatro maneras:
Como un array o un objeto
Zend_Configpasado al constructor.Como un array pasado al método
setOptions().Como un objeto
Zend_Configpasado al métodosetConfig().Como valores discretos pasados a setters individuales.
Ejemplo 16.8. Diferentes formas de parametrizar un objeto renderizador
$options = array('topOffset' => 10);
// Case 1
$renderer = new Zend_Barcode_Renderer_Pdf($options);
// Case 2
$renderer = new Zend_Barcode_Renderer_Pdf();
$renderer->setOptions($options);
// Case 3
$config = new Zend_Config($options);
$renderer = new Zend_Barcode_Renderer_Pdf();
$renderer->setConfig($config);
// Case 4
$renderer = new Zend_Barcode_Renderer_Pdf();
$renderer->setTopOffset(10);
En la siguiente lista, los valores no tienen unidad; utilizaremos el término "unidad." Por ejemplo, el valor predeterminado de la "barra fina" es "1 unidad." Las unidades reales dependen del soporte de renderizado. Los setters individuales se obtienen poniendo en mayúscula la letra inicial de la opción y anteponiendo el nombre con "set" (por ejemplo, "barHeight" => "setBarHeight"). Todas las opciones tienen un getter correspondiente prefijado con "get" (por ejemplo, "getBarHeight"). Las opciones disponibles son:
Tabla 16.4. Opciones comunes
| Opción | Tipo de dato | Valor predeterminado | Descripción |
|---|---|---|---|
| rendererNamespace | String | Zend_Barcode_Renderer |
Espacio de nombres del renderizador; por ejemplo, si necesita extender los renderizadores |
| horizontalPosition | String | "left" |
Puede ser "left", "center" o "right". Puede ser útil con
PDF o si el método setWidth()
se usa con un renderizador de imágenes.
|
| verticalPosition | String | "top" |
Puede ser "top", "middle" o "bottom". Puede ser útil con
PDF o si el método setHeight()
se usa con un renderizador de imágenes.
|
| leftOffset | Integer | 0 | Posición superior del código de barras dentro del renderizador. Si se usa, este valor sobrescribirá la opción "horizontalPosition". |
| topOffset | Integer | 0 | Posición superior del código de barras dentro del renderizador. Si se usa, este valor sobrescribirá la opción "verticalPosition". |
| automaticRenderError | Boolean | TRUE |
Indica si se deben renderizar los errores automáticamente. Si ocurre una excepción, el objeto de código de barras proporcionado será reemplazado por una representación de error. Tenga en cuenta que algunos errores (o excepciones) no se pueden renderizar. |
| moduleSize | Float | 1 | Tamaño de un módulo de renderizado en el soporte. |
| barcode | Zend_Barcode_Object |
NULL |
El objeto de código de barras a renderizar. |
Existe un getter adicional: getType(). Devuelve el nombre de
la clase del renderizador sin el espacio de nombres (por ejemplo,
Zend_Barcode_Renderer_Image devuelve "image").
El renderizador Image dibujará la lista de instrucciones del objeto de código de barras en un recurso de imagen. El componente requiere la extensión GD. El ancho predeterminado de un módulo es 1 píxel.
Las opciones disponibles son:
Tabla 16.5. Opciones de Zend_Barcode_Renderer_Image
| Opción | Tipo de dato | Valor predeterminado | Descripción |
|---|---|---|---|
| height | Integer | 0 | Le permite especificar la altura de la imagen resultante. Si es "0", la altura será calculada por el objeto de código de barras. |
| width | Integer | 0 | Le permite especificar el ancho de la imagen resultante. Si es "0", el ancho será calculado por el objeto de código de barras. |
| imageType | String | "png" | Especifica el formato de la imagen. Puede ser "png", "jpeg", "jpg" o "gif". |
El renderizador PDF dibujará la lista de instrucciones del objeto de código de barras en un documento PDF. El ancho predeterminado de un módulo es 0.5 puntos.
No hay opciones particulares para este renderizador.
El renderizador SVG dibujará la lista de instrucciones del objeto de código de barras en un documento SVG. El ancho predeterminado de un módulo es 1 píxel.
Las opciones disponibles son:
Tabla 16.6. Opciones de Zend_Barcode_Renderer_Svg
| Opción | Tipo de dato | Valor predeterminado | Descripción |
|---|---|---|---|
| height | Integer | 0 | Le permite especificar la altura de la imagen resultante. Si es "0", la altura será calculada por el objeto de código de barras. |
| width | Integer | 0 | Le permite especificar el ancho de la imagen resultante. Si es "0", el ancho será calculado por el objeto de código de barras. |