1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
1
<?xml version="1.0" encoding="utf-8" ?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
<title>composite - Merge image pixels using a specified algorithm</title>
5
<link rev="made" href="mailto:bfriesen@blade.simplesystems.org" />
5
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6
<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
7
<title>composite</title>
8
<link rel="stylesheet" href="../docutils-api.css" type="text/css" />
8
<body style="background-color: white">
10
<P><a name="__index__"></a></P>
15
<li><a href="#name">NAME</a></li>
16
<li><a href="#synopsis">SYNOPSIS</a></li>
17
<li><a href="#function_descriptions">FUNCTION DESCRIPTIONS</a></li>
20
<li><a href="#compositeimage">CompositeImage</a></li>
29
<h1><a name="name">NAME</a></h1>
30
<P>composite - Merge image pixels using a specified algorithm</P>
34
<h1><a name="synopsis">SYNOPSIS</a></h1>
35
<P>unsigned int <strong>CompositeImage</strong>( Image *canvas_image, const CompositeOperator compose, const Image *composite_image, const long x_offset, const long y_offset );</P>
39
<h1><a name="function_descriptions">FUNCTION DESCRIPTIONS</a></h1>
42
<h2><a name="compositeimage">CompositeImage</a></h2>
43
<blockquote>CompositeImage() returns the second image ( composite_image ) composited onto the first ( canvas_image ) at the specified offsets. </blockquote><P>The format of the CompositeImage method is:</P>
44
<blockquote>unsigned int CompositeImage ( <A HREF="types.html#Image">Image</A> *canvas_image, const <A HREF="types.html#CompositeOperator">CompositeOperator</A> compose, const <A HREF="types.html#Image">Image</A> *composite_image, const long x_offset, const long y_offset ); </blockquote><P>A description of each parameter follows:</P>
46
<dt><strong><a name="item_o_canvas_image_3a">canvas_image:</a></strong><br />
49
The image to be updated.
52
<dt><strong><a name="item_o_compose_3a">compose:</a></strong><br />
55
This operator affects how the composite is applied to the image. The default is Over. Choose from one of these operators: OverCompositeOp, InCompositeOp, OutCompositeOP, AtopCompositeOP, XorCompositeOP, PlusCompositeOP, MinusCompositeOP, AddCompositeOP, SubtractCompositeOP, DifferenceCompositeOP, BumpmapCompositeOP, CopyCompositeOP, CopyRedCompositeOP, CopyGreenCompositeOP, CopyBlueCompositeOP, CopyOpacityCompositeOP.
58
<dt><strong><a name="item_o_composite_image_3a">composite_image:</a></strong><br />
64
<dt><strong><a name="item_o_x_offset_3a">x_offset:</a></strong><br />
67
The column offset of the composited image.
70
<dt><strong><a name="item_o_y_offset_3a">y_offset:</a></strong><br />
73
The row offset of the composited image.
14
<img src="../images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" />
15
<span class="title">GraphicsMagick</span>
16
<form action="http://www.google.com/search">
18
<input type=hidden name="domains" value="www.graphicsmagick.org" />
19
<input type=hidden name="sitesearch" value="www.graphicsmagick.org" />
20
<input type=text name="q" size="25" maxlength="255" />
21
<input type=submit name="sa" value="Search" />
28
<li><a href="../index.html">Home</a></li>
29
<li><a href="../Copyright.html">License</a></li>
30
<li><a href="../mission.html">Mission</a></li>
31
<li><a href="../download.html">Download</a></li>
32
<li><a href="../README.html">Installation</a></li>
33
<li><a href="../FAQ.html">FAQ</a></li>
34
<li><a href="../NEWS.html">News</a> </li>
35
<li><a href="../formats.html">Formats</a></li>
40
<li><a href="../process.html">Process</a></li>
41
<li><a href="../contribute.html">Contribute</a></li>
42
<li><a href="../CVS.html">CVS</a></li>
43
<li><a href="http://sourceforge.net/mail/?group_id=73485" target="top_">Mailing Lists</a></li>
44
<li><a href="../Changelog.html">ChangeLog</a></li>
45
<li><a href="http://sourceforge.net/projects/graphicsmagick/" target="top_">Report Bugs</a></li>
46
<li><a href="../utilities.html">Utilities</a></li>
47
<li><a href="../programming.html">Programming</a></li>
48
<li><a href="../links.html">Links</a></li>
51
<div class="document" id="composite">
52
<h1 class="title">composite</h1>
53
<h2 class="subtitle" id="merge-image-pixels-using-a-specified-algorithm">Merge image pixels using a specified algorithm</h2>
54
<div class="contents topic">
55
<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
57
<li><a class="reference" href="#compositeimage" id="id1" name="id1">CompositeImage</a></li>
61
<h1><a class="toc-backref" href="#id1" id="compositeimage" name="compositeimage">CompositeImage</a></h1>
63
<h2><a id="synopsis" name="synopsis">Synopsis</a></h2>
64
<pre class="literal-block">
65
MagickPassFail CompositeImage( <a class="reference" href="types.html#image">Image</a> *canvas_image, const <a class="reference" href="types.html#compositeoperator">CompositeOperator</a> compose,
66
const <a class="reference" href="types.html#image">Image</a> *composite_image, const long x_offset,
67
const long y_offset );
71
<h2><a id="description" name="description">Description</a></h2>
72
<p>CompositeImage() composites the second image (composite_image) onto the
73
first (canvas_image) at the specified offsets.</p>
74
<p>The format of the CompositeImage method is:</p>
75
<pre class="literal-block">
76
MagickPassFail CompositeImage( <a class="reference" href="types.html#image">Image</a> *canvas_image, const <a class="reference" href="types.html#compositeoperator">CompositeOperator</a> compose,
77
const <a class="reference" href="types.html#image">Image</a> *composite_image, const long x_offset,
78
const long y_offset );
81
<dt>canvas_image:</dt>
82
<dd>The image to be updated.</dd>
84
<dd>This operator affects how the composite is applied to
85
the image. Choose from one of these operators: AddCompositeOp,
86
AtopCompositeOp, BumpmapCompositeOp, ClearCompositeOp,
87
ColorizeCompositeOp, CopyBlackCompositeOp, CopyBlueCompositeOp,
88
CopyCompositeOp, CopyCyanCompositeOp,CopyGreenCompositeOp,
89
CopyMagentaCompositeOp, CopyOpacityCompositeOp, CopyRedCompositeOp,
90
CopyYellowCompositeOp, DarkenCompositeOp, DifferenceCompositeOp,
91
DisplaceCompositeOp, DissolveCompositeOp, DivideCompositeOp,
92
HueCompositeOp, InCompositeOp, LightenCompositeOp, LuminizeCompositeOp,
93
MinusCompositeOp, ModulateCompositeOp, MultiplyCompositeOp,
94
NoCompositeOp, OutCompositeOp, OverlayCompositeOp, PlusCompositeOp,
95
SaturateCompositeOp, ScreenCompositeOp, SubtractCompositeOp,
96
ThresholdCompositeOp, XorCompositeOp.</dd>
97
<dt>composite_image:</dt>
98
<dd>The composite image.</dd>
100
<dd>The column offset of the composited image.</dd>
102
<dd>The row offset of the composited image.</dd>
108
<hr class="footer" />
109
Generated on: 2009-01-13 20:59 UTC.