1xfig(1) General Commands Manual xfig(1)
3
7 xfig - Facility for Interactive Generation of figures under X11
8 Version 3.2.9
9
11 xfig [options] [file]
12
14 Xfig is a menu-driven tool that allows the user to draw and manipulate
15 objects interactively under the X Window System. If file is given, it
16 specifies the name of a file to be edited.
17 The bulk of the documentation for xfig is in an HTML-based reference
19 guide. See the Help menu in xfig or point your browser at
20 /usr/share/doc/xfig/html/index.html. There are both English and Japa‐
21 nese versions.
22 When using a two-button mouse instead of a three-button mouse, use the
24 <Meta> key and the right button at the same time to effect the action
25 of the middle button.
26 Xfig is available from https://sourceforge.net/projects/mcj/.
28 The Fig2dev package is used when printing or exporting the output from
30 xfig. The fig2dev program is automatically called by xfig as a back-
31 end processor to produce various types of output:
32 LaTeX, Metafont, PDF, PostScript or Encapsulated PostScript, CGM and
34 EMF (mostyl used under Windows), tk (tcl/tk tool command language/tool
35 kit package), SVG, GIF, JPEG, PCX, PNG, PPM, TIFF, XBM, XPM, Gerber,
36 AutoCAD Slide, IBM-GL (HP/GL), Pic and PiCTeX. For use with TeX/LaTeX:
37 box, epic, eepic, eepicemu, pict2e, pstricks, tikz.
38 See man fig2dev for all options.
40 The Fig2dev package is available from https://source‐
42 forge.net/projects/mcj/.
43
45 -help
46 Print all command-line options for xfig and quit.
47 -a[llownegcoords]
49 Allow panning into the negative region of the canvas. This is
50 the default
51 -au[torefresh]
53 Make xfig look at the timestamp on the .fig file and automati‐
54 cally load it and display it every time it changes.
55 -bal[loon_delay] msec
57 Cause popup information balloons to be delayed by msec millisec‐
58 onds. The default is 500 milliseconds.
59 -butt[on] font
61 Cause the font used for most buttons to be font (default =
62 6x13).
63 -but_[per_row] number
65 Specify the number of buttons wide the mode panel should be.
66 This is useful in conjunction with the -pheight parameter to re‐
67 duce the canvas height for small screens.
68 -cbg color
70 Use color as the background color for the canvas. If you want
71 to set the background of everything in xfig (e.g. menus, etc.)
72 use the general -bg option.
73 -center
75 Set the print option to print the figure centered on the page.
76 This is the default.
77 -centim[ers]
79 Make centimeters the unit of choice. See also -metric.
80 -cfg color
82 Use color as the default color for objects. If you want to set
83 the foreground of everything in xfig (e.g. menus, etc.) use the
84 general -fg option.
85 -correct_font_size
87 Normally, fig2dev uses 1/80 inch for font size increments (for
88 historical reasons), instead of the more proper ``points'' (1/72
89 inch) that xfig uses. This option makes xfig call fig2dev with
90 the -F option to make it use points (1/72 inch).
91 -deb[ug]
93 Turn on debugging mode. Prints various debugging messages like
94 font names etc.
95 -dep[th]
97 Choose depth of visual desired. Your server must support the
98 desired visual and depth chosen. Use xdpyinfo to see what visu‐
99 als and depths are supported. See also the -visual option.
100 -donta[llownegcoords]
102 Don't allow panning into the negative region of the canvas. The
103 default is to allow panning in the negative region.
104 -dontshowb[alloons]
106 Prevents xfig from popping up the information balloons. See
107 also -showballoons.
108 -dontshowl[engths]
110 Don't show lengths of lines as they are being drawn. This is
111 the default.
112 -dontshowz[erolines]
114 Don't show axis zero lines on the canvas. The default is to
115 show them.
116 -dontsw[itchcmap]
118 Prevents xfig from switching to a private colormap if there
119 aren't enough colors available in the default colormap. See
120 also -max_image_colors.
121 -exportL[anguage] language
123 Specifies the default language to be used for when exporting a
124 fig file. Choices are:
125 Name Language
127 ---------------------------------------------------------------
128 Vector formats:
129 ps PostScript
130 eps Encapsulated PostScript
131 pdf PDF (Portable Document Format)
132 box LaTeX box (figure boundary)
133 latex LaTeX picture
134 pict2e LaTeX picture + pict2e macros
135 tikz LaTeX picture + tikz macros
136 epic LaTeX picture + epic macros
137 eepic LaTeX picture + eepic macros
138 eepicemu LaTeX picture + eepicemu macros
139 pstex Combined PS/LaTeX (both PS and LaTeX parts)
140 pdftex Combined PDF/LaTeX (both PDF and LaTeX parts)
141 pspdftex Combined PS/PDF/LaTeX (three parts)
142 pictex PiCTeX macros
143 cgm Computer Graphcis Meta file
144 emf Enhanced Meta file
145 dxf Drawing Interchange format
146 gbx Gerber (RS-247-X)
147 ibmgl HPGL/2 or IBMGL
148 textyl Textyl special commands
149 tpic TPIC
150 pic PIC
151 mf MF (MetaFont)
152 mp MP (MetaPost)
153 tk Tk (Tcl/Tk toolkit)
154 ptk Perl/Tk
155 shape LaTeX shape paragraph definition
156 svg SVG (Scalable Vector Graphics)
157 Bitmap formats:
159 gif GIF
160 jpeg JPEG (JFIF)
161 pcx PCX
162 png PNG
163 ppm PPM (portable pixmap package)
164 sld (AutoCad slide)
165 tiff TIFF
166 xbm X11 Bitmap
167 xpm X11 Pixmap
168 ---------------------------------------------------------------
169 -export_m[argin] width
172 Set the size of the border margin around the figure for export‐
173 ing to bitmap, PostScript, Encapsulated PostScript, or HTML MAP
174 formats. This is in units of points (1/72th inch). The default
175 is 0.
176 -fli[pvisualhints]
178 Flip left/right mouse indicator messages for mice whose buttons
179 have been switched. The default is to NOT flip the messages.
180 -flu[shleft]
182 Set the print option to print the figure flush left. The de‐
183 fault is to center the figure on the page.
184 -free[hand_resolution] resolution
186 Set the resolution of the freehand drawing mode to resolution
187 pixels. This is the number of pixels the mouse must move before
188 xfig adds another point to the object being drawn.
189 -geom[etry] [WxH][+X+Y]
191 You may use the -geometry option or resource to size and/or po‐
192 sition the xfig window, or you may use -pwidth and/or -pheight
193 to specify the canvas size in inches or centimeters. If you use
194 the -geom option to make the xfig window smaller than the de‐
195 fault, you may have to use the -but_per_row option to tell xfig
196 to put 3 or 4 buttons per row on the left mode panel.
197 -gh[ostscript] ghostscript executable
199 Specify the name or path to the ghostscript executable. The de‐
200 fault is gs. This is needed when importing PDF or Encapsulated
201 PostScript files. To disable calling ghostscript, set to the
202 empty string, -ghostscript "".
203 -grid_c[olor] color
205 Draw the grid on the canvas in this color (default: red).
206 -grid_u[nit] unit
208 Only used when in inches mode to choose between showing frac‐
209 tions or decimal inches in the rulers and grid. Any of the fol‐
210 lowing may be used to force decimal inches: "ten", "tenth", "10,
211 "1/10". If any other value is used for this option, the rulers
212 will show 1/16 inch divisions.
213 -hidd[entext]
215 Start xfig with the hidden text mode for text objects. The Hid‐
216 den attribute is used for figures that will be used with LaTeX
217 and is applicable only to the display of the document in xfig.
218 It means that the text itself is not shown onscreen, but only
219 the string ``<text>''. This is to keep long sequences of LaTeX
220 formatting commands from making the screen messy and hard to
221 read. The default for the Hidden flag is off.
222 -dontshowd[epthmanager]
224 Hide the depth manager panel. The default is to show the panel.
225 -icon_[view]
227 Show the library objects as icons. This is the default. The
228 other mode is -list_view.
229 -iconG[eometry] +X+Y
231 Specifies the position for the icon.
232 -ima[ge_editor] editor
234 Specify bitmap editor to use when ``Edit Image'' button is
235 pressed in Picture Object panel.
236 -inc[hes] (or -imp[erial])
238 Make inches the unit of choice. This is the default.
239 -ins[tallowncmap]
241 Install own colormap. Normally, xfig uses the current colormap.
242 -internalBW width
244 Use lines of width width between all buttons and panels (default
245 1).
246 -jpeg[_quality] quality
248 Set the quality factor for exporting to the jpeg format. The
249 default is 75.
250 -k[eyFile] compose-key-file
252 Use compose-key-file instead of CompKeyDB for compose (meta) key
253 database. If there are no ``/''s in the name, the file must re‐
254 side in the xfig library directory, $XFIGLIBDIR, usually
255 /usr/local/lib/X11/xfig. If there are any ``/''s in the name it
256 is taken as is (not relative to $XFIGLIBDIR). If there is a
257 leading ``~/'' in the string then the ``~'' is expanded to the
258 user's home directory.
259 -lan[dscape]
261 Make xfig come up in landscape mode (10.5" x 8"). This is the
262 default; however as the orientation is stored with Fig files,
263 when you load a Fig file the orientation will change as re‐
264 quired. This is only true for files of version 3.0 or higher.
265 See also -portrait.
266 -lat[exfonts]
268 Start xfig with LaTeX font selection. Normally, the PostScript
269 fonts are available as the default. This flag selects the LaTeX
270 fonts to start.
271 -le[ft]
273 Change the position of the side panel window to the left of the
274 canvas window. This is the default.
275 -library_d[ir] [directory | file]
277 Specify directory or file containing directory names where Fig
278 object libraries are located. There may be sub-directories
279 there and sub-sub-directories, etc.
280 -library_i[con_size] size
282 Specify the size of the icons shown for library objects. The
283 default is 60 pixels, with the minimum being 40 and the maximum
284 being 120.
285 -lis[t_view]
287 Show the library objects as a list of names. The default mode is
288 -icon_view.
289 -mag[nification] mag
291 Set export and print magnification in %.
292 -max[_image_colors] numcols
294 Limit the number of colors used for imported images to numcols
295 (default 64).
296 -me[tric]
298 Make centimeters the unit of choice. The option -centimeters
299 may also be used. Fig files saved in metric mode are, due to
300 rounding issues, scaled down by about 5% when saved, and scaled
301 up when read in. Using -inches or -imperial avoids the scaling.
302 After xfig is started you may change the units from metric to
304 imperial or vice versa from a popup menu available by pressing
305 mouse button 3 in the units box where the two rulers meet.
306 -mo[nochrome]
308 Use black and white only.
309 -mu[ltiple]
311 Sets multiple page mode for print or export. See also -single.
312 -nointernational
314 Switch off international support. This can be done if text ob‐
315 jects only contain ASCII characters. (Characters beyond ASCII
316 are interpreted as Latin 1). If there are error messages when
317 starting xfig regarding "missing charsets in string to fontset
318 conversion", setting this option avoids the error.
319 -noo[verlap]
321 When exporting in multiple page mode, causes no overlap from
322 page to page. This is the default. See also -overlap.
323 -nor[mal] font
325 Cause the font used for the message window to be font. This
326 font is also used on the canvas when the global settings "Show
327 line lengths" or "Show vertex numbers" are true (default =
328 6x13).
329 -nosp[lash]
331 Don't show the startup splash screen. The default is to show it
332 ( -splash ).
333 -not[rack]
335 Turn off cursor (mouse) tracking arrows.
336 -nowrite_bak
338 When saving a drawing into an existing .fig file xfig will first
339 rename that file by appending ".bak" to the name. This option
340 disables this feature.
341 -ov[erlap]
343 When exporting in multiple page mode, causes overlap from page
344 to page of about 10%. See also -nooverlap.
345 -pag[eborder] color
347 Draw the page border on the canvas in this color (default light
348 blue). The page border is turned on by the -showpageborder op‐
349 tion (resource Fig.showpageborder), and shows the edges of the
350 current export paper size.
351 -pap[er_size] size
353 Set the initial paper size for Export and Print. Choices are
354 Option Paper Size
356 ---------------------------------
357 letter Letter 8.5in x 11in
358 legal Legal 8.5in x 14in
359 tabloid Tabloid 17in x 11in
360 a ANSI A 8.5in x 11in
361 b ANSI B 11in x 17in
362 c ANSI C 17in x 22in
363 d ANSI D 22in x 34in
364 e ANSI E 34in x 44in
365 a9 ISO A9 37mm x 52mm
366 a8 ISO A8 52mm x 74mm
367 a7 ISO A7 74mm x 105mm
368 a6 ISO A6 105mm x 148mm
369 a5 ISO A5 148mm x 210mm
370 a4 ISO A4 210mm x 297mm
371 a3 ISO A3 297mm x 420mm
372 a2 ISO A2 420mm x 594mm
373 a1 ISO A1 594mm x 840mm
374 a0 ISO A0 840mm x 1189mm
375 b10 JIS B10 32mm x 45mm
376 b9 JIS B9 45mm x 64mm
377 b8 JIS B8 64mm x 91mm
378 b7 JIS B7 91mm x 128mm
379 b6 JIS B6 128mm x 182mm
380 b5 JIS B5 182mm x 257mm
381 b4 JIS B4 257mm x 364mm
382 b3 JIS B3 364mm x 515mm
383 b2 JIS B2 515mm x 728mm
384 b1 JIS B1 728mm x 1030mm
385 b0 JIS B0 1030mm x 1456mm
386 ---------------------------------
387 Note that this doesn't affect the size of the drawing canvas.
389 Use the -pheight and -pwidth options for that.
390 -ph[eight] height
392 Make the xfig canvas height high (where height is either cm or
393 in, depending on the -metric setting).
394 -po[rtrait]
396 Make xfig come up in portrait mode (8.5" x 9"). See note about
397 landscape mode.
398 -pw[idth] width
400 Make the xfig canvas width wide (where width is either cm or in,
401 depending on the -metric setting).
402 -righ[t]
404 Change the position of the side panel window to the right of the
405 canvas window (default: left).
406 -rigi[d]
408 Start xfig with the rigid text mode for text objects. The Rigid
409 attribute forces text to remain the same size even if inside a
410 compound object that is scaled up or down. The default is off.
411 -ru[lerthick]
413 Set the height(width) of the top(side) rulers in pixels. The
414 default (and minimum) is 24.
415 -scale_factor scale
417 Scale every figure read in by this value. This is useful in
418 conjunction with the -update option to do batch scaling of fig‐
419 ures.
420 -showa[llbuttons]
422 Show all the xfig indicator buttons instead of only those rele‐
423 vant to the current drawing mode. Normally, the buttons line
424 width, area-fill, grid mode, text size, etc. are only visible
425 when they are relevant to the current drawing mode. The
426 -showallbuttons option makes all of the indicator buttons visi‐
427 ble at all times. This takes up more screen real estate, but
428 allows the user to see all settable parameters.
429 -showb[alloons]
431 Forces xfig to pop up the information balloons when the mouse
432 passws over a button. This is the default. See also -dontshow‐
433 balloons .
434 -showd[epthmanager]
436 Show the depth manager panel. This panel lets one show or hide
437 objects at various depths. This is the default.
438 -showl[engths]
440 Makes xfig show the lengths of lines being drawn, in red text
441 near the line itself. Also, when points are moved or added. In
442 addition, imagine a triangle formed with the line segment as the
443 hypotenuse, and a vertical and horizontal line forming the other
444 two sides. These lines and their lengths are also drawn in red
445 as the point is moved or added. This mode is ignored when draw‐
446 ing in freehand mode.
447 This flag may be toggled by pressing <Meta>i (default).
448 -shown[ums]
450 With this option, xfig will draw all objects with a red number
451 next to each vertex. This is generally only useful for debug‐
452 ging.
453 -showp[ageborder]
455 Makes xfig show the border of the current paper size in the
456 color specified by the -pageborder option (default: light blue).
457 -showz[erolines]
459 Show axis zero lines on the canvas. This is the default
460 -si[ngle]
462 Sets single page mode for print or export. This is the default.
463 See also -multiple.
464 -sm[ooth_factor] factor
466 Enable smoothing when exporting to the bitmap formats (e.g. GIF,
467 PNG, etc.). The allowed values are 0 (no smoothing), 2 or 4
468 (most smoothing). This parameter is passed to ghostscript in
469 the -dTextAlphaBits -dGraphicsAlphaBits options to smooth the
470 figure.
471 -spec[ialtext]
473 Start xfig with the TeX text mode for text objects. This means
474 that characters that have a special meaning to TeX/LaTeX, e.g.,
475 '$' or '\', are not quoted but left untouched in the text
476 string. This is most useful for writing LaTeX equations. If
477 this flag is not set, then the backslash character '\' is
478 changed to the \backslash command, a brace '{' is turned into a
479 brace command \{, etc.
480 -spel[lcheckcommand] command
482 Use command for the external spell checking program when using
483 the spell check/search/replace popup. The string command should
484 include the string ``%s'' which is replaced by a temporary file‐
485 name. Default is ``spell %s''.
486 -spinner_d[elay] msec
488 The delay (in milliseconds) before the spinner will automati‐
489 cally count up or down when the button is pressed. Spinners are
490 the (numeric) text widgets with an up- and down-arrow, which
491 when clicked, cause the value to be incremented/decremented.
492 The default is 500 milliseconds.
493 -spinner_r[rate] msec
495 The rate (in milliseconds) at which the spinner will count when
496 the up- or down-arrow is pressed.
497 -startfi[llstyle] stylenumber
499 Set the starting fill style for area fill (-1 to 21).
500 -startfo[ntsize] pointsize
502 Set the default font size for text objects (default = 12pt).
503 -startg[ridmode] modenumber
505 Set the starting grid mode (0 to 3). Mode 0 is no grid. In im‐
506 perial (inches) mode, grid mode 1 is 1/4 inch, mode 2 is 1/2
507 inch and mode 3 is 1 inch. In metric mode, grid mode 1 is 2mm,
508 mode 2 is 5mm and mode 3 is 1cm.
509 -startla[texFont] font
511 Set the starting font name for LaTeX fonts.
512 -startli[newidth] width
514 Set the starting line width.
515 -startpo[snmode] modenumber
517 Set the starting point positioning mode (0 to 4) In imperial
518 (inches) mode, positioning mode 0 is ``any'', mode 1 is 1/16
519 inch, mode 2 is 1/4 inch, mode 3 is 1/2 inch and mode 4 is 1
520 inch. In metric mode, mode 0 is ``any'', mode 1 is 1mm, mode 2
521 is 5mm, mode 3 is 10mm and mode 4 is 20mm.
522 -startp[sFont] font
524 Set the starting font name for PostScript fonts.
525 -startt[extstep] stepsize
527 Set the starting text step.
528 -ta[blet]
530 Specifies that xfig should use the input tablet instead of the
531 mouse for drawing. You must have the XInputExtension in your X
532 server and an input tablet for this to work.
533 -track
535 Turn on cursor (mouse) tracking arrows (default).
536 -tran[sparent_color] color_number
538 Make the transparent color for GIF export color_number. This
539 number is the color number according to the xfig color panel,
540 starting at 0 (black) and ending at 31 (gold), or may be a user-
541 defined color number, which is 32 or higher.
542 -update file [ file ... ]
544 Run xfig in an "update" mode, where it will read each Fig file
545 specified on the command line and write it out to the original
546 file, in the current file format for the version of xfig being
547 run. The original Fig file will be preserved with the suffix
548 .bak attached to the name. In this mode, xfig exits when fin‐
549 ished, and no window is opened.
550 -users[cale] scale
552 Set the multiplier for displayed line lengths etc. This factor
553 is multiplied by the actual length, radius or diameter of the
554 object currently being drawn on the canvas. It is useful for
555 making scale drawings, where e.g. 1 inch = 1 foot (userscale =
556 12.0) or 1cm = 1m (userscale = 100.0).
557 -useru[nit] units
559 The units string is printed with the length information when
560 drawing objects. For example if the userscale = 1.0 and the
561 userunit = ft then a line which is 3 inches long on the canvas
562 would be displayed as ``length = 3 ft'' when it is being drawn.
563 After xfig is started you may change the userscale and the
565 userunit from a popup menu available by pressing mouse button 3
566 in the units box where the two rulers meet.
567 -visual visualname
569 Use visualname as the visual for xfig. The names are TrueColor
570 (case is not important), StaticColor, DirectColor, StaticGray,
571 GrayScale and PseudoColor. xfig uses the default visual unless
572 this is specified. Your server must support the desired visual.
573 Use xdpyinfo to see what visuals and depths are supported. See
574 also the -depth option.
575 -write_bak
577 When saving a drawing into an existing .fig file xfig will first
578 rename that file by appending
579 -zoom zoomscale
581 Set the starting zoom scale.
582
586 The overall widget name(Class) is xfig(Fig). These resources corre‐
587 spond to the command line arguments:
588 Name Type Default Command-line equivalent
590 -------------------------------------------------------------------
591 allownegcoords boolean true -allownegcoords (true),
592 -dontallownegcoords (false)
593 autorefresh boolean false -autorefresh
594 axislines string pink -axislines
595 balloon_delay integer 500 (ms) -balloon_delay
596 but_per_row integer 2 -but_per_row
597 buttonFont string 6x13 -button
598 canvasbackground string white -cbg
599 canvasforeground string black -cfg
600 correctfontsize boolean false -correctfontsize
601 debug boolean false -debug
602 depth integer * -depth
603 dontswitchcmap boolean false -dontswitchcmap
604 exportLanguage string eps -exportLanguage
605 export_margin integer 0 -export_margin
606 flipvisualhints boolean false -flipvisualhints
607 flushleft boolean false -flushleft (true),
608 -center (false)
609 freehand_resolution integer 25 -freehand_resolution
610 grid_color string black -grid_color
611 grid_unit string 1/16 (inch) -grid_unit
612 0.1 (metric)
613 hiddentext boolean false -hiddentext
614 icon_view boolean true -icon_view (true),
615 -list_view (false)
616 image_editor string xv -image_editor
617 inches boolean true -inches (true),
618 -imperial (true),
619 -centimeters (false),
620 -metric (false)
621 installowncmap boolean false -installowncmap
622 internalborderwidth integer 1 -internalBW
623 international boolean true -international (true),
624 -nointernational (false)
625 jpeg_quality integer 75 -jpeg_quality
626 justify boolean false -left (false),
627 -right (true)
628 keyFile string CompKeyDB -keyFile
629 landscape boolean true -Landscape (true),
630 -landscape (true),
631 -Portrait (false),
632 -portrait (false)
633 latexfonts boolean false -latexfonts
634 library_dir string ~/xfiglib -library_dir
635 magnification float 100 -magnification
636 max_image_colors integer 64 -max_image_colors
637 monochrome boolean false -monochrome
638 multiple boolean false -multiple
639 normalFont string 6x13 -normal
640 overlap boolean true -overlap (true),
641 -nooverlap (false)
642 pageborder string lightblue -pageborder
643 paper_size string Letter (inch) -paper_size
644 A4 (metric)
645 pheight float 8.5 (landscape) -pheight
646 9.5 (portrait)
647 pwidth float 11 (landscape) -pwidth
648 8.5 (portrait)
649 rigidtext boolean false -rigid (true)
650 rulerthick integer 24 -rulerthick
651 scale_factor float 1.0 -scale_factor
652 showallbuttons boolean false -showallbuttons
653 showaxislines boolean true -showaxislines (true),
654 -dontshowaxislines (false)
655 showballoons boolean true -showballoons (true),
656 -dontshowballoons (false)
657 showdepthmanager boolean true -showdepthmanager (true),
658 -dontshowdepthmanager (false)
659 showlengths boolean false -showlengths (true),
660 -dontshowlengths (false)
661 shownums boolean false -shownums (true),
662 -dontshownums (false)
663 showpageborder boolean true -showpageborder (true),
664 -dontshowpageborder (false)
665 single boolean true -single
666 smooth_factor integer 0 -smooth_factor
667 specialtext boolean false -specialtext
668 splash boolean true -splash (true),
669 -nosplash (false)
670 spellcheckcommand string spell %s -spellcheckcommand
671 spinner_delay integer 500 (ms) -spinner_delay
672 spinner_rate integer 100 (ms) -spinner_rate
673 startfillstyle integer 0 -startfillstyle
674 startfontsize float 12 -startfontsize
675 startgridmode integer 0 -startgridmode
676 startlatexFont string Default -startlatexFont
677 startlinewidth integer 1 -startlinewidth
678 startposnmode integer 1 -startposnmode
679 startpsFont string Times-Roman -startpsFont
680 starttextstep float 1.2 -starttextstep
681 tablet boolean false -track,
682 trackCursor boolean true -track (true),
683 -notrack (false)
684 transparent_color integer -2 (none) -transparent_color
685 userscale float 1.0 -userscale
686 userunit string in (inches) -userunit
687 cm (metric)
688 visual string * -visual
689 write_bak boolean true -write_bak
690 zoom float 1.0 -zoom
691 * Default visual and depth depend on the X server. Use xdpyinfo
693 to see what visuals and depths are supported.
694 -------------------------------------------------------------------
695
698 Please send bug reports, fixes, new features etc. to:
699 thomas.loimer@tuwien.ac.at
700 Because of the difference of the fonts shown on the canvas and the
702 PostScript fonts on printers, text alignment can be problematic.
703 Not all operations employ smart redrawing of objects which are altered
705 as a by product of the operation. You may need to use Redraw in these
706 cases.
707 If the image is panned or the xfig window iconified and de-iconified
709 during the middle of an operation (e.g. while drawing a line), the pic‐
710 ture will be distorted. This can be corrected using Redraw after the
711 operation is complete.
712 When zoomed very large, the length of dashes in dashed lines will top
714 out at 255 pixels long. This is due to a restriction in X that the
715 dash list is defined by char (255 pixels maximum for a dash). The fig‐
716 ure will print correctly, however.
717 When you do a copy/rotate with multiple copies, only the creation of
719 the last object can be undone with the Undo button.
720 Modifications to text using the popup search/update/replace/spell check
722 panel cannot be undone.
723
725 fig2dev(1) (Fig2dev package)
726 gs(1) (Ghostscript PostScript previewer)
728
730 (From the original author, Supoj Sutanthavibul): Many thanks goes to
731 Professor Donald E. Fussell who inspired the creation of this tool.
732 (From Brian Smith): Thanks to all the users who have contributed to
734 xfig, especially Paul King who, besides adding many features, revamped
735 the look and feel which became version 2.1.
736
738 Original Copyright (c) 1985 by Supoj Sutanthavibul
739 Parts Copyright (c) 1989-2015 by Brian V. Smith
740 Parts Copyright (c) 1991 by Paul King
741 Parts Copyright (c) 2016-2018 by Thomas Loimer
742 Other Copyrights may be found in various files
743 Any party obtaining a copy of these files is granted, free of charge, a
746 full and unrestricted irrevocable, world-wide, paid up, royalty-free,
747 nonexclusive right and license to deal in this software and documenta‐
748 tion files (the "Software"), including without limitation the rights to
749 use, copy, modify, merge, publish and/or distribute copies of the Soft‐
750 ware, and to permit persons who receive copies from any such party to
751 do so, with the only requirement being that this copyright notice re‐
752 main intact.
753 THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, IN‐
755 CLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
756 EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSE‐
757 QUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
758 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
759 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PER‐
760 FORMANCE OF THIS SOFTWARE.
761 PostScript is a trademark of Adobe Systems Incorporated.
764 Parts Copyright (C) 1989 by Jef Poskanzer.
766 Copyright notice for pbmplus code:
767 Permission to use, copy, modify, and distribute this
769 software and its documentation for any purpose and without
770 fee is hereby granted, provided that the above copyright
771 notice appear in all copies and that both that copyright
772 notice and this permission notice appear in supporting
773 documentation. This software is provided ``as is'' without
774 express or implied warranty.
775
777 /usr/share/xfig/CompKeyDB
778 Data base of compose (meta) key sequences for 8-bit characters.
779 A different file may be specified with the command line option
780 -keyFile or X toolkit resource keyFile.
781 /usr/share/doc/xfig/html
783 This directory contains the html documentation.
784 /usr/share/doc/xfig/FORMAT3.2
786 Description of Fig file format.
787 /usr/share/xfig/Libraries
789 This directory contains libraries of Fig objects such as elec‐
790 trical symbols, logic symbols, etc.
791 /usr/share/X11/app-defaults/Fig
793 Application defaults file.
794 /usr/share/applications/xfig.desktop
796 Desktop entry file.
797 /usr/share/pixmaps/xfig.png
799 Desktop icon.
800
803 Many people have contributed to xfig. Here is a list of the people who
804 have contributed the most (in chronological order):
805 Version 1:
807 Original author:
810 Supoj Sutanthavibul, University of Texas at Austin
811 The LaTeX line drawing modes were contributed by:
813 Frank Schmuck, Cornell University
814 Original X11 port by:
816 Ken Yap, Rochester
817 Variable window sizes, cleanup of X11 port, right hand side panel:
819 Dana Chee, Bellcore
820 Cleanup of color port to X11 by:
822 John T. Kohl, MIT
823 Version 2.0:
825 Area fill, multiple line thicknesses, multiple fonts and font
828 sizes, bottom panel, line style/thickness, (and anything else that
829 wasn't written by the others) by:
830 Brian Smith
831 (standard disclaimer applies)
832 (bvsmith@lbl.gov)
833 Popup change-object menu by:
835 Jon Tombs
836 Frank Schmuck
837 Zooming and panning functions, shift key select mechanism by:
839 Dieter Pellkofer
840 Henning Spruth
841 Depth feature by:
843 Mike Lutz
844 Cut/Paste by:
846 Tom Tkacik
847 Version 2.1:
849 Indicator panel, file menu popup, print menu popup, panning with
852 rulers, mouse function window, regular polygon, rubberbanding of
853 circles/ellipses, filled splines on canvas, dashed/dotted splines
854 on canvas, update button, arbitrary angle rotation of objects,
855 alignment in compound, object scaling, constrained copy/move, cor‐
856 ner markers for compound, context sensitive corner markers, smarter
857 redraw, undo for compound and point move for boxes, cancel object
858 creation, point positioning to three resolutions, TransFig scalable
859 text, hidden text, special text, save of figure on crash by:
860 Paul King (king@cs.uq.oz.au)
862 with help from:
863 Brian Smith and Micah Beck (beck@cs.utk.edu)
864 Encapsulated PostScript importing by:
866 Brian Boyter
867 Pan/zoom with ctrl key/mouse by:
869 Henning Spruth
870 International characters by:
872 Herve Soulard
873 Directory Browser based on XDir by:
875 Win Treese, Digital Equipment Corporation
876 Rotated ellipses by:
878 James Tough, Dept. of Computer Science, Heriot-Watt University,
879 Scotland
880 Rotated text from the xvertext package by:
882 Alan Richardson, Space Science Centre, School of MAPS, University
883 of Sussex
884 Popup scale menu and dynamic switching between inches and cm by:
886 Paul King (king@cs.uq.oz.au)
887 Extensive man page formatting revisions by:
889 David W. Sanderson
890 Display Postscript code for IBM RS/6000 by:
892 Dave Hale (dhale@green.mines.colorado.edu)
893 Version 3.0:
895 New arrowhead types, separate pen/fill colors, new file protocol,
898 more colors with extended color popup panel, new arc style, new
899 fill patterns (bricks, etc), new line join and cap styles, export
900 offset and file load offset, XPM import, XBM import and export (and
901 anything else that wasn't written by the others) by:
902 Brian Smith
903 (Note: the color popup panel was based on xcoloredit by Richard
904 Hesketh)
905 GIF header reading code by:
908 David Koblas from the giftoppm part of the pbmplus package
909 XPM export code (using XPM3 libraries) by:
911 Karel van Houten (K.H.C.vanHouten@research.ptt.nl)
912 Higher figure resolution (1200dpi) by:
914 Ross Martin (martin@trcsun3.eas.asu.edu)
915 Color quantization using neural network by:
917 Anthony Dekker (dekker@ACM.org)
918 [NEUQUANT Neural-Net quantization algorithm by Anthony Dekker,
919 1994. See ``Kohonen neural networks for optimal colour quantiza‐
920 tion'' in ``Network: Computation in Neural Systems'' Vol. 5 (1994)
921 pp 351-367. for a discussion of the algorithm.]
922 Floyd-Steinberg algorithm for dithering color images on monochrome
924 displays lifted from the Pbmplus package by Jef Poskanser.
925 rotate/flip objects around/about selected anchor point and multiple
927 copies of objects by:
928 Uwe Bonnes (bon@lte.e-technik.uni-erlangen.de)
929 Input tablet extension by:
931 Greg LaCoste (greg@seismo.do.usbr.gov)
932 Version 3.1:
934 The only difference between protocol version 3.0 and version 3.1 is
937 that the position of the ``magnet'' has been shifted by 14 fig
938 units. In the 2.1 and older versions of xfig the grid was in mul‐
939 tiples of 5 fig units, but they were on intervals 4, 9, 14, 19,
940 etc. When version 3.0 was created, coordinates were simply multi‐
941 plied by the ratio of the resolutions (1200/80 = 15) so values like
942 4 became 60 instead of 74 ((4+1)*15 - 1).
943 The JPEG import/export code uses the Independent JPEG Group soft‐
945 ware (see jpeg/README for details)
946 Image browser, editor and screen capture features by:
948 Jim Daley (jdaley@cix.compulink.co.uk)
949 Version 3.2:
951 The changes to the version 3.2 file protocol are the addition of
954 the paper size, print/export magnification, single/multiple page
955 indicator and a transparent color name used for GIF export to the
956 header of the file.
957 The other difference in the version 3.2 protocol is the mathemati‐
958 cal model used for splines. The new version uses X-splines which
959 allows the user to mix interpolation and approximation points in a
960 same curve. More precisely, it means that an X-spline curve is nei‐
961 ther an interpolated spline nor an approximated one, it is BOTH
962 (the behaviour of each point is controlled by one single parameter
963 called ``shape factor''). For additional information about X-
964 splines, see:
965 "X-Splines: A Spline Model Designed for the End User"
967 by C. Blanc and C. Schlick, Proceedings of SIGGRAPH'95
968 http://dept-info.labri.u-bordeaux.fr/~schlick/DOC/sig1.html
969 Caveat: Because previous spline models (quadratic B-splines and
971 Bezier with hidden points) are no longer supported, curves that are
972 present in version 3.1 and older files are automatically converted
973 to X-splines. This translation is only an approximation process.
974 It means that the converted curves are not exactly the same as the
975 original ones. Though they are usually very close, some hand-fit‐
976 ting may be needed in some pathological cases.
977 Inclusion of X-splines by:
979 Carole Blanc (blanc@labri.u-bordeaux.fr)
980 Christophe Schlick (schlick@labri.u-bordeaux.fr)
981 Note: the initial implementation was done by C. Feuille, S. Gros‐
982 bois, L. Maziere and L. Minihot as a student practice (Universite
983 Bordeaux, France).
984 Open/close compound feature written by
986 Bill Taylor (bill@mainstream.com)
987 Library feature written by
989 Stephane Mancini (mancini@elecsrv.enst.fr) (object preview by Brian
990 V. Smith)
991 The library objects in the Electrical and Logic libraries were done
993 by
994 Peter Hiscocks (phiscock@ee.ryerson.ca)
995 The library objects in the Computer, Networks, and Hospital-Equip‐
997 ment libraries were extracted from the clipart example files by
998 Bill Chimiak (chim@bgsm.edu)
999 Version 3.2.3 and newer:
1002 Please see the CHANGES file for credits for newer releases.
1005
1007 Many bug fixes/cleanups etc. by a host of faithful users.
1008 See the CHANGES file for all the credits.
1010 The Fig2dev package was written by Micah Beck and is maintained by
1012 Thomas Loimer.
1013Xfig 3.2.9 Aug 2023 xfig(1)