1FIG2DEV(1) General Commands Manual FIG2DEV(1)
2
6 fig2dev - translates Fig code to various graphics languages
7
10 fig2dev -L language [ -m mag ] [ -f font ] [ -s fsize ] [ other options
11 ] [ fig-file [ out-file ] ]
12
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
31 -L language
32 Set the output graphics language. Valid languages are box, cgm,
33 epic, eepic, eepicemu, emf, eps, gbx (Gerber beta driver), gif,
34 ibmgl, jpeg, latex, map (HTML image map), mf (MetaFont), mp
35 (MetaPost), mmp (Multi-MetaPost), pcx, pdf, pdftex, pdftex_t,
36 pic, pictex, png, ppm, ps, pstex, pstex_t, pstricks, ptk
37 (Perl/tk), shape (LaTeX shaped paragraphs), sld (AutoCad slide
38 format), svg (beta driver), textyl, tiff, tk (tcl/tk), tpic, xbm
39 and xpm.
40 Notes:
42 dvips and xdvi must be compiled with the tpic support (-DTPIC)
43 for epic, eepic and tpic to work.
44 You must have ghostscript and ps2pdf, which comes with the
45 ghostscript distribution to get the pdf output and the bitmap
46 formats (png, jpeg, etc.), and the netpbm (pbmplus) package to
47 get gif, xbm, xpm, and sld output.
48 -h Print help message with all options for all output languages
51 then exit.
52 -V Print the program version number and exit.
55 -D +/-rangelist
58 With +rangelist, keep only those depths in the list. With
59 -rangelist, keep all depths except those in the list. The range‐
60 list may be a list of comma-separated numbers or ranges sepa‐
61 rated by colon (:). For example, -D +10,40,55:70,80 means keep
62 only layers 10, 40, 55 through 70, and 80.
63 -K The selection of the depths with the '-D +/-rangelist' option
66 does normally not affect the calcualtion of the bounding box.
67 Thus the generated document might have a much larger bounding
68 box than necessary. If -K is given then the bounding box is
69 adjusted to include only those objects in the selected depths.
70 -f font
73 Set the default font used for text objects to font. The default
74 is Roman; the format of this option depends on the graphics lan‐
75 guage in use. In TeX-based languages, the font is the base of
76 the name given in lfonts.tex, for instance "cmr" for Roman, or
77 "tt" for teletype. In PostScript, it is any font name known to
78 the printer or interpreter. For Gerber it has no effect.
79 -G minor[:major][:unit]
82 Draws a grid on the page. Specify thin, or thin and thick line
83 spacing in one of several units. For example, "-G .25:1cm"
84 draws a thin, gray line every .25 cm and a thicker gray line
85 every 1 cm. Specifying "-G 1in" draws a thin line every 1 inch.
86 Fractions may be used, e.g. "-G 1/16:1/2in" will draw a thin
87 line every 1/16 inch (0.0625 inch) and a thick line every 1/2
88 inch.
89 Allowable units are: i, in, inch, f, ft, feet, c, cm, mm, and m.
90 Only allowed for PostScript, EPS, PDF, and bitmap (GIF, JPEG,
91 etc) drivers for now.
92 -j Enable the I18N internationalization facility.
95 -m mag Set the magnification at which the figure is rendered to mag.
98 The default is 1.0. This may not be used with the maxdimension
99 option (-Z).
100 -s size
103 Set the default font size (in points) for text objects to fsize.
104 The default is 11*mag, and thus is scaled by the -m option. If
105 there is no scaling, the default font is eleven point Roman."
106 -Z maxdimension
109 Scale the figure so that the maximum dimension (width or height)
110 is maxdimension inches or cm, depending on whether the figure
111 was saved with imperial or metric units. This may not be used
112 with the magnification option (-m).
113 other options
116 The other options are specific to the choice of graphics lan‐
117 guage, as described below.
118
121 CGM is Computer Graphics Metafile, developed by ISO and ANSI and is a
122 vector-based plus bitmap language. Microsoft WORD, PowerPoint and
123 probably other products can import this format and display it on the
124 screen, something that they won't do with EPS files that have an ASCII
125 preview.
126 -b dummyarg
128 Generate binary output (dummy argument required after the "-b").
129 -r Position arrowheads for CGM viewers that display rounded arrow‐
132 heads. Normally, arrowheads are pointed, so fig2dev compensates
133 for this by moving the endpoint of the line back so the tip of
134 the arrowhead ends where the original endpoint of the line was.
135 If the -r option is used, the position of arrows will NOT be
136 corrected for compensating line width effects, because the
137 rounded arrowhead doesn't extend beyond the endpoint of the
138 line.
139
142 EMF is Enhanced Metafile, developed by Microsoft and is a vector-based
143 plus bitmap language. Microsoft WORD, PowerPoint and probably other
144 products can import this format and display it on the screen, something
145 that they won't do with EPS files that have an ASCII preview.
146
149 EPIC is an enhancement to LaTeX picture drawing environment. It was
150 developed by Sunil Podar of Department of Computer Science in S.U.N.Y
151 at Stony Brook.
152 EEPIC is an extension to EPIC and LaTeX picture drawing environment
154 which uses tpic specials as a graphics mechanism. It was written by
155 Conrad Kwok of Division of Computer Science at University of Califor‐
156 nia, Davis.
157 EEPIC-EMU is an EEPIC emulation package which does not use tpic spe‐
159 cials.
160 -A factor
163 Scale arrowheads by factor. The width and height of arrowheads
164 is divided by this factor. This is because EPIC arrowheads are
165 normally about double the size of TeX arrowheads.
166 -E num Set encoding for text translation (0 = none, 1 = ISO-8859-1, 2 =
169 ISO-8859-2)
170 -F Don't set the font face, series, and style; only set it's size
173 and the baselineskip. By default, fig2dev sets all 5 font param‐
174 eters when it puts some text. The disadvantage is that you can't
175 set the font from your LaTeX document. With this option on, you
176 can set the font from your LaTeX document (like "\sfshape \input
177 picture.eepic").
178 If any of the pictures included in your LaTeX document has been
180 generated with -F, then all pictures must be generated with this
181 option.
182 This option can be used only when fig2dev was compiled with NFSS
184 defined.
185 -l width
188 Use "\thicklines" when width of the line is wider than lwidth.
189 The default is 2.
190 -P Generate a complete LaTeX file. In other words, the output file
193 can be formatted without requiring any changes. The additional
194 text inserted in the beginning and at the end of the file is
195 controlled by the configuration parameter "Preamble" and "Post‐
196 amble".
197 -R Allow rotated text. Rotated text will be set using the \rotate‐
200 box command. So, you will need to include "\usepackage{graph‐
201 ics}" in the preamble of your LaTeX document.
202 If this option is not set, then rotated text will be set hori‐
204 zontally.
205 -S scale
209 Set the scale to which the figure is rendered. This option
210 automatically sets the magnification and size to scale / 12 and
211 scale respectively.
212 -t stretch
215 Set the stretch factor of dashed lines to sretch. The default
216 is 30.
217 -v Include comments in the output file.
220 -W Enable variable line width. By default, only two line widths
223 are available: The normal line width (hinlines), and thick lines
224 (hicklines), if a line width of more than one is selected in
225 xfig.
226 -w Disable variable line width. Only "\thicklines" and/or "\thin‐
229 lines" commands will be generated in the output file.
230 When variable line width option is enabled, "\thinlines" command
232 is still used when line width is less than LineThick. One poten‐
233 tial problem is that the width of "\thinlines" is 0.4pt but the
234 resolution of Fig is 1/80 inch (approx. 1pt). If LineThick is
235 set to 2, normal lines will be drawn in 0.4pt wide lines but the
236 next line width is already 2pt. One possible solution is to set
237 LineThick to 1 and set the width of the those lines you want to
238 be drawn in "\thinlines" to 0.
239 Due to this problem, Variable line width VarWidth is defaulted
241 to be false.
242
246 IBM-GL (IBM Graphics Language) is compatible with HP-GL (Hewlett-
247 Packard Graphics Language).
248 -a Select ISO A4 (ANSI A) paper size if the default is ANSI A (ISO
251 A4) paper size.
252 -c Generate instructions for an IBM 6180 Color Plotter with (with‐
255 out) an IBM Graphics Enhancement Cartridge (IBM-GEC).
256 -d xll,yll,xur,yur
259 Restrict plotting to a rectangular area of the plotter paper
260 which has a lower left hand corner at (xll,yll) and a upper
261 right hand corner at (xur,yur). All four numbers are in inches
262 and follow -d in a comma-sparated list - xll,yll,xur,yur - with
263 no spaces between them.
264 -f file
267 Load text character specifications from the table in the fonts
268 file. The table must have 36 entries - one for each font plus a
269 default. Each entry consists of 5 numbers which specify the 1.)
270 standard character set (0 - 4, 6 - 9, 30 - 39), 2.) alternate
271 character set (0 - 4, 6 - 9, 30 - 39), 3.) character slant angle
272 (degrees), 4.) character width scale factor and 5.) character
273 height scale factor.
274 -k Precede output with PCL command to use HP/GL
277 -l pattfile
280 Load area fill line patterns from the table in the pattfile
281 file. The table must have 21 entries - one for each of the area
282 fill patterns. Each entry consists of 5 numbers which specify
283 the 1.) pattern number (-1 - 6), 2.) pattern length (inches),
284 3.) fill type (1 - 5), 4.) fill spacing (inches) and 5.) fill
285 angle (degrees).
286 -m mag,x0,y0
289 The magnification may appear as the first element in a comma
290 separated list - mag,x0,y0 - where the second and third parame‐
291 ters specify an offset in inches.
292 -P Rotate the figure to portrait mode. The default is landscape
295 mode.
296 -p penfile
299 Load plotter pen specifications from the table in the penfile
300 file. The table must have 9 entries - one for each color plus a
301 default. Each entry consists of 2 numbers which specify the 1.)
302 pen number (1 - 8) and 2.) pen thickness (millimeters).
303 -S speed
306 Set the pen speed to speed (centimeters/second).
307 -v Plot the figure upside-down in portrait mode or backwards in
310 landscape mode. This allows you to write on the top surface of
311 overhead transparencies without disturbing the plotter ink on
312 the bottom surface.
313 Fig2dev may be installed with either ANSI A or ISO A4 default paper
315 size. The -a option selects the alternate paper size. Fig2dev does
316 not fill closed splines. The IBM-GEC is required to fill other poly‐
317 gons. Fig2dev may be installed for plotters with or without the IBM-
318 GEC. The -c option selects the alternate instruction set.
319
322 -b borderwidth
323 Make blank border around figure of width borderwidth.
324 -F Use correct font sizes (points, 1/72 inch) instead of the tradi‐
327 tional size that xfig/fig2dev uses, which is (1/80 inch). The
328 corresponding xfig command-line option is -correct_font_size.
329 -g color
332 Use color for the background.
333 -N Convert all colors to grayscale.
336 -S smoothfactor
339 This will smooth the output by passing smoothfactor to ghost‐
340 script in the -dTextAlphaBits and -dGraphicsAlphaBits options to
341 improve font rendering and graphic smoothing. A value of 2 for
342 smoothfactor provides some smoothing and 4 provides more.
343
346 -t color
347 Use color for the transparent color in the GIF file. This must
348 be specified in the same format that ppmmake(1) allows. It may
349 allow an X11 color name, but at least you may use a six-digit
350 hexadecimal RGBvalue using the # sign, e.g. #ff0000 (Red).
351
354 -q image_quality
355 use the integer value image_quality for the JPEG "Quality" fac‐
356 tor. Valid values are 0-100, with the default being 75.
357
361 -d dmag
362 Set a separate magnification for the length of line dashes to
363 dmag.
364 -E num Set encoding for latex text translation (0 no translation, 1
367 ISO-8859-1, 2 ISO-8859-2)
368 -l lwidth
371 Sets the threshold between LaTeX thin and thick lines to lwidth
372 pixels. LaTeX supports only two different line width: \thin‐
373 lines and \thicklines. Lines of width greater than lwidth pix‐
374 els are drawn as \thicklines. Also affects the size of dots in
375 dotted line style. The default is 1.
376 -v Verbose mode.
378 LaTeX cannot accurately represent all the graphics objects which can be
380 described by Fig. For example, the possible slopes which lines may
381 have are limited. Some objects, such as spline curves, cannot be drawn
382 at all. Fig2latex chooses the closest possible line slope, and prints
383 error messages when objects cannot be drawn accurately
384
387 Xfig version 3.2.3 and later saves and allows the user to edit comments
388 for each Fig object. The fig2dev map output language will produce an
389 HTML image map using Fig objects that have href="some_html_reference"
390 in their comments. Any Fig object except compound objects may used for
391 this. Usually, besides generating the map file, you would also gener‐
392 ate a PNG file, which is the image to which the map refers.
393 For example, you may have an xfig drawing with an imported image that
395 has the comment href="go_here.html" and a box object with a comment
396 href="go_away.html". This will produce an image map file such the user
397 may click on the image and the browser will load the "go_here.html"
398 page, or click on the box and the browser will load the "go_away.html"
399 page.
400 After the map file is generated by fig2dev you will need to edit it to
402 fill out any additional information it may need.
403 -b borderwidth
405 Make blank border around figure of width borderwidth.
406
410 fig2dev scales the figure by 1/8 before generating METAFONT code. The
411 magnification can be further changed with the -m option or by giving
412 magnification options to mf.
413 In order to process the generated METAFONT code, the mfpic macros must
415 be installed where mf can find them. The mfpic macro package is avail‐
416 able at any CTAN cite under the subdirectory: graphics/mfpic
417 -C code
420 specifies the starting METAFONT font code. The default is 32.
421 -n name
423 specifies the name to use in the output file.
424 -p pen_magnification
426 specifies how much the line width should be magnified compared
427 to the original figure. The default is 1.
428 -t top specifies the top of the whole coordinate system. The default is
430 ypos.
431 -x xmin
433 specifies the minimum x coordinate value of the figure (inches).
434 The default is 0.
435 -y ymin
437 specifies the minumum y coordinate value of the figure (inches).
438 The default is 0.
439 -X xmax
441 specifies the maximum x coordinate value of the figure (inches).
442 The default is 8.
443 -Y ymax
445 specifies the maximum y coordinate value of the figure (inches).
446 The default is 8.
447
450 -i file
451 Include file content via \input-command.
452 -I file
455 Include file content as additional header.
456 -o Old mode (no latex).
459 -p number
462 Adds the line "prologues:=number" to the output.
463
467 -p ext Enables the use of certain PIC extensions which are known to
468 work with the groff package; compatibility with DWB PIC is
469 unknown. The extensions enabled by each option are:
470 arc Allow ARC_BOX i.e. use rounded corners
472 line Use the 'line_thickness' value
473 fill Allow ellipses to be filled
474 all Use all of the above
475 psfont Don't convert Postscript fonts generic type
476 (useful for files going to be Ditroff'ed for
477 and printed on PS printer). DWB-compatible.
478 allps Use all of the above (i.e. "all" + "psfont")
479
482 In order to include PiCTeX pictures into a document, it is necessary to
483 load the PiCTeX macros.
484 PiCTeX uses TeX integer register arithmetic to generate curves, and so
486 it is very slow. PiCTeX draws curves by \put-ing the psymbol repeat‐
487 edly, and so requires a large amount of TeX's internal memory, and gen‐
488 erates large DVI files. The size of TeX's memory limits the number of
489 plot symbols in a picture. As a result, it is best to use PiCTeX to
490 generate small pictures.
491 -E num Set encoding for latex text translation (0 no translation, 1
494 ISO-8859-1, 2 ISO-8859-2)
495
498 Typically you will wish to set the y scale to -1. See -g for more
499 information.
500 -d [mm|in]
502 Output dimensions should be assumed to be millimeters (mm) or
503 inches (in). The default is millimeters.
504 -p [pos|neg]
506 Select the image polarity. For positive images lines drawn in
507 the fig file will generate lines of material. For negative
508 images lines drawn in the fig file will result in removed mate‐
509 rial. Consider etching a chrome on glass transmission mask.
510 Drawing lines in the fig file and choosing 'neg' will result in
511 these lines being etched through the chrome, leaving transparent
512 lines.
513 -g <x scale>x<y scale>+<x offset>+<y offset>
515 This controls the geometry of the output, scaling the dimensions
516 as shown and applying the given offset. Typically you will wish
517 to set the y scale to -1, mirroring about the x axis. This is
518 because Gerber assumes the origin to be bottom left, while xfig
519 selects top left.
520 -f <n digits>.<n digits>
522 This controls the number of digits of precision before and after
523 the implied decimal point. With -f 5.3 the following number
524 12345678 corresponds to 12345.678. Whereas with -f 3.5 it cor‐
525 responds to 123.45678. The default is for 3 places before the
526 decimal point and 5 after. This corresponds, to a range of 0 to
527 1m in 10 micron increments.
528 -i [on|off]
530 Controls the output of comments describing the type of objects
531 being output. The text appears as comments starting with ## on
532 each line in the output file. By default this is on.
533
536 With PostScript, xfig can be used to create multiple page figures Spec‐
537 ify the -M option to produce a multi-page output. For posters, add -O
538 to overlap the pages slightly to get around the problem of the unprint‐
539 able area in most printers, then cut and paste the pages together. Due
540 to memory limitations of most laser printers, the figure should not
541 have large imported images (bitmaps). Great for text with very big let‐
542 ters.
543 The EPS driver has the following differences from PostScript:
545 o No showpage is generated because the output is meant to be
546 imported into another program or document and not printed
547 o The landscape/portrait options are ignored
548 o The centering option is ignored
549 o The multiple-page option is ignored
550 o The paper size option is ignored
551 o The x/y offset options are ignored
552 The EPS driver has the following two special options:
554 -B 'Wx [Wy X0 Y0]'
556 This specifies that the bounding box of the EPS file should have
557 the width Wx and the height Wy. Note that it doesn't scale the
558 figure to this size, it merely sets the bounding box. If a
559 value less than or equal to 0 is specified for Wx or Wy, these
560 are set to the width/height respectively of the figure. Origin
561 is relative to screen (0,0) (upper-left). Wx, Wy, X0 and Y0 are
562 interpreted in centimeters or inches depending on the measure
563 given in the fig-file. Remember to put either quotes (") or
564 apostrophes (') to group the arguments to -B.
565 -R 'Wx [Wy X0 Y0]'
567 Same as the -B option except that X0 and Y0 is relative to the
568 lower left corner of the figure. Remember to put either quotes
569 (") or apostrophes (') to group the arguments to -R.
570 The PDF driver uses all the PostScript options.
572 Text can now include various ISO-character codes above 0x7f, which is
574 useful for language specific characters to be printed directly. Not
575 all ISO-characters are implemented.
576 Color support: Colored objects created by Fig can be printed on a color
578 postscript printer. There are 32 standard colors: black, yellow, white,
579 gold, five shades of blue, four shades of green, four shades of cyan,
580 four shades of red, five shades of magenta, four shades of brown, and
581 four shades of pink. In addition there may be user-defined colors in
582 the file. See the xfig FORMAT3.2 file for the definition of these col‐
583 ors. On a monochrome printer, colored objects will be mapped into dif‐
584 ferent grayscales by the printer. Filled objects are printed using the
585 given area fill and color. There are 21 "shades" going from black to
586 full saturation of the fill color, and 21 more "tints" from full satu‐
587 ration + 1 to white. In addition, there are 16 patterns such as
588 bricks, diagonal lines, crosshatch, etc.
589 -A Add an ASCII (EPSI) preview.
591 -b borderwidth
593 Make blank border around figure of width borderwidth.
594 Not availble in EPS.
595 -C dummy_arg
598 Add a color *binary* TIFF preview for Microsoft products that
599 need a binary preview. See also -T (monochrome preview). A
600 dummy argument must be supplied for historical reasons.
601 -c option centers the figure on the page. The centering may not be
603 accurate if there are texts in the fig_file that extends too far
604 to the right of other objects.
605 -e option puts the figure against the edge (not centered) of the
607 page. Not availble in EPS.
608 -F Use correct font sizes (points) instead of the traditional size
611 that xfig/fig2dev uses, which is 1/80 inch. The corresponding
612 xfig command-line option is -correct_font_size.
613 -g color
616 Use color for the background.
617 -l dummy_arg
619 Generate figure in landscape mode. The dummy argument is
620 ignored, but must appear on the command line for reasons of com‐
621 patibility. This option will override the orientation specifi‐
622 cation in the file (for file versions 3.0 and higher).
623 Not availble in EPS.
624 -M Generate multiple pages if figure exceeds paper size.
626 Not availble in EPS.
627 -N Convert all colors to grayscale.
629 -n name
632 Set the Title part of the PostScript output to name. This is
633 useful when the input to fig2dev comes from standard input.
634 -O When used with -M, overlaps the pages slightly to get around the
636 problem of the unprintable area in most printers.
637 Not availble in EPS.
638 -p dummy_arg
640 Generate figure in portrait mode. The dummy argument is
641 ignored, but must appear on the command line for reasons of com‐
642 patibility. This option will override the orientation specifi‐
643 cation in the file (for file versions 3.0 and higher). This is
644 the default for Fig files of version 2.1 or lower.
645 Not availble in EPS.
646 -T Add a monochrome *binary* TIFF preview for Microsoft products
649 that need a binary preview. See also -C (color preview).
650 -x offset
653 shift the figure in the X direction by offset units (1/72
654 inch). A negative value shifts the figure to the left
655 and a positive value to the right.
656 Not availble in EPS.
657 -y offset
659 shift the figure in the Y direction by offset units (1/72
660 inch). A negative value shifts the figure up and a posi‐
661 tive value down.
662 Not availble in EPS.
663 -z papersize
665 Sets the papersize. Not availble in EPS.
666 Available paper sizes are:
667 "Letter" (8.5" x 11" also "A"),
668 "Legal" (11" x 14")
669 "Ledger" (11" x 17"),
670 "Tabloid" (17" x 11", really Ledger in Landscape mode),
671 "A" (8.5" x 11" also "Letter"),
672 "B" (11" x 17" also "Ledger"),
673 "C" (17" x 22"),
674 "D" (22" x 34"),
675 "E" (34" x 44"),
676 "A4" (21 cm x 29.7cm),
677 "A3" (29.7cm x 42 cm),
678 "A2" (42 cm x 59.4cm),
679 "A1" (59.4cm x 84.1cm),
680 "A0" (84.1cm x 118.9cm),
681 and "B5" (18.2cm x 25.7cm).
682
684 The pstex language is a variant of ps which suppresses formatted
685 (special) text. The pstex_t language has the complementary
686 behavior: it generates only the LaTeX special text and the com‐
687 mands necessary to position special text, and to overlay the
688 PostScript file generated using pstex. These two drivers can be
689 used to generate a figure which combines the flexibility of
690 PostScript graphics with LaTeX text formatting of special text.
691 -F Use correct font sizes (points) instead of the tradi‐
694 tional size that xfig/fig2dev uses, which is 1/80 inch.
695 The corresponding xfig command-line option is -cor‐
696 rect_font_size.
697 -g color
700 Use color for the background.
701 -n name
703 sets the Title part of the PostScript output to name.
704 This is useful when the input to fig2dev comes from stan‐
705 dard input.
706
708 The pstex_t language produces only the LaTeX special text and
709 the commands necessary to position special text, and to overlay
710 the PostScript file generated using pstex. (see above)
711 -E num Set encoding for latex text translation (0 no transla‐
714 tion, 1 ISO-8859-1, 2 ISO-8859-2)
715 -F Don't set the font face, series, and style; only set it's
718 size and the baselineskip. By default, fig2dev sets all 5
719 font parameters when it puts some text. The disadvantage
720 is that you can't set the font from your LaTeX document.
721 With this option on, you can set the font from your LaTeX
722 document (like "\sfshape \input picture.eepic").
723 -p file
725 specifies the name of the PostScript file to be overlaid.
726 If not set or its value is null then no PS file will be
727 inserted.
728
731 The PSTricks driver provides full LaTeX text and math formatting
732 for XFig drawings without overlaying separate outputs as in the
733 PSTEX methods. The output matches the quality of output of the
734 PostScript driver except for text, where the Latex font selec‐
735 tion mechanism is used as for other fig2dev LaTeX drivers. In
736 addition, text is rendered black, although font color-changing
737 LaTex code can be embedded in the drawing. The generated
738 PSTricks code is meant to be readable. Each command stands
739 alone, not relying on global option state variables. Thus the
740 user can easily use XFig to rough out a PSTricks drawing, then
741 finish by hand editing.
742 To use the driver's output, give the command "\usepack‐
744 age{pstricks}" in your document preamble. The graphicx and
745 pstricks-add packages may also be required. The former is used
746 for bitmap graphics and the second for complex line styles
747 and/or hollow PSTricks arrows (with the -R 1 option). The
748 driver will tell you which packages are needed. In the document
749 body, include the figure with "\input{pstfile}" where pst‐
750 file.tex is the output file. Use the XFig special flag to have
751 text passed as-is to LaTeX. For non-special text, the same
752 mechanism as the LaTeX and epic driver mechanism is used to
753 match font specs, but this is imprecise.
754 Known bugs and limitations.
757 PSTricks support for join styles is version dependent.
758 Raw postscript is inserted with "\pstVerb" for old ver‐
759 sions when other than angle joins are needed. The -t
760 option controls this behavior. PSTricks does not support
761 rotated ellipses directly, so a rput command is emitted
762 that rotates and locates a horizontal ellipse. This
763 makes a problem with hatch patterns, which are moved and
764 rotated along with the ellipse. Hatch rotation is fixed
765 by a counter-rotation, but the origin is not adjusted, so
766 registration with adjacent hatch patterns will be incor‐
767 rect. Flipped bitmap graphics use an undocumented fea‐
768 ture of the graphicx package: a negative height flips the
769 image vertically. This appears to work reliably. How‐
770 ever, you may want to flip graphics with another program
771 before including them in Xfig drawings just to be sure.
772 With the -p option, the driver attempts to convert non-
773 EPS pictures to EPS with the TeX distribution's bmeps
774 program, but bmeps does not know about very many file
775 formats including gif.
776 -G dummy_arg
779 Draws a standard PSTricks grid in light gray, ignoring
780 the size parameters, numbered in PSTricks units.
781 -l weight
784 Sets a line weight factor that is multiplied by the
785 actual Fig line width. The default value 0.5 roughly
786 matches the output of the PS driver.
787 -n 0|1|2|3
790 Sets environment type. Default 0 creates a \picture
791 environment with bounding box exactly enclosing the pic‐
792 ture (but see -x and -y ). A 1 emits bare PSTricks com‐
793 mands with no environment at all, which can be used with
794 \input{commands} inside an existing \pspicture. A 2
795 emits a complete LaTeX document. A 3 also emits a com‐
796 plete LaTeX document but attempts to set the PSTricks
797 unit to fit a 7.5 by 10 inch (portrait aspect) box.
798 -P Shorthand for -n 3
801 .
802 -p dir Attempts to run the bmeps program to translate picture
805 files to EPS, which is required by PSTricks. The trans‐
806 lated files go in dir , which must already exist (the
807 driver will not create it). Moreover, (BIG CAVEAT HERE)
808 the driver overwrites files with impunity in this direc‐
809 tory! Don't put your stuff here. The includegraphics
810 commands in the output file refer to this directory.
811 Even if the -p option is not used, includegrpahics com‐
812 mands follow this convention with the default directory
813 ./eps . In this case, the user must do the conversions
814 independently. The bmeps program is part of the standard
815 TeX distribution. It converts the following formats to
816 EPS: png jpg pnm tif. You can see the bmeps command with
817 the -v option.
818 -R 0|1|2
821 Sets arrow style. With the default style 0, Fig arrows
822 are converted to lines and polygons. With style 1, the
823 Fig arrowhead dimensions are converted to PSTricks arrow‐
824 head dimensions and PSTricks arrowhead options are emit‐
825 ted. Hollow arrows will require the additional package
826 pstricks-add
827 . With style 2, PSTricks arrowhead options are emitted
828 with no dimensions at all, and arrowhead size may be con‐
829 trolled globally with psset
830 .
831 -S scale
834 Scales the image according to the same convention as the
835 EPIC driver, i.e., to size scale
836 /12.
837 -t version
840 Provides the driver with PSTricks version number so out‐
841 put can match expected LaTeX input.
842 -v Print verbose warnings and extra comments in the output
845 file. Information provided includes font substitution
846 details, the bmeps commands used for picture conversion,
847 if any, and one comment per Fig object in the output.
848 -x marginsize
851 Adds marginsize on the left and right of the PStricks
852 bounding box. By default, the box exactly encloses the
853 image.
854 -y marginsize
857 Adds marginsize on the top and bottom of the PStricks
858 bounding box. By default, the box exactly encloses the
859 image.
860 -z 0|1|2
863 Sets font handling option. Default option 0 attempts to
864 honor Fig font names and sizes, finding the best match
865 with a standard LaTeX font. Option 1 sets LaTeX font
866 size only. Option 2 issues no font commands at all.
867
870 -l dummy_arg
871 Generate figure in landscape mode. The dummy argument is
872 ignored, but must appear on the command line for reasons
873 of compatibility. This option will override the orienta‐
874 tion specification in the file (for file versions 3.0 and
875 higher).
876 -p dummy_arg
878 Generate figure in portrait mode. The dummy argument is
879 ignored, but must appear on the command line for reasons
880 of compatibility. This option will override the orienta‐
881 tion specification in the file (for file versions 3.0 and
882 higher). This is the default for Fig files of version
883 2.1 or lower.
884 -P Generate canvas of full page size instead of using the
886 bounding box of the figure's objects. The default is to
887 use only the bounding box.
888 -z papersize
890 Sets the papersize. See the POSTSCRIPT OPTIONS for
891 available paper sizes. This is only used when the -P
892 option (use full page) is used.
893
896 [x]fig(1), pic(1) pic2fig(1), transfig(1)
897
899 Please send bug reports, fixes, new features etc. to:
900 xfig-bugs@epb1.lbl.gov (Brian V. Smith)
901 Arc-boxes are not supported for the tk output language, and only
903 X bitmap pictures are supported because of the canvas limitation
904 in tk.
905 Picture objects are not scaled with the magnification factor for
907 tk output.
908 Because tk scales canvas items according to the X display reso‐
910 lution, polygons, lines, etc. may be scaled differently than
911 imported pictures (bitmaps) which aren't scaled at all.
912 Rotated text is only supported in the IBM-GL (HP/GL) and Post‐
914 Script (including eps) languages.
915
917 Copyright (c) 1991 Micah Beck
918 Parts Copyright (c) 1985 Supoj Sutantavibul
919 Parts Copyright (c) 1989-1999 Brian V. Smith
920 Permission to use, copy, modify, distribute, and sell this soft‐
922 ware and its documentation for any purpose is hereby granted
923 without fee, provided that the above copyright notice appear in
924 all copies and that both that copyright notice and this permis‐
925 sion notice appear in supporting documentation. The authors make
926 no representations about the suitability of this software for
927 any purpose. It is provided "as is" without express or implied
928 warranty.
929 THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFT‐
931 WARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
932 FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPE‐
933 CIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSO‐
934 EVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
935 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
936 OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
937 SOFTWARE.
938
940 Micah Beck
941 Cornell University
942 Sept 28 1990
943 and Frank Schmuck (then of Cornell University)
945 and Conrad Kwok (then of U.C. Davis).
946 drivers contributed by
948 Jose Alberto Fernandez R. (U. of Maryland)
949 and Gary Beihl (MCC)
950 Color support, ISO-character encoding and poster support by
952 Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
953 Modified from f2p (fig to PIC), by the author of Fig
955 Supoj Sutanthavibul (supoj@sally.utexas.edu)
956 University of Texas at Austin.
957 MetaFont driver by
959 Anthony Starks (ajs@merck.com)
960 X-splines code by
962 Carole Blanc (blanc@labri.u-bordeaux.fr)
963 Christophe Schlick (schlick@labri.u-bordeaux.fr)
964 The initial implementation was done by C. Feuille, S. Grobois,
965 L. Maziere and L. Minihot as a student practice (Universite Bor‐
966 deaux, France).
967 Japanese text support for LaTeX output written by T. Sato
969 (VEF00200@niftyserve.or.jp)
970 The tk driver was written by
972 Mike Markowski (mm@udel.edu) with a little touch-up by Brian
973 Smith
974 The CGM driver (Computer Graphics Metafile) was written by
976 Philippe Bekaert (Philippe.Bekaert@cs.kuleuven.ac.be)
977 The EMF driver (Enhanced Metafile) was written by
979 Michael Schrick (m_schrick@hotmail.com)
980 The GBX (Gerber) driver was written by
982 Edward Grace (ej.grace@imperial.ac.uk).
983 Version 3.2.5 Feb 2007 FIG2DEV(1)