RETRO (vipl) functions


LIBRARY ROUTINE

lvgbox - Fill a buffer with a grey level representation of a parallelogram projected on a CCD sensor.

LIBRARY CALL

int lvgbox(
	unsigned char *pt_image_data,
	unsigned short n_cols,
	unsigned short n_rows,
	float px_x_w,
	float px_y_h,
	float px_x_of,
	float px_y_of,
	unsigned char grey_out,
	unsigned char grey_in,
	float im_x_w,
	float im_y_h,
	float im_x_of,
	float im_y_of,
	float phi,
	float psi)

INPUT

OUTPUT

RETURN VALUE

0 on success, n=1 on warning, n=2 on error.

DESCRIPTION

This procedure fills a buffer with a grey level represention of a parallelogram projected on a CCD sensor. It calculates the grey level of each pixel from the intersection of the theorical parallelogram and the rectangular active area of each sensor-pixel. The sensor is made of pixels suposed to be all identical, composed of an active rectangular area in a rectangular cell.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

Pixel width + pixel offset must be egal or less than 1.000.

The CCD cells are supposed square in order to obtain the asked angles, although the active area can be rectangular.

For a parallelepipedic box, the width and heigth sizes of the box are the euclidian distances between the parallel lines.

MODIFICATION

August 1991 : new float psi angle parameter for parallelogram

FILES

$RETRO/objects/library/vipl/src/lvgbox.c

SEE ALSO

vipl(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.