From 8b53a479bb0306cebd3ec862b66891b3a1759fea Mon Sep 17 00:00:00 2001 From: giraffedata Date: Fri, 22 Mar 2024 16:51:28 +0000 Subject: miscellaneous update git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4886 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- infotopam.html | 140 ++++++++++++++++++++++++++++----------------------- libnetpbm_image.html | 4 +- 2 files changed, 79 insertions(+), 65 deletions(-) diff --git a/infotopam.html b/infotopam.html index d254eed1..e52b757a 100644 --- a/infotopam.html +++ b/infotopam.html @@ -2,7 +2,7 @@ Infotopam User Manual

infotopam

-Updated: 07 April 2004 +Updated: 22 March 2024
Table Of Contents @@ -16,7 +16,8 @@ infotopam - convert Amiga .info icons to PAM [-forcecolor] [-numcolors numcolors] [-selected] -[index color ...] +[-verbose] +[index color ...] [filename] @@ -26,98 +27,111 @@ place of the equals sign to separate an option name from its value.

EXAMPLES

By default, infotopam converts the first icon in a .info file: -

-    infotopam amiga.info > amiga.first.pam
+  
+    $ infotopam amiga.info > amiga.first.pam
+

Use the -selected option to convert the second icon in a .info -file. Here infotopam reads from Standard Input: +

Use the -selected option to convert the "selected" version +of the icon rather than the regular version. Here infotopam reads from +Standard Input:

+  
     infotopam -selected < amiga.info > amiga.second.pam
+

Use the -forcecolor option to force color conversion for a 1 -bit-plane .info file: +

Use -numcolors to change the colors.

-    infotopam -forcecolor bw.info > bw.pam
-

- -

Use -numcolors to override colors for indexes 0 and 3. Notice the -two ways to specify the color: - -

-    infotopam -numcolors 2 0 green 3 #FF0000 icon.info > icon.pam
+  
+    infotopam -numcolors 2 0 green 3 rgb:FF/00/00 icon.info > icon.pam
+

Since Amiga monitors do not use square pixels, some icons may appear squished. Filtering the output through pamscale can fix this:

-     infotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm
+  
+    $ infotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm
+

DESCRIPTION

This program is part of Netpbm. -

infotopam converts an Amiga .info (icon) file to a PAM image. +

infotopam converts an Amiga .info (icon) image to a PAM image. infotopam reads a .info file from filename, or from Standard Input if you do not specify a file name, and writes the converted PAM image to Standard Output. -

infotopam currently handles 1 and 2 bit-plane icons. If the .info -icon only has 1 bit-plane, infotopam generates a bitmap -(black&white) PAM image; otherwise it generates a color PAM image. You -can force infotopam to convert 1 bit-plane images to color PAM images by -using the -forcecolor option. +

infotopam handles 1- and 2 bit-plane icons. If the .info icon has +only 1 bit-plane, infotopam generates a black and white PAM image; +otherwise it generates a color PAM image. In the latter case, you can choose +the colors or keep the original Amiga standard colors. You can +force infotopam to produce a color PAM with 1 bit-plane input with +a -forcecolor option. +

OPTIONS

In addition to the options common to all programs based on libnetpbm -(most notably -quiet, see -Common Options), infotopam recognizes the following -command line options: +

In addition to the options common to all programs based on libnetpbm (most +notably -quiet, see Common +Options), infotopam recognizes the following command line options:

-forcecolor

Forces infotopam to convert 1 bit-plane icons to color PAM - images instead of bitmap PAM images. infotopam uses the index 2 - color for black and the index 1 color for white (more on this - below).

-numcolors numcolors

Tells infotopam how many colors to override. Pixels in the - Amiga .info files are assigned an index value rather than a specific color. - The standard colors for a 2 bit-plane icon are: - -

-    Index 0:  Blue   (00, 55, AA)
-    Index 1:  White  (FF, FF, FF)
-    Index 2:  Black  (00, 00, 20)
-    Index 3:  Orange (FF, 8A, 00)
-

- -

To override the colors, first specify how many colors to override using - -numcolors, then specify an (index color) pair for each color - you want to override, where index is a value from 0 to 3 and - color the new color for that index. Specify color as - described for the pnm_parsecolor() - argument.

-selected

Tells infotopam to convert the selected (second) icon instead of - the normal (first) icon. Each Amiga .info icon file contains two icon - images. The first image is the normal, unselected icon, and the second - image is the selected icon. By default infotopam converts the first - icon. You can tell infotopam to convert the second icon by using the - -selected option.

-numcolors numcolors

This causes the program to change the colors in the conversion. A + 2-bit-plane Amiga .icon image has four colors, numbered 0 through 3. + Those colors are as follows. + +

0 +: Blue (00, 55, AA) +
1 +: White (FF, FF, FF) +
2 +: Black (00, 00, 20) +
3 +: Orange (FF, 8A, 00) +

+ +

To specify the changes, specify the number of colors you are changing + as the argument of -numcolors and for each color, specify a pair + of command line arguments, the first being the color index 0 through 3 + and the second being the color to substitute. Specify the color + (color) as described for the + argument of the + pnm_parsecolor() library routine. + +

These arguments go before the input file name argument, + if any. This is an unusual syntax for a Netpbm program. + +

-selected

An Amiga .info image contains two versions of the icon: one for + regular display and one to display when the thing represented by + the icon is selected. By default, infotopam converts the + regular icon, but this option causes it to convert the selected icon + instead. + +

-forcecolor

This causes infotopam to convert 1 bit-plane icons to color + PAM images instead of black and white. The colors are the index 2 + color for black and the index 1 color for white. + +

-verbose

This causes infotopam to issue informational messages about + the conversion process. + +

This option was new in Netpbm 11.06 (March 2024).

diff --git a/libnetpbm_image.html b/libnetpbm_image.html index 5aa9bb91..8023a940 100644 --- a/libnetpbm_image.html +++ b/libnetpbm_image.html @@ -752,8 +752,8 @@ intensity. where r, g, and b are floating point numbers from 0 to 1. Example: rgbi:1.0/0.5/.25. -

rgb-maxval:r/g/b, where r, g, and b are integers from 0 to -maxval. Example: +

rgb-maxval:r/g/b, where r, g, and b are decimal integers +from 0 to maxval. Example: rgb-255:255/128/64. maxval can be from 1 to 65535.

This format was new in Netpbm 10.83 (June 2018). -- cgit 1.4.1