1FIG2PS(1) FIG2PS(1)
2
6 fig2ps, fig2eps,fig2pdf - Convert xfig files in ps⎪pdf, processing all
7 the text marked as special with LaTeX.
8
10 fig2ps [-h⎪--help]
11 fig2ps [--[no]gv] [--packages=pack1,pack2,...] [--add=pack1,pack2,...]
13 [-k⎪--keep] [--bbox=dvips⎪gs⎪a,b,c,d] [--input=file] [--[no]pdf]
14 [--dvips=s] [--eps] [--[no]forcespecial] file1.fig {file2.fig ...}
15 [--preamble=s]
16
18 fig2ps is a little perl script which takes advantage of the pstex and
19 pstext_t export formats of fig2dev to format the text inside a Xfig
20 figure using LaTeX. fig2pdf does the same, but ensures that the ps file
21 producted converts nicely to pdf and actually performs the conversion.
22
24 --[no]gv
25 Tells wether to run gv at the end of the script to see the result.
26 On by default, if fig2ps detects he's talking to a terminal.
27 --keep
29 Use this option if you want to keep the intermediate files used by
30 fig2ps. May be useful for debugging...
31 --packages=pack1,pack2,...
33 Sets the package list to be used to pack1,pack2,.... For packages
34 taking arguments, you can use the syntax [arg]package, which so far
35 does recognise only one argument, or the newer syntax
36 arg1:arg2:arg...:package, which allows for an arbitrary number of
37 arguments.
38 --add=pack1,pack2,...
40 Adds pack1,pack2,... to the existing list of packages. The same
41 recommandation applies for packages with arguments.
42 --bbox=dvips⎪gs⎪a,b,c,d
44 Chooses the method to determine the Bounding Box:
45 dvips
47 Tells fig2ps to run divps with option -E to generate a fitting
48 bounding box. This will work on many cases, but might fail if
49 there is not a lot of text.
50 gs Tells fig2ps to use gs with option -sDEVICE=bbox to get the
52 bounding box. I never saw it fail so far.
53 a,b,c,d
55 Specify your bounding box by hand.
56 --input=file
58 Uses file as a template for the Tex file, that is, do not print out
59 a list of packages, but instead include file using \input file.
60 There is one exception: color is always included (after \input),
61 because export from xfig depends on it. This flag is designed for
62 compatibility with a private use of fig2ps; you may of course use
63 it, but you will find that, most of the times, what you actually
64 need is to use --add with an appropriate .sty file (make sure that
65 kpsewhich does find it).
66 --[no]pdf
68 Whether the output of fig2ps will be pdf or ps. On when the program
69 names includes "pdf", as for instance fig2pdf.
70 --eps
72 Change the output default extension from .ps to .eps. This is on by
73 default if the program is called as fig2eps.
74 --dvips=s
76 Passes s as options when running dvips.
77 --fig2dev=s
79 Passes s as options when running fig2dev.
80 --keepps
82 Tells fig2pdf to keep the intermediary ps file after converting to
83 pdf. It is by default removed.
84 --[no]forcespecial
86 Forces the special flag of text in the fig file, so that every sin‐
87 gle text is processed through LaTeX.
88 --preamble=s
90 Adds the string s in the preamble of the LaTeX file generated, that
91 is, before the \begin{document};
92
94 Many of the command-line options are pre-definable in either the global
95 or the user configuration file. Global configuration is overridden by
96 users' configuration which is overridden by the command line options.
97 Here is a list of the variables you can define:
98 PACKAGES=pack1,pack2...
100 Defines the basic list of packages. See the --package command-line
101 argument for the handling of packages arguments.
102 ADD=pack1,pack2...
104 Defines the supplementary packages. This option doesn't make any
105 sense in the global configuration file. Be careful that this option
106 will be overridden by the command line, thus, a ADD=something and a
107 --add=somethingelse will add only somethingelse to the package
108 list, and not something+somethingelse.
109 DOC_CLASS=class
111 Sets the document class used by LaTeX.
112 DOC_OPTIONS=options
114 Sets the options for the document class.
115 FORCE_SPECIAL=0⎪1
117 Sets or unsets the default for option --forcespecial.
118 GV=0⎪1
120 Wether to run "gv" at the end of the conversion or not.
121 INPUT=file
123 See the --input=file option. Especially comes in useful in the
124 users' configuration files.
125 PREAMBLE=string
127 Identical to the --preamble=s option.
128 KEEP_PS=0⎪1
130 See the --keepps option.
131
133 Fig2ps used to include aeguill by default on PDF output to produce nice
134 looking PDF files. However, this behavior is no longer desired. For
135 perfect PDF, we recommend that you use cm-super fonts. If you still
136 wish to use aeguill, include it with -add=aeguill.
137
139 /etc/fig2ps/fig2ps.rc, $HOME/.fig2ps.rc
140 You can also give a look at /usr/share/doc/fig2ps/examples to give you
142 few ideas. For now, the example(s) are quite limited...
143
145 xfig(1), fig2dev(1), latex(1), gv(1), gs(1), kpsewhich(1)...
146
148 This little script has been written by Vincent Fourmond, from on an
149 original idea of Seb Desreux (the first script is for private use, and
150 used the eepic export of xfig, which is severely limitated), improved
151 by a few others...
152
154 Send bugs or comments to Vincent Fourmond <vincent.fourmond@9online.fr>
155perl v5.8.8 2006-09-04 FIG2PS(1)