Debian Codegraph @

upstream/debian-unstable/man1/pamtohtmltbl.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 "Pamtohtmltbl User Manual" 1 "13 October 2008" "netpbm documentation"
7
8 .SH NAME
9 pamtohtmltbl - convert pnm/pam visual image to an HTML table
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamtohtmltbl\fP
15 [\fB-transparent=\fP\fIcolor\fP]
16 [\fB-verbose\fP]
17 [\fIfile\fP]
18 .PP
19 Minimum unique abbreviation of option is acceptable. You may use
20 double hyphens instead of single hyphen to denote options. You may use
21 white space in place of the equals sign to separate an option name
22 from its value.
23
24 .UN description
25 .SH DESCRIPTION
26 .PP
27 This program is part of
28 .BR "Netpbm" (1)\c
29 \&.
30 .PP
31 \fBpamtohtmltbl\fP converts a visual image to an HTML table with one
32 cell per pixel. The cell is empty, but its background color is that of the
33 pixel.
34 .PP
35 \fIfile\fP is a PBM, PGM, PPM, or PAM file. If PAM, it must be
36 a standard visual image of tuple type RGB, GRAYSCALE, or BLACKANDWHITE, or
37 something equivalent with extra higher numbered channels, but
38 \fBpamtohtmltbl\fP doesn't check the tuple type; it just assumes.
39 .PP
40 Note that the more normal way to include a visual image in an HTML
41 document is with a <IMG> tag.
42 .PP
43 Not all web browsers render tables as \fBpamtohtmltbl\fP expects,
44 and therefore show a grossly distorted image. Internet Explorer 7 on
45 Windows and Opera 9.02 on Windows have been seen to work; Firefox
46 2.0.0.16 on the same Windows system has been seen not to.
47
48 .UN options
49 .SH OPTIONS
50 .PP
51 In addition to the options common to all programs based on libnetpbm
52 (most notably \fB-quiet\fP, see
53 .UR index.html#commonoptions
54 Common Options
55 .UE
56 \&), \fBpamtohtmltbl\fP recognizes the following
57 command line options:
58
59
60 .TP
61 \fB-transparent=\fP\fIcolor\fP
62 This option indicates that pixels of the specified color are to be transparent
63 in the HTML table. The table cell for a pixel of this color will have no
64 background color specified.
65 .sp
66 Specify the color (\fIcolor\fP) as described for the
67 .UR libnetpbm_image.html#colorname
68 argument of the \fBpnm_parsecolor()\fP library routine
69 .UE
70 \&.
71
72
73 .TP
74 \fB-verbose\fP
75 This option causes \fBpamtohtmltbl\fP to display messages about the
76 conversion process.
77
78 .UN seealso
79 .SH SEE ALSO
80 .BR "pnm" (1)\c
81 \&
82 .BR "pam" (1)\c
83 \&
84
85 .UN history
86 .SH HISTORY
87 .sp
88 \fBpamtohtmltbl\fP was new in Netpbm 10.15 (April 2003).
89
90
91 .UN authors
92 .SH AUTHORS
93 .PP
94 Alexander B. Ivanov (SSH) wrote a program he called
95 \fBpnm2html\fP. Bryan Henderson adapted it to use the Netpbm
96 libraries and handle PAM images and follow Netpbm conventions, and
97 named it \fBpamtohtmltbl\fP.
98 .SH DOCUMENT SOURCE
99 This manual page was generated by the Netpbm tool 'makeman' from HTML
100 source. The master documentation is at
101 .IP
102 .B http://netpbm.sourceforge.net/doc/pamtohtmltbl.html
103 .PP