Man Linux: Main Page and Category List

NAME

       fig2ps,  fig2eps,fig2pdf - Convert xfig files in ps|pdf, processing all
       the text marked as special with LaTeX.

SYNOPSIS

       fig2ps [-h|--help]

       fig2ps [ options ] file1.fig [file2.fig ...]

       fig2pdf [ options ] file1.fig [file2.fig ...]

DESCRIPTION

       fig2ps converts figures  produced  by  XFig  into  postscript  or  PDF,
       processing  the  text  with  LaTeX. It takes advantage of the pstex and
       pstext_t export formats of fig2dev.

       fig2ps converts successively all the files  given  as  arguments.  It’s
       behaviour is governed by quite a few options. In all the options, the =
       sign is optional, so that

       fig2ps --bbox=dvips file.fig

       and

       fig2ps --bbox dvips file.fig

       are equivalent.

EXAMPLES

       To convert file.fig to PS:

       fig2ps file.fig

       To convert it to PDF:

       fig2pdf file.fig

       or

       fig2ps --pdf file.fig

       If the XFig file you want to convert to PDF contains  included  images,
       you might want to try:

       fig2pdf --manual-ps2pdf file.fig

OPTIONS

       --gv, --nogv
           If  on,  fig2ps runs gv on every file just after they are produced.
           On by default if fig2ps thinks it is talking to a terminal (ie  not
           from  a  pipe).  You  might want to switch that off when processing
           lots of files.

       --xpdf
           Views produced files with xpdf rather  than  gv.   Obviously,  that
           won’t  be  really useful if you are producing PS files, you’ve been
           warned.

       --viewer=command
           Runs command rather than gv on the produced files.

       --keep
           Tells fig2ps to keep the temporary  directory  in  which  temporary
           files  are  created.  Useful  for  debugging. If this option is on,
           fig2ps prints the name of the directory when it  has  finished  its
           job, so you know where to look.

       --packages=pack1,pack2,...
           Sets  the  package  list to be used to pack1,pack2,....  Resets any
           package  given  by  the  --add  command-line   option.   For   more
           information about packages, see the section PREAMBLE below.

       --add=pack1,pack2,...
           Adds  pack1,pack2,...   to  the  existing list of packages. See the
           section PREAMBLE below. This option is cumulative.

       --bbox=dvips|gs|a,b,c,d
           Chooses the method to determine the bounding box of the files.  See
           the section BOUNDING BOX below for more information.

       --input=file
           Uses  file as a template for the LaTeX file. More information about
           that can be found in the section PREAMBLE below.  This  option  was
           written for a private use, though you can of course profit from it.
           However, most of the times, what you  really  want  is  --add=file.
           file will be looked for using kpsewhich.

       --pdf, --nopdf
           Whether  the final output of fig2ps will be PDF or postscript. This
           option is automatically when called as fig2pdf.  Note that  in  any
           case,  fig2ps  has to go through Postscript output to produce a PDF
           file.

       --eps
           Change the output default extension from .ps to .eps.  This  is  on
           by  default when the program is called as fig2eps.  It has no other
           effects.

       --manual-ps2pdf
           When producing PDF files,  fig2ps  uses  epstopdf  to  perform  the
           conversion.  This  may  lead  to  bad  quality output with embedded
           pictures. The  use  of  this  option  disables  PDF  production  by
           epstopdf  and  lets  ps2pdf produce the final output PDF (but after
           tweaking the PS file using epstopdf).  In  general,  this  produces
           much better results.

       --ps2pdf-options
           When --manual-ps2pdf does not produce output of decent quality, you
           can use this option to manually feed options to ps2pdf.  The use of
           this option implies --manual-ps2pdf.

       --keepps
           When  producing  a  PDF  file, asks fig2ps to keep the intermediary
           Postscript file.

       --forcespecial, --noforcespecial
           fig2ps only processes with LaTeX text which is marked as special in
           the  Fig file. When this option is on, all text is treated as if it
           was marked with the special flag.

       --dvips=string
           Passes string as options for dvips.

       --fig2dev=string
           Passes string as options for fig2dev.

       --preamble=string
           Adds string in the preamble  of  the  LaTeX  file  generated,  just
           before the \begin{document} stanza. Effects are cumulative.

       -V,  --version
           Prints the version of fig2ps and exits.

