<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
<document>
  <header>
    <title>Code 128</title>
  </header>
  <body>
    <p>see also: <link href="symbol-ean-128.html">UCC/EAN-128, GS1-128</link></p>
    <section id="example">
      <title>Example</title>
      <figure src="../images/example-code128.png" alt="Example Code 128 symbol"/>
    </section>
    <section id="structure">
      <title>Structure</title>
      <p>The configuration for the default implementation is:</p>
      <source>&#60;barcode&#62;
  &#60;<strong>code128</strong>&#62;
      &#60;height&#62;{<link href="barcode-xml.html#length">length</link>:15mm}&#60;/height&#62;
      &#60;module-width&#62;{<link href="barcode-xml.html#length">length</link>:0.21mm}&#60;/module-width&#62;
      &#60;codesets&#62;{<link href="barcode-xml.html#string">string</link>:ABC}&#60;/codesets&#62;
      &#60;quiet-zone enabled="{<link href="barcode-xml.html#boolean">boolean</link>:true}"&#62;{<link href="barcode-xml.html#length">length</link>:10mw}&#60;/quiet-zone&#62;
      &#60;human-readable&#62;
        &#60;placement&#62;{<link href="barcode-xml.html#human-readable-placement">human-readable-placement</link>:bottom}&#60;/placement&#62;
        &#60;font-name&#62;{<link href="barcode-xml.html#font-name">font-name</link>:Helvetica}&#60;/font-name&#62;
        &#60;font-size&#62;{<link href="barcode-xml.html#length">length</link>:8pt}&#60;/font-size&#62;
      &#60;/human-readable&#62;
  &#60;/<strong>code128</strong>&#62;
&#60;/barcode&#62;</source>
    </section>
    <section>
      <title>Notes</title>
      <ul>
        <li>The height should be at least 0.15 times the barcode's length or 0.25 inches.</li>
        <li>
          Code 128 codesets can be restricted to A, B, C or a combination of the three. Example:
          "AB" enables A and B. "C" just enables C and therefore only allows an even number of
          digits.
        </li>
      </ul>
    </section>
    <section>
      <title>Message format</title>
      <ul>
        <li>Valid characters: The full 7 bit ASCII (US-ASCII) character set is supported</li>
        <li>
          Functions 1 to 4 may be used. They are encoded as ASCII characters 
          0xF1 (241), 0xF2 (242), 0xF3 (243) and 0xF4 (244) in the message.
        </li>
        <li>
          Unlike with barcode fonts, the start, stop and checksum character shall NOT be part of
          the message as they are added automatically.
        </li>
      </ul>
    </section>
  </body>
</document>

