diff options
author | Karl Berry <karl@freefriends.org> | 2008-09-08 00:26:03 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2008-09-08 00:26:03 +0000 |
commit | 883bf95bf548e81277aeb42fc6e26f1926744a3a (patch) | |
tree | 5013850e952659925803841fa0d4df17feb59115 /Master/texmf-dist/doc/generic | |
parent | 312223ebc369a2dc7e17fa003b535082b73a163e (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')
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-barcode/Changes | 75 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.pdf | bin | 240531 -> 256484 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-barcode/pst-barcode-doc.tex | 133 |
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 Binary files differindex 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 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} |