CONFIGURATION FILES

       Many  of  the command-line options can be set in either the system-wide
       (in  /etc)  or  the  user  configuration  file  (in  the  user’s   home
       directory).  Some  more  details can be configured in the configuration
       files. Global configuration is overridden by users’ configuration which
       in  turn  is overridden by the command line options.  Here is a list of
       the variables you can define:

       PACKAGES=pack1,pack2...
           Defines the basic list of packages. See the PREAMBLE section.

       ADD=pack1,pack2
           Has the same effect as the --add command-line option. Does not make
           too much sense in the global configuration file, but you might want
           to use it in a personal one.

       DOC_CLASS=class
           Sets the document class used by LaTeX.

       DOC_OPTIONS=Ioptions
           Sets the options for the document class.

       FORCE_SPECIAL=0|1
           Sets the default for option --forcespecial.

       GV=0|1
           Sets the default for option --gv.

       GV=file
           Has the same effect as the --input command-line option.

       PREAMBLE=string
           Identical to the --preamble option, with the slight difference that
           the  in  configuration  files,  it  is  not  cumulative:  the  last
           assignment seen is the only taken into account.

       KEEP_PS=0|1
           Sets the default for option --keepps.

PREAMBLE

       The preamble of the LaTeX file is built as such:

       * if a --input file is specified, it  will  be  used  directly  with  a
         \input  statement.  A  \documentclass  statement will be added if the
         input file does not contain any.

       * else,  a  preamble  is  made  based  on  the  values  of   DOC_CLASS,
         DOC_OPTIONS, and PACKAGES (the latter is overridden by the --packages
         command-line option).  See  below  for  the  format  of  the  package
         variables.

       Then,  the  packages  specified  using  the  ADD variable and the --add
       command-line options  are  added  to  the  preamble,  followed  by  the
       geometry  package  that  deals  with  setting  the  size  of the output
       (tweaked for  fig2ps’s  purposes)  and  finally  the  contents  of  the
       PREAMBLE variable and the --preamble command-line options.

       The --packages and --add options, and the corresponding variables, take
       a comma separated list of packages. Options for  the  packages  can  be
       specified in two ways:

       [option]package
           in which you can only specify one option;

       option1:option2:...:package
           in which you can specify an arbitrary number of options, as long as
           you don’t need a comma inside an option. Should the need arise, use
           --preamble.

BOUNDING BOX

       One  of  the  delicate jobs of fig2ps is to set the bounding box of the
       produced file, that is the rectangle that holds the figure.  There  are
       basically three ways for fig2ps to get them:

       dvips
           In  this  mode,  fig2ps  runs  dvips  with  the -E option. It works
           reasonably fine most of the time, but  it  will  produce  incorrect
           results if you have rotated text near the edge of the graph.

       gs  Asks  gs to tell the bounding box of the figure. It used to produce
           systematically  perfect  results,  but  the  quality  has  degraded
           somehow  recently. It still works in most of the cases, and that is
           why it is the default. It fails on very large pictures.

       a,b,c,d
           Specify your bounding box by hand.

       The benefits of using the last two methods is that fig2ps tells you how
       big the picture is (in centimeters).

FILES

       /etc/fig2ps/fig2ps.rc, $HOME/.fig2ps.rc

       The  examples/  directory in the source tarball contains some examples.
       Check fig2ps on them to see if it works fine, but  keep  in  mind  that
       fig2ps will choke on examples/Large-example.fig !

SEE ALSO

       xfig(1), fig2dev(1), latex(1), gv(1), gs(1), kpsewhich(1)

       The Sourceforge project page at:

       http://sourceforce.net/projects/fig2ps

AUTHOR

       This  script  was written by Vincent Fourmond, from an original idea of
       Seb Desreux (the first script is for private use, and  used  the  eepic
       export  of  xfig,  which  is  severely  limitated),  improved  by a few
       others...

BUG REPORT AND FEATURE REQUESTS

       Please use the tracker from the Sourceforge project page:

       https://sourceforge.net/tracker/?group_id=125824