xil_fill(3)

NAME

xil_fill − perform boundary fill from specified start point

SYNOPSIS

#include <xil/xil.h>

void xil_fill (XilImage src,

XilImage dst,
float xseed,
float yseed,
float ∗boundary,
float ∗fill_color);

DESCRIPTION

This function performs a boundary fill. Given the starting coordinates, the routine fills every 4-connected pixel with the specified color until it encounters the boundary. src is the source image handle. dst is the destination image handle. xseed is a float that specifies the x start coordinate. yseed is a float that specifies the y start coordinate. boundary is a pointer to the floating-point array that specifies the boundary value [0...(nbands-1)] for each pixel. fill_color is a pointer to the floating-point array that specifies the fill color [0...(nbands-1)] for each pixel.

ROI Behavior

This function performs the fill operation on the entire source image. The filled pixels within the ROI (region of interest) are output to the destination image.

ERRORS

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

EXAMPLES

For this example, the source and destination images contain 2 bands. Perform boundary fill starting at (x,y) = (7,3).

XilImage src;
XilImage dst;
float xseed = 7.0;
float yseed = 3.0;
float boundary[2] = {255.0, 0.0};
float fill_color [2] = {0.0,255.0};
xil_fill(src, dst, xseed, yseed, boundary, fill_color);

NOTES

Source and destination images must be the same data type, and have the same number of bands. For an n-band image, the array of floats for boundary and fill_color must be of size n. A pixel that matches each band in the specified boundary value is a boundary pixel. Only pixels that are changed to the fill color are output to the destination image. In-place operations are supported.

Museum

Related Articles