diff options
author | Norbert Preining <preining@logic.at> | 2007-11-18 21:10:43 +0000 |
---|---|---|
committer | Norbert Preining <preining@logic.at> | 2007-11-18 21:10:43 +0000 |
commit | c9311faff61859fb0e83903dabab6f6ab3321ab6 (patch) | |
tree | 4e9b1fd7415ad59d04297fa4b5be3e6fdfc56535 /Master/texmf-dist/tex/latex/pinlabel/pinlabel.sty | |
parent | 336f143603681e9a6a2198f462411a4184b67ed2 (diff) |
new package pinlabel (->collection-pictures)
git-svn-id: svn://tug.org/texlive/trunk@5502 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/pinlabel/pinlabel.sty')
-rw-r--r-- | Master/texmf-dist/tex/latex/pinlabel/pinlabel.sty | 1066 |
1 files changed, 1066 insertions, 0 deletions
diff --git a/Master/texmf-dist/tex/latex/pinlabel/pinlabel.sty b/Master/texmf-dist/tex/latex/pinlabel/pinlabel.sty new file mode 100644 index 00000000000..7ea568bc523 --- /dev/null +++ b/Master/texmf-dist/tex/latex/pinlabel/pinlabel.sty @@ -0,0 +1,1066 @@ +%%%% pinlabel.sty Version 1.1 +%%%% +%%%% Written by Colin Rourke +%%%% +%%%% Based on geompsfi.sty by Silvio Levy +%%%% Based on psfig.sty by Trevor Darrell +%%%% +%%%% Copyright 2006 Mathematical Sciences Publishers (MSP) +%%%% +%%%% NOTICE +%%%% +%%%% This package may be distributed and/or modified under the +%%%% conditions of the LaTeX Project Public License, either version +%%%% 1.3 of this license or (at your option) any later version. +%%%% The latest version of this license is in +%%%% +%%%% http://www.latex-project.org/lppl.txt +%%%% +%%%% and version 1.3 or later is part of all distributions of LaTeX +%%%% version 2005/12/01 or later. +%%%% +%%%% This package has the LPPL maintenance status `maintained' and is +%%%% currently maintained by MSP: contact@mathscipub.org +%%%% +%%%% It comprises two files: pinlabel.sty (this file) and the manual +%%%% pinlabdoc.pdf where full documentation may be found. +%%%% +%%%% +%%%% pinlabel.sty is designed for inserting perfectly formatted TeX +%%%% labels in eps or pdf files for inclusion in documents. +%%%% It uses the coordinates provided by ghostview (or gv) to +%%%% position the label and reads the relevant bounding box +%%%% information from the eps file (which must be provided: if +%%%% your figure exists only as a pdf file, then run pdf2eps). +%%%% Several features are provided which facilitate perfect +%%%% first-time label positioning, of which the most important +%%%% is auto-spacing, which sets the label a predetermined gap +%%%% away from the figure object which is being labelled. The +%%%% gap is \hair (a TeX dimension, preset to 3pt, but settable +%%%% on the fly) and the direction of the spacing is chosen +%%%% automatically. The result is consistent and eye-pleasing +%%%% spacing. +%%%% In use, read the position of the object that you wish to +%%%% label and do not guess the position of the actual label. +%%%% Then choose the orientation of the label (eg [tr] which +%%%% means top-right) and the label will automatically be set +%%%% so that top-right of the label bounding box is set one +%%%% \hair away from the object being labelled. +%%%% +%%%% +%%%% pinlabel.sty was written specifically for the use of editors and +%%%% authors of MSP papers and is the recommended package for +%%%% use for labelling diagrams for MSP. +%%%% +%%%% pinlabel.sty is a revised version of geomsfig.sty with improved +%%%% functionality and simpler syntax. The old syntax remains +%%%% available for backwards compatibility, see below. +%%%% +%%%% new syntax: \pinlabel {label} by x-pin y-pin at x-location y-location +%%%% and \pinlabel* {label} by x-pin y-pin at x-location y-location +%%%% +%%%% where "x-pin y-pin" is the point in intrinsic coords in label +%%%% space where we are placing the pin and "x-location y-location" +%%%% is the point in diagram space (in PS points as read in gv) where +%%%% the label is pinned. \pinlabel uses \hair autospacing \pinlabel* +%%%% does not. See the manual for full details. +%%%% \mathsurround is set to 0pt for parsing the label +%%%% +%%%% options: "by x-pin y-pin" may be omitted the default is 0 0 +%%%% orientation commands [r], [l] etc may replace "by x-pin y-pin" +%%%% [r] is right-centre (same as "by 0 1") etc +%%%% a manual adjustment "<x-adj, y-adj>" may be added before "at" +%%%% or directly after the label +%%%% +%%%% Examples \pinlabel $a^b$ [l] <-2pt,1pt> at 231 47 +%%%% Same as \pinlabel $a^b$ by -1 0 <-2pt,1pt> at 231 47 +%%%% Same as \pinlabel $a^b$ <-2pt,1pt> [l] at 231 47 +%%%% Same as \pinlabel $a^b$ <-2pt,1pt> by -1 0 at 231 47 +%%%% +%%%% which pins "$a^b$" by centre-left at 231 47 with two +%%%% adjustments: \hair (autospacing) and then (-2pt,1pt) manual +%%%% +%%%% \pinlabel* {A nice figure} [Bl] <-5pt,0pt> at 231 47 +%%%% +%%%% which pins "A nice figure" by baseline-left at 231 47 +%%%% with one adjustment: (-5pt,0pt) +%%%% +%%%% Full list of orientation commands: r=right, l=left, t=top, b=bottom +%%%% and B=baseline, default is centre and any sensible combination +%%%% of two commands may be give (in either order) eg +%%%% [tl]=[lt]=top-left of label bounding box +%%%% +%%%% NB the commands are syntax sensitive and use spaces as separators so +%%%% they DON'T work with \obeyspaces set. Braces must be placed +%%%% around labels containing spaces but may be omitted if there are +%%%% no spaces in the label code (see the examples above and below). +%%%% +%%%% Label instructions go either in the file inside \labellist +%%%% ... \endlabellist or in a separate .lab file (ie if fig +%%%% is fig4-1.eps or .ps, then labels go in \figdir/fig4-1.lab +%%%% where \figdir/ is the directory containing fig4-1.eps). +%%%% The \labellist overrides a .lab file. +%%%% \labellist ... \endlabellist can be given at any time before +%%%% the next figure, but typically will be included in the figure +%%%% code, as in the following example. +%%%% +%%%% Here is a complete example of a relabelled figure: +%%%% +%%%% \begin{figure}[ht!] +%%%% \labellist\small\hair 2.5pt +%%%% \pinlabel {$\partial _1 X$} by 1 0 at 156 426 +%%%% \pinlabel {$\partial _2 X$} by -1 1 at 334 429 +%%%% \pinlabel $X_1$ at 431 513 +%%%% \pinlabel $X_2$ at 428 460 +%%%% \pinlabel $H_X$ [lb] at 311 622 +%%%% \pinlabel* $H_X'$ [tr] <-1.5pt,-2pt> at 178 370 +%%%% \endlabellist +%%%% \centerline{\psfig{file=\figdir/decomp,width=3in}} +%%%% \caption{Labelling the boundary components of $X$} +%%%% \label{Fig:decomp} +%%%% \end{figure} +%%%% +%%%% The actual figure can be included by using either psfig or +%%%% graphicx. psfig is used by the code, but graphicx +%%%% commands are translated automatically, so in the above +%%%% example the alternative code: +%%%% +%%%% \centerline{\includegraphics[width=3in]{\figdir/decomp}} +%%%% +%%%% would produce identical results. Automatic translation ONLY +%%%% takes place is a labellist is present, so if you use a .lab +%%%% file then you MUST use the psfig syntax. +%%%% +%%%% +%%%% VERY IMPORTANT +%%%% ============== +%%%% +%%%% The file extension MUST NOT be given. The program will find +%%%% the correct file (\figdir/decomp.eps or .ps or .pdf). +%%%% +%%%% READ THE BUGS below before using \includegraphics with pinlabel. +%%%% +%%%% +%%%% old syntax: \setlabel is unchanged (but \mathsurround is set to 0pt) +%%%% \setlabel* is a new variant which sets \hair to 0pt (no +%%%% autospacing) and an optional manual adjustment may be added +%%%% eg: +%%%% +%%%% \setlabel<-2pt,-1pt>{a^b}{321}{33}{1}{1} +%%%% \setlabel*<-2pt,-1pt>{a^b}{321}{33}{1}{1} +%%%% \setlabel{a^b}{321}{33}{1}{1} +%%%% \setlabel*{a^b}{321}{33}{1}{1} +%%%% +%%%% the first uses autospacing and adds a (-2pt,-1pt) manual +%%%% adjustment; the second uses just the manual adjustment, +%%%% the third just autospacing and the fourth nothing. +%%%% +%%%% old and new syntax may be mixed in a label list and given +%%%% either in a .lab file or inside \labellist ... \endlabellist +%%%% +%%%% ***Users of geomsfig note the change to \mathsurround. If you +%%%% do not use it, there will be no change in label positioning. +%%%% If you do, labels may move a small amount horizontally.*** +%%%% +%%%% +%%%% !!!NBNB label is in horizontal mode in new syntax and math mode in old!!! +%%%% +%%%% +%%%% BUGS: NO spaces are permitted in the file argument of \psfig +%%%% Autotranslation of \includegraphics[]{} means that no +%%%% spaces are permitted in the file argument to \includegraphics +%%%% Eg \includegraphics[width=4in]{ foo } will produce errors, +%%%% use \includegraphics[width=4in]{foo}. Spaces are permitted +%%%% with other arguments. +%%%% +%%%% Many of the options in graphicx are not supported. The +%%%% supported ones are: width, height, scale, bbllx, bblly +%%%% bburx, bbury and clip. The syntax for clip is "clip=". +%%%% Replace "keepaspectratio=true" by "proportional=". +%%%% +%%%% The command \reallyincludegraphics will force the use of +%%%% graphicx (ie cancel autotranslation). Since code will use +%%%% graphicx automatically if there is no labellist present, +%%%% \reallyincludegraphics will only be needed if a labellist +%%%% has already been given for a later figure. +%%%% +%%%% \graphicspath{} is not supported. Use \figdir instead. +%%%% +%%%% +%%%% Automatic configuration for dvips and pdflatex is included +%%%% in this file. No support is provided for other drivers. +%%%% +%%%% NB \psfig ouputs a vbox, which is not centred in latex' {center} +%%%% environment. Either use \centerline{} or type \leavevmode +%%%% before \psfig{..}. The translator adds \leavevmode for +%%%% \includegraphics, which therefore centres correctly as usual +%%%% in the {center} environment. +%%%% +%%%% PLAIN TeX compatibility: uses miniltx.tex and works with dvips +%%%% but NOT with pdftex. For pdf output from plain TeX use dvips +%%%% followed by ps2pdf. +%%%% +%%%% + +\edef\atcatcode{\the\catcode`\@} \catcode`@=11 +\def\@message#1{\immediate\write16{#1}} + +\newif\ifoldlabels \oldlabelsfalse +\expandafter\ifx\csname @ifundefined\endcsname\relax +\long\def\@ifundefined#1#2#3{\expandafter\ifx\csname + #1\endcsname\relax#2\else#3\fi} + +\def\@iden#1{#1} +%\newdimen\@tempdima +\alloc@1\dimen\dimendef\insc@unt\@tempdima +\def\@warning#1{\@message{Warning: #1.}} +\fi + +%%% if not latex \input miniltx (for plain tex compatibility) +\@ifundefined{RequirePackage}{\input miniltx}{\relax} + +%%% make sure graphicx is loaded +\RequirePackage{graphicx} +\let\@includegraphics@\includegraphics %%% for auto translation of graphicx +\let\reallyincludegraphics\@includegraphics@ %%% to override translation + +\@ifundefined{ps@init}{}{\endinput} + +\@ifundefined{hyperactivelabels}{\let\hyperactivelabels\relax}{} + +%%% in-line label list handling %%% +\long\def\labellist#1\endlabellist{\gdef\thelabellist{#1}} +\let\thelabellist\relax %%%% initialise + +\newif\if@topspecials %false for Rokicki's dvips: \special is at bottom of box + % true for dvitps, dvi2ps + +\newif\ifdvi\dvitrue +\@ifundefined{pdfoutput}{}{\ifnum\pdfoutput>0 \dvifalse\fi} +\ifdvi +%%% start of driver.chg +{\catcode`\p=12 \catcode`\t=12 \gdef\read@PT#1pt{#1}} +\def\sp@topt#1#2{\psfig@dimen=#2sp \if\psfig@dimen=0pt \psfig@dimen=1sp\fi + \edef#1{\expandafter\read@PT \the\psfig@dimen}} +\def\sp@tobp#1#2{\psfig@dimen=#2sp \if\psfig@dimen=0pt \psfig@dimen=1sp\fi + \expandafter\@tempdima\expandafter\read@PT \the\psfig@dimen bp + \advance\psfig@dimen-.5 \@tempdima \multiply\psfig@dimen 2 + \edef#1{\expandafter\read@PT \the\psfig@dimen}} +\def\ps@init{} +\def\ps@begin{\sp@tobp\@tempa\@p@sbbllx \sp@tobp\@tempb\@p@sbblly + \sp@tobp\@tempc\@p@sbburx \sp@tobp\@tempd\@p@sbbury + \sp@tobp\@tempe{\@p@swidth0} \sp@tobp\@tempf{\@p@sheight0} + \special{PSfile=\@p@sfile\space llx=\@tempa\space lly=\@tempb\space + urx=\@tempc\space ury=\@tempd\space rwi=\@tempe\space rhi=\@tempf}} +% rwi is the total width, in tenths of the units used for the +% other dimensions (this is dvips's brain damage) +\def\ps@prolog{} +\def\ps@clip{} % +\def\ps@include{} % +\def\ps@postlog{} % +\def\ps@end{} % +%%% end of driver.chg +\else +\@ifundefined{usepackage}{\@message{} +\@message {!!! pinlabel.sty cannot be used for direct pdf output except with latex !!!} +\@message {For pdf outlut from plain tex use dvips and ps2pdf} +\@message{}}{} +%%% start of gpdftex.chg +{\catcode`\p=12 \catcode`\t=12 \gdef\read@PT#1pt{#1}} +\def\sp@topt#1#2{\psfig@dimen=#2sp \if\psfig@dimen=0pt \psfig@dimen=1sp\fi + \edef#1{\expandafter\read@PT \the\psfig@dimen}} +\def\sp@tobp#1#2{\psfig@dimen=#2sp \if\psfig@dimen=0pt \psfig@dimen=1sp\fi + \expandafter\@tempdima\expandafter\read@PT \the\psfig@dimen bp + \advance\psfig@dimen-.5 \@tempdima \multiply\psfig@dimen 2 + \edef#1{\expandafter\read@PT \the\psfig@dimen}} +\def\ps@init{} +\def\ps@begin{\sp@tobp\@tempa\@p@sbbllx \sp@tobp\@tempb\@p@sbblly + \sp@tobp\@tempc\@p@sbburx \sp@tobp\@tempd\@p@sbbury + \sp@tobp\@tempe\@p@swidth \sp@tobp\@tempf\@p@sheight% +\edef\foobar{[width=\@p@swidth sp,height=\@p@sheight sp]{\@p@dffile}}% +%,viewport=\@tempa\space\@tempb\space\@tempc\space\@tempd +\@message{\string\@includegraphics@\foobar}% +\rlap{\smash{\expandafter\@includegraphics@\foobar}}% +} +% rwi is the total width, in tenths of the units used for the +% other dimensions (this is dvips's brain damage) +\def\ps@prolog{} +\def\ps@clip{} % +\def\ps@include{} % +\def\ps@postlog{} % +\def\ps@end{} % +%%%% end of gpdftex.chg +\fi + +%%%% graphicx translation +%%%% first set a flag to detect use of graphicx and initialise +%%%% the default is \relax (graphicx not used) any other value +%%%% means graphicx is used +\let\inc@graph@flag\relax + +%%%% redefine \includegraphics to mimic \psfig ONLY IF a labellist is present +\def\includegraphics{\ifx\thelabellist\relax\let\next\@includegraphicsnolist@% +\else\let\next\@includegraphics@list@\fi\next} + +\let\@includegraphicsnolist@\reallyincludegraphics + +\def\@includegraphics@list@{\def\inc@graph@flag{1}% +\@ifnextchar[{\includegraphicswithoptions}{\includegraphicsplain}} +\def\includegraphicswithoptions[#1]#2{\leavevmode\psfig{file=#2,#1}} +\def\includegraphicsplain#1{\leavevmode\psfig{file=#1}} + + +\newcount\psfc@a +\newcount\psfc@b +\newcount\psfc@c +\newcount\psfc@d +\newcount\psfc@e +\newcount\psfc@f +\newcount\psfc@g +\newcount\psfc@h +\newcount\psfc@i +\newcount\psfc@j +\newcount\psscale@count +\newtoks\psfigtoks@ +% A dimension register for temporarily storing a dimension in +% \@pDimenToSpNumber. +\newdimen\psfig@dimen +% +%\newwrite\@unused +%\def\typeout#1{{\let\protect\string\immediate\write\@unused{#1}}} + +% Identifying message is here. +% \typeout{psfig/tex 1.4.gcg / TeXPS}\fi +% +% @psdo control structure -- similar to Latex @for. +% I redefined these with different names so that psfig can +% be used with TeX as well as LaTeX, and so that it will not +% be vunerable to future changes in LaTeX's internal +% control structure. +\def\@nnil{\@nil} +\def\@empty{} +\def\@psdonoop#1\@@#2#3{} +\def\@psdo#1:=#2\do#3{\edef\@psdotmp{#2}\ifx\@psdotmp\@empty \else + \expandafter\@psdoloop#2,\@nil,\@nil\@@#1{#3}\fi} +\def\@psdoloop#1,#2,#3\@@#4#5{\def#4{#1}\ifx #4\@nnil \else + #5\def#4{#2}\ifx #4\@nnil \else#5\@ipsdoloop #3\@@#4{#5}\fi\fi} +\def\@ipsdoloop#1,#2\@@#3#4{\def#3{#1}\ifx #3\@nnil + \let\@nextwhile=\@psdonoop \else + #4\relax\let\@nextwhile=\@ipsdoloop\fi\@nextwhile#2\@@#3{#4}} +\def\@tpsdo#1:=#2\do#3{\xdef\@psdotmp{#2}\ifx\@psdotmp\@empty \else + \@tpsdoloop#2\@nil\@nil\@@#1{#3}\fi} +\def\@tpsdoloop#1#2\@@#3#4{\def#3{#1}\ifx #3\@nnil + \let\@nextwhile=\@psdonoop \else + #4\relax\let\@nextwhile=\@tpsdoloop\fi\@nextwhile#2\@@#3{#4}} +% +\def\psdraft{% + \def\@psdraft{0} + %\typeout{draft level now is \@psdraft \space.} +} +\def\psfull{% + \def\@psdraft{100} + %\typeout{draft level now is \@psdraft \space.} +} +\psfull +\newif\if@prologfile +\newif\if@postlogfile +\newif\if@noisy +\def\pssilent{% + \@noisyfalse +} +\def\psnoisy{% + \@noisytrue +} +%\psnoisy +\pssilent +% These are for the option list: +% a specification of the form a = b maps to calling \@p@@sa{b}. +\newif\if@bbllx +\newif\if@bblly +\newif\if@bburx +\newif\if@bbury +\newif\if@height +\newif\if@width +\newif\if@rheight +\newif\if@rwidth +\newif\if@clip +\newif\if@proportional +\newif\if@scale +\newif\if@verbose +\def\@p@@sclip#1{\@cliptrue} +\def\@p@@sproportional#1{\@proportionaltrue} +\def\@p@@sfile#1{% + %\typeout{file is #1} + \def\@filestem{#1}% + \def\@p@dffile{#1.pdf}% + \def\@labfile{#1.lab}% +} +\let\@p@@sfigure\@p@@sfile +% \@pDimenToSpNumber +% ================== +% Convert a dimension into scaled points. +% #1: the name of macro which will expand to the dimension in +% scaled points, without the unit 'sp' though, i.e. as a pure +% integer. +% #2: the dimension (not a dimension register, use +% \the if dimension is stored in a dimension register). +\def\@pDimenToSpNumber #1#2{% + \psfig@dimen = #2\relax + \edef#1{\number\psfig@dimen}% +} +\def\@p@@sbbllx#1{% + %\typeout{bbllx is #1} + \@bbllxtrue + \@pDimenToSpNumber{\@p@sbbllx}{#1}% +} +\def\@p@@sbblly#1{% + %\typeout{bblly is #1} + \@bbllytrue + \@pDimenToSpNumber{\@p@sbblly}{#1}% +} +\def\@p@@sbburx#1{% + %\typeout{bburx is #1} + \@bburxtrue + \@pDimenToSpNumber{\@p@sbburx}{#1}% +} +\def\@p@@sbbury#1{% + %\typeout{bbury is #1} + \@bburytrue + \@pDimenToSpNumber{\@p@sbbury}{#1}% +} +\def\@p@@sheight#1{% + \@heighttrue + \@pDimenToSpNumber{\@p@sheight}{#1}% + %\typeout{Height is \@p@sheight} +} +\def\@p@@swidth#1{% + %\typeout{Width is #1} + \@widthtrue + \@pDimenToSpNumber{\@p@swidth}{#1}% +} +\def\@p@@srheight#1{% + %\typeout{Reserved height is #1} + \@rheighttrue + \@pDimenToSpNumber{\@p@srheight}{#1}% +} +\def\@p@@srwidth#1{% + %\typeout{Reserved width is #1} + \@rwidthtrue + \@pDimenToSpNumber{\@p@srwidth}{#1}% +} +\def\@p@@ssilent#1{% + \@verbosefalse +} +\def\@p@@sscale #1{% + \def\@p@scale{#1}% + \@scaletrue +} + +\def\@p@@sprolog#1{\@prologfiletrue\def\@prologfileval{#1}} +\def\@p@@spostlog#1{\@postlogfiletrue\def\@postlogfileval{#1}} +\def\@cs@name#1{\csname #1\endcsname} +\def\@setparms#1=#2,{\def\@tempa{#2}\ifx\@tempa\@empty + \@warning{bad syntax (missing = or extra comma) in argument of \string\psfig}% + \else\@@setparms#1=#2,\fi} +\def\@@setparms#1=#2=,{\@cs@name{@p@@s#1}{#2}} +% +% Initialize the defaults. +% +\def\ps@init@parms{% + \@bbllxfalse \@bbllyfalse + \@bburxfalse \@bburyfalse + \@heightfalse \@widthfalse + \@rheightfalse \@rwidthfalse + \@scalefalse + \def\@p@sbbllx{}\def\@p@sbblly{}% + \def\@p@sbburx{}\def\@p@sbbury{}% + \def\@p@sheight{}\def\@p@swidth{}% + \def\@p@srheight{}\def\@p@srwidth{}% + \def\@p@sfile{}% + \def\@labfile{}% + \def\@p@scost{10}% + \def\@sc{}% + \@prologfiletrue + \@postlogfilefalse + \@clipfalse + \@proportionalfalse + \if@noisy + \@verbosetrue + \else + \@verbosefalse + \fi +} + +%%%% space bug fixes +\expandafter\let\csname @p@@s scale \endcsname\@p@@sscale +\expandafter\let\csname @p@@sscale \endcsname\@p@@sscale +\expandafter\let\csname @p@@s scale\endcsname\@p@@sscale + +\expandafter\let\csname @p@@s file \endcsname\@p@@sfile +\expandafter\let\csname @p@@sfile \endcsname\@p@@sfile +\expandafter\let\csname @p@@s file\endcsname\@p@@sfile + +\expandafter\let\csname @p@@s width \endcsname\@p@@swidth +\expandafter\let\csname @p@@swidth \endcsname\@p@@swidth +\expandafter\let\csname @p@@s width\endcsname\@p@@swidth + +\expandafter\let\csname @p@@s rwidth \endcsname\@p@@srwidth +\expandafter\let\csname @p@@srwidth \endcsname\@p@@srwidth +\expandafter\let\csname @p@@s rwidth\endcsname\@p@@srwidth + +\expandafter\let\csname @p@@s height \endcsname\@p@@sheight +\expandafter\let\csname @p@@sheight \endcsname\@p@@sheight +\expandafter\let\csname @p@@s height\endcsname\@p@@sheight + +\expandafter\let\csname @p@@s rheight \endcsname\@p@@srheight +\expandafter\let\csname @p@@srheight \endcsname\@p@@srheight +\expandafter\let\csname @p@@s rheight\endcsname\@p@@srheight + +\expandafter\let\csname @p@@s bbllx \endcsname\@p@@sbbllx +\expandafter\let\csname @p@@sbbllx \endcsname\@p@@sbbllx +\expandafter\let\csname @p@@s bbllx\endcsname\@p@@sbbllx + +\expandafter\let\csname @p@@s bblly \endcsname\@p@@sbblly +\expandafter\let\csname @p@@sbblly \endcsname\@p@@sbblly +\expandafter\let\csname @p@@s bblly\endcsname\@p@@sbblly + +\expandafter\let\csname @p@@s bburx \endcsname\@p@@sbburx +\expandafter\let\csname @p@@sbburx \endcsname\@p@@sbburx +\expandafter\let\csname @p@@s bburx\endcsname\@p@@sbburx + +\expandafter\let\csname @p@@s clip \endcsname\@p@@sclip +\expandafter\let\csname @p@@sclip \endcsname\@p@@sclip +\expandafter\let\csname @p@@s clip\endcsname\@p@@sclip + +\expandafter\let\csname @p@@s proportional \endcsname\@p@@sproportional +\expandafter\let\csname @p@@sproportional \endcsname\@p@@sproportional +\expandafter\let\csname @p@@s proportional\endcsname\@p@@sproportional + +% +% Go through the options setting things up. +% +\def\parse@ps@parms#1{% + \@psdo\@psfiga:=#1\do + {\expandafter\@setparms\@psfiga=,}% +} + +\newif\ifno@file +\newif\ifno@bb +\newif\ifnot@eof +\newif\if@bbmatch +\newread\ps@stream +\newread\lab@stream +\newcount\@linecount +\newcount\maxheaderlines +\maxheaderlines=100 + +% +% Scan header of file, looking for ``BoundingBox'' line +% +\def\scan@header{% + \openin\lab@stream=\@labfile + \openin\ps@stream=\@filestem.ps + \ifeof\ps@stream + \relax\closein\ps@stream + \openin\ps@stream=\@filestem.eps + \ifeof\ps@stream + \relax %needed here so the \@warning won't cause trouble + \@warning{cannot open \@filestem.ps or .eps} + \no@filetrue + \else + \relax + \edef\@p@sfile{\@filestem.eps} + \fi + \else + \relax + \edef\@p@sfile{\@filestem.ps} + \fi + \ifno@file\else + \not@eoftrue + \ifno@bb \@bbmatchfalse \else \@bbmatchtrue \fi + \catcode`\%=12 + \catcode`\:=12 % in case punctuation is active (e.g., under french.sty) + \@linecount=\maxheaderlines + \loop + \read\ps@stream to \line@in + \global\psfigtoks@=\expandafter{\line@in} + \ifeof\ps@stream \not@eoffalse \fi + %\typeout{ looking at :: \the\psfigtoks@ } + \if@bbmatch \else \@bbtest{\psfigtoks@} \fi + \if@bbmatch \not@eoffalse \fi + \advance\@linecount-1 + \ifnum\@linecount=0 \not@eoffalse \fi + \ifnot@eof \repeat + \fi + \catcode`\%=14 +} + +% '% ' becomes a regular character for a very short time. +{ + \catcode`\%=12 + \catcode`\:=12 + \gdef\@bbtest#1{\expandafter\@bb@\the#1%%BoundingBox:\@bbtest\@bb@} + \global\long\def\@bb@#1%%BoundingBox:#2#3\@bb@{\ifx\@bbtest#2 + \else\@bbmatchtrue\expandafter\bb@cull\the\psfigtoks@\fi} +} + +\def\bb@cull#1:{\expandafter\bb@@cull\@iden} +\long\def\bb@@cull#1 #2 #3 #4 {% + \@pDimenToSpNumber{\@p@sbbllx}{#1bp}% + \@pDimenToSpNumber{\@p@sbblly}{#2bp}% + \@pDimenToSpNumber{\@p@sbburx}{#3bp}% + \@pDimenToSpNumber{\@p@sbbury}{#4bp}% + \no@bbfalse +} + +% Compute \@bbw and \@bbh, the width and height of the +% bounding box. +\def\compute@bb{% + \no@bbfalse + \if@bbllx \else \no@bbtrue \fi + \if@bblly \else \no@bbtrue \fi + \if@bburx \else \no@bbtrue \fi + \if@bbury \else \no@bbtrue \fi + \scan@header + \ifno@file + \else + \ifno@bb + \@warning{no bounding box found in \@p@sfile} + \no@filetrue + \else + % Now compute the size of the bounding box. + \psfc@c=\@p@sbburx + \psfc@b=\@p@sbbury + \advance\psfc@c by -\@p@sbbllx + \advance\psfc@b by -\@p@sbblly + \edef\@bbw{\number\psfc@c} + \edef\@bbh{\number\psfc@b} + %\typeout{\string\compute@bb: bbh = \@bbh, bbw = \@bbw} + \fi + \fi +} + +% +% \in@hundreds performs #1 * (#2 / #3) correct to the hundreds, +% then leaves the result in \@result. +% +% note: #3 should be a big number, or a multiple of 10. +% +\def\in@hundreds #1#2#3{% + \psfc@g=#2 + \psfc@d=#3 + \divide\psfc@d 10 + \psfc@a=\psfc@g % First two digits #2/#3. + \divide\psfc@a by \psfc@d + \psfc@f=\psfc@a + \multiply\psfc@f by \psfc@d + \advance\psfc@g by -\psfc@f + \multiply\psfc@g by 10 + \psfc@f=\psfc@g % Third digit of #2/#3. + \divide\psfc@f by \psfc@d + \psfc@j=\psfc@f + \multiply\psfc@j by \psfc@d + \advance\psfc@g by -\psfc@j + \multiply\psfc@g by 10 + \psfc@j=\psfc@g % Third digit. + \divide\psfc@j by \psfc@d + \psfc@h=#1\psfc@i=0 + \psfc@e=\psfc@h + \multiply\psfc@e by \psfc@a + \advance\psfc@i by \psfc@e + \psfc@e=\psfc@h + \divide\psfc@e by 10 + \multiply\psfc@e by \psfc@f + \advance\psfc@i by \psfc@e + % + \psfc@e=\psfc@h + \divide\psfc@e by 100 + \multiply\psfc@e by \psfc@j + \advance\psfc@i by \psfc@e + \divide\psfc@i 10 + % + \edef\@result{\number\psfc@i} +} +% Scale a value #1 by the current scaling factor and reassign the new +% scaled value. +\def\@ScaleInHundreds #1{% + \in@hundreds{#1}{\@p@scale}{100}% + \edef#1{\@result}% +} +% +% +% Compute width from height. +\def\compute@wfromh{% + % computing : width = height * (bbw / bbh) + \in@hundreds{\@p@sheight}{\@bbw}{\@bbh}% + %\typeout{ \@p@sheight * \@bbw / \@bbh, = \@result } + \edef\@p@swidth{\@result}% + %\typeout{w from h: width is \@p@swidth}% +} +% +% Compute height from width. +% +\def\compute@hfromw{% + % computing : height = width * (bbh / bbw) + \in@hundreds{\@p@swidth}{\@bbh}{\@bbw}% + %\typeout{ \@p@swidth * \@bbh / \@bbw = \@result } + \edef\@p@sheight{\@result}% + %\typeout{h from w : height is \@p@sheight}% +} +% +% Compute height and width when both are given and proportionality +% must be preserved. +% +\def\compute@minhw{% + \in@hundreds{\@p@swidth}{\@bbh}{\@bbw}% + \ifnum\@p@sheight<\@result + \in@hundreds{\@p@sheight}{\@bbw}{\@bbh}% + \edef\@p@swidth{\@result}% + \else + \edef\@p@sheight{\@result}% + \fi +} +% +% Compute height and width, i.e. \@p@sheight and \@p@swidth. +% +\def\compute@handw{% + % If height is given. + \if@height + % If width is given + \if@width + \if@proportional + \compute@minhw + \fi + \else + % Height, no width: compute width. + \compute@wfromh + \fi + \else + % No height. + \if@width + % Width is given, no height though: compute it. + \compute@hfromw + \else + % Neither width no height is give. + \edef\@p@sheight{\@bbh} + \edef\@p@swidth{\@bbw} + \fi + \fi +} +% Compute the amount of space to reserve. Unless defined +% using rheight and rwidth when \psfig is called, these values +% default to \@p@sheight and \@p@swidth. +\def\compute@resv{% + \if@rheight \else \edef\@p@srheight{\@p@sheight} \fi + \if@rwidth \else \edef\@p@srwidth{\@p@swidth} \fi +} +% +% +% \psfig +% ====== +% usage: \psfig{file=, height=, width=, bbllx=, bblly=, bburx=, bbury=, +% rheight=, rwidth=, clip=, scale=, proportional=} +% +% "clip=" and "proportional=" are switches and take no value, +% but the `=' must be present. +% +\def\partest{\par} +\def\psfig#1{% + \vbox {% + \offinterlineskip + \ps@init@parms + \parse@ps@parms{#1}% + % Compute any missing sizes. + \compute@bb + \ifno@file\vbox{\hbox{\footnotesize{\tt\@filestem.\{ps,eps\}} + not found (or no BBox)}}% + \else + \compute@handw + \compute@resv + \if@scale + \ifx\inc@graph@flag\relax\else %% \graphicx syntax used so + \psfig@dimen=100sp %% multiply scale by 100 + \psfig@dimen=\@p@scale\psfig@dimen + \def\@p@scale{\number\psfig@dimen} + \let\inc@graph@flag\relax %% reset + \fi + %\if@verbose \typeout{psfig: scaling by \@p@scale}\fi + %\if@verbose \typeout{psfig: scaling by \@p@scale}\fi + % We now scale the width and height as reported to the PS printer. + \@ScaleInHundreds{\@p@swidth}% + \@ScaleInHundreds{\@p@sheight}% + \@ScaleInHundreds{\@p@srwidth}% + \@ScaleInHundreds{\@p@srheight}% + \fi + % + \ifnum\@p@scost<\@psdraft + %\if@verbose \typeout{psfig: including \@p@sfile \space}\fi + \if@topspecials\do@specials\fi + % Create a vbox to reserve the proper amount of space for the figure. + \vbox to \@p@srheight sp{% + \hbox to \@p@srwidth sp{}% + \vss + }% + \if@topspecials\else\do@specials\fi + \ifx\thelabellist\relax %%% no labellist so look for .lab file + \ifeof\lab@stream + \else{% + \hyperactivelabels + \not@eoftrue + \loop + \read\lab@stream to \line@in \ifx\line@in\partest\else\line@in\fi + \ifeof\lab@stream \not@eoffalse \fi + \ifnot@eof \repeat + }\fi + \else + \hyperactivelabels\thelabellist %%% use labellist and + \global\let\thelabellist\relax %%% reset for next figure + \ifeof\lab@stream + \else{ + \@message{} + \@message{I have found both a labellist AND a .lab file for \@p@sfile.} + \@message{I am using the labellist.} + \@message{If this is not what you want, then edit out the labellist.} + \@message{} + }\fi + \fi + \else + % Draft mode: reserve the space for the figure and print the path name. + \vbox to \@p@srheight sp{% + \hbox to \@p@srwidth sp{% + \if@verbose + \@p@sfile + \fi + }% + \vss + }% + \fi + \fi + }% +} + +\def\do@specials{\ps@init\ps@begin + \if@clip + %\if@verbose \typeout{(clip)} \fi + \ps@clip \fi + \if@prologfile \ps@prolog \fi \ps@include \if@postlogfile \ps@postlog \fi + \ps@end} + +\newbox\label@box +\newdimen\x@lab \newdimen\y@lab +\newdimen\x@aux \newdimen\y@aux +\newdimen\hair\hair=3pt + +%%%%% version without math mode, with \mathsurround set to 0pt +%%%%% and final manual adjustment <#6,#7> +\def\@setlabel@#1#2#3#4#5#6#7{% + \setbox\label@box\hbox{\mathsurround 0pt\ignorespaces#1}% + \x@lab.5\wd\label@box \x@lab#4\x@lab + \y@lab.5\ht\label@box\advance\y@lab.5\dp\label@box \y@lab#5\y@lab +% rotate lab clockwise by 22.5 degrees to get aux + \x@aux.92388\x@lab \advance\x@aux.38268\y@lab + \y@aux-.38268\x@lab \advance\y@aux.92388\y@lab +% choose + \ifdim\x@aux>0pt + \ifdim\y@aux>0pt + \ifdim\x@aux>\y@aux\advance\x@lab.7071\hair\advance\y@lab.7071\hair + \else\advance\y@lab\hair\fi + \else + \ifdim\x@aux>-\y@aux\advance\x@lab\hair + \else\advance\x@lab.7071\hair\advance\y@lab-.7071\hair\fi + \fi + \else + \ifdim\y@aux>0pt + \ifdim\x@aux>-\y@aux\advance\x@lab-.7071\hair\advance\y@lab.7071\hair + \else\advance\x@lab-\hair\fi + \else + \ifdim\x@aux>\y@aux\advance\y@lab-\hair + \else + \ifdim\x@aux<0pt + \advance\x@lab-.7071\hair\advance\y@lab-.7071\hair\fi + \fi + \fi + \fi + \advance\x@lab.5\wd\label@box + \advance\y@lab.5\ht\label@box\advance\y@lab.5\dp\label@box + \x@aux=#2bp \ifoldlabels \else \advance\x@aux by -\@p@sbbllx sp \fi + \y@aux=#3bp \ifoldlabels \else \advance\y@aux by -\@p@sbblly sp \fi + \in@hundreds{\x@aux}{\@p@swidth}{\@bbw} + \edef\@xpos{\@result} + \in@hundreds{\y@aux}{\@p@sheight}{\@bbh} + \edef\@ypos{\@result} + \vbox to 0pt{% + \vss\hbox to\@p@srwidth sp{\hskip \@xpos sp \hskip-\x@lab \hskip #6 + \box\label@box\hss}\vskip \@ypos sp \vskip-\y@lab \vskip #7}} + + +%%%% old syntax: \setlabel and variant \setlabel* (\hair set 0pt) +%%%% both start in math mode for back-compatibility: +\def\setlabel{\@ifnextchar*{\setlabel@nohair}{\setlabel@hair}} + +%%%% manual adjustment added? +\def\setlabel@nohair*% +{\@ifnextchar<{\setlabel@nohair@adj}{\setlabel@nohair@noadj}} +\def\setlabel@hair% +{\@ifnextchar<{\setlabel@hair@adj}{\setlabel@hair@noadj}} + +\def\setlabel@nohair@noadj#1#2#3#4#5% +{{\hair 0pt\@setlabel@{$#1$}{#2}{#3}{#4}{#5}{0pt}{0pt}}} +\def\setlabel@nohair@adj<#1,#2>#3#4#5#6#7% +{{\hair 0pt\@setlabel@{$#3$}{#4}{#5}{#6}{#7}{#1}{#2}}} + +\def\setlabel@hair@noadj#1#2#3#4#5% +{\@setlabel@{$#1$}{#2}{#3}{#4}{#5}{0pt}{0pt}} +\def\setlabel@hair@adj<#1,#2>#3#4#5#6#7% +{\@setlabel@{$#3$}{#4}{#5}{#6}{#7}{#1}{#2}} + + +%%% \pinlabel macro starts here + +%%% set up two flags for killing autospacing and using baseline +%%% and initialise: +%%% \relax is default ie \hair used but baseline not used +%%% any other value means \hair not used but baseline used +\let\hair@flag\relax\let\baseline@flag\relax + +%%% define four control sequences to carry the auxiliary information +%%% and set to default values +\def\@labxpos@{0}\def\@labypos@{0}% +\def\@xadj@{0pt}\def\@yadj@{0pt} + +%%%% endgame +\def\finally@pinlabel #1 {\@ifnextchar a% +{\finally@pinlabel@ {#1} }{\@message{}% +\@message{There is something wrong with your syntax for label #1;} +\@message{you must finish with " at XXX YYY " : the "at" and spaces are important!} +\@message{I'm going to try to ignore this label: don't blame me if there are some} +\@message{funny numbers in your diagram and later labels are out-of-position.} +\@message{}}} + +\def\finally@pinlabel@ #1 at #2 #3 {% +\ifx\hair@flag\relax% +\@setlabel@{\ifx\baseline@flag\relax\the@label\else\smash{\the@label}\fi}% +{#2}{#3}{\@labxpos@}{\@labypos@}{\@xadj@}{\@yadj@}% +\else +{\hair 0pt \@setlabel@{\ifx\baseline@flag\relax\the@label\else\smash{\the@label}\fi}% +{#2}{#3}{\@labxpos@}{\@labypos@}{\@xadj@}{\@yadj@}} +\fi +%%%% don't forget to reset the flags etc to default values +\let\hair@flag\relax\let\baseline@flag\relax% +\def\@labxpos@{0}\def\@labypos@{0}% +\def\@xadj@{0pt}\def\@yadj@{0pt}} + +%%%% start to parse the argument +%%%% is this a starred form or not? +\def\pinlabel{\@ifnextchar*% +{\pin@nohair}{\@pinlabel@}} +\def\pin@nohair* #1 {\def\hair@flag{0}\@pinlabel@ {#1} } + +%%%% store the label for safety then +%%%% is there any label position information? +\def\@pinlabel@ #1 {\def\the@label{#1}\@ifnextchar a% +{\finally@pinlabel {#1} }{\@pinlabel@@ {#1} }} + +%%%% are we using "by" or [ or going directly to <..,..> +\def\@pinlabel@@ #1 {\@ifnextchar [% +{\pin@by@letters {#1} }{\@@pinlabel@@ {#1} }} + +\def\@@pinlabel@@ #1 {\@ifnextchar b +{\pin@by@numbers {#1} }{\@@pinlabel@@@ {#1} }} + +\def\@@pinlabel@@@ #1 {\@ifnextchar <% +{\pin@with@adj {#1} }{\@message{}% +\@message{I don't understand your positioning information for label #1 and shall} +\@message{ignore it; or perhaps your label has a space and needs braces.} +\finally@pinlabel {#1} }} + +%%%% pin@with@adj recycles from the top (to allow <Xpt,Ypt> to come first) +\def\pin@with@adj #1 <#2,#3> {% +\def\@xadj@{#2}\def\@yadj@{#3} +\@pinlabel@ {#1} } + +%%%% we are using letters, is there adjustment? +\def\pin@by@letters #1 [#2] {\@ifnextchar <% +{\pin@by@letters@with@adj {#1} [#2] }{\pin@by@letters@no@adj {#1} [#2] }} + +%%%% we are using numbers, is there adjustment? +\def\pin@by@numbers #1 by #2 #3 {\@ifnextchar <% +{\pin@by@numbers@with@adj {#1} by #2 #3 }{\pin@by@numbers@no@adj {#1} by #2 #3 }} + +\def\pin@by@numbers@with@adj #1 by #2 #3 <#4,#5> at #6 #7{% +\def\@labxpos@{#2}\def\@labypos@{#3}% +\def\@xadj@{#4}\def\@yadj@{#5} +\finally@pinlabel {#1} at #6 #7} + +\def\pin@by@numbers@no@adj #1 by #2 #3 at #4 #5{% +\def\@labxpos@{#2}\def\@labypos@{#3}% +\def\@xadj@{0pt}\def\@yadj@{0pt} +\finally@pinlabel {#1} at #4 #5} + +%%% read the letter pin positions to a control sequence +\def\pin@by@letters@no@adj #1 [#2] {% +\expandafter\ifx\csname position@#2\endcsname\relax +\@message{} +\@message{Unkown position code [#2]; I shall ignore it.} +\@message{}\else +\csname position@#2\endcsname\fi +\finally@pinlabel {#1} } + +\def\pin@by@letters@with@adj #1 [#2] <#3,#4> {% +\expandafter\ifx\csname position@#2\endcsname\relax +\@message{} +\@message{Unkown position code [#2]; I shall ignore it.} +\@message{}\else +\csname position@#2\endcsname\fi +\def\@xadj@{#3}\def\@yadj@{#4} +\finally@pinlabel {#1} } + + +%%%% final task: parse the letter pin positions +\def\position@t{\def\@labxpos@{0}\def\@labypos@{1}} +\def\position@b{\def\@labxpos@{0}\def\@labypos@{-1}} +\def\position@l{\square@left\def\@labxpos@{-1}\def\@labypos@{0}} +\def\position@r{\square@right\def\@labxpos@{1}\def\@labypos@{0}} +\def\position@B{\def\baseline@flag{1}\def\@labxpos@{0}\def\@labypos@{0}} +\def\position@rt{\square@right\def\@labxpos@{1}\def\@labypos@{1}} +\def\position@tr{\square@right\def\@labxpos@{1}\def\@labypos@{1}} +\def\position@br{\square@right\def\@labxpos@{1}\def\@labypos@{-1}} +\def\position@rb{\square@right\def\@labxpos@{1}\def\@labypos@{-1}} +\def\position@lt{\square@left\def\@labxpos@{-1}\def\@labypos@{1}} +\def\position@tl{\square@left\def\@labxpos@{-1}\def\@labypos@{1}} +\def\position@bl{\square@left\def\@labxpos@{-1}\def\@labypos@{-1}} +\def\position@lb{\square@left\def\@labxpos@{-1}\def\@labypos@{-1}} +\def\position@lB{\square@left\def\baseline@flag{1}% +\def\@labxpos@{-1}\def\@labypos@{0}} +\def\position@Bl{\square@left\def\baseline@flag{1}% +\def\@labxpos@{-1}\def\@labypos@{0}} +\def\position@rB{\square@right\def\baseline@flag{1}% +\def\@labxpos@{1}\def\@labypos@{0}} +\def\position@Br{\square@right\def\baseline@flag{1}% +\def\@labxpos@{1}\def\@labypos@{0}} + +%%%% \square@left and \square@right are hacks to force diagonal +%%%% autospacing for the corner letter pin positions + +\def\square@left{% +\setbox\label@box\hbox{\mathsurround 0pt\ignorespaces\the@label}% +\y@lab\ht\label@box\advance\y@lab\dp\label@box\let\old@label\the@label +\def\the@label{\hbox to \y@lab{\old@label\hss}}} + +\def\square@right{% +\setbox\label@box\hbox{\mathsurround 0pt\ignorespaces\the@label}% +\y@lab\ht\label@box\advance\y@lab\dp\label@box\let\old@label\the@label +\def\the@label{\hbox to \y@lab{\hss \old@label}}} + +%%%% end of \pinlabel macro + +\catcode`@=\atcatcode + +\endinput + +%%%%% History: Version 1.1 released 25 March 2006 +%%%%% 28/Mar/06: bugfixes and code to detect mathematica/illustrator deleted +%%%%% 5/Apr/06: bugfix and extra utility: <Xpt,Ypt> can come first +%%%%% 20/Apr/06: \includegraphics uses graphicx if no labellist (Naom) +%%%%% 1/May/06: bugfix to \includegraphics code +%%%%% 23/Oct/06: LPPL license added (for CTAN)
\ No newline at end of file |