xil_dithermask_create(3)

NAME

xil_dithermask_create, xil_dithermask_create_copy, xil_dithermask_destroy − create and destroy dither mask objects

SYNOPSIS

#include <xil/xil.h>

XilDitherMask xil_dithermask_create ( XilSystemState State,

unsigned int width,
unsigned int height,
unsigned int nbands,
float ∗data);

XilDitherMask xil_dithermask_create_copy ( XilDitherMask mask);

void xil_dithermask_destroy ( XilDitherMask mask);

DESCRIPTION

These routines create and destroy the XilDitherMask objects used in the xil_ordered_dither(3) operation.

xil_dithermask_create() creates an XilDitherMask object of the specified size with the specified data. width is the width of the dither mask in pixels. height is the height of the dither mask in pixels. nbands is the number of bands in the dither mask. data is a pointer to the data to be stored in the dither mask.

xil_dithermask_create_copy() creates and returns a copy of the specified dither mask. The name of a copy is initially empty (NULL).

xil_dithermask_destroy() destroys the specified dither mask.

ERRORS

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

EXAMPLES

Create a 4x4 1-band dither mask:

XilSystemState State;
unsigned int width=4, height=4, nbands=1;
XilDithermask dithermask;
float data[] = {
0.0,0.5,0.125,0.625,
0.75,0.25,0.875,0.375,
0.1875,0.6875,0.0625,0.5625,
0.9375,0.4375,0.8125,0.3125
};
dithermask = xil_dithermask_create (State, width, height, nbands, data);

Museum