fiascotopnm(1) fiascotopnm(1) NNAAMMEE fiascotopnm - Convert compressed FIASCO image to PGM, or PPM SSYYNNOOPPSSIISS ffiiaassccoottooppnnmm [_o_p_t_i_o_n]... [_f_i_l_e_n_a_m_e]... DDEESSCCRRIIPPTTIIOONN ffiiaassccoottooppnnmm decompresses the named FIASCO files, or the Standard Input if no file is named, and writes the images as PGM, or PPM files, depending on whether the FIASCO im- age is black and white or color. OOPPTTIIOONNSS All option names may be abbreviated; for example, --output may be written --outp or --ou. For all options an one let- ter short option is provided. Mandatory or optional argu- ments to long options are mandatory or optional for short options, too. Both short and long options are case sensi- tive. --oo[_n_a_m_e], ----oouuttppuutt==[_n_a_m_e] Write decompressed image to the file _n_a_m_e.ppm (if PPM) or _n_a_m_e.pgm (if PGM). If _n_a_m_e=- then produce the image file on the standard output. The optional argument _n_a_m_e can be omitted, then the input file- name is used as basename with the suffix .ppm or .pgm. In case of video streams, the frames are stored in the files _n_a_m_e.NN.ppm where NN is the frame number (of the form 00..0 - 99..9); output on the standard output is not possible with video streams. If _n_a_m_e is a relative path and the environment variable FFIIAASSCCOO__IIMMAAGGEESS is a (colon-separated) 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). --zz, ----ffaasstt 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 de- creased. July 12, 2000 1 fiascotopnm(1) fiascotopnm(1) --dd, ----ddoouubbllee 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. --pp, ----ppaanneell Show a panel with play, stop, pause, record and ex- it buttons to control the display of videos. When pressing the record button, all frames are decom- pressed and stored in memory. The other buttons work in the usual way. --mm _N, ----mmaaggnniiffyy==_N Set magnification of the decompressed image. Posi- tive values enlarge and negative values reduce the image width and height by a factor of 2^|_N|. --ss _N, ----ssmmooootthh==_N 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). --FF _N, ----ffppss==_N Set number of frames per second to _N. When using this option, the frame rate specified in the FIASCO file is overridden. --vv, ----vveerrssiioonn Print ffiiaassccoottooppnnmm version number, then exit. --ff _n_a_m_e, ----ccoonnffiigg==_n_a_m_e Load parameter file _n_a_m_e to initialize the options of ffiiaassccoottooppnnmm. See file ssyysstteemm..ffiiaassccoorrcc for an example of the syntax. Options of ffiiaassccoottooppnnmm are set by any of the following methods (in the speci- fied order): 1) Global ressource file //eettcc//ssyysstteemm..ffiiaassccoorrcc 2) $HOME//..ffiiaassccoorrcc 3) command line 4) --config=_n_a_m_e July 12, 2000 2 fiascotopnm(1) fiascotopnm(1) --hh, ----iinnffoo Print brief help, then exit. --HH, ----hheellpp Print detailed help, then exit. EEXXAAMMPPLLEESS 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 image 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 "image.00.ppm", ... , "image.14.ppm". fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm Decompress the FIASCO file "video.wfa". The decom- pression speed is as fast as possible: 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. FFIILLEESS //eettcc//ssyysstteemm..ffiiaassccoorrcc The systemwide initialization file. $HOME//..ffiiaassccoorrcc The personal initialization file. EENNVVIIRROONNMMEENNTT FFIIAASSCCOO__IIMMAAGGEESS Save path for image files. Default is "./". FFIIAASSCCOO__DDAATTAA Search path for FIASCO files. Default is "./". SSEEEE AALLSSOO ppnnmmttooffiiaassccoo(1), ppnnmm(5) July 12, 2000 3 fiascotopnm(1) fiascotopnm(1) Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger. WWeeiigghhtteedd FFiinniittee AAuuttoommaattaa ffoorr VViiddeeoo CCoommpprreessssiioonn, IEEE Journal on Selected Areas In Communications, January 1998 Ullrich Hafner. LLooww BBiitt--RRaattee IImmaaggee aanndd VViiddeeoo CCooddiinngg wwiitthh WWeeiigghhtteedd FFiinniittee AAuuttoommaattaa, Ph.D. thesis, Mensch & Buch Ver- lag, ISBN 3-89820-002-7, October 1999. AAUUTTHHOORR Ullrich Hafner July 12, 2000 4