{
    "content": [
        {
            "type": "text",
            "text": "# ppmfade(1) (man)\n\n## TLDR\n\n> Generate a transition between two PPM images.\n\n- Generate a transition between two PPM images ([f]irst and [l]ast) using the specified effect:\n  `ppmfade -f {{path/to/image1.ppm}} -l {{path/to/image2.ppm}} -{{mix|spread|shift|relief|oil|...}}`\n- Generate a transition starting with the specified image and ending in a solid black image:\n  `ppmfade -f {{path/to/image.ppm}} -{{mix|spread|shift|relief|oil|...}}`\n- Generate a transition starting with a solid black image and ending with the specified image:\n  `ppmfade -l {{path/to/image.ppm}} -{{mix|spread|shift|relief|oil|...}}`\n- Store the resulting images in files named `base.NNNN.ppm` where `NNNN` is a increasing number:\n  `ppmfade -f {{path/to/image1.ppm}} -l {{path/to/image2.ppm}} -{{mix|spread|shift|relief|oil|...}} -base {{base}}`\n\n*Source: tldr-pages*\n\n---\n\n**Summary:** ppmfade - generate a transition between two image files using special effects.\n\n**Synopsis:** ppmfade  [  -f  first.ppm  ]  [ -l last.ppm ] [ -mix|-spread|-shift|-relief|-oil|-edge|-bent‐‐\nley|-block ] [ -base name ]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -f | — | — | This is the image file (PPM format) to be used at the beginning of the transition. If not specified, the fade will start |\n| -l | — | — | This is the image file (PPM format) to be used at the ending of the transition. If not specified, the fade will end with |\n| — | — | — | full to none and the brightness of the final image increasing from none to full. The transition is quadratic in brightne |\n| — | — | — | The pixels in the first image will be moved (spread) further and further from their original location and then moved int |\n| — | — | — | their original location and then moved into the proper location in the final image. |\n| — | — | — | The first image is faded to a Laplacian relief filtered version of the first image. This is then faded to a Laplacian re |\n| — | — | — | then faded to an \"oil transfer\" version of the second image and finally faded to the final image. |\n| — | — | — | faded to an edge detected version of the second image and finally faded to the final image. |\n| — | — | — | The first image is faded to a \"Bentley Effect\" version of the first image. This is then faded to a \"Bentley Effect\" vers |\n| — | — | — | a defocused version of the last image. The block version of the last image is then focused to the final image. |\n| — | — | — | This forms part of the output filenames, as described above. EXAMPLES ppmfade -f teapot.ppm -l pyr.ppm Fade from teapot. |\n\n## See Also\n\n- tontsc(1)\n- sgifade(1)\n- smartvfr(1)\n- xmorph(1)\n- ppm(5)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (13 lines)\n- **OPTIONS** (1 lines) — 11 subsections\n  - -f first.ppm (3 lines)\n  - -l last.ppm (3 lines)\n  - -mix (4 lines)\n  - -spread (4 lines)\n  - -shift (2 lines)\n  - -relief (4 lines)\n  - -oil (3 lines)\n  - -edge (3 lines)\n  - -bentley (4 lines)\n  - -block (3 lines)\n  - -base (19 lines)\n- **SEE ALSO** (3 lines)\n- **AUTHOR** (7 lines)\n\n## Full Content\n\n### NAME\n\nppmfade - generate a transition between two image files using special effects.\n\n### SYNOPSIS\n\nppmfade  [  -f  first.ppm  ]  [ -l last.ppm ] [ -mix|-spread|-shift|-relief|-oil|-edge|-bent‐‐\nley|-block ] [ -base name ]\n\n### DESCRIPTION\n\nThis program generates a transition between either two input images or between one input  im‐\nage  and black.  You can use the 30 intermediate images generated to show a smooth transition\nbetween segments of a movie.  The input and output images are in the  Portable  Pixmap  (PPM)\nformat.  If you specify both input images, they should both be the same size.  If you want to\nfade from black to an image, specify only the last image.  If you want to fade from an  image\nto  black,  specify  only the first image.  ppmfade names the resulting image files base.nnnn\n.ppm, where nnnn is a number varying between 0001 and 0030 and base is what you specify  with\nvia the -base option (default fade).\n\nAnother way to convert by steps from one image to another is morphing.  You can use xmorph to\ndo that.\n\n### OPTIONS\n\n#### -f first.ppm\n\nThis is the image file (PPM format) to be used at the beginning of the transition.  If\nnot specified, the fade will start from black.\n\n#### -l last.ppm\n\nThis  is  the  image file (PPM format) to be used at the ending of the transition.  If\nnot specified, the fade will end with black.\n\n#### -mix\n\nfull  to none and the brightness of the final image increasing from none to full.  The\ntransition is quadratic in brightness with faster  transition  in  the  beginning  and\nslower at the end.\n\n#### -spread\n\nThe  pixels  in  the first image will be moved (spread) further and further from their\noriginal location and then moved into the proper location in the final image.  This is\nthe default transition.\n\n#### -shift\n\ntheir original location and then moved into the proper location in the final image.\n\n#### -relief\n\nThe first image is faded to a Laplacian relief filtered version of  the  first  image.\nThis  is then faded to a Laplacian relief filtered version of the second image and fi‐\nnally faded to the final image.\n\n#### -oil\n\nthen  faded  to an \"oil transfer\" version of the second image and finally faded to the\nfinal image.\n\n#### -edge\n\nfaded  to  an edge detected version of the second image and finally faded to the final\nimage.\n\n#### -bentley\n\nThe first image is faded to a \"Bentley Effect\" version of the first  image.   This  is\nthen  faded to a \"Bentley Effect\" version of the second image and finally faded to the\nfinal image.\n\n#### -block\n\na  defocused  version  of the last image.  The block version of the last image is then\nfocused to the final image.\n\n#### -base\n\nThis forms part of the output filenames, as described above.\n\n\n\nEXAMPLES\nppmfade -f teapot.ppm -l pyr.ppm\n\nFade from teapot.ppm to pyr.ppm generating fade.0001.ppm to  fade.0030.ppm  using  the\n\"spread\" transition.\n\nppmfade -l teapot.ppm\n\nFade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm.\n\nppmfade -f teapot.ppm -base end\n\nFade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm.\n\n### SEE ALSO\n\ntontsc(1), sgifade(1), smartvfr(1), xmorph(1), ppm(5),\n\n### AUTHOR\n\nWesley C. Barris (wesb@msc.edu)\nArmy High Performance Computing Research Center (AHPCRC)\nMinnesota Supercomputer Center, Inc.\n\n\n\n1                                           April 1, 2000                                 PPMFADE(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "ppmfade",
        "section": "1",
        "mode": "man",
        "summary": "ppmfade - generate a transition between two image files using special effects.",
        "synopsis": "ppmfade  [  -f  first.ppm  ]  [ -l last.ppm ] [ -mix|-spread|-shift|-relief|-oil|-edge|-bent‐‐\nley|-block ] [ -base name ]",
        "tldr_summary": "Generate a transition between two PPM images.",
        "tldr_examples": [
            {
                "description": "Generate a transition between two PPM images ([f]irst and [l]ast) using the specified effect",
                "command": "ppmfade -f {{path/to/image1.ppm}} -l {{path/to/image2.ppm}} -{{mix|spread|shift|relief|oil|...}}"
            },
            {
                "description": "Generate a transition starting with the specified image and ending in a solid black image",
                "command": "ppmfade -f {{path/to/image.ppm}} -{{mix|spread|shift|relief|oil|...}}"
            },
            {
                "description": "Generate a transition starting with a solid black image and ending with the specified image",
                "command": "ppmfade -l {{path/to/image.ppm}} -{{mix|spread|shift|relief|oil|...}}"
            },
            {
                "description": "Store the resulting images in files named `base.NNNN.ppm` where `NNNN` is a increasing number",
                "command": "ppmfade -f {{path/to/image1.ppm}} -l {{path/to/image2.ppm}} -{{mix|spread|shift|relief|oil|...}} -base {{base}}"
            }
        ],
        "tldr_source": "official",
        "flags": [
            {
                "flag": "-f",
                "long": null,
                "arg": null,
                "description": "This is the image file (PPM format) to be used at the beginning of the transition. If not specified, the fade will start from black."
            },
            {
                "flag": "-l",
                "long": null,
                "arg": null,
                "description": "This is the image file (PPM format) to be used at the ending of the transition. If not specified, the fade will end with black."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "full to none and the brightness of the final image increasing from none to full. The transition is quadratic in brightness with faster transition in the beginning and slower at the end."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "The pixels in the first image will be moved (spread) further and further from their original location and then moved into the proper location in the final image. This is the default transition."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "their original location and then moved into the proper location in the final image."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "The first image is faded to a Laplacian relief filtered version of the first image. This is then faded to a Laplacian relief filtered version of the second image and fi‐ nally faded to the final image."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "then faded to an \"oil transfer\" version of the second image and finally faded to the final image."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "faded to an edge detected version of the second image and finally faded to the final image."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "The first image is faded to a \"Bentley Effect\" version of the first image. This is then faded to a \"Bentley Effect\" version of the second image and finally faded to the final image."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "a defocused version of the last image. The block version of the last image is then focused to the final image."
            },
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "This forms part of the output filenames, as described above. EXAMPLES ppmfade -f teapot.ppm -l pyr.ppm Fade from teapot.ppm to pyr.ppm generating fade.0001.ppm to fade.0030.ppm using the \"spread\" transition. ppmfade -l teapot.ppm Fade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm. ppmfade -f teapot.ppm -base end Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "tontsc",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/tontsc/1/json"
            },
            {
                "name": "sgifade",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/sgifade/1/json"
            },
            {
                "name": "smartvfr",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/smartvfr/1/json"
            },
            {
                "name": "xmorph",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/xmorph/1/json"
            },
            {
                "name": "ppm",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/ppm/5/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 13,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "-f first.ppm",
                        "lines": 3,
                        "flag": "-f"
                    },
                    {
                        "name": "-l last.ppm",
                        "lines": 3,
                        "flag": "-l"
                    },
                    {
                        "name": "-mix",
                        "lines": 4
                    },
                    {
                        "name": "-spread",
                        "lines": 4
                    },
                    {
                        "name": "-shift",
                        "lines": 2
                    },
                    {
                        "name": "-relief",
                        "lines": 4
                    },
                    {
                        "name": "-oil",
                        "lines": 3
                    },
                    {
                        "name": "-edge",
                        "lines": 3
                    },
                    {
                        "name": "-bentley",
                        "lines": 4
                    },
                    {
                        "name": "-block",
                        "lines": 3
                    },
                    {
                        "name": "-base",
                        "lines": 19
                    }
                ]
            },
            {
                "name": "SEE ALSO",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 7,
                "subsections": []
            }
        ]
    }
}