1XFIG(1) General Commands Manual XFIG(1)
3
7 xfig - Facility for Interactive Generation of figures under X11
8 Version 3.2.4
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. 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 The bulk of the documentation fori xfig is in an HTML-based reference
21 guide. See the Help menu in xfig or point your browser at
22 Doc/html/index.html (provided with the xfig distribution, usually in
23 the Doc/www directory). There are both English and Japanese versions.
24 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 Xfig is available from http://www.xfig.org .
29 The TransFig package is used when printing or exporting the output from
31 xfig. The fig2dev program from the TransFig package is automatically
32 called by xfig as a back-end processor to produce various types of out‐
33 put:
34 LaTeX, Metafont, PostScript or Encapsulated PostScript, tk (tcl/tk tool
36 command language/tool kit package), GIF, JPEG, PCX, PNG, PPM, TIFF,
37 XBM, XPM, AutoCAD Slide, IBM-GL (HP/GL), Pic PiCTeX, box, epic, eepic
38 and eepicemu.
39 See man fig2dev for all options.
41 The TransFig package is available from http://www.xfig.org .
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 -bal[loon_delay] msec
53 Cause popup information balloons to be delayed by msec millisec‐
54 onds. The default is 500 milliseconds.
55 -bol[d] font
57 Cause the font used for displaying the file name and confirma‐
58 tion messages to be font (default = 8x13bold).
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
67 reduce 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 -enc[oding] encoding
123 Encode character set using encoding when exporting LaTeX text.
124 The default is 1. This is used for the ISO-8859 encoding of
125 character sets. Allowed values are 0 (no encoding), 1
126 (ISO-8859-1) or 2 (ISO-8859-2).
127 -exportL[anguage] language
129 Specifies the default language to be used for when exporting a
130 fig file. Choices are:
131 Name Language
133 -------------------------------------------------
134 Vector formats:
135 box LaTeX box (figure boundary)
136 latex LaTeX picture
137 epic LaTeX picture + epic macros
138 eepic LaTeX picture + eepic macros
139 eepicemu LaTeX picture + eepicemu macros
140 pictex PiCTeX macros
141 hpl HPGL (IBMGL)
142 eps Encapuslated PostScript
143 eps_ascii Encapuslated PostScript with ASCII preview
144 eps_mono_tiff Encapuslated PostScript with monochrome binary (TIFF) preview
145 eps_color_tiff Encapuslated PostScript with color binary (TIFF) preview
146 ps PostScript
147 pdf PDF (Portable Document Format)
148 pstex Combined PS/LaTeX (both PS and LaTeX parts)
149 pdftex Combined PDF/LaTeX (both PDF and LaTeX parts)
150 textyl Textyl special commands
151 tpic TPIC
152 pic PIC
153 mf MF (MetaFont)
154 mp MP (MetaPost)
155 mmp MMP (Multi-MetaPost)
156 cgm CGM (Computer Graphics Meta file)
157 bcgm Binary CGM (Computer Graphics Meta file)
158 emf Enhanced Meta file)
159 tk Tk (of the tcl/tk fame)
160 svg SVG (Scalable Vector Graphics (XML variant))
161 Bitmap formats:
163 gif GIF
164 jpeg JPEG (JFIF)
165 pcx PCX
166 png PNG
167 ppm PPM (portable pixmap package)
168 sld (AutoCad slide)
169 tiff TIFF
170 xbm X11 Bitmap
171 xpm X11 Pixmap (XPM3 package)
172 -------------------------------------------------
174 -export_m[argin] width
177 Set the size of the border margin around the figure for export‐
178 ing to bitmap, PostScript, Encapsulated PostScript, or HTML MAP
179 formats. This is in units of pixels (1/80th inch). The default
180 is 0.
181 -fli[pvisualhints]
183 Flip left/right mouse indicator messages for mice whose buttons
184 have been switched. The default is to NOT flip the messages.
185 -flu[shleft]
187 Set the print option to print the figure flush left. The
188 default is to center the figure on the page.
189 -free[hand_resolution] resolution
191 Set the resolution of the freehand drawing mode to resolution
192 pixels. This is the number of pixels the mouse must move before
193 xfig adds another point to the object being drawn.
194 -geom[etry] [WxH][+X+Y]
196 You may use the -geometry option or resource to size and/or
197 position the xfig window, or you may use -pwidth and/or -pheight
198 to specify the canvas size in inches or centimeters. If you use
199 the -geom option to make the xfig window smaller than the
200 default, you may have to use the -but_per_row option to tell
201 xfig to put 3 or 4 buttons per row on the left mode panel.
202 -gh[ostscript] postscript-interpreter
204 Select the PostScript (tm) interpreter of your choice. The
205 default is ghostscript (gs). This is needed when importing
206 Encapsulated PostScript files.
207 -grid_c[olor] color
209 Draw the grid on the canvas in this color (default: red).
210 -grid_u[nit] unit
212 Only used when in inches mode to choose between showing frac‐
213 tions or decimal inches in the rulers and grid. Any of the fol‐
214 lowing may be used to force decimal inches: "ten", "tenth", "10,
215 "1/10". If any other value is used for this option, the rulers
216 will show 1/16 inch divisions.
217 -hidd[entext]
219 Start xfig with the hidden text mode for text objects. The Hid‐
220 den attribute is used for figures that will be used with LaTeX
221 and is applicable only to the display of the document in xfig.
222 It means that the text itself is not shown onscreen, but only
223 the string ``<text>''. This is to keep long sequences of LaTeX
224 formatting commands from making the screen messy and hard to
225 read. The default for the Hidden flag is off.
226 -dontshowd[epthmanager]
228 Hide the depth manager panel. The default is to show the panel.
229 -icon_[view]
231 Show the library objects as icons. This is the default. The
232 other mode is -list_view.
233 -iconG[eometry] +X+Y
235 Specifies the position for the icon.
236 -im[age_editor] editor
238 Specify bitmap editor to use when ``Edit Image'' button is
239 pressed in Picture Object panel.
240 -inc[hes] (or-imperial)
242 Make inches the unit of choice. This is the default.
243 -ins[tallowncmap]
245 Install own colormap. Normally, xfig uses the current colormap.
246 -internalBW width
248 Use lines of width width between all buttons and panels (default
249 = 1).
250 -international
252 Switch on international support (mainly Japanese and Korean),
253 users of ISO Latin 1 (ISO-8859-1) probably should not use this,
254 therefore the international support is switched off by default
255 for locales using ISO-8859-1* codesets. For all other locales
256 this option is already used by default.
257 -jpeg[_quality] quality
259 Set the quality factor for exporting to the jpeg format. The
260 default is 75.
261 -k[eyFile] compose-key-file
263 Use compose-key-file instead of CompKeyDB for compose (meta) key
264 database. If there are no ``/''s in the name, the file must
265 reside in the xfig library directory, $XFIGLIBDIR, usually
266 /usr/local/lib/X11/xfig. If there are any ``/''s in the name it
267 is taken as is (not relative to $XFIGLIBDIR). If there is a
268 leading ``~/'' in the string then the ``~'' is expanded to the
269 user's home directory.
270 -lan[dscape]
272 Make xfig come up in landscape mode (10.5" x 8"). This is the
273 default; however as the orientation is stored with Fig files,
274 when you load a Fig file the orientation will change as
275 required. This is only true for files of version 3.0 or higher.
276 See also -portrait.
277 -lat[exfonts]
279 Start xfig with LaTeX font selection. Normally, the PostScript
280 fonts are available as the default. This flag selects the LaTeX
281 fonts to start.
282 -le[ft]
284 Change the position of the side panel window to the left of the
285 canvas window. This is the default.
286 -library_d[ir] directory
288 Specify directory where Fig object libraries are located. There
289 may be sub-directories there and sub-sub-directories, etc.
290 -library_i[con_size] size
292 Specify the size of the icons shown for library objects. The
293 default is 60 pixels, with the minimum being 40 and the maximum
294 being 120.
295 -lis[t_view]
297 Show the library objects as a list of names. The default mode is
298 -icon_view.
299 -mag[nification] mag
301 Set export and print magnification in %.
302 -max[_image_colors] numcols
304 Limit the number of colors used for imported images to numcols
305 (default 64).
306 -me[tric]
308 Make centimeters the unit of choice. The option -centimeters
309 may also be used.
310 After xfig is started you may change the units from metric to
312 imperial or vice versa from a popup menu available by pressing
313 mouse button 3 in the units box where the two rulers meet.
314 -mo[nochrome]
316 Use black and white only.
317 -mu[ltiple]
319 Sets multiple page mode for print or export. See also -single.
320 -noo[verlap]
322 When exporting in multiple page mode, causes no overlap from
323 page to page. This is the default. See also -overlap.
324 -nor[mal] font
326 Cause the font used for the message window to be font. This
327 font is also used on the canvas when the selected font is not
328 available in an X11 font (default = 6x13).
329 -nosc[alablefonts]
331 Disables use of the X11R5 or OpenWindows scalable fonts. You
332 might want to use this for debugging.
333 -nosp[lash]
335 Don't show the startup splash screen. The default is to show it
336 ( -splash ).
337 -not[rack]
339 Turn off cursor (mouse) tracking arrows.
340 -ov[erlap]
342 When exporting in multiple page mode, causes overlap from page
343 to page of about 10%. See also -nooverlap.
344 -pag[eborder] color
346 Draw the page border on the canvas in this color (default light
347 blue). The page border is turned on by the -showpageborder
348 option (resource Fig.showpageborder), and shows the edges of the
349 current export paper size.
350 -pap[er_size] size
352 Set the initial paper size for Export and Print. Choices are
353 Option Paper Size
355 ---------------------------------
356 letter Letter 8.5in x 11in
357 legal Legal 8.5in x 14in
358 tabloid Tabloid 17in x 11in
359 a ANSI A 8.5in x 11in
360 b ANSI B 11in x 17in
361 c ANSI C 17in x 22in
362 d ANSI D 22in x 34in
363 e ANSI E 34in x 44in
364 a9 ISO A9 37mm x 52mm
365 a8 ISO A8 52mm x 74mm
366 a7 ISO A7 74mm x 105mm
367 a6 ISO A6 105mm x 148mm
368 a5 ISO A5 148mm x 210mm
369 a4 ISO A4 210mm x 297mm
370 a3 ISO A3 297mm x 420mm
371 a2 ISO A2 420mm x 594mm
372 a1 ISO A1 594mm x 840mm
373 a0 ISO A0 840mm x 1189mm
374 b10 JIS B10 32mm x 45mm
375 b9 JIS B9 45mm x 64mm
376 b8 JIS B8 64mm x 91mm
377 b7 JIS B7 91mm x 128mm
378 b6 JIS B6 128mm x 182mm
379 b5 JIS B5 182mm x 257mm
380 b4 JIS B4 257mm x 364mm
381 b3 JIS B3 364mm x 515mm
382 b2 JIS B2 515mm x 728mm
383 b1 JIS B1 728mm x 1030mm
384 b0 JIS B0 1030mm x 1456mm
385 ---------------------------------
386 Note that this doesn't affect the size of the drawing canvas.
388 Use the -pheight and -pwidth options for that.
389 -ph[eight] height
391 Make the xfig canvas height high (where height is either cm or
392 in, depending on the -metric setting).
393 -po[rtrait]
395 Make xfig come up in portrait mode (8.5" x 9"). See note about
396 landscape mode.
397 -pw[idth] width
399 Make the xfig canvas width wide (where width is either cm or in,
400 depending on the -metric setting).
401 -righ[t]
403 Change the position of the side panel window to the right of the
404 canvas window (default: left).
405 -rigi[d]
407 Start xfig with the rigid text mode for text objects. The Rigid
408 attribute forces text to remain the same size even if inside a
409 compound object that is scaled up or down. The default is off.
410 -ru[lerthick]
412 Set the height(width) of the top(side) rulers in pixels. The
413 default (and minimum) is 24.
414 -scala[blefonts]
416 Allows use of the X11R5 or OpenWindows scalable fonts (this is
417 the default). If the scalable fonts aren't available xfig will
418 automatically switch to non-scaling fonts.
419 -scale_factor scale
421 Scale every figure read in by this value. This is useful in
422 conjunction with the -update option to do batch scaling of fig‐
423 ures.
424 -showa[llbuttons]
426 Show all the xfig indicator buttons instead of only those rele‐
427 vant to the current drawing mode. Normally, the buttons line
428 width, area-fill, grid mode, text size, etc. are only visible
429 when they are relevant to the current drawing mode. The
430 -showallbuttons option makes all of the indicator buttons visi‐
431 ble at all times. This takes up more screen real estate, but
432 allows the user to see all settable parameters.
433 -showb[alloons]
435 Forces xfig to pop up the information balloons when the mouse
436 passws over a button. This is the default. See also -dontshow‐
437 balloons .
438 -showd[epthmanager]
440 Show the depth manager panel. This panel lets one show or hide
441 objects at various depths. This is the default.
442 -showl[engths]
444 Makes xfig show the lengths of lines being drawn, in red text
445 near the line itself. Also, when points are moved or added. In
446 addition, imagine a triangle formed with the line segment as the
447 hypotenuse, and a vertical and horizontal line forming the other
448 two sides. These lines and their lengths are also drawn in red
449 as the point is moved or added. This mode is ignored when draw‐
450 ing in freehand mode.
451 This flag may be toggled by pressing <Meta>i (default).
452 -shown[ums]
454 With this option, xfig will draw all objects with a red number
455 next to each vertex. This is generally only useful for debug‐
456 ging.
457 -showp[ageborder]
459 Makes xfig show the border of the current paper size in the
460 color specified by the -pageborder option (default: light blue).
461 -showz[erolines]
463 Show axis zero lines on the canvas. This is the default
464 -si[ngle]
466 Sets single page mode for print or export. This is the default.
467 See also -multiple.
468 -sm[ooth_factor] factor
470 Enable smoothing when exporting to the bitmap formats (e.g. GIF,
471 PNG, etc.). The allowed values are 0 (no smoothing), 2 or 4
472 (most smoothing). This parameter is passed to ghostscript in
473 the -dTextAlphaBits -dGraphicsAlphaBits options to smooth the
474 figure.
475 -spec[ialtext]
477 Start xfig with the special text mode for text objects. Special
478 text means that special characters in the string are not spe‐
479 cially processed but are passed directly to LaTeX. This is most
480 useful for writing LaTeX equations. If this flag is not set,
481 then the backslash character '\' is changed to the \backslash
482 command, a brace '{' is turned into a brace command \{, etc.
483 -spel[lcheckcommand] command
485 Use command for the external spell checking program when using
486 the spell check/search/replace popup. The string command should
487 include the string ``%s'' which is replaced by a temporary file‐
488 name. Default is ``spell %s''.
489 -spinner_d[elay] msec
491 The delay (in milliseconds) before the spinner will automati‐
492 cally count up or down when the button is pressed. Spinners are
493 the (numeric) text widgets with an up- and down-arrow, which
494 when clicked, cause the value to be incremented/decremented.
495 The default is 500 milliseconds.
496 -spinner_r[rate] msec
498 The rate (in milliseconds) at which the spinner will count when
499 the up- or down-arrow is pressed.
500 -startfi[llstyle] stylenumber
502 Set the starting fill style for area fill (-1 to 21).
503 -startfo[ntsize] pointsize
505 Set the default font size for text objects (default = 12pt).
506 -startg[ridmode] modenumber
508 Set the starting grid mode (0 to 3). Mode 0 is no grid. In
509 imperial (inches) mode, grid mode 1 is 1/4 inch, mode 2 is 1/2
510 inch and mode 3 is 1 inch. In metric mode, grid mode 1 is 5mm,
511 mode 2 is 1cm and mode 3 is 2cm.
512 -startla[texFont] font
514 Set the starting font name for LaTeX fonts.
515 -startli[newidth] width
517 Set the starting line width.
518 -startpo[snmode] modenumber
520 Set the starting point positioning mode (0 to 4) In imperial
521 (inches) mode, positioning mode 0 is ``any'', mode 1 is 1/16
522 inch, mode 2 is 1/4 inch, mode 3 is 1/2 inch and mode 4 is 1
523 inch. In metric mode, mode 0 is ``any'', mode 1 is 1mm, mode 2
524 is 5mm, mode 3 is 10mm and mode 4 is 20mm.
525 -startp[sFont] font
527 Set the starting font name for PostScript fonts.
528 -startt[extstep] stepsize
530 Set the starting text step.
531 -ta[blet]
533 Specifies that xfig should use the input tablet instead of the
534 mouse for drawing. You must have the XInputExtension in your X
535 server and an input tablet for this to work. Also, you must
536 modify the Imakefile to include the USETAB and TABLIB variables.
537 -track
539 Turn on cursor (mouse) tracking arrows (default).
540 -tran[sparent_color] color_number
542 Make the transparent color for GIF export color_number. This
543 number is the color number according to the xfig color panel,
544 starting at 0 (black) and ending at 31 (gold), or may be a user-
545 defined color number, which is 32 or higher.
546 -update file [ file ... ]
548 Run xfig in an "update" mode, where it will read each Fig file
549 specified on the command line and write it out to the original
550 file, in the current file format for the version of xfig being
551 run. The original Fig file will be preserved with the suffix
552 .bak attached to the name.
553 In this mode, xfig doesn't connect the X server, so no window is
554 opened, and it exits when finished.
555 -users[cale] scale
557 Set the multiplier for displayed line lengths etc. This factor
558 is multiplied by the actual length, radius or diameter of the
559 object currently being drawn on the canvas. It is useful for
560 making scale drawings, where e.g. 1 inch = 1 foot (userscale =
561 12.0) or 1cm = 1m (userscale = 100.0).
562 -useru[nit] units
564 The units string is printed with the length information when
565 drawing objects. For example if the userscale = 1.0 and the
566 userunit = ft then a line which is 3 inches long on the canvas
567 would be displayed as ``length = 3 ft'' when it is being drawn.
568 After xfig is started you may change the userscale and the
570 userunit from a popup menu available by pressing mouse button 3
571 in the units box where the two rulers meet.
572 -visual visualname
574 Use visualname as the visual for xfig. The names are TrueColor
575 (case is not important), StaticColor, DirectColor, StaticGray,
576 GrayScale and PseudoColor. xfig uses the default visual unless
577 this is specified. Your server must support the desired visual.
578 Use xdpyinfo to see what visuals and depths are supported. See
579 also the -depth option.
580 -zoom zoomscale
582 Set the starting zoom scale.
583
587 The overall widget name(Class) is xfig(Fig). These resources corre‐
588 spond to the command line arguments:
589 Name Type Default Command-line equivalent
591 -------------------------------------------------------------------
592 allownegcoords boolean true -allownegcoords (true),
593 -dontallownegcoords (false)
594 axislines string pink -axislines
595 balloon_delay integer 500 (ms) -balloon_delay
596 boldFont string 8x13bold -bold
597 but_per_row integer 2 -but_per_row
598 buttonFont string 6x13 -button
599 canvasbackground string white -cbg
600 canvasforeground string black -cfg
601 correctfontsize boolean false -correctfontsize
602 debug boolean false -debug
603 depth integer * -depth
604 dontswitchcmap boolean false -dontswitchcmap
605 euc_encoding boolean false (n/a)
606 encoding integer 1 -encoding
607 exportLanguage string eps -exportLanguage
608 export_margin integer 0 -export_margin
609 flipvisualhints boolean false -flipvisualhints
610 flushleft boolean false -flushleft (true),
611 -center (false)
612 freehand_resolution integer 25 -freehand_resolution
613 grid_color string black -grid_color
614 grid_unit string 1/16 (inch) -grid_unit
615 0.1 (metric)
616 hiddentext boolean false -hiddentext
617 icon_view boolean true -icon_view (true),
618 -list_view (false)
619 image_editor string xv -image_editor
620 inches boolean true -inches (true),
621 -imperial (true),
622 -centimeters (false),
623 -metric (false)
624 installowncmap boolean false -installowncmap
625 internalborderwidth integer 1 -internalBW
626 international International booleanfalse-international
627 jpeg_quality integer 75 -jpeg_quality
628 justify boolean false -left (false),
629 -right (true)
630 keyFile string CompKeyDB -keyFile
631 landscape boolean true -Landscape (true),
632 -landscape (true),
633 -Portrait (false),
634 -portrait (false)
635 latexfonts boolean false -latexfonts
636 library_dir string ~/xfiglib -library_dir
637 magnification float 100 -magnification
638 max_image_colors integer 64 -max_image_colors
639 monochrome boolean false -monochrome
640 multiple boolean false -multiple
641 normalFont string 6x13 -normal
642 overlap boolean true -overlap (true),
643 -nooverlap (false)
644 pageborder string lightblue -pageborder
645 paper_size string Letter (inch) -paper_size
646 A4 (metric)
647 pheight float 8.5 (landscape) -pheight
648 9.5 (portrait)
649 pwidth float 11 (landscape) -pwidth
650 8.5 (portrait)
651 rigidtext boolean false -rigid (true)
652 rulerthick integer 24 -rulerthick
653 scalablefonts boolean true -scalablefonts (true),
654 -noscalablefonts (false)
655 scale_factor float 1.0 -scale_factor
656 showallbuttons boolean false -showallbuttons
657 showaxislines boolean true -showaxislines (true),
658 -dontshowaxislines (false)
659 showballoons boolean true -showballoons (true),
660 -dontshowballoons (false)
661 showdepthmanager boolean true -showdepthmanager (true),
662 -dontshowdepthmanager (false)
663 showlengths boolean false -showlengths (true),
664 -dontshowlengths (false)
665 shownums boolean false -shownums (true),
666 -dontshownums (false)
667 showpageborder boolean true -showpageborder (true),
668 -dontshowpageborder (false)
669 single boolean true -single
670 smooth_factor integer 0 -smooth_factor
671 specialtext boolean false -specialtext
672 splash boolean true -splash (true),
673 -nosplash (false)
674 spellcheckcommand string spell %s -spellcheckcommand
675 spinner_delay integer 500 (ms) -spinner_delay
676 spinner_rate integer 100 (ms) -spinner_rate
677 startfillstyle integer 0 -startfillstyle
678 startfontsize float 12 -startfontsize
679 startgridmode integer 0 -startgridmode
680 startlatexFont string Default -startlatexFont
681 startlinewidth integer 1 -startlinewidth
682 startposnmode integer 1 -startposnmode
683 startpsFont string Times-Roman -startpsFont
684 starttextstep float 1.2 -starttextstep
685 tablet boolean false -track,
686 trackCursor boolean true -track (true),
687 -notrack (false)
688 transparent_color integer -2 (none) -transparent_color
689 userscale float 1.0 -userscale
690 userunit string in (inches) -userunit
691 cm (metric)
692 visual string * -visual
693 zoom float 1.0 -zoom
694 * Default visual and depth depend on the X server. Use xdpyinfo to see what visuals
696 and depths are supported.
697 -------------------------------------------------------------------
698
701 Please send bug reports, fixes, new features etc. to:
702 bvsmith@lbl.gov (Brian V. Smith)
703 When reporting a bug, please first check if the problem is mentioned in
705 the FAQ section of the HTML files (xfig Help menu).
706 If it is not mentioned there, be sure to report the operating system
708 you are using (e.g. SunOS 4.1.3), type of X server and version (Open‐
709 Windows 3, X11R6.4, XFree86 3.2.2, etc) and color depth (e.g. 8bpp,
710 16bpp), and most importantly the version of xfig or fig2dev that is
711 having the problem.
712 It is also VERY useful to me if you can provide a stack trace from a
714 debugger such as gdb, dbx, ups, etc, if the bug causes xfig to crash.
715 Because of the difference of some fonts in some X servers and the Post‐
717 Script fonts on printers, text alignment can be problematic.
718 Not all operations employ smart redrawing of objects which are altered
720 as a by product of the operation. You may need to use Redraw in these
721 cases.
722 Some servers do not allow bitmaps/pixmaps taller than the screen height
724 or wider than the screen width. That is why there is a limit on the
725 width of the top ruler and height of the side ruler. If you need
726 wider/taller rulers AND your server allows bigger pixmaps, you may
727 define MAX_TOPRULER_WD and/or MAX_SIDERULER_HT in your Imakefile in the
728 DEFINES line. For example, to have a maximum top ruler width of 1160
729 pixels, add -DMAX_TOPRULER_WD=1160 to your DEFINES line in the Imake‐
730 file.
731 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 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 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 Modifications to text using the popup search/update/replace/spell check
746 panel cannot be undone.
747 See the README file for troubleshooting.
749
751 fig2dev(1) (TransFig package)
752 gs(1) (Ghostscript PostScript previewer)
754
756 (From the original author, Supoj Sutanthavibul): Many thanks goes to
757 Professor Donald E. Fussell who inspired the creation of this tool.
758 (From current maintainer Brian Smith): Thanks to all the users who have
760 contributed to xfig, especially Paul King who, besides adding many fea‐
761 tures, revamped the look and feel which became version 2.1.
762
764 Original Copyright (c) 1985 by Supoj Sutanthavibul
765 Parts Copyright (c) 1994-1999 by Brian V. Smith
766 Parts Copyright (c) 1991 by Paul King
767 Other Copyrights may be found in various files
768 Any party obtaining a copy of these files is granted, free of charge, a
771 full and unrestricted irrevocable, world-wide, paid up, royalty-free,
772 nonexclusive right and license to deal in this software and documenta‐
773 tion files (the "Software"), including without limitation the rights to
774 use, copy, modify, merge, publish and/or distribute copies of the Soft‐
775 ware, and to permit persons who receive copies from any such party to
776 do so, with the only requirement being that this copyright notice
777 remain intact.
778 Note that although I work at Lawrence Berkeley National Laboratory
780 (LBNL) I don't speak for LBNL nor do I represent LBNL with respect to
781 my work on TransFig and xfig, nor does LBL make any representations
782 about the suitability of this software for any purpose.
783 Here is the legal part:
785 THE LAWRENCE BERKELEY NATIONAL LABORATORY DISCLAIMS ALL WARRANTIES WITH
787 REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MER‐
788 CHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
789 ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSO‐
790 EVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
791 OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
792 CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
793 PostScript is a trademark of Adobe Systems Incorporated.
796 Parts Copyright (C) 1989 by Jef Poskanzer.
798 Copyright notice for pbmplus code:
799 Permission to use, copy, modify, and distribute this
801 software and its documentation for any purpose and without
802 fee is hereby granted, provided that the above copyright
803 notice appear in all copies and that both that copyright
804 notice and this permission notice appear in supporting
805 documentation. This software is provided ``as is'' without
806 express or implied warranty.
807
809 CompKeyDB
810 Data base of compose (meta) key sequences for 8-bit characters.
811 Must be installed in $(XFIGLIBDIR) with ``make install'', or
812 may be specified with command line option -keyFile or X toolkit
813 resource keyFile. See the Imakefile.
814 /usr/share/doc/xfig-3.2.5
816 This directory contains the documentation.
817 /usr/share/xfig
819 This directory contains the above mentioned CompKeyDB file, and
820 a directory of libraries containing Fig objects such as elec‐
821 trical symbols, logic symbols, etc.
822 Fig.ad and Fig-color.ad
824 Application defaults files which are automatically installed in
825 the system app-defaults directory with the make install com‐
826 mand.
827 Doc/FORMAT3.2
829 Description of Fig file format.
830 README Installation instructions and troubleshooting.
832 CHANGES Description of bug fixes/new features.
834
837 Many people have contributed to xfig. Here is a list of the people who
838 have contributed the most (in chronological order):
839 Version 1:
841 Original author:
844 Supoj Sutanthavibul, University of Texas at Austin
845 The LaTeX line drawing modes were contributed by:
847 Frank Schmuck, Cornell University
848 Original X11 port by:
850 Ken Yap, Rochester
851 Variable window sizes, cleanup of X11 port, right hand side panel:
853 Dana Chee, Bellcore
854 Cleanup of color port to X11 by:
856 John T. Kohl, MIT
857 Version 2.0:
859 Area fill, multiple line thicknesses, multiple fonts and font
862 sizes, bottom panel, line style/thickness, (and anything else that
863 wasn't written by the others) by:
864 Brian Smith
865 (standard disclaimer applies)
866 (bvsmith@lbl.gov)
867 Popup change-object menu by:
869 Jon Tombs
870 Frank Schmuck
871 Zooming and panning functions, shift key select mechanism by:
873 Dieter Pellkofer
874 Henning Spruth
875 Depth feature by:
877 Mike Lutz
878 Cut/Paste by:
880 Tom Tkacik
881 Version 2.1:
883 Indicator panel, file menu popup, print menu popup, panning with
886 rulers, mouse function window, regular polygon, rubberbanding of
887 circles/ellipses, filled splines on canvas, dashed/dotted splines
888 on canvas, update button, arbitrary angle rotation of objects,
889 alignment in compound, object scaling, constrained copy/move, cor‐
890 ner markers for compound, context sensitive corner markers, smarter
891 redraw, undo for compound and point move for boxes, cancel object
892 creation, point positioning to three resolutions, TransFig scalable
893 text, hidden text, special text, save of figure on crash by:
894 Paul King (king@cs.uq.oz.au)
896 with help from:
897 Brian Smith and Micah Beck (beck@cs.utk.edu)
898 Encapsulated PostScript importing by:
900 Brian Boyter
901 Pan/zoom with ctrl key/mouse by:
903 Henning Spruth
904 International characters by:
906 Herve Soulard
907 Directory Browser based on XDir by:
909 Win Treese, Digital Equipment Corporation
910 Rotated ellipses by:
912 James Tough, Dept. of Computer Science, Heriot-Watt University,
913 Scotland
914 Rotated text from the xvertext package by:
916 Alan Richardson, Space Science Centre, School of MAPS, University
917 of Sussex
918 Popup scale menu and dynamic switching between inches and cm by:
920 Paul King (king@cs.uq.oz.au)
921 Extensive man page formatting revisions by:
923 David W. Sanderson
924 Display Postscript code for IBM RS/6000 by:
926 Dave Hale (dhale@green.mines.colorado.edu)
927 Version 3.0:
929 New arrowhead types, separate pen/fill colors, new file protocol,
932 more colors with extended color popup panel, new arc style, new
933 fill patterns (bricks, etc), new line join and cap styles, export
934 offset and file load offset, XPM import, XBM import and export (and
935 anything else that wasn't written by the others) by:
936 Brian Smith
937 (Note: the color popup panel was based on xcoloredit by Richard
938 Hesketh)
939 GIF header reading code by:
942 David Koblas from the giftoppm part of the pbmplus package
943 XPM export code (using XPM3 libraries) by:
945 Karel van Houten (K.H.C.vanHouten@research.ptt.nl)
946 Higher figure resolution (1200dpi) by:
948 Ross Martin (martin@trcsun3.eas.asu.edu)
949 Color quantization using neural network by:
951 Anthony Dekker (dekker@ACM.org)
952 [NEUQUANT Neural-Net quantization algorithm by Anthony Dekker,
953 1994. See ``Kohonen neural networks for optimal colour quantiza‐
954 tion'' in ``Network: Computation in Neural Systems'' Vol. 5 (1994)
955 pp 351-367. for a discussion of the algorithm.]
956 Floyd-Steinberg algorithm for dithering color images on monochrome
958 displays lifted from the Pbmplus package by Jef Poskanser.
959 rotate/flip objects around/about selected anchor point and multiple
961 copies of objects by:
962 Uwe Bonnes (bon@lte.e-technik.uni-erlangen.de)
963 Input tablet extension by:
965 Greg LaCoste (greg@seismo.do.usbr.gov)
966 Version 3.1:
968 The only difference between protocol version 3.0 and version 3.1 is
971 that the position of the ``magnet'' has been shifted by 14 fig
972 units. In the 2.1 and older versions of xfig the grid was in mul‐
973 tiples of 5 fig units, but they were on intervals 4, 9, 14, 19,
974 etc. When version 3.0 was created, coordinates were simply multi‐
975 plied by the ratio of the resolutions (1200/80 = 15) so values like
976 4 became 60 instead of 74 ((4+1)*15 - 1).
977 The JPEG import/export code uses the Independent JPEG Group soft‐
979 ware (see jpeg/README for details)
980 Image browser, editor and screen capture features by:
982 Jim Daley (jdaley@cix.compulink.co.uk)
983 Version 3.2:
985 The changes to the version 3.2 file protocol are the addition of
988 the paper size, print/export magnification, single/multiple page
989 indicator and a transparent color name used for GIF export to the
990 header of the file.
991 The other difference in the version 3.2 protocol is the mathemati‐
992 cal model used for splines. The new version uses X-splines which
993 allows the user to mix interpolation and approximation points in a
994 same curve. More precisely, it means that an X-spline curve is nei‐
995 ther an interpolated spline nor an approximated one, it is BOTH
996 (the behaviour of each point is controlled by one single parameter
997 called ``shape factor''). For additional information about X-
998 splines, see:
999 "X-Splines: A Spline Model Designed for the End User"
1001 by C. Blanc and C. Schlick, Proceedings of SIGGRAPH'95
1002 http://dept-info.labri.u-bordeaux.fr/~schlick/DOC/sig1.html
1003 Caveat: Because previous spline models (quadratic B-splines and
1005 Bezier with hidden points) are no longer supported, curves that are
1006 present in version 3.1 and older files are automatically converted
1007 to X-splines. This translation is only an approximation process.
1008 It means that the converted curves are not exactly the same as the
1009 original ones. Though they are usually very close, some hand-fit‐
1010 ting may be needed in some pathological cases.
1011 Inclusion of X-splines by:
1013 Carole Blanc (blanc@labri.u-bordeaux.fr)
1014 Christophe Schlick (schlick@labri.u-bordeaux.fr)
1015 Note: the initial implementation was done by C. Feuille, S. Gros‐
1016 bois, L. Maziere and L. Minihot as a student practice (Universite
1017 Bordeaux, France).
1018 Open/close compound feature written by
1020 Bill Taylor (bill@mainstream.com)
1021 Library feature written by
1023 Stephane Mancini (mancini@elecsrv.enst.fr) (object preview by Brian
1024 V. Smith)
1025 The library objects in the Electrical and Logic libraries were done
1027 by
1028 Peter Hiscocks (phiscock@ee.ryerson.ca)
1029 The library objects in the Computer, Networks, and Hospital-Equip‐
1031 ment libraries were extracted from the clipart example files by
1032 Bill Chimiak (chim@bgsm.edu)
1033 Version 3.2.3 and newer:
1036 Please see the CHANGES file for credits for newer releases.
1039
1041 Many bug fixes/cleanups etc. by a host of faithful users
1042 See the CHANGES file for all the credits
1044 The TransFig package was written by Micah Beck and is maintained by
1046 Brian Smith
1047 Xfig 3.2.4 (Dec 2002) XFIG(1)