summary refs log tree commit diff
path: root/pamtohtmltbl.html
blob: 7e540dcfdbeb14cdaa71ccf7be612566dae84932 (plain) (blame)
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pamtohtmltbl User Manual</title></head>
<body>
<h1>pamtohtmltbl</h1>
Updated: 13 October 2008
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>
pamtohtmltbl - convert pnm/pam visual image to an HTML table

<h2 id="synopsis">SYNOPSIS</h2>

<b>pamtohtmltbl</b>
[<b>-transparent=</b><i>color</i>]
[<b>-verbose</b>]
[<i>file</i>]

<p>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.

<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>pamtohtmltbl</b> 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.

<p><i>file</i> 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
<b>pamtohtmltbl</b> doesn't check the tuple type; it just assumes.

<p>Note that the more normal way to include a visual image in an HTML
document is with a &lt;IMG&gt; tag.

<p>Not all web browsers render tables as <b>pamtohtmltbl</b> 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.

<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>pamtohtmltbl</b> recognizes the following
command line options:

<dl compact>
<dt><b>-transparent=</b><i>color</i>

<dd>
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.

<p>Specify the color (<i>color</i>) as described for the <a
href="libnetpbm_image.html#colorname">argument of the <b>pnm_parsecolor()</b>
library routine</a>.


<dt><b>-verbose</b>

<dd>This option causes <b>pamtohtmltbl</b> to display messages about the
conversion process.
     
<h2 id="seealso">SEE ALSO</h2>

<b><a href="pnm.html">pnm</a></b>
<b><a href="pam.html">pam</a></b>

<h2 id="history">HISTORY</h2>

<p><b>pamtohtmltbl</b> was new in Netpbm 10.15 (April 2003).
</dl>

<h2 id="authors">AUTHORS</h2>

<p>Alexander B. Ivanov (SSH) wrote a program he called
<b>pnm2html</b>.  Bryan Henderson adapted it to use the Netpbm
libraries and handle PAM images and follow Netpbm conventions, and
named it <b>pamtohtmltbl</b>.

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#history">HISTORY</a>
<li><a href="#authors">AUTHORS</a>
</ul>
</body>
</html>