










































FIG2DEV(1)                  General Commands Manual                 FIG2DEV(1)



NAME
       fig2dev - translates Fig code to various graphics languages


SYNOPSIS
       fig2dev -L language [ -m mag ] [ -f font ] [ -s fsize ] [ 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-ori-
       ented 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,
              epic,  eepic, eepicemu, emf, eps, gbx (Gerber beta driver), gif,
              ibmgl, jpeg, latex, map (HTML  image  map),  mf  (MetaFont),  mp
              (MetaPost),  mmp  (Multi-MetaPost),  pcx, pdf, pdftex, pdftex_t,
              pdftex_p, pic, pictex, png, ppm, ps,  pstex,  pstex_t,  pstex_p,
              pstricks,  ptk  (Perl/tk),  shape (LaTeX shaped paragraphs), sld
              (AutoCad slide format), svg  (beta  driver),  textyl,  tiff,  tk
              (tcl/tk), tpic, xbm and xpm.

              Notes:
              dvips
               and  xdvi  must  be compiled with the tpic support (-DTPIC) for
              epic, eepic and tpic to work.
              You must have ghostscript  and  ps2pdf,  which  comes  with  the
              ghostscript  distribution  to  get the pdf output and the bitmap
              formats (png, jpeg, etc.), and the netpbm (pbmplus)  package  to
              get gif, xbm, xpm, and sld output.


       -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 range-
              list may be a list of comma-separated numbers  or  ranges  sepa-
              rated  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 calcualtion 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.


       -f font
              Set the default font used for text objects to font.  The default
              is Roman; the format of this option depends on the graphics lan-
              guage in use.  In TeX-based languages, the font is the  base  of
              the  name  given in lfonts.tex, for instance "cmr" for Roman, or
              "tt" for teletype.  In PostScript, it is any font name known  to
              the printer or interpreter. For Gerber it has no effect.


       -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/16:1/2in" will draw a thin
              line every 1/16 inch (0.0625 inch) and 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, and bitmap (GIF, JPEG,
              etc) drivers for now.


       -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 size
              Set the default font size (in points) 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 lan-
              guage, as described below.


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.

       -b dummyarg
              Generate binary output (dummy argument required after the "-b").


       -r     Position arrowheads for CGM viewers that display rounded  arrow-
              heads.  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.


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.


EPIC OPTIONS
       EPIC is an enhancement to LaTeX picture drawing  environment.   It  was
       developed  by  Sunil Podar of Department of Computer Science in S.U.N.Y
       at Stony Brook.

       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  Califor-
       nia, Davis.

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


       -A 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)


       -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 param-
              eters 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").

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

              This option can be used only when fig2dev was compiled with NFSS
              defined.


       -l width
              Use  "\thicklines"  when width of the line is 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. The additional
              text inserted in the beginning and at the end  of  the  file  is
              controlled  by the configuration parameter "Preamble" and "Post-
              amble".


       -R     Allow rotated text. Rotated text will be set using the  \rotate-
              box  command.   So, you will need to include "\usepackage{graph-
              ics}" in the preamble of your LaTeX document.

              If this option is not set, then rotated text will be  set  hori-
              zontally.



       -S scale
              Set  the  scale  to  which  the figure is rendered.  This option
              automatically sets the magnification and size to scale / 12  and
              scale respectively.


       -t stretch
              Set  the  stretch factor of dashed lines to sretch.  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 (hinlines), and thick lines
              (hicklines), if a line width of more than  one  is  selected  in
              xfig.


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

              When variable line width option is enabled, "\thinlines" command
              is still used when line width is less than LineThick. One poten-
              tial 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 the those lines you want  to
              be drawn in "\thinlines"  to 0.

              Due  to  this problem, Variable line width VarWidth is defaulted
              to be false.



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


       -a     Select  ISO A4 (ANSI A) paper size if the default is ANSI A (ISO
              A4) paper size.


       -c     Generate instructions for an IBM 6180 Color Plotter with  (with-
              out) 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-sparated list - xll,yll,xur,yur -  with
              no spaces between them.


       -f file
              Load  text  character specifications from the table in the fonts
              file.  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).


       -m mag,x0,y0
              The magnification may appear as the first  element  in  a  comma
              separated  list - mag,x0,y0 - where the second and third parame-
              ters specify an offset in inches.


       -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.

       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 poly-
       gons.  Fig2dev may be installed for plotters with or without  the  IBM-
       GEC.  The -c option selects the alternate instruction set.


