IM_LAB2UCS(3X)

NAME
im_Lab2UCS, im_LabQ2XYZ, im_UCS2Lab, im_Lab2disp, im_disp2Lab, im_UCS2XYZ, im_XYZ2UCS - derived colour space conversion functions

SYNOPSIS
#include <vips/vips.h>
#include <vips/colour.h> int im_Lab2UCS(in, out)
IMAGE *in, *out; int im_LabQ2XYZ(in, out)
IMAGE *in, *out; int im_UCS2Lab(in, out)
IMAGE *in, *out; int im_Lab2disp(in, out, display)
IMAGE *in, *out;
struct im_col_display *display; int im_disp2Lab(in, out, display)
IMAGE *in, *out;
struct im_col_display *display; int im_UCS2XYZ(in, out)
IMAGE *in, *out; int im_XYZ2UCS(in, out)
IMAGE *in, *out;

DESCRIPTION
These functions are built on the basic VIPS colour space transformations as a convenience for the programmer. See im_Lab2XYZ(3X) for an explanation of the colour spaces and the basic conversion functions. im_Lab2UCS(3X), for example, is defined as:
  int
  im_Lab2UCS( IMAGE *in, IMAGE *out )
  {
     IMAGE *t1 = im_open_local( out,
        "im_Lab2UCS intermediate", "p" );

     if( !t1 ||
        im_Lab2LCh( in, t1 ) ||
        im_LCh2UCS( t1, out ) )
        return( -1 );

     return( 0 );
  }

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

SEE ALSO
im_col_XYZ2rgb(3X), im_dE_fromLab(3X), im_LabQ2Lab(3X), im_Lab2disp(3X).

COPYRIGHT
National Gallery and Birkbeck College, 1990 - 1993

AUTHOR
K. Martinez - 2/12/1992
J. Cupitt - 21/7/93