Provided by: fig2dev_3.2.7a-7ubuntu0.1_amd64 bug

NAME

       fig2dev - translates Fig code to various graphics languages

SYNOPSIS

       fig2dev  -L language [-m mag] [-s fsize] [-Z maxdimension]
               [-D +/-rangelist [-K]] [other  options]  [fig-file
               [out-file]]

DESCRIPTION

       fig2dev  translates  fig code in the named fig-file into the specified graphics language and puts them in
       out-file.  The default fig-file and out-file are standard input and standard output, respectively

       Xfig (Facility for Interactive Generation of figures) is a screen-oriented tool which runs  under  the  X
       Window System, and allows the user to draw and manipulate objects interactively.  This version of fig2dev
       is compatible with xfig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and 3.2.

       Xfig version 3.2.3 and later saves and allows the user to edit  comments  for  each  Fig  object.   These
       comments  are output with several of the output languages, such as PostScript, CGM, EMF, LaTeX, MetaFont,
       PicTeX, (as % comments), tk (as # comments), and pic (as .\" comments).

GENERAL OPTIONS (all drivers)

       -L language
              Set the output graphics language.  Valid languages are box, cgm, dxf, epic, eepic, eepicemu,  emf,
              eps,  gbx  (Gerber  beta driver), gif, ibmgl, jpeg, latex, map (HTML image map), mf (MetaFont), mp
              (MetaPost), pcx, pdf, pdftex, pdftex_t,  pic,  pict2e,  pictex,  png,  ppm,  ps,  pstex,  pstex_t,
              pstricks, ptk (Perl/tk), shape (LaTeX shaped paragraphs), sld (AutoCad slide format), svg, textyl,
              tiff, tikz, tk (tcl/tk), tpic, xbm and xpm.

              Notes:
              You must have ghostscript installed to get the pdf output, and ghostscript and the netpbm  package
              to get the bitmap formats (png, jpeg, etc.).

       -h     Print help message with all options for all output languages then exit.

       -V     Print the program version number and exit.

       -D +/-rangelist
              With  +rangelist,  keep  only  those  depths in the list.  With -rangelist, keep all depths except
              those in the list.  The rangelist may be a list of comma-separated numbers or ranges separated  by
              colon (:). For example, -D +10,40,55:70,80 means keep only layers 10, 40, 55 through 70, and 80.

       -K     The  selection  of  the  depths  with  the  -D  +/-rangelist  option  does normally not affect the
              calculation of the bounding box.  Thus the generated document might have a  much  larger  bounding
              box than necessary. If -K is given then the bounding box is adjusted to include only those objects
              in the selected depths.

       -G minor[:major][:unit]
              Draws a grid on the page.  Specify thin, or thin and thick line spacing in one of  several  units.
              For  example,  -G .25:1cm draws a thin, gray line every .25 cm and a thicker gray line every 1 cm.
              Specifying -G 1in draws a thin line every 1 inch.  Fractions may be used, e.g. -G :1/2in will draw
              a thick line every 1/2 inch.
              Allowable units are: i, in, inch, f, ft, feet, c, cm, mm, and m.
              Only allowed for PostScript, EPS, PDF, pstricks, tikz and bitmap (GIF, JPEG, etc) drivers.

       -j     Enable the I18N internationalization facility.

       -m mag Set  the  magnification at which the figure is rendered to mag.  The default is 1.0.  This may not
              be used with the maxdimension option (-Z).

       -s fsize
              Set the default font size (in points, 1/72 inch) for  text  objects  to  fsize.   The  default  is
              11*mag,  and  thus is scaled by the -m option.  If there is no scaling, the default font is eleven
              point Roman.

       -Z maxdimension
              Scale the figure so that the maximum dimension (width or height) is  maxdimension  inches  or  cm,
              depending  on  whether  the  figure was saved with imperial or metric units.  This may not be used
              with the magnification option (-m).

       other options
              The other options are specific to the choice of graphics language, as described below.

OPTIONS COMMON TO ALL BITMAP FORMATS

       -b borderwidth
              Make blank border around figure of width borderwidth (1/72 inch).

       -F     Use correct font sizes (points, 1/72 inch) instead of the traditional size that xfig/fig2dev uses,
              which is 1/80 inch.  The corresponding xfig command-line option is -correct_font_size.

       -g color
              Use color for the background.

       -N     Convert all colors to grayscale.

       -S smoothfactor
              This  will  smooth  the  output  by passing smoothfactor to ghostscript in the -dTextAlphaBits and
              -dGraphicsAlphaBits options to improve font rendering and graphic smoothing.  A  value  of  2  for
              smoothfactor provides some smoothing and 4 provides more.

GIF OPTIONS

       -t color
              Use  color  for  the transparent color in the GIF file.  This must be specified in the same format
              that ppmmake(1) allows.  It may allow an X11 color name, but at least  you  may  use  a  six-digit
              hexadecimal RGBvalue using the # sign, e.g. #ff0000 (Red).

JPEG OPTIONS

       -q image_quality
              use the integer value image_quality for the JPEG "Quality" factor.  Valid values are 0 - 100, with
              the default being 75.

CGM OPTIONS

       CGM is Computer Graphics Metafile, developed by ISO and ANSI and is a vector-based plus bitmap  language.
       Microsoft  WORD,  PowerPoint  and  probably  other  products can import this format and display it on the
       screen, something that they won't do with EPS files that have an ASCII preview.

       -a     Generate binary output.

       -r     Position arrowheads for CGM viewers that display rounded  arrowheads.   Normally,  arrowheads  are
              pointed, so fig2dev compensates for this by moving the endpoint of the line back so the tip of the
              arrowhead ends where the original endpoint of the line  was.   If  the  -r  option  is  used,  the
              position  of arrows will NOT be corrected for compensating line width effects, because the rounded
              arrowhead doesn't extend beyond the endpoint of the line.

DXF OPTIONS

       DXF is the Drawing Interchange File Format.  The output to DXF is experimental.

       -a     Select ANSI A paper size instead of the default ISO A4.

       -d xll,yll,xur,yur
              Restrict plotting to a rectangular area of the plotter paper which has a lower left hand corner at
              (xll,yll)  and  a upper right hand corner at (xur,yur).  All four numbers are in inches and follow
              -d in a comma-separated list - xll,yll,xur,yur - with no spaces between them.

       -P     Rotate the figure to portrait mode. The default is landscape mode.

       -v     Plot the figure upside-down in portrait mode or backwards in landscape mode.

EMF OPTIONS

       EMF is Enhanced Metafile, developed by Microsoft and is a vector-based plus bitmap  language.   Microsoft
       WORD,  PowerPoint  and  probably  other  products  can  import  this format and display it on the screen,
       something that they won't do with EPS files that have an ASCII preview.

       -l lang
              Set the compatibility level to lang, where lang is one of win95, win98 or winnt.  The  default  is
              winnt.

       -r     Position arrowheads for EMF viewers that display rounded arrowheads.  See the discussion of the -r
              option for the CGM output driver above.

EPIC OPTIONS

       EPIC is an enhancement to LaTeX picture drawing environment.

       EEPIC is an extension to EPIC and LaTeX picture  drawing  environment  which  uses  tpic  specials  as  a
       graphics  mechanism.   It  was  written  by  Conrad Kwok of Division of Computer Science at University of
       California, Davis.  Conrad Kwok has also written the EEPIC driver of fig2dev.

       EEPIC-EMU is an EEPIC emulation package which does not use tpic specials.

       -d factor
              Scale arrowheads by factor.  The width and height of arrowheads is divided by this  factor.   This
              is because EPIC arrowheads are normally about double the size of TeX arrowheads.

       -E num Set encoding for text translation (0 = none, 1 = ISO-8859-1, 2 = ISO-8859-2; default 1).

       -F     Don't  set  the font face, series, and style; only set it's size and the baselineskip. By default,
              fig2dev sets all 5 font parameters when it puts some text. The disadvantage is that you can't  set
              the  font  from  your  LaTeX  document.  With this option on, you can set the font from your LaTeX
              document.

              If any of the pictures included in your LaTeX document  has  been  generated  with  -F,  then  all
              pictures must be generated with this option.

       -f font
              Set  the  default  font  used for text objects to font, where font is one of rm, bf, it, sf or tt.
              The default is rm.

       -l lwidth
              Use "\thicklines" when the width of the line is equal or wider than lwidth.  The default is 2.

       -P     Generate a complete LaTeX file. In other words, the output file can be formatted without requiring
              any changes.

       -R dummyarg
              Allow  rotated  text. Rotated text will be set using the \rotatebox command.  So, you will need to
              include "\usepackage{graphics}" in the preamble of your  LaTeX  document.   A  dummy  argument  is
              required after the -R.

              If this option is not set, then rotated text will be set horizontally.

       -S scale
              Set  the  scale to which the figure is rendered.  This option automatically sets the magnification
              and fsize to scale/12 and scale respectively.  Scale must be between 8 and 12, inclusively.

       -t stretch
              Set the stretch factor of dashed lines to stretch.  The default is 30.

       -v     Include comments in the output file.

       -W     Enable variable line width.  By default, only two line widths are available: The normal line width
              ("\thinlines"), and thick lines ("\thicklines"). See also the -l option above.

       -w     Disable  variable line width. Only "\thicklines" and/or "\thinlines" commands will be generated in
              the output file.

              When variable line width option is enabled, the "\thinlines" command is still used when  the  line
              width is less than LineThick. One potential problem is that the width of "\thinlines" is 0.4pt but
              the resolution of Fig is 1/80 inch (approx. 1pt). If LineThick is set to 2, normal lines  will  be
              drawn  in 0.4pt wide lines but the next line width is already 2pt. One possible solution is to set
              LineThick to 1 and set the width of those lines you want to be drawn in "\thinlines"  to 0.

              Due to this problem, variable line width is disabled by default (-w).

IBM-GL (HP/GL) OPTIONS

       IBM-GL (IBM Graphics Language) is compatible with HP-GL (Hewlett-Packard Graphics Language).

       -a     Select ANSI A paper size instead of the default ISO A4.

       -c     Generate instructions for an IBM 6180 Color Plotter without an IBM Graphics Enhancement  Cartridge
              (IBM-GEC).

       -d xll,yll,xur,yur
              Restrict plotting to a rectangular area of the plotter paper which has a lower left hand corner at
              (xll,yll) and a upper right hand corner at (xur,yur).  All four numbers are in inches  and  follow
              -d in a comma-separated list - xll,yll,xur,yur - with no spaces between them.

       -f fontfile
              Load  text  character  specifications from the table in the file fontfile.  The table must have 36
              entries - one for each font plus a default.  Each entry consists of 5 numbers which specify the
              1.) standard character set (0 - 4, 6 - 9, 30 - 39),
              2.) alternate character set (0 - 4, 6 - 9, 30 - 39),
              3.) character slant angle (degrees),
              4.) character width scale factor and
              5.) character height scale factor.

       -k     Precede output with PCL command to use HP/GL.

       -l pattfile
              Load area fill line patterns from the table in the pattfile file.  The table must have 21  entries
              - one for each of the area fill patterns.  Each entry consists of 5 numbers which specify the
              1.) pattern number (-1 - 6),
              2.) pattern length (inches),
              3.) fill type (1 - 5),
              4.) fill spacing (inches) and
              5.) fill angle (degrees).

       -P     Rotate the figure to portrait mode. The default is landscape mode.

       -p penfile
              Load plotter pen specifications from the table in the penfile file.  The table must have 9 entries
              - one for each color plus a default.  Each entry consists of 2 numbers which specify the
              1.) pen number (1 - 8) and
              2.) pen thickness (millimeters).

       -S speed
              Set the pen speed to speed (centimeters/second).

       -v     Plot the figure upside-down in portrait mode or backwards in landscape mode.  This allows  you  to
              write  on  the  top  surface  of overhead transparencies without disturbing the plotter ink on the
              bottom surface.

       -x offset
              Shift figure left by offset inches.

       -y offset
              Shift figure up by offset inches.

       Fig2dev may be installed with either ANSI A or ISO A4 default paper size.   The  -a  option  selects  the
       alternate  paper  size.   Fig2dev  does  not  fill closed splines.  The IBM-GEC is required to fill other
       polygons.  Fig2dev may be installed for plotters with or without the IBM-GEC.  The -c option selects  the
       alternate instruction set.

