{
    "mode": "man",
    "parameter": "ilbmtoppm",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/ilbmtoppm/1/json",
    "generated": "2026-09-02T16:20:17Z",
    "synopsis": "ilbmtoppm [-ignore<chunkID>] [ -isham | -isnotham | -isehb | -isnotehb | -isdeep | -isnotdeep\n] [-cmaponly] [-adjustcolors] [-transparent color] [-maskfile filename [-verbose] [ILBMfile]",
    "sections": {
        "NAME": {
            "content": "ilbmtoppm - convert an ILBM file into a PPM image\n\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "ilbmtoppm [-ignore<chunkID>] [ -isham | -isnotham | -isehb | -isnotehb | -isdeep | -isnotdeep\n] [-cmaponly] [-adjustcolors] [-transparent color] [-maskfile filename [-verbose] [ILBMfile]\n\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "This program is part of Netpbm(1).\n\nilbmtoppm  reads an IFF ILBM file as input and produces a PPM image as output.  ilbmtoppm can\nhandle the following ILBM types:\n\n\n\n•      Normal ILBMs with 1-16 planes.\n\n•      Amiga ExtraHalfbrite (EHB)\n\n•      Amiga HAM with 3-16 planes.\n\n•      24 bit.\n\n•      Multiplatte (normal or HAM) pictures.\n\n•      Color map (BMHD + CMAP chunk only, nPlanes = 0).\n\n•      Unofficial direct color.  1-16 planes for each color component.\n\n\nilbmtoppm uses these ILBM chunks: BMHD, CMAP, CAMG (only HAM & EHB flags  used),  PCHG,  BODY\nunofficial  DCOL  chunk  to identify direct color ILBM.  It ignores these chunks: GRAB, DEST,\nSPRT, CRNG, CCRT, CLUT, DPPV, DRNG, EPSF.  It ignores, but displays in verbose  mode,  these:\nNAME, AUTH, (c), ANNO, DPI.  It skips chunks whose type it doesn't recognize.\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\\ ), ilbmtoppm recognizes the following command line options:\n\n\n\n",
            "subsections": [
                {
                    "name": "-transparent _",
                    "content": "This is the color that should \"show through\" in places where the image is transparent.\n\ncolor is like the \u001b]8;;libnetpbmimage.html#colorname\u001b\\argument of the pnmparsecolor() library routine\u001b]8;;\u001b\\ .\n\n"
                },
                {
                    "name": "-verbose",
                    "content": "Give some information about the ILBM file.\n\n"
                },
                {
                    "name": "-ignore _",
                    "content": "Skip a chunk.  chunkID is the 4-letter  IFF  chunk  identifier  of  the  chunk  to  be\nskipped.\n\n"
                },
                {
                    "name": "-isham  -isehb",
                    "content": "Treat  the input file as a HAM or ExtraHalfbrite picture, even if these flags are not\nset in the CAMG chunk (or if there is no CAMG chunk).\n\n"
                },
                {
                    "name": "-maskfile _",
                    "content": "This names a file for ilbmtoppm to create with the  image's  transparency  mask.   The\nmask  file is a PBM image which maps to the input image with white pixels representing\ntransparent pixels in the image and black pixels representing opaque pixels.\n\nIf you don't specify this, or the image does  not  contain  transparency  information,\nilbmtoppm does not create a mask file.\n\n"
                },
                {
                    "name": "-cmaponly",
                    "content": "With this option, ilbmtoppm generates a PPM of the ILBM's color map, not the image it‐\nself.\n\nilbmtoppm  does  the same thing even without -cmaponly if the ILBM is a pure color map\nstream (it has a bitmap header with an nplanes value of zero or has no BODY chunk.\n\n"
                },
                {
                    "name": "-adjustcolors",
                    "content": "If all colors in the CMAP have a value of less then 16, ilbmtoppm assumes a 4-bit col‐\normap and gives a warning.  With this option the colormap is scaled to 8 bits.\n\n\n\n\n"
                }
            ]
        },
        "LIMITATIONS": {
            "content": "The multipalette PCHG BigLineChanges and Huffman decompression code is untested.\n\n",
            "subsections": []
        },
        "REFERENCES": {
            "content": "Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)  Addison Wesley, ISBN 0-201-56775-X\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "ppmtoilbm(1), ppm(1)\n\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Copyright (C) 1989 by Jef Poskanzer.\n\nModified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de)\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/ilbmtoppm.html\n\nnetpbm documentation                      12 November 2014                  Ilbmtoppm User Manual(1)",
            "subsections": []
        }
    },
    "summary": "ilbmtoppm - convert an ILBM file into a PPM image",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "This is the color that should \"show through\" in places where the image is transparent. color is like the \u001b]8;;libnetpbmimage.html#colorname\u001b\\argument of the pnmparsecolor() library routine\u001b]8;;\u001b\\ ."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Give some information about the ILBM file."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Skip a chunk. chunkID is the 4-letter IFF chunk identifier of the chunk to be skipped."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Treat the input file as a HAM or ExtraHalfbrite picture, even if these flags are not set in the CAMG chunk (or if there is no CAMG chunk)."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "This names a file for ilbmtoppm to create with the image's transparency mask. The mask file is a PBM image which maps to the input image with white pixels representing transparent pixels in the image and black pixels representing opaque pixels. If you don't specify this, or the image does not contain transparency information, ilbmtoppm does not create a mask file."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "With this option, ilbmtoppm generates a PPM of the ILBM's color map, not the image it‐ self. ilbmtoppm does the same thing even without -cmaponly if the ILBM is a pure color map stream (it has a bitmap header with an nplanes value of zero or has no BODY chunk."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "If all colors in the CMAP have a value of less then 16, ilbmtoppm assumes a 4-bit col‐ ormap and gives a warning. With this option the colormap is scaled to 8 bits."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "ppmtoilbm",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/ppmtoilbm/1/json"
        },
        {
            "name": "ppm",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/ppm/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Convert an ILBM file to a PPM image.",
        "examples": [
            {
                "description": "Convert an ILBM file to a PPM image",
                "command": "ilbmtoppm {{path/to/file.ilbm}} > {{path/to/file.ppm}}"
            },
            {
                "description": "Use the specified color to \"show through\" where the image is transparent",
                "command": "ilbmtoppm {{-t|-transparent}} {{color}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}"
            },
            {
                "description": "Ignore the chunk with the specified chunk ID",
                "command": "ilbmtoppm {{-ig|-ignore}} {{chunk_id}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}"
            },
            {
                "description": "Store the input's transparency information to the specified PBM file",
                "command": "ilbmtoppm {{-m|-maskfile}} {{path/to/maskfile.pbm}} {{path/to/file.ilbm}} > {{path/to/file.ppm}}"
            }
        ]
    }
}