Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > c109337651527e96d7bb9adc83c5b18a > files > 432

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_MSB(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_msb, im_msb_band - Convert to uchar by discarding bits<br>
 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<br>
<pre>#include &lt;vips/vips.h&gt;
int im_msb( IMAGE *in, IMAGE *out );
int im_msb_band( IMAGE *in, IMAGE *out, int band );</pre>
<h2><a name='sect2' href='#toc2'></b>Description</a></h2>
<a href='im_msb.3.html'><b>im_msb(3)</b></a>

converts char, short, or int images (including LABQ coded ones) into unsigned
char images, very quickly, by discarding the lower order bits.  Once scaled
to char, signed values are converted to unsigned by adding 128. <p>
For a signed
short (16 bit) image, <p>
im_msb( in, out ); <p>
is equivalent to: <p>
im_lintra( (1.0/256.0),
in, 128.0, temp ); <br>
im_clip2fmt( temp, out, IM_BANDFMT_UCHAR ); <p>
but much faster. <p>
For any image
which uses the whole range of values for its band format, <p>
im_msb( in, out
); <p>
is equivalent to: <p>
im_scale( in, out ); <p>
but a great deal faster, and
without evaluating the input twice. <p>
<a href='im_msb_band.3.html'><b>im_msb_band(3)</b></a>
 is as <a href='im_msb.3.html'><b>im_msb(3)</b></a>
, except
that all but one of the bands are also discarded. <p>
im_msb_band( in, out,
i ); <p>
is equivalent to: <p>
im_msb( in, temp ); <br>
im_extract_bands( temp, out, i, 1 ); <p>
but again, faster. 
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
The
functions returns 0 on success and -1 on error. 
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_lintra.3.html'>im_lintra(3)</a>
, <a href='im_scale.3.html'>im_scale(3)</a>
,
<a href='im_clip.3.html'>im_clip(3)</a>
 
<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
<br>
Copyright 2006, The Nottingham Trent University. 
<h2><a name='sect6' href='#toc6'>Author</a></h2>
Tom Vajzovic <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'>Author</a></li>
</ul>
</body>
</html>