Unix/Linux Go Back    


CentOS 7.0 - man page for pnmtofiasco (centos section 0)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Pnmtofiasco User Manual(0)					       Pnmtofiasco User Manual(0)

NAME
       pnmtofiasco - Convert PNM file to FIASCO compressed file

SYNOPSIS
       pnmtofiasco [option]...	[filename]...

DESCRIPTION
       This program is part of Netpbm(1)

       pnmtofiasco  compresses	the  named  pbm, pgm, or ppm image files, or Standard Input if no
       file is named, and produces a FIASCO file on Standard Output.

OPTIONS
       All option names may be abbreviated; for example, --optimize may  be  written  --optim  or
       --opt.  For  most  options  a  one letter short option is provided.  Mandatory or optional
       arguments to long options are mandatory or optional for short options,  too.   Both  short
       and long options are case sensitive.

       The basic options are:

       -i name, --input-name=name
	      Compress	the named images, not Standard Input.  If name is -, read Standard Input.
	      name has to be either an image filename or a template of the form:

	      prefix[start-end{+,-}step]suffix

	      Templates are useful when compressing video streams: e.g., if you specify the  tem-
	      plate   img0[12-01-2].pgm,  then	pnmtofiasco  compresses  the  images  img012.pgm,
	      img010.pgm, ..., img002.pgm.

	      If name is a relative path, pnmtofiasco  searches for the image files in	the  cur-
	      rent  directory and in the (colon-separated) list of directories given by the envi-
	      ronment variable FIASCO_IMAGES.

       -o output-file, --output-name=name
	      Write FIASCO output to the named file, not to Standard Output.

	      If name is a relative path and the environment variable FIASCO_DATA  is  a  (colon-
	      separated)  list	of  directories,  then	pnmtofiasco writes the output file to the
	      first (writable) directory of this list. Otherwise, pnmtofiasco  write  it  to  the
	      current directory.

       -q N, --quality=N
	      Set  quality  of	compression to N.  Quality is 1 (worst) to 100 (best); default is
	      20.

       -v, --version
	      Print pnmtofiasco version number, then exit.

       -V N, --verbose N
	      Set level of verbosity to N.  Level is 0 (no  output  at	all),  1  (show  progress
	      meter), or 2 (show detailed compression statistics); default is 1.

       -B N, --progress-meter N
	      Set type of progress-meter to N.	The following types are available; default is 1:

       0      no progress meter

       1      RPM style progress bar using 50 hash marks

       2      percentage meter

       -f name, --config=name
	      Load  parameter file name  to initialize the options of pnmtofiasco.  See file sys-
	      tem.fiascorc for an example of the syntax. Options of pnmtofiasco are set by any of
	      the following methods (in the specified order):

       o      Global resource file /etc/system.fiascorc

       o      $HOME/.fiascorc

       o      command line

       o      --config=name

       -h, --info
	      Print brief help, then exit.

       -H, --help
	      Print detailed help, then exit.

       The options for advanced users are:

       -b name, --basis-name=name
	      Preload  compression  basis  name into FIASCO.  The basis name provides the initial
	      compression dictionary.  Either use one of the files 'small.fco', 'medium.fco',  or
	      'large.fco' that come with pnmtofiasco  or create a new ASCII basis file.

       -z N, --optimize=N
	      Set  optimization  level	to N.  Level is 0 (fastest) to 3 (slowest); default is 1.
	      Be warned, the encoding time dramatically increased when N=2 or N=3 while the  com-
	      pression performance only slightly improves.

       -P, --prediction
	      Use  additional  predictive coding.  If this optimization is enabled then the image
	      is compressed in two steps.  In the first step, a coarse approximation of the image
	      is computed using large unichrome blocks.  Finally, the delta image is computed and
	      the prediction error is approximated using the standard FIASCO algorithm.

       -D N, --dictionary-size=N
	      Set size of dictionary that is used when coding the luminance band to N; default is
	      10000, i.e., the dictionary is not restricted.

       -C N, --chroma-dictionary=N
	      Set size of dictionary that is used when coding chroma bands to N; default is 40.

       -Q N, --chroma-qfactor=N
	      Reduce  the  quality  of	chroma	band compression N-times with respect to the user
	      defined quality q of the luminance band compression (--quality=q); default is 2.

       -t N, --tiling-exponent=N
	      Subdivide the image into 2^N tiles prior coding; default is 4, i.e.  the	image  is
	      subdivided  into	16 tiles. The processing order of the individual tiles is defined
	      by the option --tiling-method=name.

       -T name, --tiling-method=name
	      Order the individual  image  tiles  (the	image  is  subdivided  into;  see  option
	      --tiling-exponent=N) by method name; default is desc-variance.

       desc-variance
	      Tiles with small variances are processed first.

       asc-variance
	      Tiles with large variances are processed first.

       desc-spiral
	      Tiles are process in spiral order starting in the middle.

       asc-spiral
	      Tiles are process in spiral order starting at the border.

       --rpf-mantissa=N
	      Use N mantissa bits for quantized coefficients.

       --dc-rpf-mantissa=N
	      Use N mantissa bits for quantized DC coefficients.

       --rpf-range=N
	      Coefficients outside the quantization interval [-N,+N] are set to zero.

       --dc-rpf-range=N
	      DC coefficients outside the quantization interval [-N,+N] are set to zero.

       Additional options for video compression are

       -s N, --smooth=N
	      Smooth  decompressed  reference  frames along the partitioning borders by the given
	      amount N.  N is 0 (no smoothing) to 100; default is 70.  This factor is  stored  in
	      the FIASCO file.

       -m N, --min-level=N
	      Start  prediction (motion compensated prediction or additional prediction) on block
	      level N; default is level 6.  I.e., motion compensation is  applied  to  all  image
	      blocks  of  at  least  8x8 pixels (binary tree level N=6), 16x8 (N=7), 16x16 (N=8),
	      etc.

       -M N, --max-level=N
	      Stop prediction (motion compensated prediction or additional prediction)	on  block
	      level  N;  default  is level 10.	I.e., motion compensation is applied to all image
	      blocks of at most 16x16 pixels (N=8), 32x16 (N=9), 32x32 (N=10), etc.

       -2, --half-pixel
	      Use half pixel precise motion compensation.

       -F N, --fps=N
	      Set number of frames per second to N.  This value is stored in  the  FIASCO  output
	      file and is used in the decoder fiascotopnm(1)
	       to control the framerate.

       -p type, --pattern=type
	      Defines  the  type of inter frame compression which should be applied to individual
	      frames  of  a  video  stream.   type  is	a  sequence  of  characters;  default  is
	      'IPPPPPPPPP'.   Element  N  defines the type of predicting which should be used for
	      frame N; the frame type pattern is periodically extended.  Valid characters are:

       I      intra frame, i.e., no motion compensated prediction is used at all.

       P      predicted frame, i.e., a previously encoded frame is used for  prediction  (forward
	      prediction).

       B      bidirectional  predicted	frame, i.e., not only a previously shown frame but also a
	      frame of the future is used for prediction (forward, backward or interpolated  pre-
	      diction).

       --cross-B-search
	      Instead  of  using exhaustive search the 'Cross-B-Search' algorithm is used to find
	      the best interpolated prediction of B-frames.

       --B-as-past-ref
	      Also use previously encoded B-frames when prediction the	current  frame.  If  this
	      option is not set, only I- and P-frames are used to predict the current frame.

