home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / useful / text / tex / pastex / macros / latex2e / contrib / supported / epsfig / epsfig.sty < prev    next >
Text File  |  1994-01-27  |  49KB  |  1,338 lines
  1. %----------------------------------------------
  2. \NeedsTeXFormat{LaTeX2e}
  3. \def\fileversion{2}%
  4. \def\filedate{1994/01/25}%
  5. \ProvidesPackage{epsfig}[\filedate]
  6. \message{ Epsfig }
  7. % minimal reworking for LaTeX2e!
  8. % 
  9. % this will be all be rewritten when the LaTeX2e includegraphics
  10. % comes out.
  11. %
  12. % SPQR Jan 94
  13. %
  14. %%%--------------------------------------------------------------------
  15. %%% psfig merged with EPSF = epsfig Release 1
  16. %%% 1.0 November 91
  17. %%% 1.1 Dec 91  fixed some bugs
  18. %%% 1.2 Jan 92  fixed bug that it never stopped reading PS file until
  19. %%%             it reached the end! merged in changes from psfig1.8
  20. %%%             (plain TeX definition of \fbox, new code for rotation)
  21. %%% 1.3 Jan 92  separated out \special code so that dvitops can be
  22. %%%             supported. use \psfigdriver{dvitops}%
  23. %%% 1.4 Jan 92  fixed dvitops. need to input psfig at different point
  24. %%%      in dvips from dvitops. define \psfig@start and \psfig@end to cope
  25. %%%      with this
  26. %%% 1.5 Jan 92  force use of psfig method if using dvitops
  27. %%% 1.6 May 92 fixed bugs
  28. %%% 1.7 Sep 92 added support for emtex, sort of. reads a .bb file
  29. %%%            and imports .pcx file. Boolean flag \epsfigdos used
  30. %%%             to indicate that we cannot have more than one . in the
  31. %%%             suffix (ie we will look at file.bb not file.eps.bb)
  32. %%%
  33. %%% 1.8 Sep 92 added support for OzTeX; fixed bugs in dvips support
  34. %%% (including clipping to bounding box); removed use of dimen100.
  35. %%%
  36. %%% 1.9 Dec 92 cleaned up documentation again
  37. %%% 1.10 Mar 93 cleaned up for plain TeX
  38. %%% 1.11 Mar 93 merged in changes by Peter Galko (supplied by CERN) for
  39. %%%             use with Textures
  40. %%% 1.12 Apr 93 actually *tested* the Textures additions, and so rewrote
  41. %%%            from scratch (borrowed an idea from psbox)
  42. %%% 1.13 May 93 allow for file names with _ or $ in them in \psdraft, and
  43. %%%             fix problem that occurred with missing BoundingBox
  44. %%% 1.14 May 93 allow for .z suffix
  45. %%% 1.15 July 93 allow for .gz suffix
  46. %%%              use \leavevmode as appropriate
  47. %%%              fix plain \TeX mode 
  48. %%%             (fixes from Peter-Klaus Schilling <R02SCH@DSYIBM.DESY.DE>)
  49. %%% 1.16 August 93 [peta@mcrcim.mcgill.edu (Peter Whaite)]
  50. %%%        -- Implement Perl scripts to do compressed file inclusion and bb
  51. %%%           generation. 
  52. %%%        -- Add \pscompress.
  53. %%%        -- Tidy up comments.
  54. %%% 1.17 September 93 SPQR
  55. %%%     better code for literal name printing
  56. %%%     allowed for spaces around , and =
  57. %%% 1.18 17.9.93
  58. %%%   updates to epsbb and epsfig from Peter W
  59. %%% 1.19 14.11.93
  60. %%%   mistaken placement of calculation of EPS@Height resulted in errors
  61. %%%
  62. %--------------------------------------------------------
  63. %%%
  64. %%% code rearranged by Sebastian Rahtz (spqr@uk.ac.york.minster)
  65. %%% from work by
  66. %%% Trevor Darrell; Tom Rokicki; Daniel Smith; H. Payne, Robert Russell
  67. %%%
  68. %%% This is a version of Darrell's `psfig' macros which are designed
  69. %%% to be used with dvips or dvitops, and the `epsf' macros (these are
  70. %%% automaticaly included by the style file). I did this because the
  71. %%% \special commands used by `epsf' appear to be more robust and
  72. %%% portable than the raw \specials used by `psfig', but I preferred
  73. %%% the psfig interface. This system preserves the psfig interface,
  74. %%% but mainly uses epsf macros to carry out the job. The user
  75. %%% interface is identical to \psfig, but you just use \epsfig
  76. %%% instead. Rotation uses the original psfig macros: I could not work
  77. %%% out how to do rotation with the epsf macros.
  78. %%%
  79. %%% The same applies to `rheight' and `rwidth'
  80. %%%
  81. %%% If you *really* want old psfig behaviour regardless, use \psfig. It is
  82. %%% still there. Some of the features have gone, however. \figurepath
  83. %%% seemed redundant, since it could be controlled by the TEXINPUTS
  84. %%% variable anyway.
  85. %%%
  86. %%% As an added feature, if FILE cannot be found, a file called FILE.bb
  87. %%% is searched for. This should simply contain a %%BoundingBox line. A perl
  88. %%% script "epsbb" is provided to generate these automatically.  It is
  89. %%% assumed that if this exists, then the actual postscript is in UNIX
  90. %%% compress format in FILE.Z or in GNU gzip format in FILE.gz or FILE.z.
  91. %%%
  92. %%% The macros then read the BB from FILE.bb, but insert "`epsfig FILE`" in
  93. %%% the  output for dvips to interpret (don't worry, it knows about this).
  94. %%% "Epsfig" is another perl script which  searches the TEXINPUTS path for
  95. %%% FILE or FILE.{gz,z,Z}.
  96. %%%
  97. %%% As an added bonus if you say \pscompress the -c switch will be passed to
  98. %%% epsfig, causing automatic FILE.bb generation and compression the first
  99. %%% time dvips is run.  Files in the system directories will NOT be
  100. %%% compressed.
  101. %%% If you are *not* on a Unix system and use this, deliberately or by
  102. %%% mischance, you will have problems!
  103. %%%
  104. %%% This file can be included in a dumped format, or used as a LaTeX
  105. %%% style file, or used in plain TeX. It does not load itself twice (I hope)
  106. %%%
  107. %--------------------------------------------------------------------
  108. %--------------------------------------------------------------------
  109. %%% previous notes. this copy of psfig.tex inherited from versions 1.8
  110. %--------------------------------------------------------------------
  111. %%% All psfig/tex software, documentation, and related files
  112. %%% in this distribution of psfig/tex are
  113. %%% Copyright 1987, 1988, 1991 Trevor J. Darrell
  114. %
  115. %%% Permission is granted for use and non-profit distribution of psfig/tex
  116. %%% providing that this notice be clearly maintained. The right to
  117. %%% distribute any portion of psfig/tex for profit or as part of any commercial
  118. %%% product is specifically reserved for the author(s) of that portion.
  119. %%%
  120. %%% Thanks to Greg Hager (GDH) and Ned Batchelder for their contributions
  121. %%% to this project.
  122. %%%--------------------------------------------------------------------------
  123. %%% GDH 7/26/87 -- changed so that it first looks in the local directory,
  124. %%% then in a specified global directory for the ps file.
  125. %%% SPQR 12/91 removed that last change. it follows TEXINPUTS anyway
  126. %%% RPR 6/25/91 -- changed so that it defaults to user-supplied name if
  127. %%% boundingbox info is specified, assuming graphic will be created by
  128. %%% print time.
  129. %%% SPQR 12/91 removed that last change. use LaTeX error message instead
  130. %%% SPQR 12/91 -- `no file found' produces LaTeX error message.
  131. %%%                If you recover from that the file name is set in draft
  132. %%%                mode in place of the file.
  133. %%%
  134. %%% Modified by J. Daniel Smith on 9 October 1990 to accept the
  135. %%% %%BoundingBox: comment with or without a space after the colon.  Stole
  136. %%% file reading code from Tom Rokicki's EPSF.TEX file (see below).
  137. %%% --- SPQR 12.91 removed most of this to use epsf directly
  138. %%%
  139. %%% More modifications by J. Daniel Smith on 29 March 1991 to allow the
  140. %%% the included PostScript figure to be rotated.  The amount of
  141. %%% rotation is specified by the "angle=" parameter of the \epsfig command.
  142. %%%
  143. %%% Modified by Robert Russell on June 25, 1991 to allow users to specify
  144. %%% .ps filenames which don't yet exist, provided they explicitly provide
  145. %%% boundingbox information via the \epsfig command. Note: This will only work
  146. %%% if the "file=" parameter follows all four "bb???=" parameters in the
  147. %%% command. This is due to the order in which psfig interprets these params.
  148. %%% ---- SPQR 12.91 removed all this
  149. %%%
  150. %%% 3 Jul 1991  JDS     check if file already read in once
  151. %%%
  152. %-----------------------------USAGE---------------------------------------
  153. % From: gvr@cs.brown.edu (George V. Reilly)
  154. %
  155. % \psdraft      draws an outline box, but doesn't include the figure
  156. %               in the DVI file.  Useful for previewing.
  157. %
  158. % \psfull       includes the figure in the DVI file (default).
  159. %
  160. % \psscalefirst width= or height= specifies the size of the figure
  161. %               before rotation.
  162. % \psrotatefirst (default) width= or height= specifies the size of the
  163. %                figure after rotation.  Asymetric figures will
  164. %                appear to shrink.
  165. %
  166. % usage: \epsfig{file=, figure=, height=, width=,
  167. %                       bbllx=, bblly=, bburx=, bbury=,
  168. %                       rheight=,