IM_ICC_*()(3)

NAME
im_icc_present, im_icc_transform, im_icc_import, im_icc_export, im_icc_export_depth - transform images using ICC profiles

SYNOPSIS
#include <vips/vips.h>
#include <vips/colour.h> #define VIPS_INTENT_PERCEPTUAL (0)
#define VIPS_INTENT_RELATIVE_COLORIMETRIC (1)
#define VIPS_INTENT_SATURATION (2)
#define VIPS_INTENT_ABSOLUTE_COLORIMETRIC (3) int
im_icc_present( void )
int
im_icc_transform( IMAGE *in, IMAGE *out,
  const char *input_profile_filename,
  const char *output_profile_filename,
  int intent ) int
im_icc_import( IMAGE *in, IMAGE *out,
  const char *input_profile_filename, int intent ) int
im_icc_export_depth( IMAGE *in, IMAGE *out, int depth,
  const char *output_profile_filename, int intent ) int
im_icc_export( IMAGE *in, IMAGE *out,
  const char *output_profile_filename, int intent ) int
im_icc_ac2rc( IMAGE *in, IMAGE *out,
  const char *profile_filename )

DESCRIPTION
im_icc_present() returns non-zero if there is an ICC library available. Calls to the other VIPS ICC functions will all fail with an error message if there is no library. im_icc_transform() maps between two images using an input and output profile and an intent. The input image must have a format matching the input profile (eg. 4 bands for a CMYK profile). The output image will have a form matching the output profile (eg. 3 bands for an RGB output profile). The input image must be 8 or 16 bit unsigned integer. The output image is always 8 bit unsigned int. im_icc_import() takes an image to D50 Lab float (profile interconnect space) from device space. The input image must match the format expected by the profile: for example, a printer profile will usually need 4 band CMYK data. The input image must be 8 or 16 bit unsigned integer. im_icc_export_depth() takes an image from D50 Lab float back to device space. The output image will match the format of the profile: for example, a screen profile will write 3 band RGB data. The output image biut depth can be set to 8 or 16 with the depth parameter. im_icc_export() behaves just as im_icc_export_depth(), but with depth always 8 bit. im_icc_ac2rc() converts an image from D50 absolute to media relative colorimetry using the media white point found in the ICC profile.

RETURN VALUE
The functions return 0 on success and -1 on error.

SEE ALSO
im_LabQ2Lab(3), im_Lab2XYZ(3).

COPYRIGHT
The National Gallery