1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
|
.ig >>
<STYLE TYPE="text/css">
<!--
A:link{text-decoration:none}
A:visited{text-decoration:none}
A:active{text-decoration:none}
OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }
H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: symboldetails</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
<table cellpadding=2 width=550><tr>
<td><br><h2>symboldetails</h2></td>
<td align=right>
<small>
<a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
Version 2.33 Jun'06
<td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>
.TH symboldetails PL "02-JUN-2006 PL ploticus.sourceforge.net"
.LP
Ploticus plotting procs that render data points use
"symboldetails" specifications for controlling the shape, color, and other details
of the data points.
.LP
Syntax: settings are separated from each other by space, but settings
themselves contain no embedded whitespace. Also, the entire specification
must be on one line.
.LP
Data points are either vector-based or "direct pixel" (2.33+). It is also possible
to use a small PNG or JPEG image as the data point.
Note: All changes made herein for 2.33 are back compatible - no changes should be necessary to existing applications.
.ig >>
<br><br><br>
.>>
.SH Examples
.LP
An example symboldetails specification: \fCshape=pixcircle style=solid color=blue\fR
.ig >>
<br><br>
.>>
.LP
A script example that generates various data point symbols:
.ig >>
<a href="../gallery/symbols2.htm">symbols2<br><img src="../gallery/symbols2.gif" border=0></a>
.>>
.LP
The first two rows show the new \fBdirect pixel\fR data points, in solid and outline styles.
These are available in ploticus 2.33+ when rendering on raster devices (GD and X11).
The third row shows the \fBvector-based\fR data points that have always been available.
Note that the new type is sharper and more uniform, while the old type offer more
options including fill+outlined and spoke styles, and unlimited size.
.ig >>
<br><br>
.>>
.SH Settings
.LP
\fBshape\fR=\fIs\fR
.IP \0
To get direct pixel data points
\fIs\fR can be one of these shapes: \fCpixcircle pixsquare pixdiamond pixtriangle pixdowntriangle\fR.
.IP
To get vector-based data points \fIs\fR can be one of:
\fCcircle square diamond triangle downtriangle pentagon lefttriangle righttriangle nicecircle\fR. A triangle
points up; a downtriangle points down, etc. A circle has 12 points; a nicecircle has 20.
.IP
We recommend using the \fCpix*\fR shapes for ongoing development. These give better-looking
data points for typical applications, and fall back to the vector equivalents on non-raster output devices.
.ig >>
<br><br>
.>>
.LP
\fBstyle\fR=\fIs\fR
.IP \0
For direct pixel data points \fIs\fR may be either \fCoutline\fR (the default), or \fCsolid\fR (solid color).
The \fCcolor\fR setting controls both the outline and fill colors.
.IP
For vector-based data points \fIs\fR may be one of: \fCoutline\fR (the default), \fCsolid\fR (solid color),
\fCfill+outline\fR (solid color with an outline of a different color), or \fCspokes\fR (like the spokes of a wheel).
The \fCfill+outline\fR style requires that \fCfillcolor\fR and \fClinecolor\fR also be set;
otherwise data point color can be controlled using the \fCcolor\fR setting.
.IP
Note: \fCfill\fR and \fCfilled\fR are equivalent to \fCsolid\fR and can still be used as a style setting.
.ig >>
<br><br>
.>>
.LP
\fBradius\fR=\fIr\fR
.IP \0
where \fIr\fR is the radius of the symbol in
.ig >>
<a href="attributetypes.html#positionunits">
.>>
\0inches or cm.
.ig >>
</a>
.>>
Direct-pixel data points can be rendered in sizes from radius=0.01 to about radius=0.1.
Vector-based data points can be rendered in any size.
.ig >>
<br><br>
.>>
.LP
\fBcolor\fR=\fIcolor\fR
.IP \0
The
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
to use for the symbol.
This may be used for any style of data point except for \fCfill+outlined\fR (where
separate \fCfillcolor\fR and \fClinecolor\fR settings are required).
.ig >>
<br><br>
.>>
.LP
\fBfillcolor\fR=
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
The fill color for \fCfill+outlined\fR data points.
.ig >>
<br><br>
.>>
.LP
\fBlinecolor\fR=
.ig >>
<a href="color.html">
.>>
\0color
.ig >>
</a>
.>>
.IP \0
The outline color for \fCfill+outlined\fR data points.
.ig >>
<br><br>
.>>
.LP
\fBlinewidth\fR=\fIlinewidth\fR
.IP \0
the linewidth to use for the lines in vector-based data points. See
.ig >>
<a href="linedetails.html">
.>>
\0linedetails
.ig >>
</a>
.>>
.ig >>
<br><br>
.>>
.LP
\fBimgfile\fR=\fIname\fR
.IP \0
If specified, a PNG or JPEG image will be loaded and displayed as the data point symbol.
\fIname\fR is the file name of an image.
Note: the image type must be the same type as your resulting
image. If your ploticus build does not support PNG or JPEG, you cannot
use this feature.
.ig >>
<br><br>
.>>
.LP
\fBimgscale\fR=\fIsx\fR[,\fIsy\fR]
.IP \0
scale factor to apply to the \fCimgfile\fR symbol. If only \fIsx\fR is given,
equal amount of scaling is applied in both X and Y directions.
Otherwise \fIsx\fR is the scale factor in X, and \fIsy\fR the
scale factor in Y. A scale factor of \fC1.0\fR uses the
original size; a smaller value shrinks the image; a larger value enlarges it.
Formerly called \fCpngscale\fR.
.ig >>
<br><br><br>
.>>
.SH Illustration of new direct pixel data points
.LP
.ig >>
<a href="../gallery/pixpts.htm"><img src="../gallery/pixpts.gif" border=0><br>pixpts</a>
.>>
.LP
This illustrates the available shapes, sizes, and styles of the new direct pixel data points.
.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
.>>
|
