Sophie: libvips-devel-7.18.2-1mdv2010.0 i586

libvips-devel-7.18.2-1mdv2010.0.i586.rpm

<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->

<html>
<head>
<title>IM_ICC_*()(3) manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>

<h2><a name='sect0' href='#toc0'>Name</a></h2>
im_icc_present, im_icc_transform, im_icc_import, im_icc_import_embedded,
im_icc_export, im_icc_export_depth - transform images using ICC profiles

<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
#include &lt;vips/vips.h&gt; 
<p> #define VIPS_INTENT_PERCEPTUAL (0) <br>
#define <a href='VIPS_INTENT_RELATIVE_COLORIMETRIC.1.html'>VIPS_INTENT_RELATIVE_COLORIMETRIC (1)</a>
 <br>
#define <a href='VIPS_INTENT_SATURATION.2.html'>VIPS_INTENT_SATURATION (2)</a>
 <br>
#define <a href='VIPS_INTENT_ABSOLUTE_COLORIMETRIC.3.html'>VIPS_INTENT_ABSOLUTE_COLORIMETRIC (3)</a>
 
<p> int <br>
im_icc_present( void ) <br>
int <br>
im_icc_transform( IMAGE *in, IMAGE *out, <br>
  const char *input_profile_filename,<br>
 <br>
  const char *output_profile_filename,<br>
 <br>
  int intent )<br>
 
<p> int <br>
im_icc_import( IMAGE *in, IMAGE *out, <br>
  const char *input_profile_filename, int intent )<br>
 
<p> int <br>
im_icc_import_embedded( IMAGE *in, IMAGE *out, <br>
  int intent )<br>
 
<p> int <br>
im_icc_export_depth( IMAGE *in, IMAGE *out, int depth, <br>
  const char *output_profile_filename, int intent )<br>
 
<p> int <br>
im_icc_export( IMAGE *in, IMAGE *out, <br>
  const char *output_profile_filename, int intent )<br>
 
<p> int <br>
im_icc_ac2rc( IMAGE *in, IMAGE *out, <br>
  const char *profile_filename )<br>
 
<p> 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<a href='im_icc_present.3.html'><b>im_icc_present(3)</b></a>
 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. 
<p> <a href='im_icc_transform.3.html'><b>im_icc_transform(3)</b></a>
 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. The output profile is attached
to the output image under the name  <b>icc-profile-data.</b> Functions like <a href='im_vips2jpeg.3.html'><b>im_vips2jpeg(3)</b></a>

will then attach the profile to the files they create. 
<p> <a href='im_icc_import.3.html'><b>im_icc_import(3)</b></a>

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. 
<p> <a href='im_icc_import_embedded.3.html'><b>im_icc_import_embedded(3)</b></a>
 takes
an image to D50 Lab float (profile interconnect space) from device space,
using the profile embedded in the image. If there is no embedded profile,
an error is returned. Test for the presence of a profile with <a href='im_header_get_type.3.html'><b>im_header_get_type(3)</a>
.</b>

<p> <a href='im_icc_export_depth.3.html'><b>im_icc_export_depth(3)</b></a>
 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.  The profile is attached
to the output image under  the name  <b>icc-profile-data.</b> Functions like <a href='im_vips2jpeg.3.html'><b>im_vips2jpeg(3)</b></a>

will then attach the profile to the files they create. 
<p> <a href='im_icc_export.3.html'><b>im_icc_export(3)</b></a>

behaves just as  <b>im_icc_export_depth(), </b> but with depth always 8 bit. 
<p> <a href='im_icc_ac2rc.3.html'><b>im_icc_ac2rc(3)</b></a>

converts an image from D50 absolute to media relative colorimetry using
the media white point found in the ICC profile. 
<p> 
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
The functions
return 0 on success and -1 on error. 
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_LabQ2Lab.3.html'>im_LabQ2Lab(3)</a>
, <a href='im_Lab2XYZ.3.html'>im_Lab2XYZ(3)</a>
.

<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
The National Gallery 
<p> <p>

<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Return Value</a></li>
<li><a name='toc4' href='#sect4'>See Also</a></li>
<li><a name='toc5' href='#sect5'>Copyright</a></li>
</ul>
</body>
</html>