Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > 7faa4cd12598db7d59564e3dc9a0913c > files > 224

vips-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_EMBED(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_embed - extract a portion of an image 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>#include &lt;vips/vips.h&gt;</b>

<p> int im_embed( in, out, type, x, y, w, h ) <br>
IMAGE *in, *out; <br>
int type; <br>
int x, y, w, h; 
<p> 
<h2><a name='sect2' href='#toc2'>Description</a></h2>
im_embed() embeds in within a larger image
(size w by h), with in&rsquo;s top left-hand corner at position (x,y) within the
output image. The value of type controls what appears in the new pels.  
<p>
 0 - black pels (all bytes 0)<br>
  1 - extend pels from image to edge<br>
  2 - tile pels from image<br>
  3 - mirror pels from image<br>
  4 - white pels (all bytes 255)<br>
 
<p> Works for any size image, any number of bands, any type. Works for LABPACK
coded images too.  
<p> 
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
The function returns 0 on success and -1
on error. 
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_insert.3.html'>im_insert(3)</a>
, <a href='im_extract.3.html'>im_extract(3)</a>
, <a href='im_region_region.3.html'>im_region_region(3)</a>
, <a href='im_fill_copy.3.html'>im_fill_copy(3)</a>
.

<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
National Gallery, 1995. 
<h2><a name='sect6' href='#toc6'>Author</a></h2>
J. Cupitt - 11/04/1995 <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>