summary refs log tree commit diff
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2021-06-09 00:31:09 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2021-06-09 00:31:09 +0000
commit2c3fbc4db1aca945072feadb09436cd198e87999 (patch)
treed928a6b5132b393300ffbcc9009d2310625719c8
parentb57c8fbc154ae710da72e2e5240e9e90148166e0 (diff)
downloadnetpbm-mirror-2c3fbc4db1aca945072feadb09436cd198e87999.tar.gz
netpbm-mirror-2c3fbc4db1aca945072feadb09436cd198e87999.tar.xz
netpbm-mirror-2c3fbc4db1aca945072feadb09436cd198e87999.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4114 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r--pamstack.html2
-rw-r--r--pamtogif.html27
2 files changed, 22 insertions, 7 deletions
diff --git a/pamstack.html b/pamstack.html
index 52bef06a..df2708d3 100644
--- a/pamstack.html
+++ b/pamstack.html
@@ -27,6 +27,8 @@ its value with a space instead of <b>=</b>.
 produces a PAM image as output, consisting of all the planes
 (channels) of the inputs, stacked in the order specified.
 
+<p>It can also just change the tuple type of a single PAM image.
+  
 <p>For any one (but not more) of the input files, you may specify
 "-" to mean Standard Input.  If you specify no arguments at all,
 the input is one file: Standard Input.
diff --git a/pamtogif.html b/pamtogif.html
index 6d720817..1c1f0ac7 100644
--- a/pamtogif.html
+++ b/pamtogif.html
@@ -2,7 +2,7 @@
 <html><head><title>Pamtogif User Manual</title></head>
 <body>
 <h1>pamtogif</h1>
-Updated: 05 June 2021
+Updated: 09 June 2021
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -56,11 +56,14 @@ multiple GIF images into an animated GIF, use <a
 href="http://www.lcdf.org/gifsicle/"><b>gifsicle</b></a> (not part of
 the Netpbm package).
 
-<p><b>pamtogif</b> creates either an original GIF87 format GIF file or
-the newer GIF89 format.  It creates GIF89 when you request features
-that were new with GIF89, to wit the <b>-transparent</b> or
-<b>-comment</b> options.  Otherwise, it creates GIF87.  Really old GIF
-readers conceivably could not recognize GIF89.
+<p><b>pamtogif</b> creates either an original GIF87 format GIF file or the
+  newer GIF89 format.  It creates GIF89 when the output needs to have features
+  that were new with GIF89, to wit transparency or comments.  Otherwise, it
+  creates GIF87.  Really old GIF readers conceivably could not recognize
+  GIF89.  The output needs to have transparency when either the input has a
+  transparency information or you specify the <b>-transparent</b> option.  It
+  needs to have comments when you specify the
+  <b>-comment</b> option.
 
 <p><b>pamtogif</b> generates a GIF image with a single image block, which
 means the image cannot have more than 256 colors in it (it contains a single
@@ -69,12 +72,22 @@ more colors than that (<b>ppmhist</b> can tell you), you can
 use <b>pnmquant</b> to reduce it to 256.  Or use the more complex but faster
 method described under the <b>-mapfile</b> option.
 
-<p>If your input image is a PAM with transparency information, <b>ppmtogif</b>
+<p>If your input image is a PAM with transparency information, <b>pamtogif</b>
 uses one entry in the GIF colormap specifically for the transparent pixels,
 so you can have at most 255 opaque colors.  In contrast, if you use the
 <b>-transparent</b> option, one of the colors from the input becomes
 transparent, so the limit is still 256.
 
+<p><b>pamtogif</b> recognizes transparency information in the input by the
+  tuple type being <b>RGB_ALPHA</b>, <B>GRAYSCALE_ALPHA</B>, or
+  <b>BLACKANDWHITE_ALPHA</b>.  This is the case for any image that has
+  transparency information and was created by a Netpbm program that
+  manipulates visual images.  If, on the other hand, you have a PAM generated
+  some other way, but you know the planes have the same meaning as implied by
+  these tuple types, you can make <b>pamtogif</b> process the transparency
+  information by changing the tuple type accordingly before you pass it
+  to <b>pamtogif</b>.  You can use <b>pamstack</b> to change the tuple type.
+
 <p><b>pamtogif</b> was new in Netpbm 10.37 (December 2006).  In older Netpbm,
 use <b>ppmtogif</b>.