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

X RESOURCES and DEFAULTS

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

BUGS and RESTRICTIONS

720       Please send bug reports, fixes, new features etc. to:
721       thomas.loimer@tuwien.ac.at
722
723       Because of the difference of some fonts in some X servers and the Post‐
724       Script fonts on printers, text alignment can be problematic.
725
726       Not  all operations employ smart redrawing of objects which are altered
727       as a by product of the operation.  You may need to use Redraw in  these
728       cases.
729
730       If  the  image  is panned or the xfig window iconified and de-iconified
731       during the middle of an operation (e.g. while drawing a line), the pic‐
732       ture  will  be distorted.  This can be corrected using Redraw after the
733       operation is complete.
734
735       When zoomed very large, the length of dashes in dashed lines  will  top
736       out  at  255  pixels  long.  This is due to a restriction in X that the
737       dash list is defined by char (255 pixels maximum for a dash).  The fig‐
738       ure will print correctly, however.
739
740       When  you  do  a copy/rotate with multiple copies, only the creation of
741       the last object can be undone with the Undo button.
742
743       Modifications to text using the popup search/update/replace/spell check
744       panel cannot be undone.
745

SEE ALSO

747       fig2dev(1) (Fig2dev package)
748
749       gs(1) (Ghostscript PostScript previewer)
750

ACKNOWLEDGEMENT

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

FILES

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

AUTHORS

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

NOTES

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