LATEX OPTIONS

       -b borderwidth
              Make blank border around figure of width borderwidth (1/72 inch).

       -d dmag
              Set a separate magnification for the length of line dashes to dmag.

       -E num Set  encoding  for  latex  text  translation  (0 = no translation, 1 = ISO-8859-1, 2 = ISO-8859-2;
              default 1).

       -F     Don't set the font face, series, and style; only set it's size and the baselineskip.  By  default,
              fig2dev  sets all 5 font parameters when it puts some text. The disadvantage is that you can't set
              the font from your LaTeX document. With this option on, you can  set  the  font  from  your  LaTeX
              document.

              If  any  of  the  pictures  included  in  your LaTeX document has been generated with -F, then all
              pictures must be generated with this option.

       -f font
              Set the default font used for text objects to font, where font is one of rm, bf,  it,  sf  or  tt.
              The default is rm.

       -l lwidth
              Sets  the  threshold between LaTeX thin and thick lines to lwidth pixels.  LaTeX supports only two
              different line widths: \thinlines and \thicklines.  Lines of width greater than lwidth pixels  are
              drawn as \thicklines.  Also affects the size of dots in dotted line style.  The default is 1.

       -v     Verbose mode. Include comments in the otput file.

       LaTeX  cannot  accurately represent all the graphics objects which can be described by Fig.  For example,
       the possible slopes which lines may have are limited.  Some objects, such as  spline  curves,  cannot  be
       drawn  at all.  Fig2latex chooses the closest possible line slope, and prints error messages when objects
       cannot be drawn accurately.