OPTIONS COMMON TO ALL BITMAP FORMATS
       -b borderwidth
              Make blank border around figure of width borderwidth.


       -F     Use correct font sizes (points, 1/72 inch) instead of the tradi-
              tional 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 ghost-
              script 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" fac-
              tor.  Valid values are 0-100, with the default being 75.



LATEX OPTIONS
       -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)


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

       -v     Verbose mode.

       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 used for
       this.  Usually, besides generating the map file, you would also  gener-
       ate 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.



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  avail-
       able at any CTAN cite under the subdirectory: graphics/mfpic


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

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

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

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

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

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

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

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


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


       -I file
              Include file content as additional header.


       -o     Old mode (no latex).


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



PIC OPTIONS
       -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")


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 repeat-
       edly, and so requires a large amount of TeX's internal memory, and gen-
       erates  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.


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


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  mate-
              rial.   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  cor-
              responds  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.

       -i [on|off]
              Controls  the  output of comments describing the type of objects
              being output.  The text appears as comments starting with ##  on
              each line in the output file.  By default this is on.


POSTSCRIPT, ENCAPSULATED POSTSCRIPT (EPS), and PDF OPTIONS
       With PostScript, xfig can be used to create multiple page figures Spec-
       ify 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 unprint-
       able area in most printers, then cut and paste the pages together.  Due
       to  memory  limitations  of  most laser printers, the figure should not
       have large imported images (bitmaps). Great for text with very big let-
       ters.

       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 uses all the PostScript options.

       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 col-
       ors.  On a monochrome printer, colored objects will be mapped into dif-
       ferent 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 satu-
       ration + 1 to white.  In  addition,  there  are  16  patterns  such  as
       bricks, diagonal lines, crosshatch, etc.

       -A     Add an ASCII (EPSI) preview.

       -b borderwidth
              Make blank border around figure of width borderwidth.
              Not available in EPS.


       -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.

       -c     option centers 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     option  puts  the  figure against the edge (not centered) of the
              page.  Not available in EPS.


       -F     Use correct font sizes (points) 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.

       -l dummy_arg
              Generate figure  in  landscape  mode.   The  dummy  argument  is
              ignored, but must appear on the command line for reasons of com-
              patibility.  This option will override the orientation  specifi-
              cation 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 com-
              patibility.   This option will override the orientation specifi-
              cation 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).


       -x offset
              shift the figure in the X direction by offset units (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 units (1/72
              inch).  A negative value shifts the figure up and a posi-
              tive value down.
              Not available in EPS.

       -z papersize
              Sets 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"),
                  "A4" (21  cm x  29.7cm),
                  "A3" (29.7cm x  42  cm),
                  "A2" (42  cm x  59.4cm),
                  "A1" (59.4cm x  84.1cm),
                  "A0" (84.1cm x 118.9cm),
                  and "B5" (18.2cm x 25.7cm).

PSTEX OPTIONS
       The pstex language is a variant of ps which suppresses formatted
       (special)  text.   The  pstex_t  language  has the complementary
       behavior: it generates only the LaTeX special text and the  com-
       mands  necessary  to  position  special text, and to overlay the
       PostScript file generated using pstex.  These two drivers can be
       used  to  generate  a  figure  which combines the flexibility of
       PostScript graphics with LaTeX text formatting of special text.


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


       -g color
              Use color for the background.

       -n name
              sets  the  Title  part  of the PostScript output to name.
              This is useful when the input to fig2dev comes from stan-
              dard input.

PSTEX_T OPTIONS
       The  pstex_t  language  produces only the LaTeX special text and
       the commands necessary to position special text, and to  overlay
       the PostScript file generated using pstex.  (see above)


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


       -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  selec-
       tion  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  "\usepack-
       age{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 pst-
       file.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  ver-
              sions  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  incor-
              rect.   Flipped  bitmap graphics use an undocumented fea-
              ture of the graphicx package: a negative height flips the
              image  vertically.   This appears to work reliably.  How-
              ever, 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.


       -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 pic-
              ture (but see -x and -y ).  A 1 emits bare PSTricks  com-
              mands  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 com-
              plete 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  trans-
              lated  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 direc-
              tory!  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,  includegrpahics  com-
              mands  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 arrow-
              head  dimensions and PSTricks arrowhead options are emit-
              ted.  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 con-
              trolled 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  out-
              put 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.


PSTEX_P and PDFTEX_P OPTIONS
       The  pstex_p  language has the same intention as the combination
       of pstex and pstex_t.  The only reason to use  pstex_p  is  that
       you have partially overlayed texts.  pstex_p splits the Fig file
       concerning the depths of existing texts. Because of it's  neces-
       sary  to  get the resulting size of the figure for the pdf docu-
       ment you have to specify the target document format (i.e.  using
       pstex_p rsp. pdftex_p).
       Two files results by using this language:

       1)  A bash script for creating and removing the necessary graph-
          ics files.  Extension: .create



       2) The latex code which includes all graphics files and  special
          texts. Content is put to stdout.


       The pstex_p driver has the following special options:


       -p basename
          specifies  the  basename  of the files to be created (see (1)
          above). This option is mandatory.

       -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)

       -l lwidth
          Sets the threshold between LaTeX  thin  and  thick  lines  to
          lwidth pixels.  LaTeX supports only two different line width:
          \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.

       -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").



