<imdoc>
<utils apps=composite>
<title>Composite</title>
<gm>
<sect NAME="composite">gm composite
</gm>
<im>
<sect NAME="comp-top">NAME
composite - composite images together.
</sect>
<format type=html>
<sect NAME="comp-contents">Contents

<dl>
<dt>
<a href="#comp-syno">Synopsis</a>
</dt>

<dt>
<a href="#comp-desc">Description</a>
</dt>

<dt>
<a href="#comp-exam">Examples</a>
</dt>

<dt>
<a href="#comp-opti">Options</a>
</dt>

</dl>
</format>
</sect>

<sect NAME="comp-syno">Synopsis

<p>
<s>gm composite</s> <s>[</s> <i>options</i> <s>... ]</s>
<i>change-image base-image</i>
<s>[</s> <i>mask-image</i> <s>]</s> <i>output-image</i>
</p>

</sect>

<sect NAME="comp-desc">Description
</im>
<p>
<s>composite</s> composites (combines) images to create new images.</p>
<p><i>base-image</i> is the base image and <i>change-image</i> contains the changes.
<i>ouput-image</i> is the result, and normally has the same dimensions
as <i>base-image</i>.
</p>

<p>
The optional <i>mask-image</i> can be used to provide opacity information
for <i>change-image</i> when it has none or if you want a different mask.
A mask image is typically grayscale and the same size as
<s>base-image</s>. If <i>mask-image</i> is not grayscale, it is converted
to grayscale and the resulting intensities are used as opacity
information.</p>

</sect>

<sect NAME="comp-exam">Examples

<p>
To composite an image of a cockatoo with a perch, use:</p>

<pre>
    gm composite cockatoo.miff perch.ras composite.miff
</pre>

<p>
To compute the difference between images in a series, use:</p>

<format type=man,tex>
<pre>
    gm composite -compose difference series.2 series.1
              difference.miff
</pre>
</format>
<format type=html>
<pre>
    gm composite -compose difference series.2 series.1 difference.miff
</pre>
</format>

<p>
To composite an image of a cockatoo with a perch starting at location (100,150),
use:</p>

<format type=man,tex>
<pre>
    gm composite -geometry +100+150 cockatoo.miff
              perch.ras composite.miff
</pre>
</format>
<format type=html>
<pre>
    gm composite -geometry +100+150 cockatoo.miff perch.ras composite.miff
</pre>
</format>


<p>
To tile a logo across your image of a cockatoo, use</p>

<pre>
    gm convert +shade 30x60 cockatoo.miff mask.miff
    gm composite -compose bumpmap -tile logo.png
              cockatoo.miff mask.miff composite.miff
</pre>

<p>
To composite a red, green, and blue color plane into a single composite image,
try</p>

<format type=man,tex>
<pre>
    gm composite -compose CopyGreen green.png red.png
              red-green.png
    gm composite -compose CopyBlue blue.png red-green.png 
              composite.png
</pre>
</format>
<format type=html>
<pre>
    gm composite -compose CopyGreen green.png red.png red-green.png
    gm composite -compose CopyBlue blue.png red-green.png composite.png
</pre>
</format>

</sect>
<back>

<!-- --------------------- Options ---------------------------------- -->

<sect NAME="comp-opti">Options

<p>
Options are processed in command line order. Any option you specify on
the command line remains in effect only for the image that follows.  All
options are reset to their default values after each image is read.</p>
<p>
For a more detailed description of each option, see
<gm>
Options, above.
</gm>
<im>
<format type=man,tex>
<i>GraphicsMagick(1)</i>.
</format>
<format type=html>
<a href="GraphicsMagick.html"><i>GraphicsMagick(1)</i></a>.
</format>
</im>
</p>

</utils>

<include file=brief_options.imdoc>

<utils apps=composite>
<p>
For a more detailed description of each option, see
<gm>
Options, above.
</gm>
<im>
<format type=man,tex>
<i>GraphicsMagick(1)</i>.
</format>
<format type=html>
<a href="GraphicsMagick.html"><i>GraphicsMagick(1)</i></a>.
</format>
</im>
</p>

</sect>
<im>
<back>

<format type=man>
<sect NAME="comp-also">SEE ALSO
<p>
GraphicsMagick(1),
animate(1),
compare(1),
conjure(1),
convert(1),
display(1),
identify(1),
import(1),
mogrify(1),
montage(1)
</p>
</sect>
</format>
</im>
</utils>
</imdoc>
