xil_subsample_adaptive(3)

NAME

xil_subsample_adaptive − adaptively subsample an image

SYNOPSIS

#include <xil/xil.h>

void xil_subsample_adaptive (XilImage src,

XilImage dst,
float xscale,
float yscale);

DESCRIPTION

This function adaptively subsamples an image about its origin.
By default, an image’s origin is its upper-left corner (0.0, 0.0). You can change the origin with the xil_set_origin() function. The subsampling algorithm used minimizes information loss from skipped pixels in the source image. src is the source image handle. dst is the destination image handle. xscale and yscale are the x and y scale factors, which must be less than or equal to 1.0 and greater than 0.0.

ROI Behavior

If an ROI (region of interest) is attached to the source image, it is used as a read mask and is scaled into the destination image’s space, where it is intersected with the destination ROI (if there is one).

ERRORS

For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer’s Guide.

EXAMPLES

Adaptively subsample an image by .3 in the x direction and .4 in the y direction:

XilImage src, dst;
xil_subsample_adaptive(src, dst, .3, .4);

NOTES

This operation cannot be performed in place.

Museum

Related Articles