MAP (HTML image map) OPTIONS

       Xfig version 3.2.3 and later saves and allows the user to edit comments for each Fig object.  The fig2dev
       map output language will produce an HTML image map using Fig objects that have href="some_html_reference"
       in their comments.  Any Fig object except compound objects  may  be  used  for  this.   Usually,  besides
       generating the map file, you would also generate a PNG file, which is the image to which the map refers.

       For example, you may have an xfig drawing with an imported image that has the comment href="go_here.html"
       and a box object with a comment href="go_away.html".  This will produce an image map file such  the  user
       may  click  on  the  image and the browser will load the "go_here.html" page, or click on the box and the
       browser will load the "go_away.html" page.

       After the map file is generated by fig2dev  you  will  need  to  edit  it  to  fill  out  any  additional
       information it may need.

       -b borderwidth
              Make blank border around figure of width borderwidth (1/72 inch).

METAFONT OPTIONS

       Fig2dev  scales  the  figure  by  1/8  before generating METAFONT code.  The magnification can be further
       changed with the -m option or by giving magnification options to mf.

       In order to process the generated METAFONT code, the mfpic macros must be installed  where  mf  can  find
       them. The mfpic macro package is available at any CTAN cite under the subdirectory: graphics/mfpic

       -C code
              Specify the starting METAFONT font code. The default is 32.

       -n name
              Specify the name to use in the output file.

       -p pen_magnification
              Specify  how  much the line width should be magnified compared to the original figure. The default
              is 1.

       -t top Specify the top of the whole coordinate system.  The default is ypos.

       -x xmin
              Specify the minimum x coordinate value of the figure (inches). The default is 0.

       -y ymin
              Specify the minimum y coordinate value of the figure (inches). The default is 0.

       -X xmax
              Specify the maximum x coordinate value of the figure (inches). The default is 8.

       -Y ymax
              Specify the maximum y coordinate value of the figure (inches). The default is 8.

METAPOST OPTIONS

       -d file
              Include file content as additional header.

       -i file
              Include file content via \input-command.

       -M     Multipage mode, generate one figure for each depth.

       -o     Old mode (no latex).

       -p number
              Adds the line "prologues:=number" to the output.

PIC OPTIONS

       -f font
              Set the default font used for text objects to font, where font is one of R (roman),  B  (bold),  I
              (italic), H (sans serif) or C (typewriter).  The default is R.

       -p ext Enables  the  use  of  certain  PIC  extensions  which  are  known to work with the groff package;
              compatibility with DWB PIC is unknown.  The extensions enabled by each option are:

           arc     Allow ARC_BOX i.e. use rounded corners
           line    Use the 'line_thickness' value
           fill    Allow ellipses to be filled
           all     Use all of the above
           psfont  Don't convert PostScript fonts generic type
                   (useful for files going to be Ditroff'ed for
                   and printed on PS printer). DWB-compatible.
           allps   Use all of the above (i.e. "all" + "psfont")

