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">
\r
5 <meta http-equiv="Content-Type" value="application/xhtml+xml" />
\r
6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
\r
7 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
\r
8 <style type="text/css" media="screen,projection"><!--
\r
9 @import url("../../www/magick.css");
\r
11 <link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
12 <title>ImageMagick: MagickCore, C API for ImageMagick: Deprecated Methods</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:, deprecated, methods, 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"/>
25 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
26 <meta name="Distribution" content="Global"/>
29 <body id="www-imagemagick-org">
\r
30 <div class="titlebar">
\r
31 <a href="../../index.html">
\r
32 <img src="../../images/script.png" alt="[ImageMagick]"
\r
33 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
\r
34 <a href="http://www.networkredux.com">
\r
35 <img src="../../images/networkredux.png" alt="[sponsor]"
\r
36 style="margin: 45px auto; border: 0px; float: left;" /></a>
\r
37 <a href="http://www.imagemagick.org/discourse-server/">
\r
38 <img src="../../images/logo.jpg" alt=""
\r
39 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
\r
40 <a href="../../index.html">
\r
41 <img src="../../images/sprite.jpg" alt=""
\r
42 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
\r
45 <div class="eastbar">
\r
48 <a href="../../index.html">About ImageMagick</a>
50 <div class="sep"></div>
\r
52 <a href="../../www/command-line-tools.html">Command-line Tools</a>
55 <a href="../../www/command-line-processing.html">Processing</a>
58 <a href="../../www/command-line-options.html">Options</a>
61 <a href="http://www.imagemagick.org/Usage/">Usage</a>
64 <a href="../../www/api.html">Program Interfaces</a>
67 <a href="../../www/magick-wand.html">MagickWand</a>
70 <a href="../../www/magick-core.html">MagickCore</a>
73 <a href="../../www/perl-magick.html">PerlMagick</a>
76 <a href="../../Magick++/">Magick++</a>
79 <a href="../../www/architecture.html">Architecture</a>
81 <div class="sep"></div>
\r
83 <a href="../../www/install-source.html">Install from Source</a>
86 <a href="../../www/install-source.html#unix">Unix</a>
89 <a href="../../www/install-source.html#windows">Windows</a>
92 <a href="../../www/binary-releases.html">Binary Releases</a>
95 <a href="../../www/binary-releases.html#unix">Unix</a>
98 <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
101 <a href="../../www/binary-releases.html#windows">Windows</a>
104 <a href="../../www/resources.html">Resources</a>
106 <div class="sep"></div>
\r
108 <a href="../../www/download.html">Download</a>
110 <div class="sep"></div>
\r
112 <a href="../http://www.imagemagick.org/script/search.php">Search</a>
114 <div class="sep"></div>
\r
116 <a href="../../www/sitemap.html">Site Map</a>
119 <a href="../../www/links.html">Links</a>
121 <div class="sep"></div>
\r
123 <a href="../../www/sponsors.html">Sponsors:</a>
125 <div class="sponsbox">
126 <div class="sponsor">
127 <a href="http://www.geschenke-elsen.de/" title="Lampe Berger">Lampe Berger</a><!-- 20106101000040 -->
129 <div class="sponsor">
130 <a href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
132 <div class="sponsor">
133 <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
135 <div class="sponsor">
136 <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
138 <div class="sponsor">
139 <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
141 <div class="sponsor">
142 <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
144 <div class="sponsor">
145 <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
147 <div class="sponsor">
148 <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
158 <p class="navigation-index">[<a href="#AcquireCacheViewIndexes">AcquireCacheViewIndexes</a> • <a href="#AcquireCacheViewPixels">AcquireCacheViewPixels</a> • <a href="#AcquireImagePixels">AcquireImagePixels</a> • <a href="#AcquireIndexes">AcquireIndexes</a> • <a href="#AcquireMemory">AcquireMemory</a> • <a href="#AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a> • <a href="#AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a> • <a href="#AcquireOneMagickPixel">AcquireOneMagickPixel</a> • <a href="#AcquireOnePixel">AcquireOnePixel</a> • <a href="#AcquireOneVirtualPixel">AcquireOneVirtualPixel</a> • <a href="#AcquirePixels">AcquirePixels</a> • <a href="#AffinityImage">AffinityImage</a> • <a href="#AffinityImages">AffinityImages</a> • <a href="#AllocateImage">AllocateImage</a> • <a href="#AllocateImageColormap">AllocateImageColormap</a> • <a href="#AllocateNextImage">AllocateNextImage</a> • <a href="#AllocateString">AllocateString</a> • <a href="#AverageImages">AverageImages</a> • <a href="#ChannelThresholdImage">ChannelThresholdImage</a> • <a href="#ClipPathImage">ClipPathImage</a> • <a href="#CloneImageAttributes">CloneImageAttributes</a> • <a href="#CloneMemory">CloneMemory</a> • <a href="#CloseCacheView">CloseCacheView</a> • <a href="#ColorFloodfill">ColorFloodfill</a> • <a href="#DeleteImageAttribute">DeleteImageAttribute</a> • <a href="#DeleteImageList">DeleteImageList</a> • <a href="#DeleteMagickRegistry">DeleteMagickRegistry</a> • <a href="#DescribeImage">DescribeImage</a> • <a href="#DestroyImageAttributes">DestroyImageAttributes</a> • <a href="#DestroyImages">DestroyImages</a> • <a href="#DestroyMagick">DestroyMagick</a> • <a href="#DispatchImage">DispatchImage</a> • <a href="#ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a> • <a href="#FlattenImages">FlattenImages</a> • <a href="#FormatImageAttribute">FormatImageAttribute</a> • <a href="#FormatString">FormatString</a> • <a href="#GetConfigureBlob">GetConfigureBlob</a> • <a href="#GetCacheView">GetCacheView</a> • <a href="#GetCacheViewIndexes">GetCacheViewIndexes</a> • <a href="#GetCacheViewPixels">GetCacheViewPixels</a> • <a href="#GetImageAttribute">GetImageAttribute</a> • <a href="#GetImageClippingPathAttribute">GetImageClippingPathAttribute</a> • <a href="#GetImageFromMagickRegistry">GetImageFromMagickRegistry</a> • <a href="#GetMagickRegistry">GetMagickRegistry</a> • <a href="#GetImageGeometry">GetImageGeometry</a> • <a href="#GetImageList">GetImageList</a> • <a href="#GetImageListIndex">GetImageListIndex</a> • <a href="#GetImageListSize">GetImageListSize</a> • <a href="#GetImagePixels">GetImagePixels</a> • <a href="#GetIndexes">GetIndexes</a> • <a href="#GetNextImage">GetNextImage</a> • <a href="#GetNextImageAttribute">GetNextImageAttribute</a> • <a href="#GetNumberScenes">GetNumberScenes</a> • <a href="#GetOnePixel">GetOnePixel</a> • <a href="#GetPixels">GetPixels</a> • <a href="#GetPreviousImage">GetPreviousImage</a> • <a href="#HSLTransform">HSLTransform</a> • <a href="#IdentityAffine">IdentityAffine</a> • <a href="#InitializeMagick">InitializeMagick</a> • <a href="#InterpolatePixelColor">InterpolatePixelColor</a> • <a href="#InterpretImageAttributes">InterpretImageAttributes</a> • <a href="#LevelImageColor">LevelImageColor</a> • <a href="#LiberateMemory">LiberateMemory</a> • <a href="#LiberateSemaphoreInfo">LiberateSemaphoreInfo</a> • <a href="#MagickIncarnate">MagickIncarnate</a> • <a href="#MagickMonitor">MagickMonitor</a> • <a href="#MapImage">MapImage</a> • <a href="#MapImages">MapImages</a> • <a href="#MatteFloodfill">MatteFloodfill</a> • <a href="#MaximumImages">MaximumImages</a> • <a href="#MinimumImages">MinimumImages</a> • <a href="#MosaicImages">MosaicImages</a> • <a href="#OpaqueImage">OpaqueImage</a> • <a href="#OpenCacheView">OpenCacheView</a> • <a href="#PaintFloodfill">PaintFloodfill</a> • <a href="#PaintOpaqueImage">PaintOpaqueImage</a> • <a href="#PaintTransparentImage">PaintTransparentImage</a> • <a href="#ParseSizeGeometry">ParseSizeGeometry</a> • <a href="#PopImageList">PopImageList</a> • <a href="#PopImagePixels">PopImagePixels</a> • <a href="#PostscriptGeometry">PostscriptGeometry</a> • <a href="#PushImageList">PushImageList</a> • <a href="#PushImagePixels">PushImagePixels</a> • <a href="#QuantizationError">QuantizationError</a> • <a href="#RandomChannelThresholdImage">RandomChannelThresholdImage</a> • <a href="#ReacquireMemory">ReacquireMemory</a> • <a href="#ResetImageAttributeIterator">ResetImageAttributeIterator</a> • <a href="#SetCacheViewPixels">SetCacheViewPixels</a> • <a href="#SetExceptionInfo">SetExceptionInfo</a> • <a href="#SetImage">SetImage</a> • <a href="#SetImageAttribute">SetImageAttribute</a> • <a href="#SetImageList">SetImageList</a> • <a href="#SetImagePixels">SetImagePixels</a> • <a href="#SetMagickRegistry">SetMagickRegistry</a> • <a href="#SetMonitorHandler">SetMonitorHandler</a> • <a href="#ShiftImageList">ShiftImageList</a> • <a href="#SpliceImageList">SpliceImageList</a> • <a href="#Strip">Strip</a> • <a href="#SyncCacheView">SyncCacheView</a> • <a href="#SyncCacheViewPixels">SyncCacheViewPixels</a> • <a href="#SyncImagePixels">SyncImagePixels</a> • <a href="#TemporaryFilename">TemporaryFilename</a> • <a href="#ThresholdImage">ThresholdImage</a> • <a href="#ThresholdImageChannel">ThresholdImageChannel</a> • <a href="#TransformHSL">TransformHSL</a> • <a href="#TranslateText">TranslateText</a> • <a href="#TransparentImage">TransparentImage</a> • <a href="#UnshiftImageList">UnshiftImageList</a>]</p>
160 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
161 _8c.html" target="source" name="AcquireCacheViewIndexes">AcquireCacheViewIndexes</a></h2>
162 <div class="doc-section">
164 <p>AcquireCacheViewIndexes() returns the indexes associated with the specified view.</p></ol>
166 <p>The format of the AcquireCacheViewIndexes method is:</p>
169 const IndexPacket *AcquireCacheViewIndexes(const CacheView *cache_view)
172 <p>A description of each parameter follows:</p></ol>
175 <ol><p>the cache view.</p></ol>
178 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
179 _8c.html" target="source" name="AcquireCacheViewPixels">AcquireCacheViewPixels</a></h2>
180 <div class="doc-section">
182 <p>AcquireCacheViewPixels() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
184 <p>The format of the AcquireCacheViewPixels method is:</p>
187 const PixelPacket *AcquireCacheViewPixels(const CacheView *cache_view,
188 const long x,const long y,const unsigned long columns,
189 const unsigned long rows,ExceptionInfo *exception)
192 <p>A description of each parameter follows:</p></ol>
195 <ol><p>the cache view.</p></ol>
197 <h5>x,y,columns,rows</h5>
198 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
201 <ol><p>return any errors or warnings in this structure.</p></ol>
204 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
205 _8c.html" target="source" name="AcquireImagePixels">AcquireImagePixels</a></h2>
206 <div class="doc-section">
208 <p>AcquireImagePixels() returns an immutable pixel region. If the region is successfully accessed, a pointer to it is returned, otherwise NULL is returned. The returned pointer may point to a temporary working copy of the pixels or it may point to the original pixels in memory. Performance is maximized if the selected region is part of one row, or one or more full rows, since there is opportunity to access the pixels in-place (without a copy) if the image is in RAM, or in a memory-mapped file. The returned pointer should *never* be deallocated by the user.</p></ol>
210 <p>Pixels accessed via the returned pointer represent a simple array of type PixelPacket. If the image type is CMYK or the storage class is PseudoClass, call GetAuthenticIndexQueue() after invoking GetAuthenticPixels() to access the black color component or to obtain the colormap indexes (of type IndexPacket) corresponding to the region.</p></ol>
212 <p>If you plan to modify the pixels, use GetAuthenticPixels() instead.</p></ol>
214 <p>Note, the AcquireImagePixels() and GetAuthenticPixels() methods are not thread-safe. In a threaded environment, use GetCacheViewVirtualPixels() or GetCacheViewAuthenticPixels() instead.</p></ol>
216 <p>The format of the AcquireImagePixels() method is:</p>
219 const PixelPacket *AcquireImagePixels(const Image *image,const long x,
220 const long y,const unsigned long columns,const unsigned long rows,
221 ExceptionInfo *exception)
224 <p>A description of each parameter follows:</p></ol>
227 <ol><p>the image.</p></ol>
229 <h5>x,y,columns,rows</h5>
230 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
233 <ol><p>return any errors or warnings in this structure.</p></ol>
236 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
237 _8c.html" target="source" name="AcquireIndexes">AcquireIndexes</a></h2>
238 <div class="doc-section">
240 <p>AcquireIndexes() returns the black channel or the colormap indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels(). NULL is returned if the black channel or colormap indexes are not available.</p></ol>
242 <p>The format of the AcquireIndexes() method is:</p>
245 const IndexPacket *AcquireIndexes(const Image *image)
248 <p>A description of each parameter follows:</p></ol>
251 <ol><p>AcquireIndexes() returns the indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p></ol>
254 <ol><p>the image.</p></ol>
257 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
258 _8c.html" target="source" name="AcquireMemory">AcquireMemory</a></h2>
259 <div class="doc-section">
261 <p>AcquireMemory() returns a pointer to a block of memory at least size bytes suitably aligned for any use.</p></ol>
263 <p>The format of the AcquireMemory method is:</p>
266 void *AcquireMemory(const size_t size)
269 <p>A description of each parameter follows:</p></ol>
272 <ol><p>the size of the memory in bytes to allocate.</p></ol>
275 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
276 _8c.html" target="source" name="AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a></h2>
277 <div class="doc-section">
279 <p>AcquireOneCacheViewPixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOneCacheViewAuthenticPixel() instead.</p></ol>
281 <p>The format of the AcquireOneCacheViewPixel method is:</p>
284 MagickBooleanType AcquireOneCacheViewPixel(const CacheView *cache_view,
285 const long x,const long y,PixelPacket *pixel,ExceptionInfo *exception)
288 <p>A description of each parameter follows:</p></ol>
291 <ol><p>the cache view.</p></ol>
294 <ol><p>These values define the offset of the pixel.</p></ol>
297 <ol><p>return a pixel at the specified (x,y) location.</p></ol>
300 <ol><p>return any errors or warnings in this structure.</p></ol>
303 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
304 _8c.html" target="source" name="AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a></h2>
305 <div class="doc-section">
307 <p>AcquireOneCacheViewVirtualPixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOneCacheViewAuthenticPixel() instead.</p></ol>
309 <p>The format of the AcquireOneCacheViewPixel method is:</p>
312 MagickBooleanType AcquireOneCacheViewVirtualPixel(
313 const CacheView *cache_view,
314 const VirtualPixelMethod virtual_pixel_method,const long x,
315 const long y,PixelPacket *pixel,ExceptionInfo *exception)
318 <p>A description of each parameter follows:</p></ol>
321 <ol><p>the cache view.</p></ol>
323 <h5>virtual_pixel_method</h5>
324 <ol><p>the virtual pixel method.</p></ol>
327 <ol><p>These values define the offset of the pixel.</p></ol>
330 <ol><p>return a pixel at the specified (x,y) location.</p></ol>
333 <ol><p>return any errors or warnings in this structure.</p></ol>
336 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
337 _8c.html" target="source" name="AcquireOneMagickPixel">AcquireOneMagickPixel</a></h2>
338 <div class="doc-section">
340 <p>AcquireOneMagickPixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOnePixel() instead.</p></ol>
342 <p>The format of the AcquireOneMagickPixel() method is:</p>
345 MagickPixelPacket AcquireOneMagickPixel(const Image image,const long x,
346 const long y,ExceptionInfo exception)
349 <p>A description of each parameter follows:</p></ol>
352 <ol><p>the image.</p></ol>
355 <ol><p>These values define the location of the pixel to return.</p></ol>
358 <ol><p>return any errors or warnings in this structure.</p></ol>
361 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
362 _8c.html" target="source" name="AcquireOnePixel">AcquireOnePixel</a></h2>
363 <div class="doc-section">
365 <p>AcquireOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOnePixel() instead.</p></ol>
367 <p>The format of the AcquireOnePixel() method is:</p>
370 PixelPacket AcquireOnePixel(const Image image,const long x,
371 const long y,ExceptionInfo exception)
374 <p>A description of each parameter follows:</p></ol>
377 <ol><p>the image.</p></ol>
380 <ol><p>These values define the location of the pixel to return.</p></ol>
383 <ol><p>return any errors or warnings in this structure.</p></ol>
386 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
387 _8c.html" target="source" name="AcquireOneVirtualPixel">AcquireOneVirtualPixel</a></h2>
388 <div class="doc-section">
390 <p>AcquireOneVirtualPixel() returns a single pixel at the specified (x,y) location as defined by specified pixel method. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOnePixel() instead.</p></ol>
392 <p>The format of the AcquireOneVirtualPixel() method is:</p>
395 PixelPacket AcquireOneVirtualPixel(const Image image,
396 const VirtualPixelMethod virtual_pixel_method,const long x,
397 const long y,ExceptionInfo exception)
400 <p>A description of each parameter follows:</p></ol>
402 <h5>virtual_pixel_method</h5>
403 <ol><p>the virtual pixel method.</p></ol>
406 <ol><p>the image.</p></ol>
409 <ol><p>These values define the location of the pixel to return.</p></ol>
412 <ol><p>return any errors or warnings in this structure.</p></ol>
415 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
416 _8c.html" target="source" name="AcquirePixels">AcquirePixels</a></h2>
417 <div class="doc-section">
419 <p>AcquirePixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p></ol>
421 <p>The format of the AcquirePixels() method is:</p>
424 const PixelPacket *AcquirePixels(const Image image)
427 <p>A description of each parameter follows:</p></ol>
430 <ol><p>the image.</p></ol>
433 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
434 _8c.html" target="source" name="AffinityImage">AffinityImage</a></h2>
435 <div class="doc-section">
437 <p>AffinityImage() replaces the colors of an image with the closest color from a reference image.</p></ol>
439 <p>The format of the AffinityImage method is:</p>
442 MagickBooleanType AffinityImage(const QuantizeInfo *quantize_info,
443 Image *image,const Image *affinity_image)
446 <p>A description of each parameter follows:</p></ol>
448 <h5>quantize_info</h5>
449 <ol><p>Specifies a pointer to an QuantizeInfo structure.</p></ol>
452 <ol><p>the image.</p></ol>
454 <h5>affinity_image</h5>
455 <ol><p>the reference image.</p></ol>
458 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
459 _8c.html" target="source" name="AffinityImages">AffinityImages</a></h2>
460 <div class="doc-section">
462 <p>AffinityImages() replaces the colors of a sequence of images with the closest color from a reference image.</p></ol>
464 <p>The format of the AffinityImage method is:</p>
467 MagickBooleanType AffinityImages(const QuantizeInfo *quantize_info,
468 Image *images,Image *affinity_image)
471 <p>A description of each parameter follows:</p></ol>
473 <h5>quantize_info</h5>
474 <ol><p>Specifies a pointer to an QuantizeInfo structure.</p></ol>
477 <ol><p>the image sequence.</p></ol>
479 <h5>affinity_image</h5>
480 <ol><p>the reference image.</p></ol>
483 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
484 _8c.html" target="source" name="AllocateImage">AllocateImage</a></h2>
485 <div class="doc-section">
487 <p>AllocateImage() returns a pointer to an image structure initialized to default values.</p></ol>
489 <p>The format of the AllocateImage method is:</p>
492 Image *AllocateImage(const ImageInfo *image_info)
495 <p>A description of each parameter follows:</p></ol>
498 <ol><p>Many of the image default values are set from this structure. For example, filename, compression, depth, background color, and others.</p></ol>
501 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
502 _8c.html" target="source" name="AllocateImageColormap">AllocateImageColormap</a></h2>
503 <div class="doc-section">
505 <p>AllocateImageColormap() allocates an image colormap and initializes it to a linear gray colorspace. If the image already has a colormap, it is replaced. AllocateImageColormap() returns MagickTrue if successful, otherwise MagickFalse if there is not enough memory.</p></ol>
507 <p>The format of the AllocateImageColormap method is:</p>
510 MagickBooleanType AllocateImageColormap(Image *image,
511 const unsigned long colors)
514 <p>A description of each parameter follows:</p></ol>
517 <ol><p>the image.</p></ol>
520 <ol><p>the number of colors in the image colormap.</p></ol>
523 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
524 _8c.html" target="source" name="AllocateNextImage">AllocateNextImage</a></h2>
525 <div class="doc-section">
527 <p>AllocateNextImage() initializes the next image in a sequence to default values. The next member of image points to the newly allocated image. If there is a memory shortage, next is assigned NULL.</p></ol>
529 <p>The format of the AllocateNextImage method is:</p>
532 void AllocateNextImage(const ImageInfo *image_info,Image *image)
535 <p>A description of each parameter follows:</p></ol>
538 <ol><p>Many of the image default values are set from this structure. For example, filename, compression, depth, background color, and others.</p></ol>
541 <ol><p>the image.</p></ol>
544 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
545 _8c.html" target="source" name="AllocateString">AllocateString</a></h2>
546 <div class="doc-section">
548 <p>AllocateString() allocates memory for a string and copies the source string to that memory location (and returns it).</p></ol>
550 <p>The format of the AllocateString method is:</p>
553 char *AllocateString(const char *source)
556 <p>A description of each parameter follows:</p></ol>
559 <ol><p>A character string.</p></ol>
562 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
563 _8c.html" target="source" name="AverageImages">AverageImages</a></h2>
564 <div class="doc-section">
566 <p>AverageImages() takes a set of images and averages them together. Each image in the set must have the same width and height. AverageImages() returns a single image with each corresponding pixel component of each image averaged. On failure, a NULL image is returned and exception describes the reason for the failure.</p></ol>
568 <p>The format of the AverageImages method is:</p>
571 Image *AverageImages(Image *images,ExceptionInfo *exception)
574 <p>A description of each parameter follows:</p></ol>
577 <ol><p>the image sequence.</p></ol>
580 <ol><p>return any errors or warnings in this structure.</p></ol>
583 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
584 _8c.html" target="source" name="ChannelThresholdImage">ChannelThresholdImage</a></h2>
585 <div class="doc-section">
587 <p>ChannelThresholdImage() changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.</p></ol>
589 <p>The format of the ChannelThresholdImage method is:</p>
592 unsigned int ChannelThresholdImage(Image *image,const char *level)
595 <p>A description of each parameter follows:</p></ol>
598 <ol><p>the image.</p></ol>
601 <ol><p>define the threshold values.</p></ol>
604 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
605 _8c.html" target="source" name="ClipPathImage">ClipPathImage</a></h2>
606 <div class="doc-section">
608 <p>ClipPathImage() sets the image clip mask based any clipping path information if it exists.</p></ol>
610 <p>The format of the ClipImage method is:</p>
613 MagickBooleanType ClipPathImage(Image *image,const char *pathname,
614 const MagickBooleanType inside)
617 <p>A description of each parameter follows:</p></ol>
620 <ol><p>the image.</p></ol>
623 <ol><p>name of clipping path resource. If name is preceded by #, use clipping path numbered by name.</p></ol>
626 <ol><p>if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.</p></ol>
629 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
630 _8c.html" target="source" name="CloneImageAttributes">CloneImageAttributes</a></h2>
631 <div class="doc-section">
633 <p>CloneImageAttributes() clones one or more image attributes.</p></ol>
635 <p>The format of the CloneImageAttributes method is:</p>
638 MagickBooleanType CloneImageAttributes(Image *image,
639 const Image *clone_image)
642 <p>A description of each parameter follows:</p></ol>
645 <ol><p>the image.</p></ol>
648 <ol><p>the clone image.</p></ol>
651 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
652 _8c.html" target="source" name="CloneMemory">CloneMemory</a></h2>
653 <div class="doc-section">
655 <p>CloneMemory() copies size bytes from memory area source to the destination. Copying between objects that overlap will take place correctly. It returns destination.</p></ol>
657 <p>The format of the CloneMemory method is:</p>
660 void *CloneMemory(void *destination,const void *source,
664 <p>A description of each parameter follows:</p></ol>
667 <ol><p>the destination.</p></ol>
670 <ol><p>the source.</p></ol>
673 <ol><p>the size of the memory in bytes to allocate.</p></ol>
676 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
677 _8c.html" target="source" name="CloseCacheView">CloseCacheView</a></h2>
678 <div class="doc-section">
680 <p>CloseCacheView() closes the specified view returned by a previous call to OpenCacheView().</p></ol>
682 <p>The format of the CloseCacheView method is:</p>
685 CacheView *CloseCacheView(CacheView *view_info)
688 <p>A description of each parameter follows:</p></ol>
691 <ol><p>the address of a structure of type CacheView.</p></ol>
694 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
695 _8c.html" target="source" name="ColorFloodfill">ColorFloodfill</a></h2>
696 <div class="doc-section">
698 <p>ColorFloodfill() changes the color value of any pixel that matches target and is an immediate neighbor. If the method FillToBorderMethod is specified, the color value is changed for any neighbor pixel that does not match the bordercolor member of image.</p></ol>
700 <p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p></ol>
702 <p>The format of the ColorFloodfillImage method is:</p>
705 MagickBooleanType ColorFloodfillImage(Image *image,
706 const DrawInfo *draw_info,const PixelPacket target,
707 const long x_offset,const long y_offset,const PaintMethod method)
710 <p>A description of each parameter follows:</p></ol>
713 <ol><p>the image.</p></ol>
716 <ol><p>the draw info.</p></ol>
719 <ol><p>the RGB value of the target color.</p></ol>
722 <ol><p>the starting location of the operation.</p></ol>
725 <ol><p>Choose either FloodfillMethod or FillToBorderMethod.</p></ol>
728 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
729 _8c.html" target="source" name="DeleteImageAttribute">DeleteImageAttribute</a></h2>
730 <div class="doc-section">
732 <p>DeleteImageAttribute() deletes an attribute from the image.</p></ol>
734 <p>The format of the DeleteImageAttribute method is:</p>
737 MagickBooleanType DeleteImageAttribute(Image *image,const char *key)
740 <p>A description of each parameter follows:</p></ol>
743 <ol><p>the image info.</p></ol>
746 <ol><p>the image key.</p></ol>
749 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
750 _8c.html" target="source" name="DeleteImageList">DeleteImageList</a></h2>
751 <div class="doc-section">
753 <p>DeleteImageList() deletes an image at the specified position in the list.</p></ol>
755 <p>The format of the DeleteImageList method is:</p>
758 unsigned int DeleteImageList(Image *images,const long offset)
761 <p>A description of each parameter follows:</p></ol>
764 <ol><p>the image list.</p></ol>
767 <ol><p>the position within the list.</p></ol>
770 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
771 _8c.html" target="source" name="DeleteMagickRegistry">DeleteMagickRegistry</a></h2>
772 <div class="doc-section">
774 <p>DeleteMagickRegistry() deletes an entry in the registry as defined by the id. It returns MagickTrue if the entry is deleted otherwise MagickFalse if no entry is found in the registry that matches the id.</p></ol>
776 <p>The format of the DeleteMagickRegistry method is:</p>
779 MagickBooleanType DeleteMagickRegistry(const long id)
782 <p>A description of each parameter follows:</p></ol>
785 <ol><p>the registry id.</p></ol>
788 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
789 _8c.html" target="source" name="DescribeImage">DescribeImage</a></h2>
790 <div class="doc-section">
792 <p>DescribeImage() describes an image by printing its attributes to the file. Attributes include the image width, height, size, and others.</p></ol>
794 <p>The format of the DescribeImage method is:</p>
797 MagickBooleanType DescribeImage(Image *image,FILE *file,
798 const MagickBooleanType verbose)
801 <p>A description of each parameter follows:</p></ol>
804 <ol><p>the image.</p></ol>
807 <ol><p>the file, typically stdout.</p></ol>
810 <ol><p>A value other than zero prints more detailed information about the image.</p></ol>
813 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
814 _8c.html" target="source" name="DestroyImageAttributes">DestroyImageAttributes</a></h2>
815 <div class="doc-section">
817 <p>DestroyImageAttributes() deallocates memory associated with the image attribute list.</p></ol>
819 <p>The format of the DestroyImageAttributes method is:</p>
822 DestroyImageAttributes(Image *image)
825 <p>A description of each parameter follows:</p></ol>
828 <ol><p>the image.</p></ol>
831 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
832 _8c.html" target="source" name="DestroyImages">DestroyImages</a></h2>
833 <div class="doc-section">
835 <p>DestroyImages() destroys an image list.</p></ol>
837 <p>The format of the DestroyImages method is:</p>
840 void DestroyImages(Image *image)
843 <p>A description of each parameter follows:</p></ol>
846 <ol><p>the image sequence.</p></ol>
849 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
850 _8c.html" target="source" name="DestroyMagick">DestroyMagick</a></h2>
851 <div class="doc-section">
853 <p>DestroyMagick() destroys the ImageMagick environment.</p></ol>
855 <p>The format of the DestroyMagick function is:</p>
862 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
863 _8c.html" target="source" name="DispatchImage">DispatchImage</a></h2>
864 <div class="doc-section">
866 <p>DispatchImage() extracts pixel data from an image and returns it to you. The method returns MagickFalse on success otherwise MagickTrue if an error is encountered. The data is returned as char, short int, int, long, float, or double in the order specified by map.</p></ol>
868 <p>Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:</p>
871 DispatchImage(image,0,0,640,1,"RGB",CharPixel,pixels,exception);
874 <p>The format of the DispatchImage method is:</p>
877 unsigned int DispatchImage(const Image *image,const long x_offset,
878 const long y_offset,const unsigned long columns,
879 const unsigned long rows,const char *map,const StorageType type,
880 void *pixels,ExceptionInfo *exception)
883 <p>A description of each parameter follows:</p></ol>
886 <ol><p>the image.</p></ol>
888 <h5>x_offset, y_offset, columns, rows</h5>
889 <ol><p>These values define the perimeter of a region of pixels you want to extract.</p></ol>
892 <ol><p>This string reflects the expected ordering of the pixel array. It can be any combination or order of R = red, G = green, B = blue, A = alpha, C = cyan, Y = yellow, M = magenta, K = black, or I = intensity (for grayscale).</p></ol>
895 <ol><p>Define the data type of the pixels. Float and double types are normalized to [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, ShortPixel, IntegerPixel, LongPixel, FloatPixel, or DoublePixel.</p></ol>
898 <ol><p>This array of values contain the pixel components as defined by map and type. You must preallocate this array where the expected length varies depending on the values of width, height, map, and type.</p></ol>
901 <ol><p>return any errors or warnings in this structure.</p></ol>
904 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
905 _8c.html" target="source" name="ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a></h2>
906 <div class="doc-section">
908 <p>ExtractSubimageFromImageImage() extracts a region of the image that most closely resembles the reference.</p></ol>
910 <p>The format of the ExtractSubimageFromImageImage method is:</p>
913 Image *ExtractSubimageFromImage(const Image *image,const Image *reference,
914 ExceptionInfo *exception)
917 <p>A description of each parameter follows:</p></ol>
920 <ol><p>the image.</p></ol>
923 <ol><p>find an area of the image that closely resembles this image.</p></ol>
926 <ol><p>return any errors or warnings in this structure.</p></ol>
929 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
930 _8c.html" target="source" name="FlattenImages">FlattenImages</a></h2>
931 <div class="doc-section">
933 <p>FlattenImages() Obsolete Function: Use MergeImageLayers() instead.</p></ol>
935 <p>The format of the FlattenImage method is:</p>
938 Image *FlattenImage(Image *image,ExceptionInfo *exception)
941 <p>A description of each parameter follows:</p></ol>
944 <ol><p>the image sequence.</p></ol>
947 <ol><p>return any errors or warnings in this structure.</p></ol>
950 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
951 _8c.html" target="source" name="FormatImageAttribute">FormatImageAttribute</a></h2>
952 <div class="doc-section">
954 <p>FormatImageAttribute() permits formatted key/value pairs to be saved as an image attribute.</p></ol>
956 <p>The format of the FormatImageAttribute method is:</p>
959 MagickBooleanType FormatImageAttribute(Image *image,const char *key,
960 const char *format,...)
963 <p>A description of each parameter follows.</p></ol>
966 <ol><p>The image.</p></ol>
969 <ol><p>The attribute key.</p></ol>
972 <ol><p>A string describing the format to use to write the remaining arguments.</p></ol>
975 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
976 _8c.html" target="source" name="FormatString">FormatString</a></h2>
977 <div class="doc-section">
979 <p>FormatString() prints formatted output of a variable argument list.</p></ol>
981 <p>The format of the FormatString method is:</p>
984 void FormatString(char *string,const char *format,...)
987 <p>A description of each parameter follows.</p></ol>
990 <ol><p>Method FormatString returns the formatted string in this character buffer.</p></ol>
993 <ol><p>A string describing the format to use to write the remaining arguments.</p></ol>
996 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
997 _8c.html" target="source" name="GetConfigureBlob">GetConfigureBlob</a></h2>
998 <div class="doc-section">
1000 <p>GetConfigureBlob() returns the specified configure file as a blob.</p></ol>
1002 <p>The format of the GetConfigureBlob method is:</p>
1005 void *GetConfigureBlob(const char *filename,ExceptionInfo *exception)
1008 <p>A description of each parameter follows:</p></ol>
1011 <ol><p>the configure file name.</p></ol>
1014 <ol><p>return the full path information of the configure file.</p></ol>
1017 <ol><p>This pointer to a size_t integer sets the initial length of the blob. On return, it reflects the actual length of the blob.</p></ol>
1020 <ol><p>return any errors or warnings in this structure.</p></ol>
1023 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1024 _8c.html" target="source" name="GetCacheView">GetCacheView</a></h2>
1025 <div class="doc-section">
1027 <p>GetCacheView() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
1029 <p>The format of the GetCacheView method is:</p>
1032 PixelPacket *GetCacheView(CacheView *cache_view,const long x,
1033 const long y,const unsigned long columns,const unsigned long rows)
1036 <p>A description of each parameter follows:</p></ol>
1039 <ol><p>the address of a structure of type CacheView.</p></ol>
1041 <h5>x,y,columns,rows</h5>
1042 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
1045 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1046 _8c.html" target="source" name="GetCacheViewIndexes">GetCacheViewIndexes</a></h2>
1047 <div class="doc-section">
1049 <p>GetCacheViewIndexes() returns the indexes associated with the specified view.</p></ol>
1051 <p>The format of the GetCacheViewIndexes method is:</p>
1054 IndexPacket *GetCacheViewIndexes(CacheView *cache_view)
1057 <p>A description of each parameter follows:</p></ol>
1060 <ol><p>the cache view.</p></ol>
1063 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1064 _8c.html" target="source" name="GetCacheViewPixels">GetCacheViewPixels</a></h2>
1065 <div class="doc-section">
1067 <p>GetCacheViewPixels() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
1069 <p>The format of the GetCacheViewPixels method is:</p>
1072 PixelPacket *GetCacheViewPixels(CacheView *cache_view,const long x,
1073 const long y,const unsigned long columns,const unsigned long rows)
1076 <p>A description of each parameter follows:</p></ol>
1079 <ol><p>the cache view.</p></ol>
1081 <h5>x,y,columns,rows</h5>
1082 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
1085 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1086 _8c.html" target="source" name="GetImageAttribute">GetImageAttribute</a></h2>
1087 <div class="doc-section">
1089 <p>GetImageAttribute() searches the list of image attributes and returns a pointer to the attribute if it exists otherwise NULL.</p></ol>
1091 <p>The format of the GetImageAttribute method is:</p>
1094 const ImageAttribute *GetImageAttribute(const Image *image,
1098 <p>A description of each parameter follows:</p></ol>
1101 <ol><p>the image.</p></ol>
1104 <ol><p>These character strings are the name of an image attribute to return.</p></ol>
1107 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1108 _8c.html" target="source" name="GetImageClippingPathAttribute">GetImageClippingPathAttribute</a></h2>
1109 <div class="doc-section">
1111 <p>GetImageClippingPathAttribute() searches the list of image attributes and returns a pointer to a clipping path if it exists otherwise NULL.</p></ol>
1113 <p>The format of the GetImageClippingPathAttribute method is:</p>
1116 const ImageAttribute *GetImageClippingPathAttribute(Image *image)
1119 <p>A description of each parameter follows:</p></ol>
1122 <ol><p>Method GetImageClippingPathAttribute returns the clipping path if it exists otherwise NULL.</p></ol>
1125 <ol><p>the image.</p></ol>
1128 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1129 _8c.html" target="source" name="GetImageFromMagickRegistry">GetImageFromMagickRegistry</a></h2>
1130 <div class="doc-section">
1132 <p>GetImageFromMagickRegistry() gets an image from the registry as defined by its name. If the image is not found, a NULL image is returned.</p></ol>
1134 <p>The format of the GetImageFromMagickRegistry method is:</p>
1137 Image *GetImageFromMagickRegistry(const char *name,long *id,
1138 ExceptionInfo *exception)
1141 <p>A description of each parameter follows:</p></ol>
1144 <ol><p>the name of the image to retrieve from the registry.</p></ol>
1147 <ol><p>the registry id.</p></ol>
1150 <ol><p>return any errors or warnings in this structure.</p></ol>
1153 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1154 _8c.html" target="source" name="GetMagickRegistry">GetMagickRegistry</a></h2>
1155 <div class="doc-section">
1157 <p>GetMagickRegistry() gets a blob from the registry as defined by the id. If the blob that matches the id is not found, NULL is returned.</p></ol>
1159 <p>The format of the GetMagickRegistry method is:</p>
1162 const void *GetMagickRegistry(const long id,RegistryType *type,
1163 size_t *length,ExceptionInfo *exception)
1166 <p>A description of each parameter follows:</p></ol>
1169 <ol><p>the registry id.</p></ol>
1172 <ol><p>the registry type.</p></ol>
1175 <ol><p>the blob length in number of bytes.</p></ol>
1178 <ol><p>return any errors or warnings in this structure.</p></ol>
1181 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1182 _8c.html" target="source" name="GetImageGeometry">GetImageGeometry</a></h2>
1183 <div class="doc-section">
1185 <p>GetImageGeometry() returns a region as defined by the geometry string with respect to the image and its gravity.</p></ol>
1187 <p>The format of the GetImageGeometry method is:</p>
1190 int GetImageGeometry(Image *image,const char *geometry,
1191 const unsigned int size_to_fit,RectangeInfo *region_info)
1194 <p>A description of each parameter follows:</p></ol>
1197 <ol><p>Method GetImageGeometry returns a bitmask that indicates which of the four values were located in the geometry string.</p></ol>
1200 <ol><p>The geometry (e.g. 100x100+10+10).</p></ol>
1202 <h5>size_to_fit</h5>
1203 <ol><p>A value other than 0 means to scale the region so it fits within the specified width and height.</p></ol>
1205 <h5>region_info</h5>
1206 <ol><p>the region as defined by the geometry string with respect to the image and its gravity.</p></ol>
1209 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1210 _8c.html" target="source" name="GetImageList">GetImageList</a></h2>
1211 <div class="doc-section">
1213 <p>GetImageList() returns an image at the specified position in the list.</p></ol>
1215 <p>The format of the GetImageList method is:</p>
1218 Image *GetImageList(const Image *images,const long offset,
1219 ExceptionInfo *exception)
1222 <p>A description of each parameter follows:</p></ol>
1225 <ol><p>the image list.</p></ol>
1228 <ol><p>the position within the list.</p></ol>
1231 <ol><p>return any errors or warnings in this structure.</p></ol>
1234 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1235 _8c.html" target="source" name="GetImageListIndex">GetImageListIndex</a></h2>
1236 <div class="doc-section">
1238 <p>GetImageListIndex() returns the position in the list of the specified image.</p></ol>
1240 <p>The format of the GetImageListIndex method is:</p>
1243 long GetImageListIndex(const Image *images)
1246 <p>A description of each parameter follows:</p></ol>
1249 <ol><p>the image list.</p></ol>
1252 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1253 _8c.html" target="source" name="GetImageListSize">GetImageListSize</a></h2>
1254 <div class="doc-section">
1256 <p>GetImageListSize() returns the number of images in the list.</p></ol>
1258 <p>The format of the GetImageListSize method is:</p>
1261 unsigned long GetImageListSize(const Image *images)
1264 <p>A description of each parameter follows:</p></ol>
1267 <ol><p>the image list.</p></ol>
1270 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1271 _8c.html" target="source" name="GetImagePixels">GetImagePixels</a></h2>
1272 <div class="doc-section">
1274 <p>GetImagePixels() obtains a pixel region for read/write access. If the region is successfully accessed, a pointer to a PixelPacket array representing the region is returned, otherwise NULL is returned.</p></ol>
1276 <p>The returned pointer may point to a temporary working copy of the pixels or it may point to the original pixels in memory. Performance is maximized if the selected region is part of one row, or one or more full rows, since then there is opportunity to access the pixels in-place (without a copy) if the image is in RAM, or in a memory-mapped file. The returned pointer should *never* be deallocated by the user.</p></ol>
1278 <p>Pixels accessed via the returned pointer represent a simple array of type PixelPacket. If the image type is CMYK or if the storage class is PseduoClass, call GetAuthenticIndexQueue() after invoking GetImagePixels() to obtain the black color component or colormap indexes (of type IndexPacket) corresponding to the region. Once the PixelPacket (and/or IndexPacket) array has been updated, the changes must be saved back to the underlying image using SyncAuthenticPixels() or they may be lost.</p></ol>
1280 <p>The format of the GetImagePixels() method is:</p>
1283 PixelPacket *GetImagePixels(Image *image,const long x,const long y,
1284 const unsigned long columns,const unsigned long rows)
1287 <p>A description of each parameter follows:</p></ol>
1290 <ol><p>the image.</p></ol>
1292 <h5>x,y,columns,rows</h5>
1293 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
1296 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1297 _8c.html" target="source" name="GetIndexes">GetIndexes</a></h2>
1298 <div class="doc-section">
1300 <p>GetIndexes() returns the black channel or the colormap indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels(). NULL is returned if the black channel or colormap indexes are not available.</p></ol>
1302 <p>The format of the GetIndexes() method is:</p>
1305 IndexPacket *GetIndexes(const Image *image)
1308 <p>A description of each parameter follows:</p></ol>
1311 <ol><p>GetIndexes() returns the indexes associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p></ol>
1314 <ol><p>the image.</p></ol>
1317 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1318 _8c.html" target="source" name="GetNextImage">GetNextImage</a></h2>
1319 <div class="doc-section">
1321 <p>GetNextImage() returns the next image in a list.</p></ol>
1323 <p>The format of the GetNextImage method is:</p>
1326 Image *GetNextImage(const Image *images)
1329 <p>A description of each parameter follows:</p></ol>
1332 <ol><p>the image list.</p></ol>
1335 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1336 _8c.html" target="source" name="GetNextImageAttribute">GetNextImageAttribute</a></h2>
1337 <div class="doc-section">
1339 <p>GetNextImageAttribute() gets the next image attribute.</p></ol>
1341 <p>The format of the GetNextImageAttribute method is:</p>
1344 const ImageAttribute *GetNextImageAttribute(const Image *image)
1347 <p>A description of each parameter follows:</p></ol>
1350 <ol><p>the image.</p></ol>
1353 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1354 _8c.html" target="source" name="GetNumberScenes">GetNumberScenes</a></h2>
1355 <div class="doc-section">
1357 <p>GetNumberScenes() returns the number of images in the list.</p></ol>
1359 <p>The format of the GetNumberScenes method is:</p>
1362 unsigned int GetNumberScenes(const Image *images)
1365 <p>A description of each parameter follows:</p></ol>
1368 <ol><p>the image list.</p></ol>
1371 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1372 _8c.html" target="source" name="GetOnePixel">GetOnePixel</a></h2>
1373 <div class="doc-section">
1375 <p>GetOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs.</p></ol>
1377 <p>The format of the GetOnePixel() method is:</p>
1380 PixelPacket GetOnePixel(const Image image,const long x,const long y)
1383 <p>A description of each parameter follows:</p></ol>
1386 <ol><p>the image.</p></ol>
1389 <ol><p>These values define the location of the pixel to return.</p></ol>
1392 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1393 _8c.html" target="source" name="GetPixels">GetPixels</a></h2>
1394 <div class="doc-section">
1396 <p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p></ol>
1398 <p>The format of the GetPixels() method is:</p>
1401 PixelPacket *GetPixels(const Image image)
1404 <p>A description of each parameter follows:</p></ol>
1407 <ol><p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p></ol>
1410 <ol><p>the image.</p></ol>
1413 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1414 _8c.html" target="source" name="GetPreviousImage">GetPreviousImage</a></h2>
1415 <div class="doc-section">
1417 <p>GetPreviousImage() returns the previous image in a list.</p></ol>
1419 <p>The format of the GetPreviousImage method is:</p>
1422 Image *GetPreviousImage(const Image *images)
1425 <p>A description of each parameter follows:</p></ol>
1428 <ol><p>the image list.</p></ol>
1431 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1432 _8c.html" target="source" name="HSLTransform">HSLTransform</a></h2>
1433 <div class="doc-section">
1435 <p>HSLTransform() converts a (hue, saturation, lightness) to a (red, green, blue) triple.</p></ol>
1437 <p>The format of the HSLTransformImage method is:</p>
1440 void HSLTransform(const double hue,const double saturation,
1441 const double lightness,Quantum *red,Quantum *green,Quantum *blue)
1444 <p>A description of each parameter follows:</p></ol>
1446 <h5>hue, saturation, lightness</h5>
1447 <ol><p>A double value representing a component of the HSL color space.</p></ol>
1449 <h5>red, green, blue</h5>
1450 <ol><p>A pointer to a pixel component of type Quantum.</p></ol>
1453 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1454 _8c.html" target="source" name="IdentityAffine">IdentityAffine</a></h2>
1455 <div class="doc-section">
1457 <p>IdentityAffine() initializes the affine transform to the identity matrix.</p></ol>
1459 <p>The format of the IdentityAffine method is:</p>
1462 IdentityAffine(AffineMatrix *affine)
1465 <p>A description of each parameter follows:</p></ol>
1468 <ol><p>A pointer the affine transform of type AffineMatrix.</p></ol>
1471 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1472 _8c.html" target="source" name="InitializeMagick">InitializeMagick</a></h2>
1473 <div class="doc-section">
1475 <p>InitializeMagick() initializes the ImageMagick environment.</p></ol>
1477 <p>The format of the InitializeMagick function is:</p>
1480 InitializeMagick(const char *path)
1483 <p>A description of each parameter follows:</p></ol>
1486 <ol><p>the execution path of the current ImageMagick client.</p></ol>
1489 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1490 _8c.html" target="source" name="InterpolatePixelColor">InterpolatePixelColor</a></h2>
1491 <div class="doc-section">
1493 <p>InterpolatePixelColor() applies bi-linear or tri-linear interpolation between a pixel and it's neighbors.</p></ol>
1495 <p>The format of the InterpolatePixelColor method is:</p>
1498 MagickPixelPacket InterpolatePixelColor(const Image *image,
1499 CacheView *view_info,InterpolatePixelMethod method,const double x,
1500 const double y,ExceptionInfo *exception)
1503 <p>A description of each parameter follows:</p></ol>
1506 <ol><p>the image.</p></ol>
1509 <ol><p>the image cache view.</p></ol>
1512 <ol><p>the type of pixel color interpolation.</p></ol>
1515 <ol><p>A double representing the current (x,y) position of the pixel.</p></ol>
1518 <ol><p>return any errors or warnings in this structure.</p></ol>
1521 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1522 _8c.html" target="source" name="InterpretImageAttributes">InterpretImageAttributes</a></h2>
1523 <div class="doc-section">
1525 <p>InterpretImageAttributes() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p></ol>
1527 <p>The format of the InterpretImageAttributes method is:</p>
1530 char *InterpretImageAttributes(const ImageInfo *image_info,Image *image,
1531 const char *embed_text)
1534 <p>A description of each parameter follows:</p></ol>
1537 <ol><p>the image info.</p></ol>
1540 <ol><p>the image.</p></ol>
1543 <ol><p>the address of a character string containing the embedded formatting characters.</p></ol>
1546 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1547 _8c.html" target="source" name="LevelImageColor">LevelImageColor</a></h2>
1548 <div class="doc-section">
1550 <p>LevelImageColor() will map the given color to "black" and "white" values, limearly spreading out the colors, and level values on a channel by channel bases, as per LevelImage(). The given colors allows you to specify different level ranges for each of the color channels seperatally.</p></ol>
1552 <p>If the boolean 'invert' is set true the image values will modifyed in the reverse direction. That is any existing "black" and "white" colors in the image will become the color values given, with all other values compressed appropriatally. This effectivally maps a greyscale gradient into the given color gradient.</p></ol>
1554 <p>The format of the LevelImageColors method is:</p>
1557 MagickBooleanType LevelImageColors(Image *image,const ChannelType channel,
1558 const MagickPixelPacket *black_color,const MagickPixelPacket *white_color,
1559 const MagickBooleanType invert)
1562 <p>A description of each parameter follows:</p></ol>
1565 <ol><p>the image.</p></ol>
1568 <ol><p>the channel.</p></ol>
1570 <h5>black_color</h5>
1571 <ol><p>The color to map black to/from</p></ol>
1573 <h5>white_point</h5>
1574 <ol><p>The color to map white to/from</p></ol>
1577 <ol><p>if true map the colors (levelize), rather than from (level)</p></ol>
1580 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1581 _8c.html" target="source" name="LiberateMemory">LiberateMemory</a></h2>
1582 <div class="doc-section">
1584 <p>LiberateMemory() frees memory that has already been allocated, and NULL's the pointer to it.</p></ol>
1586 <p>The format of the LiberateMemory method is:</p>
1589 void LiberateMemory(void **memory)
1592 <p>A description of each parameter follows:</p></ol>
1595 <ol><p>A pointer to a block of memory to free for reuse.</p></ol>
1598 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1599 _8c.html" target="source" name="LiberateSemaphoreInfo">LiberateSemaphoreInfo</a></h2>
1600 <div class="doc-section">
1602 <p>LiberateSemaphoreInfo() relinquishes a semaphore.</p></ol>
1604 <p>The format of the LiberateSemaphoreInfo method is:</p>
1607 LiberateSemaphoreInfo(void **semaphore_info)
1610 <p>A description of each parameter follows:</p></ol>
1612 <h5>semaphore_info</h5>
1613 <ol><p>Specifies a pointer to an SemaphoreInfo structure.</p></ol>
1616 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1617 _8c.html" target="source" name="MagickIncarnate">MagickIncarnate</a></h2>
1618 <div class="doc-section">
1620 <p>MagickIncarnate() initializes the ImageMagick environment.</p></ol>
1622 <p>The format of the MagickIncarnate function is:</p>
1625 MagickIncarnate(const char *path)
1628 <p>A description of each parameter follows:</p></ol>
1631 <ol><p>the execution path of the current ImageMagick client.</p></ol>
1634 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1635 _8c.html" target="source" name="MagickMonitor">MagickMonitor</a></h2>
1636 <div class="doc-section">
1638 <p>MagickMonitor() calls the monitor handler method with a text string that describes the task and a measure of completion. The method returns MagickTrue on success otherwise MagickFalse if an error is encountered, e.g. if there was a user interrupt.</p></ol>
1640 <p>The format of the MagickMonitor method is:</p>
1643 MagickBooleanType MagickMonitor(const char *text,
1644 const MagickOffsetType offset,const MagickSizeType span,
1648 <p>A description of each parameter follows:</p></ol>
1651 <ol><p>the position relative to the span parameter which represents how much progress has been made toward completing a task.</p></ol>
1654 <ol><p>the span relative to completing a task.</p></ol>
1656 <h5>client_data</h5>
1657 <ol><p>the client data.</p></ol>
1660 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1661 _8c.html" target="source" name="MapImage">MapImage</a></h2>
1662 <div class="doc-section">
1664 <p>MapImage() replaces the colors of an image with the closest color from a reference image.</p></ol>
1666 <p>The format of the MapImage method is:</p>
1669 MagickBooleanType MapImage(Image *image,const Image *map_image,
1670 const MagickBooleanType dither)
1673 <p>A description of each parameter follows:</p></ol>
1676 <ol><p>Specifies a pointer to an Image structure.</p></ol>
1679 <ol><p>the image. Reduce image to a set of colors represented by this image.</p></ol>
1682 <ol><p>Set this integer value to something other than zero to dither the mapped image.</p></ol>
1685 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1686 _8c.html" target="source" name="MapImages">MapImages</a></h2>
1687 <div class="doc-section">
1689 <p>MapImages() replaces the colors of a sequence of images with the closest color from a reference image.</p></ol>
1691 <p>The format of the MapImage method is:</p>
1694 MagickBooleanType MapImages(Image *images,Image *map_image,
1695 const MagickBooleanType dither)
1698 <p>A description of each parameter follows:</p></ol>
1701 <ol><p>Specifies a pointer to a set of Image structures.</p></ol>
1704 <ol><p>the image. Reduce image to a set of colors represented by this image.</p></ol>
1707 <ol><p>Set this integer value to something other than zero to dither the quantized image.</p></ol>
1710 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1711 _8c.html" target="source" name="MatteFloodfill">MatteFloodfill</a></h2>
1712 <div class="doc-section">
1714 <p>MatteFloodfill() changes the transparency value of any pixel that matches target and is an immediate neighbor. If the method FillToBorderMethod is specified, the transparency value is changed for any neighbor pixel that does not match the bordercolor member of image.</p></ol>
1716 <p>By default target must match a particular pixel transparency exactly. However, in many cases two transparency values may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two transparency values as the same. For example, set fuzz to 10 and the opacity values of 100 and 102 respectively are now interpreted as the same value for the purposes of the floodfill.</p></ol>
1718 <p>The format of the MatteFloodfillImage method is:</p>
1721 MagickBooleanType MatteFloodfillImage(Image *image,
1722 const PixelPacket target,const Quantum opacity,const long x_offset,
1723 const long y_offset,const PaintMethod method)
1726 <p>A description of each parameter follows:</p></ol>
1729 <ol><p>the image.</p></ol>
1732 <ol><p>the RGB value of the target color.</p></ol>
1735 <ol><p>the level of transparency: 0 is fully opaque and QuantumRange is fully transparent.</p></ol>
1738 <ol><p>the starting location of the operation.</p></ol>
1741 <ol><p>Choose either FloodfillMethod or FillToBorderMethod.</p></ol>
1744 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1745 _8c.html" target="source" name="MaximumImages">MaximumImages</a></h2>
1746 <div class="doc-section">
1748 <p>MaximumImages() returns the maximum intensity of an image sequence.</p></ol>
1750 <p>The format of the MaxImages method is:</p>
1753 Image *MaximumImages(Image *images,ExceptionInfo *exception)
1756 <p>A description of each parameter follows:</p></ol>
1759 <ol><p>the image sequence.</p></ol>
1762 <ol><p>return any errors or warnings in this structure.</p></ol>
1765 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1766 _8c.html" target="source" name="MinimumImages">MinimumImages</a></h2>
1767 <div class="doc-section">
1769 <p>MinimumImages() returns the minimum intensity of an image sequence.</p></ol>
1771 <p>The format of the MinimumImages method is:</p>
1774 Image *MinimumImages(Image *images,ExceptionInfo *exception)
1777 <p>A description of each parameter follows:</p></ol>
1780 <ol><p>the image sequence.</p></ol>
1783 <ol><p>return any errors or warnings in this structure.</p></ol>
1786 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1787 _8c.html" target="source" name="MosaicImages">MosaicImages</a></h2>
1788 <div class="doc-section">
1790 <p>MosaicImages() Obsolete Function: Use MergeImageLayers() instead.</p></ol>
1792 <p>The format of the MosaicImage method is:</p>
1795 Image *MosaicImages(const Image *image,ExceptionInfo *exception)
1798 <p>A description of each parameter follows:</p></ol>
1801 <ol><p>the image list to be composited together</p></ol>
1804 <ol><p>return any errors or warnings in this structure.</p></ol>
1807 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1808 _8c.html" target="source" name="OpaqueImage">OpaqueImage</a></h2>
1809 <div class="doc-section">
1811 <p>OpaqueImage() changes any pixel that matches color with the color defined by fill.</p></ol>
1813 <p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p></ol>
1815 <p>The format of the OpaqueImage method is:</p>
1818 MagickBooleanType OpaqueImage(Image *image,
1819 const PixelPacket *target,const PixelPacket fill)
1822 <p>A description of each parameter follows:</p></ol>
1825 <ol><p>the image.</p></ol>
1828 <ol><p>the RGB value of the target color.</p></ol>
1831 <ol><p>the replacement color.</p></ol>
1834 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1835 _8c.html" target="source" name="OpenCacheView">OpenCacheView</a></h2>
1836 <div class="doc-section">
1838 <p>OpenCacheView() opens a view into the pixel cache, using the VirtualPixelMethod that is defined within the given image itself.</p></ol>
1840 <p>The format of the OpenCacheView method is:</p>
1843 CacheView *OpenCacheView(const Image *image)
1846 <p>A description of each parameter follows:</p></ol>
1849 <ol><p>the image.</p></ol>
1852 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1853 _8c.html" target="source" name="PaintFloodfill">PaintFloodfill</a></h2>
1854 <div class="doc-section">
1856 <p>PaintFloodfill() changes the color value of any pixel that matches target and is an immediate neighbor. If the method FillToBorderMethod is specified, the color value is changed for any neighbor pixel that does not match the bordercolor member of image.</p></ol>
1858 <p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p></ol>
1860 <p>The format of the PaintFloodfillImage method is:</p>
1863 MagickBooleanType PaintFloodfillImage(Image *image,
1864 const ChannelType channel,const MagickPixelPacket target,const long x,
1865 const long y,const DrawInfo *draw_info,const PaintMethod method)
1868 <p>A description of each parameter follows:</p></ol>
1871 <ol><p>the image.</p></ol>
1874 <ol><p>the channel(s).</p></ol>
1877 <ol><p>the RGB value of the target color.</p></ol>
1880 <ol><p>the starting location of the operation.</p></ol>
1883 <ol><p>the draw info.</p></ol>
1886 <ol><p>Choose either FloodfillMethod or FillToBorderMethod.</p></ol>
1889 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1890 _8c.html" target="source" name="PaintOpaqueImage">PaintOpaqueImage</a></h2>
1891 <div class="doc-section">
1893 <p>PaintOpaqueImage() changes any pixel that matches color with the color defined by fill.</p></ol>
1895 <p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p></ol>
1897 <p>The format of the PaintOpaqueImage method is:</p>
1900 MagickBooleanType PaintOpaqueImage(Image *image,
1901 const PixelPacket *target,const PixelPacket *fill)
1902 MagickBooleanType PaintOpaqueImageChannel(Image *image,
1903 const ChannelType channel,const PixelPacket *target,
1904 const PixelPacket *fill)
1907 <p>A description of each parameter follows:</p></ol>
1910 <ol><p>the image.</p></ol>
1913 <ol><p>the channel(s).</p></ol>
1916 <ol><p>the RGB value of the target color.</p></ol>
1919 <ol><p>the replacement color.</p></ol>
1922 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1923 _8c.html" target="source" name="PaintTransparentImage">PaintTransparentImage</a></h2>
1924 <div class="doc-section">
1926 <p>PaintTransparentImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p></ol>
1928 <p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p></ol>
1930 <p>The format of the PaintTransparentImage method is:</p>
1933 MagickBooleanType PaintTransparentImage(Image *image,
1934 const MagickPixelPacket *target,const Quantum opacity)
1937 <p>A description of each parameter follows:</p></ol>
1940 <ol><p>the image.</p></ol>
1943 <ol><p>the RGB value of the target color.</p></ol>
1946 <ol><p>the replacement opacity value.</p></ol>
1949 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1950 _8c.html" target="source" name="ParseSizeGeometry">ParseSizeGeometry</a></h2>
1951 <div class="doc-section">
1953 <p>ParseSizeGeometry() returns a region as defined by the geometry string with respect to the image dimensions and aspect ratio.</p></ol>
1955 <p>The format of the ParseSizeGeometry method is:</p>
1958 MagickStatusType ParseSizeGeometry(const Image *image,
1959 const char *geometry,RectangeInfo *region_info)
1962 <p>A description of each parameter follows:</p></ol>
1965 <ol><p>The geometry (e.g. 100x100+10+10).</p></ol>
1967 <h5>region_info</h5>
1968 <ol><p>the region as defined by the geometry string.</p></ol>
1971 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1972 _8c.html" target="source" name="PopImageList">PopImageList</a></h2>
1973 <div class="doc-section">
1975 <p>PopImageList() removes the last image in the list.</p></ol>
1977 <p>The format of the PopImageList method is:</p>
1980 Image *PopImageList(Image **images)
1983 <p>A description of each parameter follows:</p></ol>
1986 <ol><p>the image list.</p></ol>
1989 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
1990 _8c.html" target="source" name="PopImagePixels">PopImagePixels</a></h2>
1991 <div class="doc-section">
1993 <p>PopImagePixels() transfers one or more pixel components from the image pixel cache to a user supplied buffer. The pixels are returned in network byte order. MagickTrue is returned if the pixels are successfully transferred, otherwise MagickFalse.</p></ol>
1995 <p>The format of the PopImagePixels method is:</p>
1998 size_t PopImagePixels(Image *,const QuantumType quantum,
1999 unsigned char *destination)
2002 <p>A description of each parameter follows:</p></ol>
2005 <ol><p>the image.</p></ol>
2008 <ol><p>Declare which pixel components to transfer (RGB, RGBA, etc).</p></ol>
2010 <h5>destination</h5>
2011 <ol><p>The components are transferred to this buffer.</p></ol>
2014 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2015 _8c.html" target="source" name="PostscriptGeometry">PostscriptGeometry</a></h2>
2016 <div class="doc-section">
2018 <p>PostscriptGeometry() replaces any page mneumonic with the equivalent size in picas.</p></ol>
2020 <p>The format of the PostscriptGeometry method is:</p>
2023 char *PostscriptGeometry(const char *page)
2026 <p>A description of each parameter follows.</p></ol>
2029 <ol><p>Specifies a pointer to an array of characters. The string is either a Postscript page name (e.g. A4) or a postscript page geometry (e.g. 612x792+36+36).</p></ol>
2032 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2033 _8c.html" target="source" name="PushImageList">PushImageList</a></h2>
2034 <div class="doc-section">
2036 <p>PushImageList() adds an image to the end of the list.</p></ol>
2038 <p>The format of the PushImageList method is:</p>
2041 unsigned int PushImageList(Image *images,const Image *image,
2042 ExceptionInfo *exception)
2045 <p>A description of each parameter follows:</p></ol>
2048 <ol><p>the image list.</p></ol>
2051 <ol><p>the image.</p></ol>
2054 <ol><p>return any errors or warnings in this structure.</p></ol>
2057 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2058 _8c.html" target="source" name="PushImagePixels">PushImagePixels</a></h2>
2059 <div class="doc-section">
2061 <p>PushImagePixels() transfers one or more pixel components from a user supplied buffer into the image pixel cache of an image. The pixels are expected in network byte order. It returns MagickTrue if the pixels are successfully transferred, otherwise MagickFalse.</p></ol>
2063 <p>The format of the PushImagePixels method is:</p>
2066 size_t PushImagePixels(Image *image,const QuantumType quantum,
2067 const unsigned char *source)
2070 <p>A description of each parameter follows:</p></ol>
2073 <ol><p>the image.</p></ol>
2076 <ol><p>Declare which pixel components to transfer (red, green, blue, opacity, RGB, or RGBA).</p></ol>
2079 <ol><p>The pixel components are transferred from this buffer.</p></ol>
2082 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2083 _8c.html" target="source" name="QuantizationError">QuantizationError</a></h2>
2084 <div class="doc-section">
2086 <p>QuantizationError() measures the difference between the original and quantized images. This difference is the total quantization error. The error is computed by summing over all pixels in an image the distance squared in RGB space between each reference pixel value and its quantized value. These values are computed:</p>
2089 o mean_error_per_pixel: This value is the mean error for any single
2093 <h5>normalized_mean_square_error</h5>
2094 <ol><p>This value is the normalized mean quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in the image.</p></ol>
2096 <h5>normalized_maximum_square_error</h5>
2097 <ol><p>Thsi value is the normalized maximum quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in your image.</p></ol>
2100 <p>The format of the QuantizationError method is:</p>
2103 unsigned int QuantizationError(Image *image)
2106 <p>A description of each parameter follows.</p></ol>
2109 <ol><p>Specifies a pointer to an Image structure; returned from ReadImage.</p></ol>
2112 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2113 _8c.html" target="source" name="RandomChannelThresholdImage">RandomChannelThresholdImage</a></h2>
2114 <div class="doc-section">
2116 <p>RandomChannelThresholdImage() changes the value of individual pixels based on the intensity of each pixel compared to a random threshold. The result is a low-contrast, two color image.</p></ol>
2118 <p>The format of the RandomChannelThresholdImage method is:</p>
2121 unsigned int RandomChannelThresholdImage(Image *image,
2122 const char *channel, const char *thresholds,
2123 ExceptionInfo *exception)
2126 <p>A description of each parameter follows:</p></ol>
2129 <ol><p>the image.</p></ol>
2132 <ol><p>the channel or channels to be thresholded.</p></ol>
2135 <ol><p>a geometry string containing LOWxHIGH thresholds. If the string contains 2x2, 3x3, or 4x4, then an ordered dither of order 2, 3, or 4 will be performed instead.</p></ol>
2138 <ol><p>return any errors or warnings in this structure.</p></ol>
2141 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2142 _8c.html" target="source" name="ReacquireMemory">ReacquireMemory</a></h2>
2143 <div class="doc-section">
2145 <p>ReacquireMemory() changes the size of the memory and returns a pointer to the (possibly moved) block. The contents will be unchanged up to the lesser of the new and old sizes.</p></ol>
2147 <p>The format of the ReacquireMemory method is:</p>
2150 void ReacquireMemory(void **memory,const size_t size)
2153 <p>A description of each parameter follows:</p></ol>
2156 <ol><p>A pointer to a memory allocation. On return the pointer may change but the contents of the original allocation will not.</p></ol>
2159 <ol><p>the new size of the allocated memory.</p></ol>
2162 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2163 _8c.html" target="source" name="ResetImageAttributeIterator">ResetImageAttributeIterator</a></h2>
2164 <div class="doc-section">
2166 <p>ResetImageAttributeIterator() resets the image attributes iterator. Use it in conjunction with GetNextImageAttribute() to iterate over all the values associated with an image.</p></ol>
2168 <p>The format of the ResetImageAttributeIterator method is:</p>
2171 ResetImageAttributeIterator(const ImageInfo *image)
2174 <p>A description of each parameter follows:</p></ol>
2177 <ol><p>the image.</p></ol>
2180 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2181 _8c.html" target="source" name="SetCacheViewPixels">SetCacheViewPixels</a></h2>
2182 <div class="doc-section">
2184 <p>SetCacheViewPixels() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
2186 <p>The format of the SetCacheViewPixels method is:</p>
2189 PixelPacket *SetCacheViewPixels(CacheView *cache_view,const long x,
2190 const long y,const unsigned long columns,const unsigned long rows)
2193 <p>A description of each parameter follows:</p></ol>
2196 <ol><p>the cache view.</p></ol>
2198 <h5>x,y,columns,rows</h5>
2199 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
2202 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2203 _8c.html" target="source" name="SetExceptionInfo">SetExceptionInfo</a></h2>
2204 <div class="doc-section">
2206 <p>SetExceptionInfo() sets the exception severity.</p></ol>
2208 <p>The format of the SetExceptionInfo method is:</p>
2211 MagickBooleanType SetExceptionInfo(ExceptionInfo *exception,
2212 ExceptionType severity)
2215 <p>A description of each parameter follows:</p></ol>
2218 <ol><p>the exception info.</p></ol>
2221 <ol><p>the exception severity.</p></ol>
2224 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2225 _8c.html" target="source" name="SetImage">SetImage</a></h2>
2226 <div class="doc-section">
2228 <p>SetImage() sets the red, green, and blue components of each pixel to the image background color and the opacity component to the specified level of transparency. The background color is defined by the background_color member of the image.</p></ol>
2230 <p>The format of the SetImage method is:</p>
2233 void SetImage(Image *image,const Quantum opacity)
2236 <p>A description of each parameter follows:</p></ol>
2239 <ol><p>the image.</p></ol>
2242 <ol><p>Set each pixel to this level of transparency.</p></ol>
2245 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2246 _8c.html" target="source" name="SetImageAttribute">SetImageAttribute</a></h2>
2247 <div class="doc-section">
2249 <p>SetImageAttribute() searches the list of image attributes and replaces the attribute value. If it is not found in the list, the attribute name and value is added to the list.</p></ol>
2251 <p>The format of the SetImageAttribute method is:</p>
2254 MagickBooleanType SetImageAttribute(Image *image,const char *key,
2258 <p>A description of each parameter follows:</p></ol>
2261 <ol><p>the image.</p></ol>
2264 <ol><p>the key.</p></ol>
2267 <ol><p>the value.</p></ol>
2270 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2271 _8c.html" target="source" name="SetImageList">SetImageList</a></h2>
2272 <div class="doc-section">
2274 <p>SetImageList() inserts an image into the list at the specified position.</p></ol>
2276 <p>The format of the SetImageList method is:</p>
2279 unsigned int SetImageList(Image *images,const Image *image,
2280 const long offset,ExceptionInfo *exception)
2283 <p>A description of each parameter follows:</p></ol>
2286 <ol><p>the image list.</p></ol>
2289 <ol><p>the image.</p></ol>
2292 <ol><p>the position within the list.</p></ol>
2295 <ol><p>return any errors or warnings in this structure.</p></ol>
2298 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2299 _8c.html" target="source" name="SetImagePixels">SetImagePixels</a></h2>
2300 <div class="doc-section">
2302 <p>SetImagePixels() queues a mutable pixel region. If the region is successfully intialized a pointer to a PixelPacket array representing the region is returned, otherwise NULL is returned. The returned pointer may point to a temporary working buffer for the pixels or it may point to the final location of the pixels in memory.</p></ol>
2304 <p>Write-only access means that any existing pixel values corresponding to the region are ignored. This useful while the initial image is being created from scratch, or if the existing pixel values are to be completely replaced without need to refer to their pre-existing values. The application is free to read and write the pixel buffer returned by SetImagePixels() any way it pleases. SetImagePixels() does not initialize the pixel array values. Initializing pixel array values is the application's responsibility.</p></ol>
2306 <p>Performance is maximized if the selected region is part of one row, or one or more full rows, since then there is opportunity to access the pixels in-place (without a copy) if the image is in RAM, or in a memory-mapped file. The returned pointer should *never* be deallocated by the user.</p></ol>
2308 <p>Pixels accessed via the returned pointer represent a simple array of type PixelPacket. If the image type is CMYK or the storage class is PseudoClass, call GetAuthenticIndexQueue() after invoking GetAuthenticPixels() to obtain the black color component or the colormap indexes (of type IndexPacket) corresponding to the region. Once the PixelPacket (and/or IndexPacket) array has been updated, the changes must be saved back to the underlying image using SyncAuthenticPixels() or they may be lost.</p></ol>
2310 <p>The format of the SetImagePixels() method is:</p>
2313 PixelPacket *SetImagePixels(Image *image,const long x,const long y,
2314 const unsigned long columns,const unsigned long rows)
2317 <p>A description of each parameter follows:</p></ol>
2320 <ol><p>SetImagePixels returns a pointer to the pixels if they are transferred, otherwise a NULL is returned.</p></ol>
2323 <ol><p>the image.</p></ol>
2325 <h5>x,y,columns,rows</h5>
2326 <ol><p>These values define the perimeter of a region of pixels.</p></ol>
2329 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2330 _8c.html" target="source" name="SetMagickRegistry">SetMagickRegistry</a></h2>
2331 <div class="doc-section">
2333 <p>SetMagickRegistry() sets a blob into the registry and returns a unique ID. If an error occurs, -1 is returned.</p></ol>
2335 <p>The format of the SetMagickRegistry method is:</p>
2338 long SetMagickRegistry(const RegistryType type,const void *blob,
2339 const size_t length,ExceptionInfo *exception)
2342 <p>A description of each parameter follows:</p></ol>
2345 <ol><p>the registry type.</p></ol>
2348 <ol><p>the address of a Binary Large OBject.</p></ol>
2351 <ol><p>For a registry type of ImageRegistryType use sizeof(Image) otherise the blob length in number of bytes.</p></ol>
2354 <ol><p>return any errors or warnings in this structure.</p></ol>
2357 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2358 _8c.html" target="source" name="SetMonitorHandler">SetMonitorHandler</a></h2>
2359 <div class="doc-section">
2361 <p>SetMonitorHandler() sets the monitor handler to the specified method and returns the previous monitor handler.</p></ol>
2363 <p>The format of the SetMonitorHandler method is:</p>
2366 MonitorHandler SetMonitorHandler(MonitorHandler handler)
2369 <p>A description of each parameter follows:</p></ol>
2372 <ol><p>Specifies a pointer to a method to handle monitors.</p></ol>
2375 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2376 _8c.html" target="source" name="ShiftImageList">ShiftImageList</a></h2>
2377 <div class="doc-section">
2379 <p>ShiftImageList() removes an image from the beginning of the list.</p></ol>
2381 <p>The format of the ShiftImageList method is:</p>
2384 Image *ShiftImageList(Image **images)
2387 <p>A description of each parameter follows:</p></ol>
2390 <ol><p>the image list.</p></ol>
2393 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2394 _8c.html" target="source" name="SpliceImageList">SpliceImageList</a></h2>
2395 <div class="doc-section">
2397 <p>SpliceImageList() removes the images designated by offset and length from the list and replaces them with the specified list.</p></ol>
2399 <p>The format of the SpliceImageList method is:</p>
2402 Image *SpliceImageList(Image *images,const long offset,
2403 const unsigned long length,const Image *splices,
2404 ExceptionInfo *exception)
2407 <p>A description of each parameter follows:</p></ol>
2410 <ol><p>the image list.</p></ol>
2413 <ol><p>the position within the list.</p></ol>
2416 <ol><p>the length of the image list to remove.</p></ol>
2419 <ol><p>Replace the removed image list with this list.</p></ol>
2422 <ol><p>return any errors or warnings in this structure.</p></ol>
2425 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2426 _8c.html" target="source" name="Strip">Strip</a></h2>
2427 <div class="doc-section">
2429 <p>Strip() strips any whitespace or quotes from the beginning and end of a string of characters.</p></ol>
2431 <p>The format of the Strip method is:</p>
2434 void Strip(char *message)
2437 <p>A description of each parameter follows:</p></ol>
2440 <ol><p>Specifies an array of characters.</p></ol>
2443 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2444 _8c.html" target="source" name="SyncCacheView">SyncCacheView</a></h2>
2445 <div class="doc-section">
2447 <p>SyncCacheView() saves the cache view pixels to the in-memory or disk cache. It returns MagickTrue if the pixel region is synced, otherwise MagickFalse.</p></ol>
2449 <p>The format of the SyncCacheView method is:</p>
2452 MagickBooleanType SyncCacheView(CacheView *cache_view)
2455 <p>A description of each parameter follows:</p></ol>
2458 <ol><p>the cache view.</p></ol>
2461 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2462 _8c.html" target="source" name="SyncCacheViewPixels">SyncCacheViewPixels</a></h2>
2463 <div class="doc-section">
2465 <p>SyncCacheViewPixels() saves the cache view pixels to the in-memory or disk cache. It returns MagickTrue if the pixel region is flushed, otherwise MagickFalse.</p></ol>
2467 <p>The format of the SyncCacheViewPixels method is:</p>
2470 MagickBooleanType SyncCacheViewPixels(CacheView *cache_view)
2473 <p>A description of each parameter follows:</p></ol>
2476 <ol><p>the cache view.</p></ol>
2479 <ol><p>return any errors or warnings in this structure.</p></ol>
2482 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2483 _8c.html" target="source" name="SyncImagePixels">SyncImagePixels</a></h2>
2484 <div class="doc-section">
2486 <p>SyncImagePixels() saves the image pixels to the in-memory or disk cache. The method returns MagickTrue if the pixel region is synced, otherwise MagickFalse.</p></ol>
2488 <p>The format of the SyncImagePixels() method is:</p>
2491 MagickBooleanType SyncImagePixels(Image *image)
2494 <p>A description of each parameter follows:</p></ol>
2497 <ol><p>the image.</p></ol>
2500 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2501 _8c.html" target="source" name="TemporaryFilename">TemporaryFilename</a></h2>
2502 <div class="doc-section">
2504 <p>TemporaryFilename() replaces the contents of path by a unique path name.</p></ol>
2506 <p>The format of the TemporaryFilename method is:</p>
2509 void TemporaryFilename(char *path)
2512 <p>A description of each parameter follows.</p></ol>
2515 <ol><p>Specifies a pointer to an array of characters. The unique path name is returned in this array.</p></ol>
2518 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2519 _8c.html" target="source" name="ThresholdImage">ThresholdImage</a></h2>
2520 <div class="doc-section">
2522 <p>ThresholdImage() changes the value of individual pixels based on the intensity of each pixel compared to threshold. The result is a high-contrast, two color image.</p></ol>
2524 <p>The format of the ThresholdImage method is:</p>
2527 unsigned int ThresholdImage(Image *image,const double threshold)
2530 <p>A description of each parameter follows:</p></ol>
2533 <ol><p>the image.</p></ol>
2536 <ol><p>Define the threshold value</p></ol>
2539 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2540 _8c.html" target="source" name="ThresholdImageChannel">ThresholdImageChannel</a></h2>
2541 <div class="doc-section">
2543 <p>ThresholdImageChannel() changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.</p></ol>
2545 <p>The format of the ThresholdImageChannel method is:</p>
2548 unsigned int ThresholdImageChannel(Image *image,const char *threshold)
2551 <p>A description of each parameter follows:</p></ol>
2554 <ol><p>the image.</p></ol>
2557 <ol><p>define the threshold values.</p></ol>
2560 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2561 _8c.html" target="source" name="TransformHSL">TransformHSL</a></h2>
2562 <div class="doc-section">
2564 <p>TransformHSL() converts a (red, green, blue) to a (hue, saturation, lightness) triple.</p></ol>
2566 <p>The format of the TransformHSL method is:</p>
2569 void TransformHSL(const Quantum red,const Quantum green,
2570 const Quantum blue,double *hue,double *saturation,double *lightness)
2573 <p>A description of each parameter follows:</p></ol>
2575 <h5>red, green, blue</h5>
2576 <ol><p>A Quantum value representing the red, green, and blue component of a pixel..</p></ol>
2578 <h5>hue, saturation, lightness</h5>
2579 <ol><p>A pointer to a double value representing a component of the HSL color space.</p></ol>
2582 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2583 _8c.html" target="source" name="TranslateText">TranslateText</a></h2>
2584 <div class="doc-section">
2586 <p>TranslateText() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p></ol>
2588 <p>The format of the TranslateText method is:</p>
2591 char *TranslateText(const ImageInfo *image_info,Image *image,
2592 const char *embed_text)
2595 <p>A description of each parameter follows:</p></ol>
2598 <ol><p>the image info.</p></ol>
2601 <ol><p>the image.</p></ol>
2604 <ol><p>the address of a character string containing the embedded formatting characters.</p></ol>
2607 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2608 _8c.html" target="source" name="TransparentImage">TransparentImage</a></h2>
2609 <div class="doc-section">
2611 <p>TransparentImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p></ol>
2613 <p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p></ol>
2615 <p>The format of the TransparentImage method is:</p>
2618 MagickBooleanType TransparentImage(Image *image,
2619 const PixelPacket target,const Quantum opacity)
2622 <p>A description of each parameter follows:</p></ol>
2625 <ol><p>the image.</p></ol>
2628 <ol><p>the RGB value of the target color.</p></ol>
2631 <ol><p>the replacement opacity value.</p></ol>
2634 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
2635 _8c.html" target="source" name="UnshiftImageList">UnshiftImageList</a></h2>
2636 <div class="doc-section">
2638 <p>UnshiftImageList() adds the image to the beginning of the list.</p></ol>
2640 <p>The format of the UnshiftImageList method is:</p>
2643 unsigned int UnshiftImageList(Image *images,const Image *image,
2644 ExceptionInfo *exception)
2647 <p>A description of each parameter follows:</p></ol>
2650 <ol><p>the image list.</p></ol>
2653 <ol><p>the image.</p></ol>
2656 <ol><p>return any errors or warnings in this structure.</p></ol>
2662 <div id="linkbar">
\r
2663 <!-- <span id="linkbar-west"> </span> -->
\r
2664 <span id="linkbar-center">
\r
2665 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> •
\r
2666 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
\r
2668 <span id="linkbar-east"> </span>
\r
2670 <div class="footer">
\r
2671 <span id="footer-west">© 1999-2010 ImageMagick Studio LLC</span>
\r
2672 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
\r
2674 <div style="clear: both; margin: 0; width: 100%; "></div>
\r