summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-barcode
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-09-08 00:26:03 +0000
committerKarl Berry <karl@freefriends.org>2008-09-08 00:26:03 +0000
commit883bf95bf548e81277aeb42fc6e26f1926744a3a (patch)
tree5013850e952659925803841fa0d4df17feb59115 /Master/texmf-dist/doc/generic/pst-barcode
parent312223ebc369a2dc7e17fa003b535082b73a163e (diff)
pst-barcode update (30aug08)
git-svn-id: svn://tug.org/texlive/trunk@10466 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-barcode')
-rw-r--r--Master/texmf-dist/doc/generic/pst-barcode/Changes75
-rw-r--r--Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.pdfbin240531 -> 256484 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex133
3 files changed, 132 insertions, 76 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-barcode/Changes b/Master/texmf-dist/doc/generic/pst-barcode/Changes
deleted file mode 100644
index dc5265db8bb..00000000000
--- a/Master/texmf-dist/doc/generic/pst-barcode/Changes
+++ /dev/null
@@ -1,75 +0,0 @@
------ pst-barcode.tex
-0.04 2006-07-23 - adding support for the ISBN-13 code
- - printing the code from the current point and
- no more from the origin
-0.03 2005-07-26 - Changes to the documentation and the syntax
- of psbarcode (hv)
-0.02 2005-07-26 - first version (hv)
-
-
------ pst-barcode.sty
-0.01 2005-07-26 first version (hv)
-
-
------ pst-barcode.pro
-2007-05-22 - Added parsable example options field to each encoder.
- - An encoder for the Pharmaceutical Binary Code symbology was added.
-2007-04-22 - Added CMYK colorspace support.
- - Fixed incorrect checksum calculation for UPC-E symbols.
- - Added raw encoder to make it easier to create
- miscellaneous symbols in a custom symbology.
- - Functional comments were added to the head of the encoders
- to allow applications to extract the symbology name and
- example input data.
- - An encoder for the Reduced Space Symbology RSS Expanded was added.
- - The incorrect definition of the USPS FIM-B symbol was fixed.
- - An encoder for the Reduced Space Symbology RSS Limited was added.
- - The efficiency of RSS-14 was improved.
- - An encoder for the Reduced Space Symbology RSS-14 was added.
- - An encoder for the new OneCode symbology used by the
- US Postal Service was added.
-2006-03-04 - An encoder for the Reduced Space Symbology RSS Expanded
- was added.
- - The incorrect definition of the USPS FIM-B symbol was fixed.
- - An encoder for the Reduced Space Symbology RSS Limited was added.
- The efficiency of RSS-14 was improved.
- - An encoder for the new OneCode symbology used by the US
- Postal Service was added.
- - The FIM symbols now render according to their specification.
- - The Postnet, Royal Mail, AusPost and KIX encoders were amended
- so that the metrics of their default symbols confirms
- strongly to their respective specifications.
- - The encoders now pass an array containing the widths of the
- bar space succession to the renderer allowing for sub-point
- horizontal precision.
- - The default border positions for EAN and UPC symbols were
- amended to properly enclose the human readable text.
- - The colour support code was fixed to prevent overwriting of
- the current colour when values are left unspecified.
- - The logic to guard whitespace in EAN symbols was migrated
- from the encoders to the renderer.
- - The whitespace guard symbols are now drawn directly making them
- independant of any font.
- - The inter-guard bar height of EANs and UPCs was amended.
- - The renderer was amended to support the passing of encoder
- specific arguments.
- - The options barcolor, textcolor, bordercolor, showbackground
- and backgroundcolor were added to the renderer.
- - A flaw in the derivation of the top border height was fixed.
- - add support for the new ISBN-13
- - printing the code from the current point
- - The performance of the renderer was improved by avoiding
- unnecessary calls of setfont
- - The auspost encoder was extended to support the customer
- information field.
-2005-10-24 - A new encoder for the bar codes used by the
- Australian Postal Service was added.
-2005-10-17 - adding a checksum for code 2of5 encoder
-2005-10-14 - some more changes to the possible charcters
-2005-09-26 - A new encoder was added to support the generation
- of miscellaneous symbols.
- - Support for generation of FIM symbols used on
- US Postal service reply mail was added.
-2005-09-15 added Kix -- Dutch mail
-2005-09-17 choose the right syntax for saving the length
-2005-09-08 some more tweaks to the code
diff --git a/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.pdf b/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.pdf
index 15aa95ef74f..5585da25fd0 100644
--- a/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.pdf
+++ b/Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.pdf
Binary files differ
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 12dce6bccb4..0781c0240ca 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
@@ -7,6 +7,7 @@
\usepackage[ps2pdf,colorlinks,linktocpage]{hyperref}
\usepackage{breakurl}
\def\CMD#1{\texttt{\textbackslash #1}}
+\def\PS{PostScript}
\title{Package \texttt{pst-barcode}\\
\footnotesize v. \PSTfileversion}
@@ -22,7 +23,7 @@
\textrm{\emph{file name}} & \emph{meaning} & \emph{version}\\\hline
pst-barcode.sty & \LaTeX\ style file -- wrapper & 2006-07-23\\
pst-barcode.tex & \TeX\ file -- PS interface & 2006-07-23\\
-pst-barcode.pro & PostScript file & 2007-05-22\\
+pst-barcode.pro & PostScript file & 2008-01-15\\
pst-barcode-doc.tex & documentation source & 2007-05-22\\
pst-barcode-doc.pdf & documentation PDF & 2007-05-22\\
pst-barcode-doc.bib & Bibliography file & 2007-05-22
@@ -654,7 +655,133 @@ For a documentation see \url{http://www.laetus.com/laetus.php?request=file&id=69
\end{pspicture}
\end{LTXexample}
+\subsection{PDF417}
+For a documentation see \url{http://de.wikipedia.org/wiki/Strichcode#PDF417}.
+\begin{description}
+\item[Characters] \verb!0123456789!
+\item[Data] Variable number characters
+\end{description}
+
+\begin{LTXexample}[width=2in,wide]
+\begin{pspicture}(2in,0.3in)
+\psbarcode{^453^178^121^239}{columns=2 rows=10}{pdf417}
+\end{pspicture}
+\end{LTXexample}
+
+\subsection{Data matrix}
+For a documentation see \url{http://de.wikipedia.org/wiki/Strichcode#DataMatrix}.
+
+\begin{description}
+\item[Characters] \verb!0123456789!
+\item[Data] Variable number characters
+\end{description}
+
+\begin{LTXexample}[width=1in,wide]
+\begin{pspicture}(1in,1in)
+%\psbarcode{Herbert Voss}{rows=48 columns=48}{datamatrix}
+\psbarcode{^142^164^186}{rows=48 columns=48}{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
+United Parcel Service that is primarily used for freight sortation
+and tracking. It's symbols have modules arranged in a hexagonal
+grid around a circular finder pattern which can be read omnidirectionally.
+
+\begin{itemize}
+\item MaxiCode has five alphabets A, B, C, D and E, each containing 64 characters.
+\begin{itemize}
+ \item Alphabet A contains mostly upper case letters, numbers and some common ASCII symbols.
+ \item Alphabet B contains mostly lower case letters and common ASCII symbols.
+ \item Alphabet C contains mostly upper case letters from the extended ASCII character set and less common ASCII symbols.
+ \item Alphabet D contains mostly lower case letters from the extended ASCII character set and less common ASCII symbols.
+ \item Alphabet E contains mostly the special ASCII characters and unprintable symbols.
+\end{itemize}
+\item Non-printable/typable characters can be entered as their escaped ordinal values, e.g. \textasciicircum 028 for FS and \textasciicircum 059 for [shift B], etc.
+\item The symbol always starts in alphabet A which is suitable for the most basic contents.
+\item You can switch the working alphabet within the data using the [latch B], [latch A], ... characters.
+\item You can temporarily shift to another alphabet for a varying number of characters using the [shift A], [2 shift A], [3 shift A], ... characters.
+\item You can remain in an alphabet to which you have shifted using the [lock in C], [lock in D], ... characters.
+\item There are also more advanced features for encoding for which a thorough reading of the specification is required as these cannot be described succinctly here.
+\end{itemize}
+
+The modes:
+\begin{itemize}
+\item Mode 0 - Obsolete. (Older printers will produce Mode 0 if the firmware is outdated. Mode 0 MaxiCodes can be visually determined by examining the two horizontal hexagons in the upper right-hand corner. They will be white if the Mode is 0. For all other modes, they are black.)
+\item Mode 2 - Used for Numeric postal codes. (Primary use is US domestic destinations.)
+\item Mode 3 - Used for Alphanumeric postal codes. (Primary use is Int'l destinations.)
+\item Mode 4 - Standard Error Correction.
+\item Mode 5 - Enhanced Error Correction.
+\item Mode 6 - Used for programming hardware devices.
+\end{itemize}
+
+UPS labels use Mode 2 or Mode 3 MaxiCodes.
+
+
+Example MaxiCode in mode 2 with standard field identifier [)>GS01GSyy
+
+%(^059^042^041^059^040^03001^02996152382802^029840^029001^0291Z00004951^029UPSN^02906X610^029159^0291234567^0291^0471^029^029Y^029634
+%ALPHA DR^029PITTSBURGH^029PA^030^062^004^063) (mode 2) maxicode barcode
+
+\begin{description}
+\item[Characters] \verb!@ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!
+\item[Data] Variable number characters
+\end{description}
+
+\begin{LTXexample}[width=1in,wide]
+\begin{pspicture}(1in,1in)
+\psbarcode{^059^042^041^059^040^03001^02996152382802^029840^029001^0291Z00004951^029UPSN^02906X610^029159^0291234567^0291^0471^029^029Y^029634
+ALPHA DR^029PITTSBURGH^029PA^030^062^004^063}{mode=2}{maxicode}
+\end{pspicture}
+\end{LTXexample}
+
+
+\subsection{QR Code}
+A QR Code (Quick Response) is a 2 dimensional matrix code created by Japanese
+corporation Denso-Wave in 1994 (\url{http://de.wikipedia.org/wiki/QR_Code}).
+
+
+\begin{description}
+\item[Characters] \verb!0123456789!
+\item[Data] Variable number characters
+\end{description}
+
+\begin{LTXexample}[width=1in,wide]
+\begin{pspicture}(1in,1in)
+\psbarcode{000100000010000000001100010101100110000110000}%
+ {version=1 eclevel=M}{qrcode}
+\end{pspicture}
+\end{LTXexample}
+
+
+\subsection{Aztec Code}
+Aztec Code is a 2 dimensional matrix style bar code symbology.
+Aztec Code was invented by Andrew Longacre (USA) in 1995
+(\url{http://de.wikipedia.org/wiki/Aztec_Code}).
+
+
+\begin{description}
+\item[Characters] \verb!0123456789!
+\item[Data] Variable number characters
+\end{description}
+
+\begin{LTXexample}[width=1in,wide]
+\begin{pspicture}(1in,1in)
+\psbarcode{00100111001000000101001101111000010100111100101000000110}%
+ {format=compact layers=3}{azteccode}
+\end{pspicture}
+\end{LTXexample}
+
+
+
+
+
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{pst-barcode-doc}
\section{Code Commentary}
@@ -1038,6 +1165,9 @@ serverdict begin 0 exitserver systemdict /quit get exec
+
+
+
\clearpage
\section{Package code}
\subsection{\texttt{pst-barcode.sty}}
@@ -1049,5 +1179,6 @@ serverdict begin 0 exitserver systemdict /quit get exec
%\subsection{\texttt{pst-barcode.pro}}
%\lstinputlisting[language={},xleftmargin=-1.5cm,xrightmargin=-1.5cm]{pst-barcode.pro}
+
\end{document}