fiasco

Section: Fractal Image And Sequence COdec (3)
Updated: April, 2000
Index Return to Main Contents

 

NAME

fiasco_coder - compress image files to a FIASCO file

 

SYNOPSIS

#include <fiasco.h>

int fiasco_coder (char const * const * image_names, const char * fiasco_name, float quality, const fiasco_options_t * options);

 

DESCRIPTION

The fiasco-coder() function compresses the image file(s) given by the list of image_names and creates the new FIASCO output file fiasco_name. Besides the approximation quality, several compression parameters can be adjusted by the class options (see fiasco_options_new(3)).

 

ARGUMENTS

image_names
NULL terminated array of image filenames to process. If the first array element is "-" or a NULL pointer then FIASCO reads the image from standard input. Each array element either has to be an image filename or a template of the form:

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

Templates are useful when compressing video streams: e.g., if the template "img0[12-01-2].pgm" is given as array element, then FIASCO compresses the images img012.pgm, img010.pgm, ..., img002.pgm (in this order).

If a filename is a relative path then the images are searched for in the current directory and in the (colon-separated) list of directories given by the environment variable FIASCO_IMAGES.

fiasco_name
Name of the FIASCO output file. If the name is "-" or NULL then the file is produced on standard output.

If fiasco_name is a relative path and the environment variable FIASCO_DATA is a (colon-separated) list of directories, then the output file is written to the first (writable) directory of this list. Otherwise, the current directory is used to store the output file.

quality
Defines the quality of compression. Quality has to be a positive value, its typical range is 1.0 (worst) to 100.0 (best). Larger values are also allowed - at the cost of exploding encoding times.

options
This "class" encapsulates the various coding and decoding parameters. Use the functions fiasco_options_new(3) and fiasco_options_delete(3) to create and delete an object of this class. Several member functions (see fiasco_options(3)) are available to change the default values.

 

RETURN VALUE

The function fiasco_coder() returns 1 if the FIASCO file has been successfully written. If an error has been catched during compression, 0 is returned - use the function fiasco_get_error_message(3) to get the last error message of FIASCO.

 

ENVIRONMENT

FIASCO_IMAGES
Search path for image files. Default is "./".
FIASCO_DATA
Search and save path for FIASCO files. Default is "./".

 

SEE ALSO


fiasco_options_new(3), fiasco_options_delete(3),
fiasco_options(3), fiasco_get_error_message(3)

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.

 

AUTHOR

Ullrich Hafner <hafner@bigfoot.de>


 

Index

NAME
SYNOPSIS
DESCRIPTION
ARGUMENTS
RETURN VALUE
ENVIRONMENT
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 16:15:34 GMT, July 31, 2024