1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
"DTD/xhtml1-transitional.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml">
5
<!-- XML file produced from file: manual.tex
6
using Hyperlatex v 2.6 (c) Otfried Cheong
7
on Emacs 21.4.1, Sun Dec 24 00:03:18 2006 -->
9
<title>Ipe Manual -- 3 Command line options, auxiliary programs, and environment variables</title>
11
<style type="text/css">
12
.maketitle { align : center }
13
div.abstract { margin-left: 20%; margin-right: 10%; }
14
h3.abstract { align : center }
15
div.verse, div.quote, div.quotation {
21
<meta http-equiv="Content-Type"
22
content="text/html; charset=UTF-8">
24
<body bgcolor="#ffffe6">
25
<table width="100%" cellpadding=0 cellspacing=2><tr><td bgcolor="#99ccff"><a href="manual_4.html"><img border="0" alt="4 General Concepts" src="next.png"></a></td><td bgcolor="#99ccff"><a href="manual.html"><img border="0" alt="Top" src="up.png"></a></td><td bgcolor="#99ccff"><a href="manual_2.html"><img border="0" alt="2 About Ipe files" src="previous.png"></a></td><td align="center" bgcolor="#99ccff" width="100%"><b>3 Command line options, auxiliary programs, and environment variables</b></td></tr></table>
26
<h1>3 Command line options, auxiliary programs, and environment variables</h1>
29
<h4><a name="id1">Ipe command line options</a></h4>
30
<p>Ipe supports the following two options:
31
<dl><dt><b><code>-sheet</code> <em>style sheet name</em></b><dd>
32
Adds the designated style sheet to any newly created documents.
33
<dt><b><code>-geom</code> <em>WxH+X+Y</em></b><dd>
34
Places the Ipe main windows at the desired position and size.
35
(Note the slight difference with the standard Unix option
36
<code>-geometry</code>).
38
In addition, you can specify the name of an Ipe file to open on the
39
command line. Finally, Ipe also understands some standard X11 options
40
on Unix (this is support built into the Qt library, see there for
43
<h4><a name="id2">ipetoipe: converting Ipe file formats</a></h4>
44
<p>The auxiliary program <em>ipetoipe</em> converts between the different
47
ipetoipe ( -xml | -pdf | -eps | -ps ) [ -export ] [ -noshading ] [-lastview ] infile outfile
49
For example, the command line syntax
51
ipetoipe -pdf figure1.eps figure1.pdf
53
converts <code>figure1.eps</code> to PDF format.
54
<p>When you use the <code>-export</code> flag, no Ipe markup is included in the
55
resulting output file. Ipe will not be able to open a file created
56
that way, so make sure you keep your original!
57
<p>With the <code>-noshading</code> flag, the background of generated PDF pages
59
<p>With the <code>-lastview</code> flag, only the last view of each Ipe page
60
will be created in PDF or Postscript format. This is often convenient
61
to make handouts for slides.
63
<h4><a name="id3">ipetopng: converting to a bitmap</a></h4>
64
<p>The auxiliary program <em>ipetopng</em> converts a page of the document
65
to a bitmap in PNG format. (Of course the result contains no Ipe
66
markup, so make sure you keep your original.) For instance, the
67
following command line
69
ipetopng 3 150.0 presentation.pdf pres3.png
71
converts page 3 of the Ipe document <code>presentation.pdf</code> to a
72
bitmap, with resolution <i>150.0</i> pixels per inch.
74
<h4><a name="id4">figtoipe: Importing FIG figures</a></h4>
76
<p>The auxiliary program <em>figtoipe</em> converts a figure in FIG format
77
into an Ipe XML-file. This is useful if you used to make figures with
78
Xfig before discovering Ipe, of if your co-authors made figures for
79
your article with Xfig (converting them will have the added benefit of
80
forcing your co-authors to learn to use Ipe). Finally, there are
81
quite a number of programs that can export to FIG format, and
82
<em>figtoipe</em> effectively turns that into the possibility of
84
<p>However, <em>figtoipe</em> is not quite complete. Most seriously, no
85
attempt is made to represent FIG splines, FIG arc-boxes, and embedded
86
images in FIG files. The drawing models of FIG and Ipe are also
87
somewhat different, which makes it impossible to properly render some
88
FIG files in Ipe. Ipe does not support depth ordering independent of
89
grouping, pattern fill, and Postscript fonts. You may therefore have
90
to edit the file after conversion.
92
<h4><a name="id5">pdftoipe: Importing Postscript and PDF</a></h4>
94
<p>You can convert arbitrary Postscript or PDF files into Ipe documents,
95
making them editable. The auxiliary program <em>pdftoipe</em> converts
96
(pages from) a PDF file into an Ipe XML-file. (If your source is
97
Postscript, you have to first convert it to PDF using Acrobat
98
Distiller or <i>ps2pdf</i>.) Once converted to XML, the file can be
99
opened from Ipe as usual.
100
<p>The conversion process should handle any graphics in the PDF file
101
fine, but doesn't do very well on text--Ipe's text model is just too
103
<p>Note that <em>pdftoipe</em> is not part of the Ipe source
104
distribution. You can download and build it separately.
106
<h4><a name="id6">environment variables</a></h4>
107
<p>Ipe, <em>ipetoipe</em>, and <em>ipetopng</em> respect the following
108
environment variables:
109
<dl><dt><b>IPELATEXDIR</b><dd> the directory where Ipe runs Pdflatex.
110
<dt><b>IPEPDFLATEX</b><dd> the name of the Pdflatex executable. If Pdflatex
111
is on your path, the value <em>pdflatex</em> is sufficient.
112
<dt><b>IPEDOCDIR</b><dd> the directory containing the Ipe documentation.
113
<dt><b>IPELANGDIR</b><dd> the directory containing user interface localization
114
for Ipe. (No such localization exists yet.)
115
<dt><b>IPEFONTMAP</b><dd> the complete path of the font map, describing where
116
Ipe can find the 14 standard PDF fonts.
117
<dt><b>IPEKEYSFILE</b><dd> the complete path of the XML file specifying the
118
standard Ipe key assignment. You don't normally need to set this
119
variable, as you can override the standard assignment using a file
120
in your home directory.
121
<dt><b>IPEBROWSER</b><dd> the name of the HTML browser to be used to
122
display the Ipe on-line manual.
123
<dt><b>IPELETPATH</b><dd> a list of directories where Ipe looks for
124
ipelets. Directories are separated by `:' on Unix, and by `;' on
126
<dt><b>TEXINPUTS</b><dd> when running Pdflatex, Ipe prepends both the current
127
directory (where Ipe was started) as the directory containing the
128
current document to the <b>TEXINPUTS</b> environment variable.
131
<table width="100%" cellpadding=0 cellspacing=2><tr><td bgcolor="#99ccff"><a href="manual_4.html"><img border="0" alt="4 General Concepts" src="next.png"></a></td><td bgcolor="#99ccff"><a href="manual.html"><img border="0" alt="Top" src="up.png"></a></td><td bgcolor="#99ccff"><a href="manual_2.html"><img border="0" alt="2 About Ipe files" src="previous.png"></a></td><td align="center" bgcolor="#99ccff" width="100%"><b>3 Command line options, auxiliary programs, and environment variables</b></td></tr></table></body></html>