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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3 <html version="-//W3C//DTD XHTML 1.1//EN"
   4       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
   5       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   6       xsi:schemaLocation="http://www.w3.org/1999/xhtml
   7                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
   8 <head>
   9   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
  10   <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
  11   <title>ImageMagick: MagickCore, C API for ImageMagick: Deprecated Methods</title>
  12   <meta http-equiv="content-language" content="en-US"/>
  13   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
  14   <meta http-equiv="reply-to" content="magick-users@imagemagick.org"/>
  15   <meta name="application-name" content="ImageMagick"/>
  16   <meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition resize, rotate, shear, distort and transform images automagically."/>
  17   <meta name="application-url" content="http://www.imagemagick.org"/>
  18   <meta name="generator" content="PHP"/>
  19   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, deprecated, methods, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"/>
  20   <meta name="rating" content="GENERAL"/>
  21   <meta name="robots" content="INDEX, FOLLOW"/>
  22   <meta name="generator" content="ImageMagick Studio LLC"/>
  23   <meta name="author" content="ImageMagick Studio LLC"/>
  24   <meta name="revisit-after" content="2 DAYS"/>
  25   <meta name="resource-type" content="document"/>
  26   <meta name="copyright" content="Copyright (c) 1999-2013 ImageMagick Studio LLC"/>
  27   <meta name="distribution" content="Global"/>
  28   <link rel="icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.png"/>
  29   <link rel="shortcut icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.ico"  type="images/x-icon"/>
  30   <link rel="canonical" href="http://www.imagemagick.org" />
  31   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
  32   <!-- Add jQuery library -->
  33   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7/jquery.min.js"></script>
  34
  35   <!-- Optionaly include easing and/or mousewheel plugins -->
  36   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.easing-1.3.pack.js"></script>
  37   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.mousewheel-3.0.6.pack.js"></script>
  38
  39   <!-- Add fancyBox -->
  40   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/jquery.fancybox.css?v=2.0.4" type="text/css" media="screen" />
  41   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.4"></script>
  42
  43   <!-- Optionaly include button and/or thumbnail helpers -->
  44   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.css?v=2.0.4" type="text/css" media="screen" />
  45   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.4"></script>
  46
  47   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.4" type="text/css" media="screen" />
  48   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.4"></script>
  49   <script type="text/javascript">
  50         $(document).ready(function() {
  51                 $(".fancybox").fancybox();
  52         });
  53   </script>
  54   <!-- ImageMagick style -->
  55   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
  56   <style type="text/css" media="all">
  57     @import url("../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick.css");
  58   </style>
  59 </head>
  60
  61 <body id="www-imagemagick-org">
  62 <div class="titlebar">
  63 <div style="margin: 17px auto; float: left;">
  64   <script type="text/javascript">
  65   <!--
  66     google_ad_client = "pub-3129977114552745";
  67     google_ad_slot = "5439289906";
  68     google_ad_width = 728;
  69     google_ad_height = 90;
  70   //-->
  71   </script>
  72   <script type="text/javascript"
  73     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
  74   </script>
  75 </div>
  76 <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">
  77   <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/logo.jpg"
  78   alt="ImageMagick Logo"
  79   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
  80 <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">
  81   <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/sprite.jpg"
  82   alt="ImageMagick Sprite"
  83   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  84 </div>
  85
  86 <div class="westbar">
  87
  88 <div class="menu">
  89   <a title="About ImageMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">About ImageMagick</a>
  90 </div>
  91 <div class="menu">
  92   <a title="Binary Releases" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html">Binary Releases</a>
  93 </div>
  94 <div class="sub">
  95     <a title="Binary Release: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#unix">Unix</a>
  96 </div>
  97 <div class="sub">
  98     <a title="Binary Release: MacOS X" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#macosx">Mac OS X</a>
  99 </div>
 100 <div class="sub">
 101     <a title="Binary Release: iOS" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#iOS">iOS</a>
 102 </div>
 103 <div class="sub">
 104     <a title="Binary Release: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#windows">Windows</a>
 105 </div>
 106 <div class="sep"></div>
 107 <div class="menu">
 108   <a title="Command-line Tools" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-tools.html">Command-line Tools</a>
 109 </div>
 110 <div class="sub">
 111     <a title="Command-line Tools: Processing" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-processing.html">Processing</a>
 112 </div>
 113 <div class="sub">
 114     <a title="Command-line Tools: Options" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-options.html">Options</a>
 115 </div>
 116 <div class="sub">
 117     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 118 </div>
 119 <div class="menu">
 120   <a title="Program Interfaces" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/api.html">Program Interfaces</a>
 121 </div>
 122 <div class="sub">
 123     <a title="Program Interface: MagickWand" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-wand.html">MagickWand</a>
 124 </div>
 125 <div class="sub">
 126     <a title="Program Interface: MagickCore" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-core.html">MagickCore</a>
 127 </div>
 128 <div class="sub">
 129     <a title="Program Interface: PerlMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/perl-magick.html">PerlMagick</a>
 130 </div>
 131 <div class="sub">
 132     <a title="Program Interface: Magick++" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick++.html">Magick++</a>
 133 </div>
 134 <div class="sep"></div>
 135 <div  class="menu">
 136    <a title="Install from Source" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html">Install from Source</a>
 137 </div>
 138 <div class="sub">
 139     <a title="Install from Source: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#unix">Unix</a>
 140 </div>
 141 <div class="sub">
 142     <a title="Install from Source: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#windows">Windows</a>
 143  </div>
 144 <div class="menu">
 145   <a title="Resources" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/resources.html">Resources</a>
 146 </div>
 147 <div class="menu">
 148   <a title="Architecture" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/architecture.html">Architecture</a>
 149 </div>
 150 <div class="menu">
 151   <a title="Download" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/download.html">Download</a>
 152 </div>
 153 <div class="sep"></div>
 154 <div class="menu">
 155   <a title="Search" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/search.html">Search</a>
 156 </div>
 157 <div class="sep"></div>
 158 <div class="menu">
 159   <a title="Site Map" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sitemap.html">Site Map</a>
 160 </div>
 161 <div  class="sub">
 162   <a title="Site Map: Links" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/links.html">Links</a>
 163 </div>
 164 <div class="sep"></div>
 165 <div class="menu">
 166   <a rel="follow" title="Sponsors" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sponsors.html">Sponsors:</a>
 167
 168   <a href="http://www.networkredux.com"> <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/networkredux.png" width="140" height="31" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
 169   <a href="http://www.dinodirect.com/ipads-tablets/"> <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/dino-direct.jpg" width="140" height="90" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a><!-- 201208010120 mickey@163... -->
 170 <div class="sponsbox">
 171 <div class="sponsor">
 172   <a rel="follow" title="Sponsor: The Fastest &amp; Easiest Way to Find Images" href="http://www.graphicsfactory.com">The Fastest &amp; Easiest Way to Find Images</a><!-- 201210010270 graphicsfac... -->
 173 </div>
 174 <div class="sponsor">
 175   <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201209010090 barsh@inter... -->
 176 </div>
 177 <div class="sponsor">
 178   <a rel="follow" title="Werbebanner Werbeplane" href="http://www.allesbanner.de">Werbebanner Werbeplane</a><!-- 201212010450 info@druck... -->
 179 </div>
 180 <div class="sponsor">
 181   <a rel="follow" title="Entertainment News &amp; Photos" href="http://www.zimbio.com">Entertainment News &amp; Photos</a><!-- 201211010540 bd@zimb... -->
 182 </div>
 183 <div class="sponsor">
 184   <a rel="follow" title="Sponsor: LED24" href="http://led24.de/">LED24</a><!-- 201207010270 info@led24... -->
 185 </div>
 186 <div class="sponsor">
 187   <a rel="follow" title="Sponsor: Best Website Hosting" href="http://www.top-cheap-web-hosting.com">Best Website Hosting</a><!-- 201304010090 eunge.liu-->
 188 </div>
 189 <div class="sponsor">
 190   <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201208010120 mickey@163... -->
 191 </div>
 192 <div class="sponsor">
 193   <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
 194 </div>
 195 <div class="sponsor">
 196    <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
 197 </div>
 198 <div class="sponsor">
 199    <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
 200 </div>
 201 <div class="sponsor">
 202   <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
 203 </div>
 204 <div class="sponsor">
 205   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 206 </div>
 207 <div  class="sponsor">
 208    <a rel="follow" title="Sponsor: Kaffeemaschinen reparatur" href="http://www.kaffeemaschinen-reparatur.de">Kaffeemaschinen reparatur</a><!-- 2012080100030 Temurbas atlas-multimedia-->
 209 </div>
 210 <div class="sponsor">
 211    <a rel="follow" title="Sponsor: Fototapete - Tapetendruck" href="http://www.druck-expert.com/Fototapete-Tapetendruck,category,8830.html">Fototapete - Tapetendruck</a><!-- 2012100100155 info@druck-->
 212 </div>
 213 </div>
 214 </div>
 215 </div>
 216
 217 <div class="eastbar">
 218   <div class="g-plusone" id="gplusone"></div>
 219   <script type="text/javascript">
 220     window.___gcfg = {
 221       lang: 'en-US'
 222     };
 223
 224     (function() {
 225       var po = document.createElement('script');
 226       po.type = 'text/javascript'; po.async = true;
 227       po.src = 'https://apis.google.com/js/plusone.js';
 228       var script = document.getElementsByTagName('script')[0];
 229       script.parentNode.insertBefore(po, script);
 230     })();
 231     var gplusone = document.getElementById("gplusone");
 232     gplusone.setAttribute("data-size","medium");
 233     gplusone.setAttribute("data-count","false");
 234   </script>
 235 </div>
 236
 237 <div class="main">
 238
 239 <h1>Module deprecate Methods</h1>
 240 <p class="navigation-index">[<a href="deprecate.html#AcquireCacheViewIndexes">AcquireCacheViewIndexes</a> &bull; <a href="deprecate.html#AcquireCacheViewPixels">AcquireCacheViewPixels</a> &bull; <a href="deprecate.html#AcquireImagePixels">AcquireImagePixels</a> &bull; <a href="deprecate.html#AcquireIndexes">AcquireIndexes</a> &bull; <a href="deprecate.html#AcquireMemory">AcquireMemory</a> &bull; <a href="deprecate.html#AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a> &bull; <a href="deprecate.html#AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a> &bull; <a href="deprecate.html#AcquireOneMagickPixel">AcquireOneMagickPixel</a> &bull; <a href="deprecate.html#AcquireOnePixel">AcquireOnePixel</a> &bull; <a href="deprecate.html#AcquireOneVirtualPixel">AcquireOneVirtualPixel</a> &bull; <a href="deprecate.html#AcquirePixels">AcquirePixels</a> &bull; <a href="deprecate.html#AffinityImage">AffinityImage</a> &bull; <a href="deprecate.html#AffinityImages">AffinityImages</a> &bull; <a href="deprecate.html#AllocateImage">AllocateImage</a> &bull; <a href="deprecate.html#AllocateImageColormap">AllocateImageColormap</a> &bull; <a href="deprecate.html#AllocateNextImage">AllocateNextImage</a> &bull; <a href="deprecate.html#AllocateString">AllocateString</a> &bull; <a href="deprecate.html#AverageImages">AverageImages</a> &bull; <a href="deprecate.html#ChannelThresholdImage">ChannelThresholdImage</a> &bull; <a href="deprecate.html#ClipPathImage">ClipPathImage</a> &bull; <a href="deprecate.html#CloneImageAttributes">CloneImageAttributes</a> &bull; <a href="deprecate.html#CloneMemory">CloneMemory</a> &bull; <a href="deprecate.html#CloseCacheView">CloseCacheView</a> &bull; <a href="deprecate.html#ColorFloodfill">ColorFloodfill</a> &bull; <a href="deprecate.html#DeleteImageAttribute">DeleteImageAttribute</a> &bull; <a href="deprecate.html#DeleteImageList">DeleteImageList</a> &bull; <a href="deprecate.html#DeleteMagickRegistry">DeleteMagickRegistry</a> &bull; <a href="deprecate.html#DescribeImage">DescribeImage</a> &bull; <a href="deprecate.html#DestroyImageAttributes">DestroyImageAttributes</a> &bull; <a href="deprecate.html#DestroyImages">DestroyImages</a> &bull; <a href="deprecate.html#DestroyMagick">DestroyMagick</a> &bull; <a href="deprecate.html#DispatchImage">DispatchImage</a> &bull; <a href="deprecate.html#ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a> &bull; <a href="deprecate.html#FlattenImages">FlattenImages</a> &bull; <a href="deprecate.html#FormatImageAttribute">FormatImageAttribute</a> &bull; <a href="deprecate.html#FormatMagickString">FormatMagickString</a> &bull; <a href="deprecate.html#FormatString">FormatString</a> &bull; <a href="deprecate.html#GetConfigureBlob">GetConfigureBlob</a> &bull; <a href="deprecate.html#GetCacheView">GetCacheView</a> &bull; <a href="deprecate.html#GetCacheViewIndexes">GetCacheViewIndexes</a> &bull; <a href="deprecate.html#GetCacheViewPixels">GetCacheViewPixels</a> &bull; <a href="deprecate.html#GetImageAttribute">GetImageAttribute</a> &bull; <a href="deprecate.html#GetImageClippingPathAttribute">GetImageClippingPathAttribute</a> &bull; <a href="deprecate.html#GetImageFromMagickRegistry">GetImageFromMagickRegistry</a> &bull; <a href="deprecate.html#GetMagickRegistry">GetMagickRegistry</a> &bull; <a href="deprecate.html#GetImageGeometry">GetImageGeometry</a> &bull; <a href="deprecate.html#GetImageList">GetImageList</a> &bull; <a href="deprecate.html#GetImageListIndex">GetImageListIndex</a> &bull; <a href="deprecate.html#GetImageListSize">GetImageListSize</a> &bull; <a href="deprecate.html#GetImagePixels">GetImagePixels</a> &bull; <a href="deprecate.html#GetIndexes">GetIndexes</a> &bull; <a href="deprecate.html#GetNextImage">GetNextImage</a> &bull; <a href="deprecate.html#GetNextImageAttribute">GetNextImageAttribute</a> &bull; <a href="deprecate.html#GetNumberScenes">GetNumberScenes</a> &bull; <a href="deprecate.html#GetOnePixel">GetOnePixel</a> &bull; <a href="deprecate.html#GetPixels">GetPixels</a> &bull; <a href="deprecate.html#GetPreviousImage">GetPreviousImage</a> &bull; <a href="deprecate.html#HSLTransform">HSLTransform</a> &bull; <a href="deprecate.html#IdentityAffine">IdentityAffine</a> &bull; <a href="deprecate.html#InitializeMagick">InitializeMagick</a> &bull; <a href="deprecate.html#InterpolatePixelColor">InterpolatePixelColor</a> &bull; <a href="deprecate.html#InterpretImageAttributes">InterpretImageAttributes</a> &bull; <a href="deprecate.html#LevelImageColor">LevelImageColor</a> &bull; <a href="deprecate.html#LiberateMemory">LiberateMemory</a> &bull; <a href="deprecate.html#LiberateSemaphoreInfo">LiberateSemaphoreInfo</a> &bull; <a href="deprecate.html#MagickIncarnate">MagickIncarnate</a> &bull; <a href="deprecate.html#MagickMonitor">MagickMonitor</a> &bull; <a href="deprecate.html#MapImage">MapImage</a> &bull; <a href="deprecate.html#MapImages">MapImages</a> &bull; <a href="deprecate.html#MatteFloodfill">MatteFloodfill</a> &bull; <a href="deprecate.html#MaximumImages">MaximumImages</a> &bull; <a href="deprecate.html#MinimumImages">MinimumImages</a> &bull; <a href="deprecate.html#MedianFilterImage">MedianFilterImage</a> &bull; <a href="deprecate.html#ModeImage">ModeImage</a> &bull; <a href="deprecate.html#MosaicImages">MosaicImages</a> &bull; <a href="deprecate.html#OpaqueImage">OpaqueImage</a> &bull; <a href="deprecate.html#OpenCacheView">OpenCacheView</a> &bull; <a href="deprecate.html#OpenMagickStream">OpenMagickStream</a> &bull; <a href="deprecate.html#PaintFloodfill">PaintFloodfill</a> &bull; <a href="deprecate.html#PaintOpaqueImage">PaintOpaqueImage</a> &bull; <a href="deprecate.html#PaintTransparentImage">PaintTransparentImage</a> &bull; <a href="deprecate.html#ParseSizeGeometry">ParseSizeGeometry</a> &bull; <a href="deprecate.html#PopImageList">PopImageList</a> &bull; <a href="deprecate.html#PopImagePixels">PopImagePixels</a> &bull; <a href="deprecate.html#PostscriptGeometry">PostscriptGeometry</a> &bull; <a href="deprecate.html#PushImageList">PushImageList</a> &bull; <a href="deprecate.html#PushImagePixels">PushImagePixels</a> &bull; <a href="deprecate.html#QuantizationError">QuantizationError</a> &bull; <a href="deprecate.html#RandomChannelThresholdImage">RandomChannelThresholdImage</a> &bull; <a href="deprecate.html#ReacquireMemory">ReacquireMemory</a> &bull; <a href="deprecate.html#RecolorImage">RecolorImage</a> &bull; <a href="deprecate.html#ReduceNoiseImage">ReduceNoiseImage</a> &bull; <a href="deprecate.html#ResetImageAttributeIterator">ResetImageAttributeIterator</a> &bull; <a href="deprecate.html#SetCacheViewPixels">SetCacheViewPixels</a> &bull; <a href="deprecate.html#SetExceptionInfo">SetExceptionInfo</a> &bull; <a href="deprecate.html#SetImage">SetImage</a> &bull; <a href="deprecate.html#SetImageAttribute">SetImageAttribute</a> &bull; <a href="deprecate.html#SetImageList">SetImageList</a> &bull; <a href="deprecate.html#SetImagePixels">SetImagePixels</a> &bull; <a href="deprecate.html#SetMagickRegistry">SetMagickRegistry</a> &bull; <a href="deprecate.html#SetMonitorHandler">SetMonitorHandler</a> &bull; <a href="deprecate.html#ShiftImageList">ShiftImageList</a> &bull; <a href="deprecate.html#SpliceImageList">SpliceImageList</a> &bull; <a href="deprecate.html#Strip">Strip</a> &bull; <a href="deprecate.html#SyncCacheView">SyncCacheView</a> &bull; <a href="deprecate.html#SyncCacheViewPixels">SyncCacheViewPixels</a> &bull; <a href="deprecate.html#SyncImagePixels">SyncImagePixels</a> &bull; <a href="deprecate.html#TemporaryFilename">TemporaryFilename</a> &bull; <a href="deprecate.html#ThresholdImage">ThresholdImage</a> &bull; <a href="deprecate.html#ThresholdImageChannel">ThresholdImageChannel</a> &bull; <a href="deprecate.html#TransformHSL">TransformHSL</a> &bull; <a href="deprecate.html#TranslateText">TranslateText</a> &bull; <a href="deprecate.html#TransparentImage">TransparentImage</a> &bull; <a href="deprecate.html#UnshiftImageList">UnshiftImageList</a> &bull; <a href="deprecate.html#ZoomImage">ZoomImage</a>]</p>
 241
 242 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireCacheViewIndexes">AcquireCacheViewIndexes</a></h2>
 243 <div class="doc-section">
 244
 245 <p>AcquireCacheViewIndexes() returns the indexes associated with the specified view.</p>
 246
 247 <p>Deprecated, replace with:</p>
 248
 249 <pre class="text">
 250       GetCacheViewVirtualIndexQueue(cache_view);
 251 </pre>
 252
 253 <p>The format of the AcquireCacheViewIndexes method is:</p>
 254
 255 <pre class="code">
 256   const IndexPacket *AcquireCacheViewIndexes(const CacheView *cache_view)
 257 </pre>
 258
 259 <p>A description of each parameter follows:</p>
 260
 261 <h5>cache_view</h5>
 262 <p>the cache view.</p>
 263
 264  </div>
 265 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireCacheViewPixels">AcquireCacheViewPixels</a></h2>
 266 <div class="doc-section">
 267
 268 <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>
 269
 270 <p>Deprecated, replace with:</p>
 271
 272 <pre class="text">
 273       GetCacheViewVirtualPixels(cache_view,x,y,columns,rows,exception);
 274 </pre>
 275
 276 <p>The format of the AcquireCacheViewPixels method is:</p>
 277
 278 <pre class="code">
 279   const PixelPacket *AcquireCacheViewPixels(const CacheView *cache_view,
 280     const ssize_t x,const ssize_t y,const size_t columns,
 281     const size_t rows,ExceptionInfo *exception)
 282 </pre>
 283
 284 <p>A description of each parameter follows:</p>
 285
 286 <h5>cache_view</h5>
 287 <p>the cache view.</p>
 288
 289 <h5>x,y,columns,rows</h5>
 290 <p>These values define the perimeter of a region of pixels.</p>
 291
 292 <h5>exception</h5>
 293 <p>return any errors or warnings in this structure.</p>
 294
 295  </div>
 296 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireImagePixels">AcquireImagePixels</a></h2>
 297 <div class="doc-section">
 298
 299 <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>
 300
 301 <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>
 302
 303 <p>If you plan to modify the pixels, use GetAuthenticPixels() instead.</p>
 304
 305 <p>Note, the AcquireImagePixels() and GetAuthenticPixels() methods are not thread-safe.  In a threaded environment, use GetCacheViewVirtualPixels() or GetCacheViewAuthenticPixels() instead.</p>
 306
 307 <p>Deprecated, replace with:</p>
 308
 309 <pre class="text">
 310       GetVirtualPixels(image,x,y,columns,rows,exception);
 311 </pre>
 312
 313 <p>The format of the AcquireImagePixels() method is:</p>
 314
 315 <pre class="code">
 316   const PixelPacket *AcquireImagePixels(const Image *image,const ssize_t x,
 317     const ssize_t y,const size_t columns,const size_t rows,
 318     ExceptionInfo *exception)
 319 </pre>
 320
 321 <p>A description of each parameter follows:</p>
 322
 323 <h5>image</h5>
 324 <p>the image.</p>
 325
 326 <h5>x,y,columns,rows</h5>
 327 <p>These values define the perimeter of a region of pixels.</p>
 328
 329 <h5>exception</h5>
 330 <p>return any errors or warnings in this structure.</p>
 331
 332  </div>
 333 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireIndexes">AcquireIndexes</a></h2>
 334 <div class="doc-section">
 335
 336 <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>
 337
 338 <p>Deprecated, replace with:</p>
 339
 340 <pre class="text">
 341       GetVirtualIndexQueue(image);
 342 </pre>
 343
 344 <p>The format of the AcquireIndexes() method is:</p>
 345
 346 <pre class="code">
 347   const IndexPacket *AcquireIndexes(const Image *image)
 348 </pre>
 349
 350 <p>A description of each parameter follows:</p>
 351
 352 <h5>indexes</h5>
 353 <p>AcquireIndexes() returns the indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p>
 354
 355 <h5>image</h5>
 356 <p>the image.</p>
 357
 358  </div>
 359 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireMemory">AcquireMemory</a></h2>
 360 <div class="doc-section">
 361
 362 <p>AcquireMemory() returns a pointer to a block of memory at least size bytes suitably aligned for any use.</p>
 363
 364 <p>The format of the AcquireMemory method is:</p>
 365
 366 <pre class="code">
 367   void *AcquireMemory(const size_t size)
 368 </pre>
 369
 370 <p>A description of each parameter follows:</p>
 371
 372 <h5>size</h5>
 373 <p>the size of the memory in bytes to allocate.</p>
 374
 375  </div>
 376 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a></h2>
 377 <div class="doc-section">
 378
 379 <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>
 380
 381 <p>Deprecated, replace with:</p>
 382
 383 <pre class="text">
 384       GetOneCacheViewVirtualPixel(cache_view,x,y,pixel,exception);
 385 </pre>
 386
 387 <p>The format of the AcquireOneCacheViewPixel method is:</p>
 388
 389 <pre class="code">
 390   MagickBooleanType AcquireOneCacheViewPixel(const CacheView *cache_view,
 391     const ssize_t x,const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)
 392 </pre>
 393
 394 <p>A description of each parameter follows:</p>
 395
 396 <h5>cache_view</h5>
 397 <p>the cache view.</p>
 398
 399 <h5>x,y</h5>
 400 <p>These values define the offset of the pixel.</p>
 401
 402 <h5>pixel</h5>
 403 <p>return a pixel at the specified (x,y) location.</p>
 404
 405 <h5>exception</h5>
 406 <p>return any errors or warnings in this structure.</p>
 407
 408  </div>
 409 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a></h2>
 410 <div class="doc-section">
 411
 412 <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>
 413
 414 <p>Deprecated, replace with:</p>
 415
 416 <pre class="text">
 417       GetOneCacheViewVirtualMethodPixel(cache_view,virtual_pixel_method,
 418   x,y,pixel,exception);
 419 </pre>
 420
 421 <p>The format of the AcquireOneCacheViewPixel method is:</p>
 422
 423 <pre class="code">
 424   MagickBooleanType AcquireOneCacheViewVirtualPixel(
 425     const CacheView *cache_view,
 426     const VirtualPixelMethod virtual_pixel_method,const ssize_t x,
 427     const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)
 428 </pre>
 429
 430 <p>A description of each parameter follows:</p>
 431
 432 <h5>cache_view</h5>
 433 <p>the cache view.</p>
 434
 435 <h5>virtual_pixel_method</h5>
 436 <p>the virtual pixel method.</p>
 437
 438 <h5>x,y</h5>
 439 <p>These values define the offset of the pixel.</p>
 440
 441 <h5>pixel</h5>
 442 <p>return a pixel at the specified (x,y) location.</p>
 443
 444 <h5>exception</h5>
 445 <p>return any errors or warnings in this structure.</p>
 446
 447  </div>
 448 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneMagickPixel">AcquireOneMagickPixel</a></h2>
 449 <div class="doc-section">
 450
 451 <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>
 452
 453 <p>Deprecated, replace with:</p>
 454
 455 <pre class="text">
 456       MagickPixelPacket pixel;
 457       GetOneVirtualMagickPixel(image,x,y,&pixel,exception);
 458 </pre>
 459
 460 <p>The format of the AcquireOneMagickPixel() method is:</p>
 461
 462 <pre class="code">
 463   MagickPixelPacket AcquireOneMagickPixel(const Image image,const ssize_t x,
 464     const ssize_t y,ExceptionInfo exception)
 465 </pre>
 466
 467 <p>A description of each parameter follows:</p>
 468
 469 <h5>image</h5>
 470 <p>the image.</p>
 471
 472 <h5>x,y</h5>
 473 <p>These values define the location of the pixel to return.</p>
 474
 475 <h5>exception</h5>
 476 <p>return any errors or warnings in this structure.</p>
 477
 478  </div>
 479 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOnePixel">AcquireOnePixel</a></h2>
 480 <div class="doc-section">
 481
 482 <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>
 483
 484 <p>Deprecated, replace with:</p>
 485
 486 <pre class="text">
 487       PixelPacket pixel;
 488       GetOneVirtualPixel(image,x,y,&pixel,exception);
 489 </pre>
 490
 491 <p>The format of the AcquireOnePixel() method is:</p>
 492
 493 <pre class="code">
 494   PixelPacket AcquireOnePixel(const Image image,const ssize_t x,
 495     const ssize_t y,ExceptionInfo exception)
 496 </pre>
 497
 498 <p>A description of each parameter follows:</p>
 499
 500 <h5>image</h5>
 501 <p>the image.</p>
 502
 503 <h5>x,y</h5>
 504 <p>These values define the location of the pixel to return.</p>
 505
 506 <h5>exception</h5>
 507 <p>return any errors or warnings in this structure.</p>
 508
 509  </div>
 510 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneVirtualPixel">AcquireOneVirtualPixel</a></h2>
 511 <div class="doc-section">
 512
 513 <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>
 514
 515 <p>Deprecated, replace with:</p>
 516
 517 <pre class="text">
 518       PixelPacket pixel;
 519       GetOneVirtualMethodPixel(image,virtual_pixel_method,x,y,&pixel,exception);
 520 </pre>
 521
 522 <p>The format of the AcquireOneVirtualPixel() method is:</p>
 523
 524 <pre class="code">
 525   PixelPacket AcquireOneVirtualPixel(const Image image,
 526     const VirtualPixelMethod virtual_pixel_method,const ssize_t x,
 527     const ssize_t y,ExceptionInfo exception)
 528 </pre>
 529
 530 <p>A description of each parameter follows:</p>
 531
 532 <h5>virtual_pixel_method</h5>
 533 <p>the virtual pixel method.</p>
 534
 535 <h5>image</h5>
 536 <p>the image.</p>
 537
 538 <h5>x,y</h5>
 539 <p>These values define the location of the pixel to return.</p>
 540
 541 <h5>exception</h5>
 542 <p>return any errors or warnings in this structure.</p>
 543
 544  </div>
 545 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquirePixels">AcquirePixels</a></h2>
 546 <div class="doc-section">
 547
 548 <p>AcquirePixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p>
 549
 550 <p>Deprecated, replace with:</p>
 551
 552 <pre class="text">
 553       GetVirtualPixelQueue(image);
 554 </pre>
 555
 556 <p>The format of the AcquirePixels() method is:</p>
 557
 558 <pre class="code">
 559   const PixelPacket *AcquirePixels(const Image image)
 560 </pre>
 561
 562 <p>A description of each parameter follows:</p>
 563
 564 <h5>image</h5>
 565 <p>the image.</p>
 566
 567  </div>
 568 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AffinityImage">AffinityImage</a></h2>
 569 <div class="doc-section">
 570
 571 <p>AffinityImage() replaces the colors of an image with the closest color from a reference image.</p>
 572
 573 <p>Deprecated, replace with:</p>
 574
 575 <pre class="text">
 576       RemapImage(quantize_info,image,affinity_image);
 577 </pre>
 578
 579 <p>The format of the AffinityImage method is:</p>
 580
 581 <pre class="code">
 582   MagickBooleanType AffinityImage(const QuantizeInfo *quantize_info,
 583     Image *image,const Image *affinity_image)
 584 </pre>
 585
 586 <p>A description of each parameter follows:</p>
 587
 588 <h5>quantize_info</h5>
 589 <p>Specifies a pointer to an QuantizeInfo structure.</p>
 590
 591 <h5>image</h5>
 592 <p>the image.</p>
 593
 594 <h5>affinity_image</h5>
 595 <p>the reference image.</p>
 596
 597  </div>
 598 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AffinityImages">AffinityImages</a></h2>
 599 <div class="doc-section">
 600
 601 <p>AffinityImages() replaces the colors of a sequence of images with the closest color from a reference image.</p>
 602
 603 <p>Deprecated, replace with:</p>
 604
 605 <pre class="text">
 606       RemapImages(quantize_info,images,affinity_image);
 607 </pre>
 608
 609 <p>The format of the AffinityImage method is:</p>
 610
 611 <pre class="code">
 612   MagickBooleanType AffinityImages(const QuantizeInfo *quantize_info,
 613     Image *images,Image *affinity_image)
 614 </pre>
 615
 616 <p>A description of each parameter follows:</p>
 617
 618 <h5>quantize_info</h5>
 619 <p>Specifies a pointer to an QuantizeInfo structure.</p>
 620
 621 <h5>images</h5>
 622 <p>the image sequence.</p>
 623
 624 <h5>affinity_image</h5>
 625 <p>the reference image.</p>
 626
 627  </div>
 628 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateImage">AllocateImage</a></h2>
 629 <div class="doc-section">
 630
 631 <p>AllocateImage() returns a pointer to an image structure initialized to default values.</p>
 632
 633 <p>Deprecated, replace with:</p>
 634
 635 <pre class="text">
 636       AcquireImage(image_info);
 637 </pre>
 638
 639 <p>The format of the AllocateImage method is:</p>
 640
 641 <pre class="code">
 642   Image *AllocateImage(const ImageInfo *image_info)
 643 </pre>
 644
 645 <p>A description of each parameter follows:</p>
 646
 647 <h5>image_info</h5>
 648 <p>Many of the image default values are set from this structure.  For example, filename, compression, depth, background color, and others.</p>
 649
 650  </div>
 651 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateImageColormap">AllocateImageColormap</a></h2>
 652 <div class="doc-section">
 653
 654 <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>
 655
 656 <p>Deprecated, replace with:</p>
 657
 658 <pre class="text">
 659       AcquireImageColormap(image,colors);
 660 </pre>
 661
 662 <p>The format of the AllocateImageColormap method is:</p>
 663
 664 <pre class="code">
 665   MagickBooleanType AllocateImageColormap(Image *image,
 666     const size_t colors)
 667 </pre>
 668
 669 <p>A description of each parameter follows:</p>
 670
 671 <h5>image</h5>
 672 <p>the image.</p>
 673
 674 <h5>colors</h5>
 675 <p>the number of colors in the image colormap.</p>
 676
 677  </div>
 678 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateNextImage">AllocateNextImage</a></h2>
 679 <div class="doc-section">
 680
 681 <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>
 682
 683 <p>Deprecated, replace with:</p>
 684
 685 <pre class="text">
 686       AcquireNextImage(image_info,image);
 687 </pre>
 688
 689 <p>The format of the AllocateNextImage method is:</p>
 690
 691 <pre class="code">
 692   void AllocateNextImage(const ImageInfo *image_info,Image *image)
 693 </pre>
 694
 695 <p>A description of each parameter follows:</p>
 696
 697 <h5>image_info</h5>
 698 <p>Many of the image default values are set from this structure.  For example, filename, compression, depth, background color, and others.</p>
 699
 700 <h5>image</h5>
 701 <p>the image.</p>
 702
 703  </div>
 704 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateString">AllocateString</a></h2>
 705 <div class="doc-section">
 706
 707 <p>AllocateString() allocates memory for a string and copies the source string to that memory location (and returns it).</p>
 708
 709 <p>The format of the AllocateString method is:</p>
 710
 711 <pre class="code">
 712   char *AllocateString(const char *source)
 713 </pre>
 714
 715 <p>A description of each parameter follows:</p>
 716
 717 <h5>source</h5>
 718 <p>A character string.</p>
 719
 720  </div>
 721 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AverageImages">AverageImages</a></h2>
 722 <div class="doc-section">
 723
 724 <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>
 725
 726 <p>Deprecated, replace with:</p>
 727
 728 <pre class="text">
 729       EvaluateImages(images,MeanEvaluateOperator,exception);
 730 </pre>
 731
 732 <p>The format of the AverageImages method is:</p>
 733
 734 <pre class="code">
 735   Image *AverageImages(Image *images,ExceptionInfo *exception)
 736 </pre>
 737
 738 <p>A description of each parameter follows:</p>
 739
 740 <h5>image</h5>
 741 <p>the image sequence.</p>
 742
 743 <h5>exception</h5>
 744 <p>return any errors or warnings in this structure.</p>
 745
 746  </div>
 747 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ChannelThresholdImage">ChannelThresholdImage</a></h2>
 748 <div class="doc-section">
 749
 750 <p>ChannelThresholdImage() changes the value of individual pixels based on the intensity of each pixel channel.  The result is a high-contrast image.</p>
 751
 752 <p>The format of the ChannelThresholdImage method is:</p>
 753
 754 <pre class="code">
 755   unsigned int ChannelThresholdImage(Image *image,const char *level)
 756 </pre>
 757
 758 <p>A description of each parameter follows:</p>
 759
 760 <h5>image</h5>
 761 <p>the image.</p>
 762
 763 <h5>level</h5>
 764 <p>define the threshold values.</p>
 765
 766  </div>
 767 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ClipPathImage">ClipPathImage</a></h2>
 768 <div class="doc-section">
 769
 770 <p>ClipPathImage() sets the image clip mask based any clipping path information if it exists.</p>
 771
 772 <p>Deprecated, replace with:</p>
 773
 774 <pre class="text">
 775       ClipImagePath(image,pathname,inside);
 776 </pre>
 777
 778 <p>The format of the ClipImage method is:</p>
 779
 780 <pre class="code">
 781   MagickBooleanType ClipPathImage(Image *image,const char *pathname,
 782     const MagickBooleanType inside)
 783 </pre>
 784
 785 <p>A description of each parameter follows:</p>
 786
 787 <h5>image</h5>
 788 <p>the image.</p>
 789
 790 <h5>pathname</h5>
 791 <p>name of clipping path resource. If name is preceded by #, use clipping path numbered by name.</p>
 792
 793 <h5>inside</h5>
 794 <p>if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.</p>
 795
 796  </div>
 797 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="CloneImageAttributes">CloneImageAttributes</a></h2>
 798 <div class="doc-section">
 799
 800 <p>CloneImageAttributes() clones one or more image attributes.</p>
 801
 802 <p>Deprecated, replace with:</p>
 803
 804 <pre class="text">
 805       CloneImageProperties(image,clone_image);
 806 </pre>
 807
 808 <p>The format of the CloneImageAttributes method is:</p>
 809
 810 <pre class="code">
 811   MagickBooleanType CloneImageAttributes(Image *image,
 812     const Image *clone_image)
 813 </pre>
 814
 815 <p>A description of each parameter follows:</p>
 816
 817 <h5>image</h5>
 818 <p>the image.</p>
 819
 820 <h5>clone_image</h5>
 821 <p>the clone image.</p>
 822
 823  </div>
 824 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="CloneMemory">CloneMemory</a></h2>
 825 <div class="doc-section">
 826
 827 <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>
 828
 829 <p>The format of the CloneMemory method is:</p>
 830
 831 <pre class="code">
 832   void *CloneMemory(void *destination,const void *source,
 833     const size_t size)
 834 </pre>
 835
 836 <p>A description of each parameter follows:</p>
 837
 838 <h5>destination</h5>
 839 <p>the destination.</p>
 840
 841 <h5>source</h5>
 842 <p>the source.</p>
 843
 844 <h5>size</h5>
 845 <p>the size of the memory in bytes to allocate.</p>
 846
 847  </div>
 848 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="CloseCacheView">CloseCacheView</a></h2>
 849 <div class="doc-section">
 850
 851 <p>CloseCacheView() closes the specified view returned by a previous call to OpenCacheView().</p>
 852
 853 <p>Deprecated, replace with:</p>
 854
 855 <pre class="text">
 856       DestroyCacheView(view_info);
 857 </pre>
 858
 859 <p>The format of the CloseCacheView method is:</p>
 860
 861 <pre class="code">
 862   CacheView *CloseCacheView(CacheView *view_info)
 863 </pre>
 864
 865 <p>A description of each parameter follows:</p>
 866
 867 <h5>view_info</h5>
 868 <p>the address of a structure of type CacheView.</p>
 869
 870  </div>
 871 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ColorFloodfill">ColorFloodfill</a></h2>
 872 <div class="doc-section">
 873
 874 <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>
 875
 876 <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>
 877
 878 <p>The format of the ColorFloodfillImage method is:</p>
 879
 880 <pre class="code">
 881   MagickBooleanType ColorFloodfillImage(Image *image,
 882     const DrawInfo *draw_info,const PixelPacket target,
 883     const ssize_t x_offset,const ssize_t y_offset,const PaintMethod method)
 884 </pre>
 885
 886 <p>A description of each parameter follows:</p>
 887
 888 <h5>image</h5>
 889 <p>the image.</p>
 890
 891 <h5>draw_info</h5>
 892 <p>the draw info.</p>
 893
 894 <h5>target</h5>
 895 <p>the RGB value of the target color.</p>
 896
 897 <h5>x,y</h5>
 898 <p>the starting location of the operation.</p>
 899
 900 <h5>method</h5>
 901 <p>Choose either FloodfillMethod or FillToBorderMethod.</p>
 902
 903  </div>
 904 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DeleteImageAttribute">DeleteImageAttribute</a></h2>
 905 <div class="doc-section">
 906
 907 <p>DeleteImageAttribute() deletes an attribute from the image.</p>
 908
 909 <p>Deprecated, replace with:</p>
 910
 911 <pre class="text">
 912       DeleteImageProperty(image,key);
 913 </pre>
 914
 915 <p>The format of the DeleteImageAttribute method is:</p>
 916
 917 <pre class="code">
 918   MagickBooleanType DeleteImageAttribute(Image *image,const char *key)
 919 </pre>
 920
 921 <p>A description of each parameter follows:</p>
 922
 923 <h5>image</h5>
 924 <p>the image info.</p>
 925
 926 <h5>key</h5>
 927 <p>the image key.</p>
 928
 929  </div>
 930 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DeleteImageList">DeleteImageList</a></h2>
 931 <div class="doc-section">
 932
 933 <p>DeleteImageList() deletes an image at the specified position in the list.</p>
 934
 935 <p>The format of the DeleteImageList method is:</p>
 936
 937 <pre class="code">
 938   unsigned int DeleteImageList(Image *images,const ssize_t offset)
 939 </pre>
 940
 941 <p>A description of each parameter follows:</p>
 942
 943 <h5>images</h5>
 944 <p>the image list.</p>
 945
 946 <h5>offset</h5>
 947 <p>the position within the list.</p>
 948
 949  </div>
 950 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DeleteMagickRegistry">DeleteMagickRegistry</a></h2>
 951 <div class="doc-section">
 952
 953 <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>
 954
 955 <p>Deprecated, replace with:</p>
 956
 957 <pre class="text">
 958       char key[MaxTextExtent];
 959       FormatLocaleString(key,MaxTextExtent,"ld\n",id);
 960       DeleteImageRegistry(key);
 961 </pre>
 962
 963 <p>The format of the DeleteMagickRegistry method is:</p>
 964
 965 <pre class="code">
 966   MagickBooleanType DeleteMagickRegistry(const ssize_t id)
 967 </pre>
 968
 969 <p>A description of each parameter follows:</p>
 970
 971 <h5>id</h5>
 972 <p>the registry id.</p>
 973
 974  </div>
 975 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DescribeImage">DescribeImage</a></h2>
 976 <div class="doc-section">
 977
 978 <p>DescribeImage() describes an image by printing its attributes to the file. Attributes include the image width, height, size, and others.</p>
 979
 980 <p>Deprecated, replace with:</p>
 981
 982 <pre class="text">
 983       IdentifyImage(image,file,verbose);
 984 </pre>
 985
 986 <p>The format of the DescribeImage method is:</p>
 987
 988 <pre class="code">
 989   MagickBooleanType DescribeImage(Image *image,FILE *file,
 990     const MagickBooleanType verbose)
 991 </pre>
 992
 993 <p>A description of each parameter follows:</p>
 994
 995 <h5>image</h5>
 996 <p>the image.</p>
 997
 998 <h5>file</h5>
 999 <p>the file, typically stdout.</p>
1000
1001 <h5>verbose</h5>
1002 <p>A value other than zero prints more detailed information about the image.</p>
1003
1004  </div>
1005 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyImageAttributes">DestroyImageAttributes</a></h2>
1006 <div class="doc-section">
1007
1008 <p>DestroyImageAttributes() deallocates memory associated with the image attribute list.</p>
1009
1010 <p>The format of the DestroyImageAttributes method is:</p>
1011
1012 <pre class="code">
1013   DestroyImageAttributes(Image *image)
1014 </pre>
1015
1016 <p>A description of each parameter follows:</p>
1017
1018 <h5>image</h5>
1019 <p>the image.</p>
1020
1021  </div>
1022 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyImages">DestroyImages</a></h2>
1023 <div class="doc-section">
1024
1025 <p>DestroyImages() destroys an image list.</p>
1026
1027 <p>Deprecated, replace with:</p>
1028
1029 <pre class="text">
1030       DestroyImageList(image);
1031 </pre>
1032
1033 <p>The format of the DestroyImages method is:</p>
1034
1035 <pre class="code">
1036   void DestroyImages(Image *image)
1037 </pre>
1038
1039 <p>A description of each parameter follows:</p>
1040
1041 <h5>image</h5>
1042 <p>the image sequence.</p>
1043
1044  </div>
1045 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyMagick">DestroyMagick</a></h2>
1046 <div class="doc-section">
1047
1048 <p>DestroyMagick() destroys the ImageMagick environment.</p>
1049
1050 <p>Deprecated, replace with:</p>
1051
1052 <pre class="text">
1053       MagickCoreTerminus();
1054 </pre>
1055
1056 <p>The format of the DestroyMagick function is:</p>
1057
1058 <pre class="text">
1059   DestroyMagick(void)
1060 </pre>
1061
1062  </div>
1063 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DispatchImage">DispatchImage</a></h2>
1064 <div class="doc-section">
1065
1066 <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, ssize_t, float, or double in the order specified by map.</p>
1067
1068 <p>Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:</p>
1069
1070 <pre class="text">
1071   DispatchImage(image,0,0,640,1,"RGB",CharPixel,pixels,exception);
1072 </pre>
1073
1074 <p>Deprecated, replace with:</p>
1075
1076 <pre class="text">
1077       ExportImagePixels(image,x_offset,y_offset,columns,rows,map,type,pixels,
1078   exception);
1079 </pre>
1080
1081 <p>The format of the DispatchImage method is:</p>
1082
1083 <pre class="code">
1084   unsigned int DispatchImage(const Image *image,const ssize_t x_offset,
1085     const ssize_t y_offset,const size_t columns,
1086     const size_t rows,const char *map,const StorageType type,
1087     void *pixels,ExceptionInfo *exception)
1088 </pre>
1089
1090 <p>A description of each parameter follows:</p>
1091
1092 <h5>image</h5>
1093 <p>the image.</p>
1094
1095 <h5>x_offset, y_offset, columns, rows</h5>
1096 <p>These values define the perimeter of a region of pixels you want to extract.</p>
1097
1098 <h5>map</h5>
1099 <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>
1100
1101 <h5>type</h5>
1102 <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>
1103
1104 <h5>pixels</h5>
1105 <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>
1106
1107 <h5>exception</h5>
1108 <p>return any errors or warnings in this structure.</p>
1109
1110  </div>
1111 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a></h2>
1112 <div class="doc-section">
1113
1114 <p>ExtractSubimageFromImageImage() extracts a region of the image that most closely resembles the reference.</p>
1115
1116 <p>The format of the ExtractSubimageFromImageImage method is:</p>
1117
1118 <pre class="code">
1119   Image *ExtractSubimageFromImage(const Image *image,
1120     const Image *reference,ExceptionInfo *exception)
1121 </pre>
1122
1123 <p>A description of each parameter follows:</p>
1124
1125 <h5>image</h5>
1126 <p>the image.</p>
1127
1128 <h5>reference</h5>
1129 <p>find an area of the image that closely resembles this image.</p>
1130
1131 <h5>exception</h5>
1132 <p>return any errors or warnings in this structure.</p>
1133
1134  </div>
1135 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FlattenImages">FlattenImages</a></h2>
1136 <div class="doc-section">
1137
1138 <p>FlattenImages() Obsolete Function: Use MergeImageLayers() instead.</p>
1139
1140 <p>Deprecated, replace with:</p>
1141
1142 <pre class="text">
1143       MergeImageLayers(image,FlattenLayer,exception);
1144 </pre>
1145
1146 <p>The format of the FlattenImage method is:</p>
1147
1148 <pre class="code">
1149   Image *FlattenImage(Image *image,ExceptionInfo *exception)
1150 </pre>
1151
1152 <p>A description of each parameter follows:</p>
1153
1154 <h5>image</h5>
1155 <p>the image sequence.</p>
1156
1157 <h5>exception</h5>
1158 <p>return any errors or warnings in this structure.</p>
1159
1160  </div>
1161 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FormatImageAttribute">FormatImageAttribute</a></h2>
1162 <div class="doc-section">
1163
1164 <p>FormatImageAttribute() permits formatted key/value pairs to be saved as an image attribute.</p>
1165
1166 <p>The format of the FormatImageAttribute method is:</p>
1167
1168 <pre class="code">
1169   MagickBooleanType FormatImageAttribute(Image *image,const char *key,
1170     const char *format,...)
1171 </pre>
1172
1173 <p>A description of each parameter follows.</p>
1174
1175 <h5> image</h5>
1176 <p>The image.</p>
1177
1178 <h5> key</h5>
1179 <p>The attribute key.</p>
1180
1181 <h5> format</h5>
1182 <p>A string describing the format to use to write the remaining arguments.</p>
1183
1184  </div>
1185 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FormatMagickString">FormatMagickString</a></h2>
1186 <div class="doc-section">
1187
1188 <p>FormatMagickString() prints formatted output of a variable argument list.</p>
1189
1190 <p>The format of the FormatMagickString method is:</p>
1191
1192 <pre class="code">
1193   ssize_t FormatMagickString(char *string,const size_t length,
1194     const char *format,...)
1195 </pre>
1196
1197 <p>A description of each parameter follows.</p>
1198
1199 <h5>string</h5>
1200 <p>FormatMagickString() returns the formatted string in this character buffer.</p>
1201
1202 <h5>length</h5>
1203 <p>the maximum length of the string.</p>
1204
1205 <h5>format</h5>
1206 <p>A string describing the format to use to write the remaining arguments.</p>
1207
1208  </div>
1209 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FormatString">FormatString</a></h2>
1210 <div class="doc-section">
1211
1212 <p>FormatString() prints formatted output of a variable argument list.</p>
1213
1214 <p>The format of the FormatString method is:</p>
1215
1216 <pre class="code">
1217   void FormatString(char *string,const char *format,...)
1218 </pre>
1219
1220 <p>A description of each parameter follows.</p>
1221
1222 <h5> string</h5>
1223 <p>Method FormatString returns the formatted string in this character buffer.</p>
1224
1225 <h5> format</h5>
1226 <p>A string describing the format to use to write the remaining arguments.</p>
1227
1228  </div>
1229 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetConfigureBlob">GetConfigureBlob</a></h2>
1230 <div class="doc-section">
1231
1232 <p>GetConfigureBlob() returns the specified configure file as a blob.</p>
1233
1234 <p>The format of the GetConfigureBlob method is:</p>
1235
1236 <pre class="code">
1237   void *GetConfigureBlob(const char *filename,ExceptionInfo *exception)
1238 </pre>
1239
1240 <p>A description of each parameter follows:</p>
1241
1242 <h5>filename</h5>
1243 <p>the configure file name.</p>
1244
1245 <h5>path</h5>
1246 <p>return the full path information of the configure file.</p>
1247
1248 <h5>length</h5>
1249 <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>
1250
1251 <h5>exception</h5>
1252 <p>return any errors or warnings in this structure.</p>
1253
1254  </div>
1255 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetCacheView">GetCacheView</a></h2>
1256 <div class="doc-section">
1257
1258 <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>
1259
1260 <p>Deprecated, replace with:</p>
1261
1262 <pre class="text">
1263       GetCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
1264   GetCacheViewException(cache_view));
1265 </pre>
1266
1267 <p>The format of the GetCacheView method is:</p>
1268
1269 <pre class="code">
1270   PixelPacket *GetCacheView(CacheView *cache_view,const ssize_t x,
1271     const ssize_t y,const size_t columns,const size_t rows)
1272 </pre>
1273
1274 <p>A description of each parameter follows:</p>
1275
1276 <h5>cache_view</h5>
1277 <p>the address of a structure of type CacheView.</p>
1278
1279 <h5>x,y,columns,rows</h5>
1280 <p>These values define the perimeter of a region of pixels.</p>
1281
1282  </div>
1283 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetCacheViewIndexes">GetCacheViewIndexes</a></h2>
1284 <div class="doc-section">
1285
1286 <p>GetCacheViewIndexes() returns the indexes associated with the specified view.</p>
1287
1288 <p>Deprecated, replace with:</p>
1289
1290 <pre class="text">
1291       GetCacheViewAuthenticIndexQueue(cache_view);
1292 </pre>
1293
1294 <p>The format of the GetCacheViewIndexes method is:</p>
1295
1296 <pre class="code">
1297   IndexPacket *GetCacheViewIndexes(CacheView *cache_view)
1298 </pre>
1299
1300 <p>A description of each parameter follows:</p>
1301
1302 <h5>cache_view</h5>
1303 <p>the cache view.</p>
1304
1305  </div>
1306 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetCacheViewPixels">GetCacheViewPixels</a></h2>
1307 <div class="doc-section">
1308
1309 <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>
1310
1311 <p>Deprecated, replace with:</p>
1312
1313 <pre class="text">
1314       GetCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
1315   GetCacheViewException(cache_view));
1316 </pre>
1317
1318 <p>The format of the GetCacheViewPixels method is:</p>
1319
1320 <pre class="code">
1321   PixelPacket *GetCacheViewPixels(CacheView *cache_view,const ssize_t x,
1322     const ssize_t y,const size_t columns,const size_t rows)
1323 </pre>
1324
1325 <p>A description of each parameter follows:</p>
1326
1327 <h5>cache_view</h5>
1328 <p>the cache view.</p>
1329
1330 <h5>x,y,columns,rows</h5>
1331 <p>These values define the perimeter of a region of pixels.</p>
1332
1333  </div>
1334 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageAttribute">GetImageAttribute</a></h2>
1335 <div class="doc-section">
1336
1337 <p>GetImageAttribute() searches the list of image attributes and returns a pointer to the attribute if it exists otherwise NULL.</p>
1338
1339 <p>The format of the GetImageAttribute method is:</p>
1340
1341 <pre class="code">
1342   const ImageAttribute *GetImageAttribute(const Image *image,
1343     const char *key)
1344 </pre>
1345
1346 <p>A description of each parameter follows:</p>
1347
1348 <h5>image</h5>
1349 <p>the image.</p>
1350
1351 <h5>key</h5>
1352 <p>These character strings are the name of an image attribute to return.</p>
1353
1354  </div>
1355 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageClippingPathAttribute">GetImageClippingPathAttribute</a></h2>
1356 <div class="doc-section">
1357
1358 <p>GetImageClippingPathAttribute() searches the list of image attributes and returns a pointer to a clipping path if it exists otherwise NULL.</p>
1359
1360 <p>Deprecated, replace with:</p>
1361
1362 <pre class="text">
1363       GetImageAttribute(image,"8BIM:1999,2998");
1364 </pre>
1365
1366 <p>The format of the GetImageClippingPathAttribute method is:</p>
1367
1368 <pre class="code">
1369   const ImageAttribute *GetImageClippingPathAttribute(Image *image)
1370 </pre>
1371
1372 <p>A description of each parameter follows:</p>
1373
1374 <h5>attribute</h5>
1375 <p>Method GetImageClippingPathAttribute returns the clipping path if it exists otherwise NULL.</p>
1376
1377 <h5>image</h5>
1378 <p>the image.</p>
1379
1380  </div>
1381 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageFromMagickRegistry">GetImageFromMagickRegistry</a></h2>
1382 <div class="doc-section">
1383
1384 <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>
1385
1386 <p>Deprecated, replace with:</p>
1387
1388 <pre class="text">
1389       GetImageRegistry(ImageRegistryType,name,exception);
1390 </pre>
1391
1392 <p>The format of the GetImageFromMagickRegistry method is:</p>
1393
1394 <pre class="code">
1395   Image *GetImageFromMagickRegistry(const char *name,ssize_t *id,
1396     ExceptionInfo *exception)
1397 </pre>
1398
1399 <p>A description of each parameter follows:</p>
1400
1401 <h5>name</h5>
1402 <p>the name of the image to retrieve from the registry.</p>
1403
1404 <h5>id</h5>
1405 <p>the registry id.</p>
1406
1407 <h5>exception</h5>
1408 <p>return any errors or warnings in this structure.</p>
1409
1410  </div>
1411 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetMagickRegistry">GetMagickRegistry</a></h2>
1412 <div class="doc-section">
1413
1414 <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>
1415
1416 <p>The format of the GetMagickRegistry method is:</p>
1417
1418 <pre class="code">
1419   const void *GetMagickRegistry(const ssize_t id,RegistryType *type,
1420     size_t *length,ExceptionInfo *exception)
1421 </pre>
1422
1423 <p>A description of each parameter follows:</p>
1424
1425 <h5>id</h5>
1426 <p>the registry id.</p>
1427
1428 <h5>type</h5>
1429 <p>the registry type.</p>
1430
1431 <h5>length</h5>
1432 <p>the blob length in number of bytes.</p>
1433
1434 <h5>exception</h5>
1435 <p>return any errors or warnings in this structure.</p>
1436
1437  </div>
1438 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageGeometry">GetImageGeometry</a></h2>
1439 <div class="doc-section">
1440
1441 <p>GetImageGeometry() returns a region as defined by the geometry string with respect to the image and its gravity.</p>
1442
1443 <p>Deprecated, replace with:</p>
1444
1445 <pre class="text">
1446       if (size_to_fit != MagickFalse)
1447   ParseRegionGeometry(image,geometry,region_info,&image->exception); else
1448   ParsePageGeometry(image,geometry,region_info,&image->exception);
1449 </pre>
1450
1451 <p>The format of the GetImageGeometry method is:</p>
1452
1453 <pre class="code">
1454   int GetImageGeometry(Image *image,const char *geometry,
1455     const unsigned int size_to_fit,RectangeInfo *region_info)
1456 </pre>
1457
1458 <p>A description of each parameter follows:</p>
1459
1460 <h5>flags</h5>
1461 <p>Method GetImageGeometry returns a bitmask that indicates which of the four values were located in the geometry string.</p>
1462
1463 <h5>geometry</h5>
1464 <p>The geometry (e.g. 100x100+10+10).</p>
1465
1466 <h5>size_to_fit</h5>
1467 <p>A value other than 0 means to scale the region so it fits within the specified width and height.</p>
1468
1469 <h5>region_info</h5>
1470 <p>the region as defined by the geometry string with respect to the image and its gravity.</p>
1471
1472  </div>
1473 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageList">GetImageList</a></h2>
1474 <div class="doc-section">
1475
1476 <p>GetImageList() returns an image at the specified position in the list.</p>
1477
1478 <p>Deprecated, replace with:</p>
1479
1480 <pre class="text">
1481       CloneImage(GetImageFromList(images,(ssize_t) offset),0,0,MagickTrue,
1482   exception);
1483 </pre>
1484
1485 <p>The format of the GetImageList method is:</p>
1486
1487 <pre class="code">
1488   Image *GetImageList(const Image *images,const ssize_t offset,
1489     ExceptionInfo *exception)
1490 </pre>
1491
1492 <p>A description of each parameter follows:</p>
1493
1494 <h5>images</h5>
1495 <p>the image list.</p>
1496
1497 <h5>offset</h5>
1498 <p>the position within the list.</p>
1499
1500 <h5>exception</h5>
1501 <p>return any errors or warnings in this structure.</p>
1502
1503  </div>
1504 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageListIndex">GetImageListIndex</a></h2>
1505 <div class="doc-section">
1506
1507 <p>GetImageListIndex() returns the position in the list of the specified image.</p>
1508
1509 <p>Deprecated, replace with:</p>
1510
1511 <pre class="text">
1512       GetImageIndexInList(images);
1513 </pre>
1514
1515 <p>The format of the GetImageListIndex method is:</p>
1516
1517 <pre class="code">
1518   ssize_t GetImageListIndex(const Image *images)
1519 </pre>
1520
1521 <p>A description of each parameter follows:</p>
1522
1523 <h5>images</h5>
1524 <p>the image list.</p>
1525
1526  </div>
1527 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageListSize">GetImageListSize</a></h2>
1528 <div class="doc-section">
1529
1530 <p>GetImageListSize() returns the number of images in the list.</p>
1531
1532 <p>Deprecated, replace with:</p>
1533
1534 <pre class="text">
1535       GetImageListLength(images);
1536 </pre>
1537
1538 <p>The format of the GetImageListSize method is:</p>
1539
1540 <pre class="code">
1541   size_t GetImageListSize(const Image *images)
1542 </pre>
1543
1544 <p>A description of each parameter follows:</p>
1545
1546 <h5>images</h5>
1547 <p>the image list.</p>
1548
1549  </div>
1550 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImagePixels">GetImagePixels</a></h2>
1551 <div class="doc-section">
1552
1553 <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>
1554
1555 <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>
1556
1557 <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>
1558
1559 <p>Deprecated, replace with:</p>
1560
1561 <pre class="text">
1562       GetAuthenticPixels(image,x,y,columns,rows,&image->exception);
1563 </pre>
1564
1565 <p>The format of the GetImagePixels() method is:</p>
1566
1567 <pre class="code">
1568   PixelPacket *GetImagePixels(Image *image,const ssize_t x,const ssize_t y,
1569     const size_t columns,const size_t rows)
1570 </pre>
1571
1572 <p>A description of each parameter follows:</p>
1573
1574 <h5>image</h5>
1575 <p>the image.</p>
1576
1577 <h5>x,y,columns,rows</h5>
1578 <p>These values define the perimeter of a region of pixels.</p>
1579
1580  </div>
1581 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetIndexes">GetIndexes</a></h2>
1582 <div class="doc-section">
1583
1584 <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>
1585
1586 <p>Deprecated, replace with:</p>
1587
1588 <pre class="text">
1589       GetAuthenticIndexQueue(image);
1590 </pre>
1591
1592 <p>The format of the GetIndexes() method is:</p>
1593
1594 <pre class="code">
1595   IndexPacket *GetIndexes(const Image *image)
1596 </pre>
1597
1598 <p>A description of each parameter follows:</p>
1599
1600 <h5>indexes</h5>
1601 <p>GetIndexes() returns the indexes associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p>
1602
1603 <h5>image</h5>
1604 <p>the image.</p>
1605
1606  </div>
1607 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetNextImage">GetNextImage</a></h2>
1608 <div class="doc-section">
1609
1610 <p>GetNextImage() returns the next image in a list.</p>
1611
1612 <p>Deprecated, replace with:</p>
1613
1614 <pre class="text">
1615       GetNextImageInList(images);
1616 </pre>
1617
1618 <p>The format of the GetNextImage method is:</p>
1619
1620 <pre class="code">
1621   Image *GetNextImage(const Image *images)
1622 </pre>
1623
1624 <p>A description of each parameter follows:</p>
1625
1626 <h5>images</h5>
1627 <p>the image list.</p>
1628
1629  </div>
1630 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetNextImageAttribute">GetNextImageAttribute</a></h2>
1631 <div class="doc-section">
1632
1633 <p>GetNextImageAttribute() gets the next image attribute.</p>
1634
1635 <p>Deprecated, replace with:</p>
1636
1637 <pre class="text">
1638       const char *property;
1639       property=GetNextImageProperty(image);
1640       if (property != (const char *) NULL)
1641   GetImageAttribute(image,property);
1642 </pre>
1643
1644 <p>The format of the GetNextImageAttribute method is:</p>
1645
1646 <pre class="code">
1647   const ImageAttribute *GetNextImageAttribute(const Image *image)
1648 </pre>
1649
1650 <p>A description of each parameter follows:</p>
1651
1652 <h5>image</h5>
1653 <p>the image.</p>
1654
1655  </div>
1656 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetNumberScenes">GetNumberScenes</a></h2>
1657 <div class="doc-section">
1658
1659 <p>GetNumberScenes() returns the number of images in the list.</p>
1660
1661 <p>Deprecated, replace with:</p>
1662
1663 <pre class="text">
1664       GetImageListLength(image);
1665 </pre>
1666
1667 <p>The format of the GetNumberScenes method is:</p>
1668
1669 <pre class="code">
1670   unsigned int GetNumberScenes(const Image *images)
1671 </pre>
1672
1673 <p>A description of each parameter follows:</p>
1674
1675 <h5>images</h5>
1676 <p>the image list.</p>
1677
1678  </div>
1679 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetOnePixel">GetOnePixel</a></h2>
1680 <div class="doc-section">
1681
1682 <p>GetOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs.</p>
1683
1684 <p>Deprecated, replace with:</p>
1685
1686 <pre class="text">
1687       GetOneAuthenticPixel(image,x,y,&pixel,&image->exception);
1688 </pre>
1689
1690 <p>The format of the GetOnePixel() method is:</p>
1691
1692 <pre class="code">
1693   PixelPacket GetOnePixel(const Image image,const ssize_t x,const ssize_t y)
1694 </pre>
1695
1696 <p>A description of each parameter follows:</p>
1697
1698 <h5>image</h5>
1699 <p>the image.</p>
1700
1701 <h5>x,y</h5>
1702 <p>These values define the location of the pixel to return.</p>
1703
1704  </div>
1705 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixels">GetPixels</a></h2>
1706 <div class="doc-section">
1707
1708 <p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p>
1709
1710 <p>Deprecated, replace with:</p>
1711
1712 <pre class="text">
1713       GetAuthenticPixelQueue(image);
1714 </pre>
1715
1716 <p>The format of the GetPixels() method is:</p>
1717
1718 <pre class="code">
1719   PixelPacket *GetPixels(const Image image)
1720 </pre>
1721
1722 <p>A description of each parameter follows:</p>
1723
1724 <h5>pixels</h5>
1725 <p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p>
1726
1727 <h5>image</h5>
1728 <p>the image.</p>
1729
1730  </div>
1731 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPreviousImage">GetPreviousImage</a></h2>
1732 <div class="doc-section">
1733
1734 <p>GetPreviousImage() returns the previous image in a list.</p>
1735
1736 <p>Deprecated, replace with:</p>
1737
1738 <pre class="text">
1739       GetPreviousImageInList(images));
1740 </pre>
1741
1742 <p>The format of the GetPreviousImage method is:</p>
1743
1744 <pre class="code">
1745   Image *GetPreviousImage(const Image *images)
1746 </pre>
1747
1748 <p>A description of each parameter follows:</p>
1749
1750 <h5>images</h5>
1751 <p>the image list.</p>
1752
1753  </div>
1754 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="HSLTransform">HSLTransform</a></h2>
1755 <div class="doc-section">
1756
1757 <p>HSLTransform() converts a (hue, saturation, lightness) to a (red, green, blue) triple.</p>
1758
1759 <p>The format of the HSLTransformImage method is:</p>
1760
1761 <pre class="code">
1762   void HSLTransform(const double hue,const double saturation,
1763     const double lightness,Quantum *red,Quantum *green,Quantum *blue)
1764 </pre>
1765
1766 <p>A description of each parameter follows:</p>
1767
1768 <h5>hue, saturation, lightness</h5>
1769 <p>A double value representing a component of the HSL color space.</p>
1770
1771 <h5>red, green, blue</h5>
1772 <p>A pointer to a pixel component of type Quantum.</p>
1773
1774  </div>
1775 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="IdentityAffine">IdentityAffine</a></h2>
1776 <div class="doc-section">
1777
1778 <p>IdentityAffine() initializes the affine transform to the identity matrix.</p>
1779
1780 <p>The format of the IdentityAffine method is:</p>
1781
1782 <pre class="code">
1783   IdentityAffine(AffineMatrix *affine)
1784 </pre>
1785
1786 <p>A description of each parameter follows:</p>
1787
1788 <h5>affine</h5>
1789 <p>A pointer the affine transform of type AffineMatrix.</p>
1790
1791  </div>
1792 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="InitializeMagick">InitializeMagick</a></h2>
1793 <div class="doc-section">
1794
1795 <p>InitializeMagick() initializes the ImageMagick environment.</p>
1796
1797 <p>Deprecated, replace with:</p>
1798
1799 <pre class="text">
1800       MagickCoreGenesis(path,MagickFalse);
1801 </pre>
1802
1803 <p>The format of the InitializeMagick function is:</p>
1804
1805 <pre class="text">
1806   InitializeMagick(const char *path)
1807 </pre>
1808
1809 <p>A description of each parameter follows:</p>
1810
1811 <h5>path</h5>
1812 <p>the execution path of the current ImageMagick client.</p>
1813
1814  </div>
1815 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="InterpolatePixelColor">InterpolatePixelColor</a></h2>
1816 <div class="doc-section">
1817
1818 <p>InterpolatePixelColor() applies bi-linear or tri-linear interpolation between a pixel and it's neighbors.</p>
1819
1820 <p>The format of the InterpolatePixelColor method is:</p>
1821
1822 <pre class="code">
1823   MagickPixelPacket InterpolatePixelColor(const Image *image,
1824     CacheView *view_info,InterpolatePixelMethod method,const double x,
1825     const double y,ExceptionInfo *exception)
1826 </pre>
1827
1828 <p>A description of each parameter follows:</p>
1829
1830 <h5>image</h5>
1831 <p>the image.</p>
1832
1833 <h5>image_view</h5>
1834 <p>the image cache view.</p>
1835
1836 <h5>type</h5>
1837 <p>the type of pixel color interpolation.</p>
1838
1839 <h5>x,y</h5>
1840 <p>A double representing the current (x,y) position of the pixel.</p>
1841
1842 <h5>exception</h5>
1843 <p>return any errors or warnings in this structure.</p>
1844
1845  </div>
1846 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="InterpretImageAttributes">InterpretImageAttributes</a></h2>
1847 <div class="doc-section">
1848
1849 <p>InterpretImageAttributes() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p>
1850
1851 <p>Deprecated, replace with:</p>
1852
1853 <pre class="text">
1854       InterpretImageProperties(image_info,image,embed_text);
1855 </pre>
1856
1857 <p>The format of the InterpretImageAttributes method is:</p>
1858
1859 <pre class="code">
1860   char *InterpretImageAttributes(const ImageInfo *image_info,Image *image,
1861     const char *embed_text)
1862 </pre>
1863
1864 <p>A description of each parameter follows:</p>
1865
1866 <h5>image_info</h5>
1867 <p>the image info.</p>
1868
1869 <h5>image</h5>
1870 <p>the image.</p>
1871
1872 <h5>embed_text</h5>
1873 <p>the address of a character string containing the embedded formatting characters.</p>
1874
1875  </div>
1876 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="LevelImageColor">LevelImageColor</a></h2>
1877 <div class="doc-section">
1878
1879 <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 separately.</p>
1880
1881 <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>
1882
1883 <p>Deprecated, replace with:</p>
1884
1885 <pre class="text">
1886       LevelColorsImageChannel(image,channel,black_color,white_color,invert);
1887 </pre>
1888
1889 <p>The format of the LevelImageColors method is:</p>
1890
1891 <pre class="code">
1892     MagickBooleanType LevelImageColors(Image *image,const ChannelType channel,
1893       const MagickPixelPacket *black_color,const MagickPixelPacket *white_color,
1894       const MagickBooleanType invert)
1895 </pre>
1896
1897 <p>A description of each parameter follows:</p>
1898
1899 <h5>image</h5>
1900 <p>the image.</p>
1901
1902 <h5>channel</h5>
1903 <p>the channel.</p>
1904
1905 <h5>black_color</h5>
1906 <p>The color to map black to/from</p>
1907
1908 <h5>white_point</h5>
1909 <p>The color to map white to/from</p>
1910
1911 <h5>invert</h5>
1912 <p>if true map the colors (levelize), rather than from (level)</p>
1913
1914  </div>
1915 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="LiberateMemory">LiberateMemory</a></h2>
1916 <div class="doc-section">
1917
1918 <p>LiberateMemory() frees memory that has already been allocated, and NULL's the pointer to it.</p>
1919
1920 <p>The format of the LiberateMemory method is:</p>
1921
1922 <pre class="code">
1923   void LiberateMemory(void **memory)
1924 </pre>
1925
1926 <p>A description of each parameter follows:</p>
1927
1928 <h5>memory</h5>
1929 <p>A pointer to a block of memory to free for reuse.</p>
1930
1931  </div>
1932 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="LiberateSemaphoreInfo">LiberateSemaphoreInfo</a></h2>
1933 <div class="doc-section">
1934
1935 <p>LiberateSemaphoreInfo() relinquishes a semaphore.</p>
1936
1937 <p>Deprecated, replace with:</p>
1938
1939 <pre class="text">
1940       UnlockSemaphoreInfo(*semaphore_info);
1941 </pre>
1942
1943 <p>The format of the LiberateSemaphoreInfo method is:</p>
1944
1945 <pre class="code">
1946   LiberateSemaphoreInfo(void **semaphore_info)
1947 </pre>
1948
1949 <p>A description of each parameter follows:</p>
1950
1951 <h5>semaphore_info</h5>
1952 <p>Specifies a pointer to an SemaphoreInfo structure.</p>
1953
1954  </div>
1955 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickIncarnate">MagickIncarnate</a></h2>
1956 <div class="doc-section">
1957
1958 <p>MagickIncarnate() initializes the ImageMagick environment.</p>
1959
1960 <p>Deprecated, replace with:</p>
1961
1962 <pre class="text">
1963       MagickCoreGenesis(path,MagickFalse);
1964 </pre>
1965
1966 <p>The format of the MagickIncarnate function is:</p>
1967
1968 <pre class="text">
1969   MagickIncarnate(const char *path)
1970 </pre>
1971
1972 <p>A description of each parameter follows:</p>
1973
1974 <h5>path</h5>
1975 <p>the execution path of the current ImageMagick client.</p>
1976
1977  </div>
1978 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMonitor">MagickMonitor</a></h2>
1979 <div class="doc-section">
1980
1981 <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>
1982
1983 <p>The format of the MagickMonitor method is:</p>
1984
1985 <pre class="code">
1986   MagickBooleanType MagickMonitor(const char *text,
1987     const MagickOffsetType offset,const MagickSizeType span,
1988     void *client_data)
1989 </pre>
1990
1991 <p>A description of each parameter follows:</p>
1992
1993 <h5>offset</h5>
1994 <p>the position relative to the span parameter which represents how much progress has been made toward completing a task.</p>
1995
1996 <h5>span</h5>
1997 <p>the span relative to completing a task.</p>
1998
1999 <h5>client_data</h5>
2000 <p>the client data.</p>
2001
2002  </div>
2003 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MapImage">MapImage</a></h2>
2004 <div class="doc-section">
2005
2006 <p>MapImage() replaces the colors of an image with the closest color from a reference image.</p>
2007
2008 <p>Deprecated, replace with:</p>
2009
2010 <pre class="text">
2011        QuantizeInfo quantize_info;
2012        GetQuantizeInfo(&quantize_info);
2013        quantize_info.dither=dither;
2014        RemapImage(&quantize_info,image,map_image);
2015 </pre>
2016
2017 <p>The format of the MapImage method is:</p>
2018
2019 <pre class="code">
2020   MagickBooleanType MapImage(Image *image,const Image *map_image,
2021     const MagickBooleanType dither)
2022 </pre>
2023
2024 <p>A description of each parameter follows:</p>
2025
2026 <h5>image</h5>
2027 <p>Specifies a pointer to an Image structure.</p>
2028
2029 <h5>map_image</h5>
2030 <p>the image.  Reduce image to a set of colors represented by this image.</p>
2031
2032 <h5>dither</h5>
2033 <p>Set this integer value to something other than zero to dither the mapped image.</p>
2034
2035  </div>
2036 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MapImages">MapImages</a></h2>
2037 <div class="doc-section">
2038
2039 <p>MapImages() replaces the colors of a sequence of images with the closest color from a reference image.</p>
2040
2041 <p>Deprecated, replace with:</p>
2042
2043 <pre class="text">
2044        QuantizeInfo quantize_info;
2045        GetQuantizeInfo(&quantize_info);
2046        quantize_info.dither=dither;
2047        RemapImages(&quantize_info,images,map_image);
2048 </pre>
2049
2050 <p>The format of the MapImage method is:</p>
2051
2052 <pre class="code">
2053   MagickBooleanType MapImages(Image *images,Image *map_image,
2054     const MagickBooleanType dither)
2055 </pre>
2056
2057 <p>A description of each parameter follows:</p>
2058
2059 <h5>image</h5>
2060 <p>Specifies a pointer to a set of Image structures.</p>
2061
2062 <h5>map_image</h5>
2063 <p>the image.  Reduce image to a set of colors represented by this image.</p>
2064
2065 <h5>dither</h5>
2066 <p>Set this integer value to something other than zero to dither the quantized image.</p>
2067
2068  </div>
2069 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MatteFloodfill">MatteFloodfill</a></h2>
2070 <div class="doc-section">
2071
2072 <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>
2073
2074 <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>
2075
2076 <p>The format of the MatteFloodfillImage method is:</p>
2077
2078 <pre class="code">
2079   MagickBooleanType MatteFloodfillImage(Image *image,
2080     const PixelPacket target,const Quantum opacity,const ssize_t x_offset,
2081     const ssize_t y_offset,const PaintMethod method)
2082 </pre>
2083
2084 <p>A description of each parameter follows:</p>
2085
2086 <h5>image</h5>
2087 <p>the image.</p>
2088
2089 <h5>target</h5>
2090 <p>the RGB value of the target color.</p>
2091
2092 <h5>opacity</h5>
2093 <p>the level of transparency: 0 is fully opaque and QuantumRange is fully transparent.</p>
2094
2095 <h5>x,y</h5>
2096 <p>the starting location of the operation.</p>
2097
2098 <h5>method</h5>
2099 <p>Choose either FloodfillMethod or FillToBorderMethod.</p>
2100
2101  </div>
2102 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MaximumImages">MaximumImages</a></h2>
2103 <div class="doc-section">
2104
2105 <p>MaximumImages() returns the maximum intensity of an image sequence.</p>
2106
2107 <p>Deprecated, replace with:</p>
2108
2109 <pre class="text">
2110       EvaluateImages(images,MinEvaluateOperator,exception);
2111 </pre>
2112
2113 <p>The format of the MaxImages method is:</p>
2114
2115 <pre class="code">
2116   Image *MaximumImages(Image *images,ExceptionInfo *exception)
2117 </pre>
2118
2119 <p>A description of each parameter follows:</p>
2120
2121 <h5>images</h5>
2122 <p>the image sequence.</p>
2123
2124 <h5>exception</h5>
2125 <p>return any errors or warnings in this structure.</p>
2126
2127  </div>
2128 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MinimumImages">MinimumImages</a></h2>
2129 <div class="doc-section">
2130
2131 <p>MinimumImages() returns the minimum intensity of an image sequence.</p>
2132
2133 <p>Deprecated, replace with:</p>
2134
2135 <pre class="text">
2136       EvaluateImages(images,MinEvaluateOperator,exception);
2137 </pre>
2138
2139 <p>The format of the MinimumImages method is:</p>
2140
2141 <pre class="code">
2142   Image *MinimumImages(Image *images,ExceptionInfo *exception)
2143 </pre>
2144
2145 <p>A description of each parameter follows:</p>
2146
2147 <h5>images</h5>
2148 <p>the image sequence.</p>
2149
2150 <h5>exception</h5>
2151 <p>return any errors or warnings in this structure.</p>
2152
2153  </div>
2154 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MedianFilterImage">MedianFilterImage</a></h2>
2155 <div class="doc-section">
2156
2157 <p>MedianFilterImage() applies a digital filter that improves the quality of a noisy image.  Each pixel is replaced by the median in a set of neighboring pixels as defined by radius.</p>
2158
2159 <p>The algorithm was contributed by Mike Edmonds and implements an insertion sort for selecting median color-channel values.  For more on this algorithm see "Skip Lists: A probabilistic Alternative to Balanced Trees" by William Pugh in the June 1990 of Communications of the ACM.</p>
2160
2161 <p>The format of the MedianFilterImage method is:</p>
2162
2163 <pre class="code">
2164   Image *MedianFilterImage(const Image *image,const double radius,
2165     ExceptionInfo *exception)
2166 </pre>
2167
2168 <p>A description of each parameter follows:</p>
2169
2170 <h5>image</h5>
2171 <p>the image.</p>
2172
2173 <h5>radius</h5>
2174 <p>the radius of the pixel neighborhood.</p>
2175
2176 <h5>exception</h5>
2177 <p>return any errors or warnings in this structure.</p>
2178
2179  </div>
2180 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ModeImage">ModeImage</a></h2>
2181 <div class="doc-section">
2182
2183 <p>ModeImage() makes each pixel the 'predominant color' of the neighborhood of the specified radius.</p>
2184
2185 <p>The format of the ModeImage method is:</p>
2186
2187 <pre class="code">
2188   Image *ModeImage(const Image *image,const double radius,
2189     ExceptionInfo *exception)
2190 </pre>
2191
2192 <p>A description of each parameter follows:</p>
2193
2194 <h5>image</h5>
2195 <p>the image.</p>
2196
2197 <h5>radius</h5>
2198 <p>the radius of the pixel neighborhood.</p>
2199
2200 <h5>exception</h5>
2201 <p>return any errors or warnings in this structure.</p>
2202
2203  </div>
2204 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MosaicImages">MosaicImages</a></h2>
2205 <div class="doc-section">
2206
2207 <p>MosaicImages() Obsolete Function: Use MergeImageLayers() instead.</p>
2208
2209 <p>Deprecated, replace with:</p>
2210
2211 <pre class="text">
2212       MergeImageLayers(image,MosaicLayer,exception);
2213 </pre>
2214
2215 <p>The format of the MosaicImage method is:</p>
2216
2217 <pre class="code">
2218   Image *MosaicImages(const Image *image,ExceptionInfo *exception)
2219 </pre>
2220
2221 <p>A description of each parameter follows:</p>
2222
2223 <h5>image</h5>
2224 <p>the image list to be composited together</p>
2225
2226 <h5>exception</h5>
2227 <p>return any errors or warnings in this structure.</p>
2228
2229  </div>
2230 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="OpaqueImage">OpaqueImage</a></h2>
2231 <div class="doc-section">
2232
2233 <p>OpaqueImage() changes any pixel that matches color with the color defined by fill.</p>
2234
2235 <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>
2236
2237 <p>The format of the OpaqueImage method is:</p>
2238
2239 <pre class="code">
2240   MagickBooleanType OpaqueImage(Image *image,
2241     const PixelPacket *target,const PixelPacket fill)
2242 </pre>
2243
2244 <p>A description of each parameter follows:</p>
2245
2246 <h5>image</h5>
2247 <p>the image.</p>
2248
2249 <h5>target</h5>
2250 <p>the RGB value of the target color.</p>
2251
2252 <h5>fill</h5>
2253 <p>the replacement color.</p>
2254
2255  </div>
2256 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="OpenCacheView">OpenCacheView</a></h2>
2257 <div class="doc-section">
2258
2259 <p>OpenCacheView() opens a view into the pixel cache, using the VirtualPixelMethod that is defined within the given image itself.</p>
2260
2261 <p>Deprecated, replace with:</p>
2262
2263 <pre class="text">
2264       AcquireVirtualCacheView(image,&image->exception);
2265 </pre>
2266
2267 <p>The format of the OpenCacheView method is:</p>
2268
2269 <pre class="code">
2270   CacheView *OpenCacheView(const Image *image)
2271 </pre>
2272
2273 <p>A description of each parameter follows:</p>
2274
2275 <h5>image</h5>
2276 <p>the image.</p>
2277
2278  </div>
2279 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="OpenMagickStream">OpenMagickStream</a></h2>
2280 <div class="doc-section">
2281
2282 <p>OpenMagickStream() opens the file at the specified path and return the associated stream.</p>
2283
2284 <p>The path of the OpenMagickStream method is:</p>
2285
2286 <pre class="code">
2287   FILE *OpenMagickStream(const char *path,const char *mode)
2288 </pre>
2289
2290 <p>A description of each parameter follows.</p>
2291
2292 <h5> path</h5>
2293 <p>the file path.</p>
2294
2295 <h5> mode</h5>
2296 <p>the file mode.</p>
2297
2298  </div>
2299 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PaintFloodfill">PaintFloodfill</a></h2>
2300 <div class="doc-section">
2301
2302 <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>
2303
2304 <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>
2305
2306 <p>Deprecated, replace with:</p>
2307
2308 <pre class="text">
2309       FloodfillPaintImage(image,channel,draw_info,target,x,y,
2310   method == FloodfillMethod ? MagickFalse : MagickTrue);
2311 </pre>
2312
2313 <p>The format of the PaintFloodfillImage method is:</p>
2314
2315 <pre class="code">
2316   MagickBooleanType PaintFloodfillImage(Image *image,
2317     const ChannelType channel,const MagickPixelPacket target,
2318     const ssize_t x,const ssize_t y,const DrawInfo *draw_info,
2319     const PaintMethod method)
2320 </pre>
2321
2322 <p>A description of each parameter follows:</p>
2323
2324 <h5>image</h5>
2325 <p>the image.</p>
2326
2327 <h5>channel</h5>
2328 <p>the channel(s).</p>
2329
2330 <h5>target</h5>
2331 <p>the RGB value of the target color.</p>
2332
2333 <h5>x,y</h5>
2334 <p>the starting location of the operation.</p>
2335
2336 <h5>draw_info</h5>
2337 <p>the draw info.</p>
2338
2339 <h5>method</h5>
2340 <p>Choose either FloodfillMethod or FillToBorderMethod.</p>
2341
2342  </div>
2343 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PaintOpaqueImage">PaintOpaqueImage</a></h2>
2344 <div class="doc-section">
2345
2346 <p>PaintOpaqueImage() changes any pixel that matches color with the color defined by fill.</p>
2347
2348 <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>
2349
2350 <p>Deprecated, replace with:</p>
2351
2352 <pre class="text">
2353       OpaquePaintImageChannel(image,DefaultChannels,target,fill,MagickFalse);
2354       OpaquePaintImageChannel(image,channel,target,fill,MagickFalse);
2355 </pre>
2356
2357 <p>The format of the PaintOpaqueImage method is:</p>
2358
2359 <pre class="code">
2360   MagickBooleanType PaintOpaqueImage(Image *image,
2361     const PixelPacket *target,const PixelPacket *fill)
2362   MagickBooleanType PaintOpaqueImageChannel(Image *image,
2363     const ChannelType channel,const PixelPacket *target,
2364     const PixelPacket *fill)
2365 </pre>
2366
2367 <p>A description of each parameter follows:</p>
2368
2369 <h5>image</h5>
2370 <p>the image.</p>
2371
2372 <h5>channel</h5>
2373 <p>the channel(s).</p>
2374
2375 <h5>target</h5>
2376 <p>the RGB value of the target color.</p>
2377
2378 <h5>fill</h5>
2379 <p>the replacement color.</p>
2380
2381  </div>
2382 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PaintTransparentImage">PaintTransparentImage</a></h2>
2383 <div class="doc-section">
2384
2385 <p>PaintTransparentImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p>
2386
2387 <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>
2388
2389 <p>Deprecated, replace with:</p>
2390
2391 <pre class="text">
2392       TransparentPaintImage(image,target,opacity,MagickFalse);
2393 </pre>
2394
2395 <p>The format of the PaintTransparentImage method is:</p>
2396
2397 <pre class="code">
2398   MagickBooleanType PaintTransparentImage(Image *image,
2399     const MagickPixelPacket *target,const Quantum opacity)
2400 </pre>
2401
2402 <p>A description of each parameter follows:</p>
2403
2404 <h5>image</h5>
2405 <p>the image.</p>
2406
2407 <h5>target</h5>
2408 <p>the RGB value of the target color.</p>
2409
2410 <h5>opacity</h5>
2411 <p>the replacement opacity value.</p>
2412
2413  </div>
2414 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ParseSizeGeometry">ParseSizeGeometry</a></h2>
2415 <div class="doc-section">
2416
2417 <p>ParseSizeGeometry() returns a region as defined by the geometry string with respect to the image dimensions and aspect ratio.</p>
2418
2419 <p>Deprecated, replace with:</p>
2420
2421 <pre class="text">
2422       ParseMetaGeometry(geometry,&region_info->x,&region_info->y,
2423   &region_info->width,&region_info->height);
2424 </pre>
2425
2426 <p>The format of the ParseSizeGeometry method is:</p>
2427
2428 <pre class="code">
2429   MagickStatusType ParseSizeGeometry(const Image *image,
2430     const char *geometry,RectangeInfo *region_info)
2431 </pre>
2432
2433 <p>A description of each parameter follows:</p>
2434
2435 <h5>geometry</h5>
2436 <p>The geometry (e.g. 100x100+10+10).</p>
2437
2438 <h5>region_info</h5>
2439 <p>the region as defined by the geometry string.</p>
2440
2441  </div>
2442 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PopImageList">PopImageList</a></h2>
2443 <div class="doc-section">
2444
2445 <p>PopImageList() removes the last image in the list.</p>
2446
2447 <p>Deprecated, replace with:</p>
2448
2449 <pre class="text">
2450       RemoveLastImageFromList(images);
2451 </pre>
2452
2453 <p>The format of the PopImageList method is:</p>
2454
2455 <pre class="code">
2456   Image *PopImageList(Image **images)
2457 </pre>
2458
2459 <p>A description of each parameter follows:</p>
2460
2461 <h5>images</h5>
2462 <p>the image list.</p>
2463
2464  </div>
2465 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PopImagePixels">PopImagePixels</a></h2>
2466 <div class="doc-section">
2467
2468 <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>
2469
2470 <p>The format of the PopImagePixels method is:</p>
2471
2472 <pre class="code">
2473   size_t PopImagePixels(Image *,const QuantumType quantum,
2474     unsigned char *destination)
2475 </pre>
2476
2477 <p>A description of each parameter follows:</p>
2478
2479 <h5>image</h5>
2480 <p>the image.</p>
2481
2482 <h5>quantum</h5>
2483 <p>Declare which pixel components to transfer (RGB, RGBA, etc).</p>
2484
2485 <h5>destination</h5>
2486 <p>The components are transferred to this buffer.</p>
2487
2488  </div>
2489 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PostscriptGeometry">PostscriptGeometry</a></h2>
2490 <div class="doc-section">
2491
2492 <p>PostscriptGeometry() replaces any page mneumonic with the equivalent size in picas.</p>
2493
2494 <p>Deprecated, replace with:</p>
2495
2496 <pre class="text">
2497       GetPageGeometry(page);
2498 </pre>
2499
2500 <p>The format of the PostscriptGeometry method is:</p>
2501
2502 <pre class="code">
2503   char *PostscriptGeometry(const char *page)
2504 </pre>
2505
2506 <p>A description of each parameter follows.</p>
2507
2508 <h5> page</h5>
2509 <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>
2510
2511  </div>
2512 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PushImageList">PushImageList</a></h2>
2513 <div class="doc-section">
2514
2515 <p>PushImageList() adds an image to the end of the list.</p>
2516
2517 <p>Deprecated, replace with:</p>
2518
2519 <pre class="text">
2520       AppendImageToList(images,CloneImageList(image,exception));
2521 </pre>
2522
2523 <p>The format of the PushImageList method is:</p>
2524
2525 <pre class="code">
2526   unsigned int PushImageList(Image *images,const Image *image,
2527     ExceptionInfo *exception)
2528 </pre>
2529
2530 <p>A description of each parameter follows:</p>
2531
2532 <h5>images</h5>
2533 <p>the image list.</p>
2534
2535 <h5>image</h5>
2536 <p>the image.</p>
2537
2538 <h5>exception</h5>
2539 <p>return any errors or warnings in this structure.</p>
2540
2541  </div>
2542 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PushImagePixels">PushImagePixels</a></h2>
2543 <div class="doc-section">
2544
2545 <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>
2546
2547 <p>The format of the PushImagePixels method is:</p>
2548
2549 <pre class="code">
2550   size_t PushImagePixels(Image *image,const QuantumType quantum,
2551     const unsigned char *source)
2552 </pre>
2553
2554 <p>A description of each parameter follows:</p>
2555
2556 <h5>image</h5>
2557 <p>the image.</p>
2558
2559 <h5>quantum</h5>
2560 <p>Declare which pixel components to transfer (red, green, blue, opacity, RGB, or RGBA).</p>
2561
2562 <h5>source</h5>
2563 <p>The pixel components are transferred from this buffer.</p>
2564
2565  </div>
2566 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="QuantizationError">QuantizationError</a></h2>
2567 <div class="doc-section">
2568
2569 <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>
2570
2571 <pre class="text">
2572       o mean_error_per_pixel:  This value is the mean error for any single
2573   pixel in the image.
2574 </pre>
2575
2576 <h5>normalized_mean_square_error</h5>
2577 <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>
2578
2579 <h5>normalized_maximum_square_error</h5>
2580 <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>
2581
2582 <p>Deprecated, replace with:</p>
2583
2584 <pre class="text">
2585       GetImageQuantizeError(image);
2586 </pre>
2587
2588 <p>The format of the QuantizationError method is:</p>
2589
2590 <pre class="code">
2591   unsigned int QuantizationError(Image *image)
2592 </pre>
2593
2594 <p>A description of each parameter follows.</p>
2595
2596 <h5>image</h5>
2597 <p>Specifies a pointer to an Image structure;  returned from ReadImage.</p>
2598
2599  </div>
2600 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="RandomChannelThresholdImage">RandomChannelThresholdImage</a></h2>
2601 <div class="doc-section">
2602
2603 <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>
2604
2605 <p>The format of the RandomChannelThresholdImage method is:</p>
2606
2607 <pre class="code">
2608   unsigned int RandomChannelThresholdImage(Image *image,
2609      const char *channel, const char *thresholds,
2610      ExceptionInfo *exception)
2611 </pre>
2612
2613 <p>A description of each parameter follows:</p>
2614
2615 <h5>image</h5>
2616 <p>the image.</p>
2617
2618 <h5>channel</h5>
2619 <p>the channel or channels to be thresholded.</p>
2620
2621 <h5>thresholds</h5>
2622 <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>
2623
2624 <h5>exception</h5>
2625 <p>return any errors or warnings in this structure.</p>
2626
2627  </div>
2628 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ReacquireMemory">ReacquireMemory</a></h2>
2629 <div class="doc-section">
2630
2631 <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>
2632
2633 <p>The format of the ReacquireMemory method is:</p>
2634
2635 <pre class="code">
2636   void ReacquireMemory(void **memory,const size_t size)
2637 </pre>
2638
2639 <p>A description of each parameter follows:</p>
2640
2641 <h5>memory</h5>
2642 <p>A pointer to a memory allocation.  On return the pointer may change but the contents of the original allocation will not.</p>
2643
2644 <h5>size</h5>
2645 <p>the new size of the allocated memory.</p>
2646
2647  </div>
2648 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="RecolorImage">RecolorImage</a></h2>
2649 <div class="doc-section">
2650
2651 <p>RecolorImage() apply color transformation to an image. The method permits saturation changes, hue rotation, luminance to alpha, and various other effects.  Although variable-sized transformation matrices can be used, typically one uses a 5x5 matrix for an RGBA image and a 6x6 for CMYKA (or RGBA with offsets).  The matrix is similar to those used by Adobe Flash except offsets are in column 6 rather than 5 (in support of CMYKA images) and offsets are normalized (divide Flash offset by 255).</p>
2652
2653 <p>The format of the RecolorImage method is:</p>
2654
2655 <pre class="code">
2656   Image *RecolorImage(const Image *image,const size_t order,
2657     const double *color_matrix,ExceptionInfo *exception)
2658 </pre>
2659
2660 <p>A description of each parameter follows:</p>
2661
2662 <h5>image</h5>
2663 <p>the image.</p>
2664
2665 <h5>order</h5>
2666 <p>the number of columns and rows in the recolor matrix.</p>
2667
2668 <h5>color_matrix</h5>
2669 <p>An array of double representing the recolor matrix.</p>
2670
2671 <h5>exception</h5>
2672 <p>return any errors or warnings in this structure.</p>
2673
2674  </div>
2675 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ReduceNoiseImage">ReduceNoiseImage</a></h2>
2676 <div class="doc-section">
2677
2678 <p>ReduceNoiseImage() smooths the contours of an image while still preserving edge information.  The algorithm works by replacing each pixel with its neighbor closest in value.  A neighbor is defined by radius.  Use a radius of 0 and ReduceNoise() selects a suitable radius for you.</p>
2679
2680 <p>The format of the ReduceNoiseImage method is:</p>
2681
2682 <pre class="code">
2683   Image *ReduceNoiseImage(const Image *image,const double radius,
2684     ExceptionInfo *exception)
2685 </pre>
2686
2687 <p>A description of each parameter follows:</p>
2688
2689 <h5>image</h5>
2690 <p>the image.</p>
2691
2692 <h5>radius</h5>
2693 <p>the radius of the pixel neighborhood.</p>
2694
2695 <h5>exception</h5>
2696 <p>return any errors or warnings in this structure.</p>
2697
2698  </div>
2699 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ResetImageAttributeIterator">ResetImageAttributeIterator</a></h2>
2700 <div class="doc-section">
2701
2702 <p>ResetImageAttributeIterator() resets the image attributes iterator.  Use it in conjunction with GetNextImageAttribute() to iterate over all the values associated with an image.</p>
2703
2704 <p>Deprecated, replace with:</p>
2705
2706 <pre class="text">
2707       ResetImagePropertyIterator(image);
2708 </pre>
2709
2710 <p>The format of the ResetImageAttributeIterator method is:</p>
2711
2712 <pre class="code">
2713   ResetImageAttributeIterator(const ImageInfo *image)
2714 </pre>
2715
2716 <p>A description of each parameter follows:</p>
2717
2718 <h5>image</h5>
2719 <p>the image.</p>
2720
2721  </div>
2722 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetCacheViewPixels">SetCacheViewPixels</a></h2>
2723 <div class="doc-section">
2724
2725 <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>
2726
2727 <p>Deprecated, replace with:</p>
2728
2729 <pre class="text">
2730       QueueCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
2731   GetCacheViewException(cache_view));
2732 </pre>
2733
2734 <p>The format of the SetCacheViewPixels method is:</p>
2735
2736 <pre class="code">
2737   PixelPacket *SetCacheViewPixels(CacheView *cache_view,const ssize_t x,
2738     const ssize_t y,const size_t columns,const size_t rows)
2739 </pre>
2740
2741 <p>A description of each parameter follows:</p>
2742
2743 <h5>cache_view</h5>
2744 <p>the cache view.</p>
2745
2746 <h5>x,y,columns,rows</h5>
2747 <p>These values define the perimeter of a region of pixels.</p>
2748
2749  </div>
2750 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetExceptionInfo">SetExceptionInfo</a></h2>
2751 <div class="doc-section">
2752
2753 <p>SetExceptionInfo() sets the exception severity.</p>
2754
2755 <p>The format of the SetExceptionInfo method is:</p>
2756
2757 <pre class="code">
2758   MagickBooleanType SetExceptionInfo(ExceptionInfo *exception,
2759     ExceptionType severity)
2760 </pre>
2761
2762 <p>A description of each parameter follows:</p>
2763
2764 <h5>exception</h5>
2765 <p>the exception info.</p>
2766
2767 <h5>severity</h5>
2768 <p>the exception severity.</p>
2769
2770  </div>
2771 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImage">SetImage</a></h2>
2772 <div class="doc-section">
2773
2774 <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>
2775
2776 <p>The format of the SetImage method is:</p>
2777
2778 <pre class="code">
2779   void SetImage(Image *image,const Quantum opacity)
2780 </pre>
2781
2782 <p>A description of each parameter follows:</p>
2783
2784 <h5>image</h5>
2785 <p>the image.</p>
2786
2787 <h5>opacity</h5>
2788 <p>Set each pixel to this level of transparency.</p>
2789
2790  </div>
2791 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImageAttribute">SetImageAttribute</a></h2>
2792 <div class="doc-section">
2793
2794 <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>
2795
2796 <p>Deprecated, replace with:</p>
2797
2798 <pre class="text">
2799       SetImageProperty(image,key,value);
2800 </pre>
2801
2802 <p>The format of the SetImageAttribute method is:</p>
2803
2804 <pre class="code">
2805    MagickBooleanType SetImageAttribute(Image *image,const char *key,
2806      const char *value)
2807 </pre>
2808
2809 <p>A description of each parameter follows:</p>
2810
2811 <h5>image</h5>
2812 <p>the image.</p>
2813
2814 <h5>key</h5>
2815 <p>the key.</p>
2816
2817 <h5>value</h5>
2818 <p>the value.</p>
2819
2820  </div>
2821 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImageList">SetImageList</a></h2>
2822 <div class="doc-section">
2823
2824 <p>SetImageList() inserts an image into the list at the specified position.</p>
2825
2826 <p>The format of the SetImageList method is:</p>
2827
2828 <pre class="code">
2829   unsigned int SetImageList(Image *images,const Image *image,
2830     const ssize_t offset,ExceptionInfo *exception)
2831 </pre>
2832
2833 <p>A description of each parameter follows:</p>
2834
2835 <h5>images</h5>
2836 <p>the image list.</p>
2837
2838 <h5>image</h5>
2839 <p>the image.</p>
2840
2841 <h5>offset</h5>
2842 <p>the position within the list.</p>
2843
2844 <h5>exception</h5>
2845 <p>return any errors or warnings in this structure.</p>
2846
2847  </div>
2848 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImagePixels">SetImagePixels</a></h2>
2849 <div class="doc-section">
2850
2851 <p>SetImagePixels() queues a mutable pixel region. If the region is successfully initialized 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>
2852
2853 <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>
2854
2855 <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>
2856
2857 <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>
2858
2859 <p>Deprecated, replace with:</p>
2860
2861 <pre class="text">
2862       QueueAuthenticPixels(image,x,y,columns,rows,&image->exception);
2863 </pre>
2864
2865 <p>The format of the SetImagePixels() method is:</p>
2866
2867 <pre class="code">
2868   PixelPacket *SetImagePixels(Image *image,const ssize_t x,const ssize_t y,
2869     const size_t columns,const size_t rows)
2870 </pre>
2871
2872 <p>A description of each parameter follows:</p>
2873
2874 <h5>pixels</h5>
2875 <p>SetImagePixels returns a pointer to the pixels if they are transferred, otherwise a NULL is returned.</p>
2876
2877 <h5>image</h5>
2878 <p>the image.</p>
2879
2880 <h5>x,y,columns,rows</h5>
2881 <p>These values define the perimeter of a region of pixels.</p>
2882
2883  </div>
2884 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetMagickRegistry">SetMagickRegistry</a></h2>
2885 <div class="doc-section">
2886
2887 <p>SetMagickRegistry() sets a blob into the registry and returns a unique ID. If an error occurs, -1 is returned.</p>
2888
2889 <p>The format of the SetMagickRegistry method is:</p>
2890
2891 <pre class="code">
2892   ssize_t SetMagickRegistry(const RegistryType type,const void *blob,
2893     const size_t length,ExceptionInfo *exception)
2894 </pre>
2895
2896 <p>A description of each parameter follows:</p>
2897
2898 <h5>type</h5>
2899 <p>the registry type.</p>
2900
2901 <h5>blob</h5>
2902 <p>the address of a Binary Large OBject.</p>
2903
2904 <h5>length</h5>
2905 <p>For a registry type of ImageRegistryType use sizeof(Image) otherise the blob length in number of bytes.</p>
2906
2907 <h5>exception</h5>
2908 <p>return any errors or warnings in this structure.</p>
2909
2910  </div>
2911 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetMonitorHandler">SetMonitorHandler</a></h2>
2912 <div class="doc-section">
2913
2914 <p>SetMonitorHandler() sets the monitor handler to the specified method and returns the previous monitor handler.</p>
2915
2916 <p>The format of the SetMonitorHandler method is:</p>
2917
2918 <pre class="code">
2919   MonitorHandler SetMonitorHandler(MonitorHandler handler)
2920 </pre>
2921
2922 <p>A description of each parameter follows:</p>
2923
2924 <h5>handler</h5>
2925 <p>Specifies a pointer to a method to handle monitors.</p>
2926
2927  </div>
2928 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ShiftImageList">ShiftImageList</a></h2>
2929 <div class="doc-section">
2930
2931 <p>ShiftImageList() removes an image from the beginning of the list.</p>
2932
2933 <p>Deprecated, replace with:</p>
2934
2935 <pre class="text">
2936       RemoveFirstImageFromList(images);
2937 </pre>
2938
2939 <p>The format of the ShiftImageList method is:</p>
2940
2941 <pre class="code">
2942   Image *ShiftImageList(Image **images)
2943 </pre>
2944
2945 <p>A description of each parameter follows:</p>
2946
2947 <h5>images</h5>
2948 <p>the image list.</p>
2949
2950  </div>
2951 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SpliceImageList">SpliceImageList</a></h2>
2952 <div class="doc-section">
2953
2954 <p>SpliceImageList() removes the images designated by offset and length from the list and replaces them with the specified list.</p>
2955
2956 <p>The format of the SpliceImageList method is:</p>
2957
2958 <pre class="code">
2959   Image *SpliceImageList(Image *images,const ssize_t offset,
2960     const size_t length,const Image *splices,
2961     ExceptionInfo *exception)
2962 </pre>
2963
2964 <p>A description of each parameter follows:</p>
2965
2966 <h5>images</h5>
2967 <p>the image list.</p>
2968
2969 <h5>offset</h5>
2970 <p>the position within the list.</p>
2971
2972 <h5>length</h5>
2973 <p>the length of the image list to remove.</p>
2974
2975 <h5>splice</h5>
2976 <p>Replace the removed image list with this list.</p>
2977
2978 <h5>exception</h5>
2979 <p>return any errors or warnings in this structure.</p>
2980
2981  </div>
2982 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="Strip">Strip</a></h2>
2983 <div class="doc-section">
2984
2985 <p>Strip() strips any whitespace or quotes from the beginning and end of a string of characters.</p>
2986
2987 <p>The format of the Strip method is:</p>
2988
2989 <pre class="code">
2990   void Strip(char *message)
2991 </pre>
2992
2993 <p>A description of each parameter follows:</p>
2994
2995 <h5>message</h5>
2996 <p>Specifies an array of characters.</p>
2997
2998  </div>
2999 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SyncCacheView">SyncCacheView</a></h2>
3000 <div class="doc-section">
3001
3002 <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>
3003
3004 <p>Deprecated, replace with:</p>
3005
3006 <pre class="text">
3007       SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view));
3008 </pre>
3009
3010 <p>The format of the SyncCacheView method is:</p>
3011
3012 <pre class="code">
3013   MagickBooleanType SyncCacheView(CacheView *cache_view)
3014 </pre>
3015
3016 <p>A description of each parameter follows:</p>
3017
3018 <h5>cache_view</h5>
3019 <p>the cache view.</p>
3020
3021  </div>
3022 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SyncCacheViewPixels">SyncCacheViewPixels</a></h2>
3023 <div class="doc-section">
3024
3025 <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>
3026
3027 <p>Deprecated, replace with:</p>
3028
3029 <pre class="text">
3030       SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view));
3031 </pre>
3032
3033 <p>The format of the SyncCacheViewPixels method is:</p>
3034
3035 <pre class="code">
3036   MagickBooleanType SyncCacheViewPixels(CacheView *cache_view)
3037 </pre>
3038
3039 <p>A description of each parameter follows:</p>
3040
3041 <h5>cache_view</h5>
3042 <p>the cache view.</p>
3043
3044 <h5>exception</h5>
3045 <p>return any errors or warnings in this structure.</p>
3046
3047  </div>
3048 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SyncImagePixels">SyncImagePixels</a></h2>
3049 <div class="doc-section">
3050
3051 <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>
3052
3053 <p>Deprecated, replace with:</p>
3054
3055 <pre class="text">
3056       SyncAuthenticPixels(image,&image->exception);
3057 </pre>
3058
3059 <p>The format of the SyncImagePixels() method is:</p>
3060
3061 <pre class="code">
3062   MagickBooleanType SyncImagePixels(Image *image)
3063 </pre>
3064
3065 <p>A description of each parameter follows:</p>
3066
3067 <h5>image</h5>
3068 <p>the image.</p>
3069
3070  </div>
3071 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TemporaryFilename">TemporaryFilename</a></h2>
3072 <div class="doc-section">
3073
3074 <p>TemporaryFilename() replaces the contents of path by a unique path name.</p>
3075
3076 <p>The format of the TemporaryFilename method is:</p>
3077
3078 <pre class="code">
3079   void TemporaryFilename(char *path)
3080 </pre>
3081
3082 <p>A description of each parameter follows.</p>
3083
3084 <h5> path</h5>
3085 <p>Specifies a pointer to an array of characters.  The unique path name is returned in this array.</p>
3086
3087  </div>
3088 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ThresholdImage">ThresholdImage</a></h2>
3089 <div class="doc-section">
3090
3091 <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>
3092
3093 <p>The format of the ThresholdImage method is:</p>
3094
3095 <pre class="code">
3096   unsigned int ThresholdImage(Image *image,const double threshold)
3097 </pre>
3098
3099 <p>A description of each parameter follows:</p>
3100
3101 <h5>image</h5>
3102 <p>the image.</p>
3103
3104 <h5>threshold</h5>
3105 <p>Define the threshold value</p>
3106
3107  </div>
3108 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ThresholdImageChannel">ThresholdImageChannel</a></h2>
3109 <div class="doc-section">
3110
3111 <p>ThresholdImageChannel() changes the value of individual pixels based on the intensity of each pixel channel.  The result is a high-contrast image.</p>
3112
3113 <p>The format of the ThresholdImageChannel method is:</p>
3114
3115 <pre class="code">
3116   unsigned int ThresholdImageChannel(Image *image,const char *threshold)
3117 </pre>
3118
3119 <p>A description of each parameter follows:</p>
3120
3121 <h5>image</h5>
3122 <p>the image.</p>
3123
3124 <h5>threshold</h5>
3125 <p>define the threshold values.</p>
3126
3127  </div>
3128 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TransformHSL">TransformHSL</a></h2>
3129 <div class="doc-section">
3130
3131 <p>TransformHSL() converts a (red, green, blue) to a (hue, saturation, lightness) triple.</p>
3132
3133 <p>The format of the TransformHSL method is:</p>
3134
3135 <pre class="code">
3136   void TransformHSL(const Quantum red,const Quantum green,
3137     const Quantum blue,double *hue,double *saturation,double *lightness)
3138 </pre>
3139
3140 <p>A description of each parameter follows:</p>
3141
3142 <h5>red, green, blue</h5>
3143 <p>A Quantum value representing the red, green, and blue component of a pixel..</p>
3144
3145 <h5>hue, saturation, lightness</h5>
3146 <p>A pointer to a double value representing a component of the HSL color space.</p>
3147
3148  </div>
3149 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TranslateText">TranslateText</a></h2>
3150 <div class="doc-section">
3151
3152 <p>TranslateText() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p>
3153
3154 <p>Deprecated, replace with:</p>
3155
3156 <pre class="text">
3157       InterpretImageProperties(image_info,image,embed_text);
3158 </pre>
3159
3160 <p>The format of the TranslateText method is:</p>
3161
3162 <pre class="code">
3163   char *TranslateText(const ImageInfo *image_info,Image *image,
3164     const char *embed_text)
3165 </pre>
3166
3167 <p>A description of each parameter follows:</p>
3168
3169 <h5>image_info</h5>
3170 <p>the image info.</p>
3171
3172 <h5>image</h5>
3173 <p>the image.</p>
3174
3175 <h5>embed_text</h5>
3176 <p>the address of a character string containing the embedded formatting characters.</p>
3177
3178  </div>
3179 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TransparentImage">TransparentImage</a></h2>
3180 <div class="doc-section">
3181
3182 <p>TransparentImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p>
3183
3184 <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>
3185
3186 <p>The format of the TransparentImage method is:</p>
3187
3188 <pre class="code">
3189   MagickBooleanType TransparentImage(Image *image,
3190     const PixelPacket target,const Quantum opacity)
3191 </pre>
3192
3193 <p>A description of each parameter follows:</p>
3194
3195 <h5>image</h5>
3196 <p>the image.</p>
3197
3198 <h5>target</h5>
3199 <p>the RGB value of the target color.</p>
3200
3201 <h5>opacity</h5>
3202 <p>the replacement opacity value.</p>
3203
3204  </div>
3205 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="UnshiftImageList">UnshiftImageList</a></h2>
3206 <div class="doc-section">
3207
3208 <p>UnshiftImageList() adds the image to the beginning of the list.</p>
3209
3210 <p>Deprecated, replace with:</p>
3211
3212 <pre class="text">
3213       PrependImageToList(images,CloneImageList(image,exception));
3214 </pre>
3215
3216 <p>The format of the UnshiftImageList method is:</p>
3217
3218 <pre class="code">
3219   unsigned int UnshiftImageList(Image *images,const Image *image,
3220     ExceptionInfo *exception)
3221 </pre>
3222
3223 <p>A description of each parameter follows:</p>
3224
3225 <h5>images</h5>
3226 <p>the image list.</p>
3227
3228 <h5>image</h5>
3229 <p>the image.</p>
3230
3231 <h5>exception</h5>
3232 <p>return any errors or warnings in this structure.</p>
3233
3234  </div>
3235 <h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ZoomImage">ZoomImage</a></h2>
3236 <div class="doc-section">
3237
3238 <p>ZoomImage() creates a new image that is a scaled size of an existing one. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.  The Point filter gives fast pixel replication, Triangle is equivalent to bi-linear interpolation, and Mitchel giver slower, very high-quality results.  See Graphic Gems III for details on this algorithm.</p>
3239
3240 <p>The filter member of the Image structure specifies which image filter to use. Blur specifies the blur factor where > 1 is blurry, < 1 is sharp.</p>
3241
3242 <p>The format of the ZoomImage method is:</p>
3243
3244 <pre class="code">
3245   Image *ZoomImage(const Image *image,const size_t columns,
3246     const size_t rows,ExceptionInfo *exception)
3247 </pre>
3248
3249 <p>A description of each parameter follows:</p>
3250
3251 <h5>image</h5>
3252 <p>the image.</p>
3253
3254 <h5>columns</h5>
3255 <p>An integer that specifies the number of columns in the zoom image.</p>
3256
3257 <h5>rows</h5>
3258 <p>An integer that specifies the number of rows in the scaled image.</p>
3259
3260 <h5>exception</h5>
3261 <p>return any errors or warnings in this structure.</p>
3262
3263  </div>
3264
3265 </div>
3266
3267 <div id="linkbar">
3268     <span id="linkbar-west">&nbsp;</span>
3269     <span id="linkbar-center">
3270       <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">Discourse Server</a> &bull;
3271       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
3272     </span>
3273     <span id="linkbar-east">&nbsp;</span>
3274   </div>
3275   <div class="footer">
3276     <span id="footer-west">&copy; 1999-2013 ImageMagick Studio LLC</span>
3277     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
3278   </div>
3279   <div style="clear: both; margin: 0; width: 100%; "></div>
3280   <script type="text/javascript">
3281     var _gaq = _gaq || [];
3282     _gaq.push(['_setAccount', 'UA-17690367-1']);
3283     _gaq.push(['_trackPageview']);
3284
3285     (function() {
3286       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
3287       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
3288       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
3289     })();
3290   </script>
3291 </body>
3292 </html>