summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-10-07 23:03:55 +0000
committerKarl Berry <karl@freefriends.org>2013-10-07 23:03:55 +0000
commit739a5dcbf79d2c9a807db6116b2819d25242e2a2 (patch)
tree55a080f68ca141bf97e57e765de0e4d3bd56a2a4 /Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex
parent71e1ef7201c8a380aa66cbdeb409aeeeb72ccc7e (diff)
pst-barcode (7oct13)
git-svn-id: svn://tug.org/texlive/trunk@31857 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex89
1 files changed, 74 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex b/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex
index 2fe0037cea3..cdbaa6e96e9 100644
--- a/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex
+++ b/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex
@@ -109,45 +109,49 @@ or the \Lcs{makebox} macro.
\begin{LTXexample}[pos=t,preset=\centering,wide]
\psframebox{\begin{pspicture}(2.5,1in)
-\psbarcode{12345678}{includetext}{ean8}
+\psbarcode{01335583}{includetext}{ean8}
\end{pspicture}}\quad
\psframebox{\begin{pspicture}(-2.6,-1.5)(0.4,0.2in)
-\psbarcode[rotate=180,linecolor=red]{12345678}{includetext guardwhitespace height=0.6}{ean8}
+%\psbarcode[rotate=180,linecolor=red]{01335583}{includetext guardwhitespace height=0.6}{ean8}
\end{pspicture}}\quad
\psframebox{\begin{pspicture}(3.8,1in)
-\psbarcode[scalex=1.5,scaley=0.5,transy=1]{12345678}{includetext inkspread=0.5}{ean8}
+%\psbarcode[scalex=1.5,scaley=0.5,transy=1]{01335583}{includetext inkspread=0.5}{ean8}
\end{pspicture}}
\end{LTXexample}
-
\newpage
\subsection{Examples for the PostScript options}
\begin{LTXexample}[pos=t,preset=\centering]
\begin{pspicture}(3.5,1.2in)
-\psbarcode{12345678}{includetext guardwhitespace height=0.6}{ean8}
+\psbarcode{01335583}{includetext guardwhitespace height=0.6}{ean8}
\end{pspicture}
\begin{pspicture}(3.5,1.2in)
-\psbarcode{12345678}{textsize=15 includetext guardwhitespace height=0.6}{ean8}
+\psbarcode{01335583}{textsize=15 includetext guardwhitespace height=0.6}{ean8}
\end{pspicture}
\begin{pspicture}(3.5,1.2in)
-\psbarcode{12345678}{includetext inkspread=0.5}{ean8}
+\psbarcode{01335583}{includetext inkspread=0.5}{ean8}
\end{pspicture}
\begin{pspicture}(3.5,1.2in)
-\psbarcode{12345678}{includetext textpos=0}{ean8}
+\psbarcode{01335583}{includetext textpos=0}{ean8}
\end{pspicture}
\end{LTXexample}
+
+
\begin{LTXexample}[pos=t,preset=\centering]
\begin{pspicture}(3.5,1.2in)
-\psbarcode{12345678}{includetext guardwhitespace}{ean8}
+\psbarcode{01335583}{includetext guardwhitespace}{ean8}
\end{pspicture}
\begin{pspicture}(3.5,1.2in)
-\psbarcode{12345678}{textsize=15 includetext guardwhitespace width=2}{ean8}
+\psbarcode{01335583}{textsize=15 includetext guardwhitespace width=2}{ean8}
\end{pspicture}
\end{LTXexample}
+
+
+
\section{Usage}
By default the barcode has a width and a height of zero. Using the \Lcs{parbox}
macro or the \Lenv{pspicture} environment can reserve the needed space for
@@ -198,7 +202,7 @@ try the support mailing list.
\xLps{ean13}
\begin{LTXexample}[width=.3\linewidth]
\begin{pspicture}(3,1.2in)
-\psbarcode[scalex=0.8,scaley=0.8]{9781860742712}{includetext guardwhitespace}{ean13}
+\psbarcode[scalex=0.8,scaley=0.8]{9783865415561}{includetext guardwhitespace}{ean13}
\end{pspicture}
\end{LTXexample}
@@ -218,7 +222,7 @@ try the support mailing list.
\xLps{ean8}
\begin{LTXexample}[width=.3\linewidth]
\begin{pspicture}(-2,-1.2)(0,0.2in)
-\psbarcode[rotate=180,linecolor=red]{12345678}{includetext guardwhitespace height=0.6}{ean8}
+\psbarcode[rotate=180,linecolor=red]{01335583}{includetext guardwhitespace height=0.6}{ean8}
\end{pspicture}
\end{LTXexample}
@@ -402,7 +406,7 @@ for the initial character set. UCC/EAN-128s must have a manditory
\begin{LTXexample}[pos=l,width=.4\linewidth]
\begin{pspicture}(4,1in)
-\psbarcode{0123456789}{includetext}{rationalizedCodabar}
+\psbarcode{A0123456789B}{includetext}{rationalizedCodabar}
\end{pspicture}
\end{LTXexample}
@@ -468,7 +472,7 @@ for the initial character set. UCC/EAN-128s must have a manditory
\begin{LTXexample}[width=.6\linewidth]
\begin{pspicture}(7,0.3in)
-\psbarcode{01234567}{includetext textpos=-10 textfont=Arial textsize=10}{postnet}
+\psbarcode{01234}{includetext textpos=-10 textfont=Arial textsize=10}{postnet}
\end{pspicture}
\end{LTXexample}
@@ -713,7 +717,53 @@ For a documentation see \url{http://de.wikipedia.org/wiki/Strichcode#PDF417}.
\subsection{Data matrix}
For a documentation see \url{http://de.wikipedia.org/wiki/Strichcode#DataMatrix}.
-It is used for the german post company DHL.
+It is a 2D matrix-style barcode that can encode full 256 character extended-ASCII.
+Also known as: Data Matrix ECC 200.
+Variants:
+\begin{description}
+\item[GS1] DataMatrix is a variant of Data Matrix that should be used when encoding data that is in
+GS1 Application Identifier standard format.
+ \item[HIBC] Data Matrix is a variant of Data Matrix that should be used when encoding
+ HIBC formatted data.
+\end{description}
+
+Standards: ISO/IEC 16022, ANSI/AIM BC11 ISS.
+
+Data and Options
+
+\begin{itemize}
+\item The data field can contain any extended ASCII data.
+\item When the parse option is specified, any instances of \verb|^NNN| in the data field
+are replaced with their equivalent ASCII value, useful for specifying unprintable characters.
+\item When the parsefnc option is specified, non-data function characters can be specified by \verb|^FNC1|.
+\item The columns and rows options are used to specify the size of the symbol, either square or rectangular, one of:
+ Square: 10x10, 12x12, 14x14, 16x16, 18x18, 20x20, 22x22, 24x24, 26x26, 32x32, 36x36, 40x40,
+ 44x44, 48x48, 52x52, 64x64, 72x72, 80x80, 88x88, 96x96, 104x104, 120x120, 132x132, 144x144
+ Rectangular: 8x18, 8x32, 12x26, 12x36, 16x36, 16x48
+\item If the columns and rows are unspecified, the encoder will default to creating a (non-rectangular)
+symbol that is the minimum size to represent the given data.
+\item The raw option denotes that the data field is providing the input as a pre-encoded codewords in \verb|^NNN|
+format, suitable for direct low-level encoding.
+\item The encoding option specifies how the data is to be encoded. Possible values are:
+\begin{itemize}
+\item encoding=ascii - Extended ASCII data (default).
+\item encoding=c40 - Optimized encoding for upper-case alphanumeric data. Can also encode extended ASCII
+data but incurs extra codeword overhead.
+\item encoding=text - Optimized encoding for lower-case alphanumeric data. Can also encode
+extended ASCII data but incurs extra codeword overhead.
+\item encoding=x12 - Optimized encoding restricted to upper-case alphanumeric data plus the characters \verb|\r * >| and space.
+\item encoding=raw - Same as the raw option.
+\end{itemize}
+\item The prefix option allows adding a special codeword to the symbol prior to the data. Possible values are:
+\begin{itemize}
+\item prefix=MAC5 - Prefixes the data with the 05 Macro codeword.
+\item prefix=MAC6 - Prefixes the data with the 06 Macro codeword.
+\item prefix=PROG - Prefixes the data with the reader programming codeword. May require encoding=c40, depending on the reader.
+\item prefix=FNC1 - Prefixes the data with the FNC1 codeword.
+\end{itemize}
+\end{itemize}
+
+
\begin{description}
\item[Characters] extended ASCII
@@ -726,6 +776,15 @@ It is used for the german post company DHL.
\end{pspicture}
\end{LTXexample}
+
+\begin{LTXexample}[pos=l,width=1.6in,wide]
+\begin{pspicture}(1in,1in)
+\psbarcode{^098^099^100^142^164^186^101^102^103^104^105}{raw}{datamatrix}
+\end{pspicture}
+\end{LTXexample}
+
+
+
\subsection{2D Maxi code}
For a documentation see \url{http://www.logicalconcepts.eu/wDeutsch/autoid/barcodetypen/index.html?navid=21}.
MaxiCode is a fixed-sized two-dimensional symbology created by the