diff options
Diffstat (limited to 'support/xtexshell/help/help_tools')
-rw-r--r-- | support/xtexshell/help/help_tools | 115 |
1 files changed, 115 insertions, 0 deletions
diff --git a/support/xtexshell/help/help_tools b/support/xtexshell/help/help_tools new file mode 100644 index 0000000000..dd421c572d --- /dev/null +++ b/support/xtexshell/help/help_tools @@ -0,0 +1,115 @@ +:entry +psfig +pssilent +psnoisy +psdraft +psnoisy +psscalefirst +psrotatefirst +:header +PSFIG: Including Postscript Documents +:synopsis +\psfig{figure=:em input_file[,option1[,option2,...]]} +\pssilent +\psnoisy +\psdraft +\psfull +\psscalefirst +\psrotatefirst +:description +Psfig is a macro package for TeX that facilitates the inclusion of Postscript +figures into TeX documents. With the help of a compatible postprocessor (dvips +for example), figures are automatically scaled and positioned on the page, +and the proper amount of space is reserved. + +To include a Postscript figure with psfig, include the psfig style at the top +of your document: + + \documentstyle[...,psfig]{article} + +and then, when you wish to include a figure, invoke the macro + + \psfig{figure=input} + +where input is the name of a Postscript file. Psfig will automatically position the +figure at the current point on the page, and reserve the proper amount of space +in TeX so that it doesn't block any other objects on the page. + +:bold \psfig + +Psfig includes a postscript document. Optional parameters are: +:el +:li height=len +:li width=len +:li rheight=len +:li rwidth=len +:li angle=angle +:li prolog=filename +:li clip= +:li bbllx=pos,bblly=pos,bburx=pos,bbury=pos Specify your own bounding box. This +is useful if your Postscript document does not have a bounding box. See below +:eel + +:bold \pssilent :bold and :bold \psnoisy + +Normally, psfig will print advisory messages to remind you that it is including +figures as TeX processes a document. This behavior can be disabled with \pssilent, +and re-enabled with \psnoisy. + +:bold \psdraft :bold and :bold \psfull + +Some Postscript figures can take quite a long time to transmit and print; for +these figures a draft mode is available to speed printing of draft versions of +the document. A figure printed in draft mode will appear as a box with the name +of the figure file (Figure 2). The macro \psdraft will switch into draft mode, +and all subsequent psfig macros will produce draft figures until reaching the +macro \psfull, which switches out of draft mode. + +:bold Bounding :bold Boxes + +To properly translate and scale a figure psfig must know its `natural' position +on the page; this information is present in what is called the :em bounding :em box +of a Postscript program. The bounding box is an outer limit to the marks created +by a program, and is specified as four coordinates of a rectangle: the lower-left +x-coordinate (bbllx), the lower-left y-coordinate (bblly), the upper-right +x-coordinate (bburx), and the upper-right y-coordinate (bbury). +Adobe has defined a convention whereby the bounding box of a program +is contained in a `bounding box comment'. + +This comment, which :bold must be present in any file to be used as a psfig figure, +is a line of the form + + %%BoundingBox: :em bbllx :em bblly :em bburx :em bbury + + +:bold Rotation + +With autoscaling, some rotated figures come out smaller because the diagonal of +their bounding box is of course longer than their height or width alone. This +behavior can be disabled with \psscalefirst, and re-enabled with \psrotatefirst. +:example + +\documentstyle[11pt,psfig]{article} + +\begin{document} + + % A simple Postscript figure + + \psfig{figure=xmas.ps} + + % This one specifies the width and uses a special prolog + + \psfig{figure=figs/lab2.ps,width=3.25in,prolog=figs/oldmac.pro} + + % Now rotated rosettes + + \psscalefirst + \centerline{\hbox{ + \psfig{figure=rosette.ps,height=1.0in} + \psfig{figure=rosette.ps,height=1.0in,angle=20} + \psfig{figure=rosette.ps,height=1.0in,angle=40} + \psfig{figure=rosette.ps,height=1.0in,angle=60} + }} + +\end{document} + |