{
    "mode": "man",
    "parameter": "infotopam",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/infotopam/1/json",
    "generated": "2026-08-31T12:48:09Z",
    "synopsis": "infotopam [-forcecolor] [-numcolors numcolors] [-selected] [index color ...]  [filename]\nMinimum  unique  abbreviation of option is acceptable.  You may use double hyphens instead of\nsingle hyphen to denote options.  You may use white space in place of the equals sign to sep‐\narate an option name from its value.",
    "sections": {
        "NAME": {
            "content": "infotopam - convert Amiga .info icons to PAM\n\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "infotopam [-forcecolor] [-numcolors numcolors] [-selected] [index color ...]  [filename]\n\nMinimum  unique  abbreviation of option is acceptable.  You may use double hyphens instead of\nsingle hyphen to denote options.  You may use white space in place of the equals sign to sep‐\narate an option name from its value.\n\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "By default, infotopam converts the first icon in a .info file:\n\ninfotopam amiga.info > amiga.first.pam\n\n\nUse the -selected option to convert the second icon in a .info file.   Here  infotopam  reads\nfrom Standard Input:\n\ninfotopam -selected < amiga.info > amiga.second.pam\n\n\nUse the -forcecolor option to force color conversion for a 1 bit-plane .info file:\n\ninfotopam -forcecolor bw.info > bw.pam\n\n\nUse  -numcolors  to  override colors for indexes 0 and 3.  Notice the two ways to specify the\ncolor:\n\ninfotopam -numcolors 2 0 green 3 #FF0000 icon.info > icon.pam\n\n\nSince Amiga monitors do not use square pixels, some icons may appear squished.  Filtering the\noutput through pamscale can fix this:\n\ninfotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm\n\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "This program is part of Netpbm(1).\n\ninfotopam converts an Amiga .info (icon) file to a PAM image.  infotopam reads a  .info  file\nfrom  filename, or from Standard Input if you do not specify a file name, and writes the con‐\nverted PAM image to Standard Output.\n\ninfotopam currently handles 1 and 2 bit-plane icons.  If the .info icon only has 1 bit-plane,\ninfotopam generates a bitmap (black&white) PAM image; otherwise it generates a color PAM  im‐\nage.   You can force infotopam to convert 1 bit-plane images to color PAM images by using the\n-forcecolor option.\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "In addition to the options common to all programs based on libnetpbm  (most  notably  -quiet,\nsee \u001b]8;;index.html#commonoptions\u001b\\ Common Options\u001b]8;;\u001b\\ ), infotopam recognizes the following command line options:\n\n\n",
            "subsections": [
                {
                    "name": "-forcecolor",
                    "content": "Forces infotopam to convert 1 bit-plane icons to color PAM\nimages instead of bitmap PAM images.  infotopam uses the index 2\ncolor for black and the index 1 color for white (more on this\nbelow).\n\n"
                },
                {
                    "name": "-numcolors _",
                    "content": "Tells infotopam how many colors to override.  Pixels in the\nAmiga .info files are assigned an index value rather than a specific color.\nThe standard colors for a 2 bit-plane icon are:\n\nIndex 0:  Blue   (00, 55, AA)\nIndex 1:  White  (FF, FF, FF)\nIndex 2:  Black  (00, 00, 20)\nIndex 3:  Orange (FF, 8A, 00)\n\n\nTo override the colors, first specify how many colors to override using\n-numcolors, then specify an (index color) pair for each color\nyou want to override, where index is a value from 0 to 3 and\ncolor the new color for that index.  Specify color as\ndescribed for the \u001b]8;;libnetpbmimage.html#colorname\u001b\\pnmparsecolor()   argument\u001b]8;;\u001b\\ .\n\n"
                },
                {
                    "name": "-selected",
                    "content": "Tells infotopam to convert the selected (second) icon instead of\nthe normal (first) icon.  Each Amiga .info icon file contains two icon\nimages.  The first image is the normal, unselected icon, and the second\nimage is the selected icon.  By default infotopam converts the first\nicon.  You can tell infotopam to convert the second icon by using the\n-selected option.\n\n\n\nAll options can be abbreviated to their shortest unique prefix.\n\n"
                }
            ]
        },
        "SEE ALSO": {
            "content": "pam(1) pamtopnm(1) pamscale(1)\n\n\n",
            "subsections": []
        },
        "NOTES": {
            "content": "Thanks to the following people on comp.sys.amiga.programmer for tips and pointers on decoding\nthe info file format:\n\n\n\n•      Ben Hutchings\n\n•      Thomas Richter\n\n•      Kjetil Svalastog Matheussen\n\n•      Anders Melchiorsen\n\n•      Dirk Stoecker\n\n•      Ronald V.D.\n\n\nThe format of the Amiga .info file is as follows:\n\nDiskObject header            78 bytes\nOptional DrawerData header   56 bytes\nFirst icon header            20 bytes\nFirst icon data              Varies\nSecond icon header           20 bytes\nSecond icon data             Varies\n\n\nThe  DiskObject  header  contains,  among other things, the magic number (0xE310), the object\nwidth and height (inside the embedded Gadget header), and the version.\n\nEach icon header contains the icon width and height, which can be  smaller  than  the  object\nwidth and height, and the number of bit-planes.\n\nThe icon data has the following format:\n\n\n\nBIT-PLANE planes, each with HEIGHT rows of (WIDTH\n+15) / 16 * 2 bytes length.\n\nSo if you have a 9x3x2 icon, the icon data will look like this:\n\naaaa aaaa a000 0000\naaaa aaaa a000 0000\naaaa aaaa a000 0000\nbbbb bbbb b000 0000\nbbbb bbbb b000 0000\nbbbb bbbb b000 0000\n\n\nwhere  a  is  a  bit  for  the first bit-plane, b is a bit for the second bit-plane, and 0 is\npadding.  Thanks again to Ben Hutchings for his very helpful post!\n\n",
            "subsections": []
        },
        "HISTORY": {
            "content": "infotopam was new in Netpbm 10.22 (April 2004).\n\n",
            "subsections": []
        },
        "LIMITATIONS": {
            "content": "infotopam currently only handles 1 and 2 bit-plane icons.\n\nThere is no pamtoinfo command, since the .info files contain a lot more than just icon  data,\nand mapping the colors would be difficult.\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Copyright (C) 2000, 2004 by Richard Griswold.\n",
            "subsections": []
        },
        "DOCUMENT SOURCE": {
            "content": "This  manual  page  was  generated by the Netpbm tool 'makeman' from HTML source.  The master\ndocumentation is at\n\nhttp://netpbm.sourceforge.net/doc/infotopam.html\n\nnetpbm documentation                        07 April 2004                   Infotopam User Manual(1)",
            "subsections": []
        }
    },
    "summary": "infotopam - convert Amiga .info icons to PAM",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "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)."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "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 \u001b]8;;libnetpbmimage.html#colorname\u001b\\pnmparsecolor() argument\u001b]8;;\u001b\\ ."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "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. All options can be abbreviated to their shortest unique prefix."
        }
    ],
    "examples": [
        "By default, infotopam converts the first icon in a .info file:",
        "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:",
        "infotopam -selected < amiga.info > amiga.second.pam",
        "Use the -forcecolor option to force color conversion for a 1 bit-plane .info file:",
        "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",
        "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"
    ],
    "see_also": [
        {
            "name": "pam",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pam/1/json"
        },
        {
            "name": "pamtopnm",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pamtopnm/1/json"
        },
        {
            "name": "pamscale",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pamscale/1/json"
        }
    ]
}