fig2dev man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

FIG2DEV(1)							    FIG2DEV(1)

       fig2dev - translates Fig code to various graphics languages

       fig2dev -L language [ -m mag ] [ -f font ] [ -s fsize ] [ other options
       ] [ fig-file [ out-file ] ]

       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

       Fig (Facility for Interactive Generation of figures) is	a  screen-ori‐
       ented  tool which allows the user to draw and manipulate objects inter‐
       actively.  Various versions of Fig run under the Suntools/Sunview  win‐
       dow  environment and under version 11 of the X Windows System.  Fig2dev
       is compatible with Fig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and 3.2.

       -L     Set the output graphics  language.   Valid  languages  are  acad
	      (AutoCad	slide format), box, epic, eepic, eepicemu, gif, ibmgl,
	      jpeg, latex, mf (METAFONT), pcx,	pic,  pictex,  png,  ppm,  ps,
	      pstex, pstex_t, textyl, tiff, tk (tcl/tk), tpic, xbm and xpm.

	      Note  that dvips and xdvi must be compiled with the tpic support
	      (-DTPIC) for epic, eepic and tpic to work.

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

       -m     Set the magnification at which the figure is  rendered  to  mag.
	      The default is 1.0.

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

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

       -V     Print the program version number only.

       other options
	      The other options are specific to the choice  of	graphics  lan‐
	      guage, as described below.

       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‐

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

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

       -v     Include comments in the output file.

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

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

       -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

       -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 potential prob‐
       lem 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

       IBM-GL  (International Business Machines Graphics Language) is compati‐
       ble 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     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     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.

       -l     Load area fill line patterns from	 the  table  in	 the  patterns
	      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     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     Load plotter pen specifications from the table in the pens 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).

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

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

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

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

       -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

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

       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.

       With  PostScript,  Fig  can be used to create large posters. The figure
       will be created by printing multiple pages which can be glued together.
       Simply  specify	the  -M option to produce a multi-page output.	Due to
       memory limitations of most laser printers, the figure should not be too
       complicated. Great for text with very big letters.

       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.

       -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

       -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).
	      This option is only honored when not using the  -P  option  (add
	      showpage).   This	 is  because  the  figure  doesn't  need to be
	      rotated when generating Encapsulated PostScript (EPS).

       -M     Generate multiple pages if figure exceeds paper size.

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

       -P     indicates that the figure describes a full page which  will  not
	      necessarily  be  inserted	 into  a  document,  but  can  be sent
	      directly to a PS printer.	 This ensures that a showpage  command
	      is inserted at the end of the figure.

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

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

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

       -z papersize
	      Sets the papersize. Available paper sizes are:
		  "Letter" (8.5" x 11" also "A"),
		  "Legal" (11" x 14" also "A")
		  "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).

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

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

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

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

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

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

       There are no TeXtyl-specific 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

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

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

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

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

       -q image_quality
	      use  the integer value image_quality for the JPEG "Quality" fac‐
	      tor.  Valid values are 0-100.

       -t color
	      Use color for the transparent color in the GIF file.  This  must
	      be  specified  as	 a  six-digit  hexadecimal RGBvalue with the #
	      sign, e.g. #ff0000 (Red).

       There are no tpic-specific options.

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

       Please send bug reports, fixes, new features etc. to: (Brian V. Smith)

       Arc-boxes are not supported for the tk output language, and only X bit‐
       map pictures are supported because of the canvas limitation in tk.

       Picture	objects	 are  not  scaled with the magnification factor for tk

       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.

       Copyright (c) 1985 Supoj Sutantavibul
       Copyright (c) 1991 Micah Beck

       Permission to use, copy, modify, distribute, and sell this software and
       its documentation for any purpose is hereby granted without  fee,  pro‐
       vided  that  the	 above	copyright notice appear in all copies and that
       both that copyright notice and this permission notice  appear  in  sup‐
       porting	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.


       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 (

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

       MetaFont driver by
       Anthony Starks (

       X-splines code by
       Carole Blanc (
       Christophe Schlick (
       The  initial  implementation  was  done	by  C. Feuille, S. Grobois, L.
       Maziere and L. Minihot as  a  student  practice	(Universite  Bordeaux,
       France).	 The tk driver was written by:
       Mike Markowski ( with a little touch-up by Brian Smith

	     Release 3.2 Patchlevel 1 (Protocol 3.2) July 1, 1998   FIG2DEV(1)

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net