
XFIG(1)			   OpenBSD Reference Manual		       XFIG(1)



NAME
       xfig - Facility for Interactive Generation of figures under X11
       Version 3.2.4

SYNOPSIS
       xfig [options] [file]

DESCRIPTION
       Xfig is a menu-driven tool that allows the user to draw and manipulate
       objects interactively under the X Window System.	 It runs under X
       version 11 release 4 or higher and requires a two- or three-button
       mouse.  file specifies the name of a file to be edited.	The objects in
       the file will be read at the start of xfig.

       The bulk of the documentation fori xfig is in an HTML-based reference
       guide.  See the Help menu in xfig or point your browser at
       Doc/html/index.html (provided with the xfig distribution, usually in
       the Doc/www directory).	There are both English and Japanese versions.

       When using a two-button mouse use the <Meta> key and the right button
       at the same time to effect the action of the middle button.

       Xfig is available from http://www.xfig.org .

       The TransFig package is used when printing or exporting the output from
       xfig.  The fig2dev program from the TransFig package is automatically
       called by xfig as a back-end processor to produce various types of
       output:

       LaTeX, Metafont, PostScript or Encapsulated PostScript, tk (tcl/tk tool
       command language/tool kit package), GIF, JPEG, PCX, PNG, PPM, TIFF,
       XBM, XPM, AutoCAD Slide, IBM-GL (HP/GL), Pic PiCTeX, box, epic, eepic
       and eepicemu.

       See man fig2dev for all options.

       The TransFig package is available from http://www.xfig.org .

