NAME

rle_raw_alloc - Allocate memory for rle_getraw or rle_putraw.

rle_raw_free - free memory allocated by rle_raw_alloc.

SYNOPSIS

#include <rle.h>
#include <rle_raw.h>

rle_raw_alloc( the_hdr, scanp, nrawp )
rle_hdr * the_hdr;
rle_op *** scanp;
int ** nrawp;

rle_raw_free( the_hdr, scanp, nrawp )
rle_hdr * the_hdr;
rle_op ** scanp;
int * nrawp;

DESCRIPTION

The function rle_raw_alloc is provided to make it easier to allocate storage for use by the RLE "raw" functions. It examines the the_hdr structure provided and return (via its other arguments) newly allocated space suitable for reading from or writing to an RLE file described by the the_hdr structure. Rle_raw_alloc allocates (the_hdr→xmax - the_hdr→xmin + 1) elements per channel, which is more than should ever be needed for a valid RLE file.

Rle_raw_free should be used to free memory allocated by rle_raw_alloc(3). The arguments are pointers to the allocated storage. This is distinct from rle_freeraw(3), which only frees pixel arrays referenced by individual rle_op structures, while rle_raw_free frees the storage consumed by the arrays of pointers and rle_op structures. In fact, rle_freeraw should be called before calling rle_raw_free.

AUTHOR

Spencer W. Thomas
University of Utah

BUGS

The naming confusion between rle_freeraw and rle_raw_free is unfortunate.

NAME

SYNOPSIS

DESCRIPTION

SEE ALSO

AUTHOR

BUGS