PICT2E OPTIONS

       PICT2E  is  an  enhancement  to  the  LaTeX   picture   environment.   It   is   enabled   by   inserting
       "\usepackage{pict2e}"  in  the  document  preamble.  Depending  on  the  content of the figure, it may be
       necessary to also include "\usepackage{color}" and "\usepackage{graphics}".  Figures  produced  with  the
       PICT2E  driver  can  be  processed with any LaTeX engine, e.g., LaTeX + dvips, LaTeX + dvipdfm, pdflatex,
       xelatex, ConTeX, etc.  Pattern fills are not supported by the PICT2E output language. The  PICT2E  driver
       renders  patterns by filling the respective area with the pen-color at 25% intensity, i.e., a 75% tint of
       the pen-color.  The PICT2E driver allows one to choose any font available to the LaTeX engine,  including
       PostScript fonts.

       -b borderwidth
              Make blank border around figure of width borderwidth*(1/72) inches.

       -C num Do  not  emit a \color-command for the color number num. (0 = black, 1 = blue, 2 = green - see the
              color chooser widget in Xfig).  By default, fig2dev does not issue a  \color-command  for  objects
              which  have  the  color  set to "Default" in xfig.  With this option, the "\color"-command is also
              omitted for objects having the color num.  The color of these objects, as well as of those  having
              the color set to "Default", is picked up from the including LaTeX-document.

              The  option  -C 0  is  particularly  useful.  By default, xfig starts with the color set to black.
              Then, fig2dev emits "\color{black}" commands, and  the  color-package  must  be  included  in  the
              document preamble.  For black text and black-and-white drawings, this is superfluous.

       -e     Do  not  try  to  be compatible with epic/eepic.  By default, you can include "\usepackage{pict2e,
              epic, eepic}" (in this order!)  in  the  document  preamble  and  mix  LaTeX  pictures  using  the
              epic/eepic  command set and pictures produced with the PICT2E output language within one document.
              With this option on, epic or eepic pictures can not be mixed with PICT2E-pictures.

              By default, fig2dev avoids the use of the "\circle" and "\oval"-commands,  which  are  defined  by
              epic,  in  lieu  of the "\circlearc"-command exclusive to pict2e. In addition, line widths are not
              only set using "\linethickness", but also with the  eepic-command  "\allinethickness"  (if  it  is
              defined).

       -E num Set encoding for text translation (0 = no translation, 1 = ISO-8859-1, 2 = ISO-8859-2; default 1).
              For instance, to use utf8-encoded text, first create a text object, then edit the text  using  the
              edit-button   in  xfig.  Convert  the  fig-file  to  pict2e  with  the  option  -E 0  and  include
              "\usepackage[utf8]{inputenc}" in the LaTeX file In xfig, the text typed in may  not  be  displayed
              correctly, but the document produced from the LaTeX file will show the same text as was typed in.

       -F     Do  not  set  the font family, series or shape.  By default, fig2dev sets the font family, series,
              shape, font size and baselineskip.  With this option on,  the  text  font  can  be  set  from  the
              including LaTeX-document, e.g., "\itshape \input{fig1.pict2e}".  See also -o (no font size).

       -f font
              Set the default font used for text objects to font.  The string font may be one of rm, bf, it, sf,
              tt, \rmfamily, \bfseries, \itshape, \sffamily, \ttfamily, or one of  the  35  standard  PostScript
              font names.  The default is \rmfamily.

       -i dir Prepend  the  string  dir  to graphics files included in the pict2e-picture.  For instance, having
              imported     "image.jpg"     in     xfig,     with     -i      '$HOME/Figures/'      the      code
              "\incudegraphics{$HOME/Figures/image.jpg}" will be generated.

       -o     Do not set the font size or baselineskip. Text will be rendered at the size that is in force where
              the pict2e-code is inserted into the LaTeX-document, e.g., "\small \input{fig1.pict2e}".  See also
              -F (no font properties).

       -O     Do  not quote characters special to TeX/LaTeX.  Useful to get, e.g., an italic x, not $x$, because
              it was forgotten to set the text-flag "special-text" in xfig.  This option  effectively  sets  the
              "special-text" flag for all text.

       -P     Pagemode, generate a stand-alone LaTeX-file as out-file. The document produced from the LaTeX-file
              will have the paper size equal to the figure's bounding box (but  see  the  -b  option  to  add  a
              margin).  The generated LaTeX-file calls the package "geometry.sty" to set the paper size.

       -R num Replace  arrowheads  num  by LaTeX-arrows ("\vector"). The number of an arrowhead ("Arrow Type" in
              xfig) can be found by opening the arrow chooser widget in xfig and counting the  arrows,  starting
              from  1.   For  instance,  to  replace filled triangle arrowheads with LaTeX \vector-commands, use
              -R 3.

       -r     Replace all arrows by LaTeX-arrows.

       -T     Only use TeX fonts, even where PostScript-fonts are specified.

       -v     Verbose mode. Write comment lines into the output file, usually naming the type of the object that
              is drawn.

       -w     Remove  the suffix from included graphics-files.  With this option on, fig2dev generates code that
              contains, e.g., "\includegraphics{fig1}", instead of "\includegraphics{fig1.eps}".

PICTEX OPTIONS

       In order to include PiCTeX pictures into a document, it is necessary to load the PiCTeX macros.

       PiCTeX uses TeX integer register arithmetic to generate curves, and so it is  very  slow.   PiCTeX  draws
       curves  by  \put-ing the psymbol repeatedly, and so requires a large amount of TeX's internal memory, and
       generates large DVI files.  The size of TeX's memory limits the number of plot symbols in a picture.   As
       a result, it is best to use PiCTeX to generate small pictures.

       -a     Anonymous mode. Do not write the user name into the output file.

       -E num Set  encoding  for  latex  text  translation  (0 = no translation, 1 = ISO-8859-1, 2 = ISO-8859-2;
              default 1).

       -f font
              Set the default font used for text objects to font, where font is one of rm, bf,  it,  sf  or  tt.
              The default is rm.

       -l dimen
              Set line thickness to dimen. Default "1pt".

       -p psymbol
              Set the psymbol.  Default "\makebox(0,0)[l]{\tencirc\symbol{'160}}".

       -r     Do  not  allow  rotated  text.  Otherwise,  files  with  PiCTeX macros and rotated text need to be
              processed with dvips.

