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

OUTPUT

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.