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.8a
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 for xfig is in an HTML-based reference
21       guide.   See  the  Help  menu  in  xfig  or  point  your   browser   at
22       /usr/share/doc/xfig/html/index.html.   There are both English and Japa‐
23       nese 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 https://sourceforge.net/projects/mcj/.
29
30       The  Fig2dev package is used when printing or exporting the output from
31       xfig.  The fig2dev program is automatically called by xfig as  a  back-
32       end processor to produce various types of output:
33
34       LaTeX,  Metafont,  PDF,  PostScript or Encapsulated PostScript, CGM and
35       EMF (mostyl used under Windows), tk (tcl/tk tool command  language/tool
36       kit  package),  SVG,  GIF, JPEG, PCX, PNG, PPM, TIFF, XBM, XPM, Gerber,
37       AutoCAD Slide, IBM-GL (HP/GL), Pic and PiCTeX.  For use with TeX/LaTeX:
38       box, epic, eepic, eepicemu, pict2e, pstricks, tikz.
39
40       See man fig2dev for all options.
41
42       The    Fig2dev    package    is    available    from    https://source
43       forge.net/projects/mcj/.
44

OPTIONS

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

X RESOURCES and DEFAULTS

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

BUGS and RESTRICTIONS

722       Please send bug reports, fixes, new features etc. to:
723       thomas.loimer@tuwien.ac.at
724
725       Because of the difference of some fonts in some X servers and the Post‐
726       Script fonts on printers, text alignment can be problematic.
727
728       Not all operations employ smart redrawing of objects which are  altered
729       as  a by product of the operation.  You may need to use Redraw in these
730       cases.
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

SEE ALSO

749       fig2dev(1) (Fig2dev package)
750
751       gs(1) (Ghostscript PostScript previewer)
752

ACKNOWLEDGEMENT

754       (From the original author, Supoj Sutanthavibul): Many  thanks  goes  to
755       Professor Donald E. Fussell who inspired the creation of this tool.
756
757       (From  Brian  Smith):  Thanks  to all the users who have contributed to
758       xfig, especially Paul King who, besides adding many features,  revamped
759       the look and feel which became version 2.1.
760
762       Original Copyright (c) 1985 by Supoj Sutanthavibul
763       Parts Copyright (c) 1989-2015 by Brian V. Smith
764       Parts Copyright (c) 1991 by Paul King
765       Parts Copyright (c) 2016-2018 by Thomas Loimer
766       Other Copyrights may be found in various files
767
768
769       Any party obtaining a copy of these files is granted, free of charge, a
770       full and unrestricted irrevocable, world-wide, paid  up,  royalty-free,
771       nonexclusive  right and license to deal in this software and documenta‐
772       tion files (the "Software"), including without limitation the rights to
773       use, copy, modify, merge, publish and/or distribute copies of the Soft‐
774       ware, and to permit persons who receive copies from any such  party  to
775       do  so,  with the only requirement being that this copyright notice re‐
776       main intact.
777
778       THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,  IN‐
779       CLUDING  ALL  IMPLIED  WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
780       EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT  OR  CONSE‐
781       QUENTIAL  DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
782       DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR  OTHER
783       TORTIOUS  ACTION,  ARISING OUT OF OR IN CONNECTION WITH THE USE OR PER‐
784       FORMANCE OF THIS SOFTWARE.
785
786
787       PostScript is a trademark of Adobe Systems Incorporated.
788
789       Parts Copyright (C) 1989 by Jef Poskanzer.
790       Copyright notice for pbmplus code:
791
792       Permission to use, copy, modify, and distribute this
793       software and its documentation for any purpose and without
794       fee is hereby granted, provided that the above copyright
795       notice appear in all copies and that both that copyright
796       notice and this permission notice appear in supporting
797       documentation.  This software is provided ``as is'' without
798       express or implied warranty.
799

FILES

801       /usr/share/xfig/CompKeyDB
802               Data base of compose (meta) key sequences for 8-bit characters.
803               A  different file may be specified with the command line option
804               -keyFile or X toolkit resource keyFile.
805
806       /usr/share/doc/xfig/html
807               This directory contains the html documentation.
808
809       /usr/share/doc/xfig/FORMAT3.2
810               Description of Fig file format.
811
812       /usr/share/xfig/Libraries
813               This directory contains libraries of Fig objects such as  elec‐
814               trical symbols, logic symbols, etc.
815
816       /usr/share/X11/app-defaults/Fig
817               Application defaults file.
818
819       /usr/share/applications/xfig.desktop
820               Desktop entry file.
821
822       /usr/share/pixmaps/xfig.png
823               Desktop icon.
824
825

AUTHORS

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

NOTES

1031       Many bug fixes/cleanups etc. by a host of faithful users.
1032
1033       See the CHANGES file for all the credits.
1034
1035       The Fig2dev package was written by Micah  Beck  and  is  maintained  by
1036       Thomas Loimer.
1037
1038
1039
1040Xfig 3.2.8a                        Mar 2021                            xfig(1)
Impressum