Introducción a Zend Framework

 Aprendiendo Zend Framework

Apéndice

 Referencia de Zend Framework


  • Zend_Gdata
  • Zend_Http
  • Zend_InfoCard
  • Zend_Json
  • Zend_Layout
  • Zend_Ldap
  • Zend_Loader
  • Zend_Locale
  • Zend_Log
  • Zend_Mail
  • Zend_Markup
  • Zend_Measure
  • Zend_Memory
  • Zend_Mime
  • Zend_Navigation
  • Zend_Oauth
  • Zend_OpenId
  • Zend_Paginator
  • Zend_Pdf
  • Zend_ProgressBar
  • Zend_Queue
  • Zend_Reflection
  • Zend_Registry
  • Zend_Rest

  • Zend_Search_Lucene
  • Zend_Serializer
  • Zend_Server
  • Zend_Service
  • Zend_Session
  • Zend_Soap
  • Zend_Tag
  • Zend_Test
  • Zend_Text
  • Zend_TimeSync
  • Zend_Tool
  • Zend_Tool_Framework
  • Zend_Tool_Project
  • Zend_Translate
  • Zend_Uri
  • Zend_Validate
  • Zend_Version
  • Zend_View
  • Zend_Wildfire
  • Zend_XmlRpc
  • ZendX_Console_Process_Unix
  • ZendX_JQuery
  • Traducción al 26.9% - Actualizado el 2011-11-16 - Revisión 24249 - Versión ZF 1.11.x

    16.3. Zend_Barcode Objects

    Barcode objects allow you to generate barcodes independently of the rendering support. After generation, you can retrieve the barcode as an array of drawing instructions that you can provide to a renderer.

    Objects have a large number of options. Most of them are common to all objects. These options can be set in four ways:

    • As an array or a Zend_Config object passed to the constructor.

    • As an array passed to the setOptions() method.

    • As a Zend_Config object passed to the setConfig() method.

    • Via individual setters for each configuration type.

    Ejemplo 16.7. Different ways to parameterize a barcode object

    $options = array('text' => 'ZEND-FRAMEWORK''barHeight' => 40);

    // Case 1: constructor
    $barcode = new Zend_Barcode_Object_Code39($options);

    // Case 2: setOptions()
    $barcode = new Zend_Barcode_Object_Code39();
    $barcode->setOptions($options);

    // Case 3: setConfig()
    $config  = new Zend_Config($options);
    $barcode = new Zend_Barcode_Object_Code39();
    $barcode->setConfig($config);

    // Case 4: individual setters
    $barcode = new Zend_Barcode_Object_Code39();
    $barcode->setText('ZEND-FRAMEWORK')
            ->
    setBarHeight(40);

    16.3.1. Common Options

    In the following list, the values have no units; we will use the term "unit." For example, the default value of the "thin bar" is "1 unit". The real units depend on the rendering support (see the renderers documentation for more information). Setters are each named by uppercasing the initial letter of the option and prefixing the name with "set" (e.g. "barHeight" becomes "setBarHeight"). All options have a corresponding getter prefixed with "get" (e.g. "getBarHeight"). Available options are:

    Tabla 16.1. Common Options

    Option Data Type Default Value Description
    barcodeNamespace String Zend_Barcode_Object Namespace of the barcode; for example, if you need to extend the embedding objects
    barHeight Integer 50 Height of the bars
    barThickWidth Integer 3 Width of the thick bar
    barThinWidth Integer 1 Width of the thin
    factor Integer 1 Factor by which to multiply bar widths and font sizes
    foreColor Integer 0 (black) Color of the bar and the text. Could be provided as an integer or as a HTML value (e.g. "#333333")
    backgroundColor Integer or String 16777125 (white) Color of the background. Could be provided as an integer or as a HTML value (e.g. "#333333")
    reverseColor Boolean FALSE Allow switching the color of the bar and the background
    orientation Integer 0 Orientation of the barcode
    font String or Integer NULL Font path to a TTF font or a number between 1 and 5 if using image generation with GD (internal fonts)
    fontSize Integer 10 Size of the font (not applicable with numeric fonts)
    withBorder Boolean FALSE Draw a border around the barcode and the quiet zones
    withQuietZones Boolean TRUE Leave a quiet zone before and after the barcode
    drawText Boolean TRUE Set if the text is displayed below the barcode
    stretchText Boolean FALSE Specify if the text is stretched all along the barcode
    withChecksum Boolean FALSE Indicate whether or not the checksum is automatically added to the barcode
    withChecksumInText Boolean FALSE Indicate whether or not the checksum is displayed in the textual representation
    text String NULL The text to represent as a barcode

    16.3.1.1. Particular case of static setBarcodeFont()

    You can set a commont font for all your objects by using the static method Zend_Barcode_Object::setBarcodeFont(). This value can be always be overridden for individual objects by using the setFont() method.

    // In your bootstrap:
    Zend_Barcode_Object::setBarcodeFont('my_font.ttf');

    // Later in your code:
    Zend_Barcode::render(
        
    'code39',
        
    'pdf',
        array(
    'text' => 'ZEND-FRAMEWORK')
    ); 
    // will use 'my_font.ttf'

    // or:
    Zend_Barcode::render(
        
    'code39',
        
    'image',
        array(
            
    'text' => 'ZEND-FRAMEWORK',
            
    'font' => 3
        
    )
    ); 
    // will use the 3rd GD internal font

    16.3.2. Common Additional Getters

    Tabla 16.2. Common Getters

    Getter Data Type Description
    getType() String Return the name of the barcode class without the namespace (e.g. Zend_Barcode_Object_Code39 returns simply "code39")
    getRawText() String Return the original text provided to the object
    getTextToDisplay() String Return the text to display, including, if activated, the checksum value
    getQuietZone() Integer Return the size of the space needed before and after the barcode without any drawing
    getInstructions() Array Return drawing instructions as an array.
    getHeight($recalculate = false) Integer Return the height of the barcode calculated after possible rotation
    getWidth($recalculate = false) Integer Return the width of the barcode calculated after possible rotation
    getOffsetTop($recalculate = false) Integer Return the position of the top of the barcode calculated after possible rotation
    getOffsetLeft($recalculate = false) Integer Return the position of the left of the barcode calculated after possible rotation

    16.3.3. Description of shipped barcodes

    You will find below detailed information about all barcode types shipped by default with Zend Framework.

    16.3.3.1. Zend_Barcode_Object_Error

    This barcode is a special case. It is internally used to automatically render an exception caught by the Zend_Barcode component.

    16.3.3.2. Zend_Barcode_Object_Code128

    • Name: Code 128

    • Allowed characters: the complete ASCII-character set

    • Checksum: optional (modulo 103)

    • Length: variable

    There are no particular options for this barcode.

    16.3.3.3. Zend_Barcode_Object_Code25

    • Name: Code 25 (or Code 2 of 5 or Code 25 Industrial)

    • Allowed characters: '0123456789'

    • Checksum: optional (modulo 10)

    • Length: variable

    There are no particular options for this barcode.

    16.3.3.4. Zend_Barcode_Object_Code25interleaved

    This barcode extends Zend_Barcode_Object_Code25 (Code 2 of 5), and has the same particulars and options, and adds the following:

    • Name: Code 2 of 5 Interleaved

    • Allowed characters: '0123456789'

    • Checksum: optional (modulo 10)

    • Length: variable (always even number of characters)

    Available options include:

    Tabla 16.3. Zend_Barcode_Object_Code25interleaved Options

    Option Data Type Default Value Description
    withBearerBars Boolean FALSE Draw a thick bar at the top and the bottom of the barcode.

    [Nota] Nota

    If the number of characters is not even, Zend_Barcode_Object_Code25interleaved will automatically prepend the missing zero to the barcode text.

    16.3.3.5. Zend_Barcode_Object_Ean2

    This barcode extends Zend_Barcode_Object_Ean5 (EAN 5), and has the same particulars and options, and adds the following:

    • Name: EAN-2

    • Allowed characters: '0123456789'

    • Checksum: only use internally but not displayed

    • Length: 2 characters

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 2, Zend_Barcode_Object_Ean2 will automatically prepend the missing zero to the barcode text.

    16.3.3.6. Zend_Barcode_Object_Ean5

    This barcode extends Zend_Barcode_Object_Ean13 (EAN 13), and has the same particulars and options, and adds the following:

    • Name: EAN-5

    • Allowed characters: '0123456789'

    • Checksum: only use internally but not displayed

    • Length: 5 characters

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 5, Zend_Barcode_Object_Ean5 will automatically prepend the missing zero to the barcode text.

    16.3.3.7. Zend_Barcode_Object_Ean8

    This barcode extends Zend_Barcode_Object_Ean13 (EAN 13), and has the same particulars and options, and adds the following:

    • Name: EAN-8

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 8 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 8, Zend_Barcode_Object_Ean8 will automatically prepend the missing zero to the barcode text.

    16.3.3.8. Zend_Barcode_Object_Ean13

    • Name: EAN-13

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 13 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 13, Zend_Barcode_Object_Ean13 will automatically prepend the missing zero to the barcode text.

    The option withQuietZones has no effect with this barcode.

    16.3.3.9. Zend_Barcode_Object_Code39

    • Name: Code 39

    • Allowed characters: '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ -.$/+%'

    • Checksum: optional (modulo 43)

    • Length: variable

    [Nota] Nota

    Zend_Barcode_Object_Code39 will automatically add the start and stop characters ('*') for you.

    There are no particular options for this barcode.

    16.3.3.10. Zend_Barcode_Object_Identcode

    This barcode extends Zend_Barcode_Object_Code25interleaved (Code 2 of 5 Interleaved), and inherits some of its capabilities; it also has a few particulars of its own.

    • Name: Identcode (Deutsche Post Identcode)

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10 different from Code25)

    • Length: 12 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 12, Zend_Barcode_Object_Identcode will automatically prepend missing zeros to the barcode text.

    16.3.3.11. Zend_Barcode_Object_Itf14

    This barcode extends Zend_Barcode_Object_Code25interleaved (Code 2 of 5 Interleaved), and inherits some of its capabilities; it also has a few particulars of its own.

    • Name: ITF-14

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 14 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 14, Zend_Barcode_Object_Itf14 will automatically prepend missing zeros to the barcode text.

    16.3.3.12. Zend_Barcode_Object_Leitcode

    This barcode extends Zend_Barcode_Object_Identcode (Deutsche Post Identcode), and inherits some of its capabilities; it also has a few particulars of its own.

    • Name: Leitcode (Deutsche Post Leitcode)

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10 different from Code25)

    • Length: 14 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 14, Zend_Barcode_Object_Leitcode will automatically prepend missing zeros to the barcode text.

    16.3.3.13. Zend_Barcode_Object_Planet

    • Name: Planet (PostaL Alpha Numeric Encoding Technique)

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 12 or 14 characters (including checksum)

    There are no particular options for this barcode.

    16.3.3.14. Zend_Barcode_Object_Postnet

    • Name: Postnet (POSTal Numeric Encoding Technique)

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 6, 7, 10 or 12 characters (including checksum)

    There are no particular options for this barcode.

    16.3.3.15. Zend_Barcode_Object_Royalmail

    • Name: Royal Mail or RM4SCC (Royal Mail 4-State Customer Code)

    • Allowed characters: '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ'

    • Checksum: mandatory

    • Length: variable

    There are no particular options for this barcode.

    16.3.3.16. Zend_Barcode_Object_Upca

    This barcode extends Zend_Barcode_Object_Ean13 (EAN-13), and inherits some of its capabilities; it also has a few particulars of its own.

    • Name: UPC-A (Universal Product Code)

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 12 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 12, Zend_Barcode_Object_Upca will automatically prepend missing zeros to the barcode text.

    The option withQuietZones has no effect with this barcode.

    16.3.3.17. Zend_Barcode_Object_Upce

    This barcode extends Zend_Barcode_Object_Upca (UPC-A), and inherits some of its capabilities; it also has a few particulars of its own. The first character of the text to encode is the system (0 or 1).

    • Name: UPC-E (Universal Product Code)

    • Allowed characters: '0123456789'

    • Checksum: mandatory (modulo 10)

    • Length: 8 characters (including checksum)

    There are no particular options for this barcode.

    [Nota] Nota

    If the number of characters is lower than 8, Zend_Barcode_Object_Upce will automatically prepend missing zeros to the barcode text.

    [Nota] Nota

    If the first character of the text to encode is not 0 or 1, Zend_Barcode_Object_Upce will automatically replace it by 0.

    The option withQuietZones has no effect with this barcode.

    digg delicious meneame google twitter technorati facebook

    Comentarios

    Loading...