fiascotopnm(1)

1Fiascotopnm User Manual(0)                          Fiascotopnm User Manual(0)
2
3
4

NAME

6       fiascotopnm - Convert compressed FIASCO image to PGM, or PPM
7
8

SYNOPSIS

10       fiascotopnm [option]...  [filename]...
11
12       All option names may be abbreviated; for example, --output may be writ‐
13       ten --outp or --ou. For all options an one letter short option is  pro‐
14       vided. Mandatory or optional arguments to long options are mandatory or
15       optional for short options, too. Both short and long options  are  case
16       sensitive.
17
18
19

DESCRIPTION

21       This program is part of Netpbm(1).
22
23       fiascotopnm  decompresses the named FIASCO files, or the Standard Input
24       if no file is named, and writes  the  images  as  PGM,  or  PPM  files,
25       depending on whether the FIASCO image is black and white or color.
26
27

OPTIONS

29       -o[name], --output=[name]
30               Write  decompressed  image  to  the  file  name.ppm (if PPM) or
31              name.pgm (if PGM).  If name is -, then produce the image file on
32              the  standard output. The optional argument name can be omitted,
33              then the input filename is used as basename with the suffix .ppm
34              or  .pgm. In case of video streams, the frames are stored in the
35              files name.N.ppm where N is the frame number (of the form  00..0
36              -  99..9);  output  on  the standard output is not possible with
37              video streams.
38
39               If name  is  a  relative  path  and  the  environment  variable
40              FIASCO_IMAGES  is  a (colon-separated) list of directories, then
41              the output file(s) are written to the first (writable) directory
42              of  this list. Otherwise, the current directory is used to store
43              the output file(s).
44
45
46       -r, --fast
47              Decompress images in the 4:2:0 format; i.e., each chroma channel
48              is decompressed to an image of halved width and height. Use this
49              option on slow machines when  the  desired  frame  rate  is  not
50              achieved; the output quality is only slightly decreased.
51
52
53       -d, --double
54              Double  the  size of the X11 window both in width and height; no
55              pixel interpolation is used, each pixel is just replaced by four
56              identical pixels.
57
58
59       -p, --panel
60              Show  a panel with play, stop, pause, record and exit buttons to
61              control the display of videos. When pressing the record  button,
62              all frames are decompressed and stored in memory. The other but‐
63              tons work in the usual way.
64
65
66       -m N, --magnify=N
67              Set magnification of the  decompressed  image.  Positive  values
68              enlarge and negative values reduce the image width and height by
69              a factor of 2^|N|.
70
71
72       -s N, --smooth=N
73              Smooth decompressed image(s) along the partitioning  borders  by
74              the  given  amount N. N is 1 (minimum) to 100 (maximum); default
75              is 70. When N=0, then the  smoothing  amount  specified  in  the
76              FIASCO file is used (defined by the FIASCO coder).
77
78
79       -F N, --framerate=N
80              Set  number  of  frames per second to N. When using this option,
81              the frame rate specified in the FIASCO file is overridden.
82
83
84       -v, --version
85              Print fiascotopnm version number, then exit.
86
87
88       -f name, --config=name
89              Load parameter file name to initialize the  options  of  fiasco‐
90              topnm.   See  file system.fiascorc for an example of the syntax.
91              Options of fiascotopnm  are set by any of the following  methods
92              (in the specified order):
93
94
95
96       ·      Global ressource file /etc/system.fiascorc
97
98
99       ·      $HOME/.fiascorc
100
101
102       ·      command line
103
104
105       ·      --config=name
106
107
108
109       -h, --help
110              Print help, then exit.
111
112
113
114
115

EXAMPLES

117       fiascotopnm foo.wfa >foo.ppm
118
119       Decompress the FIASCO file 'foo.wfa' and store it as 'foo.ppm'.
120
121       fiascotopnm -o foo1.wfa foo2.wfa
122
123       Decompress  the  FIASCO  files  'foo1.wfa' and 'foo2.wfa' and write the
124       frames to the image files 'foo1.wfa.ppm' and 'foo2.wfa.ppm'.
125
126       fiascotopnm -oimage foo1.wfa
127
128       Decompress the FIASCO file 'foo1.wfa' and write all 15  frames  to  the
129       image files 'image.00.ppm', ... , 'image.14.ppm'.
130
131       fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm
132
133       Decompress  the FIASCO file 'video.wfa'.  The decompression speed is as
134       fast as possible: the image is decompressed  (in  4:2:0  format)  at  a
135       quarter of its original size; then the image is enlarged again by pixel
136       doubling.
137
138

FILES

140       /etc/system.fiascorc
141              The systemwide initialization file.
142
143
144       $HOME/.fiascorc
145              The personal initialization file.
146
147
148
149

ENVIRONMENT

151       FIASCO_IMAGES
152              Save path for image files. Default is './'.
153
154
155       FIASCO_DATA
156              Search path for FIASCO files. Default is './'.
157
158
159
160
161

AUTHOR

173       Ullrich Hafner <hafner@bigfoot.de>
174
175
176
177netpbm documentation             12 July 2000       Fiascotopnm User Manual(0)