GBX OPTIONS (Gerber, RS-247-X)

       Typically you will wish to set the y scale to -1.  See -g for more information.

       -d [mm|in]
              Output dimensions should be assumed to be  millimeters  (mm)  or  inches  (in).   The  default  is
              millimeters.

       -p [pos|neg]
              Select the image polarity.  For positive images lines drawn in the fig file will generate lines of
              material.  For negative images lines drawn in the  fig  file  will  result  in  removed  material.
              Consider  etching a chrome on glass transmission mask.  Drawing lines in the fig file and choosing
              'neg' will result in these lines being etched through the chrome, leaving transparent lines.

       -g <x scale>x<y scale>+<x offset>+<y offset>
              This controls the geometry of the output, scaling the dimensions as shown and applying  the  given
              offset.   Typically  you  will wish to set the y scale to -1, mirroring about the x axis.  This is
              because Gerber assumes the origin to be bottom left, while xfig selects top left.

       -f <n digits>.<n digits>
              This controls the number of digits of precision before and after the implied decimal point.   With
              -f 5.3 the following number 12345678 corresponds to 12345.678.  Whereas with -f 3.5 it corresponds
              to 123.45678.  The default  is  for  3  places  before  the  decimal  point  and  5  after.   This
              corresponds, to a range of 0 to 1m in 10 micron increments.

       -v     Output  comments  describing  the  type  of  objects  being  output.  The text appears as comments
              starting with ## on each line in the output file.

