~ubuntu-branches/ubuntu/precise/graphviz/precise-updates

« back to all changes in this revision

Viewing changes to doc/info/output.html

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2008-02-08 02:06:56 UTC
  • mfrom: (1.2.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20080208020656-a3cbewe5ly6dpj0s
Tags: 2.16-3ubuntu1
* Merge with Debian; remaining changes:
  - Drop libttf-dev (libttf-dev is in universe) (LP: #174749).
  - Replace gs-common with ghostscript.
  - Build-depend on python-dev instead of python2.4-dev.
  - Build-depend on liblua50-dev instead of liblua5.1-0-dev.
  - Mention the correct python version for the python bindings in the
    package description.

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
flag on the <A HREF=command.html>command line</A>, where <I>lang</I>
15
15
is one of the parameters listed below.
16
16
<P>
 
17
The formats actually available in a given Graphviz system depend on 
 
18
how the system was built and the presence of additional libraries.
 
19
To see what formats <b>dot</b> supports, run <TT>dot -T?</TT>.
 
20
See the <A HREF=command.html#d.T> description of the -T</A> 
 
21
flag for additional information.
 
22
<P>
17
23
Note that the internal coordinate system has the origin 
18
24
in the lower left corner.
19
25
Thus, positions in the
26
32
<P>
27
33
<TABLE ALIGN=CENTER>
28
34
<TR><TH>Command-line<BR>parameter</TH><TH>Format</TH></TR>
 
35
 <TR><TD ALIGN=CENTER><A NAME=a:bmp HREF=#d:bmp>bmp</A>
 
36
</TD><TD>Windows Bitmap Format</TD> </TR>
29
37
 <TR><TD ALIGN=CENTER><A NAME=a:canon HREF=#d:canon>canon</A>
30
38
<BR><A NAME=a:dot HREF=#d:dot>dot</A>
31
39
<BR><A NAME=a:xdot HREF=#d:xdot>xdot</A>
41
49
</TD><TD>GD/GD2 formats</TD> </TR>
42
50
 <TR><TD ALIGN=CENTER><A NAME=a:gif HREF=#d:gif>gif</A>
43
51
</TD><TD>GIF</TD> </TR>
 
52
 <TR><TD ALIGN=CENTER><A NAME=a:gtk HREF=#d:gtk>gtk</A>
 
53
</TD><TD>GTK canvas</TD> </TR>
44
54
 <TR><TD ALIGN=CENTER><A NAME=a:hpgl HREF=#d:hpgl>hpgl</A>
45
55
</TD><TD>HP-GL/2</TD> </TR>
 
56
 <TR><TD ALIGN=CENTER><A NAME=a:ico HREF=#d:ico>ico</A>
 
57
</TD><TD>Icon Image File Format</TD> </TR>
46
58
 <TR><TD ALIGN=CENTER><A NAME=a:imap HREF=#d:imap>imap</A>
47
59
<BR><A NAME=a:cmapx HREF=#d:cmapx>cmapx</A>
48
60
</TD><TD>Server-side and client-side imagemaps</TD> </TR>
 
61
 <TR><TD ALIGN=CENTER><A NAME=a:imap_np HREF=#d:imap_np>imap_np</A>
 
62
<BR><A NAME=a:cmapx_np HREF=#d:cmapx_np>cmapx_np</A>
 
63
</TD><TD>Server-side and client-side imagemaps</TD> </TR>
49
64
 <TR><TD ALIGN=CENTER><A NAME=a:ismap HREF=#d:ismap>ismap</A>
50
65
</TD><TD>Server-side imagemap (deprecated)</TD> </TR>
51
66
 <TR><TD ALIGN=CENTER><A NAME=a:jpg HREF=#d:jpg>jpg</A>
52
67
<BR><A NAME=a:jpeg HREF=#d:jpeg>jpeg</A>
53
 
</TD><TD>JPEG (deprecated - 8 May 2006 - will no longer be supported)</TD> </TR>
 
68
<BR><A NAME=a:jpe HREF=#d:jpe>jpe</A>
 
69
</TD><TD>JPEG</TD> </TR>
54
70
 <TR><TD ALIGN=CENTER><A NAME=a:mif HREF=#d:mif>mif</A>
55
71
</TD><TD>FrameMaker MIF format</TD> </TR>
56
72
 <TR><TD ALIGN=CENTER><A NAME=a:mp HREF=#d:mp>mp</A>
57
73
</TD><TD>MetaPost</TD> </TR>
58
74
 <TR><TD ALIGN=CENTER><A NAME=a:pcl HREF=#d:pcl>pcl</A>
59
75
</TD><TD>PCL</TD> </TR>
 
76
 <TR><TD ALIGN=CENTER><A NAME=a:pdf HREF=#d:pdf>pdf</A>
 
77
</TD><TD>Portable Document Format (PDF)</TD> </TR>
60
78
 <TR><TD ALIGN=CENTER><A NAME=a:pic HREF=#d:pic>pic</A>
61
79
</TD><TD>PIC</TD> </TR>
62
80
 <TR><TD ALIGN=CENTER><A NAME=a:plain HREF=#d:plain>plain</A>
71
89
 <TR><TD ALIGN=CENTER><A NAME=a:svg HREF=#d:svg>svg</A>
72
90
<BR><A NAME=a:svgz HREF=#d:svgz>svgz</A>
73
91
</TD><TD>Scalable Vector Graphics</TD> </TR>
 
92
 <TR><TD ALIGN=CENTER><A NAME=a:tga HREF=#d:tga>tga</A>
 
93
</TD><TD>Truevision Targa Format (TGA)</TD> </TR>
 
94
 <TR><TD ALIGN=CENTER><A NAME=a:tif HREF=#d:tif>tif</A>
 
95
<BR><A NAME=a:tiff HREF=#d:tiff>tiff</A>
 
96
</TD><TD>TIFF (Tag Image File Format)</TD> </TR>
 
97
 <TR><TD ALIGN=CENTER><A NAME=a:vml HREF=#d:vml>vml</A>
 
98
<BR><A NAME=a:vmlz HREF=#d:vmlz>vmlz</A>
 
99
</TD><TD>Vector Markup Language (VML)</TD> </TR>
74
100
 <TR><TD ALIGN=CENTER><A NAME=a:vrml HREF=#d:vrml>vrml</A>
75
101
</TD><TD>VRML</TD> </TR>
76
102
 <TR><TD ALIGN=CENTER><A NAME=a:vtx HREF=#d:vtx>vtx</A>
77
103
</TD><TD>Visual Thought format</TD> </TR>
78
104
 <TR><TD ALIGN=CENTER><A NAME=a:wbmp HREF=#d:wbmp>wbmp</A>
79
105
</TD><TD>Wireless BitMap format</TD> </TR>
 
106
 <TR><TD ALIGN=CENTER><A NAME=a:xlib HREF=#d:xlib>xlib</A>
 
107
</TD><TD>Xlib canvas</TD> </TR>
80
108
</TABLE>
81
109
<HR>
82
110
<H2>Format Descriptions</H2>
83
111
<DL>
 
112
<DT><A NAME=d:bmp HREF=#a:bmp><STRONG>bmp</STRONG></A>
 
113
<DD>  Outputs images in the Windows <A HREF="http://en.wikipedia.org/wiki/Bitmap">BMP</A> format.
 
114
 
84
115
<DT><A NAME=d:canon HREF=#a:canon><STRONG>canon</STRONG></A>
85
116
,<DT><A NAME=d:dot HREF=#a:dot><STRONG>dot</STRONG></A>
86
117
,<DT><A NAME=d:xdot HREF=#a:xdot><STRONG>xdot</STRONG></A>
114
145
  The <B>xdot</B> format extends the
115
146
  <B>dot</B> format by providing much more detailed information about
116
147
  how graph components are drawn. It relies on additional attributes
117
 
  for nodes, edges and graphs. The format is preliminary; comments and
 
148
  for nodes, edges and graphs.
 
149
  <P>
 
150
  The format is preliminary; comments and
118
151
  suggestions for better representations are welcome.
 
152
  To allow for changes in the format, Graphviz attaches the attribute
 
153
  <TT>xdotversion</TT> to the graph.
119
154
  <P>
120
155
  At present, additional drawing attributes are only attached to nodes
121
156
  and edges. There are six new attributes:
131
166
  <P>
132
167
  The value of these attributes consists of the concatenation of some
133
168
  (multi-)set of the following 12 rendering or attribute operations.
 
169
  (The number is parentheses gives the xdot version when the operation
 
170
  was added to the format. If no version number is given, the operation
 
171
  was in the original specification.)
134
172
  <SPACER TYPE=VERTICAL size=10>
135
173
  <TABLE border bgcolor=beige>
136
174
  <TR><TD>E x<sub>0</sub> y<sub>0</sub> w h
146
184
  <TR><TD>B n x<sub>1</sub> y<sub>1</sub> ... x<sub>n</sub> y<sub>n</sub>
147
185
    <TD>B-spline using the given n control points
148
186
  <TR><TD>b n x<sub>1</sub> y<sub>1</sub> ... x<sub>n</sub> y<sub>n</sub>
149
 
    <TD>Filled B-spline using the given n control points
 
187
    <TD>Filled B-spline using the given n control points (1.1)
150
188
  <TR><TD>T x y j w n -<I>c<sub>1</sub>c<sub>2</sub>...c<sub>n</sub><I>
151
189
    <TD>Text drawn using the baseline point (x,y). The text consists of the
152
190
    n characters following '-'. The text should be left-aligned (centered,
154
192
    w gives the width of the text as computed by the library.
155
193
  <TR><TD>C n -<I>c<sub>1</sub>c<sub>2</sub>...c<sub>n</sub><I>
156
194
    <TD>Set fill color. The color value consists of the
157
 
    n characters following '-'.
 
195
    n characters following '-'. (1.1)
158
196
  <TR><TD>c n -<I>c<sub>1</sub>c<sub>2</sub>...c<sub>n</sub><I>
159
197
    <TD>Set pen color. The color value consists of the
160
 
    n characters following '-'.
 
198
    n characters following '-'. (1.1)
161
199
  <TR><TD>F s n -<I>c<sub>1</sub>c<sub>2</sub>...c<sub>n</sub><I>
162
200
    <TD>Set font. The font size is s points. The font name consists of the
163
 
    n characters following '-'.
 
201
    n characters following '-'. (1.1)
164
202
  <TR><TD>S n -<I>c<sub>1</sub>c<sub>2</sub>...c<sub>n</sub><I>
165
203
    <TD>Set style attribute. The style value consists of the
166
204
    n characters following '-'. The syntax of the value is the same as
167
 
    specified for a <B>styleItem</B> in <A HREF=attrs.html#k:style>style</A>.
 
205
    specified for a <B>styleItem</B> in <A HREF=attrs.html#k:style>style</A>. (1.1)
 
206
  <TR><TD>I x y w h n -<I>c<sub>1</sub>c<sub>2</sub>...c<sub>n</sub><I>
 
207
    <TD>Externally-specified image drawn in the box with lower left
 
208
    corner (x,y) and upper right corner (x+w,y+h). The name of the image
 
209
    consists of the n characters following '-'. This is usually a bitmap 
 
210
    image. Note that the image size, even when converted from pixels to
 
211
    points, might be different from the required size (w,h). It is 
 
212
    assumed the renderer will perform the necessary scaling. (1.2)
168
213
  </TABLE>
169
214
  <SPACER TYPE=VERTICAL size=10>
170
215
  In handling alignment, the application may want to recompute the
181
226
  All coordinates and sizes are in points.
182
227
  Note though that if
183
228
  an edge or node is invisible, no drawing operations are attached to it.
 
229
  <P>
 
230
  Version info:
 
231
  <TABLE  border >
 
232
  <TR><TH>Xdot version</TH><TH>Graphviz version</TH></TR>
 
233
  <TR><TD>1.0</TD><TD>1.9</TD></TR>
 
234
  <TR><TD>1.1</TD><TD>2.8</TD></TR>
 
235
  <TR><TD>1.2</TD><TD>2.13</TD></TR>
 
236
  </TABLE>
184
237
 
185
238
<DT><A NAME=d:cmap HREF=#a:cmap><STRONG>cmap</STRONG></A>
186
239
<DD>  Produces map files for client-side image maps. The cmap format is
202
255
<DT><A NAME=d:gif HREF=#a:gif><STRONG>gif</STRONG></A>
203
256
<DD>  Outputs GIF bitmap images.
204
257
 
 
258
<DT><A NAME=d:gtk HREF=#a:gtk><STRONG>gtk</STRONG></A>
 
259
<DD>  Creates a <A HREF="http://www.gtk.org/">GTK</A> window and displays the output there.
 
260
 
205
261
<DT><A NAME=d:hpgl HREF=#a:hpgl><STRONG>hpgl</STRONG></A>
206
262
<DD>  Produces output in the HP-GL/2 vector graphic printer language.
207
263
 
 
264
<DT><A NAME=d:ico HREF=#a:ico><STRONG>ico</STRONG></A>
 
265
<DD>  Outputs images in the Windows <A HREF="http://en.wikipedia.org/wiki/ICO_(icon_image_file_format)">ICO format</A>.
 
266
 
208
267
<DT><A NAME=d:imap HREF=#a:imap><STRONG>imap</STRONG></A>
209
268
,<DT><A NAME=d:cmapx HREF=#a:cmapx><STRONG>cmapx</STRONG></A>
210
269
<DD>  Produces map files for server-side and client-side image maps,
261
320
  The analogous result holds for the tailURL and the
262
321
  <A HREF=attrs.html#d:taillabel>taillabel</A>.
263
322
 
 
323
<DT><A NAME=d:imap_np HREF=#a:imap_np><STRONG>imap_np</STRONG></A>
 
324
,<DT><A NAME=d:cmapx_np HREF=#a:cmapx_np><STRONG>cmapx_np</STRONG></A>
 
325
<DD>  These are identical to the imap and cmapx formats, except they
 
326
  rely solely on rectangles as active areas.
 
327
 
264
328
<DT><A NAME=d:ismap HREF=#a:ismap><STRONG>ismap</STRONG></A>
265
329
<DD>  Produces HTML image map files. This is a predecessor (circa 1994)
266
330
  of the IMAP format.  Most servers now use the latter.
274
338
 
275
339
<DT><A NAME=d:jpg HREF=#a:jpg><STRONG>jpg</STRONG></A>
276
340
,<DT><A NAME=d:jpeg HREF=#a:jpeg><STRONG>jpeg</STRONG></A>
 
341
,<DT><A NAME=d:jpe HREF=#a:jpe><STRONG>jpe</STRONG></A>
277
342
<DD>  Output JPEG compressed image files.
278
 
  This format relies on the installation having the JPEG library.
279
343
 
280
344
<DT><A NAME=d:mif HREF=#a:mif><STRONG>mif</STRONG></A>
281
345
<DD>  Generates Frame Maker MIF files.
289
353
  PCL, so that PCL output is the same as HP-GL, wrapped with some initial
290
354
  and final commands to set the printer to and from HP-GL mode.
291
355
 
 
356
<DT><A NAME=d:pdf HREF=#a:pdf><STRONG>pdf</STRONG></A>
 
357
<DD>  Produces <A HREF="http://www.adobe.com/devnet/pdf/">PDF</A> output.
 
358
  Alternatively, one can use the <A HREF="#d:ps2">ps2</A> to produce PDF-compatible
 
359
  PostScript, and then use a ps-to-pdf converter.
 
360
 
292
361
<DT><A NAME=d:pic HREF=#a:pic><STRONG>pic</STRONG></A>
293
362
<DD>  Outputs in PIC, the picture description language in the troff-family
294
363
 
382
451
 
383
452
<DT><A NAME=d:png HREF=#a:png><STRONG>png</STRONG></A>
384
453
<DD>   Produces output in the PNG (Portable Network Graphics) format.
385
 
   PNG relies on having libz and the PNG library.
386
454
 
387
455
<DT><A NAME=d:ps HREF=#a:ps><STRONG>ps</STRONG></A>
388
456
<DD>  Produces PostScript output.
403
471
,<DT><A NAME=d:svgz HREF=#a:svgz><STRONG>svgz</STRONG></A>
404
472
<DD>  Produce <A HREF="http://www.adobe.com/svg/">SVG</A> output, 
405
473
  the latter in compressed format.
406
 
  SVG relies on having libz.
 
474
 
 
475
<DT><A NAME=d:tga HREF=#a:tga><STRONG>tga</STRONG></A>
 
476
<DD>  Produces <A HREF="http://en.wikipedia.org/wiki/Truevision_TGA">Targa</A> output.
 
477
 
 
478
<DT><A NAME=d:tif HREF=#a:tif><STRONG>tif</STRONG></A>
 
479
,<DT><A NAME=d:tiff HREF=#a:tiff><STRONG>tiff</STRONG></A>
 
480
<DD>  Produces <A HREF="http://www.libtiff.org/">TIFF</A> output.
 
481
 
 
482
<DT><A NAME=d:vml HREF=#a:vml><STRONG>vml</STRONG></A>
 
483
,<DT><A NAME=d:vmlz HREF=#a:vmlz><STRONG>vmlz</STRONG></A>
 
484
<DD>  Produces <A HREF="http://www.w3.org/TR/NOTE-VML/">VML</A> output,
 
485
  the latter in compressed format.
407
486
 
408
487
<DT><A NAME=d:vrml HREF=#a:vrml><STRONG>vrml</STRONG></A>
409
488
<DD>  Outputs graphs in the <A HREF="http://www.vrml.org/">VRML</A> format.
426
505
<DD>  Produces output in the Wireless BitMap (WBMP) format, optimized for
427
506
  mobile computing.
428
507
 
 
508
<DT><A NAME=d:xlib HREF=#a:xlib><STRONG>xlib</STRONG></A>
 
509
<DD>  Creates an <A HREF="http://en.wikipedia.org/wiki/Xlib">Xlib</A> window and displays the output there.
 
510
 
429
511
</DL>
430
512
<HR>
431
513
</BODY>