136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<!DOCTYPE html>
636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<html lang="en">
736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<head>
836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <title>ImageMagick: MagickCore, C API for ImageMagick: Composite an Image</title>
1036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
1136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="application-name" content="ImageMagick"/>
1236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
1336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="application-url" content="http://www.imagemagick.org"/>
1436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="generator" content="PHP"/>
1536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="keywords" content="magickcore, c, api, for, imagemagick:, composite, an, image, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
1636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="rating" content="GENERAL"/>
1736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="robots" content="INDEX, FOLLOW"/>
1836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="generator" content="ImageMagick Studio LLC"/>
1936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="author" content="ImageMagick Studio LLC"/>
2036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="revisit-after" content="2 DAYS"/>
2136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="resource-type" content="document"/>
227ce65e7125a4e1df1a274ce373c537a9df9c16cdCristy  <meta name="copyright" content="Copyright (c) 1999-2016 ImageMagick Studio LLC"/>
2336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="distribution" content="Global"/>
2436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
25882d9f4ab22246b0110b960e923614ae9c53702aCristy  <link rel="icon" href="../image/wand.png"/>
26882d9f4ab22246b0110b960e923614ae9c53702aCristy  <link rel="shortcut icon" href="../image/wand.ico"/>
27882d9f4ab22246b0110b960e923614ae9c53702aCristy  <link rel="stylesheet" href="../css/magick.php"/>
2836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</head>
2936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<body>
3036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="main">
3136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="magick-masthead">
3236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <div class="container">
33882d9f4ab22246b0110b960e923614ae9c53702aCristy    <script async="async" src="http://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
3436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         style="display:block"
3536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         data-ad-client="ca-pub-3129977114552745"
3636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         data-ad-slot="6345125851"
3736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         data-ad-format="auto"></ins>
3836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <script>
39882d9f4ab22246b0110b960e923614ae9c53702aCristy      (adsbygoogle = window.adsbygoogle || []).push({});
4036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    </script>
4136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <nav class="magick-nav">
4236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../index.php">Home</a>
4336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/binary-releases.php">Download</a>
4436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/command-line-tools.php">Tools</a>
4536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/command-line-options.php">Options</a>
4636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/resources.php">Resources</a>
4736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/api.php">Develop</a>
4836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/search.php">Search</a>
4936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
5036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    </nav>
5136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  </div>
5236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div>
5336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="container">
5436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="magick-header">
5536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p class="text-center"><a href="composite.php#CompositeImage">CompositeImage</a> &bull; <a href="composite.php#TextureImage">TextureImage</a></p>
5636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
5736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<h2><a href="http://nextgen.imagemagick.org/api/MagickCore/composite_8c.html" id="CompositeImage">CompositeImage</a></h2>
5836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
5936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>CompositeImage() returns the second image composited onto the first at the specified offset, using the specified composite method.</p>
6036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
6136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>The format of the CompositeImage method is:</p>
6236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
6336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<pre class="text">
6436421ee45722da418b8ab99d7e6358e4f86b9f1eCristyMagickBooleanType CompositeImage(Image *image,
6536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  const Image *source_image,const CompositeOperator compose,
6636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  const MagickBooleanType clip_to_self,const ssize_t x_offset,
6736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  const ssize_t y_offset,ExceptionInfo *exception)
6836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</pre>
6936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
7036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>A description of each parameter follows:</p>
7136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
7236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>
7336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dd>
7436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
7536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
7636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dl class="dl-horizontal">
7736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>image</dt>
7836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the canvas image, modified by he composition </dd>
7936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
8036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
8136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>source_image</dt>
8236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the source image. </dd>
8336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
8436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
8536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>compose</dt>
8636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>This operator affects how the composite is applied to the image.  The operators and how they are utilized are listed here http://www.w3.org/TR/SVG12/#compositing. </dd>
8736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
8836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
8936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>clip_to_self</dt>
9036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>set to MagickTrue to limit composition to area composed. </dd>
9136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
9236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
9336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>x_offset</dt>
9436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the column offset of the composited image. </dd>
9536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
9636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
9736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>y_offset</dt>
9836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the row offset of the composited image. </dd>
9936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> Extra Controls from Image meta-data in 'image' (artifacts) </dd>
10136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> o "compose:args" A string containing extra numerical arguments for specific compose methods, generally expressed as a 'geometry' or a comma separated list of numbers. </dd>
10336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> Compose methods needing such arguments include "BlendCompositeOp" and "DisplaceCompositeOp". </dd>
10536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
10736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>exception</dt>
10836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>return any errors or warnings in this structure. </dd>
10936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>  </dd>
11136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dl>
11236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<h2><a href="http://nextgen.imagemagick.org/api/MagickCore/composite_8c.html" id="TextureImage">TextureImage</a></h2>
11336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>TextureImage() repeatedly tiles the texture image across and down the image canvas.</p>
11536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>The format of the TextureImage method is:</p>
11736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<pre class="text">
11936421ee45722da418b8ab99d7e6358e4f86b9f1eCristyMagickBooleanType TextureImage(Image *image,const Image *texture,
12036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  ExceptionInfo *exception)
12136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</pre>
12236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
12336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>A description of each parameter follows:</p>
12436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
12536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>
12636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dd>
12736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
12836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
12936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dl class="dl-horizontal">
13036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>image</dt>
13136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the image. </dd>
13236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
13336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
13436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>texture_image</dt>
13536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>This image is the texture to layer on the background. </dd>
13636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
13736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>  </dd>
13836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dl>
13936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div>
14036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <footer class="magick-footer">
14136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <p><a href="../script/support.php">Donate</a> •
14236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy     <a href="../script/sitemap.php">Sitemap</a> •
14336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="../script/links.php">Related</a> •
14436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="../script/architecture.php">Architecture</a>
14536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</p>
14636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <p><a href="composite.php#">Back to top</a> •
14736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
14836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="../script/contact.php">Contact Us</a></p>
1497ce65e7125a4e1df1a274ce373c537a9df9c16cdCristy        <p><small>©  1999-2016 ImageMagick Studio LLC</small></p>
15036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  </footer>
15136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div><!-- /.container -->
15236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
153882d9f4ab22246b0110b960e923614ae9c53702aCristy  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
15436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <script src="http://nextgen.imagemagick.org/js/magick.php"></script>
15536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div>
15636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</body>
15736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</html>
158