POSTSCRIPT, ENCAPSULATED POSTSCRIPT (EPS), and PDF OPTIONS

       With PostScript, xfig can be used to create multiple page figures.  Specify the -M option  to  produce  a
       multi-page  output.   For  posters, add -O to overlap the pages slightly to get around the problem of the
       unprintable area in most printers, then cut and paste the pages together.  Great for text with  very  big
       letters.

       The EPS driver has the following differences from PostScript:
           o  No  showpage  is  generated  because  the  output  is meant to be imported into another program or
           document and not printed
           o The landscape/portrait options are ignored
           o The centering option is ignored
           o The multiple-page option is ignored
           o The paper size option is ignored
           o The x/y offset options are ignored

       The EPS driver has the following two special options:

       -B 'Wx [Wy X0 Y0]'
              This specifies that the bounding box of the EPS file should have the width Wx and the  height  Wy.
              Note  that  it doesn't scale the figure to this size, it merely sets the bounding box.  If a value
              less than or equal to 0 is specified for Wx or Wy, these are set to the width/height  respectively
              of  the  figure.   Origin  is  relative  to  screen  (0,0)  (upper-left).   Wx,  Wy, X0 and Y0 are
              interpreted in centimeters or inches depending on the measure given in the fig-file.  Remember  to
              put either quotes (") or apostrophes (') to group the arguments to -B.

       -R 'Wx [Wy X0 Y0]'
              Same  as  the  -B option except that X0 and Y0 is relative to the lower left corner of the figure.
              Remember to put either quotes (") or apostrophes (') to group the arguments to -R.

       The PDF driver accepts all of the PostScript options, if the -P (pagemode)  option  is  given.   In  this
       case,  the  size  of  the  PDF  is the pagesize given in the file or set from the command line via the -z
       option.  Otherwise, if -P is not given, the PDF is cropped to the bounding box of the figure  (optionally
       with a blank border margin set by the -b option), and all of the EPS options are supported.

       Text  can  now  include  various  ISO-character  codes  above 0x7f, which is useful for language specific
       characters to be printed directly.  Not all ISO-characters are implemented.

       Color support: Colored objects created by Fig can be printed on a color postscript printer. There are  32
       standard  colors:  black,  yellow, white, gold, five shades of blue, four shades of green, four shades of
       cyan, four shades of red, five shades of magenta, four shades of brown, and  four  shades  of  pink.   In
       addition there may be user-defined colors in the file.  See the xfig FORMAT3.2 file for the definition of
       these colors.  On a monochrome printer, colored objects will be mapped into different grayscales  by  the
       printer.   Filled  objects  are printed using the given area fill and color.  There are 21 "shades" going
       from black to full saturation of the fill color, and 21 more "tints" from full saturation + 1  to  white.
       In addition, there are 16 patterns such as bricks, diagonal lines, crosshatch, etc.

       -A     Add an ASCII (EPSI) preview.  Not for PDF.

       -a     Anonymous mode. Do not write the user's login name into the output file.

       -b borderwidth
              Make blank border around figure of width borderwidth (1/72 inch).

       -C dummy_arg
              Add  a color *binary* TIFF preview for Microsoft products that need a binary preview.  See also -T
              (monochrome preview).  A dummy argument must be supplied for  historical  reasons.   Not  for  PDF
              output.

       -c     Center  the  figure  on  the  page.   The  centering may not be accurate if there are texts in the
              fig_file that extends too far to the right of other objects.

       -e     Put the figure against the edge (not centered) of the page.  Not available in EPS.

       -F     Use correct font sizes (points, 1/72 inch) instead of the traditional size that xfig/fig2dev uses,
              which is 1/80 inch.  The corresponding xfig command-line option is -correct_font_size.

       -f font
              Set  the  default  font  used  for  text  objects  to  font,  where font is one of the 35 standard
              PostScript font names.  The default is Times-Roman.

       -g color
              Use color for the background.

       -l dummy_arg
              Generate figure in landscape mode.  The dummy argument is ignored, but must appear on the  command
              line for reasons of compatibility.  This option will override the orientation specification in the
              file (for file versions 3.0 and higher).  Not available in EPS.

       -M     Generate multiple pages if figure exceeds paper size.  Not available in EPS.

       -N     Convert all colors to grayscale.

       -n name
              Set the Title part of the PostScript output to name.  This is useful when  the  input  to  fig2dev
              comes from standard input.

       -O     When  used  with -M, overlaps the pages slightly to get around the problem of the unprintable area
              in most printers.  Not available in EPS.

       -p dummy_arg
              Generate figure in portrait mode.  The dummy argument is ignored, but must appear on  the  command
              line for reasons of compatibility.  This option will override the orientation specification in the
              file (for file versions 3.0 and higher).  This is the default for Fig  files  of  version  2.1  or
              lower.  Not available in EPS.

       -T     Add  a  monochrome  *binary*  TIFF preview for Microsoft products that need a binary preview.  See
              also -C (color preview).  Not available for PDF output.

       -x offset
              Shift the figure in the X direction by offset PostScript points (1/72  inch).   A  negative  value
              shifts the figure to the left and a positive value to the right.  Not available in EPS.

       -y offset
              Shift  the  figure  in  the Y direction by offset points (1/72 inch).  A negative value shifts the
              figure up and a positive value down.  Not available in EPS.

       -z papersize
              Set the papersize.  Not available in EPS.
              Available paper sizes are:

                  Letter    (8.5" x 11" also A),
                  Legal     ( 11" x 14")
                  Ledger    ( 11" x 17"),
                  Tabloid   ( 17" x 11", really Ledger in Landscape mode),
                  A         (8.5" x 11" also Letter),
                  B         ( 11" x 17" also Ledger),
                  C         ( 17" x 22"),
                  D         ( 22" x 34"),
                  E         ( 34" x 44"),
                  A9        ( 37 mm x  52 mm),
                  A8        ( 52 mm x  74 mm),
                  A7        ( 74 mm x 105 mm),
                  A6        (105 mm x 148 mm),
                  A5        (148 mm x 210 mm),
                  A4        (210 mm x 297 mm),
                  A3        (297 mm x 420 mm),
                  A2        (420 mm x 594 mm),
                  A1        (594 mm x 841 mm),
                  A0        (841 mm x1189 mm),
                  B10       ( 32 mm x  45 mm),
                  B9        ( 45 mm x  64 mm),
                  B8        ( 64 mm x  91 mm),
                  B7        ( 91 mm x 128 mm),
                  B6        (128 mm x 182 mm),
                  B5        (182 mm x 257 mm),
                  B4        (257 mm x 364 mm),
                  B3        (364 mm x 515 mm),
                  B2        (515 mm x 728 mm),
                  B1        (728 mm x1030 mm),
                  B0        (1030mm x1456 mm).

PSTEX and PDFTEX OPTIONS

       The pstex and pdftex languages are a variant of ps which suppress text that has the text flag "TeX  Text"
       set.   The  pstex_t  and  pdftex_t languages have the complementary behavior: they generate only the text
       that has the "Tex Text" flag set and the commands necessary to position this text. They also generate the
       commands necessary to overlay the PostScript or PDF file generated using pstex/pdftex.  These two drivers
       can be used to generate a figure which combines the flexibility of PostScript graphics  with  LaTeX  text
       formatting of text flagged as "TeX Text".

       The pstex and pdftex drivers accept the same options that the EPS driver accepts.

       -n name
              Set  the  Title  part  of the PostScript output to name.  This is useful when the input to fig2dev
              comes from standard input.

PSTEX_T and PDFTEX_T OPTIONS

       The pstex_t and pdftex_t languages produce only the text flagged with the "TeX Text" flag,  the  commands
       necessary  to  position  this  text,  and  the  commands  necessary to overlay the PostScript or PDF file
       generated using pstex or pdftex (see above).

       -E num Set encoding for latex text translation (0 no translation, 1 ISO-8859-1, 2 ISO-8859-2; default 1)

       -F     Don't set the font face, series, and style; only set it's size and the baselineskip.  By  default,
              fig2dev  sets all 5 font parameters when it puts some text. The disadvantage is that you can't set
              the font from your LaTeX document. With this option on, you can  set  the  font  from  your  LaTeX
              document (like "\sfshape \input picture.eepic").

       -p file
              specifies the name of the PostScript file to be overlaid.  If not set or its value is null then no
              PS file will be inserted.

PSTricks OPTIONS

       The PSTricks driver provides full LaTeX text and math formatting for  XFig  drawings  without  overlaying
       separate  outputs  as  in  the PSTEX methods.  The output matches the quality of output of the PostScript
       driver except for text, where the Latex font selection mechanism is  used  as  for  other  fig2dev  LaTeX
       drivers.  In addition, text is rendered black, although font color-changing LaTex code can be embedded in
       the drawing.  The generated PSTricks code is meant to  be  readable.   Each  command  stands  alone,  not
       relying  on  global  option  state  variables.  Thus the user can easily use XFig to rough out a PSTricks
       drawing, then finish by hand editing.

       To use the driver's output, give the command "\usepackage{pstricks}"  in  your  document  preamble.   The
       graphicx  and pstricks-add packages may also be required.  The former is used for bitmap graphics and the
       second for complex line styles and/or hollow PSTricks arrows (with the -R 1  option).   The  driver  will
       tell  you  which  packages  are  needed.  In the document body, include the figure with "\input{pstfile}"
       where pstfile.tex is the output file.  Use the XFig special flag to have text passed as-is to LaTeX.  For
       non-special  text, the same mechanism as the LaTeX and epic driver mechanism is used to match font specs,
       but this is imprecise.

       Known bugs and limitations.
              PSTricks support for join styles is version dependent. Raw postscript is inserted with  "\pstVerb"
              for  old  versions  when other than angle joins are needed.  The -t option controls this behavior.
              PSTricks does not support rotated ellipses directly, so a rput command is emitted that rotates and
              locates  a  horizontal  ellipse.   This  makes  a problem with hatch patterns, which are moved and
              rotated along with the ellipse.  Hatch rotation is fixed by a counter-rotation, but the origin  is
              not  adjusted,  so  registration  with  adjacent hatch patterns will be incorrect.  Flipped bitmap
              graphics use an undocumented feature of the graphicx package: a negative height  flips  the  image
              vertically.   This  appears to work reliably.  However, you may want to flip graphics with another
              program before including them in Xfig drawings just to be sure.  With the -p  option,  the  driver
              attempts  to  convert non-EPS pictures to EPS with the TeX distribution's bmeps program, but bmeps
              does not know about very many file formats including gif.

       -f font
              Set the default font used for text objects to font, where font is one of rm, bf,  it,  sf  or  tt.
              The default is rm.

       -G dummy_arg
              Draws  a  standard PSTricks grid in light gray, ignoring the size parameters, numbered in PSTricks
              units.

       -l weight
              Sets a line weight factor that is multiplied by the actual Fig line width.  The default value  0.5
              roughly matches the output of the PS driver.

       -n 0|1|2|3
              Sets  environment  type.   Default  0  creates  a  \picture  environment with bounding box exactly
              enclosing the picture (but see -x and -y ).  A 1 emits bare PSTricks commands with no  environment
              at  all,  which  can  be  used  with  \input{commands} inside an existing \pspicture.  A 2 emits a
              complete LaTeX document.  A 3 also emits a  complete  LaTeX  document  but  attempts  to  set  the
              PSTricks unit to fit a 7.5 by 10 inch (portrait aspect) box.

       -P     Shorthand for -n 3.

       -p dir Attempts  to  run  the  bmeps  program  to  translate  picture  files to EPS, which is required by
              PSTricks.  The translated files go in dir , which must already exist (the driver will  not  create
              it).  Moreover,  (BIG  CAVEAT  HERE)  the driver overwrites files with impunity in this directory!
              Don't put your stuff here.  The  includegraphics  commands  in  the  output  file  refer  to  this
              directory.   Even  if  the  -p option is not used, includegraphics commands follow this convention
              with the default directory ./eps .  In this case, the user must do the conversions  independently.
              The  bmeps  program is part of the standard TeX distribution. It converts the following formats to
              EPS: png jpg pnm tif.  You can see the bmeps command with the -v option.

       -R 0|1|2
              Sets arrow style.  With the default style 0, Fig arrows are converted to lines and polygons.  With
              style  1, the Fig arrowhead dimensions are converted to PSTricks arrowhead dimensions and PSTricks
              arrowhead options are emitted.  Hollow arrows will require the  additional  package  pstricks-add.
              With style 2, PSTricks arrowhead options are emitted with no dimensions at all, and arrowhead size
              may be controlled globally with psset.

       -S scale
              Scales the image according to the same convention as the EPIC driver, i.e., to size scale/12.

       -t version
              Provides the driver with PSTricks version number so output can match expected LaTeX input.

       -v     Print verbose warnings and extra comments in the output file.  Information provided includes  font
              substitution  details, the bmeps commands used for picture conversion, if any, and one comment per
              Fig object in the output.

       -x marginsize
              Adds marginsize on the left and right of the PStricks bounding box.  By default, the  box  exactly
              encloses the image.

       -y marginsize
              Adds  marginsize  on the top and bottom of the PStricks bounding box.  By default, the box exactly
              encloses the image.

       -z 0|1|2
              Sets font handling option.  Default option 0 attempts to honor Fig font names and  sizes,  finding
              the  best  match with a standard LaTeX font.  Option 1 sets LaTeX font size only.  Option 2 issues
              no font commands at all.

TEXTYL OPTIONS

       -f font
              Set the default font used for text objects to font, where font is one of rm, bf,  it,  sf  or  tt.
              The default is rm.

       -l lwidth
              Set the line thickness. lwidth must be a value between 1 and 12.

TIKZ OPTIONS

       TIKZ  is  a  powerful frontend to the Portable Graphics Format (PGF) developed by Till Tantau, now at the
       University of Lübeck.  TIKZ was developed to be as platform-independent as possible, i.e., tikz-code  can
       be processed with plain TeX, pdftex, xetex, LaTeX, ConTeX, pdflatex, lualatex, or combinations of LaTeX +
       dvips, LaTeX + dvipdfm or others.  The TIKZ-code emitted by fig2dev tries to maintain  this  portability.
       For  instance,  a tikz-picture is commenced  with \tikzpicture (TeX-style), to not exclude any processing
       engine.  However, the stand-alone file produced with the -P option must be processed with a LaTeX-engine.
       In addition, font-commands may require a LaTeX engine.

       -b borderwidth
              Make blank border around figure of width borderwidth*(1/72) inches.

       -C num Do  not  emit a \color-command for the color number num. (0 = black, 1 = blue, 2 = green - see the
              color chooser widget in Xfig).  By default, fig2dev does not issue a  \color-command  for  objects
              which  have  the  color  set to "Default" in xfig.  With this option, the "\color"-command is also
              omitted for objects having the color num.  The color of these objects, as well as of those  having
              the color set to "Default", is picked up from the including document.

       -E num Set encoding for text translation (0 = no translation, 1 = ISO-8859-1, 2 = ISO-8859-2; default 1).
              For instance, to use utf8-encoded text, first create a text object, then edit the text  using  the
              edit-button   in   xfig.   Convert  the  fig-file  to  tikz  with  the  option  -E 0  and  include
              "\usepackage[utf8]{inputenc}" in the LaTeX file (not necessary when using xelatex).  In  xfig, the
              text  typed  in may not be displayed correctly, but the document produced from the LaTeX file will
              show the same text as was typed in.

       -F     Do not set the font family, series or shape.  By default, fig2dev sets the  font  family,  series,
              shape,  font size and baselineskip.  As a side effect, this requires the New Font Selection Scheme
              (NFSS) of LaTeX.  With this option on, the text font can be set from the including document, which
              may be TeX or LaTeX.  See also -o (no font size).

       -f font
              Set the default font used for text objects to font.  The string font may be one of rm, bf, it, sf,
              tt, \rmfamily, \bfseries, \itshape, \sffamily, \ttfamily, or one of  the  35  standard  PostScript
              font names.  The default is \rmfamily.

       -i dir Prepend  the  string  dir  to  graphics  files included in the tikz-picture.  For instance, having
              imported  "image.jpg"  in  xfig,  with  -  i  '$HOME/Figures/'  the   code   "\pgfimage[width=...,
              height=...]{$HOME/Figures/image.jpg}" will be generated.

       -O     Do  not quote characters special to TeX/LaTeX.  Useful to get, e.g., an italic x, not $x$, because
              it was forgotten to set the text-flag "special-text" in xfig.  This option  effectively  sets  the
              "special-text" flag for all text.

       -o     Do not set the font size or baselineskip. Text will be rendered at the size that is in force where
              the tikz-code is inserted into the document, e.g., "\small\input fig1.tikz".  See also -F (no font
              properties).

       -P     Pagemode, generate a stand-alone LaTeX-file as out-file. The document produced from the LaTeX-file
              will have the paper size equal to the figure's bounding box (but  see  the  -b  option  to  add  a
              margin).  The generated LaTeX-file calls the package "geometry.sty" to set the paper size.

       -T     Only use TeX fonts, even where PostScript-fonts are specified.

       -v     Verbose mode. Write comment lines into the output file, usually naming the type of the object that
              is drawn.

       -W     Do not emit code at the beginning of the file that allows one to set the figure  width  or  height
              from  the  including  TeX  document.   Otherwise, e.g., "\newdimen\XFigwidth\XFigwidth=\linewidth"
              would scale the following figures to the line width.

       -w     Remove the suffix from included graphics-files.  With this option on, fig2dev generates code  that
              contains, e.g., "\pgfimage{fig1}" instead of "\pgfimage{fig1.pdf}".

