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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">\r
   4 <head>\r
   5   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
   6   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>\r
   7   <title>ImageMagick: MagickCore, C API for ImageMagick: Draw on an Image</title/>
   8   <meta http-equiv="Content-Language" content="en-US"/>
   9   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  10   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  11   <meta name="Application-name" content="ImageMagick"/>
  12   <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."/>
  13   <meta name="Application-url" content="http://www.imagemagick.org"/>
  14   <meta name="Generator" content="PHP"/>
  15   <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"/>
  16   <meta name="Rating" content="GENERAL"/>
  17   <meta name="Robots" content="INDEX, FOLLOW"/>
  18   <meta name="Generator" content="ImageMagick Studio LLC"/>
  19   <meta name="Author" content="ImageMagick Studio LLC"/>
  20   <meta name="Revisit-after" content="2 DAYS"/>
  21   <meta name="Resource-type" content="document"/>
  22   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  23   <meta name="Distribution" content="Global"/>
  24   <link rel="icon" href="../../images/wand.png"  sizes="32x32"/>
  25   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/x-icon"/>
  26   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
  27   <style type="text/css" media="all">\r
  28     @import url("../../www/magick.css");\r
  29   </style>\r
  30 </head>\r
  31 \r
  32 <body id="www-imagemagick-org">\r
  33 <div class="titlebar">\r
  34 <a href="../../index.html">\r
  35   <img src="../../images/script.png" alt="[ImageMagick]"\r
  36   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  37 <a href="http://www.networkredux.com">\r
  38   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  39   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  40 <a href="http://www.imagemagick.org/discourse-server/">\r
  41   <img src="../../images/logo.jpg" alt=""\r
  42   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  43 <a href="../../index.html">\r
  44   <img src="../../images/sprite.jpg" alt=""\r
  45   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  46 </div>\r
  47 \r
  48 <div class="westbar">\r
  49 \r
  50 <div class="menu">
  51   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  52 </div>
  53 <div class="sep"></div>\r
  54 <div class="menu">
  55   <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
  56 </div>
  57 <div class="sub">
  58     <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
  59 </div>
  60 <div class="sub">
  61     <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
  62 </div>
  63 <div class="sub">
  64     <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
  65 </div>
  66 <div class="sep"></div>\r
  67 <div class="menu">
  68   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  69 </div>
  70 <div class="sub">
  71     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  72 </div>
  73 <div class="sub">
  74     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  75 </div>
  76 <div class="sub">
  77     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  78 </div>
  79 <div class="menu">
  80   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
  81 </div>
  82 <div class="sub">
  83     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
  90 </div>
  91 <div class="sub">
  92     <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
  93 </div>
  94 <div class="sep"></div>\r
  95 <div  class="menu">
  96    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
  97 </div>
  98 <div class="sub">
  99     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
 100 </div>
 101 <div class="sub">
 102     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 103  </div>
 104 <div class="menu">
 105   <a title="Resources" href="../../www/resources.html">Resources</a>
 106 </div>
 107 <div class="menu">
 108   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 109 </div>
 110 <div class="menu">
 111   <a title="Download" href="../../www/download.html">Download</a>
 112 </div>
 113 <div class="sep"></div>\r
 114 <div class="menu">
 115   <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
 116 </div>
 117 <div class="sep"></div>\r
 118 <div class="menu">
 119   <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
 120 </div>
 121 <div  class="sub">
 122     <a title="Site Map: Links"href="../../www/links.html">Links</a>
 123 </div>
 124 <div class="sep"></div>\r
 125 <div  class="menu">
 126   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 127
 128 <div class="sponsbox">
 129 <div  class="sponsor">
 130    <a title="Sponsor: Atlas Multimedia" href="http://www.atlas-multimedia.de/">Atlas Multimedia</a><!-- 20101201000025 tanju.temurbas-->
 131 </div>
 132 <div  class="sponsor">
 133   <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
 134 </div>
 135 <div  class="sponsor">
 136   <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
 137 </div>
 138 <div  class="sponsor">
 139   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 140 </div>
 141 <div  class="sponsor">
 142   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 143 </div>
 144 <div  class="sponsor">
 145   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 146 </div>
 147 <div  class="sponsor">
 148   <a title="Sponsor: Diamonds are a Girls Best Friend" href="http://www.schmuck.org">Diamonds are a Girls Best Friend</a><!-- 201101010600 Peterssen-->
 149 </div>
 150 <div  class="sponsor">
 151    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 152 </div>
 153 </div>
 154 </div>
 155 </div>\r
 156 \r
 157 <div class="eastbar">\r
 158   <script type="text/javascript">\r
 159   <!--\r
 160     google_ad_client = "pub-3129977114552745";\r
 161     google_ad_slot = "0574824969";\r
 162     google_ad_width = 160;\r
 163     google_ad_height = 600;\r
 164   //-->\r
 165   </script>\r
 166   <script type="text/javascript"\r
 167     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 168   </script>\r
 169 </div>\r
 170 \r
 171 <div class="main">\r
 172 \r
 173 <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>
 174
 175 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 176 _8c.html" target="source" name="AcquireDrawInfo">AcquireDrawInfo</a></h2>
 177 <div class="doc-section">
 178
 179 <p>AcquireDrawInfo() returns a DrawInfo structure properly initialized.</p></ol>
 180
 181 <p>The format of the AcquireDrawInfo method is:</p>
 182
 183 <pre class="code">
 184   DrawInfo *AcquireDrawInfo(void)
 185 </pre>
 186
 187  </div>
 188 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 189 _8c.html" target="source" name="CloneDrawInfo">CloneDrawInfo</a></h2>
 190 <div class="doc-section">
 191
 192 <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>
 193
 194 <p>The format of the CloneDrawInfo method is:</p>
 195
 196 <pre class="code">
 197   DrawInfo *CloneDrawInfo(const ImageInfo *image_info,
 198     const DrawInfo *draw_info)
 199 </pre>
 200
 201 <p>A description of each parameter follows:</p></ol>
 202
 203 <h5>image_info</h5>
 204 <ol><p>the image info.</p></ol>
 205
 206 <h5>draw_info</h5>
 207 <ol><p>the draw info.</p></ol>
 208
 209  </div>
 210 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 211 _8c.html" target="source" name="DestroyDrawInfo">DestroyDrawInfo</a></h2>
 212 <div class="doc-section">
 213
 214 <p>DestroyDrawInfo() deallocates memory associated with an DrawInfo structure.</p></ol>
 215
 216 <p>The format of the DestroyDrawInfo method is:</p>
 217
 218 <pre class="code">
 219   DrawInfo *DestroyDrawInfo(DrawInfo *draw_info)
 220 </pre>
 221
 222 <p>A description of each parameter follows:</p></ol>
 223
 224 <h5>draw_info</h5>
 225 <ol><p>the draw info.</p></ol>
 226
 227  </div>
 228 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 229 _8c.html" target="source" name="DrawAffineImage">DrawAffineImage</a></h2>
 230 <div class="doc-section">
 231
 232 <p>DrawAffineImage() composites the source over the destination image as dictated by the affine transform.</p></ol>
 233
 234 <p>The format of the DrawAffineImage method is:</p>
 235
 236 <pre class="code">
 237   MagickBooleanType DrawAffineImage(Image *image,const Image *source,
 238     const AffineMatrix *affine)
 239 </pre>
 240
 241 <p>A description of each parameter follows:</p></ol>
 242
 243 <h5>image</h5>
 244 <ol><p>the image.</p></ol>
 245
 246 <h5>source</h5>
 247 <ol><p>the source image.</p></ol>
 248
 249 <h5>affine</h5>
 250 <ol><p>the affine transform.</p></ol>
 251
 252  </div>
 253 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 254 _8c.html" target="source" name="DrawClipPath">DrawClipPath</a></h2>
 255 <div class="doc-section">
 256
 257 <p>DrawClipPath() draws the clip path on the image mask.</p></ol>
 258
 259 <p>The format of the DrawClipPath method is:</p>
 260
 261 <pre class="code">
 262   MagickBooleanType DrawClipPath(Image *image,const DrawInfo *draw_info,
 263     const char *name)
 264 </pre>
 265
 266 <p>A description of each parameter follows:</p></ol>
 267
 268 <h5>image</h5>
 269 <ol><p>the image.</p></ol>
 270
 271 <h5>draw_info</h5>
 272 <ol><p>the draw info.</p></ol>
 273
 274 <h5>name</h5>
 275 <ol><p>the name of the clip path.</p></ol>
 276
 277  </div>
 278 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 279 _8c.html" target="source" name="DrawImage">DrawImage</a></h2>
 280 <div class="doc-section">
 281
 282 <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>
 283
 284 <p>The format of the DrawImage method is:</p>
 285
 286 <pre class="code">
 287   MagickBooleanType DrawImage(Image *image,const DrawInfo *draw_info)
 288 </pre>
 289
 290 <p>A description of each parameter follows:</p></ol>
 291
 292 <h5>image</h5>
 293 <ol><p>the image.</p></ol>
 294
 295 <h5>draw_info</h5>
 296 <ol><p>the draw info.</p></ol>
 297
 298  </div>
 299 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 300 _8c.html" target="source" name="DrawGradientImage">DrawGradientImage</a></h2>
 301 <div class="doc-section">
 302
 303 <p>DrawGradientImage() draws a linear gradient on the image.</p></ol>
 304
 305 <p>The format of the DrawGradientImage method is:</p>
 306
 307 <pre class="code">
 308   MagickBooleanType DrawGradientImage(Image *image,
 309     const DrawInfo *draw_info)
 310 </pre>
 311
 312 <p>A description of each parameter follows:</p></ol>
 313
 314 <h5>image</h5>
 315 <ol><p>the image.</p></ol>
 316
 317 <h5>_info</h5>
 318 <ol><p>the draw info.</p></ol>
 319
 320  </div>
 321 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 322 _8c.html" target="source" name="DrawPatternPath">DrawPatternPath</a></h2>
 323 <div class="doc-section">
 324
 325 <p>DrawPatternPath() draws a pattern.</p></ol>
 326
 327 <p>The format of the DrawPatternPath method is:</p>
 328
 329 <pre class="code">
 330   MagickBooleanType DrawPatternPath(Image *image,const DrawInfo *draw_info,
 331     const char *name,Image **pattern)
 332 </pre>
 333
 334 <p>A description of each parameter follows:</p></ol>
 335
 336 <h5>image</h5>
 337 <ol><p>the image.</p></ol>
 338
 339 <h5>draw_info</h5>
 340 <ol><p>the draw info.</p></ol>
 341
 342 <h5>name</h5>
 343 <ol><p>the pattern name.</p></ol>
 344
 345 <h5>image</h5>
 346 <ol><p>the image.</p></ol>
 347
 348  </div>
 349 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 350 _8c.html" target="source" name="DrawPrimitive">DrawPrimitive</a></h2>
 351 <div class="doc-section">
 352
 353 <p>DrawPrimitive() draws a primitive (line, rectangle, ellipse) on the image.</p></ol>
 354
 355 <p>The format of the DrawPrimitive method is:</p>
 356
 357 <pre class="code">
 358   MagickBooleanType DrawPrimitive(Image *image,const DrawInfo *draw_info,
 359     PrimitiveInfo *primitive_info)
 360 </pre>
 361
 362 <p>A description of each parameter follows:</p></ol>
 363
 364 <h5>image</h5>
 365 <ol><p>the image.</p></ol>
 366
 367 <h5>draw_info</h5>
 368 <ol><p>the draw info.</p></ol>
 369
 370 <h5>primitive_info</h5>
 371 <ol><p>Specifies a pointer to a PrimitiveInfo structure.</p></ol>
 372
 373  </div>
 374 <h2><a href="http://www.imagemagick.org/api/MagickCore/draw
 375 _8c.html" target="source" name="GetAffineMatrix">GetAffineMatrix</a></h2>
 376 <div class="doc-section">
 377
 378 <p>GetAffineMatrix() returns an AffineMatrix initialized to the identity matrix.</p></ol>
 379
 380 <p>The format of the GetAffineMatrix method is:</p>
 381
 382 <pre class="code">
 383   void GetAffineMatrix(AffineMatrix *affine_matrix)
 384 </pre>
 385
 386 <p>A description of each parameter follows:</p></ol>
 387
 388 <h5>affine_matrix</h5>
 389 <ol><p>the affine matrix.</p></ol>
 390
 391  </div>
 392 \r
 393 </div>\r
 394 \r
 395 <div id="linkbar">\r
 396     <span id="linkbar-west">&nbsp;</span>\r
 397     <span id="linkbar-center">\r
 398       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 399       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 400     </span>\r
 401     <span id="linkbar-east">&nbsp;</span>\r
 402   </div>\r
 403   <div class="footer">\r
 404     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 405     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 406   </div>\r
 407   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 408   <script type="text/javascript">\r
 409     var _gaq = _gaq || [];\r
 410     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 411     _gaq.push(['_trackPageview']);\r
 412 \r
 413     (function() {\r
 414       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 415       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 416       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 417     })();\r
 418   </script>\r
 419 </body>\r
 420 </html>\r