TK and PTK OPTIONS (tcl/tk and Perl/tk)
       -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 orienta-
              tion 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 orienta-
              tion 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.

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


SEE ALSO
       [x]fig(1), pic(1) pic2fig(1), transfig(1)

BUGS and RESTRICTIONS
       Please send bug reports, fixes, new features etc. to:
       xfig-bugs@epb1.lbl.gov (Brian V. Smith)

       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 reso-
       lution, polygons, lines, etc. may  be  scaled  differently  than
       imported pictures (bitmaps) which aren't scaled at all.

       Rotated  text  is only supported in the IBM-GL (HP/GL) and Post-
       Script (including eps) languages.

       In pdftex_p language fig2dev can not determine the  exact  sizes
       of  the special texts set by pdflatex afterwards. If these texts
       are bigger than expected the calculated bounding  box  might  be
       too  small so that some texts passes over the figure boundaries.
       If this happen you have to  put  an  invisible  rectangle  (line
       width 0) around the text or the entire figure.


COPYRIGHT
       Copyright (c) 1991 Micah Beck
       Parts Copyright (c) 1985 Supoj Sutantavibul
       Parts Copyright (c) 1989-1999 Brian V. Smith

       Permission to use, copy, modify, distribute, and sell this soft-
       ware 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  permis-
       sion 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  SOFT-
       WARE,  INCLUDING  ALL  IMPLIED WARRANTIES OF MERCHANTABILITY AND
       FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE  FOR  ANY  SPE-
       CIAL,  INDIRECT  OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSO-
       EVER 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 Bor-
       deaux, 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).

       The  PSTEX_P  and  PDFTEX_P  drivers (overlayed LaTeX texts) was
       written by
       Michael Pfeiffer (p3f@gmx.de)



                          Version 3.2.5e August 2013                FIG2DEV(1)
