<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_BUILDLUT(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_buildlut - build a LUT from a set of x/y points <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> #include <vips/vips.h> <p> int <br> im_buildlut( DOUBLEMASK *input, IMAGE *output ) <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_buildlut.3.html'><b>im_buildlut(3)</b></a> constructs a LUT, interpolating a set of x/y points. Interpolation is strictly piecewise linear. For example, if the input is: <p> 0 <tt> </tt> <tt> </tt> 0<br> 128<tt> </tt> <tt> </tt> 20<br> 255 <tt> </tt> <tt> </tt> 100<br> <p> we generate the values: <p> index value<br> <p> 0<tt> </tt> <tt> </tt> 0<br> 1<tt> </tt> <tt> </tt> 0.01<br> .. etc. linear interpolation<br> 128<tt> </tt> <tt> </tt> 20<br> 129<tt> </tt> <tt> </tt> 20.5<br> .. etc. linear interpolation<br> 255<tt> </tt> <tt> </tt> 100<br> <p> (we don’t generate the index column, that’s just there to show the position in the table) <p> The x/y points don’t need to be sorted: we do that. You can have several Ys: each becomes a band in the output LUT. X can start at any integer value, including negatives. <p> <h2><a name='sect3' href='#toc3'>Return Value</a></h2> -1 on error, otherwise 0 <h2><a name='sect4' href='#toc4'>See Also</a></h2> <a href='im_invertlut.3.html'>im_invertlut(3)</a> , <a href='im_identity.3.html'>im_identity(3)</a> . <h2><a name='sect5' href='#toc5'>Copyright</a></h2> 2006, Imperial College <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>