summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/svgtopam.1
blob: 14dd793e495c8880baf6f7d8c4122295abeaad4f (plain)
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
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Svgtopam User Manual" 0 "28 June 2017" "netpbm documentation"

.SH NAME
svgtopam - convert an SVG (Scalable Vector Graphics) image to Netpbm format

.UN synopsis
.SH SYNOPSIS

\fBsvgtopam\fP
[\fB-trace\fP]
[\fIpnmfile\fP]
.PP
Minimum unique abbreviation of option is acceptable.  You may use
double hyphens instead of single hyphen to denote options.  You may use
white space in place of the equals sign to separate an option name
from its value.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBsvgtopam\fP reads an SVG (Scalable Vector Graphics) image as input and
produces a PAM image as output.
.PP
\fBsvgtopam\fP is so weak that it is probably not useful in general for
converting SVG images.  It understands only <path> SVG elements which
use only the "M", "L", and "z" commands, and only those that use whole number
arguments.  This is sufficient for converting most of what comes out of
\fBpamtosvg\fP (not by coincidence - the program was developed for the
specific task of testing \fBpamtosvg\fP), but the main reason it is part of
Netpbm is to provide a base for someone to create a full SVG to Netpbm
converter.
.PP
SVG is a vector image format, which means it describes curves that
compose an image.  By contrast, PNM is a raster format, which means it
describes dots that compose an image.  The main practical difference
between the two types is that you can scale vector images better.  A
vector image also takes a lot less data to describe an image if the
image is composed of simple curves.
.PP
That means it is really an understatement to say that \fBsvgtopam\fP
is an image format converter.  It's really an image drawer, not unlike
\fBppmdraw\fP.
.PP
For more information on SVG, see 
.UR http://www.w3.org/Graphics/SVG/
the Worldwide Web Consortium's SVG web page
.UE
\&.


.UN options
.SH OPTIONS



.TP
\fB-trace\fP
This option makes \fBsvgtopam\fP issue messages describing the drawing.




.UN seealso
.SH SEE ALSO
.BR "pamtosvg" (1)\c
\&,
.BR "pam" (5)\c
\&,

.UN history
.SH HISTORY
.PP
\fBsvgtopam\fP was added to Netpbm in Version 10.34 (May 2006).
.PP
Bryan Henderson created \fBsvgtopam\fP to test \fBpamtosvg\fP.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/svgtopam.html
.PP