Debian Codegraph @

upstream/debian-unstable/man1/svgtopam.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Svgtopam User Manual" 1 "28 June 2017" "netpbm documentation"
7
8 .SH NAME
9 svgtopam - convert an SVG (Scalable Vector Graphics) image to Netpbm format
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBsvgtopam\fP
15 [\fB-trace\fP]
16 [\fIpnmfile\fP]
17 .PP
18 Minimum unique abbreviation of option is acceptable. You may use
19 double hyphens instead of single hyphen to denote options. You may use
20 white space in place of the equals sign to separate an option name
21 from its value.
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBsvgtopam\fP reads an SVG (Scalable Vector Graphics) image as input and
31 produces a PAM image as output.
32 .PP
33 \fBsvgtopam\fP is so weak that it is probably not useful in general for
34 converting SVG images. It understands only <path> SVG elements which
35 use only the "M", "L", and "z" commands, and only those that use whole number
36 arguments. This is sufficient for converting most of what comes out of
37 \fBpamtosvg\fP (not by coincidence - the program was developed for the
38 specific task of testing \fBpamtosvg\fP), but the main reason it is part of
39 Netpbm is to provide a base for someone to create a full SVG to Netpbm
40 converter.
41 .PP
42 SVG is a vector image format, which means it describes curves that
43 compose an image. By contrast, PNM is a raster format, which means it
44 describes dots that compose an image. The main practical difference
45 between the two types is that you can scale vector images better. A
46 vector image also takes a lot less data to describe an image if the
47 image is composed of simple curves.
48 .PP
49 That means it is really an understatement to say that \fBsvgtopam\fP
50 is an image format converter. It's really an image drawer, not unlike
51 \fBppmdraw\fP.
52 .PP
53 For more information on SVG, see
54 .UR http://www.w3.org/Graphics/SVG/
55 the Worldwide Web Consortium's SVG web page
56 .UE
57 \&.
58
59
60 .UN options
61 .SH OPTIONS
62 .PP
63 In addition to the options common to all programs based on libnetpbm
64 (most notably \fB-quiet\fP, see
65 .UR index.html#commonoptions
66 Common Options
67 .UE
68 \&), \fBsvgtopam\fP recognizes the following
69 command line option:
70
71
72
73 .TP
74 \fB-trace\fP
75 This option makes \fBsvgtopam\fP issue messages describing the drawing.
76
77
78
79
80 .UN seealso
81 .SH SEE ALSO
82 .BR "pamtosvg" (1)\c
83 \&,
84 .BR "pam" (1)\c
85 \&,
86
87 .UN history
88 .SH HISTORY
89 .PP
90 \fBsvgtopam\fP was added to Netpbm in Version 10.34 (May 2006).
91 .PP
92 Bryan Henderson created \fBsvgtopam\fP to test \fBpamtosvg\fP.
93 .SH DOCUMENT SOURCE
94 This manual page was generated by the Netpbm tool 'makeman' from HTML
95 source. The master documentation is at
96 .IP
97 .B http://netpbm.sourceforge.net/doc/svgtopam.html
98 .PP