TK and PTK OPTIONS (tcl/tk and Perl/tk)

       Arc-boxes  are not supported for the tk output language, and only X bitmap pictures are supported because
       of the canvas limitation in tk.
       Picture objects are not scaled with the magnification factor for tk output.
       Because tk scales canvas items according to the X display resolution, polygons, lines, etc. may be scaled
       differently than imported pictures (bitmaps) which aren't scaled at all.

       -g color
              Use color for the background.

       -l dummy_arg
              Generate  figure in landscape mode.  The dummy argument is ignored, but must appear on the command
              line for reasons of compatibility.  This option will override the orientation specification in the
              file (for file versions 3.0 and higher).

       -p dummy_arg
              Generate  figure  in portrait mode.  The dummy argument is ignored, but must appear on the command
              line for reasons of compatibility.  This option will override the orientation specification in the
              file  (for  file  versions  3.0  and higher).  This is the default for Fig files of version 2.1 or
              lower.

       -P     Generate canvas of full page size instead of using the bounding box of the figure's  objects.  The
              default is to use only the bounding box.

       -w     Wrap  the figure with code in order to generate a complete perl file.  That is, you can do fig2dev
              -L ptk -w f.fig f.pl; perl f.pl and a widget pops up that shows the graphics  contained  in  f.pl.
              Only available for ptk output.

       -z papersize
              Set the paper size.  See the POSTSCRIPT OPTIONS for available paper sizes.  This is only used when
              the -P option (use full page) is used.

