RETRO (vipl) functions
LIBRARY ROUTINE
lvqerr - Compute the quantization error between a quantized image and the original.
LIBRARY CALL
int lvqerr(
xvimage *img1,
xvimage *img2,
xvimage *img3,
int mflg,
double *rms)
INPUT
- img1 - quantized VIFF image structure
- img2 - original VIFF image structure
- img3 - gating mask image
- mflg - a flag set (equal 1) if gating mask available
- rms - pointer to a DOUBLE to receive the RMS error
OUTPUT
- rms - is modified to contain the RMS quantization error
RETURN VALUE
TRUE (1) on success, FALSE (0) on failure
DESCRIPTION
lvqerr computes the RMS quantization error between
a quantized image and the original image.
The first input image is the quantized image and
should have maps attached. The data type of the
first image should be BYTE or INT. The map should
be of the same data type as the data in the second
image (the original). The original image should
have no maps attached.
The mask image must be the same data storage type
and size as the first input image.
The number of columns in the map of the first input
image should match the number of bands in the second
(original) input image.
The output is in text format, with the RMS quantization
error printed in using the %e format.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
lvqerr will not operate on VFF_TYP_BIT, VFF_TYP_COMPLEX,
or VFF_TYP_DOUBLE data storage types.
MODIFICATION
none
FILES
$RETRO/objects/library/vipl/src/lvqerr.c
SEE ALSO
vipl(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.