EXAMPLES
       Compress the still image 'foo.ppm' to the FIASCO file 'foo.wfa' using the default options:

	       pnmtofiasco < foo.ppm >foo.wfa

       Compress the video frames 'foo0*.ppm' to the FIASCO file 'video.wfa' using half pixel pre-
       cise motion compensation at a frame rate of 15 frames per second.  Intra frame 1  is  used
       to  predict  P-frame  4,  frames  1 and 4 are used to predict B-frames 2 and 3, and so on.
       Frame 10 is again an intra-frame.

	       pnmtofiasco -2 -p 'IBBPBBPBB' -fps 15 -o video.wfa foo0*.ppm

FILES
       /etc/system.fiascorc
	      The systemwide initialization file.

       $HOME/.fiascorc
	      The personal initialization file.

ENVIRONMENT
       FIASCO_IMAGES
	      Search path for image files.  Default is './'.

       FIASCO_DATA
	      Search and save path for FIASCO files.  Default is './'.

SEE ALSO
       fiascotopnm(1) , ppmtojpeg(1) , pnmtojbig(1) , pamtogif(1) , pnm(1)

       Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.  Weighted Finite Automata
       for Video Compression, IEEE Journal on Selected Areas In Communications, January 1998

       Ullrich	Hafner.  Low Bit-Rate Image and Video Coding with Weighted Finite Automata, Ph.D.
       thesis, Mensch & Buch Verlag, ISBN 3-89820-002-7, October 1999.

       FIASCO:	    An	    Open-Source      Fractal	  Image      and      Sequence	    Codec
       <http://www.linuxjournal.com/node/4367/print> , Linux Journal, January 2001.

AUTHOR
       Ullrich Hafner <hafner@bigfoot.de>

netpbm documentation			  July 12, 2000 	       Pnmtofiasco User Manual(0)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 08:34 AM.