Debian Codegraph @

man/fig2dev.1.in

raw
1 '\" t -*- coding: LATIN-1 -*-
2 .\" @configure_input@
3 .TH fig2dev 1 "@RELEASE_DATE@" "Version @PACKAGE_VERSION@"
4 .SH NAME
5 fig2dev \- translates Fig code to various graphics languages
6
7 .SH SYNOPSIS
8 .\" create the new environment "nohyphenation", push it to the stack
9 .ev nohyphenation
10 .\" disable hyphenation within this environment
11 .nh
12 .HP \w'\fBfig2dev\fR\ 'u
13 .B fig2dev
14 .RB [ \-L
15 .IR language ]
16 .RB [ \-m
17 .IR mag ]
18 .RB [ \-s
19 .IR fsize ]
20 .RB [ \-Z
21 .I maxdimension
22 |
23 .IR <width> w
24 |
25 .IR <height> h
26 ]
27 .RB [ \-D
28 .I +/\-rangelist
29 .RB [ \-K ]]
30 .RI [ "other options" ]
31 .RI [ fig-file
32 .RI [ out-file ]]
33 .LP
34 .BR "fig2dev \-h" | \-V
35 .\" pop the last environment from the stack
36 .ev
37
38 .SH DESCRIPTION
39 .B fig2dev
40 translates fig code in the named
41 .I fig-file
42 into the specified graphics
43 .I language
44 and puts them in
45 .I out-file.
46 The graphics language is inferred from the suffix of
47 .I out-file,
48 or it must be given with the
49 .B \-L
50 option.
51 The default
52 .I fig-file
53 and
54 .I out-file
55 are standard input and standard output, respectively.
56 A minus (-) in place of
57 .I fig-file
58 or
59 .I out-file
60 also denotes either standard input or standard output.
61
62 .LP
63 Xfig (Facility for Interactive Generation of figures) is a screen-oriented
64 tool which runs under the X Window System, and
65 allows the user to draw and manipulate objects interactively.
66 This version of fig2dev is compatible with
67 xfig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and 3.2.
68 .LP
69 Xfig version 3.2.3 and later saves and allows the user to edit comments
70 for each Fig object. These comments are output with several of the output languages,
71 such as PostScript, CGM, EMF, LaTeX, MetaFont, PicTeX, (as % comments),
72 tk (as # comments), and pic (as .\\" comments).
73
74
75 .SH GENERAL OPTIONS (all drivers)
76
77 .TP
78 .B "\-L language"
79 Set the output graphics language.
80 Valid languages are
81 \fBbox, cgm, dxf, epic, eepic, eepicemu, emf, eps, gbx (Gerber beta
82 driver), gif, ibmgl, jpeg, latex, map (HTML image map), mf (MetaFont),
83 mp (MetaPost), pcx, pdf, pdftex, pdftex_t, pic,
84 pict2e, pictex, png, ppm, ps, pstex, pstex_t, pstricks, ptk (Perl/tk),
85 shape (LaTeX shaped paragraphs), sld (AutoCad slide format), svg,
86 textyl, tiff, tikz, tk (tcl/tk), tpic, xbm and xpm\fR.
87
88 Notes:
89 .br
90 You must have ghostscript installed to get the pdf output, and ghostscript and
91 one from the netpbm, the ImageMagick or the GraphicsMagick packages to get the
92 bitmap formats (png, jpeg, etc.).
93
94 .TP
95 .B \-h
96 Print help message with all options for all output languages then exit.
97
98 .TP
99 .B \-V
100 Print the program version number and exit.
101
102 .TP
103 .B "\-D +/\-rangelist"
104 With \fI+rangelist\fR, keep only those depths in the list.
105 With \fI\-rangelist\fR, keep all depths except those in the list.
106 The rangelist may be a list of comma-separated
107 numbers or ranges separated by colon (:). For example,
108 \fB\-D +10,40,55:70,80\fR
109 means keep only layers 10, 40, 55 through 70, and 80.
110
111 .TP
112 .B \-K
113 The selection of the depths with the \fB\-D\fI +/\-rangelist\fR
114 option does normally not affect the calculation of the bounding box.
115 Thus the generated document might have a much larger bounding box than
116 necessary. If
117 .B \-K
118 is given then the
119 bounding box is adjusted to include only those objects in the selected depths.
120
121 .TP
122 .B "\-E encoding"
123 Specify the character encoding of the input file.
124 Must be one of the strings listed by `iconv --list`, e.g., ISO-8859-1 or UTF-8.
125 Defaults to the encoding of the current locale.
126 It may be necessary to set this option if the input file was produced on
127 a different computer, or in a different language environment.
128
129 .TP
130 .B "\-G minor[:major][:unit]"
131 Draws a grid on the page.
132 Specify thin, or thin and thick line spacing in one of several units.
133 For example, \fB\-G\ .25:1cm\fR draws a thin,
134 gray line every .25 cm and a thicker gray line every 1 cm.
135 Specifying \fB\-G\ 1in\fR draws a thin line every 1 inch.
136 Fractions may be used, e.g. \fB\-G\ :1/2in\fR will draw a
137 thick line every 1/2 inch.
138 .br
139 Allowable units are: i, in, inch, f, ft, feet, c, cm, mm, and m.
140 .br
141 .B Only allowed for PostScript, EPS, PDF, pstricks, tikz and
142 .B bitmap (GIF, JPEG, etc) drivers.
143
144 .TP
145 .B "\-m mag"
146 Set the magnification at which the figure is rendered to
147 .I mag.
148 The default is 1.0.
149 This may not be used with the maxdimension option (\fB\-Z\fR).
150
151 .TP
152 .B "\-s fsize"
153 Set the default font size (in points, 1/72 inch) for text objects to
154 .I fsize.
155 The default is 11*mag, and thus is scaled by the \fB\-m\fR option.
156 If there is no scaling, the default font is eleven point Roman.
157
158 .TP
159 .B "\-Z maxdimension|<width>w|<height>h|<width>:|:<height>"
160 Scale the figure so that the maximum dimension (width or height) is
161 .I maxdimension
162 inches or cm, depending on whether the figure was saved with
163 imperial or metric units.
164 Scale the figure to the given width by appending a 'w' or a colon,
165 scale to the given height by appending a 'h' or prepending a colon.
166 This may not be used with the magnification option (\fB\-m\fR).
167
168 .TP
169 .I other options
170 The other options are specific to the choice of graphics
171 .I language,
172 as described below.
173
174
175 .SH OPTIONS COMMON TO ALL BITMAP FORMATS
176
177 .TP
178 .B \-b borderwidth
179 Make blank border around figure of width
180 .I borderwidth
181 (1/72 inch).
182
183 .TP
184 .B \-F
185 Use correct font sizes (points, 1/72 inch) instead of the traditional
186 size that xfig/fig2dev uses, which is 1/80 inch. The corresponding
187 xfig command-line option is \-correct_font_size.
188
189 .TP
190 .B \-g color
191 Use
192 .I color
193 for the background.
194
195 .TP
196 .B \-N
197 Convert all colors to grayscale.
198
199 .TP
200 .B \-S smoothfactor
201 This will smooth the output by passing
202 .I smoothfactor
203 to ghostscript in the
204 .I \-dTextAlphaBits
205 and
206 .I \-dGraphicsAlphaBits
207 options to improve font rendering and graphic smoothing.
208 A value of 2 for
209 .I smoothfactor
210 provides some smoothing and 4 provides more.
211
212
213 .SH GIF OPTIONS
214
215 .TP
216 .B \-t color
217 Use
218 .I color
219 for the transparent color in the GIF file. This must be specified
220 in the same format that ppmmake(1) allows.
221 It may allow an X11 color name, but at least you may use
222 a six-digit hexadecimal RGBvalue using the # sign, e.g. #ff0000 (Red).
223
224
225 .SH JPEG OPTIONS
226 .TP
227 .B \-q image_quality
228 use the integer value
229 .I image_quality
230 for the JPEG "Quality" factor.
231 Valid values are 0 - 100, with the default being 75.
232
233
234 .SH CGM OPTIONS
235 CGM is Computer Graphics Metafile, developed by ISO and ANSI and is a
236 vector-based plus bitmap language. Microsoft WORD, PowerPoint and probably
237 other products can import this format
238 .I and display it on the screen,
239 something that they won't do with EPS files that have an ASCII preview.
240
241 .TP
242 .B \-a
243 Generate binary output.
244
245 .TP
246 .B \-r
247 Position arrowheads for CGM viewers that display rounded arrowheads.
248 Normally, arrowheads are pointed, so fig2dev compensates for this by
249 moving the endpoint of the line back so the tip of the arrowhead ends
250 where the original endpoint of the line was.
251 If the \fB\-r\fR option is used, the position
252 of arrows will \fINOT\fR be corrected for compensating line width effects,
253 because the rounded arrowhead doesn't extend beyond the endpoint of the line.
254
255
256 .SH DXF OPTIONS
257 DXF is the Drawing Interchange File Format.
258 The output to DXF is experimental.
259
260 .TP
261 .B \-P
262 Rotate the figure to portrait mode. The default is landscape mode.
263
264
265 .SH EMF OPTIONS
266 EMF is Enhanced Metafile, developed by Microsoft and is a
267 vector-based plus bitmap language. Microsoft WORD, PowerPoint and probably
268 other products can import this format
269 .I and display it on the screen,
270 something that they won't do with EPS files that have an ASCII preview.
271
272 .TP
273 .B \-l lang
274 Set the compatibility level to \fIlang\fR, where \fIlang\fR is one of
275 .I win95, win98
276 or
277 .I winnt.
278 The default is \fIwinnt\fR.
279
280 .TP
281 .B \-r
282 Position arrowheads for EMF viewers that display rounded arrowheads.
283 See the discussion of the \fB\-r\fR option for the CGM output driver above.
284
285 .SH EPIC OPTIONS
286 EPIC is an enhancement to LaTeX picture drawing environment.
287 .LP
288 EEPIC is an extension to EPIC and LaTeX picture drawing environment
289 which uses tpic specials as a graphics mechanism.
290 It was written by Conrad Kwok of Division of
291 Computer Science at University of California, Davis.
292 Conrad Kwok has also written the EEPIC driver of fig2dev.
293 .LP
294 EEPIC-EMU is an EEPIC emulation package which does not use tpic specials.
295 .LP
296 When including EPIC/EEPIC output in a LaTeX file, use
297 "\fB\\usepackage{epic,eepic}\fR" in the preamble.
298
299 .TP
300 .B \-d factor
301 Scale arrowheads by
302 .I factor.
303 The width and height of arrowheads is
304 .I divided
305 by this factor.
306 This is because EPIC arrowheads are normally about double the size of
307 TeX arrowheads.
308
309 @nfssman@
310
311 .TP
312 .B "\-f font"
313 Set the default font used for text objects to \fIfont\fR,
314 where \fIfont\fR is one of
315 \fIrm\fR, \fIbf\fR, \fIit\fR, \fIsf\fR or \fItt\fR.
316 The default is \fIrm\fR.
317
318 .TP
319 .B "\-l lwidth"
320 Use "\fB\\thicklines\fR" when the width of the line is equal or wider than
321 .I lwidth.
322 The default is 2.
323
324 .TP
325 .B \-P
326 Generate a complete LaTeX file. In other words, the output file can be
327 formatted without requiring any changes.
328
329 .TP
330 .B \-R dummyarg
331 Allow rotated text. Rotated text will be set using the \\rotatebox command.
332 So, you will need to include "\fB\\usepackage{graphics}\fR" in the preamble
333 of your LaTeX document.
334 A dummy argument is required after the \fB\-R\fR.
335 .IP
336 If this option is not set, then rotated text will be set horizontally.
337
338 .TP
339 .B \-S scale
340 Set the scale to which the figure is rendered.
341 This option automatically sets the
342 .I magnification
343 and \fIfsize\fR to \fIscale\fR/12 and
344 .I scale
345 respectively.
346 .I Scale
347 must be between 8 and 12, inclusively.
348
349 .TP
350 .B \-t stretch
351 Set the stretch factor of dashed lines to
352 .I stretch.
353 The default is 30.
354
355 .TP
356 .B \-v
357 Include comments in the output file.
358
359 .TP
360 .B \-W
361 Enable variable line width. By default, only two line widths are
362 available: The normal line width ("\fB\\thinlines\fR"), and thick
363 lines ("\fB\\thicklines\fR"). See also the \fB\-l\fR option above.
364
365 .TP
366 .B \-w
367 Disable variable line width. Only "\fB\\thicklines\fR" and/or
368 "\fB\\thinlines\fR" commands will be generated in the output file.
369
370 When variable line width option is enabled, the "\fB\\thinlines\fR"
371 command is still used when the line width is less than
372 \fILineThick\fR. One potential problem is that the width of
373 "\fB\\thinlines\fR" is 0.4pt
374 but the resolution of Fig is 1/80 inch (approx. 1pt). If
375 \fILineThick\fR is set to 2, normal lines will be drawn in 0.4pt
376 wide lines but the next line width is already 2pt. One possible
377 solution is to set \fILineThick\fR to 1 and set the width of
378 those lines you want to be drawn in "\fB\\thinlines\fR" to 0.
379
380 Due to this problem, variable line width
381 is disabled by default (\fB\-w\fR).
382
383
384 .SH IBM-GL (HP/GL) OPTIONS
385 IBM-GL (IBM Graphics Language) is compatible
386 with HP-GL (Hewlett-Packard Graphics Language).
387
388 .TP
389 .B \-a
390 Select @ALTERNATE_PAPERSIZE@ paper size instead of the
391 default @DEFAULT_PAPERSIZE@.
392
393 .TP
394 .B \-c
395 Generate instructions for an IBM 6180 Color Plotter
396 @WITH_IBMGEC@ an IBM Graphics Enhancement Cartridge (IBM-GEC).
397
398 .TP
399 .B \-d xll,yll,xur,yur
400 Restrict plotting to a rectangular area of the plotter paper which has
401 a lower left hand corner at
402 .I (xll,yll)
403 and a upper right hand corner at
404 .I (xur,yur).
405 All four numbers are in inches and follow \fB\-d\fR in a comma-separated list -
406 .I xll,yll,xur,yur
407 - with no spaces between them.
408
409 .TP
410 .B \-f fontfile
411 Load text character specifications from the table in the
412 file \fIfontfile\fR.
413 The table must have 36 entries - one for each font plus a default.
414 Each entry consists of 5 numbers which specify the
415 .br
416 1.) standard character set (0 - 4, 6 - 9, 30 - 39),
417 .br
418 2.) alternate character set (0 - 4, 6 - 9, 30 - 39),
419 .br
420 3.) character slant angle (degrees),
421 .br
422 4.) character width scale factor and
423 .br
424 5.) character height scale factor.
425
426 .TP
427 .B \-k
428 Precede output with PCL command to use HP/GL.
429
430 .TP
431 .B \-l pattfile
432 Load area fill line patterns from the table in the
433 .I pattfile
434 file.
435 The table must have 21 entries - one for each of the area fill patterns.
436 Each entry consists of 5 numbers which specify the
437 .br
438 1.) pattern number (\-1 - 6),
439 .br
440 2.) pattern length (inches),
441 .br
442 3.) fill type (1 - 5),
443 .br
444 4.) fill spacing (inches) and
445 .br
446 5.) fill angle (degrees).
447
448 .TP
449 .B \-P
450 Rotate the figure to portrait mode. The default is landscape mode.
451
452 .TP
453 .B \-p penfile
454 Load plotter pen specifications from the table in the
455 .I penfile
456 file.
457 The table must have 9 entries - one for each color plus a default.
458 Each entry consists of 2 numbers which specify the
459 .br
460 1.) pen number (1 - 8) and
461 .br
462 2.) pen thickness (millimeters).
463
464 .TP
465 .B \-S speed
466 Set the pen speed to
467 .I speed
468 (centimeters/second).
469
470 .TP
471 .B \-v
472 Plot the figure upside-down in portrait mode or backwards in landscape mode.
473 This allows you to write on the top surface of overhead transparencies without
474 disturbing the plotter ink on the bottom surface.
475
476 .TP
477 .B \-x offset
478 Shift figure left by
479 .I offset
480 inches.
481
482 .TP
483 .B \-y offset
484 Shift figure up by
485 .I offset
486 inches.
487
488 .LP
489 Fig2dev may be installed with either ANSI A or ISO A4 default paper size.
490 The \fB\-a\fR option selects the alternate paper size.
491 Fig2dev does not fill closed splines.
492 The IBM-GEC is required to fill other polygons.
493 Fig2dev may be installed for plotters with or without the IBM-GEC.
494 The \fB\-c\fR option selects the alternate instruction set.
495
496
497 .SH LATEX OPTIONS
498 LaTeX cannot accurately represent all the graphics objects which can
499 be described by Fig.
500 For example, the possible slopes which lines may have are limited.
501 Some objects, such as spline curves, cannot be drawn at all.
502 Fig2latex chooses the closest possible line slope, and prints error
503 messages when objects cannot be drawn accurately.
504
505 .TP
506 .B \-b borderwidth
507 Make blank border around figure of width
508 .I borderwidth
509 (1/72 inch).
510
511 .TP
512 .B \-d dmag
513 Set a separate magnification for the length of line dashes to \fIdmag\fR.
514
515 @nfssman@
516
517 .TP
518 .B \-f font
519 Set the default font used for text objects to \fIfont\fR,
520 where \fIfont\fR is one of
521 \fIrm\fR, \fIbf\fR, \fIit\fR, \fIsf\fR or \fItt\fR.
522 The default is \fIrm\fR.
523
524 .TP
525 .B \-l lwidth
526 Sets the threshold between LaTeX thin and thick lines to
527 .I lwidth
528 pixels.
529 LaTeX supports only two different line widths: \\thinlines and \\thicklines.
530 Lines of width greater than
531 .I lwidth
532 pixels are drawn as \\thicklines.
533 Also affects the size of dots in dotted line style.
534 The default is 1.
535
536 .TP
537 .B \-v
538 Verbose mode. Include comments in the otput file.
539
540 .SH MAP (HTML image map) OPTIONS
541 Xfig version 3.2.3 and later saves and allows the user to edit comments
542 for each Fig object.
543 The fig2dev map output language will produce an HTML image map using Fig objects
544 that have href="some_html_reference" in their comments.
545 Any Fig object except compound objects may be used for this.
546 Usually, besides generating the map file, you would also
547 generate a PNG file, which is the image to which the map refers.
548 .sp
549 For example, you may have an xfig drawing with an
550 imported image that has the comment
551 href="go_here.html" and a box object with a comment href="go_away.html".
552 This will produce an image map file such the user
553 may click on the image and the browser will load the "go_here.html" page,
554 or click on the box and the browser will load the "go_away.html" page.
555 .sp
556 After the map file is generated by
557 .I fig2dev
558 you will need to edit it to fill out any additional information it may need.
559
560 .TP
561 .B \-b borderwidth
562 Make blank border around figure of width \fIborderwidth\fR (1/72 inch).
563
564
565 .SH METAFONT OPTIONS
566
567 .I Fig2dev
568 scales the figure by 1/8 before generating METAFONT code.
569 The magnification can be further changed with the
570 .B \-m
571 option or by giving magnification options to \fBmf\fR.
572 .LP
573 In order to process the generated METAFONT code, the mfpic macros
574 must be installed where
575 .B mf
576 can find them. The mfpic macro package is available at any CTAN cite
577 under the subdirectory: graphics/mfpic
578
579 .TP
580 .B \-C code
581 Specify the starting METAFONT font code. The default is 32.
582
583 .TP
584 .B \-n name
585 Specify the name to use in the output file.
586
587 .TP
588 .B \-p pen_magnification
589 Specify how much the line width should be magnified compared to the
590 original figure. The default is 1.
591
592 .TP
593 .B \-t top
594 Specify the top of the whole coordinate system.
595 The default is \fBypos\fR.
596
597 .TP
598 .B \-x xmin
599 Specify the minimum x coordinate value of the figure (inches). The
600 default is 0.
601
602 .TP
603 .B \-y ymin
604 Specify the minimum y coordinate value of the figure (inches). The
605 default is 0.
606
607 .TP
608 .B \-X xmax
609 Specify the maximum x coordinate value of the figure (inches). The
610 default is 8.
611
612 .TP
613 .B \-Y ymax
614 Specify the maximum y coordinate value of the figure (inches). The
615 default is 8.
616
617
618 .SH METAPOST OPTIONS
619
620 .TP
621 .B \-d file
622 Include file content as additional header.
623
624 .TP
625 .B \-i file
626 Include file content via \\input-command.
627
628 .TP
629 .B \-M
630 Multipage mode, generate one figure for each depth.
631
632 .TP
633 .B \-o
634 Old mode (no latex).
635
636 .TP
637 .B "\-p number"
638 Adds the line "prologues:=number" to the output.
639
640
641 .SH PIC OPTIONS
642
643 .TP
644 .B "\-f font"
645 Set the default font used for text objects to \fIfont\fR,
646 where \fIfont\fR is one of
647 \fIR\fR (roman), \fIB\fR (bold), \fII\fR (italic), \fIH\fR (sans serif)
648 or \fIC\fR (typewriter).
649 The default is \fIR\fR.
650
651 .TP
652 .B "\-p ext"
653 Enables the use of certain PIC extensions which are known to work with
654 the groff package; compatibility with DWB PIC is unknown.
655 The extensions enabled by each option are:
656 .LP
657 .nf
658 .in 1.1i
659 .ta .8i
660 \fBarc\fR Allow ARC_BOX i.e. use rounded corners
661 .br
662 \fBline\fR Use the 'line_thickness' value
663 .br
664 \fBfill\fR Allow ellipses to be filled
665 .br
666 \fBall\fR Use all of the above
667 .br
668 \fBpsfont\fR Don't convert PostScript fonts generic type
669 (useful for files going to be Ditroff'ed for
670 and printed on PS printer). DWB-compatible.
671 .br
672 \fBallps\fR Use all of the above (i.e. "all" + "psfont")
673 .in
674 .fi
675
676 .SH PICT2E OPTIONS
677 PICT2E is an enhancement to the LaTeX picture environment. It is enabled by
678 inserting "\fB\\usepackage{pict2e}\fR" in the document preamble. Depending on
679 the content of the figure, it may be necessary to also include
680 "\fB\\usepackage{color}\fR" and "\fB\\usepackage{graphics}\fR". Figures produced
681 with the PICT2E driver can be processed with any LaTeX engine, e.g., LaTeX +
682 dvips, LaTeX + dvipdfm, pdflatex, xelatex, ConTeX, etc.
683 Pattern fills are not supported by the PICT2E output language. The PICT2E driver
684 renders patterns by filling the respective area with the pen-color at 25%
685 intensity, i.e., a 75% tint of the pen-color.
686 The PICT2E driver allows one to choose any font available to the LaTeX engine,
687 including PostScript fonts.
688 TeX an PostScript fonts may appear together in the same document.
689
690 .TP
691 .B \-b borderwidth
692 Make blank border around figure of width \fIborderwidth\fR*(1/72) inches.
693
694 .TP
695 .B \-C num
696 Do not emit a \\color-command for the color number \fBnum\fR. (0 = black,
697 1 = blue, 2 = green - see the color chooser widget in Xfig).
698 By default, \fIfig2dev\fR does not issue a \\color-command
699 for objects which have the color set to "Default" in xfig.
700 With this option, the "\\color"-command is also omitted for objects having the
701 color \fBnum\fR.
702 The color of these objects, as well as of those having the color set to
703 "Default", is picked up from the including LaTeX-document.
704
705 The option \fB\-C\ 0\fR is particularly useful.
706 By default, xfig starts with the color set to black.
707 Then, \fIfig2dev\fR emits "\\color{black}" commands,
708 and the color-package must be included in the document preamble.
709 For black text and black-and-white drawings, this is superfluous.
710
711 .TP
712 .B \-e
713 Do not try to be compatible with epic/eepic.
714 By default, you can include "\fB\\usepackage{pict2e, epic, eepic}\fR"
715 (in this order!) in the document preamble and mix LaTeX pictures using
716 the epic/eepic command set and pictures produced with the PICT2E output
717 language within one document. With this option on, epic or eepic
718 pictures can not be mixed with PICT2E-pictures.
719
720 By default, \fIfig2dev\fR avoids the use of
721 the "\\circle" and "\\oval"-commands, which are defined by epic, in lieu of the
722 "\\circlearc"-command exclusive to pict2e. In addition, line widths are not only
723 set using "\\linethickness", but also with the eepic-command
724 "\\allinethickness" (if it is defined).
725
726 .TP
727 .B \-F
728 Do not set the font family, series or shape.
729 By default, \fIfig2dev\fR sets the font family, series, shape, font size and
730 baselineskip.
731 With this option on, the text font can be set from the including
732 LaTeX-document, e.g.,
733 "\fB\\itshape \\input{fig1.pict2e}\fR".
734 See also \fB\-o\fR (no font size).
735
736 .TP
737 .B "\-f font"
738 Set the default font used for text objects to \fIfont\fR.
739 The string \fIfont\fR may be one of
740 \fIrm\fR, \fIbf, \fIit\fR, \fIsf\fR, \fItt\fR,
741 \fI\\rmfamily\fR, \fI\\bfseries\fR, \fI\\itshape\fR, \fI\\sffamily\fR,
742 \fI\\ttfamily\fR,
743 or one of the 35 standard PostScript font names.
744 The default is \fI\\rmfamily\fR.
745
746 .TP
747 .B \-i dir
748 Prepend the string \fIdir\fR to graphics files included in the pict2e-picture.
749 For instance, having imported "image.jpg" in xfig, with
750 \fB\-i '$HOME/Figures/'\fR the code "\\incudegraphics{$HOME/Figures/image.jpg}"
751 will be generated.
752
753 .TP
754 .B \-o
755 Do not set the font size or baselineskip. Text will be rendered at the size that
756 is in force where the pict2e-code is inserted into the LaTeX-document, e.g.,
757 "\fB\\small \\input{fig1.pict2e}\fR".
758 See also \fB\-F\fR (no font properties).
759
760 .TP
761 .B \-O
762 Do not quote characters special to TeX/LaTeX.
763 Useful to get, e.g., an italic \fIx\fR, not $x$,
764 if it was forgotten to set the text flag "TeX" in xfig.
765 This option effectively sets the "TeX" flag for all text.
766
767 .TP
768 .B \-P
769 Pagemode, generate a stand-alone LaTeX-file as \fIout-file\fR. The document
770 produced from the
771 LaTeX-file will have the paper size equal to the figure's
772 bounding box (but see the \fB\-b\fR option to add a margin).
773 The generated LaTeX-file calls the package "geometry.sty" to set the paper size.
774
775 .TP
776 .B \-R num
777 Replace arrowheads \fInum\fR by LaTeX-arrows ("\\vector"). The number of
778 an arrowhead ("Arrow Type" in xfig) can be found by opening the arrow chooser
779 widget in xfig and counting the arrows, starting from 1.
780 For instance, to replace filled triangle arrowheads with LaTeX
781 \\vector-commands, use \fB\-R\ 3\fR.
782
783 .TP
784 .B \-r
785 Replace all arrows by LaTeX-arrows.
786
787 .TP
788 .B \-T
789 Only use TeX fonts, even where PostScript-fonts are specified.
790
791 .TP
792 .B \-v
793 Verbose mode. Write comment lines into the output file, usually naming the
794 type of the object that is drawn.
795
796 .TP
797 .B \-w
798 Remove the suffix from included graphics-files.
799 With this option on, \fIfig2dev\fR generates code that contains, e.g.,
800 "\fB\\includegraphics{fig1}\fR",
801 instead of "\fB\\includegraphics{fig1.eps}\fR".
802
803
804 .SH PICTEX OPTIONS
805 In order to include PiCTeX pictures into a document, it is necessary to
806 load the PiCTeX macros.
807 .LP
808 PiCTeX uses TeX integer register arithmetic to generate curves,
809 and so it is very slow.
810 PiCTeX draws curves by \fB\\put\fR-ing the \fIpsymbol\fR repeatedly,
811 and so requires a large amount of TeX's internal memory,
812 and generates large DVI files.
813 The size of TeX's memory limits the number of plot symbols in a picture.
814 As a result, it is best to use PiCTeX to generate small pictures.
815
816 .TP
817 .B \-f font
818 Set the default font used for text objects to \fIfont\fR,
819 where \fIfont\fR is one of
820 \fIrm\fR, \fIbf\fR, \fIit\fR, \fIsf\fR or \fItt\fR.
821 The default is \fIrm\fR.
822
823 .TP
824 .B \-l dimen
825 Set line thickness to \fIdimen\fR. Default "1pt".
826
827 .TP
828 .B \-p psymbol
829 Set the \fIpsymbol\fR.
830 Default "\\makebox(0,0)[l]{\\tencirc\\symbol{'160}}".
831
832 .TP
833 .B \-r
834 Do not allow rotated text. Otherwise, files with PiCTeX macros and
835 rotated text need to be processed with \fIdvips\fR.
836
837 .SH GBX OPTIONS (Gerber, RS-247-X)
838 Typically you will wish to set the y scale to \-1. See
839 .B \-g
840 for more information.
841
842 .TP
843 .B \-d [mm|in]
844 Output dimensions should be assumed to be millimeters (mm) or inches
845 (in). The default is millimeters.
846
847 .TP
848 .B \-p [pos|neg]
849 Select the image polarity. For positive images lines drawn in the fig
850 file will generate lines of material. For negative images lines drawn
851 in the fig file will result in removed material. Consider etching a
852 chrome on glass transmission mask. Drawing lines in the fig file and
853 choosing 'neg' will result in these lines being etched through the
854 chrome, leaving transparent lines.
855
856 .TP
857 .B \-g <x scale>x<y scale>+<x offset>+<y offset>
858 This controls the geometry of the output, scaling the dimensions as
859 shown and applying the given offset. Typically you will wish to set
860 the y scale to \-1, mirroring about the x axis. This is because Gerber
861 assumes the origin to be bottom left, while xfig selects top left.
862
863 .TP
864 .B \-f <n digits>.<n digits>
865 This controls the number of digits of precision before and after the
866 implied decimal point. With \fB\-f\ 5.3\fR the following number 12345678
867 corresponds to 12345.678.
868 Whereas with \fB\-f\ 3.5\fR it corresponds to 123.45678.
869 The default is for 3 places before the decimal point and 5 after.
870 This corresponds, to a range of 0 to 1m in 10 micron increments.
871
872 .TP
873 .B \-v
874 Output comments describing the type of objects being output.
875 The text appears as comments starting with ## on each line in the output file.
876
877
878 .SH POSTSCRIPT, ENCAPSULATED POSTSCRIPT (EPS), and PDF OPTIONS
879 With PostScript, xfig can be used to create multiple page figures.
880 Specify the \fB\-M\fR option to produce a multi-page output.
881 For posters, add \fB\-O\fR to overlap the pages slightly to get around the
882 problem of the unprintable area in most printers, then cut and paste the pages
883 together.
884 Great for text with very big letters.
885 .LP
886 The EPS driver has the following differences from PostScript:
887 .br
888 .in +.4i
889 o No showpage is generated because the output is meant to be imported
890 into another program or document and not printed
891 .br
892 o The landscape/portrait options are ignored
893 .br
894 o The centering option is ignored
895 .br
896 o The multiple-page option is ignored
897 .br
898 o The paper size option is ignored
899 .br
900 o The x/y offset options are ignored
901 .LP
902 The EPS driver has the following two special options:
903
904 .TP
905 .B \-B 'Wx [Wy X0 Y0]'
906 This specifies that the bounding box of the EPS file should have the
907 width \fIWx\fR and the height \fIWy\fR.
908 Note that it doesn't scale the figure to this size,
909 it merely sets the bounding box.
910 If a value less than or equal to 0 is specified for \fIWx\fR or \fIWy\fR,
911 these are set to the width/height respectively of the figure.
912 Origin is relative to screen (0,0) (upper-left).
913 \fIWx\fR, \fIWy\fR, \fIX0\fR and \fIY0\fR are interpreted in centimeters or
914 inches depending on the measure given in the fig-file.
915 Remember to put either quotes (") or apostrophes (') to group the arguments to
916 \fB\-B\fR.
917
918 .TP
919 .B \-R 'Wx [Wy X0 Y0]'
920 Same as the \fB\-B\fR option except that \fIX0\fR and \fIY0\fR
921 is relative to the lower left corner of the
922 .B figure.
923 Remember to put either quotes (") or apostrophes (') to group the arguments to
924 \fB\-R\fR.
925
926 .LP
927 The PDF driver accepts all of the PostScript options, if the
928 .B \-P
929 (pagemode) option is given.
930 In this case, the size of the PDF is the pagesize given
931 in the file or set from the command line via the
932 .B \-z
933 option.
934 Otherwise, if
935 .B \-P
936 is not given, the PDF is cropped to the bounding box of the figure
937 (optionally with a blank border margin set by the \fB\-b\fR option),
938 and all of the EPS options are supported.
939
940 .LP
941 Text can now include various ISO-character codes above 0x7f, which is
942 useful for language specific characters to be printed directly.
943 Not all ISO-characters are implemented.
944 .LP
945 Color support: Colored objects created by Fig can be printed
946 on a color postscript printer. There are 32 standard colors:
947 black, yellow, white, gold,
948 five shades of blue, four shades of green,
949 four shades of cyan, four shades of red, five shades of magenta,
950 four shades of brown, and four shades of pink.
951 In addition there may be user-defined colors in the file. See the
952 xfig FORMAT3.2 file for the definition of these colors.
953 On a monochrome printer, colored objects will be mapped into different
954 grayscales by the printer.
955 Filled objects are printed using the given area fill and color.
956 There are 21 "shades" going from black to full saturation of the fill color,
957 and 21 more "tints" from full saturation + 1 to white.
958 In addition, there are 16 patterns such as bricks, diagonal lines,
959 crosshatch, etc.
960
961 .TP
962 .B \-A
963 Add an ASCII (EPSI) preview.
964 Not for PDF.
965
966 .TP
967 .B \-b borderwidth
968 Make blank border around figure of width
969 .I borderwidth
970 (1/72 inch).
971
972 .TP
973 .B \-C dummy_arg
974 Add a color *binary* TIFF preview for Microsoft products that need a binary
975 preview.
976 See also \-T (monochrome preview).
977 A dummy argument must be supplied for historical reasons.
978 Not for PDF output.
979
980 .TP
981 .B \-c
982 Center the figure on the page.
983 The centering may not be accurate if there are texts in the
984 .I fig_file
985 that extends too far to the right of other objects.
986
987 .TP
988 .B \-e
989 Put the figure against the edge (not centered) of the page.
990 Not available in EPS.
991
992 .TP
993 .B \-F
994 Use correct font sizes (points, 1/72 inch) instead of the traditional size that
995 xfig/fig2dev uses, which is 1/80 inch.
996 The corresponding xfig command-line option is \-correct_font_size.
997
998 .TP
999 .B "\-f font"
1000 Set the default font used for text objects to \fIfont\fR,
1001 where \fIfont\fR is one of the 35 standard PostScript font names.
1002 The default is \fITimes-Roman\fR.
1003
1004 .TP
1005 .B \-g color
1006 Use
1007 .I color
1008 for the background.
1009
1010 .TP
1011 .B \-j
1012 Enable composite fonts for text objects containing japanese or korean texts.
1013 With this option on and if your environment variable LC_CTYPE is set to one of
1014 ja_JP.eucJP, ja_JP.EUC, ja_JP, ja_JP.ujis, ja, japanese, ko_KR.eucKR, ko_KR.EUC,
1015 ko_KR, ko, or korean, fig2dev will insert a postscript preamble taken from
1016 the fig2dev/i18n directory into the output file.
1017 Japanese characters written with the Times-Roman font will then be taken from
1018 the fonts Ryumin-Light-EUC-H or HeiseiMin-W3-EUC-H, japanese characters written
1019 with Times-Bold will be taken from GothicBBB-Medium-EUC-H.
1020 For the korean locales, korean characters appearing in text objects for which
1021 Times-Roman is selected will be taken from Munhwa-Regular-KSC-EUC-H or
1022 HLaTeX-Myoungjo-Regular-KSC-EUC-H. Korean characters in Times-Bold text will be
1023 taken from MunhwaGothic-Bold-KSC-EUC-H or HLaTeX-Gothic-Regular-KSC-EUC-H.
1024 Ghostscript must be able to find these fonts.
1025
1026 .TP
1027 .B \-l dummy_arg
1028 Generate figure in landscape mode. The dummy argument is ignored,
1029 but must appear on the command line for reasons of compatibility.
1030 This option will override the orientation specification in the
1031 file (for file versions 3.0 and higher).
1032 Not available in EPS.
1033
1034 .TP
1035 .B \-M
1036 Generate multiple pages if figure exceeds paper size.
1037 Not available in EPS.
1038
1039 .TP
1040 .B \-N
1041 Convert all colors to grayscale.
1042
1043 .TP
1044 .B \-n name
1045 Set the Title part of the PostScript output to
1046 .I name.
1047 This is useful when the input to
1048 .I fig2dev
1049 comes from standard input.
1050
1051 .TP
1052 .B \-O
1053 When used with \fB\-M\fR,
1054 overlaps the pages slightly to get around the problem of
1055 the unprintable area in most printers.
1056 Not available in EPS.
1057
1058 .TP
1059 .B \-p dummy_arg
1060 Generate figure in portrait mode. The dummy argument is ignored,
1061 but must appear on the command line for reasons of compatibility.
1062 This option will override the orientation specification in the
1063 file (for file versions 3.0 and higher).
1064 This is the default for Fig files of version 2.1 or lower.
1065 Not available in EPS.
1066
1067 .TP
1068 .B \-T
1069 Add a monochrome *binary* TIFF preview for Microsoft products that need a binary preview.
1070 See also \fB\-C\fR (color preview).
1071 Not available for PDF output.
1072
1073 .TP
1074 .B \-x offset
1075 Shift the figure in the X direction by \fIoffset\fR
1076 PostScript points (1/72 inch).
1077 A negative value shifts the figure to the left and
1078 a positive value to the right.
1079 Not available in EPS.
1080
1081 .TP
1082 .B \-y offset
1083 Shift the figure in the Y direction by \fIoffset\fR
1084 points (1/72 inch).
1085 A negative value shifts the figure up and a positive value down.
1086 Not available in EPS.
1087
1088 .TP
1089 .B \-z papersize
1090 Set the papersize.
1091 Not available in EPS.
1092 .br
1093 Available paper sizes are:
1094 .br
1095 .in +.4i
1096 .TS
1097 ll.
1098 \fILetter\fR (8.5" x 11" also \fIA\fR),
1099 \fILegal\fR ( 11" x 14")
1100 \fILedger\fR ( 11" x 17"),
1101 \fITabloid\fR ( 17" x 11", really \fILedger\fR in Landscape mode),
1102 \fIA\fR (8.5" x 11" also \fILetter\fR),
1103 \fIB\fR ( 11" x 17" also \fILedger\fR),
1104 \fIC\fR ( 17" x 22"),
1105 \fID\fR ( 22" x 34"),
1106 \fIE\fR ( 34" x 44"),
1107 \fIA9\fR ( 37 mm x 52 mm),
1108 \fIA8\fR ( 52 mm x 74 mm),
1109 \fIA7\fR ( 74 mm x 105 mm),
1110 \fIA6\fR (105 mm x 148 mm),
1111 \fIA5\fR (148 mm x 210 mm),
1112 \fIA4\fR (210 mm x 297 mm),
1113 \fIA3\fR (297 mm x 420 mm),
1114 \fIA2\fR (420 mm x 594 mm),
1115 \fIA1\fR (594 mm x 841 mm),
1116 \fIA0\fR (841 mm x1189 mm),
1117 \fIB10\fR ( 32 mm x 45 mm),
1118 \fIB9\fR ( 45 mm x 64 mm),
1119 \fIB8\fR ( 64 mm x 91 mm),
1120 \fIB7\fR ( 91 mm x 128 mm),
1121 \fIB6\fR (128 mm x 182 mm),
1122 \fIB5\fR (182 mm x 257 mm),
1123 \fIB4\fR (257 mm x 364 mm),
1124 \fIB3\fR (364 mm x 515 mm),
1125 \fIB2\fR (515 mm x 728 mm),
1126 \fIB1\fR (728 mm x1030 mm),
1127 \fIB0\fR (1030mm x1456 mm).
1128 .TE
1129 .in -.4i
1130 .br
1131
1132 .SH PSTEX and PDFTEX OPTIONS
1133 The
1134 .B pstex
1135 and
1136 .B pdftex
1137 languages are a variant of
1138 .B ps
1139 which suppress text that has the text flag "TeX Text" set.
1140 The
1141 .B pstex_t
1142 and
1143 .B pdftex_t
1144 languages have the complementary behavior: they generate only the
1145 text that has the "Tex Text" flag set and the commands
1146 necessary to position this text. They also generate the commands necessary
1147 to overlay the PostScript or PDF file generated using \fBpstex\fR/\fBpdftex\fR.
1148 These two drivers can be used to generate a figure which combines the
1149 flexibility of PostScript graphics with LaTeX text formatting of
1150 text flagged as "TeX Text".
1151 .LP
1152 The pstex and pdftex drivers accept the same options that the EPS driver
1153 accepts.
1154
1155 .TP
1156 .B \-n name
1157 Set the Title part of the PostScript output to
1158 .I name.
1159 This is useful when the input to
1160 .I fig2dev
1161 comes from standard input.
1162
1163 .SH PSTEX_T and PDFTEX_T OPTIONS
1164 The \fBpstex_t\fR and \fBpdftex_t\fR languages produce only the text flagged
1165 with the "TeX Text" flag, the commands necessary to position this text, and the
1166 commands necessary to overlay the PostScript or PDF file generated using
1167 .B pstex
1168 or
1169 .B pdftex
1170 (see above).
1171
1172 .TP
1173 .B \-F
1174 Don't set the font face, series, and style; only set it's size and the
1175 baselineskip. By default, fig2dev sets all 5 font parameters when it
1176 puts some text. The disadvantage is that you can't set the font from your
1177 LaTeX document. With this option on, you can set the font from your LaTeX
1178 document (like "\fB\\sfshape \\input picture.eepic\fR").
1179
1180 .TP
1181 .B \-p file
1182 specifies the name of the PostScript file to be overlaid.
1183 If not set or its value is null then no PS file will be inserted.
1184
1185
1186 .SH PSTricks OPTIONS
1187 The
1188 .B PSTricks
1189 driver provides full
1190 .B LaTeX
1191 text and math formatting for XFig drawings without overlaying
1192 separate outputs as in the
1193 .B PSTEX
1194 methods. The output matches the quality of output of the PostScript
1195 driver except for text, where the
1196 .B Latex
1197 font selection mechanism is used as for other
1198 .I fig2dev
1199 LaTeX drivers. In addition, text is rendered black, although font color-changing
1200 .B LaTex
1201 code can be embedded in the drawing.
1202 The generated PSTricks code is meant to be
1203 readable. Each command stands alone, not relying on
1204 global option state variables. Thus the user can easily use
1205 XFig to rough out a PSTricks drawing, then finish by hand editing.
1206 .PP
1207 To use the driver's output, give the command
1208 "\fB\\usepackage{pstricks}\fR"
1209 in your document preamble. The
1210 .B graphicx
1211 and
1212 .B pstricks-add
1213 packages may also be required. The former is used for bitmap graphics
1214 and the second for complex line styles and/or hollow PSTricks arrows
1215 (with the \-R 1 option). The driver will tell
1216 you which packages are needed. In the document body, include the
1217 figure with "\fB\\input{pstfile}\fR" where
1218 .B pstfile.tex
1219 is the output file. Use the
1220 .B XFig TeX text
1221 flag to have text passed as-is to LaTeX. For non-TeX text,
1222 the same mechanism as the LaTeX and epic driver mechanism is used
1223 to match font specs, but this is imprecise.
1224
1225 .TP
1226 .B Known bugs and limitations.
1227 PSTricks support for join styles is version dependent. Raw postscript
1228 is inserted with "\fB\\pstVerb\fR" for old versions when other than
1229 angle joins are needed. The
1230 .B \-t
1231 option controls this behavior. PSTricks does not support rotated
1232 ellipses directly, so a
1233 .B rput
1234 command is emitted that rotates and locates a horizontal ellipse.
1235 This makes a problem with hatch patterns, which are moved and
1236 rotated along with the ellipse. Hatch rotation is fixed by a
1237 counter-rotation, but the origin is not adjusted, so
1238 registration with adjacent hatch patterns will be incorrect. Flipped
1239 bitmap graphics use an undocumented feature of the
1240 .B graphicx
1241 package: a negative height flips the image vertically. This
1242 appears to work reliably. However, you may want to flip graphics
1243 with another program before including them in
1244 .B Xfig
1245 drawings just to be sure. With the
1246 .B \-p
1247 option, the driver attempts to convert non-EPS pictures to EPS
1248 with the TeX distribution's
1249 .B bmeps
1250 program, but
1251 .B bmeps
1252 does not know about very many file formats including \fBgif\fR.
1253
1254 .TP
1255 .B "\-f font"
1256 Set the default font used for text objects to \fIfont\fR,
1257 where \fIfont\fR is one of
1258 \fIrm\fR, \fIbf\fR, \fIit\fR, \fIsf\fR or \fItt\fR.
1259 The default is \fIrm\fR.
1260
1261 .TP
1262 .B \-G dummy_arg
1263 Draws a standard PSTricks grid in light gray, ignoring the size
1264 parameters, numbered in PSTricks units.
1265
1266 .TP
1267 .B \-l weight
1268 Sets a line weight factor that is multiplied by the actual Fig line
1269 width. The default value 0.5 roughly matches the output of the PS
1270 driver.
1271
1272 .TP
1273 .B \-n 0|1|2|3
1274 Sets environment type. Default 0 creates a \fB\\picture\fR
1275 environment with bounding box exactly enclosing the picture (but see
1276 .B \-x
1277 and
1278 .B \-y
1279 ). A 1 emits bare PSTricks commands with no environment
1280 at all, which can be used with
1281 \fB\\input{commands}\fR inside an existing \fB\\pspicture\fR.
1282 A 2 emits a complete LaTeX document. A 3 also emits a complete
1283 LaTeX document but attempts to set the PSTricks unit to fit
1284 a 7.5 by 10 inch (portrait aspect) box.
1285
1286 .TP
1287 .B \-P
1288 Shorthand for \fB\-n 3\fR.
1289
1290 .TP
1291 .B \-p dir
1292 Attempts to run the
1293 .B bmeps
1294 program to translate picture files to EPS, which is required by
1295 PSTricks. The translated files go in
1296 .I dir
1297 , which must already exist (the driver will not create it). Moreover,
1298 (BIG CAVEAT HERE) the driver overwrites files with impunity in this
1299 directory! Don't put your stuff here. The
1300 .B includegraphics
1301 commands in the output file refer to this directory. Even
1302 if the \-p option is not used,
1303 .B includegraphics
1304 commands follow this convention with the default directory
1305 .I "\./eps".
1306 In this case, the user must do
1307 the conversions independently. The
1308 .B bmeps
1309 program is part of the standard TeX distribution. It converts
1310 the following formats to EPS:
1311 .B png jpg pnm tif.
1312 You can see the bmeps command with the
1313 .B \-v
1314 option.
1315
1316 .TP
1317 .B \-R 0|1|2
1318 Sets arrow style. With the default style 0, Fig arrows are converted
1319 to lines and polygons. With style 1, the Fig arrowhead dimensions are
1320 converted to PSTricks arrowhead dimensions and PSTricks arrowhead
1321 options are emitted. Hollow arrows will require the additional
1322 package \fBpstricks-add\fR.
1323 With style 2, PSTricks arrowhead options are emitted with no
1324 dimensions at all, and arrowhead size may be controlled globally with
1325 \fBpsset\fR.
1326
1327 .TP
1328 .B \-S scale
1329 Scales the image according to the same convention as the EPIC driver,
1330 i.e., to size \fIscale\fR/12.
1331
1332 .TP
1333 .B \-t version
1334 Provides the driver with PSTricks version number so
1335 output can match expected LaTeX input.
1336
1337 .TP
1338 .B \-v
1339 Print verbose warnings and extra comments in the output file.
1340 Information provided includes font substitution details, the
1341 .B bmeps
1342 commands used for picture conversion, if any, and one comment per Fig
1343 object in the output.
1344
1345 .TP
1346 .B \-x marginsize
1347 Adds
1348 .I marginsize
1349 on the left and right of the
1350 .B PStricks
1351 bounding box. By default, the box exactly encloses the image.
1352
1353 .TP
1354 .B \-y marginsize
1355 Adds
1356 .I marginsize
1357 on the top and bottom of the
1358 .B PStricks
1359 bounding box. By default, the box exactly encloses the image.
1360
1361
1362 .TP
1363 .B \-z 0|1|2
1364 Sets font handling option. Default option 0 attempts to honor Fig
1365 font names and sizes, finding the best match with a standard LaTeX
1366 font. Option 1 sets LaTeX font size only. Option 2 issues no font
1367 commands at all.
1368
1369
1370 .SH TEXTYL OPTIONS
1371
1372 .TP
1373 .B "\-f font"
1374 Set the default font used for text objects to \fIfont\fR,
1375 where \fIfont\fR is one of
1376 \fIrm\fR, \fIbf\fR, \fIit\fR, \fIsf\fR or \fItt\fR.
1377 The default is \fIrm\fR.
1378
1379 .TP
1380 .B "\-l lwidth"
1381 Set the line thickness. \fIlwidth\fR must be a value between 1 and 12.
1382
1383 .SH TIKZ OPTIONS
1384 TIKZ is a powerful frontend to the Portable Graphics Format (PGF) for TeX/LaTeX.
1385 To use figures created by the TIKZ driver in a LaTeX document, use
1386 "\fB\\usepackage{tikz}\fR" and, depending on the contents of your figure,
1387 "\fB\\usetikzlibrary{arrows.meta, bending}\fR" and
1388 "\fB\\usetikzlibrary{patterns}\fR" in the document preamble.
1389 Simply \\input or copy the output file into the TeX-document.
1390 TIKZ files produced by \fIfig2dev\fR may be included into a plain TeX document.
1391 However, the stand-alone file produced with
1392 the \fB\-P\fR option must be processed with a LaTeX-engine.
1393 In addition, font-commands may require a LaTeX engine.
1394
1395 .TP
1396 .B \-b borderwidth
1397 Make blank border around figure of width \fIborderwidth\fR*(1/72) inches.
1398
1399 .TP
1400 .B \-C num
1401 Do not emit a \\color-command for the color number \fBnum\fR. (0 = black,
1402 1 = blue, 2 = green - see the color chooser widget in Xfig).
1403 By default, \fIfig2dev\fR does not issue a \\color-command
1404 for objects which have the color set to "Default" in xfig.
1405 With this option, the "\\color"-command is also omitted for objects having the
1406 color \fBnum\fR.
1407 The color of these objects, as well as of those having the color set to
1408 "Default", is picked up from the including document.
1409
1410 .TP
1411 .B \-F
1412 Do not set the font family, series or shape.
1413 By default, \fIfig2dev\fR sets the font family, series, shape,
1414 font size and baselineskip.
1415 As a side effect, this requires the New Font Selection
1416 Scheme (NFSS) of LaTeX.
1417 With this option on, the text font can be set from the including
1418 document, which may be TeX or LaTeX.
1419 See also \fB\-o\fR (no font size).
1420
1421 .TP
1422 .B "\-f font"
1423 Set the default font used for text objects to \fIfont\fR.
1424 The string \fIfont\fR may be one of
1425 \fIrm\fR, \fIbf, \fIit\fR, \fIsf\fR, \fItt\fR,
1426 \fI\\rmfamily\fR, \fI\\bfseries\fR, \fI\\itshape\fR, \fI\\sffamily\fR,
1427 \fI\\ttfamily\fR,
1428 or one of the 35 standard PostScript font names.
1429 The default is \fI\\rmfamily\fR.
1430
1431 .TP
1432 .B \-i dir
1433 Prepend the string \fIdir\fR to graphics files included in the tikz-picture.
1434 For instance, having imported "image.jpg" in xfig, with
1435 \fB\- i '$HOME/Figures/'\fR the code
1436 "\\pgfimage[width=..., height=...]{$HOME/Figures/image.jpg}"
1437 will be generated.
1438
1439 .TP
1440 .B \-O
1441 Do not quote characters special to TeX/LaTeX.
1442 Useful to get, e.g., an italic \fIx\fR, not $x$,
1443 if it was forgotten to set the text-flag "TeX" in xfig.
1444 This option effectively sets the "TeX" flag for all text.
1445
1446 .TP
1447 .B \-o
1448 Do not set the font size or baselineskip. Text will be rendered at the size that
1449 is in force where the tikz-code is inserted into the document, e.g.,
1450 "\fB\\small\\input fig1.tikz\fR".
1451 See also \fB\-F\fR (no font properties).
1452
1453 .TP
1454 .B \-P
1455 Pagemode, generate a stand-alone LaTeX-file as \fIout-file\fR.
1456 Run \fIout-file\fR through LaTeX to generate a pdf or eps of the figure.
1457 The document produced from \fIout-file\fR will have the paper size equal to the
1458 figure's bounding box (but see the \fB\-b\fR option to add a margin).
1459 The package "geometry.sty" is used in \fIout-file\fR to set the paper size.
1460
1461 .TP
1462 .B \-T
1463 Only use TeX fonts, even where PostScript-fonts are specified.
1464
1465 .TP
1466 .B \-v
1467 Verbose mode. Write comment lines into the output file, usually naming the
1468 type of the object that is drawn.
1469
1470 .TP
1471 .B \-W
1472 Do not emit code at the beginning of the file that allows one to set the
1473 figure width or height from the including TeX document.
1474 Otherwise, e.g., "\fB\\newdimen\\XFigwidth\\XFigwidth=\\linewidth\fR"
1475 would scale the following figures to the line width.
1476
1477 .TP
1478 .B \-w
1479 Remove the suffix from included graphics-files.
1480 With this option on, \fIfig2dev\fR generates code that contains, e.g.,
1481 "\fB\\pgfimage{fig1}\fR" instead of "\fB\\pgfimage{fig1.pdf}\fR".
1482
1483 .SH TK and PTK OPTIONS (tcl/tk and Perl/tk)
1484
1485 Arc-boxes are not supported for the tk output language, and only X bitmap
1486 pictures are supported because of the canvas limitation in tk.
1487 .br
1488 Picture objects are not scaled with the magnification factor for tk output.
1489 .br
1490 Because tk scales canvas items according to the X display resolution,
1491 polygons, lines, etc. may be scaled differently than imported pictures (bitmaps)
1492 which aren't scaled at all.
1493
1494 .TP
1495 .B \-g color
1496 Use
1497 .I color
1498 for the background.
1499
1500 .TP
1501 .B \-l dummy_arg
1502 Generate figure in landscape mode. The dummy argument is ignored,
1503 but must appear on the command line for reasons of compatibility.
1504 This option will override the orientation specification in the
1505 file (for file versions 3.0 and higher).
1506
1507 .TP
1508 .B \-p dummy_arg
1509 Generate figure in portrait mode. The dummy argument is ignored,
1510 but must appear on the command line for reasons of compatibility.
1511 This option will override the orientation specification in the
1512 file (for file versions 3.0 and higher).
1513 This is the default for Fig files of version 2.1 or lower.
1514
1515 .TP
1516 .B \-P
1517 Generate canvas of full page size instead of using the bounding box
1518 of the figure's objects. The default is to use only the bounding box.
1519
1520 .TP
1521 .B \-w
1522 Wrap the figure with code in order to generate a complete perl file.
1523 That is, you can do
1524 .B fig2dev -L ptk -w f.fig f.pl; perl f.pl
1525 and a widget pops up that shows the graphics contained in f.pl.
1526 Only available for ptk output.
1527
1528 .TP
1529 .B \-z papersize
1530 Set the paper size. See the POSTSCRIPT OPTIONS for available paper sizes.
1531 This is only used when the \fB\-P\fR option (use full page) is used.
1532
1533
1534 .SH TPIC OPTIONS
1535
1536 .TP
1537 .B "\-f font"
1538 Set the default font used for text objects to \fIfont\fR.
1539 The default is \fIrm\fR.
1540 The string \fIfont\fR can be one of
1541 \fIrm\fR, \fIbf\fR, \fIit\fR, \fIsf\fR, \fItt\fR,
1542 \fIavant\fR, \fIavantcsc\fR, \fIavantd\fR, \fIavantdi\fR, \fIavanti\fR,
1543 \fIbookd\fR, \fIbookdi\fR, \fIbookl\fR, \fIbooklcsc\fR, \fIbookli\fR,
1544 \fIchanc\fR, \fIcour\fR, \fIcourb\fR, \fIcourbi\fR, \fIcouri\fR,
1545 \fIhelv\fR, \fIhelvb\fR, \fIhelvbi\fR, \fIhelvc\fR, \fIhelvcb\fR,
1546 \fIhelvcbi\fR, \fIhelvci\fR, \fIhelvcsc\fR, \fIhelvi\fR, \fIpal\fR,
1547 \fIpalb\fR, \fIpalbi\fR, \fIpalbu\fR, \fIpalc\fR, \fIpalcsc\fR,
1548 \fIpali\fR, \fIpalsl\fR, \fIpalu\fR, \fIpalx\fR, \fItimes\fR,
1549 \fItimesb\fR, \fItimesbi\fR, \fItimesc\fR, \fItimescsc\fR, \fItimesi\fR,
1550 \fItimessl\fR or \fItimesx\fR.
1551
1552
1553 .SH SEE ALSO
1554 .BR xfig (1),
1555 .BR pic (1),
1556 .BR pic2fig (1),
1557 .BR transfig (1)
1558
1559
1560 .SH BUGS and RESTRICTIONS
1561 Please send bug reports, fixes, new features etc. to:
1562 .br
1563 \&@PACKAGE_BUGREPORT@
1564 .\"[email protected] (Brian V. Smith)
1565
1566 .SH COPYRIGHT
1567 Copyright (c) 1991 Micah Beck
1568 .br
1569 Parts Copyright (c) 1985-1988 Supoj Sutantavibul
1570 .br
1571 Parts Copyright (c) 1989-2015 Brian V. Smith
1572 .br
1573 Parts Copyright (c) 2015-2018 by Thomas Loimer
1574 .LP
1575 Permission to use, copy, modify, distribute, and sell this software and its
1576 documentation for any purpose is hereby granted without fee, provided that
1577 the above copyright notice appear in all copies and that both that
1578 copyright notice and this permission notice appear in supporting
1579 documentation. The authors make no representations about the suitability
1580 of this software for any purpose. It is provided "as is" without express
1581 or implied warranty.
1582 .LP
1583 THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
1584 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
1585 EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
1586 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
1587 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
1588 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
1589 PERFORMANCE OF THIS SOFTWARE.
1590
1591
1592 .SH AUTHORS
1593 Micah Beck
1594 .br
1595 Cornell University
1596 .br
1597 Sept 28 1990
1598 .sp
1599 and Frank Schmuck (then of Cornell University)
1600 .br
1601 and Conrad Kwok (then of U.C. Davis).
1602 .sp
1603 Drivers contributed by
1604 .br
1605 Jose Alberto Fernandez R. (U. of Maryland)
1606 .br
1607 and Gary Beihl (MCC)
1608 .sp
1609 Color support, ISO-character encoding and poster support by
1610 .br
1611 Herbert Bauer ([email protected])
1612 .sp
1613 Modified from f2p (fig to PIC), by the author of Fig
1614 .br
1615 Supoj Sutanthavibul ([email protected])
1616 .br
1617 University of Texas at Austin.
1618 .sp
1619 MetaFont driver by
1620 .br
1621 Anthony Starks ([email protected])
1622 .sp
1623 X-splines code by
1624 .br
1625 Carole Blanc ([email protected])
1626 .br
1627 Christophe Schlick ([email protected])
1628 .br
1629 The initial implementation was done by C. Feuille, S. Grobois, L. Maziere
1630 and L. Minihot as a student practice (Universite Bordeaux, France).
1631 .sp
1632 Japanese text support for LaTeX output
1633 written by T. Sato ([email protected])
1634 .sp
1635 The tk driver was written by
1636 .br
1637 Mike Markowski ([email protected]) with a little touch-up by Brian Smith
1638 .sp
1639 The CGM driver (Computer Graphics Metafile) was written by
1640 .br
1641 Philippe Bekaert ([email protected])
1642 .sp
1643 The EMF driver (Enhanced Metafile) was written by
1644 .br
1645 Michael Schrick ([email protected])
1646 .sp
1647 The GBX (Gerber) driver was written by
1648 .br
1649 Edward Grace ([email protected]).