man 1 ps2eps

PS2EPS(1ELCA)                                                    PS2EPS(1ELCA)

NAME
       ps2eps  -  converts  PostScript to Encapsulated PostScript for use with
       LaTeX.

SYNOPSIS
       ps2eps [ options ] inputfile

DESCRIPTION
       Ps2eps is a program that reads the PostScript (PS) inputfile  and  con-
       verts  it to an Encapsulated PostScript (EPS) file meant to be included
       into a LaTeX file.  The default extension of inputfile is .ps.  In gen-
       eral inputfile will be a PostScript picture file generated for instance
       by Gem.  Ps2eps generates an outputfile as supplied by the -o option or
       with the same name as inputfile and extension .eps.

       When  for  inputfile a ? is supplied a brief description of all options
       is displayed.  Be aware of escaping the ? when operating under UNIX  to
       prevent file name substitution by the shell.

       When the picture file was generated by DrawPerfect, Gem, OrCAD, PSpice,
       Gnuplot, Mathcad or PrintGL special actions are taken to make  a  suit-
       able  EPS  file.   However,  the picture file may come from anywhere in
       which case ps2eps will do its best in making a usable EPS file.  Ps2eps
       is meant to be used with programs `dvips' or `dvialw' to make a PS file
       from the dvi file.

       Program options:

       The -D, -P, -G, -O, -T, -M and -H options are mutually exclusive.

       -D          inputfile is a PS file from DrawPerfect version 1.1.

       -P          inputfile is a PS file from PSpice version 4.05.
                   PSpice generates it's picture within always the same bound-
                   ingbox  dimensions.  These  are  scaled so that the default
                   width will be 140 mm.

       -G          inputfile is a PS file from Gem version 3.0.

       -O          inputfile is a PS file from OrCAD version 3.11.
                   Owing to the simple structure in an OrCAD  PS  file  ps2eps
                   determines  the  boundingbox dimensions itself.  When width
                   is greater than the default width of 140 mm  it  is  scaled
                   back to it.

       -T          inputfile is a PS file from Gnuplot version 3.0.

       -M          inputfile is a PS file from Mathcad version 3.0.

       -H          inputfile is a PS file from PrintGL version 1.18.
                   Among others PrintGL converts HPGL to PS.

       -b#,#,#,#   picture boundingbox in millimeters.
                   #,#,#,# means respectively:
                   llx = lower-left x coordinate.
                   lly = lower-left y coordinate.
                   urx = upper-right x coordinate.
                   ury = upper-right y coordinate.
                   For good centering the boundingbox must be symetrically po-
                   sitioned around the picture.
                   This option is required with the -D, -G and -M option.
                   When used with the other options it is neglected.

       -w#         denotes picture width in millimeters.  Must be <= 140.

       -h#         denotes picture height in millimeters.  Must be <= 200.

       -s#,#       extra space in millimeters above and below the picture  re-
                   spectively.

       -d          Headerline with Date, Time and Temperature.
                   Only valid with -P option.

       -f          No boundingbox frame around the picture.
                   Only valid with -O option.
                   When using OrCAD the user has to switch off the OrCAD frame
                   and make a boundingbox frame around the picture.

       -oname      output file name.

EXAMPLE
       The following code fragment demontrates how to include  an  EPS  figure
       file  into  a  LaTeX file.  It is assumed that `dvips' is used later on
       for the conversion to PS.

       \documentstyle[a4,11pt]{article}
       \begin{document}
       \input epsf
                  any text
       \centerline{\epsffile{yourfile.eps}}
       If it is desired to include a figure caption, this can be
       done by putting the inserted line into a figure environment.

       \begin{figure}[h]
       \centerline{\epsffile{yourfile.eps}}
       \caption{your caption text}
       \end{figure}\\
                  any text
       \end{document}

NOTES
       To get the right PS file from the graphic programs it is useful to read
       the notes about that in file /usr/local/lib/ps2eps/notes.ps

WARNINGS
       When  versions  of  the graphic programs other than the above mentioned
       are used ps2eps may fail due to a different PS output format.

AUTHOR
       Jan Nusteling

FILES
       /usr/local/lib/ps2eps/notes.ps     How to use the graphic programs.

SEE ALSO
       dvips(1), dvialw(1ELCA)

4th Berkeley Distribution         28-Aug-1991                    PS2EPS(1ELCA)