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 maxdimension]
11 [-D +/-rangelist [-K]] [other options] [fig-file
12 [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 default fig-file and
17 out-file are standard input and standard output, respectively
18 Xfig (Facility for Interactive Generation of figures) is a screen-ori‐
20 ented tool which runs under the X Window System, and allows the user to
21 draw and manipulate objects interactively. This version of fig2dev is
22 compatible with xfig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and 3.2.
23 Xfig version 3.2.3 and later saves and allows the user to edit comments
25 for each Fig object. These comments are output with several of the
26 output languages, such as PostScript, CGM, EMF, LaTeX, MetaFont,
27 PicTeX, (as % comments), tk (as # comments), and pic (as .\" comments).
28
32 -L language
33 Set the output graphics language. Valid languages are box, cgm,
34 dxf, epic, eepic, eepicemu, emf, eps, gbx (Gerber beta driver),
35 gif, ibmgl, jpeg, latex, map (HTML image map), mf (MetaFont), mp
36 (MetaPost), pcx, pdf, pdftex, pdftex_t, pic, pict2e, pictex,
37 png, ppm, ps, pstex, pstex_t, pstricks, ptk (Perl/tk), shape
38 (LaTeX shaped paragraphs), sld (AutoCad slide format), svg,
39 textyl, tiff, tikz, tk (tcl/tk), tpic, xbm and xpm.
40 Notes:
42 You must have ghostscript installed to get the pdf output, and
43 ghostscript and the netpbm package to get the bitmap formats
44 (png, jpeg, etc.).
45 -h Print help message with all options for all output languages
48 then exit.
49 -V Print the program version number and exit.
52 -D +/-rangelist
55 With +rangelist, keep only those depths in the list. With
56 -rangelist, keep all depths except those in the list. The
57 rangelist may be a list of comma-separated numbers or ranges
58 separated by colon (:). For example, -D +10,40,55:70,80 means
59 keep only layers 10, 40, 55 through 70, and 80.
60 -K The selection of the depths with the -D +/-rangelist option does
63 normally not affect the calculation of the bounding box. Thus
64 the generated document might have a much larger bounding box
65 than necessary. If -K is given then the bounding box is adjusted
66 to include only those objects in the selected depths.
67 -G minor[:major][:unit]
70 Draws a grid on the page. Specify thin, or thin and thick line
71 spacing in one of several units. For example, -G .25:1cm draws
72 a thin, gray line every .25 cm and a thicker gray line every 1
73 cm. Specifying -G 1in draws a thin line every 1 inch. Frac‐
74 tions may be used, e.g. -G :1/2in will draw a thick line every
75 1/2 inch.
76 Allowable units are: i, in, inch, f, ft, feet, c, cm, mm, and m.
77 Only allowed for PostScript, EPS, PDF, pstricks, tikz and bitmap
78 (GIF, JPEG, etc) drivers.
79 -j Enable the I18N internationalization facility.
82 -m mag Set the magnification at which the figure is rendered to mag.
85 The default is 1.0. This may not be used with the maxdimension
86 option (-Z).
87 -s fsize
90 Set the default font size (in points, 1/72 inch) for text
91 objects to fsize. The default is 11*mag, and thus is scaled by
92 the -m option. If there is no scaling, the default font is
93 eleven point Roman.
94 -Z maxdimension
97 Scale the figure so that the maximum dimension (width or height)
98 is maxdimension inches or cm, depending on whether the figure
99 was saved with imperial or metric units. This may not be used
100 with the magnification option (-m).
101 other options
104 The other options are specific to the choice of graphics lan‐
105 guage, as described below.
106
110 -b borderwidth
111 Make blank border around figure of width borderwidth (1/72
112 inch).
113 -F Use correct font sizes (points, 1/72 inch) instead of the tradi‐
116 tional size that xfig/fig2dev uses, which is 1/80 inch. The
117 corresponding xfig command-line option is -correct_font_size.
118 -g color
121 Use color for the background.
122 -N Convert all colors to grayscale.
125 -S smoothfactor
128 This will smooth the output by passing smoothfactor to ghost‐
129 script in the -dTextAlphaBits and -dGraphicsAlphaBits options to
130 improve font rendering and graphic smoothing. A value of 2 for
131 smoothfactor provides some smoothing and 4 provides more.
132
136 -t color
137 Use color for the transparent color in the GIF file. This must
138 be specified in the same format that ppmmake(1) allows. It may
139 allow an X11 color name, but at least you may use a six-digit
140 hexadecimal RGBvalue using the # sign, e.g. #ff0000 (Red).
141
145 -q image_quality
146 use the integer value image_quality for the JPEG "Quality" fac‐
147 tor. Valid values are 0 - 100, with the default being 75.
148
152 CGM is Computer Graphics Metafile, developed by ISO and ANSI and is a
153 vector-based plus bitmap language. Microsoft WORD, PowerPoint and
154 probably other products can import this format and display it on the
155 screen, something that they won't do with EPS files that have an ASCII
156 preview.
157 -a Generate binary output.
160 -r Position arrowheads for CGM viewers that display rounded arrow‐
163 heads. Normally, arrowheads are pointed, so fig2dev compensates
164 for this by moving the endpoint of the line back so the tip of
165 the arrowhead ends where the original endpoint of the line was.
166 If the -r option is used, the position of arrows will NOT be
167 corrected for compensating line width effects, because the
168 rounded arrowhead doesn't extend beyond the endpoint of the
169 line.
170
174 DXF is the Drawing Interchange File Format. The output to DXF is
175 experimental.
176 -a Select ANSI A paper size instead of the default ISO A4.
179 -d xll,yll,xur,yur
182 Restrict plotting to a rectangular area of the plotter paper
183 which has a lower left hand corner at (xll,yll) and a upper
184 right hand corner at (xur,yur). All four numbers are in inches
185 and follow -d in a comma-separated list - xll,yll,xur,yur - with
186 no spaces between them.
187 -P Rotate the figure to portrait mode. The default is landscape
190 mode.
191 -v Plot the figure upside-down in portrait mode or backwards in
194 landscape mode.
195
199 EMF is Enhanced Metafile, developed by Microsoft and is a vector-based
200 plus bitmap language. Microsoft WORD, PowerPoint and probably other
201 products can import this format and display it on the screen, something
202 that they won't do with EPS files that have an ASCII preview.
203 -l lang
206 Set the compatibility level to lang, where lang is one of win95,
207 win98 or winnt. The default is winnt.
208 -r Position arrowheads for EMF viewers that display rounded arrow‐
211 heads. See the discussion of the -r option for the CGM output
212 driver above.
213
216 EPIC is an enhancement to LaTeX picture drawing environment.
217 EEPIC is an extension to EPIC and LaTeX picture drawing environment
219 which uses tpic specials as a graphics mechanism. It was written by
220 Conrad Kwok of Division of Computer Science at University of Califor‐
221 nia, Davis. Conrad Kwok has also written the EEPIC driver of fig2dev.
222 EEPIC-EMU is an EEPIC emulation package which does not use tpic spe‐
224 cials.
225 -d factor
228 Scale arrowheads by factor. The width and height of arrowheads
229 is divided by this factor. This is because EPIC arrowheads are
230 normally about double the size of TeX arrowheads.
231 -E num Set encoding for text translation (0 = none, 1 = ISO-8859-1, 2 =
234 ISO-8859-2; default 1).
235 -F Don't set the font face, series, and style; only set it's size
238 and the baselineskip. By default, fig2dev sets all 5 font param‐
239 eters when it puts some text. The disadvantage is that you can't
240 set the font from your LaTeX document. With this option on, you
241 can set the font from your LaTeX document.
242 If any of the pictures included in your LaTeX document has been
244 generated with -F, then all pictures must be generated with this
245 option.
246 -f font
249 Set the default font used for text objects to font, where font
250 is one of rm, bf, it, sf or tt. The default is rm.
251 -l lwidth
254 Use "\thicklines" when the width of the line is equal or wider
255 than lwidth. The default is 2.
256 -P Generate a complete LaTeX file. In other words, the output file
259 can be formatted without requiring any changes.
260 -R dummyarg
263 Allow rotated text. Rotated text will be set using the \rotate‐
264 box command. So, you will need to include "\usepackage{graph‐
265 ics}" in the preamble of your LaTeX document. A dummy argument
266 is required after the -R.
267 If this option is not set, then rotated text will be set hori‐
269 zontally.
270 -S scale
273 Set the scale to which the figure is rendered. This option
274 automatically sets the magnification and fsize to scale/12 and
275 scale respectively. Scale must be between 8 and 12, inclu‐
276 sively.
277 -t stretch
280 Set the stretch factor of dashed lines to stretch. The default
281 is 30.
282 -v Include comments in the output file.
285 -W Enable variable line width. By default, only two line widths
288 are available: The normal line width ("\thinlines"), and thick
289 lines ("\thicklines"). See also the -l option above.
290 -w Disable variable line width. Only "\thicklines" and/or "\thin‐
293 lines" commands will be generated in the output file.
294 When variable line width option is enabled, the "\thinlines"
296 command is still used when the line width is less than
297 LineThick. One potential problem is that the width of "\thin‐
298 lines" is 0.4pt but the resolution of Fig is 1/80 inch (approx.
299 1pt). If LineThick is set to 2, normal lines will be drawn in
300 0.4pt wide lines but the next line width is already 2pt. One
301 possible solution is to set LineThick to 1 and set the width of
302 those lines you want to be drawn in "\thinlines" to 0.
303 Due to this problem, variable line width is disabled by default
305 (-w).
306
310 IBM-GL (IBM Graphics Language) is compatible with HP-GL (Hewlett-
311 Packard Graphics Language).
312 -a Select ANSI A paper size instead of the default ISO A4.
315 -c Generate instructions for an IBM 6180 Color Plotter without an
318 IBM Graphics Enhancement Cartridge (IBM-GEC).
319 -d xll,yll,xur,yur
322 Restrict plotting to a rectangular area of the plotter paper
323 which has a lower left hand corner at (xll,yll) and a upper
324 right hand corner at (xur,yur). All four numbers are in inches
325 and follow -d in a comma-separated list - xll,yll,xur,yur - with
326 no spaces between them.
327 -f fontfile
330 Load text character specifications from the table in the file
331 fontfile. The table must have 36 entries - one for each font
332 plus a default. Each entry consists of 5 numbers which specify
333 the
334 1.) standard character set (0 - 4, 6 - 9, 30 - 39),
335 2.) alternate character set (0 - 4, 6 - 9, 30 - 39),
336 3.) character slant angle (degrees),
337 4.) character width scale factor and
338 5.) character height scale factor.
339 -k Precede output with PCL command to use HP/GL.
342 -l pattfile
345 Load area fill line patterns from the table in the pattfile
346 file. The table must have 21 entries - one for each of the area
347 fill patterns. Each entry consists of 5 numbers which specify
348 the
349 1.) pattern number (-1 - 6),
350 2.) pattern length (inches),
351 3.) fill type (1 - 5),
352 4.) fill spacing (inches) and
353 5.) fill angle (degrees).
354 -P Rotate the figure to portrait mode. The default is landscape
357 mode.
358 -p penfile
361 Load plotter pen specifications from the table in the penfile
362 file. The table must have 9 entries - one for each color plus a
363 default. Each entry consists of 2 numbers which specify the
364 1.) pen number (1 - 8) and
365 2.) pen thickness (millimeters).
366 -S speed
369 Set the pen speed to speed (centimeters/second).
370 -v Plot the figure upside-down in portrait mode or backwards in
373 landscape mode. This allows you to write on the top surface of
374 overhead transparencies without disturbing the plotter ink on
375 the bottom surface.
376 -x offset
379 Shift figure left by offset inches.
380 -y offset
383 Shift figure up by offset inches.
384 Fig2dev may be installed with either ANSI A or ISO A4 default paper
387 size. The -a option selects the alternate paper size. Fig2dev does
388 not fill closed splines. The IBM-GEC is required to fill other poly‐
389 gons. Fig2dev may be installed for plotters with or without the IBM-
390 GEC. The -c option selects the alternate instruction set.
391
395 -b borderwidth
396 Make blank border around figure of width borderwidth (1/72
397 inch).
398 -d dmag
401 Set a separate magnification for the length of line dashes to
402 dmag.
403 -E num Set encoding for latex text translation (0 = no translation, 1 =
406 ISO-8859-1, 2 = ISO-8859-2; default 1).
407 -F Don't set the font face, series, and style; only set it's size
410 and the baselineskip. By default, fig2dev sets all 5 font param‐
411 eters when it puts some text. The disadvantage is that you can't
412 set the font from your LaTeX document. With this option on, you
413 can set the font from your LaTeX document.
414 If any of the pictures included in your LaTeX document has been
416 generated with -F, then all pictures must be generated with this
417 option.
418 -f font
421 Set the default font used for text objects to font, where font
422 is one of rm, bf, it, sf or tt. The default is rm.
423 -l lwidth
426 Sets the threshold between LaTeX thin and thick lines to lwidth
427 pixels. LaTeX supports only two different line widths: \thin‐
428 lines and \thicklines. Lines of width greater than lwidth pix‐
429 els are drawn as \thicklines. Also affects the size of dots in
430 dotted line style. The default is 1.
431 -v Verbose mode. Include comments in the otput file.
434 LaTeX cannot accurately represent all the graphics objects which can be
437 described by Fig. For example, the possible slopes which lines may
438 have are limited. Some objects, such as spline curves, cannot be drawn
439 at all. Fig2latex chooses the closest possible line slope, and prints
440 error messages when objects cannot be drawn accurately.
441
445 Xfig version 3.2.3 and later saves and allows the user to edit comments
446 for each Fig object. The fig2dev map output language will produce an
447 HTML image map using Fig objects that have href="some_html_reference"
448 in their comments. Any Fig object except compound objects may be used
449 for this. Usually, besides generating the map file, you would also
450 generate a PNG file, which is the image to which the map refers.
451 For example, you may have an xfig drawing with an imported image that
453 has the comment href="go_here.html" and a box object with a comment
454 href="go_away.html". This will produce an image map file such the user
455 may click on the image and the browser will load the "go_here.html"
456 page, or click on the box and the browser will load the "go_away.html"
457 page.
458 After the map file is generated by fig2dev you will need to edit it to
460 fill out any additional information it may need.
461 -b borderwidth
464 Make blank border around figure of width borderwidth (1/72
465 inch).
466
470 Fig2dev scales the figure by 1/8 before generating METAFONT code. The
471 magnification can be further changed with the -m option or by giving
472 magnification options to mf.
473 In order to process the generated METAFONT code, the mfpic macros must
475 be installed where mf can find them. The mfpic macro package is avail‐
476 able at any CTAN cite under the subdirectory: graphics/mfpic
477 -C code
480 Specify the starting METAFONT font code. The default is 32.
481 -n name
484 Specify the name to use in the output file.
485 -p pen_magnification
488 Specify how much the line width should be magnified compared to
489 the original figure. The default is 1.
490 -t top Specify the top of the whole coordinate system. The default is
493 ypos.
494 -x xmin
497 Specify the minimum x coordinate value of the figure (inches).
498 The default is 0.
499 -y ymin
502 Specify the minimum y coordinate value of the figure (inches).
503 The default is 0.
504 -X xmax
507 Specify the maximum x coordinate value of the figure (inches).
508 The default is 8.
509 -Y ymax
512 Specify the maximum y coordinate value of the figure (inches).
513 The default is 8.
514
518 -d file
519 Include file content as additional header.
520 -i file
523 Include file content via \input-command.
524 -M Multipage mode, generate one figure for each depth.
527 -o Old mode (no latex).
530 -p number
533 Adds the line "prologues:=number" to the output.
534
538 -f font
539 Set the default font used for text objects to font, where font
540 is one of R (roman), B (bold), I (italic), H (sans serif) or C
541 (typewriter). The default is R.
542 -p ext Enables the use of certain PIC extensions which are known to
545 work with the groff package; compatibility with DWB PIC is
546 unknown. The extensions enabled by each option are:
547 arc Allow ARC_BOX i.e. use rounded corners
549 line Use the 'line_thickness' value
550 fill Allow ellipses to be filled
551 all Use all of the above
552 psfont Don't convert PostScript fonts generic type
553 (useful for files going to be Ditroff'ed for
554 and printed on PS printer). DWB-compatible.
555 allps Use all of the above (i.e. "all" + "psfont")
556
559 PICT2E is an enhancement to the LaTeX picture environment. It is
560 enabled by inserting "\usepackage{pict2e}" in the document preamble.
561 Depending on the content of the figure, it may be necessary to also
562 include "\usepackage{color}" and "\usepackage{graphics}". Figures pro‐
563 duced with the PICT2E driver can be processed with any LaTeX engine,
564 e.g., LaTeX + dvips, LaTeX + dvipdfm, pdflatex, xelatex, ConTeX, etc.
565 Pattern fills are not supported by the PICT2E output language. The
566 PICT2E driver renders patterns by filling the respective area with the
567 pen-color at 25% intensity, i.e., a 75% tint of the pen-color. The
568 PICT2E driver allows one to choose any font available to the LaTeX
569 engine, including PostScript fonts.
570 -b borderwidth
573 Make blank border around figure of width borderwidth*(1/72)
574 inches.
575 -C num Do not emit a \color-command for the color number num. (0 =
578 black, 1 = blue, 2 = green - see the color chooser widget in
579 Xfig). By default, fig2dev does not issue a \color-command for
580 objects which have the color set to "Default" in xfig. With
581 this option, the "\color"-command is also omitted for objects
582 having the color num. The color of these objects, as well as of
583 those having the color set to "Default", is picked up from the
584 including LaTeX-document.
585 The option -C 0 is particularly useful. By default, xfig starts
587 with the color set to black. Then, fig2dev emits
588 "\color{black}" commands, and the color-package must be included
589 in the document preamble. For black text and black-and-white
590 drawings, this is superfluous.
591 -e Do not try to be compatible with epic/eepic. By default, you
594 can include "\usepackage{pict2e, epic, eepic}" (in this order!)
595 in the document preamble and mix LaTeX pictures using the
596 epic/eepic command set and pictures produced with the PICT2E
597 output language within one document. With this option on, epic
598 or eepic pictures can not be mixed with PICT2E-pictures.
599 By default, fig2dev avoids the use of the "\circle" and
601 "\oval"-commands, which are defined by epic, in lieu of the
602 "\circlearc"-command exclusive to pict2e. In addition, line
603 widths are not only set using "\linethickness", but also with
604 the eepic-command "\allinethickness" (if it is defined).
605 -E num Set encoding for text translation (0 = no translation, 1 =
608 ISO-8859-1, 2 = ISO-8859-2; default 1). For instance, to use
609 utf8-encoded text, first create a text object, then edit the
610 text using the edit-button in xfig. Convert the fig-file to
611 pict2e with the option -E 0 and include "\usepackage[utf8]{inpu‐
612 tenc}" in the LaTeX file In xfig, the text typed in may not be
613 displayed correctly, but the document produced from the LaTeX
614 file will show the same text as was typed in.
615 -F Do not set the font family, series or shape. By default,
618 fig2dev sets the font family, series, shape, font size and base‐
619 lineskip. With this option on, the text font can be set from
620 the including LaTeX-document, e.g., "\itshape
621 \input{fig1.pict2e}". See also -o (no font size).
622 -f font
625 Set the default font used for text objects to font. The string
626 font may be one of rm, bf, it, sf, tt, \rmfamily, \bfseries,
627 \itshape, \sffamily, \ttfamily, or one of the 35 standard Post‐
628 Script font names. The default is \rmfamily.
629 -i dir Prepend the string dir to graphics files included in the pict2e-
632 picture. For instance, having imported "image.jpg" in xfig,
633 with -i '$HOME/Figures/' the code "\incudegraphics{$HOME/Fig‐
634 ures/image.jpg}" will be generated.
635 -o Do not set the font size or baselineskip. Text will be rendered
638 at the size that is in force where the pict2e-code is inserted
639 into the LaTeX-document, e.g., "\small \input{fig1.pict2e}".
640 See also -F (no font properties).
641 -O Do not quote characters special to TeX/LaTeX. Useful to get,
644 e.g., an italic x, not $x$, because it was forgotten to set the
645 text-flag "special-text" in xfig. This option effectively sets
646 the "special-text" flag for all text.
647 -P Pagemode, generate a stand-alone LaTeX-file as out-file. The
650 document produced from the LaTeX-file will have the paper size
651 equal to the figure's bounding box (but see the -b option to add
652 a margin). The generated LaTeX-file calls the package "geome‐
653 try.sty" to set the paper size.
654 -R num Replace arrowheads num by LaTeX-arrows ("\vector"). The number
657 of an arrowhead ("Arrow Type" in xfig) can be found by opening
658 the arrow chooser widget in xfig and counting the arrows, start‐
659 ing from 1. For instance, to replace filled triangle arrowheads
660 with LaTeX \vector-commands, use -R 3.
661 -r Replace all arrows by LaTeX-arrows.
664 -T Only use TeX fonts, even where PostScript-fonts are specified.
667 -v Verbose mode. Write comment lines into the output file, usually
670 naming the type of the object that is drawn.
671 -w Remove the suffix from included graphics-files. With this
674 option on, fig2dev generates code that contains, e.g.,
675 "\includegraphics{fig1}", instead of "\includegraph‐
676 ics{fig1.eps}".
677
681 In order to include PiCTeX pictures into a document, it is necessary to
682 load the PiCTeX macros.
683 PiCTeX uses TeX integer register arithmetic to generate curves, and so
685 it is very slow. PiCTeX draws curves by \put-ing the psymbol repeat‐
686 edly, and so requires a large amount of TeX's internal memory, and gen‐
687 erates large DVI files. The size of TeX's memory limits the number of
688 plot symbols in a picture. As a result, it is best to use PiCTeX to
689 generate small pictures.
690 -a Anonymous mode. Do not write the user name into the output file.
693 -E num Set encoding for latex text translation (0 = no translation, 1 =
696 ISO-8859-1, 2 = ISO-8859-2; default 1).
697 -f font
700 Set the default font used for text objects to font, where font
701 is one of rm, bf, it, sf or tt. The default is rm.
702 -l dimen
705 Set line thickness to dimen. Default "1pt".
706 -p psymbol
709 Set the psymbol. Default "\makebox(0,0)[l]{\tencirc\sym‐
710 bol{'160}}".
711 -r Do not allow rotated text. Otherwise, files with PiCTeX macros
714 and rotated text need to be processed with dvips.
715
718 Typically you will wish to set the y scale to -1. See -g for more
719 information.
720 -d [mm|in]
723 Output dimensions should be assumed to be millimeters (mm) or
724 inches (in). The default is millimeters.
725 -p [pos|neg]
728 Select the image polarity. For positive images lines drawn in
729 the fig file will generate lines of material. For negative
730 images lines drawn in the fig file will result in removed mate‐
731 rial. Consider etching a chrome on glass transmission mask.
732 Drawing lines in the fig file and choosing 'neg' will result in
733 these lines being etched through the chrome, leaving transparent
734 lines.
735 -g <x scale>x<y scale>+<x offset>+<y offset>
738 This controls the geometry of the output, scaling the dimensions
739 as shown and applying the given offset. Typically you will wish
740 to set the y scale to -1, mirroring about the x axis. This is
741 because Gerber assumes the origin to be bottom left, while xfig
742 selects top left.
743 -f <n digits>.<n digits>
746 This controls the number of digits of precision before and after
747 the implied decimal point. With -f 5.3 the following number
748 12345678 corresponds to 12345.678. Whereas with -f 3.5 it cor‐
749 responds to 123.45678. The default is for 3 places before the
750 decimal point and 5 after. This corresponds, to a range of 0 to
751 1m in 10 micron increments.
752 -v Output comments describing the type of objects being output.
755 The text appears as comments starting with ## on each line in
756 the output file.
757
761 With PostScript, xfig can be used to create multiple page figures.
762 Specify the -M option to produce a multi-page output. For posters, add
763 -O to overlap the pages slightly to get around the problem of the
764 unprintable area in most printers, then cut and paste the pages
765 together. Great for text with very big letters.
766 The EPS driver has the following differences from PostScript:
768 o No showpage is generated because the output is meant to be
769 imported into another program or document and not printed
770 o The landscape/portrait options are ignored
771 o The centering option is ignored
772 o The multiple-page option is ignored
773 o The paper size option is ignored
774 o The x/y offset options are ignored
775 The EPS driver has the following two special options:
777 -B 'Wx [Wy X0 Y0]'
780 This specifies that the bounding box of the EPS file should have
781 the width Wx and the height Wy. Note that it doesn't scale the
782 figure to this size, it merely sets the bounding box. If a
783 value less than or equal to 0 is specified for Wx or Wy, these
784 are set to the width/height respectively of the figure. Origin
785 is relative to screen (0,0) (upper-left). Wx, Wy, X0 and Y0 are
786 interpreted in centimeters or inches depending on the measure
787 given in the fig-file. Remember to put either quotes (") or
788 apostrophes (') to group the arguments to -B.
789 -R 'Wx [Wy X0 Y0]'
792 Same as the -B option except that X0 and Y0 is relative to the
793 lower left corner of the figure. Remember to put either quotes
794 (") or apostrophes (') to group the arguments to -R.
795 The PDF driver accepts all of the PostScript options, if the -P (page‐
798 mode) option is given. In this case, the size of the PDF is the page‐
799 size given in the file or set from the command line via the -z option.
800 Otherwise, if -P is not given, the PDF is cropped to the bounding box
801 of the figure (optionally with a blank border margin set by the -b
802 option), and all of the EPS options are supported.
803 Text can now include various ISO-character codes above 0x7f, which is
806 useful for language specific characters to be printed directly. Not
807 all ISO-characters are implemented.
808 Color support: Colored objects created by Fig can be printed on a color
810 postscript printer. There are 32 standard colors: black, yellow, white,
811 gold, five shades of blue, four shades of green, four shades of cyan,
812 four shades of red, five shades of magenta, four shades of brown, and
813 four shades of pink. In addition there may be user-defined colors in
814 the file. See the xfig FORMAT3.2 file for the definition of these col‐
815 ors. On a monochrome printer, colored objects will be mapped into dif‐
816 ferent grayscales by the printer. Filled objects are printed using the
817 given area fill and color. There are 21 "shades" going from black to
818 full saturation of the fill color, and 21 more "tints" from full satu‐
819 ration + 1 to white. In addition, there are 16 patterns such as
820 bricks, diagonal lines, crosshatch, etc.
821 -A Add an ASCII (EPSI) preview. Not for PDF.
824 -a Anonymous mode. Do not write the user's login name into the out‐
827 put file.
828 -b borderwidth
831 Make blank border around figure of width borderwidth (1/72
832 inch).
833 -C dummy_arg
836 Add a color *binary* TIFF preview for Microsoft products that
837 need a binary preview. See also -T (monochrome preview). A
838 dummy argument must be supplied for historical reasons. Not for
839 PDF output.
840 -c Center the figure on the page. The centering may not be accu‐
843 rate if there are texts in the fig_file that extends too far to
844 the right of other objects.
845 -e Put the figure against the edge (not centered) of the page. Not
848 available in EPS.
849 -F Use correct font sizes (points, 1/72 inch) instead of the tradi‐
852 tional size that xfig/fig2dev uses, which is 1/80 inch. The
853 corresponding xfig command-line option is -correct_font_size.
854 -f font
857 Set the default font used for text objects to font, where font
858 is one of the 35 standard PostScript font names. The default is
859 Times-Roman.
860 -g color
863 Use color for the background.
864 -l dummy_arg
867 Generate figure in landscape mode. The dummy argument is
868 ignored, but must appear on the command line for reasons of com‐
869 patibility. This option will override the orientation specifi‐
870 cation in the file (for file versions 3.0 and higher). Not
871 available in EPS.
872 -M Generate multiple pages if figure exceeds paper size. Not
875 available in EPS.
876 -N Convert all colors to grayscale.
879 -n name
882 Set the Title part of the PostScript output to name. This is
883 useful when the input to fig2dev comes from standard input.
884 -O When used with -M, overlaps the pages slightly to get around the
887 problem of the unprintable area in most printers. Not available
888 in EPS.
889 -p dummy_arg
892 Generate figure in portrait mode. The dummy argument is
893 ignored, but must appear on the command line for reasons of com‐
894 patibility. This option will override the orientation specifi‐
895 cation in the file (for file versions 3.0 and higher). This is
896 the default for Fig files of version 2.1 or lower. Not avail‐
897 able in EPS.
898 -T Add a monochrome *binary* TIFF preview for Microsoft products
901 that need a binary preview. See also -C (color preview). Not
902 available for PDF output.
903 -x offset
906 Shift the figure in the X direction by offset PostScript points
907 (1/72 inch). A negative value shifts the figure to the left and
908 a positive value to the right. Not available in EPS.
909 -y offset
912 Shift the figure in the Y direction by offset points (1/72
913 inch). A negative value shifts the figure up and a positive
914 value down. Not available in EPS.
915 -z papersize
918 Set the papersize. Not available in EPS.
919 Available paper sizes are:
920 Letter (8.5" x 11" also A),
922 Legal ( 11" x 14")
923 Ledger ( 11" x 17"),
924 Tabloid ( 17" x 11", really Ledger in Landscape mode),
925 A (8.5" x 11" also Letter),
926 B ( 11" x 17" also Ledger),
927 C ( 17" x 22"),
928 D ( 22" x 34"),
929 E ( 34" x 44"),
930 A9 ( 37 mm x 52 mm),
931 A8 ( 52 mm x 74 mm),
932 A7 ( 74 mm x 105 mm),
933 A6 (105 mm x 148 mm),
934 A5 (148 mm x 210 mm),
935 A4 (210 mm x 297 mm),
936 A3 (297 mm x 420 mm),
937 A2 (420 mm x 594 mm),
938 A1 (594 mm x 841 mm),
939 A0 (841 mm x1189 mm),
940 B10 ( 32 mm x 45 mm),
941 B9 ( 45 mm x 64 mm),
942 B8 ( 64 mm x 91 mm),
943 B7 ( 91 mm x 128 mm),
944 B6 (128 mm x 182 mm),
945 B5 (182 mm x 257 mm),
946 B4 (257 mm x 364 mm),
947 B3 (364 mm x 515 mm),
948 B2 (515 mm x 728 mm),
949 B1 (728 mm x1030 mm),
950 B0 (1030mm x1456 mm).
951
954 The pstex and pdftex languages are a variant of ps which suppress text
955 that has the text flag "TeX Text" set. The pstex_t and pdftex_t lan‐
956 guages have the complementary behavior: they generate only the text
957 that has the "Tex Text" flag set and the commands necessary to position
958 this text. They also generate the commands necessary to overlay the
959 PostScript or PDF file generated using pstex/pdftex. These two drivers
960 can be used to generate a figure which combines the flexibility of
961 PostScript graphics with LaTeX text formatting of text flagged as "TeX
962 Text".
963 The pstex and pdftex drivers accept the same options that the EPS
965 driver accepts.
966 -n name
969 Set the Title part of the PostScript output to name. This is
970 useful when the input to fig2dev comes from standard input.
971
974 The pstex_t and pdftex_t languages produce only the text flagged with
975 the "TeX Text" flag, the commands necessary to position this text, and
976 the commands necesary to overlay the PostScript or PDF file generated
977 using pstex or pdftex (see above).
978 -E num Set encoding for latex text translation (0 no translation, 1
981 ISO-8859-1, 2 ISO-8859-2; default 1)
982 -F Don't set the font face, series, and style; only set it's size
985 and the baselineskip. By default, fig2dev sets all 5 font param‐
986 eters when it puts some text. The disadvantage is that you can't
987 set the font from your LaTeX document. With this option on, you
988 can set the font from your LaTeX document (like "\sfshape \input
989 picture.eepic").
990 -p file
993 specifies the name of the PostScript file to be overlaid. If
994 not set or its value is null then no PS file will be inserted.
995
999 The PSTricks driver provides full LaTeX text and math formatting for
1000 XFig drawings without overlaying separate outputs as in the PSTEX meth‐
1001 ods. The output matches the quality of output of the PostScript driver
1002 except for text, where the Latex font selection mechanism is used as
1003 for other fig2dev LaTeX drivers. In addition, text is rendered black,
1004 although font color-changing LaTex code can be embedded in the drawing.
1005 The generated PSTricks code is meant to be readable. Each command
1006 stands alone, not relying on global option state variables. Thus the
1007 user can easily use XFig to rough out a PSTricks drawing, then finish
1008 by hand editing.
1009 To use the driver's output, give the command "\usepackage{pstricks}" in
1011 your document preamble. The graphicx and pstricks-add packages may
1012 also be required. The former is used for bitmap graphics and the sec‐
1013 ond for complex line styles and/or hollow PSTricks arrows (with the -R
1014 1 option). The driver will tell you which packages are needed. In the
1015 document body, include the figure with "\input{pstfile}" where pst‐
1016 file.tex is the output file. Use the XFig special flag to have text
1017 passed as-is to LaTeX. For non-special text, the same mechanism as the
1018 LaTeX and epic driver mechanism is used to match font specs, but this
1019 is imprecise.
1020 Known bugs and limitations.
1023 PSTricks support for join styles is version dependent. Raw post‐
1024 script is inserted with "\pstVerb" for old versions when other
1025 than angle joins are needed. The -t option controls this behav‐
1026 ior. PSTricks does not support rotated ellipses directly, so a
1027 rput command is emitted that rotates and locates a horizontal
1028 ellipse. This makes a problem with hatch patterns, which are
1029 moved and rotated along with the ellipse. Hatch rotation is
1030 fixed by a counter-rotation, but the origin is not adjusted, so
1031 registration with adjacent hatch patterns will be incorrect.
1032 Flipped bitmap graphics use an undocumented feature of the
1033 graphicx package: a negative height flips the image vertically.
1034 This appears to work reliably. However, you may want to flip
1035 graphics with another program before including them in Xfig
1036 drawings just to be sure. With the -p option, the driver
1037 attempts to convert non-EPS pictures to EPS with the TeX distri‐
1038 bution's bmeps program, but bmeps does not know about very many
1039 file formats including gif.
1040 -f font
1043 Set the default font used for text objects to font, where font
1044 is one of rm, bf, it, sf or tt. The default is rm.
1045 -G dummy_arg
1048 Draws a standard PSTricks grid in light gray, ignoring the size
1049 parameters, numbered in PSTricks units.
1050 -l weight
1053 Sets a line weight factor that is multiplied by the actual Fig
1054 line width. The default value 0.5 roughly matches the output of
1055 the PS driver.
1056 -n 0|1|2|3
1059 Sets environment type. Default 0 creates a \picture environment
1060 with bounding box exactly enclosing the picture (but see -x and
1061 -y ). A 1 emits bare PSTricks commands with no environment at
1062 all, which can be used with \input{commands} inside an existing
1063 \pspicture. A 2 emits a complete LaTeX document. A 3 also
1064 emits a complete LaTeX document but attempts to set the PSTricks
1065 unit to fit a 7.5 by 10 inch (portrait aspect) box.
1066 -P Shorthand for -n 3.
1069 -p dir Attempts to run the bmeps program to translate picture files to
1072 EPS, which is required by PSTricks. The translated files go in
1073 dir , which must already exist (the driver will not create it).
1074 Moreover, (BIG CAVEAT HERE) the driver overwrites files with
1075 impunity in this directory! Don't put your stuff here. The
1076 includegraphics commands in the output file refer to this direc‐
1077 tory. Even if the -p option is not used, includegraphics com‐
1078 mands follow this convention with the default directory ./eps .
1079 In this case, the user must do the conversions independently.
1080 The bmeps program is part of the standard TeX distribution. It
1081 converts the following formats to EPS: png jpg pnm tif. You can
1082 see the bmeps command with the -v option.
1083 -R 0|1|2
1086 Sets arrow style. With the default style 0, Fig arrows are con‐
1087 verted to lines and polygons. With style 1, the Fig arrowhead
1088 dimensions are converted to PSTricks arrowhead dimensions and
1089 PSTricks arrowhead options are emitted. Hollow arrows will
1090 require the additional package pstricks-add. With style 2,
1091 PSTricks arrowhead options are emitted with no dimensions at
1092 all, and arrowhead size may be controlled globally with psset.
1093 -S scale
1096 Scales the image according to the same convention as the EPIC
1097 driver, i.e., to size scale/12.
1098 -t version
1101 Provides the driver with PSTricks version number so output can
1102 match expected LaTeX input.
1103 -v Print verbose warnings and extra comments in the output file.
1106 Information provided includes font substitution details, the
1107 bmeps commands used for picture conversion, if any, and one com‐
1108 ment per Fig object in the output.
1109 -x marginsize
1112 Adds marginsize on the left and right of the PStricks bounding
1113 box. By default, the box exactly encloses the image.
1114 -y marginsize
1117 Adds marginsize on the top and bottom of the PStricks bounding
1118 box. By default, the box exactly encloses the image.
1119 -z 0|1|2
1123 Sets font handling option. Default option 0 attempts to honor
1124 Fig font names and sizes, finding the best match with a standard
1125 LaTeX font. Option 1 sets LaTeX font size only. Option 2
1126 issues no font commands at all.
1127
1131 -f font
1132 Set the default font used for text objects to font, where font
1133 is one of rm, bf, it, sf or tt. The default is rm.
1134 -l lwidth
1137 Set the line thickness. lwidth must be a value between 1 and 12.
1138
1141 TIKZ is a powerful frontend to the Portable Graphics Format (PGF)
1142 developed by Till Tantau, now at the University of Lübeck. TIKZ was
1143 developed to be as platform-independent as possible, i.e., tikz-code
1144 can be processed with plain TeX, pdftex, xetex, LaTeX, ConTeX, pdfla‐
1145 tex, lualatex, or combinations of LaTeX + dvips, LaTeX + dvipdfm or
1146 others. The TIKZ-code emitted by fig2dev tries to maintain this porta‐
1147 bility. For instance, a tikz-picture is commenced with \tikzpicture
1148 (TeX-style), to not exclude any processing engine. However, the stand-
1149 alone file produced with the -P option must be processed with a LaTeX-
1150 engine. In addition, font-commands may require a LaTeX engine.
1151 -b borderwidth
1154 Make blank border around figure of width borderwidth*(1/72)
1155 inches.
1156 -C num Do not emit a \color-command for the color number num. (0 =
1159 black, 1 = blue, 2 = green - see the color chooser widget in
1160 Xfig). By default, fig2dev does not issue a \color-command for
1161 objects which have the color set to "Default" in xfig. With
1162 this option, the "\color"-command is also omitted for objects
1163 having the color num. The color of these objects, as well as of
1164 those having the color set to "Default", is picked up from the
1165 including document.
1166 -E num Set encoding for text translation (0 = no translation, 1 =
1169 ISO-8859-1, 2 = ISO-8859-2; default 1). For instance, to use
1170 utf8-encoded text, first create a text object, then edit the
1171 text using the edit-button in xfig. Convert the fig-file to tikz
1172 with the option -E 0 and include "\usepackage[utf8]{inputenc}"
1173 in the LaTeX file (not necessary when using xelatex). In xfig,
1174 the text typed in may not be displayed correctly, but the docu‐
1175 ment produced from the LaTeX file will show the same text as was
1176 typed in.
1177 -F Do not set the font family, series or shape. By default,
1180 fig2dev sets the font family, series, shape, font size and base‐
1181 lineskip. As a side effect, this requires the New Font Selec‐
1182 tion Scheme (NFSS) of LaTeX. With this option on, the text font
1183 can be set from the including document, which may be TeX or
1184 LaTeX. See also -o (no font size).
1185 -f font
1188 Set the default font used for text objects to font. The string
1189 font may be one of rm, bf, it, sf, tt, \rmfamily, \bfseries,
1190 \itshape, \sffamily, \ttfamily, or one of the 35 standard Post‐
1191 Script font names. The default is \rmfamily.
1192 -i dir Prepend the string dir to graphics files included in the tikz-
1195 picture. For instance, having imported "image.jpg" in xfig,
1196 with - i '$HOME/Figures/' the code "\pgfimage[width=...,
1197 height=...]{$HOME/Figures/image.jpg}" will be generated.
1198 -O Do not quote characters special to TeX/LaTeX. Useful to get,
1201 e.g., an italic x, not $x$, because it was forgotten to set the
1202 text-flag "special-text" in xfig. This option effectively sets
1203 the "special-text" flag for all text.
1204 -o Do not set the font size or baselineskip. Text will be rendered
1207 at the size that is in force where the tikz-code is inserted
1208 into the document, e.g., "\small\input fig1.tikz". See also -F
1209 (no font properties).
1210 -P Pagemode, generate a stand-alone LaTeX-file as out-file. The
1213 document produced from the LaTeX-file will have the paper size
1214 equal to the figure's bounding box (but see the -b option to add
1215 a margin). The generated LaTeX-file calls the package "geome‐
1216 try.sty" to set the paper size.
1217 -T Only use TeX fonts, even where PostScript-fonts are specified.
1220 -v Verbose mode. Write comment lines into the output file, usually
1223 naming the type of the object that is drawn.
1224 -W Do not emit code at the beginning of the file that allows to set
1227 the figure width or height from the including TeX document.
1228 Otherwise, e.g., "\newdimen\XFigwidth\XFigwidth=\linewidth"
1229 would scale the following figures to the line width.
1230 -w Remove the suffix from included graphics-files. With this
1233 option on, fig2dev generates code that contains, e.g., "\pgfim‐
1234 age{fig1}" instead of "\pgfimage{fig1.pdf}".
1235
1238 Arc-boxes are not supported for the tk output language, and only X bit‐
1239 map pictures are supported because of the canvas limitation in tk.
1240 Picture objects are not scaled with the magnification factor for tk
1241 output.
1242 Because tk scales canvas items according to the X display resolution,
1243 polygons, lines, etc. may be scaled differently than imported pictures
1244 (bitmaps) which aren't scaled at all.
1245 -g color
1248 Use color for the background.
1249 -l dummy_arg
1252 Generate figure in landscape mode. The dummy argument is
1253 ignored, but must appear on the command line for reasons of com‐
1254 patibility. This option will override the orientation specifi‐
1255 cation in the file (for file versions 3.0 and higher).
1256 -p dummy_arg
1259 Generate figure in portrait mode. The dummy argument is
1260 ignored, but must appear on the command line for reasons of com‐
1261 patibility. This option will override the orientation specifi‐
1262 cation in the file (for file versions 3.0 and higher). This is
1263 the default for Fig files of version 2.1 or lower.
1264 -P Generate canvas of full page size instead of using the bounding
1267 box of the figure's objects. The default is to use only the
1268 bounding box.
1269 -w Wrap the figure with code in order to generate a complete perl
1272 file. That is, you can do fig2dev -L ptk -w f.fig f.pl; perl
1273 f.pl and a widget pops up that shows the graphics contained in
1274 f.pl. Only available for ptk output.
1275 -z papersize
1278 Set the paper size. See the POSTSCRIPT OPTIONS for available
1279 paper sizes. This is only used when the -P option (use full
1280 page) is used.
1281
1285 -f font
1286 Set the default font used for text objects to font. The default
1287 is rm. The string font can be one of rm, bf, it, sf, tt, avant,
1288 avantcsc, avantd, avantdi, avanti, bookd, bookdi, bookl,
1289 booklcsc, bookli, chanc, cour, courb, courbi, couri, helv,
1290 helvb, helvbi, helvc, helvcb, helvcbi, helvci, helvcsc, helvi,
1291 pal, palb, palbi, palbu, palc, palcsc, pali, palsl, palu, palx,
1292 times, timesb, timesbi, timesc, timescsc, timesi, timessl or
1293 timesx.
1294
1298 xfig(1), pic(1), pic2fig(1), transfig(1)
1299
1303 Please send bug reports, fixes, new features etc. to:
1304 thomas.loimer@tuwien.ac.at
1305
1308 Copyright (c) 1991 Micah Beck
1309 Parts Copyright (c) 1985-1988 Supoj Sutantavibul
1310 Parts Copyright (c) 1989-2015 Brian V. Smith
1311 Parts Copyright (c) 2015-2018 by Thomas Loimer
1312 Permission to use, copy, modify, distribute, and sell this software and
1314 its documentation for any purpose is hereby granted without fee, pro‐
1315 vided that the above copyright notice appear in all copies and that
1316 both that copyright notice and this permission notice appear in sup‐
1317 porting documentation. The authors make no representations about the
1318 suitability of this software for any purpose. It is provided "as is"
1319 without express or implied warranty.
1320 THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
1322 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
1323 EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSE‐
1324 QUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
1325 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
1326 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PER‐
1327 FORMANCE OF THIS SOFTWARE.
1328
1332 Micah Beck
1333 Cornell University
1334 Sept 28 1990
1335 and Frank Schmuck (then of Cornell University)
1337 and Conrad Kwok (then of U.C. Davis).
1338 Drivers contributed by
1340 Jose Alberto Fernandez R. (U. of Maryland)
1341 and Gary Beihl (MCC)
1342 Color support, ISO-character encoding and poster support by
1344 Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
1345 Modified from f2p (fig to PIC), by the author of Fig
1347 Supoj Sutanthavibul (supoj@sally.utexas.edu)
1348 University of Texas at Austin.
1349 MetaFont driver by
1351 Anthony Starks (ajs@merck.com)
1352 X-splines code by
1354 Carole Blanc (blanc@labri.u-bordeaux.fr)
1355 Christophe Schlick (schlick@labri.u-bordeaux.fr)
1356 The initial implementation was done by C. Feuille, S. Grobois, L.
1357 Maziere and L. Minihot as a student practice (Universite Bordeaux,
1358 France).
1359 Japanese text support for LaTeX output written by T. Sato
1361 (VEF00200@niftyserve.or.jp)
1362 The tk driver was written by
1364 Mike Markowski (mm@udel.edu) with a little touch-up by Brian Smith
1365 The CGM driver (Computer Graphics Metafile) was written by
1367 Philippe Bekaert (Philippe.Bekaert@cs.kuleuven.ac.be)
1368 The EMF driver (Enhanced Metafile) was written by
1370 Michael Schrick (m_schrick@hotmail.com)
1371 The GBX (Gerber) driver was written by
1373 Edward Grace (ej.grace@imperial.ac.uk).
1374Version 3.2.7a May 2018 fig2dev(1)