diff options
author | Karl Berry <karl@freefriends.org> | 2006-07-23 23:05:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-07-23 23:05:28 +0000 |
commit | abb699090718cb65cf58d15dffdc8e5508855fe8 (patch) | |
tree | 063340f116e2a482f4c1d9b64734f4af11c12c0a /Master/texmf-dist/doc/latex | |
parent | 9c513dd7cec89aed0eaf0cdd6ba1cce22ae231d5 (diff) |
pst-barcode 0.04 (24jul06)
git-svn-id: svn://tug.org/texlive/trunk@1900 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-barcode/Changes | 52 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf | bin | 216794 -> 228289 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-barcode/barcode.tex | 158 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-barcode/pst-barcode.tex | 6 |
4 files changed, 178 insertions, 38 deletions
diff --git a/Master/texmf-dist/doc/latex/pst-barcode/Changes b/Master/texmf-dist/doc/latex/pst-barcode/Changes index be3e3676d26..17ab2457dbf 100644 --- a/Master/texmf-dist/doc/latex/pst-barcode/Changes +++ b/Master/texmf-dist/doc/latex/pst-barcode/Changes @@ -1,7 +1,10 @@ ----- pst-barcode.tex -2005-07-26 Changes to the documentation and the syntax - of psbarcode (hv) -2005-07-26 first version (hv) +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 @@ -9,10 +12,43 @@ ----- pst-barcode.pro -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 +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 @@ -20,5 +56,3 @@ 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 -0.02 2005-08-02 sync to barcode.ps (hv) -0.01 2005-07-26 first version (hv) diff --git a/Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf b/Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf Binary files differindex 132333f711c..8f85434f353 100644 --- a/Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf +++ b/Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf diff --git a/Master/texmf-dist/doc/latex/pst-barcode/barcode.tex b/Master/texmf-dist/doc/latex/pst-barcode/barcode.tex index 70c1b41b9df..fe8f3541c39 100644 --- a/Master/texmf-dist/doc/latex/pst-barcode/barcode.tex +++ b/Master/texmf-dist/doc/latex/pst-barcode/barcode.tex @@ -5,6 +5,8 @@ \usepackage{pst-barcode} \let\PSTfileversion\fileversion \usepackage[ps2pdf,colorlinks,linktocpage]{hyperref} +\usepackage{breakurl} +\def\CMD#1{\texttt{\textbackslash #1}} \title{Package \texttt{pst-barcode}\\ \footnotesize v. \PSTfileversion} @@ -18,11 +20,11 @@ \begin{center} \begin{tabular}{@{}>{\ttfamily}lll@{}} \textrm{\emph{file name}} & \emph{meaning} & \emph{version}\\\hline -pst-barcode.sty & \LaTeX\ style file -- wrapper & 2005-07-24\\ -pst-barcode.tex & \TeX\ file -- PS interface & 2005-07-26\\ -pst-barcode.pro & PostScript file & 2005-10-17\\ -barcode.tex & documentation source & 2005-09-16\\ -barcode.pdf & documentation PDF & 2005-09-16\\ +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 & 2006-07-23\\ +barcode.tex & documentation source & 2006-07-23\\ +barcode.pdf & documentation PDF & 2006-07-23\\ \end{tabular} \end{center} @@ -96,7 +98,7 @@ or the \verb+\makebox+ macro. \subsection{Examples for the TeX options} -\begin{LTXexample}[pos=t] +\begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(3.5,1.2in) \psbarcode{12345678}{includetext}{ean8} \end{pspicture} @@ -111,7 +113,7 @@ or the \verb+\makebox+ macro. \newpage \subsection{Examples for the PostScript options} -\begin{LTXexample}[pos=t] +\begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(3.5,1.2in) \psbarcode{12345678}{includetext guardwhitespace height=0.6}{ean8} \end{pspicture} @@ -126,7 +128,7 @@ or the \verb+\makebox+ macro. \end{pspicture} \end{LTXexample} -\begin{LTXexample}[pos=t] +\begin{LTXexample}[pos=t,preset=\centering] \begin{pspicture}(3.5,1.2in) \psbarcode{12345678}{includetext guardwhitespace}{ean8} \end{pspicture} @@ -136,6 +138,31 @@ or the \verb+\makebox+ macro. \end{LTXexample} +\section{Usage} +By default the barcode has a width and a height of zero. Using the \CMD{parbox} +macro or the \verb+pspicture+ environment can reserve the needed space for +the barcode. The \CMD{fbox} in the following examples is used +only for demonstration. + + +\begin{LTXexample}[width=.5\linewidth] +foo +\fbox{% + \parbox[b][1in]{1.5in}{\psbarcode{241078}{includetext width=1.5 height=1}{code39}}} +bar +\end{LTXexample} + +\bigskip +\begin{LTXexample}[width=.5\linewidth] +foo +\fbox{% +\begin{pspicture}(0,-8pt)(1.5in,1in) + \psbarcode{241078}{includetext width=1.5 height=1}{code39} +\end{pspicture}} +bar +\end{LTXexample} + + \section{Possible barcodes} The following section shows the symbologies that are supported by @@ -261,26 +288,38 @@ try the support mailing list. \end{pspicture} \end{LTXexample} +\newpage \subsection{ISBN} +An ISBN symbol is really an EAN-13 with a particular prefix, 978 for the older ISBN-10 format, and others for the new ISBN-13 format. \begin{description} \item[Characters] \verb+-0123456789+ -\item[Data] 9 or 10 digits seperated appropriately with dashes +\item[Data] 9 or 10 digits for ISBN-10 seperated appropriately with dashes +\item[Data] 12 or 13 digits for ISBN-13 seperated appropriately with dashes \item[Options]~\\ \begin{tabular}{l|l} Option & Feature\\ \hline \texttt{includetext} & Enable human readable text\\ \end{tabular} -\item[Notes] If just 9 digits are entered then the human readable +\item[Notes] If just 9 (ISBN-10) or 12 (ISBN-13) digits are entered then the human readable, ISBN check digit is calculated automatically \end{description} +\smallskip +\begin{LTXexample}[width=.3\linewidth] +\begin{pspicture}(3,1in) +\psbarcode{3-86541-114}{includetext guardwhitespace}{isbn} +\end{pspicture} +\end{LTXexample} + +\bigskip\enlargethispage{2ex} \begin{LTXexample}[width=.3\linewidth] \begin{pspicture}(3,1in) -\psbarcode{1-58880-149}{includetext guardwhitespace}{isbn} +\psbarcode{978-3-86541-114}{includetext guardwhitespace}{isbn} \end{pspicture} \end{LTXexample} + \subsection{Code-39} \begin{description} @@ -350,6 +389,7 @@ for the initial character set. UCC/EAN-128s must have a manditory \end{LTXexample} +\newpage \subsection{Interleaved 2 of 5 and ITF-14} \begin{description} @@ -448,7 +488,7 @@ for the initial character set. UCC/EAN-128s must have a manditory \end{description} \begin{LTXexample}[width=.5\linewidth] -\begin{pspicture}(5,0.5in) +\begin{pspicture}(5,0.3in) \psbarcode{1203AA12}{includetext}{kix} \end{pspicture} \end{LTXexample} @@ -469,28 +509,58 @@ for the initial character set. UCC/EAN-128s must have a manditory \end{description} \begin{LTXexample}[width=.5\linewidth] -\begin{pspicture}(5,0.5in) +\begin{pspicture}(5,0.3in) \psbarcode{1139549554}{includetext}{auspost} \end{pspicture} \end{LTXexample} +\subsection{onecode} +United States Postal Service, replaces POSTNET and PLANET symbols. +Each barcode can be 20, 25, 29, or 31 digits long, depending on the type of ZIP code present. Each digit has four possible states, so one digit represents numbers 0-3. +\begin{description} +\item[Characters] \verb!0123456789! +\item[Data] Variable number digits +\iffalse +\item[Options]~\\ + \begin{tabular}{l|l} + Option & Feature\\ \hline + \texttt{includetext} & Enable human readable text\\ + \end{tabular} +\fi +\end{description} + +\begin{LTXexample}[pos=t,preset=\centering] +\begin{pspicture}(5,0.3in) +\psbarcode{0123456709498765432101234567891}{includetext}{onecode} +\end{pspicture} +\end{LTXexample} \subsection{Symbol} The purpose of the symbol encoder is to store the definitions of miscellaneous barcode symbols such as the FIM symbols used by the US Postal Service on their reply mail. -\begin{LTXexample}[width=.2\linewidth] -\begin{pspicture}(1cm,.5in) -\psbarcode{fima}{includetext}{symbol} + +\begin{LTXexample}[width=.4\linewidth] +\begin{pspicture}(1cm,1.5cm) +\psbarcode{fima}{}{symbol} +\end{pspicture} +\end{LTXexample} + +\begin{LTXexample}[width=.4\linewidth] +\begin{pspicture}(1cm,1.5cm) +\psbarcode{fimb}{}{symbol} \end{pspicture} -\begin{pspicture}(1cm,.5in) -\psbarcode{fimb}{includetext}{symbol} -\end{pspicture}\\ -\begin{pspicture}(1cm,.5in) -\psbarcode{fimc}{includetext}{symbol} +\end{LTXexample} + +\begin{LTXexample}[width=.4\linewidth] +\begin{pspicture}(1cm,1.5cm) +\psbarcode{fimc}{}{symbol} \end{pspicture} -\begin{pspicture}(1cm,.5in) -\psbarcode{fimd}{includetext}{symbol} +\end{LTXexample} + +\begin{LTXexample}[width=.4\linewidth] +\begin{pspicture}(1cm,1.5cm) +\psbarcode{fimd}{}{symbol} \end{pspicture} \end{LTXexample} @@ -498,7 +568,7 @@ symbols such as the FIM symbols used by the US Postal Service on their reply mai \subsection{MSI} \begin{description} -\item[Characters] \verb!01234B6789! +\item[Characters] \verb!0123456789! \item[Data] Variable number digits \item[Options]~\\ \begin{tabular}{l|l} @@ -529,12 +599,48 @@ symbols such as the FIM symbols used by the US Postal Service on their reply mai \item[Notes] Check digits are always added automatically. \end{description} -\begin{LTXexample}[pos=t] -\begin{pspicture}(12,1in) +\begin{LTXexample}[pos=t,preset=\centering] +\begin{pspicture}(0,-2mm)(12,1in) \psbarcode{0123456789ABCDEF}{includetext}{plessey} \end{pspicture} \end{LTXexample} +\subsection{Reduced Space Symbology (RSS)} +This is a family that includes RSS-14\textregistered, RSS Limited\textregistered, +and RSS Expanded\textregistered{} (\url{http://www.gs1.org/productssolutions/barcodes/technical/rss.html}). RSS-14 and RSS Limited encode Global Trade Item +Numbers (GTINs). RSS Expanded will encode any of the GS1 System identification +numbers as well as all other Application Identifiers. +RSS is used in the healthcare industry. + +\begin{description} +\item[Characters] \verb!0123456789! +\item[Data] Variable number digits +\end{description} + +\subsubsection{rss14} + +\begin{LTXexample}[width=.3\linewidth] +\begin{pspicture}(12,.3in) +\psbarcode{24012345678905}{height=0.3}{rss14} +\end{pspicture} +\end{LTXexample} + +\subsubsection{rsslimited} +\begin{LTXexample}[width=.3\linewidth] +\begin{pspicture}(12,.3in) +\psbarcode{00978186074271}{height=0.3}{rsslimited} +\end{pspicture} +\end{LTXexample} + +\subsubsection{rssexpanded} +\begin{LTXexample}[width=.3\linewidth] +\begin{pspicture}(12,.3in) +\psbarcode{000000010011001010100001000000010000}{height=0.3}{rssexpanded} +\end{pspicture} +\end{LTXexample} + + + \section{Code Commentary} This commentary assumes familiarity with the PostScript language\footnote{The PostScript Language Tutorial and Cookbook diff --git a/Master/texmf-dist/doc/latex/pst-barcode/pst-barcode.tex b/Master/texmf-dist/doc/latex/pst-barcode/pst-barcode.tex index 8c4c0e4e81b..98449a8430c 100644 --- a/Master/texmf-dist/doc/latex/pst-barcode/pst-barcode.tex +++ b/Master/texmf-dist/doc/latex/pst-barcode/pst-barcode.tex @@ -19,8 +19,8 @@ \let\PSTBarcodeLoaded\endinput \ifx\PSTricksLoaded\endinput\else\input pstricks.tex\fi % -\def\fileversion{0.03} -\def\filedate{2005/09/17} +\def\fileversion{0.04} +\def\filedate{2006/07/23} \message{`PST-barcode' v\fileversion, \filedate\space (tb,hv)} % \edef\PstAtCode{\the\catcode`\@} \catcode`\@=11\relax @@ -48,7 +48,7 @@ \psk@barcode@scalex\space \psk@barcode@scaley\space \psk@barcode@transx\space \psk@barcode@transy\space translate scale rotate - (#1) (#2) #3\space barcode + 0 0 moveto (#1) (#2) #3\space barcode grestore }% \end@SpecialObj% |