OPTIONS
       -help
	      Print all command-line options for xfig and quit.

       -a[llownegcoords]
	      Allow panning into the negative region of the canvas.  This is
	      the default

       -bal[loon_delay] msec
	      Cause popup information balloons to be delayed by msec
	      milliseconds.  The default is 500 milliseconds.

       -bol[d] font
	      Cause the font used for displaying the file name and
	      confirmation messages to be font (default = 8x13bold).

       -butt[on] font
	      Cause the font used for most buttons to be font (default =
	      6x13).

       -but_[per_row] number
	      Specify the number of buttons wide the mode panel should be.
	      This is useful in conjunction with the -pheight parameter to
	      reduce the canvas height for small screens.

       -cbg color
	      Use color as the background color for the canvas.	 If you want
	      to set the background of everything in xfig (e.g. menus, etc.)
	      use the general -bg option.

       -center
	      Set the print option to print the figure centered on the page.
	      This is the default.

       -centim[ers]
	      Make centimeters the unit of choice.  See also -metric.

       -cfg color
	      Use color as the default color for objects.  If you want to set
	      the foreground of everything in xfig (e.g. menus, etc.) use the
	      general -fg option.

       -correct_font_size
	      Normally, fig2dev uses 1/80 inch for font size increments (for
	      historical reasons), instead of the more proper ``points'' (1/72
	      inch) that xfig uses.  This option makes xfig call fig2dev with
	      the -F option to make it use points (1/72 inch).

       -deb[ug]
	      Turn on debugging mode.  Prints various debugging messages like
	      font names etc.

       -dep[th]
	      Choose depth of visual desired.  Your server must support the
	      desired visual and depth chosen.	Use xdpyinfo to see what
	      visuals and depths are supported.	 See also the -visual option.

       -donta[llownegcoords]
	      Don't allow panning into the negative region of the canvas.  The
	      default is to allow panning in the negative region.

       -dontshowb[alloons]
	      Prevents xfig from popping up the information balloons.  See
	      also -showballoons.

       -dontshowl[engths]
	      Don't show lengths of lines as they are being drawn.  This is
	      the default.

       -dontshowz[erolines]
	      Don't show axis zero lines on the canvas.	 The default is to
	      show them.

       -dontsw[itchcmap]
	      Prevents xfig from switching to a private colormap if there
	      aren't enough colors available in the default colormap.  See
	      also -max_image_colors.

       -enc[oding] encoding
	      Encode character set using encoding when exporting LaTeX text.
	      The default is 1.	 This is used for the ISO-8859 encoding of
	      character sets.  Allowed values are 0 (no encoding), 1
	      (ISO-8859-1) or 2 (ISO-8859-2).

       -exportL[anguage] language
	      Specifies the default language to be used for when exporting a
	      fig file.	 Choices are:

	      Name		Language
	      -------------------------------------------------
	      Vector formats:
	      box		LaTeX box (figure boundary)
	      latex		LaTeX picture
	      epic		LaTeX picture + epic macros
	      eepic		LaTeX picture + eepic macros
	      eepicemu		LaTeX picture + eepicemu macros
	      pictex		PiCTeX macros
	      hpl		HPGL (IBMGL)
	      eps		Encapuslated PostScript
	      eps_ascii		Encapuslated PostScript with ASCII preview
	      eps_mono_tiff	Encapuslated PostScript with monochrome binary (TIFF) preview
	      eps_color_tiff	Encapuslated PostScript with color binary (TIFF) preview
	      ps		PostScript
	      pdf		PDF (Portable Document Format)
	      pstex		Combined PS/LaTeX (both PS and LaTeX parts)
	      pdftex		Combined PDF/LaTeX (both PDF and LaTeX parts)
	      textyl		Textyl special commands
	      tpic		TPIC
	      pic		PIC
	      mf		MF (MetaFont)
	      mp		MP (MetaPost)
	      mmp		MMP (Multi-MetaPost)
	      cgm		CGM (Computer Graphics Meta file)
	      bcgm		Binary CGM (Computer Graphics Meta file)
	      emf		Enhanced Meta file)
	      tk		Tk (of the tcl/tk fame)
	      svg		SVG (Scalable Vector Graphics (XML variant))

	      Bitmap formats:
	      gif		GIF
	      jpeg		JPEG (JFIF)
	      pcx		PCX
	      png		PNG
	      ppm		PPM (portable pixmap package)
	      sld		(AutoCad slide)
	      tiff		TIFF
	      xbm		X11 Bitmap
	      xpm		X11 Pixmap (XPM3 package)

	      -------------------------------------------------


       -export_m[argin] width
	      Set the size of the border margin around the figure for
	      exporting to bitmap, PostScript, Encapsulated PostScript, or
	      HTML MAP formats.	 This is in units of pixels (1/80th inch).
	      The default is 0.

       -fli[pvisualhints]
	      Flip left/right mouse indicator messages for mice whose buttons
	      have been switched.  The default is to NOT flip the messages.

       -flu[shleft]
	      Set the print option to print the figure flush left.  The
	      default is to center the figure on the page.

       -free[hand_resolution] resolution
	      Set the resolution of the freehand drawing mode to resolution
	      pixels.  This is the number of pixels the mouse must move before
	      xfig adds another point to the object being drawn.

       -geom[etry] [WxH][+X+Y]
	      You may use the -geometry option or resource to size and/or
	      position the xfig window, or you may use -pwidth and/or -pheight
	      to specify the canvas size in inches or centimeters.  If you use
	      the -geom option to make the xfig window smaller than the
	      default, you may have to use the -but_per_row option to tell
	      xfig to put 3 or 4 buttons per row on the left mode panel.

       -gh[ostscript] postscript-interpreter
	      Select the PostScript (tm) interpreter of your choice.  The
	      default is ghostscript (gs).  This is needed when importing
	      Encapsulated PostScript files.

       -grid_c[olor] color
	      Draw the grid on the canvas in this color (default: red).

       -grid_u[nit] unit
	      Only used when in inches mode to choose between showing
	      fractions or decimal inches in the rulers and grid.  Any of the
	      following may be used to force decimal inches: "ten", "tenth",
	      "10, "1/10".  If any other value is used for this option, the
	      rulers will show 1/16 inch divisions.

       -hidd[entext]
	      Start xfig with the hidden text mode for text objects.  The
	      Hidden attribute is used for figures that will be used with
	      LaTeX and is applicable only to the display of the document in
	      xfig.  It means that the text itself is not shown onscreen, but
	      only the string ``<text>''.  This is to keep long sequences of
	      LaTeX formatting commands from making the screen messy and hard
	      to read.	The default for the Hidden flag is off.

       -dontshowd[epthmanager]
	      Hide the depth manager panel.  The default is to show the panel.

       -icon_[view]
	      Show the library objects as icons.  This is the default.	The
	      other mode is -list_view.

       -iconG[eometry] +X+Y
	      Specifies the position for the icon.

       -im[age_editor] editor
	      Specify bitmap editor to use when ``Edit Image'' button is
	      pressed in Picture Object panel.

       -inc[hes] (or-imperial)
	      Make inches the unit of choice.  This is the default.

       -ins[tallowncmap]
	      Install own colormap. Normally, xfig uses the current colormap.

       -internalBW width
	      Use lines of width width between all buttons and panels (default
	      = 1).

       -international
	      Switch on international support (mainly Japanese and Korean),
	      users of ISO Latin 1 (ISO-8859-1) probably should not use this,
	      therefore the international support is switched off by default
	      for locales using ISO-8859-1* codesets. For all other locales
	      this option is already used by default.

       -jpeg[_quality] quality
	      Set the quality factor for exporting to the jpeg format.	The
	      default is 75.

       -k[eyFile] compose-key-file
	      Use compose-key-file instead of CompKeyDB for compose (meta) key
	      database.	 If there are no ``/''s in the name, the file must
	      reside in the xfig library directory, $XFIGLIBDIR, usually
	      /usr/local/lib/X11/xfig.	If there are any ``/''s in the name it
	      is taken as is (not relative to $XFIGLIBDIR).  If there is a
	      leading ``~/'' in the string then the ``~'' is expanded to the
	      user's home directory.

       -lan[dscape]
	      Make xfig come up in landscape mode (10.5" x 8").	 This is the
	      default; however as the orientation is stored with Fig files,
	      when you load a Fig file the orientation will change as
	      required.	 This is only true for files of version 3.0 or higher.
	      See also -portrait.

       -lat[exfonts]
	      Start xfig with LaTeX font selection.  Normally, the PostScript
	      fonts are available as the default.  This flag selects the LaTeX
	      fonts to start.

       -le[ft]
	      Change the position of the side panel window to the left of the
	      canvas window.  This is the default.

       -library_d[ir] directory
	      Specify directory where Fig object libraries are located.	 There
	      may be sub-directories there and sub-sub-directories, etc.

       -library_i[con_size] size
	      Specify the size of the icons shown for library objects.	The
	      default is 60 pixels, with the minimum being 40 and the maximum
	      being 120.

       -lis[t_view]
	      Show the library objects as a list of names. The default mode is
	      -icon_view.

       -mag[nification] mag
	      Set export and print magnification in %.

       -max[_image_colors] numcols
	      Limit the number of colors used for imported images to numcols
	      (default 64).

       -me[tric]
	      Make centimeters the unit of choice.  The option -centimeters
	      may also be used.

	      After xfig is started you may change the units from metric to
	      imperial or vice versa from a popup menu available by pressing
	      mouse button 3 in the units box where the two rulers meet.

       -mo[nochrome]
	      Use black and white only.

       -mu[ltiple]
	      Sets multiple page mode for print or export. See also -single.

       -noo[verlap]
	      When exporting in multiple page mode, causes no overlap from
	      page to page.  This is the default.  See also -overlap.

       -nor[mal] font
	      Cause the font used for the message window to be font.  This
	      font is also used on the canvas when the selected font is not
	      available in an X11 font (default = 6x13).

       -nosc[alablefonts]
	      Disables use of the X11R5 or OpenWindows scalable fonts.	You
	      might want to use this for debugging.

       -nosp[lash]
	      Don't show the startup splash screen.  The default is to show it
	      ( -splash ).

       -not[rack]
	      Turn off cursor (mouse) tracking arrows.

       -ov[erlap]
	      When exporting in multiple page mode, causes overlap from page
	      to page of about 10%.  See also -nooverlap.

       -pag[eborder] color
	      Draw the page border on the canvas in this color (default light
	      blue).  The page border is turned on by the -showpageborder
	      option (resource Fig.showpageborder), and shows the edges of the
	      current export paper size.

       -pap[er_size] size
	      Set the initial paper size for Export and Print.	Choices are

	      Option	 Paper	    Size
	      ---------------------------------
	      letter	 Letter	    8.5in x 11in
	      legal	 Legal	    8.5in x 14in
	      tabloid	 Tabloid    17in x 11in
	      a		 ANSI A	    8.5in x 11in
	      b		 ANSI B	    11in x 17in
	      c		 ANSI C	    17in x 22in
	      d		 ANSI D	    22in x 34in
	      e		 ANSI E	    34in x 44in
	      a9	 ISO A9	    37mm x 52mm
	      a8	 ISO A8	    52mm x 74mm
	      a7	 ISO A7	    74mm x 105mm
	      a6	 ISO A6	    105mm x 148mm
	      a5	 ISO A5	    148mm x 210mm
	      a4	 ISO A4	    210mm x 297mm
	      a3	 ISO A3	    297mm x 420mm
	      a2	 ISO A2	    420mm x 594mm
	      a1	 ISO A1	    594mm x 840mm
	      a0	 ISO A0	    840mm x 1189mm
	      b10	 JIS B10    32mm x 45mm
	      b9	 JIS B9	    45mm x 64mm
	      b8	 JIS B8	    64mm x 91mm
	      b7	 JIS B7	    91mm x 128mm
	      b6	 JIS B6	    128mm x 182mm
	      b5	 JIS B5	    182mm x 257mm
	      b4	 JIS B4	    257mm x 364mm
	      b3	 JIS B3	    364mm x 515mm
	      b2	 JIS B2	    515mm x 728mm
	      b1	 JIS B1	    728mm x 1030mm
	      b0	 JIS B0	    1030mm x 1456mm
	      ---------------------------------

	      Note that this doesn't affect the size of the drawing canvas.
	      Use the -pheight and -pwidth options for that.

       -ph[eight] height
	      Make the xfig canvas height high (where height is either cm or
	      in, depending on the -metric setting).

       -po[rtrait]
	      Make xfig come up in portrait mode (8.5" x 9").  See note about
	      landscape mode.

       -pw[idth] width
	      Make the xfig canvas width wide (where width is either cm or in,
	      depending on the -metric setting).

       -righ[t]
	      Change the position of the side panel window to the right of the
	      canvas window (default: left).

       -rigi[d]
	      Start xfig with the rigid text mode for text objects.  The Rigid
	      attribute forces text to remain the same size even if inside a
	      compound object that is scaled up or down.  The default is off.

       -ru[lerthick]
	      Set the height(width) of the top(side) rulers in pixels.	The
	      default (and minimum) is 24.

       -scala[blefonts]
	      Allows use of the X11R5 or OpenWindows scalable fonts (this is
	      the default).  If the scalable fonts aren't available xfig will
	      automatically switch to non-scaling fonts.

       -scale_factor scale
	      Scale every figure read in by this value.	 This is useful in
	      conjunction with the -update option to do batch scaling of
	      figures.

       -showa[llbuttons]
	      Show all the xfig indicator buttons instead of only those
	      relevant to the current drawing mode.  Normally, the buttons
	      line width, area-fill, grid mode, text size, etc. are only
	      visible when they are relevant to the current drawing mode.  The
	      -showallbuttons option makes all of the indicator buttons
	      visible at all times.  This takes up more screen real estate,
	      but allows the user to see all settable parameters.

       -showb[alloons]
	      Forces xfig to pop up the information balloons when the mouse
	      passws over a button. This is the default. See also
	      -dontshowballoons .

       -showd[epthmanager]
	      Show the depth manager panel.  This panel lets one show or hide
	      objects at various depths.  This is the default.

       -showl[engths]
	      Makes xfig show the lengths of lines being drawn, in red text
	      near the line itself.  Also, when points are moved or added.  In
	      addition, imagine a triangle formed with the line segment as the
	      hypotenuse, and a vertical and horizontal line forming the other
	      two sides.  These lines and their lengths are also drawn in red
	      as the point is moved or added.  This mode is ignored when
	      drawing in freehand mode.
	      This flag may be toggled by pressing <Meta>i (default).

       -shown[ums]
	      With this option, xfig will draw all objects with a red number
	      next to each vertex.  This is generally only useful for
	      debugging.

       -showp[ageborder]
	      Makes xfig show the border of the current paper size in the
	      color specified by the -pageborder option (default: light blue).

       -showz[erolines]
	      Show axis zero lines on the canvas.  This is the default

       -si[ngle]
	      Sets single page mode for print or export.  This is the default.
	      See also -multiple.

       -sm[ooth_factor] factor
	      Enable smoothing when exporting to the bitmap formats (e.g. GIF,
	      PNG, etc.). The allowed values are 0 (no smoothing), 2 or 4
	      (most smoothing).	 This parameter is passed to ghostscript in
	      the -dTextAlphaBits -dGraphicsAlphaBits options to smooth the
	      figure.

       -spec[ialtext]
	      Start xfig with the special text mode for text objects.  Special
	      text means that special characters in the string are not
	      specially processed but are passed directly to LaTeX.  This is
	      most useful for writing LaTeX equations.	If this flag is not
	      set, then the backslash character '\' is changed to the
	      \backslash command, a brace '{' is turned into a brace command
	      \{, etc.

       -spel[lcheckcommand] command
	      Use command for the external spell checking program when using
	      the spell check/search/replace popup.  The string command should
	      include the string ``%s'' which is replaced by a temporary
	      filename.	 Default is ``spell %s''.

       -spinner_d[elay] msec
	      The delay (in milliseconds) before the spinner will
	      automatically count up or down when the button is pressed.
	      Spinners are the (numeric) text widgets with an up- and down-
	      arrow, which when clicked, cause the value to be
	      incremented/decremented.	The default is 500 milliseconds.

       -spinner_r[rate] msec
	      The rate (in milliseconds) at which the spinner will count when
	      the up- or down-arrow is pressed.

       -startfi[llstyle] stylenumber
	      Set the starting fill style for area fill (-1 to 21).

       -startfo[ntsize] pointsize
	      Set the default font size for text objects (default = 12pt).

       -startg[ridmode] modenumber
	      Set the starting grid mode (0 to 3).  Mode 0 is no grid.	In
	      imperial (inches) mode, grid mode 1 is 1/4 inch, mode 2 is 1/2
	      inch and mode 3 is 1 inch.  In metric mode, grid mode 1 is 5mm,
	      mode 2 is 1cm and mode 3 is 2cm.

       -startla[texFont] font
	      Set the starting font name for LaTeX fonts.

       -startli[newidth] width
	      Set the starting line width.

       -startpo[snmode] modenumber
	      Set the starting point positioning mode (0 to 4) In imperial
	      (inches) mode, positioning mode 0 is ``any'', mode 1 is 1/16
	      inch, mode 2 is 1/4 inch, mode 3 is 1/2 inch and mode 4 is 1
	      inch.  In metric mode, mode 0 is ``any'', mode 1 is 1mm, mode 2
	      is 5mm, mode 3 is 10mm and mode 4 is 20mm.

       -startp[sFont] font
	      Set the starting font name for PostScript fonts.

       -startt[extstep] stepsize
	      Set the starting text step.

       -ta[blet]
	      Specifies that xfig should use the input tablet instead of the
	      mouse for drawing.  You must have the XInputExtension in your X
	      server and an input tablet for this to work.  Also, you must
	      modify the Imakefile to include the USETAB and TABLIB variables.

       -track
	      Turn on cursor (mouse) tracking arrows (default).

       -tran[sparent_color] color_number
	      Make the transparent color for GIF export color_number.  This
	      number is the color number according to the xfig color panel,
	      starting at 0 (black) and ending at 31 (gold), or may be a user-
	      defined color number, which is 32 or higher.

       -update file [ file ... ]
	      Run xfig in an "update" mode, where it will read each Fig file
	      specified on the command line and write it out to the original
	      file, in the current file format for the version of xfig being
	      run.  The original Fig file will be preserved with the suffix
	      .bak attached to the name.
	      In this mode, xfig doesn't connect the X server, so no window is
	      opened, and it exits when finished.

       -users[cale] scale
	      Set the multiplier for displayed line lengths etc.  This factor
	      is multiplied by the actual length, radius or diameter of the
	      object currently being drawn on the canvas.  It is useful for
	      making scale drawings, where e.g. 1 inch = 1 foot (userscale =
	      12.0) or 1cm = 1m (userscale = 100.0).

       -useru[nit] units
	      The units string is printed with the length information when
	      drawing objects.	For example if the userscale = 1.0 and the
	      userunit = ft then a line which is 3 inches long on the canvas
	      would be displayed as ``length = 3 ft'' when it is being drawn.

	      After xfig is started you may change the userscale and the
	      userunit from a popup menu available by pressing mouse button 3
	      in the units box where the two rulers meet.

       -visual visualname
	      Use visualname as the visual for xfig.  The names are TrueColor
	      (case is not important), StaticColor, DirectColor, StaticGray,
	      GrayScale and PseudoColor.  xfig uses the default visual unless
	      this is specified.  Your server must support the desired visual.
	      Use xdpyinfo to see what visuals and depths are supported.  See
	      also the -depth option.

       -zoom zoomscale
	      Set the starting zoom scale.



X RESOURCES and DEFAULTS
       The overall widget name(Class) is xfig(Fig).  These resources
       correspond to the command line arguments:

    Name		Type	Default		Command-line equivalent
    -------------------------------------------------------------------
    allownegcoords	boolean true		-allownegcoords (true),
						-dontallownegcoords (false)
    axislines		string	pink		-axislines
    balloon_delay	integer 500 (ms)	-balloon_delay
    boldFont		string	8x13bold	-bold
    but_per_row		integer 2		-but_per_row
    buttonFont		string	6x13		-button
    canvasbackground	string	white		-cbg
    canvasforeground	string	black		-cfg
    correctfontsize	boolean false		-correctfontsize
    debug		boolean false		-debug
    depth		integer *		-depth
    dontswitchcmap	boolean false		-dontswitchcmap
    euc_encoding	boolean false		(n/a)
    encoding		integer 1		-encoding
    exportLanguage	string	eps		-exportLanguage
    export_margin	integer 0		-export_margin
    flipvisualhints	boolean false		-flipvisualhints
    flushleft		boolean false		-flushleft (true),
						-center (false)
    freehand_resolution integer 25		-freehand_resolution
    grid_color		string	black		-grid_color
    grid_unit		string	1/16 (inch)	-grid_unit
				0.1 (metric)
    hiddentext		boolean false		-hiddentext
    icon_view		boolean true		-icon_view (true),
						-list_view (false)
    image_editor	string	xv		-image_editor
    inches		boolean true		-inches (true),
						-imperial (true),
						-centimeters (false),
						-metric (false)
    installowncmap	boolean false		-installowncmap
    internalborderwidth integer 1		-internalBW
    international	International		booleanfalse-international
    jpeg_quality	integer 75		-jpeg_quality
    justify		boolean false		-left (false),
						-right (true)
    keyFile		string	CompKeyDB	-keyFile
    landscape		boolean true		-Landscape (true),
						-landscape (true),
						-Portrait (false),
						-portrait (false)
    latexfonts		boolean false		-latexfonts
    library_dir		string	~/xfiglib	-library_dir
    magnification	float	100		-magnification
    max_image_colors	integer 64		-max_image_colors
    monochrome		boolean false		-monochrome
    multiple		boolean false		-multiple
    normalFont		string	6x13		-normal
    overlap		boolean true		-overlap (true),
						-nooverlap (false)
    pageborder		string	lightblue	-pageborder
    paper_size		string	Letter (inch)	-paper_size
				A4 (metric)
    pheight		float	8.5 (landscape) -pheight
				9.5 (portrait)
    pwidth		float	11 (landscape)	-pwidth
				8.5 (portrait)
    rigidtext		boolean false		-rigid (true)
    rulerthick		integer 24		-rulerthick
    scalablefonts	boolean true		-scalablefonts (true),
						-noscalablefonts (false)
    scale_factor	float	1.0		-scale_factor
    showallbuttons	boolean false		-showallbuttons
    showaxislines	boolean true		-showaxislines (true),
						-dontshowaxislines (false)
    showballoons	boolean true		-showballoons (true),
						-dontshowballoons (false)
    showdepthmanager	boolean true		-showdepthmanager (true),
						-dontshowdepthmanager (false)
    showlengths		boolean false		-showlengths (true),
						-dontshowlengths (false)
    shownums		boolean false		-shownums (true),
						-dontshownums (false)
    showpageborder	boolean true		-showpageborder (true),
						-dontshowpageborder (false)
    single		boolean true		-single
    smooth_factor	integer 0		-smooth_factor
    specialtext		boolean false		-specialtext
    splash		boolean true		-splash (true),
						-nosplash (false)
    spellcheckcommand	string	spell %s	-spellcheckcommand
    spinner_delay	integer 500 (ms)	-spinner_delay
    spinner_rate	integer 100 (ms)	-spinner_rate
    startfillstyle	integer 0		-startfillstyle
    startfontsize	float	12		-startfontsize
    startgridmode	integer 0		-startgridmode
    startlatexFont	string	Default		-startlatexFont
    startlinewidth	integer 1		-startlinewidth
    startposnmode	integer 1		-startposnmode
    startpsFont		string	Times-Roman	-startpsFont
    starttextstep	float	1.2		-starttextstep
    tablet		boolean false		-track,
    trackCursor		boolean true		-track (true),
						-notrack (false)
    transparent_color	integer -2 (none)	-transparent_color
    userscale		float	1.0		-userscale
    userunit		string	in (inches)	-userunit
				cm (metric)
    visual		string	*		-visual
    zoom		float	1.0		-zoom

    * Default visual and depth depend on the X server. Use xdpyinfo to see what visuals
    and depths are supported.
    -------------------------------------------------------------------


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

       When reporting a bug, please first check if the problem is mentioned in
       the FAQ section of the HTML files (xfig Help menu).

       If it is not mentioned there, be sure to report the operating system
       you are using (e.g. SunOS 4.1.3), type of X server and version
       (OpenWindows 3, X11R6.4, XFree86 3.2.2, etc) and color depth (e.g.
       8bpp, 16bpp), and most importantly the version of xfig or fig2dev that
       is having the problem.

       It is also VERY useful to me if you can provide a stack trace from a
       debugger such as gdb, dbx, ups, etc, if the bug causes xfig to crash.

       Because of the difference of some fonts in some X servers and the
       PostScript fonts on printers, text alignment can be problematic.

       Not all operations employ smart redrawing of objects which are altered
       as a by product of the operation.  You may need to use Redraw in these
       cases.

       Some servers do not allow bitmaps/pixmaps taller than the screen height
       or wider than the screen width.	That is why there is a limit on the
       width of the top ruler and height of the side ruler.  If you need
       wider/taller rulers AND your server allows bigger pixmaps, you may
       define MAX_TOPRULER_WD and/or MAX_SIDERULER_HT in your Imakefile in the
       DEFINES line.  For example, to have a maximum top ruler width of 1160
       pixels, add -DMAX_TOPRULER_WD=1160 to your DEFINES line in the
       Imakefile.

       If the image is panned or the xfig window iconified and de-iconified
       during the middle of an operation (e.g. while drawing a line), the
       picture will be distorted.  This can be corrected using Redraw after
       the operation is complete.

       When zoomed very large, the length of dashes in dashed lines will top
       out at 255 pixels long.	This is due to a restriction in X that the
       dash list is defined by char (255 pixels maximum for a dash).  The
       figure will print correctly, however.

       When you do a copy/rotate with multiple copies, only the creation of
       the last object can be undone with the Undo button.

       Modifications to text using the popup search/update/replace/spell check
       panel cannot be undone.

       See the README file for troubleshooting.

SEE ALSO
       fig2dev(1) (TransFig package)

       gs(1) (Ghostscript PostScript previewer)

ACKNOWLEDGEMENT
       (From the original author, Supoj Sutanthavibul): Many thanks goes to
       Professor Donald E. Fussell who inspired the creation of this tool.

       (From current maintainer Brian Smith): Thanks to all the users who have
       contributed to xfig, especially Paul King who, besides adding many
       features, revamped the look and feel which became version 2.1.

COPYRIGHT
       Original Copyright (c) 1985 by Supoj Sutanthavibul
       Parts Copyright (c) 1994-1999 by Brian V. Smith
       Parts Copyright (c) 1991 by Paul King
       Other Copyrights may be found in various files


       Any party obtaining a copy of these files is granted, free of charge, a
       full and unrestricted irrevocable, world-wide, paid up, royalty-free,
       nonexclusive right and license to deal in this software and
       documentation files (the "Software"), including without limitation the
       rights to use, copy, modify, merge, publish and/or distribute copies of
       the Software, and to permit persons who receive copies from any such
       party to do so, with the only requirement being that this copyright
       notice remain intact.

       Note that although I work at Lawrence Berkeley National Laboratory
       (LBNL) I don't speak for LBNL nor do I represent LBNL with respect to
       my work on TransFig and xfig, nor does LBL make any representations
       about the suitability of this software for any purpose.

       Here is the legal part:

       THE LAWRENCE BERKELEY NATIONAL LABORATORY DISCLAIMS 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.


       PostScript is a trademark of Adobe Systems Incorporated.

       Parts Copyright (C) 1989 by Jef Poskanzer.
       Copyright notice for pbmplus code:

       Permission to use, copy, modify, and distribute this
       software and its documentation for any purpose and without
       fee is hereby granted, provided that the above copyright
       notice appear in all copies and that both that copyright
       notice and this permission notice appear in supporting
       documentation.  This software is provided ``as is'' without
       express or implied warranty.

FILES
       CompKeyDB
	       Data base of compose (meta) key sequences for 8-bit characters.
	       Must be installed in $(XFIGLIBDIR) with ``make install'', or
	       may be specified with command line option -keyFile or X toolkit
	       resource keyFile.  See the Imakefile.

       /usr/lib/X11/xfig
	       This directory contains the html documentation, the above
	       mentioned CompKeyDB file, and a directory of libraries
	       containing Fig objects such as electrical symbols, logic
	       symbols, etc.

       Fig.ad and Fig-color.ad
	       Application defaults files which are automatically installed in
	       the system app-defaults directory with the make install
	       command.

       Doc/FORMAT3.2
	       Description of Fig file format.

       README  Installation instructions and troubleshooting.

       CHANGES Description of bug fixes/new features.


AUTHORS
       Many people have contributed to xfig.  Here is a list of the people who
       have contributed the most (in chronological order):

       Version 1:


	   Original author:
	   Supoj Sutanthavibul, University of Texas at Austin

	   The LaTeX line drawing modes were contributed by:
	   Frank Schmuck, Cornell University

	   Original X11 port by:
	   Ken Yap, Rochester

	   Variable window sizes, cleanup of X11 port, right hand side panel:
	   Dana Chee, Bellcore

	   Cleanup of color port to X11 by:
	   John T. Kohl, MIT

       Version 2.0:


	   Area fill, multiple line thicknesses, multiple fonts and font
	   sizes, bottom panel, line style/thickness, (and anything else that
	   wasn't written by the others) by:
	   Brian Smith
	   (standard disclaimer applies)
	   (bvsmith@lbl.gov)

	   Popup change-object menu by:
	   Jon Tombs
	   Frank Schmuck

	   Zooming and panning functions, shift key select mechanism by:
	   Dieter Pellkofer
	   Henning Spruth

	   Depth feature by:
	   Mike Lutz

	   Cut/Paste by:
	   Tom Tkacik

       Version 2.1:


	   Indicator panel, file menu popup, print menu popup, panning with
	   rulers, mouse function window, regular polygon, rubberbanding of
	   circles/ellipses, filled splines on canvas, dashed/dotted splines
	   on canvas, update button, arbitrary angle rotation of objects,
	   alignment in compound, object scaling, constrained copy/move,
	   corner markers for compound, context sensitive corner markers,
	   smarter redraw, undo for compound and point move for boxes, cancel
	   object creation, point positioning to three resolutions, TransFig
	   scalable text, hidden text, special text, save of figure on crash
	   by:

	   Paul King (king@cs.uq.oz.au)
	   with help from:
	   Brian Smith and Micah Beck (beck@cs.utk.edu)

	   Encapsulated PostScript importing by:
	   Brian Boyter

	   Pan/zoom with ctrl key/mouse by:
	   Henning Spruth

	   International characters by:
	   Herve Soulard

	   Directory Browser based on XDir by:
	   Win Treese, Digital Equipment Corporation

	   Rotated ellipses by:
	   James Tough, Dept. of Computer Science, Heriot-Watt University,
	   Scotland

	   Rotated text from the xvertext package by:
	   Alan Richardson, Space Science Centre, School of MAPS, University
	   of Sussex

	   Popup scale menu and dynamic switching between inches and cm by:
	   Paul King (king@cs.uq.oz.au)

	   Extensive man page formatting revisions by:
	   David W. Sanderson

	   Display Postscript code for IBM RS/6000 by:
	   Dave Hale (dhale@green.mines.colorado.edu)

       Version 3.0:


	   New arrowhead types, separate pen/fill colors, new file protocol,
	   more colors with extended color popup panel, new arc style, new
	   fill patterns (bricks, etc), new line join and cap styles, export
	   offset and file load offset, XPM import, XBM import and export (and
	   anything else that wasn't written by the others) by:
	   Brian Smith
	   (Note: the color popup panel was based on xcoloredit by Richard
	   Hesketh)


	   GIF header reading code by:
	   David Koblas from the giftoppm part of the pbmplus package

	   XPM export code (using XPM3 libraries) by:
	   Karel van Houten (K.H.C.vanHouten@research.ptt.nl)

	   Higher figure resolution (1200dpi) by:
	   Ross Martin (martin@trcsun3.eas.asu.edu)

	   Color quantization using neural network by:
	   Anthony Dekker (dekker@ACM.org)
	   [NEUQUANT Neural-Net quantization algorithm by Anthony Dekker,
	   1994.  See ``Kohonen neural networks for optimal colour
	   quantization'' in ``Network: Computation in Neural Systems'' Vol. 5
	   (1994) pp 351-367.  for a discussion of the algorithm.]

	   Floyd-Steinberg algorithm for dithering color images on monochrome
	   displays lifted from the Pbmplus package by Jef Poskanser.

	   rotate/flip objects around/about selected anchor point and multiple
	   copies of objects by:
	   Uwe Bonnes (bon@lte.e-technik.uni-erlangen.de)

	   Input tablet extension by:
	   Greg LaCoste (greg@seismo.do.usbr.gov)

       Version 3.1:


	   The only difference between protocol version 3.0 and version 3.1 is
	   that the position of the ``magnet'' has been shifted by 14 fig
	   units.  In the 2.1 and older versions of xfig the grid was in
	   multiples of 5 fig units, but they were on intervals 4, 9, 14, 19,
	   etc.	 When version 3.0 was created, coordinates were simply
	   multiplied by the ratio of the resolutions (1200/80 = 15) so values
	   like 4 became 60 instead of 74 ((4+1)*15 - 1).

	   The JPEG import/export code uses the Independent JPEG Group
	   software (see jpeg/README for details)

	   Image browser, editor and screen capture features by:
	   Jim Daley (jdaley@cix.compulink.co.uk)

       Version 3.2:


	   The changes to the version 3.2 file protocol are the addition of
	   the paper size, print/export magnification, single/multiple page
	   indicator and a transparent color name used for GIF export to the
	   header of the file.
	   The other difference in the version 3.2 protocol is the
	   mathematical model used for splines. The new version uses X-splines
	   which allows the user to mix interpolation and approximation points
	   in a same curve. More precisely, it means that an X-spline curve is
	   neither an interpolated spline nor an approximated one, it is BOTH
	   (the behaviour of each point is controlled by one single parameter
	   called ``shape factor''). For additional information about X-
	   splines, see:

	     "X-Splines: A Spline Model Designed for the End User"
	     by C. Blanc and C. Schlick, Proceedings of SIGGRAPH'95
	     http://dept-info.labri.u-bordeaux.fr/~schlick/DOC/sig1.html

	   Caveat: Because previous spline models (quadratic B-splines and
	   Bezier with hidden points) are no longer supported, curves that are
	   present in version 3.1 and older files are automatically converted
	   to X-splines.  This translation is only an approximation process.
	   It means that the converted curves are not exactly the same as the
	   original ones. Though they are usually very close, some hand-
	   fitting may be needed in some pathological cases.

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

	   Open/close compound feature written by
	   Bill Taylor (bill@mainstream.com)

	   Library feature written by
	   Stephane Mancini (mancini@elecsrv.enst.fr) (object preview by Brian
	   V. Smith)

	   The library objects in the Electrical and Logic libraries were done
	   by
	   Peter Hiscocks (phiscock@ee.ryerson.ca)

	   The library objects in the Computer, Networks, and Hospital-
	   Equipment libraries were extracted from the clipart example files
	   by
	   Bill Chimiak (chim@bgsm.edu)


       Version 3.2.3 and newer:


	   Please see the CHANGES file for credits for newer releases.

NOTES
       Many bug fixes/cleanups etc. by a host of faithful users

       See the CHANGES file for all the credits

       The TransFig package was written by Micah Beck and is maintained by
       Brian Smith



			     Xfig 3.2.4 (Dec 2002)		       XFIG(1)
