1
2XFIG(1)                     General Commands Manual                    XFIG(1)
3
4
5

NAME

7       xfig - Facility for Interactive Generation of figures under X11
8       Version 3.2.4
9

SYNOPSIS

11       xfig [options] [file]
12

DESCRIPTION

14       Xfig  is a menu-driven tool that allows the user to draw and manipulate
15       objects interactively under the X Window System.  It runs under X  ver‐
16       sion  11 release 4 or higher and requires a two- or three-button mouse.
17       file specifies the name of a file to be edited.   The  objects  in  the
18       file will be read at the start of xfig.
19
20       The  bulk  of the documentation fori xfig is in an HTML-based reference
21       guide.   See  the  Help  menu  in  xfig  or  point  your   browser   at
22       Doc/html/index.html  (provided  with  the xfig distribution, usually in
23       the Doc/www directory).  There are both English and Japanese versions.
24
25       When using a two-button mouse use the <Meta> key and the  right  button
26       at the same time to effect the action of the middle button.
27
28       Xfig is available from http://www.xfig.org .
29
30       The TransFig package is used when printing or exporting the output from
31       xfig.  The fig2dev program from the TransFig package  is  automatically
32       called by xfig as a back-end processor to produce various types of out‐
33       put:
34
35       LaTeX, Metafont, PostScript or Encapsulated PostScript, tk (tcl/tk tool
36       command  language/tool  kit  package),  GIF, JPEG, PCX, PNG, PPM, TIFF,
37       XBM, XPM, AutoCAD Slide, IBM-GL (HP/GL), Pic PiCTeX, box,  epic,  eepic
38       and eepicemu.
39
40       See man fig2dev for all options.
41
42       The TransFig package is available from http://www.xfig.org .
43

OPTIONS

