xenial (1) fig2dev.1.gz

Provided by: transfig_3.2.5.e-5ubuntu0.1_amd64 bug

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

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
       California, Davis.

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

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

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

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

              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 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 "\thinlines" 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 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 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 (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-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 parameters 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
       polygons.  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 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.

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

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

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

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

       -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 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.  Due to memory  limitations  of
       most laser printers, the figure should not have large imported images (bitmaps). 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 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 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.

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

       -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 positive 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 commands 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 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 name
              sets  the  Title  part of the PostScript output to name.  This is useful when the input to fig2dev
              comes from standard 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 translation, 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 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.

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

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 necessary to get the resulting size of the figure for the pdf
       document 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 graphics 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 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.

       -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 resolution, 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 PostScript (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 (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 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).

       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)