4
4
<html xmlns="http://www.w3.org/1999/xhtml">
5
5
<!-- XML file produced from file: manual.tex
6
6
using Hyperlatex v 2.6 (c) Otfried Cheong
7
on Emacs 21.3.1, Mon Nov 22 10:30:53 2004 -->
7
on Emacs 21.3.1, Tue Sep 26 20:03:47 2006 -->
9
9
<title>Ipe Manual -- 14.3 Ipe object elements</title>
35
35
<p>Any Ipe object can take the optional attributes <code>stroke</code> and
36
36
<code>matrix</code>. The value of <code>stroke</code> is a color--either a
37
37
symbolic name defined in one of the style sheets of the document, one
38
of the predefined names "void", "black", or "white", a single
38
of the predefined names "black" or "white", a single
39
39
real number between <i>0</i> (black) and <i>1</i> (white) indicating a gray
40
40
level, or three real numbers in the range <i>[0,1]</i> indicating the red,
41
41
green, and blue component (in this order), separated by white space.
42
(Note that the stroke color is not allowed to be "void".)
42
43
<p>The value of <code>matrix</code> is a sequence of six real numbers,
43
44
separated by white space, indicating a transformation matrix for all
44
45
coordinates inside the element (including embedded elements if this is
49
50
<p>The <code><mark></code> element defines a mark object. It takes the required
50
51
attributes <code>size</code> (a real number or symbolic name), <code>type</code>
51
52
(an integer, see <code>IpeMark</code>), and <code><pos></code> (two real numbers,
52
separated by white space).
53
separated by white space), and the optional attribute <code>fill</code> for
54
56
<h3><a name="id2">14.3.2 The <code><ref></code> element</a></h3>
55
57
<p>The <code><ref></code> element refers to an Ipe object defined in the style
64
66
to a bitmap defined in a <code><bitmap></code> element in the document), and
65
67
<code>rect</code> (four real coordinates separated by white space, in the
66
68
order <i>x<sub>1</sub></i>, <i>y<sub>1</sub></i>, <i>x<sub>2</sub></i>, <i>y<sub>2</sub></i>, indicating two opposite
67
corners of the image in Ipe coordinates), The optional <code>matrix</code>
69
corners of the image in Ipe coordinates). The optional <code>matrix</code>
68
70
attribute can be used to transform the image into a non-rectangular
70
72
<p>It is also possible to embed a bitmap <em>directly</em>, without first
99
101
are <em>yes</em> and <em>no</em>, the latter is the default) determines
100
102
whether the text object can be transformed, that is, stretched and
101
103
rotated. Moving, of course, is always allowed.
104
<p>The optional attribute <code>style</code> selects a LaTeX "style" to be
105
used for formatting the text. It is only used for minipage objects,
106
and must be a symbolic name defined in a style sheet. The standard
107
style sheet defines the styles "default", "center", "itemize",
108
and "item". If the attribute is not present, the "default" style
102
110
<p>The contents of the element must be a legal LaTeX fragment that can
103
111
be interpreted by LaTeX inside <code>\hbox</code>, possibly using the
104
112
macros or packages defined in the preamble.
114
122
<code>stroke</code>, <code>fill</code>, <code>dash</code>, <code>pen</code>, <code>cap</code>,
115
123
<code>join</code>, <code>fillrule</code>, <code>matrix</code>, <code>arrow</code>,
116
124
<code>backarrow</code>.
117
<p>The value of <code>dash</code> is either the predefined name "solid", a
118
symbolic name defined in a style sheet, or a dash pattern in PDF
119
format, such as "[3 1] 0" for "three pixels on, one off, starting
120
with the first pixel".
125
<p>The value of <code>dash</code> is either one of the predefined names
126
"void" or "solid", a symbolic name defined in a style sheet, or a
127
dash pattern in PDF format, such as "[3 1] 0" for "three pixels on,
128
one off, starting with the first pixel".
121
129
<p>The value of <code>pen</code> is the line width, either symbolic (defined in
122
130
a style sheet), or as a single real number.
123
131
<p>The values of <code>cap</code>, <code>join</code> are the <em>line cap</em> and
124
132
<em>line join</em> settings of PDF, as integers.
125
133
<p>The value of the <code>fillrule</code> attribute selects one of two
126
134
algorithms for determining whether a point lies inside a filled
127
object. Possible values are <code>wind</code> and <code>eofill</code> (the latter
128
is the default if the attribute is missing).
135
object. Possible values are <code>wind</code> and <code>eofill</code>.
129
136
<p>The value of the <code><arrow></code> and <code><backarrow></code> attributes is
130
137
the size of an arrow, either a symbolic name defined in a style sheet,
131
138
or a real number. If the attribute is missing, no arrow is drawn.
133
140
series of "path construction operators" with arguments. This
134
141
generalizes the PDF path construction syntax.
135
142
<p>Each operator follows its arguments. The operators are
136
<ul class="menu"><li><code>m</code> (moveto) (1 point argument): begin new subpath,
143
[<ul class="menu"><li><code>m</code> (moveto) (1 point argument): begin new subpath,
137
144
<li><code>l</code> (lineto) (1 point argument): add straight segment to
139
146
<li><code>c</code> (curveto) (3 point arguments): add a cubic Bézier
148
<li><code>q</code> (quadratic curveto) (2 point arguments): add a
149
quadratic Bézier curve,
141
150
<li><code>e</code> (ellipse) (1 matrix argument): add a closed subpath
142
151
consisting of an ellipse, the ellipse is the image of the unit
143
152
circle under the transformation described by the matrix,
added
removed
doc/manual_38.html