TPIC OPTIONS

       -f font
              Set the default font used for text objects to font.  The default is rm.  The string  font  can  be
              one  of  rm,  bf,  it,  sf,  tt,  avant,  avantcsc, avantd, avantdi, avanti, bookd, bookdi, bookl,
              booklcsc, bookli, chanc, cour, courb, courbi, couri, helv, helvb, helvbi, helvc, helvcb,  helvcbi,
              helvci,  helvcsc,  helvi,  pal,  palb, palbi, palbu, palc, palcsc, pali, palsl, palu, palx, times,
              timesb, timesbi, timesc, timescsc, timesi, timessl or timesx.

SEE ALSO

       xfig(1), pic(1), pic2fig(1), transfig(1)

BUGS and RESTRICTIONS

       Please send bug reports, fixes, new features etc. to:
       thomas.loimer@tuwien.ac.at

COPYRIGHT

       Copyright (c) 1991 Micah Beck
       Parts Copyright (c) 1985-1988 Supoj Sutantavibul
       Parts Copyright (c) 1989-2015 Brian V. Smith
       Parts Copyright (c) 2015-2018 by Thomas Loimer

       Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose
       is  hereby  granted  without  fee, provided that the above copyright notice appear in all copies and that
       both that copyright notice and this permission notice appear in  supporting  documentation.  The  authors
       make  no  representations about the suitability of this software for any purpose.  It is provided "as is"
       without express or implied warranty.

       THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING  ALL  IMPLIED  WARRANTIES  OF
       MERCHANTABILITY  AND  FITNESS,  IN  NO  EVENT  SHALL  THE  AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
       CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,  WHETHER  IN
       AN  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
       OR PERFORMANCE OF THIS SOFTWARE.

AUTHORS

       Micah Beck
       Cornell University
       Sept 28 1990

       and Frank Schmuck (then of Cornell University)
       and Conrad Kwok (then of U.C. Davis).

       Drivers contributed by
       Jose Alberto Fernandez R. (U. of Maryland)
       and Gary Beihl (MCC)

       Color support, ISO-character encoding and poster support by
       Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)

       Modified from f2p (fig to PIC), by the author of Fig
       Supoj Sutanthavibul (supoj@sally.utexas.edu)
       University of Texas at Austin.

       MetaFont driver by
       Anthony Starks (ajs@merck.com)

       X-splines code by
       Carole Blanc (blanc@labri.u-bordeaux.fr)
       Christophe Schlick (schlick@labri.u-bordeaux.fr)
       The initial implementation was done by C. Feuille, S. Grobois, L. Maziere and L.  Minihot  as  a  student
       practice (Universite Bordeaux, France).

       Japanese text support for LaTeX output written by T. Sato (VEF00200@niftyserve.or.jp)

       The tk driver was written by
       Mike Markowski (mm@udel.edu) with a little touch-up by Brian Smith

       The CGM driver (Computer Graphics Metafile) was written by
       Philippe Bekaert (Philippe.Bekaert@cs.kuleuven.ac.be)

       The EMF driver (Enhanced Metafile) was written by
       Michael Schrick (m_schrick@hotmail.com)

       The GBX (Gerber) driver was written by
       Edward Grace (ej.grace@imperial.ac.uk).