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 22.2.1, Wed Dec 9 15:44:24 2009 -->
9
<title>Ipe Manual -- 12.1 Command line options</title>
11
<style type="text/css">
12
.maketitle { text-align : center }
13
div.abstract { margin-left: 20%; margin-right: 10%; }
14
h3.abstract { text-align : center }
15
div.verse, div.quote, div.quotation {
21
<link rel="stylesheet"
22
href="manual.css" type="text/css"><meta http-equiv="Content-Type"
23
content="text/html; charset=UTF-8">
25
<body bgcolor="#ffffe6">
26
<table width="100%" cellpadding=0 cellspacing=2><tr>
27
<td bgcolor="#99ccff"><a href="manual_50.html"><img border="0" alt="12.2 Environment variables" src="next.png"></a></td><td bgcolor="#99ccff"><a href="manual_48.html"><img border="0" alt="12 Command line options and environment variables" src="up.png"></a></td><td bgcolor="#99ccff"><img alt="" src="blank.png"></td><td align="center" bgcolor="#99ccff" width="100%"><b>12.1 Command line options</b></td></tr></table>
28
<h2>12.1 Command line options</h2>
30
<h4><a name="id1">Ipe command line options</a></h4>
31
<p>Ipe supports the following command line options:
32
<dl><dt><b><code>-sheet</code> <em>style sheet name</em></b><dd>
33
Adds the designated style sheet to any newly created documents.
34
<dt><b><code>-show-configuration</code></b><dd>
35
With this option, Ipe will display the current configuration options
36
on stdout, and terminate.
38
In addition, you can specify the name of an Ipe file to open on the
39
command line. Ipe also understands all options supported by the
40
<a href="http://qt.nokia.com/doc/4.5/qapplication.html#QApplication">Qt
43
<h4><a name="id2">Ipeview: a minimal Ipe viewer</a></h4>
44
<p>Ipeview allows you to quickly view an Ipe file without starting the
47
<h4><a name="id3">Ipetoipe: converting Ipe file formats</a></h4>
48
<p>The auxiliary program <em>ipetoipe</em> converts between the different
51
ipetoipe ( -xml | -pdf | -eps ) { <options> } infile [ outfile ]
53
The first argument determines the format of the output file. If no
54
output filename is provided, Ipe will try to guess it by appending one
55
of the extensions "ipe", "pdf", or "eps" to the input file's
57
<p>For example, the command line syntax
59
ipetoipe -pdf figure1.eps
61
converts <i>figure1.eps</i> to <i>figure1.pdf</i>.
62
<p>Ipetoipe understands the following options:
63
<dl><dt><b><code>-export</code></b><dd> No Ipe markup is included in the resulting
64
output file. Ipe will not be able to open a file created that way,
65
so make sure you keep your original!
66
<dt><b><code>-lastview</code></b><dd> (PDF only) <br />Only the last view of each Ipe
67
page will be created in PDF format. This is often convenient to
68
make handouts for slides.
69
<dt><b><code>-pages</code> from-to</b><dd> (PDF only) <br />Restrict exporting to PDF to this page range. This implies the
70
<code>-export</code> option.
71
<dt><b><code>-view</code> page-view</b><dd> Only export this single view from the document. This implies
72
the <code>-export</code> option.
73
<dt><b><code>-runlatex</code></b><dd>
74
Run Latex even for XML output. This has the effect of including
75
the dimensions of each text object in the XML file.
76
<dt><b><code>-nocolor</code></b><dd>
77
Do not use any color commands in Postscript output. This is
78
useful if you are preparing a manuscript for publication where
79
the publisher checks that the figures are grayscale only. Note
80
that this option doesn't actually verify that the figure con-
81
tains no color (a figure using color processed with this option
82
will cause a Postscript error when displayed).
83
<dt><b><code>-nozip</code></b><dd>
84
Do not compress streams in PDF or Postscript output.
85
<dt><b><code>-styleupdate</code></b><dd> Update all style sheets in the document
86
from external style sheet files in the current directory. The
87
external file's name must match the name of the style sheet and have
91
<h4><a name="id4">Iperender: converting to a bitmap or SVG art</a></h4>
92
<p>The program <em>iperender</em> converts a page of the document to a
93
bitmap in PNG format or to scalable vector graphics in SVG format.
94
(Of course the result contains no Ipe markup, so make sure you keep
95
your original.) For instance, the following command line
97
iperender -png -page 3 -resolution 150 presentation.pdf pres3.png
99
converts page 3 of the Ipe document <code>presentation.pdf</code> to a
100
bitmap, with resolution <i>150</i> pixels per inch.
102
<h4><a name="id5">Ipeextract: extract XML stream from Ipe PDF or EPS file</a></h4>
103
<p>Ipeextract extracts the XML stream from a PDF or EPS file and saves it
104
in a file. It will work even if Ipe cannot actually parse the file,
105
so you can use this tool to debug problems where Ipe fails to open
108
ipeextract infile [ outfile ]
110
If not provided, the outfile is guessed by appending "xml" to the
113
<h4><a name="id6">Ipe6upgrade: convert Ipe 6 files to Ipe 7 file format</a></h4>
114
<p>Ipe6upgrade takes as input a file created by any version of Ipe 6, and
115
saves in the format of Ipe 7.0.0.
117
ipe6upgrade infile [ outfile ]
119
If not provided, the outfile is guessed by adding the extension
120
"ipe" to the infile's basename.
122
<h4><a name="id7">Svgtoipe: Importing SVG figures</a></h4>
124
<p>The auxiliary program <em>svgtoipe</em> converts an SVG figure to Ipe
125
format. It cannot handle all SVG features (many SVG features are not
126
supported by Ipe anyway), but it works for gradients.
127
<p><em>svgtoipe</em> is not part of the Ipe source distribution. You can
128
download it separately.
130
<h4><a name="id8">Pdftoipe: Importing Postscript and PDF</a></h4>
132
<p>You can convert arbitrary Postscript or PDF files into Ipe documents,
133
making them editable. The auxiliary program <em>pdftoipe</em> converts
134
(pages from) a PDF file into an Ipe XML-file. (If your source is
135
Postscript, you have to first convert it to PDF using Acrobat
136
Distiller or <i>ps2pdf</i>.) Once converted to XML, the file can be
137
opened from Ipe as usual.
138
<p>The conversion process should handle any graphics in the PDF file
139
fine, but doesn't do very well on text--Ipe's text model is just too
141
<p><em>pdftoipe</em> is not part of the Ipe source distribution. You can
142
download and build it separately.
144
<h4><a name="id9">Ipe5toxml: convert Ipe 5 files to Ipe 6 file format</a></h4>
145
<p>If you still have figures that were created with Ipe 5, you can use
146
<em>ipe5toxml</em> to convert them to Ipe 6 format. You can then use
147
<em>ipe6upgrade</em> to convert them to Ipe 7 format.
148
<p><em>ipe5toxml</em> is not part of the Ipe distribution, but available as
151
<h4><a name="id10">Figtoipe: Importing FIG figures</a></h4>
153
<p>The auxiliary program <em>figtoipe</em> converts a figure in FIG format
154
into an Ipe XML-file. This is useful if you used to make figures with
155
Xfig before discovering Ipe, of if your co-authors made figures for
156
your article with Xfig (converting them will have the added benefit of
157
forcing your co-authors to learn to use Ipe). Finally, there are
158
quite a number of programs that can export to FIG format, and
159
<em>figtoipe</em> effectively turns that into the possibility of
161
<p>However, <em>figtoipe</em> is not quite complete. The drawing models of
162
FIG and Ipe are also somewhat different, which makes it impossible to
163
properly render some FIG files in Ipe. Ipe does not support depth
164
ordering independent of grouping, pattern fill, and Postscript fonts.
165
You may therefore have to edit the file after conversion.
166
<p><em>figtoipe</em> is not part of the Ipe distribution. You can download
167
and build it separately. <em>figtoipe</em> is now maintained by
168
Alexander Bürger.
170
<table width="100%" cellpadding=0 cellspacing=2><tr>
171
<td bgcolor="#99ccff"><a href="manual_50.html"><img border="0" alt="12.2 Environment variables" src="next.png"></a></td><td bgcolor="#99ccff"><a href="manual_48.html"><img border="0" alt="12 Command line options and environment variables" src="up.png"></a></td><td bgcolor="#99ccff"><img alt="" src="blank.png"></td><td align="center" bgcolor="#99ccff" width="100%"><b>12.1 Command line options</b></td></tr></table></body></html>