IM_LAB2UCS

Section: C Library Functions (3)
Updated: 2 December 1992
Index Return to Main Contents
 

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>

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(3) for an explanation of the colour spaces and the basic conversion functions.

im_Lab2UCS(3), 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(3), im_dE_fromLab(3), im_LabQ2Lab(3), im_Lab2disp(3).  

COPYRIGHT

National Gallery and Birkbeck College, 1990 - 1993  

AUTHOR

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