Sophie

Sophie

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

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>SUBTRACTION(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_subtract - subtracts two images 
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
#include &lt;vips/vips.h&gt; 
<p> int
im_subtract(in1, in2, out) <br>
IMAGE *in1, *in2, *out; 
<h2><a name='sect2' href='#toc2'>Description</a></h2>

<p> This functions calculates in1 - in2
and writes the result in the image descriptor out.  Input images in1 and
in2 should have the same channels and the same sizes; however they can
be of different types.  Only the history of the image descriptor pointed
by in1 is copied to out. 
<p> The type of the output is given by the table:

<p>  in1    - uchar   char   ushort  short  uint  int <br>
  -------|-----------------------------------------<br>
  in2    |<br>
  uchar  | short   short  short   short  int   int<br>
  char   | short   short  short   short  int   int<br>
  ushort | short   short  short   short  int   int<br>
  short  | short   short  short   short  int   int<br>
  uint   | int     int    int     int    int   int<br>
  int    | int     int    int     int    int   int<br>
 
<p> The result of this operation cannot be unsigned. For float types, the
refult is float unless one of the inputs is double, in which case the result
is double. For complex types the result is FMTCOMPLEX, unless one of the
inputs is FMTDPCOMPLEX, in which case the output is FMTDPCOMPLEX. 
<p> 
<h2><a name='sect3' href='#toc3'>Bugs</a></h2>
None
of the functions checks the result for over/underflow. 
<h2><a name='sect4' href='#toc4'>Return Value</a></h2>
All functions
return 0 on success and -1 on error. 
<h2><a name='sect5' href='#toc5'>See Also</a></h2>
<a href='im_add.3.html'>im_add(3)</a>
, <a href='im_lintra.3.html'>im_lintra(3)</a>
, <a href='im_multiply.3.html'>im_multiply(3)</a>
.

<h2><a name='sect6' href='#toc6'>Copyright</a></h2>
National Gallery, 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'>Bugs</a></li>
<li><a name='toc4' href='#sect4'>Return Value</a></li>
<li><a name='toc5' href='#sect5'>See Also</a></li>
<li><a name='toc6' href='#sect6'>Copyright</a></li>
</ul>
</body>
</html>