summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-07-23 23:05:28 +0000
committerKarl Berry <karl@freefriends.org>2006-07-23 23:05:28 +0000
commitabb699090718cb65cf58d15dffdc8e5508855fe8 (patch)
tree063340f116e2a482f4c1d9b64734f4af11c12c0a /Master/texmf-dist/doc/latex
parent9c513dd7cec89aed0eaf0cdd6ba1cce22ae231d5 (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/Changes52
-rw-r--r--Master/texmf-dist/doc/latex/pst-barcode/barcode.pdfbin216794 -> 228289 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pst-barcode/barcode.tex158
-rw-r--r--Master/texmf-dist/doc/latex/pst-barcode/pst-barcode.tex6
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
index 132333f711c..8f85434f353 100644
--- a/Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf
+++ b/Master/texmf-dist/doc/latex/pst-barcode/barcode.pdf
Binary files differ
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%