<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>IM_MAPLUT(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_maplut - map an image through a lookup table
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
#include <vips/vips.h>
<p> int im_maplut(in, out, lut) <br>
IMAGE *in, *out, *lut;
<p>
<h2><a name='sect2' href='#toc2'>Description</a></h2>
im_maplut() maps an image through another
image, acting as a LUT (Look Up Table). The lut may have any type, and
the output image will be of that type.
<p> The input image must be an unsigned
integer types, that is, it must be one of FMTUCHAR, FMTUSHORT or FMTUINT.
<p> If the input is FMTUCHAR, then the LUT must have 256 elements, in other
words, lut->Xsize * lut->Ysize == 256.
<p> If the input is FMTUSHORT or FMTUINT,
then the lut may have any number of elements, and input pels whose value
is greater than lut->Xsize * lut->Ysize are mapped with the last LUT element.
The function counts and prints the number of image elements which overflow
in this way.
<p> As regards bands, there are three cases:
<p> - If LUT has one
band, then the input may have any number of bands, and<br>
each band will pass through the same LUT.<br>
<p> - If LUT has the same number of bands as the input, then each band
of the<br>
input will be LUTed separately.<br>
<p> - If the input has one band, then the LUT may have any number of bands,
and<br>
the output will have the same number of bands as the LUT.<br>
<p>
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
All functions returns 0 on success and -1 on error.
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_histgr.3.html'>im_histgr(3)</a>
,
<a href='im_hsp.3.html'>im_hsp(3)</a>
, <a href='im_heq.3.html'>im_heq(3)</a>
, <a href='im_identity.3.html'>im_identity(3)</a>
.
<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
1995, National Gallery and
Birkbeck College
<h2><a name='sect6' href='#toc6'>Authors</a></h2>
J. Cupitt, 1995 <br>
N. Dessipris - 10/05/1991 <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>
<li><a name='toc6' href='#sect6'>Authors</a></li>
</ul>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
c109337651527e96d7bb9adc83c5b18a
>
files
>
390
