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 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 rulerthick integer 24 -rulerthick
652 scalablefonts boolean true -scalablefonts (true),
653 -noscalablefonts (false)
654 scale_factor float 1.0 -scale_factor
655 showallbuttons boolean false -showallbuttons
656 showaxislines boolean true -showaxislines (true),
657 -dontshowaxislines (false)
658 showballoons boolean true -showballoons (true),
659 -dontshowballoons (false)
660 showdepthmanager boolean true -showdepthmanager (true),
661 -dontshowdepthmanager (false)
662 showlengths boolean false -showlengths (true),
663 -dontshowlengths (false)
664 shownums boolean false -shownums (true),
665 -dontshownums (false)
666 showpageborder boolean true -showpageborder (true),
667 -dontshowpageborder (false)
668 single boolean true -single
669 smooth_factor integer 0 -smooth_factor
670 specialtext boolean false -specialtext
671 splash boolean true -splash (true),
672 -nosplash (false)
673 spellcheckcommand string spell %s -spellcheckcommand
674 spinner_delay integer 500 (ms) -spinner_delay
675 spinner_rate integer 100 (ms) -spinner_rate
676 startfillstyle integer 0 -startfillstyle
677 startfontsize float 12 -startfontsize
678 startgridmode integer 0 -startgridmode
679 startlatexFont string Default -startlatexFont
680 startlinewidth integer 1 -startlinewidth
681 startposnmode integer 1 -startposnmode
682 startpsFont string Times-Roman -startpsFont
683 starttextstep float 1.2 -starttextstep
684 tablet boolean false -track,
685 trackCursor boolean true -track (true),
686 -notrack (false)
687 transparent_color integer -2 (none) -transparent_color
688 userscale float 1.0 -userscale
689 userunit string in (inches) -userunit
690 cm (metric)
691 visual string * -visual
692 zoom float 1.0 -zoom
693 * Default visual and depth depend on the X server. Use xdpyinfo to see what visuals
695 and depths are supported.
696 -------------------------------------------------------------------
697
700 Please send bug reports, fixes, new features etc. to:
701 bvsmith@lbl.gov (Brian V. Smith)
702 When reporting a bug, please first check if the problem is mentioned in
704 the FAQ section of the HTML files (xfig Help menu).
705 If it is not mentioned there, be sure to report the operating system
707 you are using (e.g. SunOS 4.1.3), type of X server and version (Open‐
708 Windows 3, X11R6.4, XFree86 3.2.2, etc) and color depth (e.g. 8bpp,
709 16bpp), and most importantly the version of xfig or fig2dev that is
710 having the problem.
711 It is also VERY useful to me if you can provide a stack trace from a
713 debugger such as gdb, dbx, ups, etc, if the bug causes xfig to crash.
714 Because of the difference of some fonts in some X servers and the Post‐
716 Script fonts on printers, text alignment can be problematic.
717 Not all operations employ smart redrawing of objects which are altered
719 as a by product of the operation. You may need to use Redraw in these
720 cases.
721 Some servers do not allow bitmaps/pixmaps taller than the screen height
723 or wider than the screen width. That is why there is a limit on the
724 width of the top ruler and height of the side ruler. If you need
725 wider/taller rulers AND your server allows bigger pixmaps, you may
726 define MAX_TOPRULER_WD and/or MAX_SIDERULER_HT in your Imakefile in the
727 DEFINES line. For example, to have a maximum top ruler width of 1160
728 pixels, add -DMAX_TOPRULER_WD=1160 to your DEFINES line in the Imake‐
729 file.
730 If the image is panned or the xfig window iconified and de-iconified
732 during the middle of an operation (e.g. while drawing a line), the pic‐
733 ture will be distorted. This can be corrected using Redraw after the
734 operation is complete.
735 When zoomed very large, the length of dashes in dashed lines will top
737 out at 255 pixels long. This is due to a restriction in X that the
738 dash list is defined by char (255 pixels maximum for a dash). The fig‐
739 ure will print correctly, however.
740 When you do a copy/rotate with multiple copies, only the creation of
742 the last object can be undone with the Undo button.
743 Modifications to text using the popup search/update/replace/spell check
745 panel cannot be undone.
746 See the README file for troubleshooting.
748
750 fig2dev(1) (TransFig package)
751 gs(1) (Ghostscript PostScript previewer)
753
755 (From the original author, Supoj Sutanthavibul): Many thanks goes to
756 Professor Donald E. Fussell who inspired the creation of this tool.
757 (From current maintainer Brian Smith): Thanks to all the users who have
759 contributed to xfig, especially Paul King who, besides adding many fea‐
760 tures, revamped the look and feel which became version 2.1.
761
763 Original Copyright (c) 1985 by Supoj Sutanthavibul
764 Parts Copyright (c) 1994-1999 by Brian V. Smith
765 Parts Copyright (c) 1991 by Paul King
766 Other Copyrights may be found in various files
767 Any party obtaining a copy of these files is granted, free of charge, a
770 full and unrestricted irrevocable, world-wide, paid up, royalty-free,
771 nonexclusive right and license to deal in this software and documenta‐
772 tion files (the "Software"), including without limitation the rights to
773 use, copy, modify, merge, publish and/or distribute copies of the Soft‐
774 ware, and to permit persons who receive copies from any such party to
775 do so, with the only requirement being that this copyright notice
776 remain intact.
777 Note that although I work at Lawrence Berkeley National Laboratory
779 (LBNL) I don't speak for LBNL nor do I represent LBNL with respect to
780 my work on TransFig and xfig, nor does LBL make any representations
781 about the suitability of this software for any purpose.
782 Here is the legal part:
784 THE LAWRENCE BERKELEY NATIONAL LABORATORY DISCLAIMS ALL WARRANTIES WITH
786 REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MER‐
787 CHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
788 ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSO‐
789 EVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
790 OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
791 CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
792 PostScript is a trademark of Adobe Systems Incorporated.
795 Parts Copyright (C) 1989 by Jef Poskanzer.
797 Copyright notice for pbmplus code:
798 Permission to use, copy, modify, and distribute this
800 software and its documentation for any purpose and without
801 fee is hereby granted, provided that the above copyright
802 notice appear in all copies and that both that copyright
803 notice and this permission notice appear in supporting
804 documentation. This software is provided ``as is'' without
805 express or implied warranty.
806
808 CompKeyDB
809 Data base of compose (meta) key sequences for 8-bit characters.
810 Must be installed in $(XFIGLIBDIR) with ``make install'', or
811 may be specified with command line option -keyFile or X toolkit
812 resource keyFile. See the Imakefile.
813 /usr/lib/X11/xfig
815 This directory contains the html documentation, the above men‐
816 tioned CompKeyDB file, and a directory of libraries containing
817 Fig objects such as electrical symbols, logic symbols, etc.
818 Fig.ad and Fig-color.ad
820 Application defaults files which are automatically installed in
821 the system app-defaults directory with the make install com‐
822 mand.
823 Doc/FORMAT3.2
825 Description of Fig file format.
826 README Installation instructions and troubleshooting.
828 CHANGES Description of bug fixes/new features.
830
833 Many people have contributed to xfig. Here is a list of the people who
834 have contributed the most (in chronological order):
835 Version 1:
837 Original author:
840 Supoj Sutanthavibul, University of Texas at Austin
841 The LaTeX line drawing modes were contributed by:
843 Frank Schmuck, Cornell University
844 Original X11 port by:
846 Ken Yap, Rochester
847 Variable window sizes, cleanup of X11 port, right hand side panel:
849 Dana Chee, Bellcore
850 Cleanup of color port to X11 by:
852 John T. Kohl, MIT
853 Version 2.0:
855 Area fill, multiple line thicknesses, multiple fonts and font
858 sizes, bottom panel, line style/thickness, (and anything else that
859 wasn't written by the others) by:
860 Brian Smith
861 (standard disclaimer applies)
862 (bvsmith@lbl.gov)
863 Popup change-object menu by:
865 Jon Tombs
866 Frank Schmuck
867 Zooming and panning functions, shift key select mechanism by:
869 Dieter Pellkofer
870 Henning Spruth
871 Depth feature by:
873 Mike Lutz
874 Cut/Paste by:
876 Tom Tkacik
877 Version 2.1:
879 Indicator panel, file menu popup, print menu popup, panning with
882 rulers, mouse function window, regular polygon, rubberbanding of
883 circles/ellipses, filled splines on canvas, dashed/dotted splines
884 on canvas, update button, arbitrary angle rotation of objects,
885 alignment in compound, object scaling, constrained copy/move, cor‐
886 ner markers for compound, context sensitive corner markers, smarter
887 redraw, undo for compound and point move for boxes, cancel object
888 creation, point positioning to three resolutions, TransFig scalable
889 text, hidden text, special text, save of figure on crash by:
890 Paul King (king@cs.uq.oz.au)
892 with help from:
893 Brian Smith and Micah Beck (beck@cs.utk.edu)
894 Encapsulated PostScript importing by:
896 Brian Boyter
897 Pan/zoom with ctrl key/mouse by:
899 Henning Spruth
900 International characters by:
902 Herve Soulard
903 Directory Browser based on XDir by:
905 Win Treese, Digital Equipment Corporation
906 Rotated ellipses by:
908 James Tough, Dept. of Computer Science, Heriot-Watt University,
909 Scotland
910 Rotated text from the xvertext package by:
912 Alan Richardson, Space Science Centre, School of MAPS, University
913 of Sussex
914 Popup scale menu and dynamic switching between inches and cm by:
916 Paul King (king@cs.uq.oz.au)
917 Extensive man page formatting revisions by:
919 David W. Sanderson
920 Display Postscript code for IBM RS/6000 by:
922 Dave Hale (dhale@green.mines.colorado.edu)
923 Version 3.0:
925 New arrowhead types, separate pen/fill colors, new file protocol,
928 more colors with extended color popup panel, new arc style, new
929 fill patterns (bricks, etc), new line join and cap styles, export
930 offset and file load offset, XPM import, XBM import and export (and
931 anything else that wasn't written by the others) by:
932 Brian Smith
933 (Note: the color popup panel was based on xcoloredit by Richard
934 Hesketh)
935 GIF header reading code by:
938 David Koblas from the giftoppm part of the pbmplus package
939 XPM export code (using XPM3 libraries) by:
941 Karel van Houten (K.H.C.vanHouten@research.ptt.nl)
942 Higher figure resolution (1200dpi) by:
944 Ross Martin (martin@trcsun3.eas.asu.edu)
945 Color quantization using neural network by:
947 Anthony Dekker (dekker@ACM.org)
948 [NEUQUANT Neural-Net quantization algorithm by Anthony Dekker,
949 1994. See ``Kohonen neural networks for optimal colour quantiza‐
950 tion'' in ``Network: Computation in Neural Systems'' Vol. 5 (1994)
951 pp 351-367. for a discussion of the algorithm.]
952 Floyd-Steinberg algorithm for dithering color images on monochrome
954 displays lifted from the Pbmplus package by Jef Poskanser.
955 rotate/flip objects around/about selected anchor point and multiple
957 copies of objects by:
958 Uwe Bonnes (bon@lte.e-technik.uni-erlangen.de)
959 Input tablet extension by:
961 Greg LaCoste (greg@seismo.do.usbr.gov)
962 Version 3.1:
964 The only difference between protocol version 3.0 and version 3.1 is
967 that the position of the ``magnet'' has been shifted by 14 fig
968 units. In the 2.1 and older versions of xfig the grid was in mul‐
969 tiples of 5 fig units, but they were on intervals 4, 9, 14, 19,
970 etc. When version 3.0 was created, coordinates were simply multi‐
971 plied by the ratio of the resolutions (1200/80 = 15) so values like
972 4 became 60 instead of 74 ((4+1)*15 - 1).
973 The JPEG import/export code uses the Independent JPEG Group soft‐
975 ware (see jpeg/README for details)
976 Image browser, editor and screen capture features by:
978 Jim Daley (jdaley@cix.compulink.co.uk)
979 Version 3.2:
981 The changes to the version 3.2 file protocol are the addition of
984 the paper size, print/export magnification, single/multiple page
985 indicator and a transparent color name used for GIF export to the
986 header of the file.
987 The other difference in the version 3.2 protocol is the mathemati‐
988 cal model used for splines. The new version uses X-splines which
989 allows the user to mix interpolation and approximation points in a
990 same curve. More precisely, it means that an X-spline curve is nei‐
991 ther an interpolated spline nor an approximated one, it is BOTH
992 (the behaviour of each point is controlled by one single parameter
993 called ``shape factor''). For additional information about X-
994 splines, see:
995 "X-Splines: A Spline Model Designed for the End User"
997 by C. Blanc and C. Schlick, Proceedings of SIGGRAPH'95
998 http://dept-info.labri.u-bordeaux.fr/~schlick/DOC/sig1.html
999 Caveat: Because previous spline models (quadratic B-splines and
1001 Bezier with hidden points) are no longer supported, curves that are
1002 present in version 3.1 and older files are automatically converted
1003 to X-splines. This translation is only an approximation process.
1004 It means that the converted curves are not exactly the same as the
1005 original ones. Though they are usually very close, some hand-fit‐
1006 ting may be needed in some pathological cases.
1007 Inclusion of X-splines by:
1009 Carole Blanc (blanc@labri.u-bordeaux.fr)
1010 Christophe Schlick (schlick@labri.u-bordeaux.fr)
1011 Note: the initial implementation was done by C. Feuille, S. Gros‐
1012 bois, L. Maziere and L. Minihot as a student practice (Universite
1013 Bordeaux, France).
1014 Open/close compound feature written by
1016 Bill Taylor (bill@mainstream.com)
1017 Library feature written by
1019 Stephane Mancini (mancini@elecsrv.enst.fr) (object preview by Brian
1020 V. Smith)
1021 The library objects in the Electrical and Logic libraries were done
1023 by
1024 Peter Hiscocks (phiscock@ee.ryerson.ca)
1025 The library objects in the Computer, Networks, and Hospital-Equip‐
1027 ment libraries were extracted from the clipart example files by
1028 Bill Chimiak (chim@bgsm.edu)
1029 Version 3.2.3 and newer:
1032 Please see the CHANGES file for credits for newer releases.
1035
1037 Many bug fixes/cleanups etc. by a host of faithful users
1038 See the CHANGES file for all the credits
1040 The TransFig package was written by Micah Beck and is maintained by
1042 Brian Smith
1043 Xfig 3.2.4 (Dec 2002) XFIG(1)