{ "content": [ { "type": "text", "text": "# fiascotopnm (man)\n\n## NAME\n\nfiascotopnm - Convert compressed FIASCO image to PGM, or PPM\n\n## SYNOPSIS\n\nfiascotopnm [option]... [filename]...\n\n## DESCRIPTION\n\nfiascotopnm decompresses the named FIASCO files, or the Standard Input if no file is named,\nand writes the images as PGM, or PPM files, depending on whether the FIASCO image is black\nand white or color.\n\n## TLDR\n\n> Convert a compressed FIASCO file to a PNM image.\n\n- Convert a compressed FIASCO file to a PNM file or in the case of video streams multiple PNM files:\n `fiascotopnm {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`\n- Use fast decompression, resulting in a slightly decreased quality of the output file(s):\n `fiascotopnm {{-z|--fast}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`\n- Load the options to be used from the specified configuration file:\n `fiascotopnm {{-f|--config}} {{path/to/fiascorc}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`\n- Magnify the decompressed image(s) by a factor of 2^n:\n `fiascotopnm {{-m|--magnify}} {{n}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`\n- Smooth the decompressed image by the specified amount:\n `fiascotopnm {{-s|--smoothing}} {{n}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (11 subsections)\n- **EXAMPLES**\n- **FILES** (1 subsections)\n- **ENVIRONMENT**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "fiascotopnm", "section": "", "mode": "man", "summary": "fiascotopnm - Convert compressed FIASCO image to PGM, or PPM", "synopsis": "fiascotopnm [option]... [filename]...", "tldr_summary": "Convert a compressed FIASCO file to a PNM image.", "tldr_examples": [ { "description": "Convert a compressed FIASCO file to a PNM file or in the case of video streams multiple PNM files", "command": "fiascotopnm {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}" }, { "description": "Use fast decompression, resulting in a slightly decreased quality of the output file(s)", "command": "fiascotopnm {{-z|--fast}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}" }, { "description": "Load the options to be used from the specified configuration file", "command": "fiascotopnm {{-f|--config}} {{path/to/fiascorc}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}" }, { "description": "Magnify the decompressed image(s) by a factor of 2^n", "command": "fiascotopnm {{-m|--magnify}} {{n}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}" }, { "description": "Smooth the decompressed image by the specified amount", "command": "fiascotopnm {{-s|--smoothing}} {{n}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}" } ], "tldr_source": "official", "flags": [ { "flag": "-o", "long": null, "arg": null, "description": "Write decompressed image to the file name.ppm (if PPM) or name.pgm (if PGM). If name=- then produce the image file on the standard output. The optional argument name can be omitted, then the input filename is used as basename with the suffix .ppm or .pgm. In case of video streams, the frames are stored in the files name.N.ppm where N is the frame number (of the form 00..0 - 99..9); output on the standard output is not possible with video streams. If name is a relative path and the environment variable FIASCOIMAGES is a (colon-sep‐ arated) list of directories, then the output file(s) are written to the first (writable) directory of this list. Otherwise, the current directory is used to store the output file(s)." }, { "flag": "-z", "long": "--fast", "arg": null, "description": "Decompress images in the 4:2:0 format; i.e., each chroma channel is decompressed to an image of halved width and height. Use this option on slow machines when the desired frame rate is not achieved; the output quality is only slightly decreased." }, { "flag": "-d", "long": "--double", "arg": null, "description": "Double the size of the X11 window both in width and height; no pixel interpolation is used, each pixel is just replaced by four identical pixels." }, { "flag": "-p", "long": "--panel", "arg": null, "description": "Show a panel with play, stop, pause, record and exit buttons to control the display of videos. When pressing the record button, all frames are decompressed and stored in memory. The other buttons work in the usual way." }, { "flag": "-m", "long": null, "arg": null, "description": "Set magnification of the decompressed image. Positive values enlarge and negative val‐ ues reduce the image width and height by a factor of 2^|N|." }, { "flag": "-s", "long": null, "arg": null, "description": "Smooth decompressed image(s) along the partitioning borders by the given amount N. N is 1 (minimum) to 100 (maximum); default is 70. When N=0, then the smoothing amount specified in the FIASCO file is used (defined by the FIASCO coder)." }, { "flag": "-F", "long": null, "arg": null, "description": "Set number of frames per second to N. When using this option, the frame rate specified in the FIASCO file is overridden." }, { "flag": "-v", "long": "--version", "arg": null, "description": "Print fiascotopnm version number, then exit." }, { "flag": "-f", "long": null, "arg": null, "description": "Load parameter file name to initialize the options of fiascotopnm. See file sys‐‐ tem.fiascorc for an example of the syntax. Options of fiascotopnm are set by any of the following methods (in the specified order): 1) Global ressource file /etc/system.fiascorc 2) $HOME/.fiascorc 3) command line 4) --config=name" }, { "flag": "-h", "long": "--info", "arg": null, "description": "Print brief help, then exit." }, { "flag": "-H", "long": "--help", "arg": null, "description": "Print detailed help, then exit." } ], "examples": [ "fiascotopnm foo.wfa >foo.ppm", "Decompress the FIASCO file \"foo.wfa\" and store it as \"foo.ppm\".", "fiascotopnm -o foo1.wfa foo2.wfa", "Decompress the FIASCO files \"foo1.wfa\" and \"foo2.wfa\" and write the frames to the im‐", "age files \"foo1.wfa.ppm\" and \"foo2.wfa.ppm\".", "fiascotopnm -oimage foo1.wfa", "Decompress the FIASCO file \"foo1.wfa\" and write all 15 frames to the image files \"im‐", "age.00.ppm\", ... , \"image.14.ppm\".", "fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm", "Decompress the FIASCO file \"video.wfa\". The decompression speed is as fast as possi‐", "ble: the image is decompressed (in 4:2:0 format) at a quarter of its original size;", "then the image is enlarged again by pixel doubling." ], "see_also": [ { "name": "pnmtofiasco", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pnmtofiasco/1/json" }, { "name": "pnm", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/pnm/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 3, "subsections": [] }, { "name": "SYNOPSIS", "lines": 3, "subsections": [] }, { "name": "DESCRIPTION", "lines": 5, "subsections": [] }, { "name": "OPTIONS", "lines": 6, "subsections": [ { "name": "-o --output=", "lines": 13, "flag": "-o" }, { "name": "-z --fast", "lines": 5, "flag": "-z", "long": "--fast" }, { "name": "-d --double", "lines": 4, "flag": "-d", "long": "--double" }, { "name": "-p --panel", "lines": 5, "flag": "-p", "long": "--panel" }, { "name": "-m --magnify=", "lines": 4, "flag": "-m" }, { "name": "-s --smooth=", "lines": 5, "flag": "-s" }, { "name": "-F --fps=", "lines": 4, "flag": "-F" }, { "name": "-v --version", "lines": 3, "flag": "-v", "long": "--version" }, { "name": "-f --config=", "lines": 13, "flag": "-f" }, { "name": "-h --info", "lines": 3, "flag": "-h", "long": "--info" }, { "name": "-H --help", "lines": 4, "flag": "-H", "long": "--help" } ] }, { "name": "EXAMPLES", "lines": 21, "subsections": [] }, { "name": "FILES", "lines": 1, "subsections": [ { "name": "/etc/system.fiascorc", "lines": 5 } ] }, { "name": "ENVIRONMENT", "lines": 6, "subsections": [] }, { "name": "SEE ALSO", "lines": 8, "subsections": [] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "fiascotopnm - Convert compressed FIASCO image to PGM, or PPM\n\n", "subsections": [] }, "SYNOPSIS": { "content": "fiascotopnm [option]... [filename]...\n\n", "subsections": [] }, "DESCRIPTION": { "content": "fiascotopnm decompresses the named FIASCO files, or the Standard Input if no file is named,\nand writes the images as PGM, or PPM files, depending on whether the FIASCO image is black\nand white or color.\n\n", "subsections": [] }, "OPTIONS": { "content": "All option names may be abbreviated; for example, --output may be written --outp or --ou. For\nall options an one letter short option is provided. Mandatory or optional arguments to long\noptions are mandatory or optional for short options, too. Both short and long options are\ncase sensitive.\n\n", "subsections": [ { "name": "-o --output=", "content": "Write decompressed image to the file name.ppm (if PPM) or name.pgm (if PGM). If\nname=- then produce the image file on the standard output. The optional argument name\ncan be omitted, then the input filename is used as basename with the suffix .ppm or\n.pgm. In case of video streams, the frames are stored in the files name.N.ppm where N\nis the frame number (of the form 00..0 - 99..9); output on the standard output is not\npossible with video streams.\n\nIf name is a relative path and the environment variable FIASCOIMAGES is a (colon-sep‐\narated) list of directories, then the output file(s) are written to the first\n(writable) directory of this list. Otherwise, the current directory is used to store\nthe output file(s).\n\n", "flag": "-o" }, { "name": "-z --fast", "content": "Decompress images in the 4:2:0 format; i.e., each chroma channel is decompressed to an\nimage of halved width and height. Use this option on slow machines when the desired\nframe rate is not achieved; the output quality is only slightly decreased.\n\n", "flag": "-z", "long": "--fast" }, { "name": "-d --double", "content": "Double the size of the X11 window both in width and height; no pixel interpolation is\nused, each pixel is just replaced by four identical pixels.\n\n", "flag": "-d", "long": "--double" }, { "name": "-p --panel", "content": "Show a panel with play, stop, pause, record and exit buttons to control the display of\nvideos. When pressing the record button, all frames are decompressed and stored in\nmemory. The other buttons work in the usual way.\n\n", "flag": "-p", "long": "--panel" }, { "name": "-m --magnify=", "content": "Set magnification of the decompressed image. Positive values enlarge and negative val‐\nues reduce the image width and height by a factor of 2^|N|.\n\n", "flag": "-m" }, { "name": "-s --smooth=", "content": "Smooth decompressed image(s) along the partitioning borders by the given amount N. N\nis 1 (minimum) to 100 (maximum); default is 70. When N=0, then the smoothing amount\nspecified in the FIASCO file is used (defined by the FIASCO coder).\n\n", "flag": "-s" }, { "name": "-F --fps=", "content": "Set number of frames per second to N. When using this option, the frame rate specified\nin the FIASCO file is overridden.\n\n", "flag": "-F" }, { "name": "-v --version", "content": "Print fiascotopnm version number, then exit.\n\n", "flag": "-v", "long": "--version" }, { "name": "-f --config=", "content": "Load parameter file name to initialize the options of fiascotopnm. See file sys‐‐\ntem.fiascorc for an example of the syntax. Options of fiascotopnm are set by any of\nthe following methods (in the specified order):\n\n1) Global ressource file /etc/system.fiascorc\n\n2) $HOME/.fiascorc\n\n3) command line\n\n4) --config=name\n\n", "flag": "-f" }, { "name": "-h --info", "content": "Print brief help, then exit.\n\n", "flag": "-h", "long": "--info" }, { "name": "-H --help", "content": "Print detailed help, then exit.\n\n\n", "flag": "-H", "long": "--help" } ] }, "EXAMPLES": { "content": "fiascotopnm foo.wfa >foo.ppm\nDecompress the FIASCO file \"foo.wfa\" and store it as \"foo.ppm\".\n\n\nfiascotopnm -o foo1.wfa foo2.wfa\nDecompress the FIASCO files \"foo1.wfa\" and \"foo2.wfa\" and write the frames to the im‐\nage files \"foo1.wfa.ppm\" and \"foo2.wfa.ppm\".\n\n\nfiascotopnm -oimage foo1.wfa\nDecompress the FIASCO file \"foo1.wfa\" and write all 15 frames to the image files \"im‐\nage.00.ppm\", ... , \"image.14.ppm\".\n\n\nfiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm\nDecompress the FIASCO file \"video.wfa\". The decompression speed is as fast as possi‐\nble: the image is decompressed (in 4:2:0 format) at a quarter of its original size;\nthen the image is enlarged again by pixel doubling.\n\n\n", "subsections": [] }, "FILES": { "content": "", "subsections": [ { "name": "/etc/system.fiascorc", "content": "The systemwide initialization file.\n$HOME/.fiascorc\nThe personal initialization file.\n\n" } ] }, "ENVIRONMENT": { "content": "FIASCOIMAGES\nSave path for image files. Default is \"./\".\nFIASCODATA\nSearch path for FIASCO files. Default is \"./\".\n\n", "subsections": [] }, "SEE ALSO": { "content": "pnmtofiasco(1), pnm(5)\n\nUllrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger. Weighted Finite Automata\nfor Video Compression, IEEE Journal on Selected Areas In Communications, January 1998\nUllrich Hafner. Low Bit-Rate Image and Video Coding with Weighted Finite Automata, Ph.D. the‐\nsis, Mensch & Buch Verlag, ISBN 3-89820-002-7, October 1999.\n\n", "subsections": [] }, "AUTHOR": { "content": "Ullrich Hafner \n\n\n\nJuly 12, 2000 fiascotopnm(1)", "subsections": [] } } } }