blob: 63913d058a259ec44fc635d6c758dc8d2188c8b7 [file] [log] [blame]
cristy3eaa0ef2010-03-06 20:35:26 +00001<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
cristy2c839602010-04-03 02:32:08 +00003<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +00004<head>
cristy3de29cc2010-04-15 02:34:44 +00005 <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
cristy3eaa0ef2010-03-06 20:35:26 +00006 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
7 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
cristy3de29cc2010-04-15 02:34:44 +00008 <style type="text/css" media="all">
cristy3eaa0ef2010-03-06 20:35:26 +00009 @import url("../../www/magick.css");
cristy3de29cc2010-04-15 02:34:44 +000010 </style>
cristy3ed852e2009-09-05 21:47:34 +000011 <link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
12 <title>ImageMagick: MagickCore, C API for ImageMagick: Draw on an Image</title>
13 <meta http-equiv="Content-Language" content="en-US"/>
14 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
15 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
16 <meta name="Generator" content="PHP"/>
17 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, draw, on, an, image, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
18 <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
19 <meta name="Rating" content="GENERAL"/>
20 <meta name="Robots" content="INDEX, FOLLOW"/>
21 <meta name="Generator" content="ImageMagick Studio LLC"/>
22 <meta name="Author" content="ImageMagick Studio LLC"/>
23 <meta name="Revisit-after" content="2 DAYS"/>
24 <meta name="Resource-type" content="document"/>
cristy16af1cb2009-12-11 21:38:29 +000025 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +000026 <meta name="Distribution" content="Global"/>
cristy3eaa0ef2010-03-06 20:35:26 +000027</head>
28
29<body id="www-imagemagick-org">
30<div class="titlebar">
31<a href="../../index.html">
32 <img src="../../images/script.png" alt="[ImageMagick]"
33 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
34<a href="http://www.networkredux.com">
35 <img src="../../images/networkredux.png" alt="[sponsor]"
36 style="margin: 45px auto; border: 0px; float: left;" /></a>
37<a href="http://www.imagemagick.org/discourse-server/">
38 <img src="../../images/logo.jpg" alt=""
39 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
40<a href="../../index.html">
41 <img src="../../images/sprite.jpg" alt=""
42 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
43</div>
44
cristyce69bb02010-07-27 19:49:46 +000045<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +000046
cristy3ed852e2009-09-05 21:47:34 +000047<div class="menu">
cristy83a272e2010-05-07 20:40:35 +000048 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +000049</div>
cristy3eaa0ef2010-03-06 20:35:26 +000050<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +000051<div class="menu">
cristybb503372010-05-27 20:51:26 +000052 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
53</div>
54<div class="sub">
55 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
56</div>
57<div class="sub">
58 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
59</div>
60<div class="sub">
61 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
62</div>
63<div class="sep"></div>
64<div class="menu">
cristy83a272e2010-05-07 20:40:35 +000065 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +000066</div>
67<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000068 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +000069</div>
70<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000071 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +000072</div>
73<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000074 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +000075</div>
76<div class="menu">
cristy83a272e2010-05-07 20:40:35 +000077 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +000078</div>
79<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000080 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +000081</div>
82<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000083 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +000084</div>
85<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000086 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +000087</div>
88<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000089 <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +000090</div>
cristy3eaa0ef2010-03-06 20:35:26 +000091<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +000092<div class="menu">
cristy83a272e2010-05-07 20:40:35 +000093 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +000094</div>
95<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000096 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +000097</div>
98<div class="sub">
cristy83a272e2010-05-07 20:40:35 +000099 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000100 </div>
101<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000102 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000103</div>
cristybb503372010-05-27 20:51:26 +0000104<div class="menu">
105 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
106</div>
cristy3ed852e2009-09-05 21:47:34 +0000107<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000108 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000111<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000112 <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000113</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000114<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000115<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000116 <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000117</div>
118<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000119 <a title="Site Map: Links"href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000120</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000121<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000122<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000123 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000124
125<div class="sponsbox">
126<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000127 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
cristy0391e8d2010-04-10 01:36:10 +0000128</div>
129<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000130 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristy8f900122010-03-05 15:26:31 +0000131</div>
132<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000133 <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristy5f2356f2009-11-16 00:40:46 +0000134</div>
135<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000136 <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
cristyc1c61662009-09-30 14:04:37 +0000137</div>
138<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000139 <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristyb4c03bb2009-09-27 13:55:46 +0000140</div>
cristya7cb4312010-06-26 00:47:03 +0000141<div class="sponsor">
cristya8902942010-07-30 00:49:52 +0000142 <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
cristya7cb4312010-06-26 00:47:03 +0000143</div>
cristy3ed852e2009-09-05 21:47:34 +0000144</div>
145</div>
cristyce69bb02010-07-27 19:49:46 +0000146</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000147
cristyce69bb02010-07-27 19:49:46 +0000148<div class="eastbar">
149 <script type="text/javascript">
150 <!--
151 google_ad_client = "pub-3129977114552745";
152 /* 160x600, created 7/27/10 */
153 google_ad_slot = "0574824969";
154 google_ad_width = 160;
155 google_ad_height = 600;
156 //-->
157 </script>
158 <script type="text/javascript"
159 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
160 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000161</div>
162
163<div class="main">
164
cristy3ed852e2009-09-05 21:47:34 +0000165<p class="navigation-index">[<a href="#AcquireDrawInfo">AcquireDrawInfo</a> &bull; <a href="#CloneDrawInfo">CloneDrawInfo</a> &bull; <a href="#DestroyDrawInfo">DestroyDrawInfo</a> &bull; <a href="#DrawAffineImage">DrawAffineImage</a> &bull; <a href="#DrawClipPath">DrawClipPath</a> &bull; <a href="#DrawImage">DrawImage</a> &bull; <a href="#DrawGradientImage">DrawGradientImage</a> &bull; <a href="#DrawPatternPath">DrawPatternPath</a> &bull; <a href="#DrawPrimitive">DrawPrimitive</a> &bull; <a href="#GetAffineMatrix">GetAffineMatrix</a>]</p>
166
167<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
168_8c.html" target="source" name="AcquireDrawInfo">AcquireDrawInfo</a></h2>
169<div class="doc-section">
170
171<p>AcquireDrawInfo() returns a DrawInfo structure properly initialized.</p></ol>
172
173<p>The format of the AcquireDrawInfo method is:</p>
174
175<pre class="code">
176 DrawInfo *AcquireDrawInfo(void)
177</pre>
178
179 </div>
180<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
181_8c.html" target="source" name="CloneDrawInfo">CloneDrawInfo</a></h2>
182<div class="doc-section">
183
184<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></ol>
185
186<p>The format of the CloneDrawInfo method is:</p>
187
188<pre class="code">
189 DrawInfo *CloneDrawInfo(const ImageInfo *image_info,
190 const DrawInfo *draw_info)
191</pre>
192
193<p>A description of each parameter follows:</p></ol>
194
195<h5>image_info</h5>
196<ol><p>the image info.</p></ol>
197
198<h5>draw_info</h5>
199<ol><p>the draw info.</p></ol>
200
201 </div>
202<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
203_8c.html" target="source" name="DestroyDrawInfo">DestroyDrawInfo</a></h2>
204<div class="doc-section">
205
206<p>DestroyDrawInfo() deallocates memory associated with an DrawInfo structure.</p></ol>
207
208<p>The format of the DestroyDrawInfo method is:</p>
209
210<pre class="code">
211 DrawInfo *DestroyDrawInfo(DrawInfo *draw_info)
212</pre>
213
214<p>A description of each parameter follows:</p></ol>
215
216<h5>draw_info</h5>
217<ol><p>the draw info.</p></ol>
218
219 </div>
220<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
221_8c.html" target="source" name="DrawAffineImage">DrawAffineImage</a></h2>
222<div class="doc-section">
223
224<p>DrawAffineImage() composites the source over the destination image as dictated by the affine transform.</p></ol>
225
226<p>The format of the DrawAffineImage method is:</p>
227
228<pre class="code">
229 MagickBooleanType DrawAffineImage(Image *image,const Image *source,
230 const AffineMatrix *affine)
231</pre>
232
233<p>A description of each parameter follows:</p></ol>
234
235<h5>image</h5>
236<ol><p>the image.</p></ol>
237
238<h5>source</h5>
239<ol><p>the source image.</p></ol>
240
241<h5>affine</h5>
242<ol><p>the affine transform.</p></ol>
243
244 </div>
245<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
246_8c.html" target="source" name="DrawClipPath">DrawClipPath</a></h2>
247<div class="doc-section">
248
249<p>DrawClipPath() draws the clip path on the image mask.</p></ol>
250
251<p>The format of the DrawClipPath method is:</p>
252
253<pre class="code">
254 MagickBooleanType DrawClipPath(Image *image,const DrawInfo *draw_info,
255 const char *name)
256</pre>
257
258<p>A description of each parameter follows:</p></ol>
259
260<h5>image</h5>
261<ol><p>the image.</p></ol>
262
263<h5>draw_info</h5>
264<ol><p>the draw info.</p></ol>
265
266<h5>name</h5>
267<ol><p>the name of the clip path.</p></ol>
268
269 </div>
270<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
271_8c.html" target="source" name="DrawImage">DrawImage</a></h2>
272<div class="doc-section">
273
274<p>DrawImage() draws 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></ol>
275
276<p>The format of the DrawImage method is:</p>
277
278<pre class="code">
279 MagickBooleanType DrawImage(Image *image,const DrawInfo *draw_info)
280</pre>
281
282<p>A description of each parameter follows:</p></ol>
283
284<h5>image</h5>
285<ol><p>the image.</p></ol>
286
287<h5>draw_info</h5>
288<ol><p>the draw info.</p></ol>
289
290 </div>
291<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
292_8c.html" target="source" name="DrawGradientImage">DrawGradientImage</a></h2>
293<div class="doc-section">
294
295<p>DrawGradientImage() draws a linear gradient on the image.</p></ol>
296
297<p>The format of the DrawGradientImage method is:</p>
298
299<pre class="code">
300 MagickBooleanType DrawGradientImage(Image *image,
301 const DrawInfo *draw_info)
302</pre>
303
304<p>A description of each parameter follows:</p></ol>
305
306<h5>image</h5>
307<ol><p>the image.</p></ol>
308
309<h5>_info</h5>
310<ol><p>the draw info.</p></ol>
311
312 </div>
313<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
314_8c.html" target="source" name="DrawPatternPath">DrawPatternPath</a></h2>
315<div class="doc-section">
316
317<p>DrawPatternPath() draws a pattern.</p></ol>
318
319<p>The format of the DrawPatternPath method is:</p>
320
321<pre class="code">
322 MagickBooleanType DrawPatternPath(Image *image,const DrawInfo *draw_info,
323 const char *name,Image **pattern)
324</pre>
325
326<p>A description of each parameter follows:</p></ol>
327
328<h5>image</h5>
329<ol><p>the image.</p></ol>
330
331<h5>draw_info</h5>
332<ol><p>the draw info.</p></ol>
333
334<h5>name</h5>
335<ol><p>the pattern name.</p></ol>
336
337<h5>image</h5>
338<ol><p>the image.</p></ol>
339
340 </div>
341<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
342_8c.html" target="source" name="DrawPrimitive">DrawPrimitive</a></h2>
343<div class="doc-section">
344
345<p>DrawPrimitive() draws a primitive (line, rectangle, ellipse) on the image.</p></ol>
346
347<p>The format of the DrawPrimitive method is:</p>
348
349<pre class="code">
350 MagickBooleanType DrawPrimitive(Image *image,const DrawInfo *draw_info,
351 PrimitiveInfo *primitive_info)
352</pre>
353
354<p>A description of each parameter follows:</p></ol>
355
356<h5>image</h5>
357<ol><p>the image.</p></ol>
358
359<h5>draw_info</h5>
360<ol><p>the draw info.</p></ol>
361
362<h5>primitive_info</h5>
363<ol><p>Specifies a pointer to a PrimitiveInfo structure.</p></ol>
364
365 </div>
366<h2><a href="http://www.imagemagick.org/api/MagickCore/draw
367_8c.html" target="source" name="GetAffineMatrix">GetAffineMatrix</a></h2>
368<div class="doc-section">
369
370<p>GetAffineMatrix() returns an AffineMatrix initialized to the identity matrix.</p></ol>
371
372<p>The format of the GetAffineMatrix method is:</p>
373
374<pre class="code">
375 void GetAffineMatrix(AffineMatrix *affine_matrix)
376</pre>
377
378<p>A description of each parameter follows:</p></ol>
379
380<h5>affine_matrix</h5>
381<ol><p>the affine matrix.</p></ol>
382
383 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000384
385</div>
386
387<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000388 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000389 <span id="linkbar-center">
390 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000391 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000392 </span>
393 <span id="linkbar-east">&nbsp;</span>
394 </div>
395 <div class="footer">
396 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
397 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
398 </div>
399 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000400 <script type="text/javascript">
401 var _gaq = _gaq || [];
402 _gaq.push(['_setAccount', 'UA-17690367-1']);
403 _gaq.push(['_trackPageview']);
404
405 (function() {
406 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
407 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
408 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
409 })();
410 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000411</body>
412</html>