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. In-place operations are supported.

Museum

Related Articles