granicus.if.org Git - imagemagick/blob - www/api/composite.html

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4
   5     <title>ImageMagick: MagickCore, C API for ImageMagick: Composite an Image</title>
   6   <meta http-equiv="content-type" content="text/html; charset=utf-8">
   7   <meta name="application-name" content="ImageMagick">
   8   <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.">
   9   <meta name="application-url" content="http://www.imagemagick.org">
  10   <meta name="generator" content="PHP">
  11   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, composite, an, image, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert">
  12   <meta name="rating" content="GENERAL">
  13   <meta name="robots" content="INDEX, FOLLOW">
  14   <meta name="generator" content="ImageMagick Studio LLC">
  15   <meta name="author" content="ImageMagick Studio LLC">
  16   <meta name="revisit-after" content="2 DAYS">
  17   <meta name="resource-type" content="document">
  18   <meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC">
  19   <meta name="distribution" content="Global">
  20   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1">
  21   <link rel="icon" href="../images/wand.png">
  22   <link rel="shortcut icon" href="../images/wand.ico">
  23   <link rel="stylesheet" href="../css/magick.html">
  24 </head>
  25 <body>
  26 <div class="main">
  27 <div class="magick-masthead">
  28   <div class="container">
  29     <script async src="http://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle" style="display:block" data-ad-client="ca-pub-3129977114552745" data-ad-slot="6345125851" data-ad-format="auto"></ins>
  30     <script>
  31     (adsbygoogle = window.adsbygoogle || []).push({});
  32     </script>
  33     <nav class="magick-nav">
  34       <a class="magick-nav-item " href="../index.html">Home</a>
  35       <a class="magick-nav-item " href="../binary-releases.html">Download</a>
  36       <a class="magick-nav-item " href="../command-line-tools.html">Tools</a>
  37       <a class="magick-nav-item " href="../command-line-options.html">Options</a>
  38       <a class="magick-nav-item " href="../resources.html">Resources</a>
  39       <a class="magick-nav-item " href="api.html">Develop</a>
  40       <a class="magick-nav-item " href="http://nextgen.imagemagick.org/script/search.php">Search</a>
  41       <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
  42     </nav>
  43   </div>
  44 </div>
  45 <div class="container">
  46 <div class="magick-header">
  47 <p class="text-center"><a href="composite.html#CompositeImage">CompositeImage</a> • <a href="composite.html#TextureImage">TextureImage</a></p>
  48
  49 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/composite_8c.html" id="CompositeImage">CompositeImage</a></h2>
  50
  51 <p>CompositeImage() returns the second image composited onto the first at the specified offset, using the specified composite method.</p>
  52
  53 <p>The format of the CompositeImage method is:</p>
  54
  55 <pre class="text">
  56 MagickBooleanType CompositeImage(Image *image,
  57   const Image *source_image,const CompositeOperator compose,
  58   const MagickBooleanType clip_to_self,const ssize_t x_offset,
  59   const ssize_t y_offset,ExceptionInfo *exception)
  60 </pre>
  61
  62 <p>A description of each parameter follows:</p>
  63
  64 <dd>
  65 </dd>
  66
  67 <dd> </dd>
  68 <dl class="dl-horizontal">
  69 <dt>image</dt>
  70 <dd>the canvas image, modified by he composition </dd>
  71
  72 <dd> </dd>
  73 <dt>source_image</dt>
  74 <dd>the source image. </dd>
  75
  76 <dd> </dd>
  77 <dt>compose</dt>
  78 <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>
  79
  80 <dd> </dd>
  81 <dt>clip_to_self</dt>
  82 <dd>set to MagickTrue to limit composition to area composed. </dd>
  83
  84 <dd> </dd>
  85 <dt>x_offset</dt>
  86 <dd>the column offset of the composited image. </dd>
  87
  88 <dd> </dd>
  89 <dt>y_offset</dt>
  90 <dd>the row offset of the composited image. </dd>
  91
  92 <dd> Extra Controls from Image meta-data in 'image' (artifacts) </dd>
  93
  94 <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>
  95
  96 <dd> Compose methods needing such arguments include "BlendCompositeOp" and "DisplaceCompositeOp". </dd>
  97
  98 <dd> </dd>
  99 <dt>exception</dt>
 100 <dd>return any errors or warnings in this structure. </dd>
 101
 102 <dd>  </dd>
 103 </dl>
 104 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/composite_8c.html" id="TextureImage">TextureImage</a></h2>
 105
 106 <p>TextureImage() repeatedly tiles the texture image across and down the image canvas.</p>
 107
 108 <p>The format of the TextureImage method is:</p>
 109
 110 <pre class="text">
 111 MagickBooleanType TextureImage(Image *image,const Image *texture,
 112   ExceptionInfo *exception)
 113 </pre>
 114
 115 <p>A description of each parameter follows:</p>
 116
 117 <dd>
 118 </dd>
 119
 120 <dd> </dd>
 121 <dl class="dl-horizontal">
 122 <dt>image</dt>
 123 <dd>the image. </dd>
 124
 125 <dd> </dd>
 126 <dt>texture_image</dt>
 127 <dd>This image is the texture to layer on the background. </dd>
 128
 129 <dd>  </dd>
 130 </dl>
 131 </div>
 132   <footer class="magick-footer">
 133     <p><a href="../support.html">Donate</a> •
 134      <a href="../sitemap.html">Sitemap</a> •
 135     <a href="../links.html">Related</a> •
 136     <a href="../architecture.html">Architecture</a>
 137 </p>
 138     <p><a href="composite.html#">Back to top</a> •
 139     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
 140     <a href="http://nextgen.imagemagick.org/script/contact.php">Contact Us</a></p>
 141         <p><small>©  1999-2015 ImageMagick Studio LLC</small></p>
 142   </footer>
 143 </div><!-- /.container -->
 144
 145   <script src="http://nextgen.imagemagick.org/js/magick.html"></script>
 146 </div>
 147 </body>
 148 </html>