<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
<document>
  <header>
    <title>PDF417</title>
  </header>
  <body>
    <p>also known as: ISO/IEC 15438:2001(E)</p>
    <section id="example">
      <title>Example</title>
      <figure src="../images/example-pdf417.png" alt="Example PDF417 symbol"/>
    </section>
    <section id="structure">
      <title>Structure</title>
      <p>The configuration for the default implementation is:</p>
      <source>&#60;barcode&#62;
  &#60;<strong>pdf417</strong>&#62;
      &#60;module-width&#62;{<link href="barcode-xml.html#length">length</link>:0.352777mm}&#60;/module-width&#62; &#60;!-- 1 pixel at 72dpi --&#62;
      &#60;row-height&#62;{<link href="barcode-xml.html#length">length</link>:3mw}&#60;/row-height&#62;
      &#60;columns&#62;{<link href="barcode-xml.html#number">number</link>:2}&#60;/columns&#62;
      &#60;min-columns&#62;{<link href="barcode-xml.html#number">number</link>:2}&#60;/min-columns&#62;
      &#60;max-columns&#62;{<link href="barcode-xml.html#number">number</link>:2}&#60;/max-columns&#62;
      &#60;min-rows&#62;{<link href="barcode-xml.html#number">number</link>:3}&#60;/min-rows&#62;
      &#60;max-rows&#62;{<link href="barcode-xml.html#number">number</link>:90}&#60;/max-rows&#62;
      &#60;ec-level&#62;{<link href="barcode-xml.html#number">number</link>:0}&#60;/ec-level&#62;
      &#60;quiet-zone enabled="{<link href="barcode-xml.html#boolean">boolean</link>:true}"&#62;{<link href="barcode-xml.html#length">length</link>:2mw}&#60;/quiet-zone&#62;
      &#60;vertical-quiet-zone&#62;{<link href="barcode-xml.html#length">length</link>:default is same as quiet-zone}&#60;/vertical-quiet-zone&#62;
      &#60;width-to-height-ratio&#62;{<link href="barcode-xml.html#number">number</link>:3.0}&#60;/width-to-height-ratio&#62;
  &#60;/<strong>pdf417</strong>&#62;
&#60;/barcode&#62;</source>
    </section>
    <section>
      <title>Notes</title>
      <ul>
        <li>This symbology has no human-readable part!</li>
        <li>"ec-level" is the error correction level and must be between 0 and 8.</li>
        <li>If "vertical-quiet-zone" is not set explicitely, it is the same as the horizontal quiet zone.</li>
        <li>Depending on the size of the message, "columns" and "ec-level" may need to be adjusted. Read possible error messages carefully.</li>
        <li>
          Alternatively, you can remove the "columns" setting and work with "min/max-columns" 
          and "min/max-rows" which allows the symbol to grow and shrink depending on the message.
          Using the "width-to-height-ratio" you can control the shape of the symbol.
          (Note: the valid number of rows must be between 3 and 90, the valid number of columns
          between 1 and 30)
        </li>
        <li>
          Using the "columns" setting overrides the "min/max-columns" setting! Or in other words:
          Setting "columns" sets "min-columns" and "max-columns" to the same value.
        </li>
        <li>Macro PDF417 functionality is not implemented, yet.</li>
        <li>Compact PDF417 functionality is not implemented, yet.</li>
      </ul>
    </section>
    <section>
      <title>Message format</title>
      <ul>
        <li>All printable ASCII characters are valid characters.</li>
        <li>Byte compaction mode permits all 256 possible 8-bit byte values to be encoded.</li>
        <li>Using only numeric characters allows for smaller symbol sizes.</li>
        <li>Currently, no ECI functionality is available. All characters are interpreted in "cp437" (PC437) encoding.</li>
      </ul>
    </section>
  </body>
</document>

