summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/pamtohtmltbl.1
blob: b558374c708c82af380abd3caf2e969503d53624 (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
91
92
93
94
95
96
97
98
99
100
101
102
103
\
.\" 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 "Pamtohtmltbl User Manual" 0 "13 October 2008" "netpbm documentation"

.SH NAME
pamtohtmltbl - convert pnm/pam visual image to an HTML table

.UN synopsis
.SH SYNOPSIS

\fBpamtohtmltbl\fP
[\fB-transparent=\fP\fIcolor\fP]
[\fB-verbose\fP]
[\fIfile\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
\fBpamtohtmltbl\fP converts a visual image to an HTML table with one
cell per pixel.  The cell is empty, but its background color is that of the
pixel.
.PP
\fIfile\fP is a PBM, PGM, PPM, or PAM file.  If PAM, it must be
a standard visual image of tuple type RGB, GRAYSCALE, or BLACKANDWHITE, or
something equivalent with extra higher numbered channels, but
\fBpamtohtmltbl\fP doesn't check the tuple type; it just assumes.
.PP
Note that the more normal way to include a visual image in an HTML
document is with a <IMG> tag.
.PP
Not all web browsers render tables as \fBpamtohtmltbl\fP expects,
and therefore show a grossly distorted image.  Internet Explorer 7 on
Windows and Opera 9.02 on Windows have been seen to work; Firefox
2.0.0.16 on the same Windows system has been seen not to.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpamtohtmltbl\fP recognizes the following
command line options:


.TP
\fB-transparent=\fP\fIcolor\fP
This option indicates that pixels of the specified color are to be transparent
in the HTML table.  The table cell for a pixel of this color will have no
background color specified.
.sp
Specify the color (\fIcolor\fP) as described for the 
.UR libnetpbm_image.html#colorname
argument of the \fBpnm_parsecolor()\fP library routine
.UE
\&.


.TP
\fB-verbose\fP
This option causes \fBpamtohtmltbl\fP to display messages about the
conversion process.
     
.UN seealso
.SH SEE ALSO
.BR "pnm" (5)\c
\&
.BR "pam" (5)\c
\&

.UN history
.SH HISTORY
.sp
\fBpamtohtmltbl\fP was new in Netpbm 10.15 (April 2003).


.UN authors
.SH AUTHORS
.PP
Alexander B. Ivanov (SSH) wrote a program he called
\fBpnm2html\fP.  Bryan Henderson adapted it to use the Netpbm
libraries and handle PAM images and follow Netpbm conventions, and
named it \fBpamtohtmltbl\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/pamtohtmltbl.html
.PP