1fig2dev(1) General Commands Manual fig2dev(1)
2
6 fig2dev - translates Fig code to various graphics languages
7
10 fig2dev [-L language] [-m mag] [-s fsize] [-Z
11 maxdimension] [-D +/-rangelist [-K]] [other
12 options] [fig-file [out-file]]
13
15 fig2dev translates fig code in the named fig-file into the specified
16 graphics language and puts them in out-file. The graphics language is
17 inferred from the suffix of out-file, or it must be given with the -L
18 option. The default fig-file and out-file are standard input and stan‐
19 dard output, respectively. A minus (-) in place of fig-file or out-
20 file also denotes either standard input or standard output.
21 Xfig (Facility for Interactive Generation of figures) is a screen-ori‐
24 ented tool which runs under the X Window System, and allows the user to
25 draw and manipulate objects interactively. This version of fig2dev is
26 compatible with xfig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and 3.2.
27 Xfig version 3.2.3 and later saves and allows the user to edit comments
29 for each Fig object. These comments are output with several of the
30 output languages, such as PostScript, CGM, EMF, LaTeX, MetaFont,
31 PicTeX, (as % comments), tk (as # comments), and pic (as .\" comments).
32
36 -L language
37 Set the output graphics language. Valid languages are box, cgm,
38 dxf, epic, eepic, eepicemu, emf, eps, gbx (Gerber beta driver),
39 gif, ibmgl, jpeg, latex, map (HTML image map), mf (MetaFont), mp
40 (MetaPost), pcx, pdf, pdftex, pdftex_t, pic, pict2e, pictex,
41 png, ppm, ps, pstex, pstex_t, pstricks, ptk (Perl/tk), shape
42 (LaTeX shaped paragraphs), sld (AutoCad slide format), svg,
43 textyl, tiff, tikz, tk (tcl/tk), tpic, xbm and xpm.
44 Notes:
46 You must have ghostscript installed to get the pdf output, and
47 ghostscript and one from the netpbm, the ImageMagick or the
48 GraphicsMagick packages to get the bitmap formats (png, jpeg,
49 etc.).
50 -h Print help message with all options for all output languages
53 then exit.
54 -V Print the program version number and exit.
57 -D +/-rangelist
60 With +rangelist, keep only those depths in the list. With
61 -rangelist, keep all depths except those in the list. The
62 rangelist may be a list of comma-separated numbers or ranges
63 separated by colon (:). For example, -D +10,40,55:70,80 means
64 keep only layers 10, 40, 55 through 70, and 80.
65 -K The selection of the depths with the -D +/-rangelist option does
68 normally not affect the calculation of the bounding box. Thus
69 the generated document might have a much larger bounding box
70 than necessary. If -K is given then the bounding box is adjusted
71 to include only those objects in the selected depths.
72 -G minor[:major][:unit]
75 Draws a grid on the page. Specify thin, or thin and thick line
76 spacing in one of several units. For example, -G .25:1cm draws
77 a thin, gray line every .25 cm and a thicker gray line every 1
78 cm. Specifying -G 1in draws a thin line every 1 inch. Frac‐
79 tions may be used, e.g. -G :1/2in will draw a thick line every
80 1/2 inch.
81 Allowable units are: i, in, inch, f, ft, feet, c, cm, mm, and m.
82 Only allowed for PostScript, EPS, PDF, pstricks, tikz and bitmap
83 (GIF, JPEG, etc) drivers.
84 -j Enable the I18N internationalization facility.
87 -m mag Set the magnification at which the figure is rendered to mag.
90 The default is 1.0. This may not be used with the maxdimension
91 option (-Z).
92 -s fsize
95 Set the default font size (in points, 1/72 inch) for text ob‐
96 jects to fsize. The default is 11*mag, and thus is scaled by
97 the -m option. If there is no scaling, the default font is
98 eleven point Roman.
99 -Z maxdimension
102 Scale the figure so that the maximum dimension (width or height)
103 is maxdimension inches or cm, depending on whether the figure
104 was saved with imperial or metric units. This may not be used
105 with the magnification option (-m).
106 other options
109 The other options are specific to the choice of graphics lan‐
110 guage, as described below.
111
115 -b borderwidth
116 Make blank border around figure of width borderwidth (1/72
117 inch).
118 -F Use correct font sizes (points, 1/72 inch) instead of the tradi‐
121 tional size that xfig/fig2dev uses, which is 1/80 inch. The
122 corresponding xfig command-line option is -correct_font_size.
123 -g color
126 Use color for the background.
127 -N Convert all colors to grayscale.
130 -S smoothfactor
133 This will smooth the output by passing smoothfactor to ghost‐
134 script in the -dTextAlphaBits and -dGraphicsAlphaBits options to
135 improve font rendering and graphic smoothing. A value of 2 for
136 smoothfactor provides some smoothing and 4 provides more.
137
141 -t color
142 Use color for the transparent color in the GIF file. This must
143 be specified in the same format that ppmmake(1) allows. It may
144 allow an X11 color name, but at least you may use a six-digit
145 hexadecimal RGBvalue using the # sign, e.g. #ff0000 (Red).
146
150 -q image_quality
151 use the integer value image_quality for the JPEG "Quality" fac‐
152 tor. Valid values are 0 - 100, with the default being 75.
153
157 CGM is Computer Graphics Metafile, developed by ISO and ANSI and is a
158 vector-based plus bitmap language. Microsoft WORD, PowerPoint and
159 probably other products can import this format and display it on the
160 screen, something that they won't do with EPS files that have an ASCII
161 preview.
162 -a Generate binary output.
165 -r Position arrowheads for CGM viewers that display rounded arrow‐
168 heads. Normally, arrowheads are pointed, so fig2dev compensates
169 for this by moving the endpoint of the line back so the tip of
170 the arrowhead ends where the original endpoint of the line was.
171 If the -r option is used, the position of arrows will NOT be
172 corrected for compensating line width effects, because the
173 rounded arrowhead doesn't extend beyond the endpoint of the
174 line.
175
179 DXF is the Drawing Interchange File Format. The output to DXF is ex‐
180 perimental.
181 -a Select ANSI A paper size instead of the default ISO A4.
184 -d xll,yll,xur,yur
187 Restrict plotting to a rectangular area of the plotter paper
188 which has a lower left hand corner at (xll,yll) and a upper
189 right hand corner at (xur,yur). All four numbers are in inches
190 and follow -d in a comma-separated list - xll,yll,xur,yur - with
191 no spaces between them.
192 -P Rotate the figure to portrait mode. The default is landscape
195 mode.
196 -v Plot the figure upside-down in portrait mode or backwards in
199 landscape mode.
200
204 EMF is Enhanced Metafile, developed by Microsoft and is a vector-based
205 plus bitmap language. Microsoft WORD, PowerPoint and probably other
206 products can import this format and display it on the screen, something
207 that they won't do with EPS files that have an ASCII preview.
208 -l lang
211 Set the compatibility level to lang, where lang is one of win95,
212 win98 or winnt. The default is winnt.
213 -r Position arrowheads for EMF viewers that display rounded arrow‐
216 heads. See the discussion of the -r option for the CGM output
217 driver above.
218
221 EPIC is an enhancement to LaTeX picture drawing environment.
222 EEPIC is an extension to EPIC and LaTeX picture drawing environment
224 which uses tpic specials as a graphics mechanism. It was written by
225 Conrad Kwok of Division of Computer Science at University of Califor‐
226 nia, Davis. Conrad Kwok has also written the EEPIC driver of fig2dev.
227 EEPIC-EMU is an EEPIC emulation package which does not use tpic spe‐
229 cials.
230 -d factor
233 Scale arrowheads by factor. The width and height of arrowheads
234 is divided by this factor. This is because EPIC arrowheads are
235 normally about double the size of TeX arrowheads.
236 -E num Set encoding for text translation (0 = none, 1 = ISO-8859-1, 2 =
239 ISO-8859-2; default 1).
240 -F Don't set the font face, series, and style; only set it's size
243 and the baselineskip. By default, fig2dev sets all 5 font param‐
244 eters when it puts some text. The disadvantage is that you can't
245 set the font from your LaTeX document. With this option on, you
246 can set the font from your LaTeX document.
247 If any of the pictures included in your LaTeX document has been
249 generated with -F, then all pictures must be generated with this
250 option.
251 -f font
254 Set the default font used for text objects to font, where font
255 is one of rm, bf, it, sf or tt. The default is rm.
256 -l lwidth
259 Use "\thicklines" when the width of the line is equal or wider
260 than lwidth. The default is 2.
261 -P Generate a complete LaTeX file. In other words, the output file
264 can be formatted without requiring any changes.
265 -R dummyarg
268 Allow rotated text. Rotated text will be set using the \rotate‐
269 box command. So, you will need to include "\usepackage{graph‐
270 ics}" in the preamble of your LaTeX document. A dummy argument
271 is required after the -R.
272 If this option is not set, then rotated text will be set hori‐
274 zontally.
275 -S scale
278 Set the scale to which the figure is rendered. This option au‐
279 tomatically sets the magnification and fsize to scale/12 and
280 scale respectively. Scale must be between 8 and 12, inclu‐
281 sively.
282 -t stretch
285 Set the stretch factor of dashed lines to stretch. The default
286 is 30.
287 -v Include comments in the output file.
290 -W Enable variable line width. By default, only two line widths
293 are available: The normal line width ("\thinlines"), and thick
294 lines ("\thicklines"). See also the -l option above.
295 -w Disable variable line width. Only "\thicklines" and/or "\thin‐
298 lines" commands will be generated in the output file.
299 When variable line width option is enabled, the "\thinlines"
301 command is still used when the line width is less than
302 LineThick. One potential problem is that the width of "\thin‐
303 lines" is 0.4pt but the resolution of Fig is 1/80 inch (approx.
304 1pt). If LineThick is set to 2, normal lines will be drawn in
305 0.4pt wide lines but the next line width is already 2pt. One
306 possible solution is to set LineThick to 1 and set the width of
307 those lines you want to be drawn in "\thinlines" to 0.
308 Due to this problem, variable line width is disabled by default
310 (-w).
311
315 IBM-GL (IBM Graphics Language) is compatible with HP-GL (Hewlett-
316 Packard Graphics Language).
317 -a Select ANSI A paper size instead of the default ISO A4.
320 -c Generate instructions for an IBM 6180 Color Plotter without an
323 IBM Graphics Enhancement Cartridge (IBM-GEC).
324 -d xll,yll,xur,yur
327 Restrict plotting to a rectangular area of the plotter paper
328 which has a lower left hand corner at (xll,yll) and a upper
329 right hand corner at (xur,yur). All four numbers are in inches
330 and follow -d in a comma-separated list - xll,yll,xur,yur - with
331 no spaces between them.
332 -f fontfile
335 Load text character specifications from the table in the file
336 fontfile. The table must have 36 entries - one for each font
337 plus a default. Each entry consists of 5 numbers which specify
338 the
339 1.) standard character set (0 - 4, 6 - 9, 30 - 39),
340 2.) alternate character set (0 - 4, 6 - 9, 30 - 39),
341 3.) character slant angle (degrees),
342 4.) character width scale factor and
343 5.) character height scale factor.
344 -k Precede output with PCL command to use HP/GL.
347 -l pattfile
350 Load area fill line patterns from the table in the pattfile
351 file. The table must have 21 entries - one for each of the area
352 fill patterns. Each entry consists of 5 numbers which specify
353 the
354 1.) pattern number (-1 - 6),
355 2.) pattern length (inches),
356 3.) fill type (1 - 5),
357 4.) fill spacing (inches) and
358 5.) fill angle (degrees).
359 -P Rotate the figure to portrait mode. The default is landscape
362 mode.
363 -p penfile
366 Load plotter pen specifications from the table in the penfile
367 file. The table must have 9 entries - one for each color plus a
368 default. Each entry consists of 2 numbers which specify the
369 1.) pen number (1 - 8) and
370 2.) pen thickness (millimeters).
371 -S speed
374 Set the pen speed to speed (centimeters/second).
375 -v Plot the figure upside-down in portrait mode or backwards in
378 landscape mode. This allows you to write on the top surface of
379 overhead transparencies without disturbing the plotter ink on
380 the bottom surface.
381 -x offset
384 Shift figure left by offset inches.
385 -y offset
388 Shift figure up by offset inches.
389 Fig2dev may be installed with either ANSI A or ISO A4 default paper
392 size. The -a option selects the alternate paper size. Fig2dev does
393 not fill closed splines. The IBM-GEC is required to fill other poly‐
394 gons. Fig2dev may be installed for plotters with or without the IBM-
395 GEC. The -c option selects the alternate instruction set.
396
400 -b borderwidth
401 Make blank border around figure of width borderwidth (1/72
402 inch).
403 -d dmag
406 Set a separate magnification for the length of line dashes to
407 dmag.
408 -E num Set encoding for latex text translation (0 = no translation, 1 =
411 ISO-8859-1, 2 = ISO-8859-2; default 1).
412 -F Don't set the font face, series, and style; only set it's size
415 and the baselineskip. By default, fig2dev sets all 5 font param‐
416 eters when it puts some text. The disadvantage is that you can't
417 set the font from your LaTeX document. With this option on, you
418 can set the font from your LaTeX document.
419 If any of the pictures included in your LaTeX document has been
421 generated with -F, then all pictures must be generated with this
422 option.
423 -f font
426 Set the default font used for text objects to font, where font
427 is one of rm, bf, it, sf or tt. The default is rm.
428 -l lwidth
431 Sets the threshold between LaTeX thin and thick lines to lwidth
432 pixels. LaTeX supports only two different line widths: \thin‐
433 lines and \thicklines. Lines of width greater than lwidth pix‐
434 els are drawn as \thicklines. Also affects the size of dots in
435 dotted line style. The default is 1.
436 -v Verbose mode. Include comments in the otput file.
439 LaTeX cannot accurately represent all the graphics objects which can be
442 described by Fig. For example, the possible slopes which lines may
443 have are limited. Some objects, such as spline curves, cannot be drawn
444 at all. Fig2latex chooses the closest possible line slope, and prints
445 error messages when objects cannot be drawn accurately.
446
450 Xfig version 3.2.3 and later saves and allows the user to edit comments
451 for each Fig object. The fig2dev map output language will produce an
452 HTML image map using Fig objects that have href="some_html_reference"
453 in their comments. Any Fig object except compound objects may be used
454 for this. Usually, besides generating the map file, you would also
455 generate a PNG file, which is the image to which the map refers.
456 For example, you may have an xfig drawing with an imported image that
458 has the comment href="go_here.html" and a box object with a comment
459 href="go_away.html". This will produce an image map file such the user
460 may click on the image and the browser will load the "go_here.html"
461 page, or click on the box and the browser will load the "go_away.html"
462 page.
463 After the map file is generated by fig2dev you will need to edit it to
465 fill out any additional information it may need.
466 -b borderwidth
469 Make blank border around figure of width borderwidth (1/72
470 inch).
471
475 Fig2dev scales the figure by 1/8 before generating METAFONT code. The
476 magnification can be further changed with the -m option or by giving
477 magnification options to mf.
478 In order to process the generated METAFONT code, the mfpic macros must
480 be installed where mf can find them. The mfpic macro package is avail‐
481 able at any CTAN cite under the subdirectory: graphics/mfpic
482 -C code
485 Specify the starting METAFONT font code. The default is 32.
486 -n name
489 Specify the name to use in the output file.
490 -p pen_magnification
493 Specify how much the line width should be magnified compared to
494 the original figure. The default is 1.
495 -t top Specify the top of the whole coordinate system. The default is
498 ypos.
499 -x xmin
502 Specify the minimum x coordinate value of the figure (inches).
503 The default is 0.
504 -y ymin
507 Specify the minimum y coordinate value of the figure (inches).
508 The default is 0.
509 -X xmax
512 Specify the maximum x coordinate value of the figure (inches).
513 The default is 8.
514 -Y ymax
517 Specify the maximum y coordinate value of the figure (inches).
518 The default is 8.
519
523 -d file
524 Include file content as additional header.
525 -i file
528 Include file content via \input-command.
529 -M Multipage mode, generate one figure for each depth.
532 -o Old mode (no latex).
535 -p number
538 Adds the line "prologues:=number" to the output.
539
543 -f font
544 Set the default font used for text objects to font, where font
545 is one of R (roman), B (bold), I (italic), H (sans serif) or C
546 (typewriter). The default is R.
547 -p ext Enables the use of certain PIC extensions which are known to
550 work with the groff package; compatibility with DWB PIC is un‐
551 known. The extensions enabled by each option are:
552 arc Allow ARC_BOX i.e. use rounded corners
554 line Use the 'line_thickness' value
555 fill Allow ellipses to be filled
556 all Use all of the above
557 psfont Don't convert PostScript fonts generic type
558 (useful for files going to be Ditroff'ed for
559 and printed on PS printer). DWB-compatible.
560 allps Use all of the above (i.e. "all" + "psfont")
561
564 PICT2E is an enhancement to the LaTeX picture environment. It is en‐
565 abled by inserting "\usepackage{pict2e}" in the document preamble. De‐
566 pending on the content of the figure, it may be necessary to also in‐
567 clude "\usepackage{color}" and "\usepackage{graphics}". Figures pro‐
568 duced with the PICT2E driver can be processed with any LaTeX engine,
569 e.g., LaTeX + dvips, LaTeX + dvipdfm, pdflatex, xelatex, ConTeX, etc.
570 Pattern fills are not supported by the PICT2E output language. The
571 PICT2E driver renders patterns by filling the respective area with the
572 pen-color at 25% intensity, i.e., a 75% tint of the pen-color. The
573 PICT2E driver allows one to choose any font available to the LaTeX en‐
574 gine, including PostScript fonts. TeX an PostScript fonts may appear
575 together in the same document.
576 -b borderwidth
579 Make blank border around figure of width borderwidth*(1/72)
580 inches.
581 -C num Do not emit a \color-command for the color number num. (0 =
584 black, 1 = blue, 2 = green - see the color chooser widget in
585 Xfig). By default, fig2dev does not issue a \color-command for
586 objects which have the color set to "Default" in xfig. With
587 this option, the "\color"-command is also omitted for objects
588 having the color num. The color of these objects, as well as of
589 those having the color set to "Default", is picked up from the
590 including LaTeX-document.
591 The option -C 0 is particularly useful. By default, xfig starts
593 with the color set to black. Then, fig2dev emits
594 "\color{black}" commands, and the color-package must be included
595 in the document preamble. For black text and black-and-white
596 drawings, this is superfluous.
597 -e Do not try to be compatible with epic/eepic. By default, you
600 can include "\usepackage{pict2e, epic, eepic}" (in this order!)
601 in the document preamble and mix LaTeX pictures using the
602 epic/eepic command set and pictures produced with the PICT2E
603 output language within one document. With this option on, epic
604 or eepic pictures can not be mixed with PICT2E-pictures.
605 By default, fig2dev avoids the use of the "\circle" and
607 "\oval"-commands, which are defined by epic, in lieu of the
608 "\circlearc"-command exclusive to pict2e. In addition, line
609 widths are not only set using "\linethickness", but also with
610 the eepic-command "\allinethickness" (if it is defined).
611 -E num Set encoding for text translation (0 = no translation, 1 =
614 ISO-8859-1, 2 = ISO-8859-2; default 1). For instance, to use
615 utf8-encoded text, first create a text object, then edit the
616 text using the edit-button in xfig. Convert the fig-file to
617 pict2e with the option -E 0 and include "\usepack‐
618 age[utf8]{inputenc}" in the LaTeX file In xfig, the text typed
619 in may not be displayed correctly, but the document produced
620 from the LaTeX file will show the same text as was typed in.
621 -F Do not set the font family, series or shape. By default,
624 fig2dev sets the font family, series, shape, font size and base‐
625 lineskip. With this option on, the text font can be set from
626 the including LaTeX-document, e.g., "\itshape \in‐
627 put{fig1.pict2e}". See also -o (no font size).
628 -f font
631 Set the default font used for text objects to font. The string
632 font may be one of rm, bf, it, sf, tt, \rmfamily, \bfseries,
633 \itshape, \sffamily, \ttfamily, or one of the 35 standard Post‐
634 Script font names. The default is \rmfamily.
635 -i dir Prepend the string dir to graphics files included in the pict2e-
638 picture. For instance, having imported "image.jpg" in xfig,
639 with -i '$HOME/Figures/' the code "\incudegraphics{$HOME/Fig‐
640 ures/image.jpg}" will be generated.
641 -o Do not set the font size or baselineskip. Text will be rendered
644 at the size that is in force where the pict2e-code is inserted
645 into the LaTeX-document, e.g., "\small \input{fig1.pict2e}".
646 See also -F (no font properties).
647 -O Do not quote characters special to TeX/LaTeX. Useful to get,
650 e.g., an italic x, not $x$, because it was forgotten to set the
651 text-flag "special-text" in xfig. This option effectively sets
652 the "special-text" flag for all text.
653 -P Pagemode, generate a stand-alone LaTeX-file as out-file. The
656 document produced from the LaTeX-file will have the paper size
657 equal to the figure's bounding box (but see the -b option to add
658 a margin). The generated LaTeX-file calls the package "geome‐
659 try.sty" to set the paper size.
660 -R num Replace arrowheads num by LaTeX-arrows ("\vector"). The number
663 of an arrowhead ("Arrow Type" in xfig) can be found by opening
664 the arrow chooser widget in xfig and counting the arrows, start‐
665 ing from 1. For instance, to replace filled triangle arrowheads
666 with LaTeX \vector-commands, use -R 3.
667 -r Replace all arrows by LaTeX-arrows.
670 -T Only use TeX fonts, even where PostScript-fonts are specified.
673 -v Verbose mode. Write comment lines into the output file, usually
676 naming the type of the object that is drawn.
677 -w Remove the suffix from included graphics-files. With this op‐
680 tion on, fig2dev generates code that contains, e.g., "\include‐
681 graphics{fig1}", instead of "\includegraphics{fig1.eps}".
682
686 In order to include PiCTeX pictures into a document, it is necessary to
687 load the PiCTeX macros.
688 PiCTeX uses TeX integer register arithmetic to generate curves, and so
690 it is very slow. PiCTeX draws curves by \put-ing the psymbol repeat‐
691 edly, and so requires a large amount of TeX's internal memory, and gen‐
692 erates large DVI files. The size of TeX's memory limits the number of
693 plot symbols in a picture. As a result, it is best to use PiCTeX to
694 generate small pictures.
695 -a Anonymous mode. Do not write the user name into the output file.
698 -E num Set encoding for latex text translation (0 = no translation, 1 =
701 ISO-8859-1, 2 = ISO-8859-2; default 1).
702 -f font
705 Set the default font used for text objects to font, where font
706 is one of rm, bf, it, sf or tt. The default is rm.
707 -l dimen
710 Set line thickness to dimen. Default "1pt".
711 -p psymbol
714 Set the psymbol. Default "\makebox(0,0)[l]{\tencirc\sym‐
715 bol{'160}}".
716 -r Do not allow rotated text. Otherwise, files with PiCTeX macros
719 and rotated text need to be processed with dvips.
720
723 Typically you will wish to set the y scale to -1. See -g for more in‐
724 formation.
725 -d [mm|in]
728 Output dimensions should be assumed to be millimeters (mm) or
729 inches (in). The default is millimeters.
730 -p [pos|neg]
733 Select the image polarity. For positive images lines drawn in
734 the fig file will generate lines of material. For negative im‐
735 ages lines drawn in the fig file will result in removed mate‐
736 rial. Consider etching a chrome on glass transmission mask.
737 Drawing lines in the fig file and choosing 'neg' will result in
738 these lines being etched through the chrome, leaving transparent
739 lines.
740 -g <x scale>x<y scale>+<x offset>+<y offset>
743 This controls the geometry of the output, scaling the dimensions
744 as shown and applying the given offset. Typically you will wish
745 to set the y scale to -1, mirroring about the x axis. This is
746 because Gerber assumes the origin to be bottom left, while xfig
747 selects top left.
748 -f <n digits>.<n digits>
751 This controls the number of digits of precision before and after
752 the implied decimal point. With -f 5.3 the following number
753 12345678 corresponds to 12345.678. Whereas with -f 3.5 it cor‐
754 responds to 123.45678. The default is for 3 places before the
755 decimal point and 5 after. This corresponds, to a range of 0 to
756 1m in 10 micron increments.
757 -v Output comments describing the type of objects being output.
760 The text appears as comments starting with ## on each line in
761 the output file.
762
766 With PostScript, xfig can be used to create multiple page figures.
767 Specify the -M option to produce a multi-page output. For posters, add
768 -O to overlap the pages slightly to get around the problem of the un‐
769 printable area in most printers, then cut and paste the pages together.
770 Great for text with very big letters.
771 The EPS driver has the following differences from PostScript:
773 o No showpage is generated because the output is meant to be im‐
774 ported into another program or document and not printed
775 o The landscape/portrait options are ignored
776 o The centering option is ignored
777 o The multiple-page option is ignored
778 o The paper size option is ignored
779 o The x/y offset options are ignored
780 The EPS driver has the following two special options:
782 -B 'Wx [Wy X0 Y0]'
785 This specifies that the bounding box of the EPS file should have
786 the width Wx and the height Wy. Note that it doesn't scale the
787 figure to this size, it merely sets the bounding box. If a
788 value less than or equal to 0 is specified for Wx or Wy, these
789 are set to the width/height respectively of the figure. Origin
790 is relative to screen (0,0) (upper-left). Wx, Wy, X0 and Y0 are
791 interpreted in centimeters or inches depending on the measure
792 given in the fig-file. Remember to put either quotes (") or
793 apostrophes (') to group the arguments to -B.
794 -R 'Wx [Wy X0 Y0]'
797 Same as the -B option except that X0 and Y0 is relative to the
798 lower left corner of the figure. Remember to put either quotes
799 (") or apostrophes (') to group the arguments to -R.
800 The PDF driver accepts all of the PostScript options, if the -P (page‐
803 mode) option is given. In this case, the size of the PDF is the page‐
804 size given in the file or set from the command line via the -z option.
805 Otherwise, if -P is not given, the PDF is cropped to the bounding box
806 of the figure (optionally with a blank border margin set by the -b op‐
807 tion), and all of the EPS options are supported.
808 Text can now include various ISO-character codes above 0x7f, which is
811 useful for language specific characters to be printed directly. Not
812 all ISO-characters are implemented.
813 Color support: Colored objects created by Fig can be printed on a color
815 postscript printer. There are 32 standard colors: black, yellow, white,
816 gold, five shades of blue, four shades of green, four shades of cyan,
817 four shades of red, five shades of magenta, four shades of brown, and
818 four shades of pink. In addition there may be user-defined colors in
819 the file. See the xfig FORMAT3.2 file for the definition of these col‐
820 ors. On a monochrome printer, colored objects will be mapped into dif‐
821 ferent grayscales by the printer. Filled objects are printed using the
822 given area fill and color. There are 21 "shades" going from black to
823 full saturation of the fill color, and 21 more "tints" from full satu‐
824 ration + 1 to white. In addition, there are 16 patterns such as
825 bricks, diagonal lines, crosshatch, etc.
826 -A Add an ASCII (EPSI) preview. Not for PDF.
829 -a Anonymous mode. Do not write the user's login name into the out‐
832 put file.
833 -b borderwidth
836 Make blank border around figure of width borderwidth (1/72
837 inch).
838 -C dummy_arg
841 Add a color *binary* TIFF preview for Microsoft products that
842 need a binary preview. See also -T (monochrome preview). A
843 dummy argument must be supplied for historical reasons. Not for
844 PDF output.
845 -c Center the figure on the page. The centering may not be accu‐
848 rate if there are texts in the fig_file that extends too far to
849 the right of other objects.
850 -e Put the figure against the edge (not centered) of the page. Not
853 available in EPS.
854 -F Use correct font sizes (points, 1/72 inch) instead of the tradi‐
857 tional size that xfig/fig2dev uses, which is 1/80 inch. The
858 corresponding xfig command-line option is -correct_font_size.
859 -f font
862 Set the default font used for text objects to font, where font
863 is one of the 35 standard PostScript font names. The default is
864 Times-Roman.
865 -g color
868 Use color for the background.
869 -l dummy_arg
872 Generate figure in landscape mode. The dummy argument is ig‐
873 nored, but must appear on the command line for reasons of com‐
874 patibility. This option will override the orientation specifi‐
875 cation in the file (for file versions 3.0 and higher). Not
876 available in EPS.
877 -M Generate multiple pages if figure exceeds paper size. Not
880 available in EPS.
881 -N Convert all colors to grayscale.
884 -n name
887 Set the Title part of the PostScript output to name. This is
888 useful when the input to fig2dev comes from standard input.
889 -O When used with -M, overlaps the pages slightly to get around the
892 problem of the unprintable area in most printers. Not available
893 in EPS.
894 -p dummy_arg
897 Generate figure in portrait mode. The dummy argument is ig‐
898 nored, but must appear on the command line for reasons of com‐
899 patibility. This option will override the orientation specifi‐
900 cation in the file (for file versions 3.0 and higher). This is
901 the default for Fig files of version 2.1 or lower. Not avail‐
902 able in EPS.
903 -T Add a monochrome *binary* TIFF preview for Microsoft products
906 that need a binary preview. See also -C (color preview). Not
907 available for PDF output.
908 -x offset
911 Shift the figure in the X direction by offset PostScript points
912 (1/72 inch). A negative value shifts the figure to the left and
913 a positive value to the right. Not available in EPS.
914 -y offset
917 Shift the figure in the Y direction by offset points (1/72
918 inch). A negative value shifts the figure up and a positive
919 value down. Not available in EPS.
920 -z papersize
923 Set the papersize. Not available in EPS.
924 Available paper sizes are:
925 Letter (8.5" x 11" also A),
927 Legal ( 11" x 14")
928 Ledger ( 11" x 17"),
929 Tabloid ( 17" x 11", really Ledger in Landscape mode),
930 A (8.5" x 11" also Letter),
931 B ( 11" x 17" also Ledger),
932 C ( 17" x 22"),
933 D ( 22" x 34"),
934 E ( 34" x 44"),
935 A9 ( 37 mm x 52 mm),
936 A8 ( 52 mm x 74 mm),
937 A7 ( 74 mm x 105 mm),
938 A6 (105 mm x 148 mm),
939 A5 (148 mm x 210 mm),
940 A4 (210 mm x 297 mm),
941 A3 (297 mm x 420 mm),
942 A2 (420 mm x 594 mm),
943 A1 (594 mm x 841 mm),
944 A0 (841 mm x1189 mm),
945 B10 ( 32 mm x 45 mm),
946 B9 ( 45 mm x 64 mm),
947 B8 ( 64 mm x 91 mm),
948 B7 ( 91 mm x 128 mm),
949 B6 (128 mm x 182 mm),
950 B5 (182 mm x 257 mm),
951 B4 (257 mm x 364 mm),
952 B3 (364 mm x 515 mm),
953 B2 (515 mm x 728 mm),
954 B1 (728 mm x1030 mm),
955 B0 (1030mm x1456 mm).
956
959 The pstex and pdftex languages are a variant of ps which suppress text
960 that has the text flag "TeX Text" set. The pstex_t and pdftex_t lan‐
961 guages have the complementary behavior: they generate only the text
962 that has the "Tex Text" flag set and the commands necessary to position
963 this text. They also generate the commands necessary to overlay the
964 PostScript or PDF file generated using pstex/pdftex. These two drivers
965 can be used to generate a figure which combines the flexibility of
966 PostScript graphics with LaTeX text formatting of text flagged as "TeX
967 Text".
968 The pstex and pdftex drivers accept the same options that the EPS
970 driver accepts.
971 -n name
974 Set the Title part of the PostScript output to name. This is
975 useful when the input to fig2dev comes from standard input.
976
979 The pstex_t and pdftex_t languages produce only the text flagged with
980 the "TeX Text" flag, the commands necessary to position this text, and
981 the commands necessary to overlay the PostScript or PDF file generated
982 using pstex or pdftex (see above).
983 -E num Set encoding for latex text translation (0 no translation, 1
986 ISO-8859-1, 2 ISO-8859-2; default 1)
987 -F Don't set the font face, series, and style; only set it's size
990 and the baselineskip. By default, fig2dev sets all 5 font param‐
991 eters when it puts some text. The disadvantage is that you can't
992 set the font from your LaTeX document. With this option on, you
993 can set the font from your LaTeX document (like "\sfshape \input
994 picture.eepic").
995 -p file
998 specifies the name of the PostScript file to be overlaid. If
999 not set or its value is null then no PS file will be inserted.
1000
1004 The PSTricks driver provides full LaTeX text and math formatting for
1005 XFig drawings without overlaying separate outputs as in the PSTEX meth‐
1006 ods. The output matches the quality of output of the PostScript driver
1007 except for text, where the Latex font selection mechanism is used as
1008 for other fig2dev LaTeX drivers. In addition, text is rendered black,
1009 although font color-changing LaTex code can be embedded in the drawing.
1010 The generated PSTricks code is meant to be readable. Each command
1011 stands alone, not relying on global option state variables. Thus the
1012 user can easily use XFig to rough out a PSTricks drawing, then finish
1013 by hand editing.
1014 To use the driver's output, give the command "\usepackage{pstricks}" in
1016 your document preamble. The graphicx and pstricks-add packages may
1017 also be required. The former is used for bitmap graphics and the sec‐
1018 ond for complex line styles and/or hollow PSTricks arrows (with the -R
1019 1 option). The driver will tell you which packages are needed. In the
1020 document body, include the figure with "\input{pstfile}" where pst‐
1021 file.tex is the output file. Use the XFig TeX text flag to have text
1022 passed as-is to LaTeX. For non-TeX text, the same mechanism as the La‐
1023 TeX and epic driver mechanism is used to match font specs, but this is
1024 imprecise.
1025 Known bugs and limitations.
1028 PSTricks support for join styles is version dependent. Raw post‐
1029 script is inserted with "\pstVerb" for old versions when other
1030 than angle joins are needed. The -t option controls this behav‐
1031 ior. PSTricks does not support rotated ellipses directly, so a
1032 rput command is emitted that rotates and locates a horizontal
1033 ellipse. This makes a problem with hatch patterns, which are
1034 moved and rotated along with the ellipse. Hatch rotation is
1035 fixed by a counter-rotation, but the origin is not adjusted, so
1036 registration with adjacent hatch patterns will be incorrect.
1037 Flipped bitmap graphics use an undocumented feature of the
1038 graphicx package: a negative height flips the image vertically.
1039 This appears to work reliably. However, you may want to flip
1040 graphics with another program before including them in Xfig
1041 drawings just to be sure. With the -p option, the driver at‐
1042 tempts to convert non-EPS pictures to EPS with the TeX distribu‐
1043 tion's bmeps program, but bmeps does not know about very many
1044 file formats including gif.
1045 -f font
1048 Set the default font used for text objects to font, where font
1049 is one of rm, bf, it, sf or tt. The default is rm.
1050 -G dummy_arg
1053 Draws a standard PSTricks grid in light gray, ignoring the size
1054 parameters, numbered in PSTricks units.
1055 -l weight
1058 Sets a line weight factor that is multiplied by the actual Fig
1059 line width. The default value 0.5 roughly matches the output of
1060 the PS driver.
1061 -n 0|1|2|3
1064 Sets environment type. Default 0 creates a \picture environment
1065 with bounding box exactly enclosing the picture (but see -x and
1066 -y ). A 1 emits bare PSTricks commands with no environment at
1067 all, which can be used with \input{commands} inside an existing
1068 \pspicture. A 2 emits a complete LaTeX document. A 3 also
1069 emits a complete LaTeX document but attempts to set the PSTricks
1070 unit to fit a 7.5 by 10 inch (portrait aspect) box.
1071 -P Shorthand for -n 3.
1074 -p dir Attempts to run the bmeps program to translate picture files to
1077 EPS, which is required by PSTricks. The translated files go in
1078 dir , which must already exist (the driver will not create it).
1079 Moreover, (BIG CAVEAT HERE) the driver overwrites files with im‐
1080 punity in this directory! Don't put your stuff here. The in‐
1081 cludegraphics commands in the output file refer to this direc‐
1082 tory. Even if the -p option is not used, includegraphics com‐
1083 mands follow this convention with the default directory ./eps .
1084 In this case, the user must do the conversions independently.
1085 The bmeps program is part of the standard TeX distribution. It
1086 converts the following formats to EPS: png jpg pnm tif. You can
1087 see the bmeps command with the -v option.
1088 -R 0|1|2
1091 Sets arrow style. With the default style 0, Fig arrows are con‐
1092 verted to lines and polygons. With style 1, the Fig arrowhead
1093 dimensions are converted to PSTricks arrowhead dimensions and
1094 PSTricks arrowhead options are emitted. Hollow arrows will re‐
1095 quire the additional package pstricks-add. With style 2,
1096 PSTricks arrowhead options are emitted with no dimensions at
1097 all, and arrowhead size may be controlled globally with psset.
1098 -S scale
1101 Scales the image according to the same convention as the EPIC
1102 driver, i.e., to size scale/12.
1103 -t version
1106 Provides the driver with PSTricks version number so output can
1107 match expected LaTeX input.
1108 -v Print verbose warnings and extra comments in the output file.
1111 Information provided includes font substitution details, the
1112 bmeps commands used for picture conversion, if any, and one com‐
1113 ment per Fig object in the output.
1114 -x marginsize
1117 Adds marginsize on the left and right of the PStricks bounding
1118 box. By default, the box exactly encloses the image.
1119 -y marginsize
1122 Adds marginsize on the top and bottom of the PStricks bounding
1123 box. By default, the box exactly encloses the image.
1124 -z 0|1|2
1128 Sets font handling option. Default option 0 attempts to honor
1129 Fig font names and sizes, finding the best match with a standard
1130 LaTeX font. Option 1 sets LaTeX font size only. Option 2 is‐
1131 sues no font commands at all.
1132
1136 -f font
1137 Set the default font used for text objects to font, where font
1138 is one of rm, bf, it, sf or tt. The default is rm.
1139 -l lwidth
1142 Set the line thickness. lwidth must be a value between 1 and 12.
1143
1146 TIKZ is a powerful frontend to the Portable Graphics Format (PGF) for
1147 TeX/LaTeX. To use figures created by the TIKZ driver in a LaTeX docu‐
1148 ment, use "\usepackage{tikz}" and, depending on the contents of your
1149 figure, "\usetikzlibrary{arrows.meta, bending}" and "\usetikzli‐
1150 brary{patterns}" in the document preamble. Simply \input or copy the
1151 output file into the TeX-document. TIKZ files produced by fig2dev may
1152 be included into a plain TeX document. However, the stand-alone file
1153 produced with the -P option must be processed with a LaTeX-engine. In
1154 addition, font-commands may require a LaTeX engine.
1155 -b borderwidth
1158 Make blank border around figure of width borderwidth*(1/72)
1159 inches.
1160 -C num Do not emit a \color-command for the color number num. (0 =
1163 black, 1 = blue, 2 = green - see the color chooser widget in
1164 Xfig). By default, fig2dev does not issue a \color-command for
1165 objects which have the color set to "Default" in xfig. With
1166 this option, the "\color"-command is also omitted for objects
1167 having the color num. The color of these objects, as well as of
1168 those having the color set to "Default", is picked up from the
1169 including document.
1170 -E num Set encoding for text translation (0 = no translation, 1 =
1173 ISO-8859-1, 2 = ISO-8859-2; default 1). For instance, to use
1174 utf8-encoded text, first create a text object, then edit the
1175 text using the edit-button in xfig. Convert the fig-file to tikz
1176 with the option -E 0 and include "\usepackage[utf8]{inputenc}"
1177 in the LaTeX file (not necessary when using xelatex). In xfig,
1178 the text typed in may not be displayed correctly, but the docu‐
1179 ment produced from the LaTeX file will show the same text as was
1180 typed in.
1181 -F Do not set the font family, series or shape. By default,
1184 fig2dev sets the font family, series, shape, font size and base‐
1185 lineskip. As a side effect, this requires the New Font Selec‐
1186 tion Scheme (NFSS) of LaTeX. With this option on, the text font
1187 can be set from the including document, which may be TeX or La‐
1188 TeX. See also -o (no font size).
1189 -f font
1192 Set the default font used for text objects to font. The string
1193 font may be one of rm, bf, it, sf, tt, \rmfamily, \bfseries,
1194 \itshape, \sffamily, \ttfamily, or one of the 35 standard Post‐
1195 Script font names. The default is \rmfamily.
1196 -i dir Prepend the string dir to graphics files included in the tikz-
1199 picture. For instance, having imported "image.jpg" in xfig,
1200 with - i '$HOME/Figures/' the code "\pgfimage[width=...,
1201 height=...]{$HOME/Figures/image.jpg}" will be generated.
1202 -O Do not quote characters special to TeX/LaTeX. Useful to get,
1205 e.g., an italic x, not $x$, because it was forgotten to set the
1206 text-flag "special-text" in xfig. This option effectively sets
1207 the "special-text" flag for all text.
1208 -o Do not set the font size or baselineskip. Text will be rendered
1211 at the size that is in force where the tikz-code is inserted
1212 into the document, e.g., "\small\input fig1.tikz". See also -F
1213 (no font properties).
1214 -P Pagemode, generate a stand-alone LaTeX-file as out-file. Run
1217 out-file through LaTeX to generate a pdf or eps of the figure.
1218 The document produced from out-file will have the paper size
1219 equal to the figure's bounding box (but see the -b option to add
1220 a margin). The package "geometry.sty" is used in out-file to
1221 set the paper size.
1222 -T Only use TeX fonts, even where PostScript-fonts are specified.
1225 -v Verbose mode. Write comment lines into the output file, usually
1228 naming the type of the object that is drawn.
1229 -W Do not emit code at the beginning of the file that allows one to
1232 set the figure width or height from the including TeX document.
1233 Otherwise, e.g., "\newdimen\XFigwidth\XFigwidth=\linewidth"
1234 would scale the following figures to the line width.
1235 -w Remove the suffix from included graphics-files. With this op‐
1238 tion on, fig2dev generates code that contains, e.g., "\pgfim‐
1239 age{fig1}" instead of "\pgfimage{fig1.pdf}".
1240
1243 Arc-boxes are not supported for the tk output language, and only X bit‐
1244 map pictures are supported because of the canvas limitation in tk.
1245 Picture objects are not scaled with the magnification factor for tk
1246 output.
1247 Because tk scales canvas items according to the X display resolution,
1248 polygons, lines, etc. may be scaled differently than imported pictures
1249 (bitmaps) which aren't scaled at all.
1250 -g color
1253 Use color for the background.
1254 -l dummy_arg
1257 Generate figure in landscape mode. The dummy argument is ig‐
1258 nored, but must appear on the command line for reasons of com‐
1259 patibility. This option will override the orientation specifi‐
1260 cation in the file (for file versions 3.0 and higher).
1261 -p dummy_arg
1264 Generate figure in portrait mode. The dummy argument is ig‐
1265 nored, but must appear on the command line for reasons of com‐
1266 patibility. This option will override the orientation specifi‐
1267 cation in the file (for file versions 3.0 and higher). This is
1268 the default for Fig files of version 2.1 or lower.
1269 -P Generate canvas of full page size instead of using the bounding
1272 box of the figure's objects. The default is to use only the
1273 bounding box.
1274 -w Wrap the figure with code in order to generate a complete perl
1277 file. That is, you can do fig2dev -L ptk -w f.fig f.pl; perl
1278 f.pl and a widget pops up that shows the graphics contained in
1279 f.pl. Only available for ptk output.
1280 -z papersize
1283 Set the paper size. See the POSTSCRIPT OPTIONS for available
1284 paper sizes. This is only used when the -P option (use full
1285 page) is used.
1286
1290 -f font
1291 Set the default font used for text objects to font. The default
1292 is rm. The string font can be one of rm, bf, it, sf, tt, avant,
1293 avantcsc, avantd, avantdi, avanti, bookd, bookdi, bookl,
1294 booklcsc, bookli, chanc, cour, courb, courbi, couri, helv,
1295 helvb, helvbi, helvc, helvcb, helvcbi, helvci, helvcsc, helvi,
1296 pal, palb, palbi, palbu, palc, palcsc, pali, palsl, palu, palx,
1297 times, timesb, timesbi, timesc, timescsc, timesi, timessl or
1298 timesx.
1299
1303 xfig(1), pic(1), pic2fig(1), transfig(1)
1304
1308 Please send bug reports, fixes, new features etc. to:
1309 thomas.loimer@tuwien.ac.at
1310
1313 Copyright (c) 1991 Micah Beck
1314 Parts Copyright (c) 1985-1988 Supoj Sutantavibul
1315 Parts Copyright (c) 1989-2015 Brian V. Smith
1316 Parts Copyright (c) 2015-2018 by Thomas Loimer
1317 Permission to use, copy, modify, distribute, and sell this software and
1319 its documentation for any purpose is hereby granted without fee, pro‐
1320 vided that the above copyright notice appear in all copies and that
1321 both that copyright notice and this permission notice appear in sup‐
1322 porting documentation. The authors make no representations about the
1323 suitability of this software for any purpose. It is provided "as is"
1324 without express or implied warranty.
1325 THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, IN‐
1327 CLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
1328 EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSE‐
1329 QUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
1330 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
1331 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PER‐
1332 FORMANCE OF THIS SOFTWARE.
1333
1337 Micah Beck
1338 Cornell University
1339 Sept 28 1990
1340 and Frank Schmuck (then of Cornell University)
1342 and Conrad Kwok (then of U.C. Davis).
1343 Drivers contributed by
1345 Jose Alberto Fernandez R. (U. of Maryland)
1346 and Gary Beihl (MCC)
1347 Color support, ISO-character encoding and poster support by
1349 Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
1350 Modified from f2p (fig to PIC), by the author of Fig
1352 Supoj Sutanthavibul (supoj@sally.utexas.edu)
1353 University of Texas at Austin.
1354 MetaFont driver by
1356 Anthony Starks (ajs@merck.com)
1357 X-splines code by
1359 Carole Blanc (blanc@labri.u-bordeaux.fr)
1360 Christophe Schlick (schlick@labri.u-bordeaux.fr)
1361 The initial implementation was done by C. Feuille, S. Grobois, L.
1362 Maziere and L. Minihot as a student practice (Universite Bordeaux,
1363 France).
1364 Japanese text support for LaTeX output written by T. Sato
1366 (VEF00200@niftyserve.or.jp)
1367 The tk driver was written by
1369 Mike Markowski (mm@udel.edu) with a little touch-up by Brian Smith
1370 The CGM driver (Computer Graphics Metafile) was written by
1372 Philippe Bekaert (Philippe.Bekaert@cs.kuleuven.ac.be)
1373 The EMF driver (Enhanced Metafile) was written by
1375 Michael Schrick (m_schrick@hotmail.com)
1376 The GBX (Gerber) driver was written by
1378 Edward Grace (ej.grace@imperial.ac.uk).
1379Version 3.2.8b Aug 2021 fig2dev(1)