xil_black_generation(3)

NAME

xil_black_generation − adjust the amount of black to be added to or removed from a CMYK image

SYNOPSIS

#include <xil/xil.h>

void xil_black_generation (XilImage src,

XilImage dst,
float black,
float undercolor);

DESCRIPTION

This function adjusts the amount of black to be added to and removed from an image. Both src and dst are image handles to a 4-band CMYK image. black is the fraction of color that forms the K channel. undercolor represents the fraction of color taken away from each of the C, M, and Y channels.

Channels for each pixel are defined as follows:

black channnel=black ∗ (minimum of C, M, Y)
cyan channel=C - (undercolor ∗ (minimum of C, M, Y))
magenta channel=M - (undercolor ∗ (minimum of C, M, Y))
yellow channel=Y - (undercolor ∗ (minimum of C, M, Y))

ERRORS

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

EXAMPLES

Adjust a CMYK image:

XilImage src, dst;
xil_black_generation(src, dst, 0.7, 0.5);

NOTES

It is assumed that all imported CMYK images are generated by using the same function for black generation and undercolor removal. Regions of interest are ignored when you perform undercolor removal. In-place operations are supported.

Museum

Related Articles