45       -help
46              Print all command-line options for xfig and quit.
47
48       -a[llownegcoords]
49              Allow  panning  into the negative region of the canvas.  This is
50              the default
51
52       -bal[loon_delay] msec
53              Cause popup information balloons to be delayed by msec millisec‐
54              onds.  The default is 500 milliseconds.
55
56       -bol[d] font
57              Cause  the  font used for displaying the file name and confirma‐
58              tion messages to be font (default = 8x13bold).
59
60       -butt[on] font
61              Cause the font used for most  buttons  to  be  font  (default  =
62              6x13).
63
64       -but_[per_row] number
65              Specify  the  number  of  buttons wide the mode panel should be.
66              This is useful in conjunction with  the  -pheight  parameter  to
67              reduce the canvas height for small screens.
68
69       -cbg color
70              Use  color  as the background color for the canvas.  If you want
71              to set the background of everything in xfig (e.g.  menus,  etc.)
72              use the general -bg option.
73
74       -center
75              Set  the  print option to print the figure centered on the page.
76              This is the default.
77
78       -centim[ers]
79              Make centimeters the unit of choice.  See also -metric.
80
81       -cfg color
82              Use color as the default color for objects.  If you want to  set
83              the  foreground of everything in xfig (e.g. menus, etc.) use the
84              general -fg option.
85
86       -correct_font_size
87              Normally, fig2dev uses 1/80 inch for font size  increments  (for
88              historical reasons), instead of the more proper ``points'' (1/72
89              inch) that xfig uses.  This option makes xfig call fig2dev  with
90              the -F option to make it use points (1/72 inch).
91
92       -deb[ug]
93              Turn  on debugging mode.  Prints various debugging messages like
94              font names etc.
95
96       -dep[th]
97              Choose depth of visual desired.  Your server  must  support  the
98              desired visual and depth chosen.  Use xdpyinfo to see what visu‐
99              als and depths are supported.  See also the -visual option.
100
101       -donta[llownegcoords]
102              Don't allow panning into the negative region of the canvas.  The
103              default is to allow panning in the negative region.
104
105       -dontshowb[alloons]
106              Prevents  xfig  from  popping  up the information balloons.  See
107              also -showballoons.
108
109       -dontshowl[engths]
110              Don't show lengths of lines as they are being  drawn.   This  is
111              the default.
112
113       -dontshowz[erolines]
114              Don't  show  axis  zero  lines on the canvas.  The default is to
115              show them.
116
117       -dontsw[itchcmap]
118              Prevents xfig from switching to  a  private  colormap  if  there
119              aren't  enough  colors  available  in the default colormap.  See
120              also -max_image_colors.
121
122       -enc[oding] encoding
123              Encode character set using encoding when exporting  LaTeX  text.
124              The  default  is  1.   This is used for the ISO-8859 encoding of
125              character  sets.   Allowed  values  are  0  (no   encoding),   1
126              (ISO-8859-1) or 2 (ISO-8859-2).
127
128       -exportL[anguage] language
129              Specifies  the  default language to be used for when exporting a
130              fig file.  Choices are:
131
132              Name              Language
133              -------------------------------------------------
134              Vector formats:
135              box               LaTeX box (figure boundary)
136              latex             LaTeX picture
137              epic              LaTeX picture + epic macros
138              eepic             LaTeX picture + eepic macros
139              eepicemu          LaTeX picture + eepicemu macros
140              pictex            PiCTeX macros
141              hpl               HPGL (IBMGL)
142              eps               Encapuslated PostScript
143              eps_ascii         Encapuslated PostScript with ASCII preview
144              eps_mono_tiff     Encapuslated PostScript with monochrome binary (TIFF) preview
145              eps_color_tiff    Encapuslated PostScript with color binary (TIFF) preview
146              ps                PostScript
147              pdf               PDF (Portable Document Format)
148              pstex             Combined PS/LaTeX (both PS and LaTeX parts)
149              pdftex            Combined PDF/LaTeX (both PDF and LaTeX parts)
150              textyl            Textyl special commands
151              tpic              TPIC
152              pic               PIC
153              mf                MF (MetaFont)
154              mp                MP (MetaPost)
155              mmp               MMP (Multi-MetaPost)
156              cgm               CGM (Computer Graphics Meta file)
157              bcgm              Binary CGM (Computer Graphics Meta file)
158              emf               Enhanced Meta file)
159              tk                Tk (of the tcl/tk fame)
160              svg               SVG (Scalable Vector Graphics (XML variant))
161
162              Bitmap formats:
163              gif               GIF
164              jpeg              JPEG (JFIF)
165              pcx               PCX
166              png               PNG
167              ppm               PPM (portable pixmap package)
168              sld               (AutoCad slide)
169              tiff              TIFF
170              xbm               X11 Bitmap
171              xpm               X11 Pixmap (XPM3 package)
172
173              -------------------------------------------------
174
175
176       -export_m[argin] width
177              Set the size of the border margin around the figure for  export‐
178              ing  to bitmap, PostScript, Encapsulated PostScript, or HTML MAP
179              formats.  This is in units of pixels (1/80th inch).  The default
180              is 0.
181
182       -fli[pvisualhints]
183              Flip  left/right mouse indicator messages for mice whose buttons
184              have been switched.  The default is to NOT flip the messages.
185
186       -flu[shleft]
187              Set the print option  to  print  the  figure  flush  left.   The
188              default is to center the figure on the page.
189
190       -free[hand_resolution] resolution
191              Set  the  resolution  of the freehand drawing mode to resolution
192              pixels.  This is the number of pixels the mouse must move before
193              xfig adds another point to the object being drawn.
194
195       -geom[etry] [WxH][+X+Y]
196              You  may  use  the  -geometry  option or resource to size and/or
197              position the xfig window, or you may use -pwidth and/or -pheight
198              to specify the canvas size in inches or centimeters.  If you use
199              the -geom option to  make  the  xfig  window  smaller  than  the
200              default,  you  may  have  to use the -but_per_row option to tell
201              xfig to put 3 or 4 buttons per row on the left mode panel.
202
203       -gh[ostscript] postscript-interpreter
204              Select the PostScript (tm)  interpreter  of  your  choice.   The
205              default  is  ghostscript  (gs).   This  is needed when importing
206              Encapsulated PostScript files.
207
208       -grid_c[olor] color
209              Draw the grid on the canvas in this color (default: red).
210
211       -grid_u[nit] unit
212              Only used when in inches mode to choose  between  showing  frac‐
213              tions or decimal inches in the rulers and grid.  Any of the fol‐
214              lowing may be used to force decimal inches: "ten", "tenth", "10,
215              "1/10".   If any other value is used for this option, the rulers
216              will show 1/16 inch divisions.
217
218       -hidd[entext]
219              Start xfig with the hidden text mode for text objects.  The Hid‐
220              den  attribute  is used for figures that will be used with LaTeX
221              and is applicable only to the display of the document  in  xfig.
222              It  means  that  the text itself is not shown onscreen, but only
223              the string ``<text>''.  This is to keep long sequences of  LaTeX
224              formatting  commands  from  making  the screen messy and hard to
225              read.  The default for the Hidden flag is off.
226
227       -dontshowd[epthmanager]
228              Hide the depth manager panel.  The default is to show the panel.
229
230       -icon_[view]
231              Show the library objects as icons.  This is  the  default.   The
232              other mode is -list_view.
233
234       -iconG[eometry] +X+Y
235              Specifies the position for the icon.
236
237       -im[age_editor] editor
238              Specify  bitmap  editor  to  use  when  ``Edit Image'' button is
239              pressed in Picture Object panel.
240
241       -inc[hes] (or-imperial)
242              Make inches the unit of choice.  This is the default.
243
244       -ins[tallowncmap]
245              Install own colormap. Normally, xfig uses the current colormap.
246
247       -internalBW width
248              Use lines of width width between all buttons and panels (default
249              = 1).
250
251       -international
252              Switch  on  international  support (mainly Japanese and Korean),
253              users of ISO Latin 1 (ISO-8859-1) probably should not use  this,
254              therefore  the  international support is switched off by default
255              for locales using ISO-8859-1* codesets. For  all  other  locales
256              this option is already used by default.
257
258       -jpeg[_quality] quality
259              Set  the  quality  factor for exporting to the jpeg format.  The
260              default is 75.
261
262       -k[eyFile] compose-key-file
263              Use compose-key-file instead of CompKeyDB for compose (meta) key
264              database.   If  there  are  no ``/''s in the name, the file must
265              reside in  the  xfig  library  directory,  $XFIGLIBDIR,  usually
266              /usr/local/lib/X11/xfig.  If there are any ``/''s in the name it
267              is taken as is (not relative to $XFIGLIBDIR).   If  there  is  a
268              leading  ``~/''  in the string then the ``~'' is expanded to the
269              user's home directory.
270
271       -lan[dscape]
272              Make xfig come up in landscape mode (10.5" x 8").  This  is  the
273              default;  however  as  the orientation is stored with Fig files,
274              when you  load  a  Fig  file  the  orientation  will  change  as
275              required.  This is only true for files of version 3.0 or higher.
276              See also -portrait.
277
278       -lat[exfonts]
279              Start  xfig with LaTeX font selection.  Normally, the PostScript
280              fonts are available as the default.  This flag selects the LaTeX
281              fonts to start.
282
283       -le[ft]
284              Change  the position of the side panel window to the left of the
285              canvas window.  This is the default.
286
287       -library_d[ir] directory
288              Specify directory where Fig object libraries are located.  There
289              may be sub-directories there and sub-sub-directories, etc.
290
291       -library_i[con_size] size
292              Specify  the  size  of the icons shown for library objects.  The
293              default is 60 pixels, with the minimum being 40 and the  maximum
294              being 120.
295
296       -lis[t_view]
297              Show the library objects as a list of names. The default mode is
298              -icon_view.
299
300       -mag[nification] mag
301              Set export and print magnification in %.
302
303       -max[_image_colors] numcols
304              Limit the number of colors used for imported images  to  numcols
305              (default 64).
306
307       -me[tric]
308              Make  centimeters  the  unit of choice.  The option -centimeters
309              may also be used.
310
311              After xfig is started you may change the units  from  metric  to
312              imperial  or  vice versa from a popup menu available by pressing
313              mouse button 3 in the units box where the two rulers meet.
314
315       -mo[nochrome]
316              Use black and white only.
317
318       -mu[ltiple]
319              Sets multiple page mode for print or export. See also -single.
320
321       -noo[verlap]
322              When exporting in multiple page mode,  causes  no  overlap  from
323              page to page.  This is the default.  See also -overlap.
324
325       -nor[mal] font
326              Cause  the  font  used  for the message window to be font.  This
327              font is also used on the canvas when the selected  font  is  not
328              available in an X11 font (default = 6x13).
329
330       -nosc[alablefonts]
331              Disables  use  of  the X11R5 or OpenWindows scalable fonts.  You
332              might want to use this for debugging.
333
334       -nosp[lash]
335              Don't show the startup splash screen.  The default is to show it
336              ( -splash ).
337
338       -not[rack]
339              Turn off cursor (mouse) tracking arrows.
340
341       -ov[erlap]
342              When  exporting  in multiple page mode, causes overlap from page
343              to page of about 10%.  See also -nooverlap.
344
345       -pag[eborder] color
346              Draw the page border on the canvas in this color (default  light
347              blue).   The  page  border  is  turned on by the -showpageborder
348              option (resource Fig.showpageborder), and shows the edges of the
349              current export paper size.
350
351       -pap[er_size] size
352              Set the initial paper size for Export and Print.  Choices are
353
354              Option     Paper      Size
355              ---------------------------------
356              letter     Letter     8.5in x 11in
357              legal      Legal      8.5in x 14in
358              tabloid    Tabloid    17in x 11in
359              a          ANSI A     8.5in x 11in
360              b          ANSI B     11in x 17in
361              c          ANSI C     17in x 22in
362              d          ANSI D     22in x 34in
363              e          ANSI E     34in x 44in
364              a9         ISO A9     37mm x 52mm
365              a8         ISO A8     52mm x 74mm
366              a7         ISO A7     74mm x 105mm
367              a6         ISO A6     105mm x 148mm
368              a5         ISO A5     148mm x 210mm
369              a4         ISO A4     210mm x 297mm
370              a3         ISO A3     297mm x 420mm
371              a2         ISO A2     420mm x 594mm
372              a1         ISO A1     594mm x 840mm
373              a0         ISO A0     840mm x 1189mm
374              b10        JIS B10    32mm x 45mm
375              b9         JIS B9     45mm x 64mm
376              b8         JIS B8     64mm x 91mm
377              b7         JIS B7     91mm x 128mm
378              b6         JIS B6     128mm x 182mm
379              b5         JIS B5     182mm x 257mm
380              b4         JIS B4     257mm x 364mm
381              b3         JIS B3     364mm x 515mm
382              b2         JIS B2     515mm x 728mm
383              b1         JIS B1     728mm x 1030mm
384              b0         JIS B0     1030mm x 1456mm
385              ---------------------------------
386
387              Note  that  this  doesn't affect the size of the drawing canvas.
388              Use the -pheight and -pwidth options for that.
389
390       -ph[eight] height
391              Make the xfig canvas height high (where height is either  cm  or
392              in, depending on the -metric setting).
393
394       -po[rtrait]
395              Make  xfig come up in portrait mode (8.5" x 9").  See note about
396              landscape mode.
397
398       -pw[idth] width
399              Make the xfig canvas width wide (where width is either cm or in,
400              depending on the -metric setting).
401
402       -righ[t]
403              Change the position of the side panel window to the right of the
404              canvas window (default: left).
405
406       -rigi[d]
407              Start xfig with the rigid text mode for text objects.  The Rigid
408              attribute  forces  text to remain the same size even if inside a
409              compound object that is scaled up or down.  The default is off.
410
411       -ru[lerthick]
412              Set the height(width) of the top(side) rulers  in  pixels.   The
413              default (and minimum) is 24.
414
415       -scala[blefonts]
416              Allows  use  of the X11R5 or OpenWindows scalable fonts (this is
417              the default).  If the scalable fonts aren't available xfig  will
418              automatically switch to non-scaling fonts.
419
420       -scale_factor scale
421              Scale  every  figure  read  in by this value.  This is useful in
422              conjunction with the -update option to do batch scaling of  fig‐
423              ures.
424
425       -showa[llbuttons]
426              Show  all the xfig indicator buttons instead of only those rele‐
427              vant to the current drawing mode.  Normally,  the  buttons  line
428              width,  area-fill,  grid  mode, text size, etc. are only visible
429              when they  are  relevant  to  the  current  drawing  mode.   The
430              -showallbuttons  option makes all of the indicator buttons visi‐
431              ble at all times.  This takes up more screen  real  estate,  but
432              allows the user to see all settable parameters.
433
434       -showb[alloons]
435              Forces  xfig  to  pop up the information balloons when the mouse
436              passws over a button. This is the default. See  also  -dontshow‐
437              balloons .
438
439       -showd[epthmanager]
440              Show  the depth manager panel.  This panel lets one show or hide
441              objects at various depths.  This is the default.
442
443       -showl[engths]
444              Makes xfig show the lengths of lines being drawn,  in  red  text
445              near the line itself.  Also, when points are moved or added.  In
446              addition, imagine a triangle formed with the line segment as the
447              hypotenuse, and a vertical and horizontal line forming the other
448              two sides.  These lines and their lengths are also drawn in  red
449              as the point is moved or added.  This mode is ignored when draw‐
450              ing in freehand mode.
451              This flag may be toggled by pressing <Meta>i (default).
452
453       -shown[ums]
454              With this option, xfig will draw all objects with a  red  number
455              next  to  each vertex.  This is generally only useful for debug‐
456              ging.
457
458       -showp[ageborder]
459              Makes xfig show the border of the  current  paper  size  in  the
460              color specified by the -pageborder option (default: light blue).
461
462       -showz[erolines]
463              Show axis zero lines on the canvas.  This is the default
464
465       -si[ngle]
466              Sets single page mode for print or export.  This is the default.
467              See also -multiple.
468
469       -sm[ooth_factor] factor
470              Enable smoothing when exporting to the bitmap formats (e.g. GIF,
471              PNG,  etc.).  The  allowed  values  are 0 (no smoothing), 2 or 4
472              (most smoothing).  This parameter is passed  to  ghostscript  in
473              the  -dTextAlphaBits  -dGraphicsAlphaBits  options to smooth the
474              figure.
475
476       -spec[ialtext]
477              Start xfig with the special text mode for text objects.  Special
478              text  means  that  special characters in the string are not spe‐
479              cially processed but are passed directly to LaTeX.  This is most
480              useful  for  writing  LaTeX equations.  If this flag is not set,
481              then the backslash character '\' is changed  to  the  \backslash
482              command, a brace '{' is turned into a brace command \{, etc.
483
484       -spel[lcheckcommand] command
485              Use  command  for the external spell checking program when using
486              the spell check/search/replace popup.  The string command should
487              include the string ``%s'' which is replaced by a temporary file‐
488              name.  Default is ``spell %s''.
489
490       -spinner_d[elay] msec
491              The delay (in milliseconds) before the  spinner  will  automati‐
492              cally count up or down when the button is pressed.  Spinners are
493              the (numeric) text widgets with an  up-  and  down-arrow,  which
494              when  clicked,  cause  the  value to be incremented/decremented.
495              The default is 500 milliseconds.
496
497       -spinner_r[rate] msec
498              The rate (in milliseconds) at which the spinner will count  when
499              the up- or down-arrow is pressed.
500
501       -startfi[llstyle] stylenumber
502              Set the starting fill style for area fill (-1 to 21).
503
504       -startfo[ntsize] pointsize
505              Set the default font size for text objects (default = 12pt).
506
507       -startg[ridmode] modenumber
508              Set  the  starting  grid  mode (0 to 3).  Mode 0 is no grid.  In
509              imperial (inches) mode, grid mode 1 is 1/4 inch, mode 2  is  1/2
510              inch  and mode 3 is 1 inch.  In metric mode, grid mode 1 is 5mm,
511              mode 2 is 1cm and mode 3 is 2cm.
512
513       -startla[texFont] font
514              Set the starting font name for LaTeX fonts.
515
516       -startli[newidth] width
517              Set the starting line width.
518
519       -startpo[snmode] modenumber
520              Set the starting point positioning mode (0  to  4)  In  imperial
521              (inches)  mode,  positioning  mode  0 is ``any'', mode 1 is 1/16
522              inch, mode 2 is 1/4 inch, mode 3 is 1/2 inch and  mode  4  is  1
523              inch.   In metric mode, mode 0 is ``any'', mode 1 is 1mm, mode 2
524              is 5mm, mode 3 is 10mm and mode 4 is 20mm.
525
526       -startp[sFont] font
527              Set the starting font name for PostScript fonts.
528
529       -startt[extstep] stepsize
530              Set the starting text step.
531
532       -ta[blet]
533              Specifies that xfig should use the input tablet instead  of  the
534              mouse  for drawing.  You must have the XInputExtension in your X
535              server and an input tablet for this to  work.   Also,  you  must
536              modify the Imakefile to include the USETAB and TABLIB variables.
537
538       -track
539              Turn on cursor (mouse) tracking arrows (default).
540
541       -tran[sparent_color] color_number
542              Make  the  transparent  color for GIF export color_number.  This
543              number is the color number according to the  xfig  color  panel,
544              starting at 0 (black) and ending at 31 (gold), or may be a user-
545              defined color number, which is 32 or higher.
546
547       -update file [ file ... ]
548              Run xfig in an "update" mode, where it will read each  Fig  file
549              specified  on  the command line and write it out to the original
550              file, in the current file format for the version of  xfig  being
551              run.   The  original  Fig file will be preserved with the suffix
552              .bak attached to the name.
553              In this mode, xfig doesn't connect the X server, so no window is
554              opened, and it exits when finished.
555
556       -users[cale] scale
557              Set  the multiplier for displayed line lengths etc.  This factor
558              is multiplied by the actual length, radius or  diameter  of  the
559              object  currently  being  drawn on the canvas.  It is useful for
560              making scale drawings, where e.g. 1 inch = 1 foot  (userscale  =
561              12.0) or 1cm = 1m (userscale = 100.0).
562
563       -useru[nit] units
564              The  units  string  is  printed with the length information when
565              drawing objects.  For example if the userscale  =  1.0  and  the
566              userunit  =  ft then a line which is 3 inches long on the canvas
567              would be displayed as ``length = 3 ft'' when it is being drawn.
568
569              After xfig is started you  may  change  the  userscale  and  the
570              userunit  from a popup menu available by pressing mouse button 3
571              in the units box where the two rulers meet.
572
573       -visual visualname
574              Use visualname as the visual for xfig.  The names are  TrueColor
575              (case  is  not important), StaticColor, DirectColor, StaticGray,
576              GrayScale and PseudoColor.  xfig uses the default visual  unless
577              this is specified.  Your server must support the desired visual.
578              Use xdpyinfo to see what visuals and depths are supported.   See
579              also the -depth option.
580
581       -zoom zoomscale
582              Set the starting zoom scale.
583
584
585

X RESOURCES and DEFAULTS

587       The  overall  widget  name(Class) is xfig(Fig).  These resources corre‐
588       spond to the command line arguments:
589
590    Name                Type    Default         Command-line equivalent
591    -------------------------------------------------------------------
592    allownegcoords      boolean true            -allownegcoords (true),
593                                                -dontallownegcoords (false)
594    axislines           string  pink            -axislines
595    balloon_delay       integer 500 (ms)        -balloon_delay
596    boldFont            string  8x13bold        -bold
597    but_per_row         integer 2               -but_per_row
598    buttonFont          string  6x13            -button
599    canvasbackground    string  white           -cbg
600    canvasforeground    string  black           -cfg
601    correctfontsize     boolean false           -correctfontsize
602    debug               boolean false           -debug
603    depth               integer *               -depth
604    dontswitchcmap      boolean false           -dontswitchcmap
605    euc_encoding        boolean false           (n/a)
606    encoding            integer 1               -encoding
607    exportLanguage      string  eps             -exportLanguage
608    export_margin       integer 0               -export_margin
609    flipvisualhints     boolean false           -flipvisualhints
610    flushleft           boolean false           -flushleft (true),
611                                                -center (false)
612    freehand_resolution integer 25              -freehand_resolution
613    grid_color          string  black           -grid_color
614    grid_unit           string  1/16 (inch)     -grid_unit
615                                0.1 (metric)
616    hiddentext          boolean false           -hiddentext
617    icon_view           boolean true            -icon_view (true),
618                                                -list_view (false)
619    image_editor        string  xv              -image_editor
620    inches              boolean true            -inches (true),
621                                                -imperial (true),
622                                                -centimeters (false),
623                                                -metric (false)
624    installowncmap      boolean false           -installowncmap
625    internalborderwidth integer 1               -internalBW
626    international       International           booleanfalse-international
627    jpeg_quality        integer 75              -jpeg_quality
628    justify             boolean false           -left (false),
629                                                -right (true)
630    keyFile             string  CompKeyDB       -keyFile
631    landscape           boolean true            -Landscape (true),
632                                                -landscape (true),
633                                                -Portrait (false),
634                                                -portrait (false)
635    latexfonts          boolean false           -latexfonts
636    library_dir         string  ~/xfiglib       -library_dir
637    magnification       float   100             -magnification
638    max_image_colors    integer 64              -max_image_colors
639    monochrome          boolean false           -monochrome
640    multiple            boolean false           -multiple
641    normalFont          string  6x13            -normal
642    overlap             boolean true            -overlap (true),
643                                                -nooverlap (false)
644    pageborder          string  lightblue       -pageborder
645    paper_size          string  Letter (inch)   -paper_size
646                                A4 (metric)
647    pheight             float   8.5 (landscape) -pheight
648                                9.5 (portrait)
649    pwidth              float   11 (landscape)  -pwidth
650                                8.5 (portrait)
651    rigidtext           boolean false           -rigid (true)
652    rulerthick          integer 24              -rulerthick
653    scalablefonts       boolean true            -scalablefonts (true),
654                                                -noscalablefonts (false)
655    scale_factor        float   1.0             -scale_factor
656    showallbuttons      boolean false           -showallbuttons
657    showaxislines       boolean true            -showaxislines (true),
658                                                -dontshowaxislines (false)
659    showballoons        boolean true            -showballoons (true),
660                                                -dontshowballoons (false)
661    showdepthmanager    boolean true            -showdepthmanager (true),
662                                                -dontshowdepthmanager (false)
663    showlengths         boolean false           -showlengths (true),
664                                                -dontshowlengths (false)
665    shownums            boolean false           -shownums (true),
666                                                -dontshownums (false)
667    showpageborder      boolean true            -showpageborder (true),
668                                                -dontshowpageborder (false)
669    single              boolean true            -single
670    smooth_factor       integer 0               -smooth_factor
671    specialtext         boolean false           -specialtext
672    splash              boolean true            -splash (true),
673                                                -nosplash (false)
674    spellcheckcommand   string  spell %s        -spellcheckcommand
675    spinner_delay       integer 500 (ms)        -spinner_delay
676    spinner_rate        integer 100 (ms)        -spinner_rate
677    startfillstyle      integer 0               -startfillstyle
678    startfontsize       float   12              -startfontsize
679    startgridmode       integer 0               -startgridmode
680    startlatexFont      string  Default         -startlatexFont
681    startlinewidth      integer 1               -startlinewidth
682    startposnmode       integer 1               -startposnmode
683    startpsFont         string  Times-Roman     -startpsFont
684    starttextstep       float   1.2             -starttextstep
685    tablet              boolean false           -track,
686    trackCursor         boolean true            -track (true),
687                                                -notrack (false)
688    transparent_color   integer -2 (none)       -transparent_color
689    userscale           float   1.0             -userscale
690    userunit            string  in (inches)     -userunit
691                                cm (metric)
692    visual              string  *               -visual
693    zoom                float   1.0             -zoom
694
695    * Default visual and depth depend on the X server. Use xdpyinfo to see what visuals
696    and depths are supported.
697    -------------------------------------------------------------------
698
699

BUGS and RESTRICTIONS

701       Please send bug reports, fixes, new features etc. to:
702       bvsmith@lbl.gov (Brian V. Smith)
703
704       When reporting a bug, please first check if the problem is mentioned in
705       the FAQ section of the HTML files (xfig Help menu).
706
707       If  it  is  not mentioned there, be sure to report the operating system
708       you are using (e.g. SunOS 4.1.3), type of X server and  version  (Open‐
709       Windows  3,  X11R6.4,  XFree86  3.2.2, etc) and color depth (e.g. 8bpp,
710       16bpp), and most importantly the version of xfig  or  fig2dev  that  is
711       having the problem.
712
713       It  is  also  VERY useful to me if you can provide a stack trace from a
714       debugger such as gdb, dbx, ups, etc, if the bug causes xfig to crash.
715
716       Because of the difference of some fonts in some X servers and the Post‐
717       Script fonts on printers, text alignment can be problematic.
718
719       Not  all operations employ smart redrawing of objects which are altered
720       as a by product of the operation.  You may need to use Redraw in  these
721       cases.
722
723       Some servers do not allow bitmaps/pixmaps taller than the screen height
724       or wider than the screen width.  That is why there is a  limit  on  the
725       width  of  the  top  ruler  and  height of the side ruler.  If you need
726       wider/taller rulers AND your server  allows  bigger  pixmaps,  you  may
727       define MAX_TOPRULER_WD and/or MAX_SIDERULER_HT in your Imakefile in the
728       DEFINES line.  For example, to have a maximum top ruler width  of  1160
729       pixels,  add  -DMAX_TOPRULER_WD=1160 to your DEFINES line in the Imake‐
730       file.
731
732       If the image is panned or the xfig window  iconified  and  de-iconified
733       during the middle of an operation (e.g. while drawing a line), the pic‐
734       ture will be distorted.  This can be corrected using Redraw  after  the
735       operation is complete.
736
737       When  zoomed  very large, the length of dashes in dashed lines will top
738       out at 255 pixels long.  This is due to a restriction  in  X  that  the
739       dash list is defined by char (255 pixels maximum for a dash).  The fig‐
740       ure will print correctly, however.
741
742       When you do a copy/rotate with multiple copies, only  the  creation  of
743       the last object can be undone with the Undo button.
744
745       Modifications to text using the popup search/update/replace/spell check
746       panel cannot be undone.
747
748       See the README file for troubleshooting.
749

SEE ALSO

751       fig2dev(1) (TransFig package)
752
753       gs(1) (Ghostscript PostScript previewer)
754

ACKNOWLEDGEMENT

756       (From the original author, Supoj Sutanthavibul): Many  thanks  goes  to
757       Professor Donald E. Fussell who inspired the creation of this tool.
758
759       (From current maintainer Brian Smith): Thanks to all the users who have
760       contributed to xfig, especially Paul King who, besides adding many fea‐
761       tures, revamped the look and feel which became version 2.1.
762
764       Original Copyright (c) 1985 by Supoj Sutanthavibul
765       Parts Copyright (c) 1994-1999 by Brian V. Smith
766       Parts Copyright (c) 1991 by Paul King
767       Other Copyrights may be found in various files
768
769
770       Any party obtaining a copy of these files is granted, free of charge, a
771       full and unrestricted irrevocable, world-wide, paid  up,  royalty-free,
772       nonexclusive  right and license to deal in this software and documenta‐
773       tion files (the "Software"), including without limitation the rights to
774       use, copy, modify, merge, publish and/or distribute copies of the Soft‐
775       ware, and to permit persons who receive copies from any such  party  to
776       do  so,  with  the  only  requirement  being that this copyright notice
777       remain intact.
778
779       Note that although I work  at  Lawrence  Berkeley  National  Laboratory
780       (LBNL)  I  don't speak for LBNL nor do I represent LBNL with respect to
781       my work on TransFig and xfig, nor does  LBL  make  any  representations
782       about the suitability of this software for any purpose.
783
784       Here is the legal part:
785
786       THE LAWRENCE BERKELEY NATIONAL LABORATORY DISCLAIMS ALL WARRANTIES WITH
787       REGARD TO THIS SOFTWARE,  INCLUDING  ALL  IMPLIED  WARRANTIES  OF  MER‐
788       CHANTABILITY  AND  FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
789       ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY  DAMAGES  WHATSO‐
790       EVER  RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
791       OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR  IN
792       CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
793
794
795       PostScript is a trademark of Adobe Systems Incorporated.
796
797       Parts Copyright (C) 1989 by Jef Poskanzer.
798       Copyright notice for pbmplus code:
799
800       Permission to use, copy, modify, and distribute this
801       software and its documentation for any purpose and without
802       fee is hereby granted, provided that the above copyright
803       notice appear in all copies and that both that copyright
804       notice and this permission notice appear in supporting
805       documentation.  This software is provided ``as is'' without
806       express or implied warranty.
807

FILES

809       CompKeyDB
810               Data base of compose (meta) key sequences for 8-bit characters.
811               Must be installed in $(XFIGLIBDIR) with  ``make  install'',  or
812               may be specified with command line option -keyFile or X toolkit
813               resource keyFile.  See the Imakefile.
814
815       /usr/share/doc/xfig-3.2.5
816               This directory contains the documentation.
817
818       /usr/share/xfig
819               This directory contains the above mentioned CompKeyDB file, and
820               a  directory  of libraries containing Fig objects such as elec‐
821               trical symbols, logic symbols, etc.
822
823       Fig.ad and Fig-color.ad
824               Application defaults files which are automatically installed in
825               the  system  app-defaults  directory with the make install com‐
826               mand.
827
828       Doc/FORMAT3.2
829               Description of Fig file format.
830
831       README  Installation instructions and troubleshooting.
832
833       CHANGES Description of bug fixes/new features.
834
835

AUTHORS

837       Many people have contributed to xfig.  Here is a list of the people who
838       have contributed the most (in chronological order):
839
840       Version 1:
841
842
843           Original author:
844           Supoj Sutanthavibul, University of Texas at Austin
845
846           The LaTeX line drawing modes were contributed by:
847           Frank Schmuck, Cornell University
848
849           Original X11 port by:
850           Ken Yap, Rochester
851
852           Variable window sizes, cleanup of X11 port, right hand side panel:
853           Dana Chee, Bellcore
854
855           Cleanup of color port to X11 by:
856           John T. Kohl, MIT
857
858       Version 2.0:
859
860
861           Area  fill,  multiple  line  thicknesses,  multiple  fonts and font
862           sizes, bottom panel, line style/thickness, (and anything else  that
863           wasn't written by the others) by:
864           Brian Smith
865           (standard disclaimer applies)
866           (bvsmith@lbl.gov)
867
868           Popup change-object menu by:
869           Jon Tombs
870           Frank Schmuck
871
872           Zooming and panning functions, shift key select mechanism by:
873           Dieter Pellkofer
874           Henning Spruth
875
876           Depth feature by:
877           Mike Lutz
878
879           Cut/Paste by:
880           Tom Tkacik
881
882       Version 2.1:
883
884
885           Indicator  panel,  file  menu popup, print menu popup, panning with
886           rulers, mouse function window, regular  polygon,  rubberbanding  of
887           circles/ellipses,  filled  splines on canvas, dashed/dotted splines
888           on canvas, update button,  arbitrary  angle  rotation  of  objects,
889           alignment  in compound, object scaling, constrained copy/move, cor‐
890           ner markers for compound, context sensitive corner markers, smarter
891           redraw,  undo  for compound and point move for boxes, cancel object
892           creation, point positioning to three resolutions, TransFig scalable
893           text, hidden text, special text, save of figure on crash by:
894
895           Paul King (king@cs.uq.oz.au)
896           with help from:
897           Brian Smith and Micah Beck (beck@cs.utk.edu)
898
899           Encapsulated PostScript importing by:
900           Brian Boyter
901
902           Pan/zoom with ctrl key/mouse by:
903           Henning Spruth
904
905           International characters by:
906           Herve Soulard
907
908           Directory Browser based on XDir by:
909           Win Treese, Digital Equipment Corporation
910
911           Rotated ellipses by:
912           James  Tough,  Dept.  of  Computer Science, Heriot-Watt University,
913           Scotland
914
915           Rotated text from the xvertext package by:
916           Alan Richardson, Space Science Centre, School of  MAPS,  University
917           of Sussex
918
919           Popup scale menu and dynamic switching between inches and cm by:
920           Paul King (king@cs.uq.oz.au)
921
922           Extensive man page formatting revisions by:
923           David W. Sanderson
924
925           Display Postscript code for IBM RS/6000 by:
926           Dave Hale (dhale@green.mines.colorado.edu)
927
928       Version 3.0:
929
930
931           New  arrowhead  types, separate pen/fill colors, new file protocol,
932           more colors with extended color popup panel,  new  arc  style,  new
933           fill  patterns  (bricks, etc), new line join and cap styles, export
934           offset and file load offset, XPM import, XBM import and export (and
935           anything else that wasn't written by the others) by:
936           Brian Smith
937           (Note:  the  color  popup  panel was based on xcoloredit by Richard
938           Hesketh)
939
940
941           GIF header reading code by:
942           David Koblas from the giftoppm part of the pbmplus package
943
944           XPM export code (using XPM3 libraries) by:
945           Karel van Houten (K.H.C.vanHouten@research.ptt.nl)
946
947           Higher figure resolution (1200dpi) by:
948           Ross Martin (martin@trcsun3.eas.asu.edu)
949
950           Color quantization using neural network by:
951           Anthony Dekker (dekker@ACM.org)
952           [NEUQUANT Neural-Net  quantization  algorithm  by  Anthony  Dekker,
953           1994.   See  ``Kohonen neural networks for optimal colour quantiza‐
954           tion'' in ``Network: Computation in Neural Systems'' Vol. 5  (1994)
955           pp 351-367.  for a discussion of the algorithm.]
956
957           Floyd-Steinberg  algorithm for dithering color images on monochrome
958           displays lifted from the Pbmplus package by Jef Poskanser.
959
960           rotate/flip objects around/about selected anchor point and multiple
961           copies of objects by:
962           Uwe Bonnes (bon@lte.e-technik.uni-erlangen.de)
963
964           Input tablet extension by:
965           Greg LaCoste (greg@seismo.do.usbr.gov)
966
967       Version 3.1:
968
969
970           The only difference between protocol version 3.0 and version 3.1 is
971           that the position of the ``magnet'' has  been  shifted  by  14  fig
972           units.   In the 2.1 and older versions of xfig the grid was in mul‐
973           tiples of 5 fig units, but they were on intervals  4,  9,  14,  19,
974           etc.   When version 3.0 was created, coordinates were simply multi‐
975           plied by the ratio of the resolutions (1200/80 = 15) so values like
976           4 became 60 instead of 74 ((4+1)*15 - 1).
977
978           The  JPEG  import/export code uses the Independent JPEG Group soft‐
979           ware (see jpeg/README for details)
980
981           Image browser, editor and screen capture features by:
982           Jim Daley (jdaley@cix.compulink.co.uk)
983
984       Version 3.2:
985
986
987           The changes to the version 3.2 file protocol are  the  addition  of
988           the  paper  size,  print/export magnification, single/multiple page
989           indicator and a transparent color name used for GIF export  to  the
990           header of the file.
991           The  other difference in the version 3.2 protocol is the mathemati‐
992           cal model used for splines. The new version  uses  X-splines  which
993           allows  the user to mix interpolation and approximation points in a
994           same curve. More precisely, it means that an X-spline curve is nei‐
995           ther  an  interpolated  spline  nor an approximated one, it is BOTH
996           (the behaviour of each point is controlled by one single  parameter
997           called  ``shape  factor'').  For  additional  information  about X-
998           splines, see:
999
1000             "X-Splines: A Spline Model Designed for the End User"
1001             by C. Blanc and C. Schlick, Proceedings of SIGGRAPH'95
1002             http://dept-info.labri.u-bordeaux.fr/~schlick/DOC/sig1.html
1003
1004           Caveat: Because previous spline  models  (quadratic  B-splines  and
1005           Bezier with hidden points) are no longer supported, curves that are
1006           present in version 3.1 and older files are automatically  converted
1007           to  X-splines.   This translation is only an approximation process.
1008           It means that the converted curves are not exactly the same as  the
1009           original  ones.  Though they are usually very close, some hand-fit‐
1010           ting may be needed in some pathological cases.
1011
1012           Inclusion of X-splines by:
1013           Carole Blanc (blanc@labri.u-bordeaux.fr)
1014           Christophe Schlick (schlick@labri.u-bordeaux.fr)
1015           Note: the initial implementation was done by C. Feuille,  S.  Gros‐
1016           bois,  L.  Maziere and L. Minihot as a student practice (Universite
1017           Bordeaux, France).
1018
1019           Open/close compound feature written by
1020           Bill Taylor (bill@mainstream.com)
1021
1022           Library feature written by
1023           Stephane Mancini (mancini@elecsrv.enst.fr) (object preview by Brian
1024           V. Smith)
1025
1026           The library objects in the Electrical and Logic libraries were done
1027           by
1028           Peter Hiscocks (phiscock@ee.ryerson.ca)
1029
1030           The library objects in the Computer, Networks, and  Hospital-Equip‐
1031           ment libraries were extracted from the clipart example files by
1032           Bill Chimiak (chim@bgsm.edu)
1033
1034
1035       Version 3.2.3 and newer:
1036
1037
1038           Please see the CHANGES file for credits for newer releases.
1039

NOTES

1041       Many bug fixes/cleanups etc. by a host of faithful users
1042
1043       See the CHANGES file for all the credits
1044
1045       The  TransFig  package  was  written by Micah Beck and is maintained by
1046       Brian Smith
1047
1048
1049
1050                             Xfig 3.2.4 (Dec 2002)                     XFIG(1)
Impressum