{
    "content": [
        {
            "type": "text",
            "text": "# ppmtoilbm(1) (man)\n\n**Summary:** ppmtoilbm - convert a portable pixmap into an ILBM file\n\n**Synopsis:** ppmtoilbm  [-maxplanes|-mp  N] [-fixplanes|-fp N] [-ham6|-ham8] [-dcbits|-dcplanesrgb] [-nor‐‐\nmal|-hamif|-hamforce|-24if|-24force| -dcif|-dcforce|-cmaponly] [-ecs|-aga] [-compress|-nocom‐‐\npress] [-cmethod type] [-mapppmfile] [-savemem] [ppmfile]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| — | — | — | (default 5, minimum 1, maximum 16) Maximum planes to write in a normal ILBM. If the pixmap does not fit into <n> planes, |\n| — | — | — | (min 1, max 16) If a normal ILBM is written, it will have exactly <n> planes. |\n| — | — | — | (default 6, min 3, max 16) Select number of planes for HAM picture. The current Amiga hardware supports 6 and 8 planes,  |\n| — | — | — | Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and -cmaponly. Also sets compression type to byterun1. |\n| — | — | — |  |\n| — | — | — |  |\n| — | — | — | Write a HAM/24bit/direct color file if the pixmap does not fit into <maxplanes> planes. |\n| — | — | — |  |\n| — | — | — |  |\n| — | — | — | Write a HAM/24bit/direct color file. |\n| — | — | — | (default 5, min 1, max 16). Select number of bits for red, green & blue in a direct color ILBM. |\n| — | — | — | Shortcut for: -hamplanes 6 -maxplanes 5 |\n| — | — | — |  |\n| — | — | — |  |\n| — | — | — |  |\n| — | — | — |  |\n| — | — | — | Compress the BODY chunk. The default compression method is byterun1. Compression re‐ quires building the ILBM image in m |\n| — | — | — | Write a normal ILBM using the colors in <ppmfile> as the colormap. The colormap file also determines the number of plane |\n| — | — | — | Write a colormap file: only BMHD and CMAP chunks, no BODY chunk, nPlanes = 0. |\n| — | — | — | See the -compress option. |\n\n## See Also\n\n- ppm(5)\n- ilbmtoppm(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (18 lines)\n- **OPTIONS** (3 lines) — 22 subsections\n  - -maxplanes | -mp n (5 lines)\n  - -fixplanes | -fp n (2 lines)\n  - -hambits | -hamplanes n (3 lines)\n  - -normal (default) (3 lines)\n  - -hamif (1 lines)\n  - -24if (1 lines)\n  - -dcif (3 lines)\n  - -hamforce (1 lines)\n  - -24force (1 lines)\n  - -dcforce (2 lines)\n  - -dcbits | -dcplanes r g b (3 lines)\n  - -ecs (default) (2 lines)\n  - -aga (1 lines)\n  - Shortcut for: -hamplanes 8 -maxplanes 8 (1 lines)\n  - -ham6 (1 lines)\n  - Shortcut for: -hamplanes 6 -hamforce (1 lines)\n  - -ham8 (1 lines)\n  - -compress (1 lines)\n  - -cmethod none|byterun1 (6 lines)\n  - -map ppmfile (3 lines)\n  - -cmaponly (2 lines)\n  - -savemem (2 lines)\n- **BUGS** (5 lines)\n- **REFERENCES** (3 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHORS** (7 lines)\n\n## Full Content\n\n### NAME\n\nppmtoilbm - convert a portable pixmap into an ILBM file\n\n### SYNOPSIS\n\nppmtoilbm  [-maxplanes|-mp  N] [-fixplanes|-fp N] [-ham6|-ham8] [-dcbits|-dcplanesrgb] [-nor‐‐\nmal|-hamif|-hamforce|-24if|-24force| -dcif|-dcforce|-cmaponly] [-ecs|-aga] [-compress|-nocom‐‐\npress] [-cmethod type] [-mapppmfile] [-savemem] [ppmfile]\n\n### DESCRIPTION\n\nReads  a  portable  pixmap  as input.  Produces an ILBM file as output.  Supported ILBM types\nare:\n\nNormal ILBMs with 1-16 planes.\n\nAmiga HAM with 3-16 planes.\n\n24 bit.\n\nColor map (BMHD + CMAP chunk only, nPlanes = 0).\n\nUnofficial direct color.\n1-16 planes for each color component.\n\nChunks written:\nBMHD, CMAP, CAMG (only for HAM), BODY (not for colormap files) unofficial  DCOL  chunk\nfor direct color ILBM\n\n### OPTIONS\n\nOptions  marked with (*) can be prefixed with a \"no\", e.g. \"-nohamif\". All options can be ab‐\nbreviated to their shortest unique prefix.\n\n#### -maxplanes | -mp n\n\n(default 5, minimum 1, maximum 16) Maximum planes to write in a normal ILBM.   If  the\npixmap  does not fit into <n> planes, ppmtoilbm writes a HAM file (if -hamif is used),\na 24bit file (if -24if is used) or a direct color file (if -dcif is  used)  or  aborts\nwith an error.\n\n#### -fixplanes | -fp n\n\n(min 1, max 16) If a normal ILBM is written, it will have exactly <n> planes.\n\n#### -hambits | -hamplanes n\n\n(default 6, min 3, max 16) Select number of planes for HAM picture.  The current Amiga\nhardware supports 6 and 8 planes, so for now you should only use this values.\n\n#### -normal (default)\n\nTurns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and  -cmaponly.   Also  sets\ncompression type to byterun1.\n\n#### -hamif\n\n#### -24if\n\n#### -dcif\n\nWrite  a  HAM/24bit/direct  color  file  if  the  pixmap does not fit into <maxplanes>\nplanes.\n\n#### -hamforce\n\n#### -24force\n\n#### -dcforce\n\nWrite a HAM/24bit/direct color file.\n\n#### -dcbits | -dcplanes r g b\n\n(default 5, min 1, max 16).  Select number of bits for red, green & blue in  a  direct\ncolor ILBM.\n\n#### -ecs (default)\n\nShortcut for: -hamplanes 6 -maxplanes 5\n\n#### -aga\n\n#### Shortcut for: -hamplanes 8 -maxplanes 8\n\n#### -ham6\n\n#### Shortcut for: -hamplanes 6 -hamforce\n\n#### -ham8\n\n#### -compress\n\n#### -cmethod none|byterun1\n\nCompress the BODY chunk.  The default compression method is byterun1.  Compression re‐\nquires building the ILBM image in memory; turning compression off allows  stream-writ‐\ning  of  the image, but the resulting file will usually be 30% to 50% larger.  Another\nalternative is the -savemem option, this will keep memory requirements for compression\nat a minimum, but is very slow.\n\n#### -map ppmfile\n\nWrite  a  normal ILBM using the colors in <ppmfile> as the colormap. The colormap file\nalso determines the number of planes, a -maxplanes or -fixplanes option is ignored.\n\n#### -cmaponly\n\nWrite a colormap file: only BMHD and CMAP chunks, no BODY chunk, nPlanes = 0.\n\n#### -savemem\n\nSee the -compress option.\n\n### BUGS\n\nHAM pictures will always get a grayscale colormap; a real  color  selection  algorithm  might\ngive  better results.  On the other hand, this allows row-by-row operation on HAM images, and\nall HAM images of the same depth (no. of planes) share a common colormap, which is useful for\nbuilding HAM animations.\n\n### REFERENCES\n\nAmiga ROM Kernel Reference Manual - Devices (3rd Ed.)\nAddison Wesley, ISBN 0-201-56775-X\n\n### SEE ALSO\n\nppm(5), ilbmtoppm(1)\n\n### AUTHORS\n\nCopyright (C) 1989 by Jef Poskanzer.\nModified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de)\n\n\n\n\n31 October 1993                              ppmtoilbm(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "ppmtoilbm",
        "section": "1",
        "mode": "man",
        "summary": "ppmtoilbm - convert a portable pixmap into an ILBM file",
        "synopsis": "ppmtoilbm  [-maxplanes|-mp  N] [-fixplanes|-fp N] [-ham6|-ham8] [-dcbits|-dcplanesrgb] [-nor‐‐\nmal|-hamif|-hamforce|-24if|-24force| -dcif|-dcforce|-cmaponly] [-ecs|-aga] [-compress|-nocom‐‐\npress] [-cmethod type] [-mapppmfile] [-savemem] [ppmfile]",
        "flags": [
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "(default 5, minimum 1, maximum 16) Maximum planes to write in a normal ILBM. If the pixmap does not fit into <n> planes, ppmtoilbm writes a HAM file (if -hamif is used), a 24bit file (if -24if is used) or a direct color file (if -dcif is used) or aborts with an error."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "(min 1, max 16) If a normal ILBM is written, it will have exactly <n> planes."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "(default 6, min 3, max 16) Select number of planes for HAM picture. The current Amiga hardware supports 6 and 8 planes, so for now you should only use this values."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and -cmaponly. Also sets compression type to byterun1."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Write a HAM/24bit/direct color file if the pixmap does not fit into <maxplanes> planes."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Write a HAM/24bit/direct color file."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "(default 5, min 1, max 16). Select number of bits for red, green & blue in a direct color ILBM."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Shortcut for: -hamplanes 6 -maxplanes 5"
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Compress the BODY chunk. The default compression method is byterun1. Compression re‐ quires building the ILBM image in memory; turning compression off allows stream-writ‐ ing of the image, but the resulting file will usually be 30% to 50% larger. Another alternative is the -savemem option, this will keep memory requirements for compression at a minimum, but is very slow."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Write a normal ILBM using the colors in <ppmfile> as the colormap. The colormap file also determines the number of planes, a -maxplanes or -fixplanes option is ignored."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "Write a colormap file: only BMHD and CMAP chunks, no BODY chunk, nPlanes = 0."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "See the -compress option."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "ppm",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/ppm/5/json"
            },
            {
                "name": "ilbmtoppm",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/ilbmtoppm/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 18,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 3,
                "subsections": [
                    {
                        "name": "-maxplanes | -mp n",
                        "lines": 5
                    },
                    {
                        "name": "-fixplanes | -fp n",
                        "lines": 2
                    },
                    {
                        "name": "-hambits | -hamplanes n",
                        "lines": 3
                    },
                    {
                        "name": "-normal (default)",
                        "lines": 3
                    },
                    {
                        "name": "-hamif",
                        "lines": 1
                    },
                    {
                        "name": "-24if",
                        "lines": 1
                    },
                    {
                        "name": "-dcif",
                        "lines": 3
                    },
                    {
                        "name": "-hamforce",
                        "lines": 1
                    },
                    {
                        "name": "-24force",
                        "lines": 1
                    },
                    {
                        "name": "-dcforce",
                        "lines": 2
                    },
                    {
                        "name": "-dcbits | -dcplanes r g b",
                        "lines": 3
                    },
                    {
                        "name": "-ecs (default)",
                        "lines": 2
                    },
                    {
                        "name": "-aga",
                        "lines": 1
                    },
                    {
                        "name": "Shortcut for: -hamplanes 8 -maxplanes 8",
                        "lines": 1
                    },
                    {
                        "name": "-ham6",
                        "lines": 1
                    },
                    {
                        "name": "Shortcut for: -hamplanes 6 -hamforce",
                        "lines": 1
                    },
                    {
                        "name": "-ham8",
                        "lines": 1
                    },
                    {
                        "name": "-compress",
                        "lines": 1
                    },
                    {
                        "name": "-cmethod none|byterun1",
                        "lines": 6
                    },
                    {
                        "name": "-map ppmfile",
                        "lines": 3
                    },
                    {
                        "name": "-cmaponly",
                        "lines": 2
                    },
                    {
                        "name": "-savemem",
                        "lines": 2
                    }
                ]
            },
            {
                "name": "BUGS",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "REFERENCES",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHORS",
                "lines": 7,
                "subsections": []
            }
        ]
    }
}