<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
<title>render</title>
<link rel="stylesheet" href="../docutils-api.css" type="text/css" />
</head>
<body>
<div class="banner">
<span>
<img src="../images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" />
<span class="title">GraphicsMagick</span>
<form action="http://www.google.com/search">
Search site
<input type=hidden name="domains" value="www.graphicsmagick.org" />
<input type=hidden name="sitesearch" value="www.graphicsmagick.org" />
<input type=text name="q" size="25" maxlength="255" />
<input type=submit name="sa" value="Search" />
</form>
</span>
</div>
<div class="navmenu">
<ul>
<li><a href="../index.html">Home</a></li>
<li><a href="../Copyright.html">License</a></li>
<li><a href="../mission.html">Mission</a></li>
<li><a href="../download.html">Download</a></li>
<li><a href="../README.html">Installation</a></li>
<li><a href="../FAQ.html">FAQ</a></li>
<li><a href="../NEWS.html">News</a> </li>
<li><a href="../formats.html">Formats</a></li>
</ul>
</div>
<div class="navmenu">
<ul>
<li><a href="../process.html">Process</a></li>
<li><a href="../contribute.html">Contribute</a></li>
<li><a href="../CVS.html">CVS</a></li>
<li><a href="http://sourceforge.net/mail/?group_id=73485" target="top_">Mailing Lists</a></li>
<li><a href="../Changelog.html">ChangeLog</a></li>
<li><a href="http://sourceforge.net/projects/graphicsmagick/" target="top_">Report Bugs</a></li>
<li><a href="../utilities.html">Utilities</a></li>
<li><a href="../programming.html">Programming</a></li>
<li><a href="../links.html">Links</a></li>
</ul>
</div>
<div class="document" id="render">
<h1 class="title">render</h1>
<h2 class="subtitle" id="low-level-methods-to-draw-on-an-image">Low-level methods to draw on an image</h2>
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
<ul class="simple">
<li><a class="reference internal" href="#clonedrawinfo" id="id11">CloneDrawInfo</a></li>
<li><a class="reference internal" href="#destroydrawinfo" id="id12">DestroyDrawInfo</a></li>
<li><a class="reference internal" href="#drawaffineimage" id="id13">DrawAffineImage</a></li>
<li><a class="reference internal" href="#drawclippath" id="id14">DrawClipPath</a></li>
<li><a class="reference internal" href="#drawimage" id="id15">DrawImage</a></li>
<li><a class="reference internal" href="#drawpatternpath" id="id16">DrawPatternPath</a></li>
</ul>
</div>
<div class="section" id="clonedrawinfo">
<h1><a class="toc-backref" href="#id11">CloneDrawInfo</a></h1>
<div class="section" id="synopsis">
<h2>Synopsis</h2>
<pre class="literal-block">
<a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *CloneDrawInfo( const <a class="reference external" href="../api/types.html#imageinfo">ImageInfo</a> *image_info, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info );
</pre>
</div>
<div class="section" id="description">
<h2>Description</h2>
<p>CloneDrawInfo() makes a copy of the given draw info structure. If NULL
is specified, a new image info structure is created initialized to
default values.</p>
<p>The format of the CloneDrawInfo method is:</p>
<pre class="literal-block">
<a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *CloneDrawInfo( const <a class="reference external" href="../api/types.html#imageinfo">ImageInfo</a> *image_info, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info );
</pre>
<dl class="docutils">
<dt>image_info:</dt>
<dd>The image info.</dd>
<dt>draw_info:</dt>
<dd>The draw info.</dd>
</dl>
</div>
</div>
<div class="section" id="destroydrawinfo">
<h1><a class="toc-backref" href="#id12">DestroyDrawInfo</a></h1>
<div class="section" id="id1">
<h2>Synopsis</h2>
<pre class="literal-block">
void DestroyDrawInfo( <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info );
</pre>
</div>
<div class="section" id="id2">
<h2>Description</h2>
<p>DestroyDrawInfo() deallocates memory associated with an DrawInfo
structure.</p>
<p>The format of the DestroyDrawInfo method is:</p>
<pre class="literal-block">
void DestroyDrawInfo( <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info );
</pre>
<p>A description of each parameter follows:</p>
<dl class="docutils">
<dt>draw_info:</dt>
<dd>The draw info.</dd>
</dl>
</div>
</div>
<div class="section" id="drawaffineimage">
<h1><a class="toc-backref" href="#id13">DrawAffineImage</a></h1>
<div class="section" id="id3">
<h2>Synopsis</h2>
<pre class="literal-block">
unsigned int DrawAffineImage( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#image">Image</a> *composite,
const <a class="reference external" href="../api/types.html#affinematrix">AffineMatrix</a> *affine );
</pre>
</div>
<div class="section" id="id4">
<h2>Description</h2>
<p>DrawAffineImage() composites the source over the destination image as
dictated by the affine transform.</p>
<p>The format of the DrawAffineImage method is:</p>
<pre class="literal-block">
unsigned int DrawAffineImage( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#image">Image</a> *composite,
const <a class="reference external" href="../api/types.html#affinematrix">AffineMatrix</a> *affine );
</pre>
<dl class="docutils">
<dt>image:</dt>
<dd>The image.</dd>
<dt>image:</dt>
<dd>The composite image.</dd>
<dt>affine:</dt>
<dd>The affine transform.</dd>
</dl>
</div>
</div>
<div class="section" id="drawclippath">
<h1><a class="toc-backref" href="#id14">DrawClipPath</a></h1>
<div class="section" id="id5">
<h2>Synopsis</h2>
<pre class="literal-block">
unsigned int DrawClipPath( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info,
const char *name );
</pre>
</div>
<div class="section" id="id6">
<h2>Description</h2>
<p>DrawClipPath() draws the clip path on the image mask.</p>
<p>The format of the DrawClipPath method is:</p>
<pre class="literal-block">
unsigned int DrawClipPath( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info,
const char *name );
</pre>
<dl class="docutils">
<dt>image:</dt>
<dd>The image.</dd>
<dt>draw_info:</dt>
<dd>The draw info.</dd>
<dt>name:</dt>
<dd>The name of the clip path.</dd>
</dl>
</div>
</div>
<div class="section" id="drawimage">
<h1><a class="toc-backref" href="#id15">DrawImage</a></h1>
<div class="section" id="id7">
<h2>Synopsis</h2>
<pre class="literal-block">
unsigned int DrawImage( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info );
</pre>
</div>
<div class="section" id="id8">
<h2>Description</h2>
<p>Use DrawImage() to draw a graphic primitive on your image. The primitive
may be represented as a string or filename. Precede the filename with an
"at" sign (@) and the contents of the file are drawn on the image. You
can affect how text is drawn by setting one or more members of the draw
info structure.</p>
<p>Note that this is a legacy interface. Authors of new code should consider
using the Draw* methods defined by magick/draw.h since they are better
documented and less error prone.</p>
<p>The format of the DrawImage method is:</p>
<pre class="literal-block">
unsigned int DrawImage( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info );
</pre>
<p>A description of each parameter follows:</p>
<dl class="docutils">
<dt>image:</dt>
<dd>The image.</dd>
<dt>draw_info:</dt>
<dd>The draw info.</dd>
</dl>
</div>
</div>
<div class="section" id="drawpatternpath">
<h1><a class="toc-backref" href="#id16">DrawPatternPath</a></h1>
<div class="section" id="id9">
<h2>Synopsis</h2>
<pre class="literal-block">
unsigned int DrawPatternPath( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info,
const char *name, <a class="reference external" href="../api/types.html#image">Image</a> ** pattern );
</pre>
</div>
<div class="section" id="id10">
<h2>Description</h2>
<p>DrawPatternPath() draws a pattern.</p>
<p>The format of the DrawPatternPath method is:</p>
<pre class="literal-block">
unsigned int DrawPatternPath( <a class="reference external" href="../api/types.html#image">Image</a> *image, const <a class="reference external" href="../api/types.html#drawinfo">DrawInfo</a> *draw_info,
const char *name, <a class="reference external" href="../api/types.html#image">Image</a> ** pattern );
</pre>
<dl class="docutils">
<dt>image:</dt>
<dd>The image.</dd>
<dt>draw_info:</dt>
<dd>The draw info.</dd>
<dt>name:</dt>
<dd>The pattern name.</dd>
<dt>image:</dt>
<dd>The image.</dd>
</dl>
</div>
</div>
</div>
<div class="footer">
<hr class="footer" />
Generated on: 2010-03-07 19:17 UTC.
</div>
</body>
</html>
