<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">\r
<head>\r
- <meta http-equiv="Content-Type" value="application/xhtml+xml" />\r
+ <meta http-equiv="content-type" content="text/html; charset=utf-8"/>\r
<meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
- <style type="text/css" media="screen,projection"><!--\r
+ <style type="text/css" media="all">\r
@import url("../../www/magick.css");\r
- --></style>\r
+ </style>\r
<link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
<title>ImageMagick: MagickCore, C API for ImageMagick: Deprecated Methods</title>
<meta http-equiv="Content-Language" content="en-US"/>
<meta name="Author" content="ImageMagick Studio LLC"/>
<meta name="Revisit-after" content="2 DAYS"/>
<meta name="Resource-type" content="document"/>
- <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
+ <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
<meta name="Distribution" content="Global"/>
</head>\r
\r
<div class="eastbar">\r
\r
<div class="menu">
- <a href="../../index.html">About ImageMagick</a>
+ <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
</div>
<div class="sep"></div>\r
<div class="menu">
- <a href="../../www/command-line-tools.html">Command-line Tools</a>
+ <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
</div>
<div class="sub">
- <a href="../../www/command-line-processing.html">Processing</a>
+ <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
</div>
<div class="sub">
- <a href="../../www/command-line-options.html">Options</a>
+ <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
</div>
<div class="sub">
- <a href="http://www.imagemagick.org/Usage/">Usage</a>
+ <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
</div>
+<div class="sep"></div>\r
<div class="menu">
- <a href="../../www/api.html">Program Interfaces</a>
-</div>
-<div class="sub">
- <a href="../../www/magick-wand.html">MagickWand</a>
+ <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
</div>
<div class="sub">
- <a href="../../www/magick-core.html">MagickCore</a>
+ <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
</div>
<div class="sub">
- <a href="../../www/perl-magick.html">PerlMagick</a>
+ <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
</div>
<div class="sub">
- <a href="../../Magick++/">Magick++</a>
+ <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
</div>
<div class="menu">
- <a href="../../www/architecture.html">Architecture</a>
+ <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
</div>
-<div class="sep"></div>\r
-<div class="menu">
- <a href="../../www/install-source.html">Install from Source</a>
+<div class="sub">
+ <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
</div>
<div class="sub">
- <a href="../../www/install-source.html#unix">Unix</a>
+ <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
</div>
<div class="sub">
- <a href="../../www/install-source.html#windows">Windows</a>
- </div>
-<div class="menu">
- <a href="../../www/binary-releases.html">Binary Releases</a>
+ <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
</div>
<div class="sub">
- <a href="../../www/binary-releases.html#unix">Unix</a>
+ <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
+</div>
+<div class="sep"></div>\r
+<div class="menu">
+ <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
</div>
<div class="sub">
- <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
+ <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
</div>
<div class="sub">
- <a href="../../www/binary-releases.html#windows">Windows</a>
+ <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
+ </div>
+<div class="menu">
+ <a title="Resources" href="../../www/resources.html">Resources</a>
</div>
<div class="menu">
- <a href="../../www/resources.html">Resources</a>
+ <a title="Architecture" href="../../www/architecture.html">Architecture</a>
</div>
-<div class="sep"></div>\r
<div class="menu">
- <a href="../../www/download.html">Download</a>
+ <a title="Download" href="../../www/download.html">Download</a>
</div>
<div class="sep"></div>\r
<div class="menu">
- <a href="../http://www.imagemagick.org/script/search.php">Search</a>
+ <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
</div>
<div class="sep"></div>\r
<div class="menu">
- <a href="../../www/sitemap.html">Site Map</a>
+ <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
</div>
<div class="sub">
- <a href="../../www/links.html">Links</a>
+ <a title="Site Map: Links"href="../../www/links.html">Links</a>
</div>
<div class="sep"></div>\r
<div class="menu">
- <a href="../../www/sponsors.html">Sponsors:</a>
+ <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
<div class="sponsbox">
<div class="sponsor">
- <a href="http://www.hygi.de">Reinigungsmittel</a><!-- 201002000400+ -->
-</div>
-<div class="sponsor">
- <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
+ <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
</div>
<div class="sponsor">
- <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201004010120 Buchhorn -->
+ <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
</div>
<div class="sponsor">
- <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
+ <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
</div>
<div class="sponsor">
- <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
+ <a title="Sponsor: Kredit" href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
</div>
<div class="sponsor">
- <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
+ <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
</div>
<div class="sponsor">
- <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
+ <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
</div>
<div class="sponsor">
- <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
+ <a title="Sponsor: Webdesign" href="http://www.renehornig.com/" title="Webdesign">Webdesign</a><!-- 20110101000120 -->
</div>
</div>
</div>
\r
<div class="main">\r
\r
-<p class="navigation-index">[<a href="#AcquireCacheViewIndexes">AcquireCacheViewIndexes</a> • <a href="#AcquireCacheViewPixels">AcquireCacheViewPixels</a> • <a href="#AcquireImagePixels">AcquireImagePixels</a> • <a href="#AcquireIndexes">AcquireIndexes</a> • <a href="#AcquireMemory">AcquireMemory</a> • <a href="#AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a> • <a href="#AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a> • <a href="#AcquireOneMagickPixel">AcquireOneMagickPixel</a> • <a href="#AcquireOnePixel">AcquireOnePixel</a> • <a href="#AcquireOneVirtualPixel">AcquireOneVirtualPixel</a> • <a href="#AcquirePixels">AcquirePixels</a> • <a href="#AffinityImage">AffinityImage</a> • <a href="#AffinityImages">AffinityImages</a> • <a href="#AllocateImage">AllocateImage</a> • <a href="#AllocateImageColormap">AllocateImageColormap</a> • <a href="#AllocateNextImage">AllocateNextImage</a> • <a href="#AllocateString">AllocateString</a> • <a href="#
ChannelThresholdImage">ChannelThresholdImage</a> • <a href="#ClipPathImage">ClipPathImage</a> • <a href="#CloneImageAttributes">CloneImageAttributes</a> • <a href="#CloneMemory">CloneMemory</a> • <a href="#CloseCacheView">CloseCacheView</a> • <a href="#ColorFloodfill">ColorFloodfill</a> • <a href="#DeleteImageAttribute">DeleteImageAttribute</a> • <a href="#DeleteImageList">DeleteImageList</a> • <a href="#DeleteMagickRegistry">DeleteMagickRegistry</a> • <a href="#DescribeImage">DescribeImage</a> • <a href="#DestroyImageAttributes">DestroyImageAttributes</a> • <a href="#DestroyImages">DestroyImages</a> • <a href="#DestroyMagick">DestroyMagick</a> • <a href="#DispatchImage">DispatchImage</a> • <a href="#ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a> • <a href="#FlattenImages">FlattenImages</a> • <a href="#FormatImageAttribute">FormatImageAttribute</a> • <a href="#FormatString">FormatString</a> • <a href="#GetConfigureBlob">GetConfigureBlob</a> • <a href="#GetCacheView">GetCacheView</a> • <a href="#GetCacheViewIndexes">GetCacheViewIndexes</a> • <a href="#GetCacheViewPixels">GetCacheViewPixels</a> • <a href="#GetImageAttribute">GetImageAttribute</a> • <a href="#GetImageClippingPathAttribute">GetImageClippingPathAttribute</a> • <a href="#GetImageFromMagickRegistry">GetImageFromMagickRegistry</a> • <a href="#GetMagickRegistry">GetMagickRegistry</a> • <a href="#GetImageGeometry">GetImageGeometry</a> • <a href="#GetImageList">GetImageList</a> • <a href="#GetImageListIndex">GetImageListIndex</a> • <a href="#GetImageListSize">GetImageListSize</a> • <a href="#GetImagePixels">GetImagePixels</a> • <a href="#GetIndexes">GetIndexes</a> • <a href="#GetNextImage">GetNextImage</a> • <a href="#GetNextImageAttribute">GetNextImageAttribute</a> • <a href="#GetNumberScenes">GetNumberScenes</a> • <a href="#GetOnePixel">GetOnePixel</a> • <a href="#GetPixels">GetPixels</a> • <a href="#GetPreviousImage">GetPreviousImage</a> • <a href="#HSLTransform">HSLTransform</a> • <a href="#IdentityAffine">IdentityAffine</a> • <a href="#InitializeMagick">InitializeMagick</a> • <a href="#InterpolatePixelColor">InterpolatePixelColor</a> • <a href="#InterpretImageAttributes">InterpretImageAttributes</a> • <a href="#LevelImageColor">LevelImageColor</a> • <a href="#LiberateMemory">LiberateMemory</a> • <a href="#LiberateSemaphoreInfo">LiberateSemaphoreInfo</a> • <a href="#MagickIncarnate">MagickIncarnate</a> • <a href="#MagickMonitor">MagickMonitor</a> • <a href="#MapImage">MapImage</a> • <a href="#MapImages">MapImages</a> • <a href="#MatteFloodfill">MatteFloodfill</a> • <a href="#MosaicImages">MosaicImages</a> • <a href="#OpaqueImage">OpaqueImage</a> • <a href="#OpenCacheView">OpenCacheView</a> • <a href="#PaintFloodfill">PaintFloodfill</a> • <a href="#PaintOpaqueImage">PaintOpaqueImage</a> • <a href="#PaintTransparentImage">PaintTransparentImage</a> • <a href="#ParseSizeGeometry">ParseSizeGeometry</a> • <a href="#PopImageList">PopImageList</a> • <a href="#PopImagePixels">PopImagePixels</a> • <a href="#PostscriptGeometry">PostscriptGeometry</a> • <a href="#PushImageList">PushImageList</a> • <a href="#PushImagePixels">PushImagePixels</a> • <a href="#QuantizationError">QuantizationError</a> • <a href="#RandomChannelThresholdImage">RandomChannelThresholdImage</a> • <a href="#ReacquireMemory">ReacquireMemory</a> • <a href="#ResetImageAttributeIterator">ResetImageAttributeIterator</a> • <a href="#SetCacheViewPixels">SetCacheViewPixels</a> • <a href="#SetExceptionInfo">SetExceptionInfo</a> • <a href="#SetImage">SetImage</a> • <a href="#SetImageAttribute">SetImageAttribute</a> • <a href="#SetImageList">SetImageList</a> • <a href="#SetImagePixels">SetImagePixels</a> • <a href="#SetMagickRegistry">SetMagickRegistry</a> • <a href="#SetMonitorHandler">SetMonitorHandler</a> • <a href="#ShiftImageList">ShiftImageList</a> • <a href="#SpliceImageList">SpliceImageList</a> • <a href="#Strip">Strip</a> • <a href="#SyncCacheView">SyncCacheView</a> • <a href="#SyncCacheViewPixels">SyncCacheViewPixels</a> • <a href="#SyncImagePixels">SyncImagePixels</a> • <a href="#TemporaryFilename">TemporaryFilename</a> • <a href="#ThresholdImage">ThresholdImage</a> • <a href="#ThresholdImageChannel">ThresholdImageChannel</a> • <a href="#TransformHSL">TransformHSL</a> • <a href="#TranslateText">TranslateText</a> • <a href="#TransparentImage">TransparentImage</a> • <a href="#UnshiftImageList">UnshiftImageList</a>]</p>
+<p class="navigation-index">[<a href="#AcquireCacheViewIndexes">AcquireCacheViewIndexes</a> • <a href="#AcquireCacheViewPixels">AcquireCacheViewPixels</a> • <a href="#AcquireImagePixels">AcquireImagePixels</a> • <a href="#AcquireIndexes">AcquireIndexes</a> • <a href="#AcquireMemory">AcquireMemory</a> • <a href="#AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a> • <a href="#AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a> • <a href="#AcquireOneMagickPixel">AcquireOneMagickPixel</a> • <a href="#AcquireOnePixel">AcquireOnePixel</a> • <a href="#AcquireOneVirtualPixel">AcquireOneVirtualPixel</a> • <a href="#AcquirePixels">AcquirePixels</a> • <a href="#AffinityImage">AffinityImage</a> • <a href="#AffinityImages">AffinityImages</a> • <a href="#AllocateImage">AllocateImage</a> • <a href="#AllocateImageColormap">AllocateImageColormap</a> • <a href="#AllocateNextImage">AllocateNextImage</a> • <a href="#AllocateString">AllocateString</a> • <a href="#
AverageImages">AverageImages</a> • <a href="#ChannelThresholdImage">ChannelThresholdImage</a> • <a href="#ClipPathImage">ClipPathImage</a> • <a href="#CloneImageAttributes">CloneImageAttributes</a> • <a href="#CloneMemory">CloneMemory</a> • <a href="#CloseCacheView">CloseCacheView</a> • <a href="#ColorFloodfill">ColorFloodfill</a> • <a href="#DeleteImageAttribute">DeleteImageAttribute</a> • <a href="#DeleteImageList">DeleteImageList</a> • <a href="#DeleteMagickRegistry">DeleteMagickRegistry</a> • <a href="#DescribeImage">DescribeImage</a> • <a href="#DestroyImageAttributes">DestroyImageAttributes</a> • <a href="#DestroyImages">DestroyImages</a> • <a href="#DestroyMagick">DestroyMagick</a> • <a href="#DispatchImage">DispatchImage</a> • <a href="#ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a> • <a href="#FlattenImages">FlattenImages</a> • <a href="#FormatImageAttribute">FormatImageAttribute</a> • <a href="#FormatString">FormatString</a> • <a href="#GetConfigureBlob">GetConfigureBlob</a> • <a href="#GetCacheView">GetCacheView</a> • <a href="#GetCacheViewIndexes">GetCacheViewIndexes</a> • <a href="#GetCacheViewPixels">GetCacheViewPixels</a> • <a href="#GetImageAttribute">GetImageAttribute</a> • <a href="#GetImageClippingPathAttribute">GetImageClippingPathAttribute</a> • <a href="#GetImageFromMagickRegistry">GetImageFromMagickRegistry</a> • <a href="#GetMagickRegistry">GetMagickRegistry</a> • <a href="#GetImageGeometry">GetImageGeometry</a> • <a href="#GetImageList">GetImageList</a> • <a href="#GetImageListIndex">GetImageListIndex</a> • <a href="#GetImageListSize">GetImageListSize</a> • <a href="#GetImagePixels">GetImagePixels</a> • <a href="#GetIndexes">GetIndexes</a> • <a href="#GetNextImage">GetNextImage</a> • <a href="#GetNextImageAttribute">GetNextImageAttribute</a> • <a href="#GetNumberScenes">GetNumberScenes</a> • <a href="#GetOnePixel">GetOnePixel</a> • <a href="#GetPixels">GetPixels</a> • <a href="#GetPreviousImage">GetPreviousImage</a> • <a href="#HSLTransform">HSLTransform</a> • <a href="#IdentityAffine">IdentityAffine</a> • <a href="#InitializeMagick">InitializeMagick</a> • <a href="#InterpolatePixelColor">InterpolatePixelColor</a> • <a href="#InterpretImageAttributes">InterpretImageAttributes</a> • <a href="#LevelImageColor">LevelImageColor</a> • <a href="#LiberateMemory">LiberateMemory</a> • <a href="#LiberateSemaphoreInfo">LiberateSemaphoreInfo</a> • <a href="#MagickIncarnate">MagickIncarnate</a> • <a href="#MagickMonitor">MagickMonitor</a> • <a href="#MapImage">MapImage</a> • <a href="#MapImages">MapImages</a> • <a href="#MatteFloodfill">MatteFloodfill</a> • <a href="#MaximumImages">MaximumImages</a> • <a href="#MinimumImages">MinimumImages</a> • <a href="#MosaicImages">MosaicImages</a> • <a href="#OpaqueImage">OpaqueImage</a> • <a href="#OpenCacheView">OpenCacheView</a> • <a href="#PaintFloodfill">PaintFloodfill</a> • <a href="#PaintOpaqueImage">PaintOpaqueImage</a> • <a href="#PaintTransparentImage">PaintTransparentImage</a> • <a href="#ParseSizeGeometry">ParseSizeGeometry</a> • <a href="#PopImageList">PopImageList</a> • <a href="#PopImagePixels">PopImagePixels</a> • <a href="#PostscriptGeometry">PostscriptGeometry</a> • <a href="#PushImageList">PushImageList</a> • <a href="#PushImagePixels">PushImagePixels</a> • <a href="#QuantizationError">QuantizationError</a> • <a href="#RandomChannelThresholdImage">RandomChannelThresholdImage</a> • <a href="#ReacquireMemory">ReacquireMemory</a> • <a href="#RecolorImage">RecolorImage</a> • <a href="#ResetImageAttributeIterator">ResetImageAttributeIterator</a> • <a href="#SetCacheViewPixels">SetCacheViewPixels</a> • <a href="#SetExceptionInfo">SetExceptionInfo</a> • <a href="#SetImage">SetImage</a> • <a href="#SetImageAttribute">SetImageAttribute</a> • <a href="#SetImageList">SetImageList</a> • <a href="#SetImagePixels">SetImagePixels</a> • <a href="#SetMagickRegistry">SetMagickRegistry</a> • <a href="#SetMonitorHandler">SetMonitorHandler</a> • <a href="#ShiftImageList">ShiftImageList</a> • <a href="#SpliceImageList">SpliceImageList</a> • <a href="#Strip">Strip</a> • <a href="#SyncCacheView">SyncCacheView</a> • <a href="#SyncCacheViewPixels">SyncCacheViewPixels</a> • <a href="#SyncImagePixels">SyncImagePixels</a> • <a href="#TemporaryFilename">TemporaryFilename</a> • <a href="#ThresholdImage">ThresholdImage</a> • <a href="#ThresholdImageChannel">ThresholdImageChannel</a> • <a href="#TransformHSL">TransformHSL</a> • <a href="#TranslateText">TranslateText</a> • <a href="#TransparentImage">TransparentImage</a> • <a href="#UnshiftImageList">UnshiftImageList</a>]</p>
<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
_8c.html" target="source" name="AcquireCacheViewIndexes">AcquireCacheViewIndexes</a></h2>
<p>AcquireCacheViewIndexes() returns the indexes associated with the specified view.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewVirtualIndexQueue(cache_view);
+</pre>
+
<p>The format of the AcquireCacheViewIndexes method is:</p>
<pre class="code">
<p>AcquireCacheViewPixels() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewVirtualPixels(cache_view,x,y,columns,rows,exception);
+</pre>
+
<p>The format of the AcquireCacheViewPixels method is:</p>
<pre class="code">
const PixelPacket *AcquireCacheViewPixels(const CacheView *cache_view,
- const long x,const long y,const unsigned long columns,
- const unsigned long rows,ExceptionInfo *exception)
+ const ssize_t x,const ssize_t y,const size_t columns,
+ const size_t rows,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>Note, the AcquireImagePixels() and GetAuthenticPixels() methods are not thread-safe. In a threaded environment, use GetCacheViewVirtualPixels() or GetCacheViewAuthenticPixels() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetVirtualPixels(image,x,y,columns,rows,exception);
+</pre>
+
<p>The format of the AcquireImagePixels() method is:</p>
<pre class="code">
- const PixelPacket *AcquireImagePixels(const Image *image,const long x,
- const long y,const unsigned long columns,const unsigned long rows,
+ const PixelPacket *AcquireImagePixels(const Image *image,const ssize_t x,
+ const ssize_t y,const size_t columns,const size_t rows,
ExceptionInfo *exception)
</pre>
_8c.html" target="source" name="AcquireIndexes">AcquireIndexes</a></h2>
<div class="doc-section">
-<p>AcquireIndexes() returns the black channel or the colormap indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels(). NULL is returned if the black channel or colormap indexes are not available.</p></ol>
+<p>AcquireIndexes() returns the black channel or the colormap indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels(). NULL is returned if the black channel or colormap indexes are not available.</p></ol>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetVirtualIndexQueue(image);
+</pre>
<p>The format of the AcquireIndexes() method is:</p>
<p>AcquireOneCacheViewPixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOneCacheViewAuthenticPixel() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetOneCacheViewVirtualPixel(cache_view,x,y,pixel,exception);
+</pre>
+
<p>The format of the AcquireOneCacheViewPixel method is:</p>
<pre class="code">
MagickBooleanType AcquireOneCacheViewPixel(const CacheView *cache_view,
- const long x,const long y,PixelPacket *pixel,ExceptionInfo *exception)
+ const ssize_t x,const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>AcquireOneCacheViewVirtualPixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOneCacheViewAuthenticPixel() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetOneCacheViewVirtualMethodPixel(cache_view,virtual_pixel_method,
+ x,y,pixel,exception);
+</pre>
+
<p>The format of the AcquireOneCacheViewPixel method is:</p>
<pre class="code">
MagickBooleanType AcquireOneCacheViewVirtualPixel(
const CacheView *cache_view,
- const VirtualPixelMethod virtual_pixel_method,const long x,
- const long y,PixelPacket *pixel,ExceptionInfo *exception)
+ const VirtualPixelMethod virtual_pixel_method,const ssize_t x,
+ const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>AcquireOneMagickPixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOnePixel() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickPixelPacket pixel;
+ GetOneVirtualMagickPixel(image,x,y,&pixel,exception);
+</pre>
+
<p>The format of the AcquireOneMagickPixel() method is:</p>
<pre class="code">
- MagickPixelPacket AcquireOneMagickPixel(const Image image,const long x,
- const long y,ExceptionInfo exception)
+ MagickPixelPacket AcquireOneMagickPixel(const Image image,const ssize_t x,
+ const ssize_t y,ExceptionInfo exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>AcquireOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOnePixel() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ PixelPacket pixel;
+ GetOneVirtualPixel(image,x,y,&pixel,exception);
+</pre>
+
<p>The format of the AcquireOnePixel() method is:</p>
<pre class="code">
- PixelPacket AcquireOnePixel(const Image image,const long x,
- const long y,ExceptionInfo exception)
+ PixelPacket AcquireOnePixel(const Image image,const ssize_t x,
+ const ssize_t y,ExceptionInfo exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>AcquireOneVirtualPixel() returns a single pixel at the specified (x,y) location as defined by specified pixel method. The image background color is returned if an error occurs. If you plan to modify the pixel, use GetOnePixel() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ PixelPacket pixel;
+ GetOneVirtualMethodPixel(image,virtual_pixel_method,x,y,&pixel,exception);
+</pre>
+
<p>The format of the AcquireOneVirtualPixel() method is:</p>
<pre class="code">
PixelPacket AcquireOneVirtualPixel(const Image image,
- const VirtualPixelMethod virtual_pixel_method,const long x,
- const long y,ExceptionInfo exception)
+ const VirtualPixelMethod virtual_pixel_method,const ssize_t x,
+ const ssize_t y,ExceptionInfo exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>AcquirePixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetVirtualPixelQueue(image);
+</pre>
+
<p>The format of the AcquirePixels() method is:</p>
<pre class="code">
<p>AffinityImage() replaces the colors of an image with the closest color from a reference image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ RemapImage(quantize_info,image,affinity_image);
+</pre>
+
<p>The format of the AffinityImage method is:</p>
<pre class="code">
<p>AffinityImages() replaces the colors of a sequence of images with the closest color from a reference image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ RemapImages(quantize_info,images,affinity_image);
+</pre>
+
<p>The format of the AffinityImage method is:</p>
<pre class="code">
<p>AllocateImage() returns a pointer to an image structure initialized to default values.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireImage(image_info);
+</pre>
+
<p>The format of the AllocateImage method is:</p>
<pre class="code">
<p>AllocateImageColormap() allocates an image colormap and initializes it to a linear gray colorspace. If the image already has a colormap, it is replaced. AllocateImageColormap() returns MagickTrue if successful, otherwise MagickFalse if there is not enough memory.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireImageColormap(image,colors);
+</pre>
+
<p>The format of the AllocateImageColormap method is:</p>
<pre class="code">
MagickBooleanType AllocateImageColormap(Image *image,
- const unsigned long colors)
+ const size_t colors)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>AllocateNextImage() initializes the next image in a sequence to default values. The next member of image points to the newly allocated image. If there is a memory shortage, next is assigned NULL.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireNextImage(image_info,image);
+</pre>
+
<p>The format of the AllocateNextImage method is:</p>
<pre class="code">
</div>
<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
+_8c.html" target="source" name="AverageImages">AverageImages</a></h2>
+<div class="doc-section">
+
+<p>AverageImages() takes a set of images and averages them together. Each image in the set must have the same width and height. AverageImages() returns a single image with each corresponding pixel component of each image averaged. On failure, a NULL image is returned and exception describes the reason for the failure.</p></ol>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ EvaluateImages(images,MeanEvaluateOperator,exception);
+</pre>
+
+<p>The format of the AverageImages method is:</p>
+
+<pre class="code">
+ Image *AverageImages(Image *images,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p></ol>
+
+<h5>image</h5>
+<ol><p>the image sequence.</p></ol>
+
+<h5>exception</h5>
+<ol><p>return any errors or warnings in this structure.</p></ol>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
_8c.html" target="source" name="ChannelThresholdImage">ChannelThresholdImage</a></h2>
<div class="doc-section">
<p>ClipPathImage() sets the image clip mask based any clipping path information if it exists.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ ClipImagePath(image,pathname,inside);
+</pre>
+
<p>The format of the ClipImage method is:</p>
<pre class="code">
<p>CloneImageAttributes() clones one or more image attributes.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ CloneImageProperties(image,clone_image);
+</pre>
+
<p>The format of the CloneImageAttributes method is:</p>
<pre class="code">
<p>CloseCacheView() closes the specified view returned by a previous call to OpenCacheView().</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ DestroyCacheView(view_info);
+</pre>
+
<p>The format of the CloseCacheView method is:</p>
<pre class="code">
<pre class="code">
MagickBooleanType ColorFloodfillImage(Image *image,
const DrawInfo *draw_info,const PixelPacket target,
- const long x_offset,const long y_offset,const PaintMethod method)
+ const ssize_t x_offset,const ssize_t y_offset,const PaintMethod method)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>DeleteImageAttribute() deletes an attribute from the image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ DeleteImageProperty(image,key);
+</pre>
+
<p>The format of the DeleteImageAttribute method is:</p>
<pre class="code">
<p>The format of the DeleteImageList method is:</p>
<pre class="code">
- unsigned int DeleteImageList(Image *images,const long offset)
+ unsigned int DeleteImageList(Image *images,const ssize_t offset)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>DeleteMagickRegistry() deletes an entry in the registry as defined by the id. It returns MagickTrue if the entry is deleted otherwise MagickFalse if no entry is found in the registry that matches the id.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ char key[MaxTextExtent];
+ FormatMagickString(key,MaxTextExtent,"ld\n",id);
+ DeleteImageRegistry(key);
+</pre>
+
<p>The format of the DeleteMagickRegistry method is:</p>
<pre class="code">
- MagickBooleanType DeleteMagickRegistry(const long id)
+ MagickBooleanType DeleteMagickRegistry(const ssize_t id)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>DescribeImage() describes an image by printing its attributes to the file. Attributes include the image width, height, size, and others.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ IdentifyImage(image,file,verbose);
+</pre>
+
<p>The format of the DescribeImage method is:</p>
<pre class="code">
<p>DestroyImages() destroys an image list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ DestroyImageList(image);
+</pre>
+
<p>The format of the DestroyImages method is:</p>
<pre class="code">
<p>DestroyMagick() destroys the ImageMagick environment.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickCoreTerminus();
+</pre>
+
<p>The format of the DestroyMagick function is:</p>
<pre class="text">
_8c.html" target="source" name="DispatchImage">DispatchImage</a></h2>
<div class="doc-section">
-<p>DispatchImage() extracts pixel data from an image and returns it to you. The method returns MagickFalse on success otherwise MagickTrue if an error is encountered. The data is returned as char, short int, int, long, float, or double in the order specified by map.</p></ol>
+<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></ol>
<p>Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:</p>
DispatchImage(image,0,0,640,1,"RGB",CharPixel,pixels,exception);
</pre>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ ExportImagePixels(image,x_offset,y_offset,columns,rows,map,type,pixels,
+ exception);
+</pre>
+
<p>The format of the DispatchImage method is:</p>
<pre class="code">
- unsigned int DispatchImage(const Image *image,const long x_offset,
- const long y_offset,const unsigned long columns,
- const unsigned long rows,const char *map,const StorageType type,
+ unsigned int DispatchImage(const Image *image,const ssize_t x_offset,
+ const ssize_t y_offset,const size_t columns,
+ const size_t rows,const char *map,const StorageType type,
void *pixels,ExceptionInfo *exception)
</pre>
<p>The format of the ExtractSubimageFromImageImage method is:</p>
<pre class="code">
- Image *ExtractSubimageFromImage(const Image *image,const Image *reference,
- ExceptionInfo *exception)
+ Image *ExtractSubimageFromImage(const Image *image,
+ const Image *reference,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>FlattenImages() Obsolete Function: Use MergeImageLayers() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MergeImageLayers(image,FlattenLayer,exception);
+</pre>
+
<p>The format of the FlattenImage method is:</p>
<pre class="code">
<p>GetCacheView() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
+ GetCacheViewException(cache_view));
+</pre>
+
<p>The format of the GetCacheView method is:</p>
<pre class="code">
- PixelPacket *GetCacheView(CacheView *cache_view,const long x,
- const long y,const unsigned long columns,const unsigned long rows)
+ PixelPacket *GetCacheView(CacheView *cache_view,const ssize_t x,
+ const ssize_t y,const size_t columns,const size_t rows)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>GetCacheViewIndexes() returns the indexes associated with the specified view.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewAuthenticIndexQueue(cache_view);
+</pre>
+
<p>The format of the GetCacheViewIndexes method is:</p>
<pre class="code">
<p>GetCacheViewPixels() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
+ GetCacheViewException(cache_view));
+</pre>
+
<p>The format of the GetCacheViewPixels method is:</p>
<pre class="code">
- PixelPacket *GetCacheViewPixels(CacheView *cache_view,const long x,
- const long y,const unsigned long columns,const unsigned long rows)
+ PixelPacket *GetCacheViewPixels(CacheView *cache_view,const ssize_t x,
+ const ssize_t y,const size_t columns,const size_t rows)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>GetImageClippingPathAttribute() searches the list of image attributes and returns a pointer to a clipping path if it exists otherwise NULL.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageAttribute(image,"8BIM:1999,2998");
+</pre>
+
<p>The format of the GetImageClippingPathAttribute method is:</p>
<pre class="code">
<p>GetImageFromMagickRegistry() gets an image from the registry as defined by its name. If the image is not found, a NULL image is returned.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageRegistry(ImageRegistryType,name,exception);
+</pre>
+
<p>The format of the GetImageFromMagickRegistry method is:</p>
<pre class="code">
- Image *GetImageFromMagickRegistry(const char *name,long *id,
+ Image *GetImageFromMagickRegistry(const char *name,ssize_t *id,
ExceptionInfo *exception)
</pre>
<p>The format of the GetMagickRegistry method is:</p>
<pre class="code">
- const void *GetMagickRegistry(const long id,RegistryType *type,
+ const void *GetMagickRegistry(const ssize_t id,RegistryType *type,
size_t *length,ExceptionInfo *exception)
</pre>
<p>GetImageGeometry() returns a region as defined by the geometry string with respect to the image and its gravity.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ if (size_to_fit != MagickFalse)
+ ParseRegionGeometry(image,geometry,region_info,&image->exception); else
+ ParsePageGeometry(image,geometry,region_info,&image->exception);
+</pre>
+
<p>The format of the GetImageGeometry method is:</p>
<pre class="code">
<p>GetImageList() returns an image at the specified position in the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ CloneImage(GetImageFromList(images,(ssize_t) offset),0,0,MagickTrue,
+ exception);
+</pre>
+
<p>The format of the GetImageList method is:</p>
<pre class="code">
- Image *GetImageList(const Image *images,const long offset,
+ Image *GetImageList(const Image *images,const ssize_t offset,
ExceptionInfo *exception)
</pre>
<p>GetImageListIndex() returns the position in the list of the specified image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageIndexInList(images);
+</pre>
+
<p>The format of the GetImageListIndex method is:</p>
<pre class="code">
- long GetImageListIndex(const Image *images)
+ ssize_t GetImageListIndex(const Image *images)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>GetImageListSize() returns the number of images in the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageListLength(images);
+</pre>
+
<p>The format of the GetImageListSize method is:</p>
<pre class="code">
- unsigned long GetImageListSize(const Image *images)
+ size_t GetImageListSize(const Image *images)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>Pixels accessed via the returned pointer represent a simple array of type PixelPacket. If the image type is CMYK or if the storage class is PseduoClass, call GetAuthenticIndexQueue() after invoking GetImagePixels() to obtain the black color component or colormap indexes (of type IndexPacket) corresponding to the region. Once the PixelPacket (and/or IndexPacket) array has been updated, the changes must be saved back to the underlying image using SyncAuthenticPixels() or they may be lost.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetAuthenticPixels(image,x,y,columns,rows,&image->exception);
+</pre>
+
<p>The format of the GetImagePixels() method is:</p>
<pre class="code">
- PixelPacket *GetImagePixels(Image *image,const long x,const long y,
- const unsigned long columns,const unsigned long rows)
+ PixelPacket *GetImagePixels(Image *image,const ssize_t x,const ssize_t y,
+ const size_t columns,const size_t rows)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>GetIndexes() returns the black channel or the colormap indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels(). NULL is returned if the black channel or colormap indexes are not available.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetAuthenticIndexQueue(image);
+</pre>
+
<p>The format of the GetIndexes() method is:</p>
<pre class="code">
<p>GetNextImage() returns the next image in a list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetNextImageInList(images);
+</pre>
+
<p>The format of the GetNextImage method is:</p>
<pre class="code">
<p>GetNextImageAttribute() gets the next image attribute.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ const char *property;
+ property=GetNextImageProperty(image);
+ if (property != (const char *) NULL)
+ GetImageAttribute(image,property);
+</pre>
+
<p>The format of the GetNextImageAttribute method is:</p>
<pre class="code">
<p>GetNumberScenes() returns the number of images in the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageListLength(image);
+</pre>
+
<p>The format of the GetNumberScenes method is:</p>
<pre class="code">
<p>GetOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetOneAuthenticPixel(image,x,y,&pixel,&image->exception);
+</pre>
+
<p>The format of the GetOnePixel() method is:</p>
<pre class="code">
- PixelPacket GetOnePixel(const Image image,const long x,const long y)
+ PixelPacket GetOnePixel(const Image image,const ssize_t x,const ssize_t y)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetAuthenticPixelQueue(image);
+</pre>
+
<p>The format of the GetPixels() method is:</p>
<pre class="code">
<p>GetPreviousImage() returns the previous image in a list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetPreviousImageInList(images));
+</pre>
+
<p>The format of the GetPreviousImage method is:</p>
<pre class="code">
<p>InitializeMagick() initializes the ImageMagick environment.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickCoreGenesis(path,MagickFalse);
+</pre>
+
<p>The format of the InitializeMagick function is:</p>
<pre class="text">
<p>InterpretImageAttributes() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ InterpretImageProperties(image_info,image,embed_text);
+</pre>
+
<p>The format of the InterpretImageAttributes method is:</p>
<pre class="code">
<p>If the boolean 'invert' is set true the image values will modifyed in the reverse direction. That is any existing "black" and "white" colors in the image will become the color values given, with all other values compressed appropriatally. This effectivally maps a greyscale gradient into the given color gradient.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ LevelColorsImageChannel(image,channel,black_color,white_color,invert);
+</pre>
+
<p>The format of the LevelImageColors method is:</p>
<pre class="code">
<p>LiberateSemaphoreInfo() relinquishes a semaphore.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ UnlockSemaphoreInfo(*semaphore_info);
+</pre>
+
<p>The format of the LiberateSemaphoreInfo method is:</p>
<pre class="code">
<p>MagickIncarnate() initializes the ImageMagick environment.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickCoreGenesis(path,MagickFalse);
+</pre>
+
<p>The format of the MagickIncarnate function is:</p>
<pre class="text">
<p>MapImage() replaces the colors of an image with the closest color from a reference image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ QuantizeInfo quantize_info;
+ GetQuantizeInfo(&quantize_info);
+ quantize_info.dither=dither;
+ RemapImage(&quantize_info,image,map_image);
+</pre>
+
<p>The format of the MapImage method is:</p>
<pre class="code">
<p>MapImages() replaces the colors of a sequence of images with the closest color from a reference image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ QuantizeInfo quantize_info;
+ GetQuantizeInfo(&quantize_info);
+ quantize_info.dither=dither;
+ RemapImages(&quantize_info,images,map_image);
+</pre>
+
<p>The format of the MapImage method is:</p>
<pre class="code">
<pre class="code">
MagickBooleanType MatteFloodfillImage(Image *image,
- const PixelPacket target,const Quantum opacity,const long x_offset,
- const long y_offset,const PaintMethod method)
+ const PixelPacket target,const Quantum opacity,const ssize_t x_offset,
+ const ssize_t y_offset,const PaintMethod method)
</pre>
<p>A description of each parameter follows:</p></ol>
</div>
<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
+_8c.html" target="source" name="MaximumImages">MaximumImages</a></h2>
+<div class="doc-section">
+
+<p>MaximumImages() returns the maximum intensity of an image sequence.</p></ol>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ EvaluateImages(images,MinEvaluateOperator,exception);
+</pre>
+
+<p>The format of the MaxImages method is:</p>
+
+<pre class="code">
+ Image *MaximumImages(Image *images,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p></ol>
+
+<h5>images</h5>
+<ol><p>the image sequence.</p></ol>
+
+<h5>exception</h5>
+<ol><p>return any errors or warnings in this structure.</p></ol>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
+_8c.html" target="source" name="MinimumImages">MinimumImages</a></h2>
+<div class="doc-section">
+
+<p>MinimumImages() returns the minimum intensity of an image sequence.</p></ol>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ EvaluateImages(images,MinEvaluateOperator,exception);
+</pre>
+
+<p>The format of the MinimumImages method is:</p>
+
+<pre class="code">
+ Image *MinimumImages(Image *images,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p></ol>
+
+<h5>images</h5>
+<ol><p>the image sequence.</p></ol>
+
+<h5>exception</h5>
+<ol><p>return any errors or warnings in this structure.</p></ol>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
_8c.html" target="source" name="MosaicImages">MosaicImages</a></h2>
<div class="doc-section">
<p>MosaicImages() Obsolete Function: Use MergeImageLayers() instead.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MergeImageLayers(image,MosaicLayer,exception);
+</pre>
+
<p>The format of the MosaicImage method is:</p>
<pre class="code">
<p>OpenCacheView() opens a view into the pixel cache, using the VirtualPixelMethod that is defined within the given image itself.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireCacheView(image);
+</pre>
+
<p>The format of the OpenCacheView method is:</p>
<pre class="code">
<p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ FloodfillPaintImage(image,channel,draw_info,target,x,y,
+ method == FloodfillMethod ? MagickFalse : MagickTrue);
+</pre>
+
<p>The format of the PaintFloodfillImage method is:</p>
<pre class="code">
MagickBooleanType PaintFloodfillImage(Image *image,
- const ChannelType channel,const MagickPixelPacket target,const long x,
- const long y,const DrawInfo *draw_info,const PaintMethod method)
+ const ChannelType channel,const MagickPixelPacket target,const ssize_t x,
+ const ssize_t y,const DrawInfo *draw_info,const PaintMethod method)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ OpaquePaintImageChannel(image,DefaultChannels,target,fill,MagickFalse);
+ OpaquePaintImageChannel(image,channel,target,fill,MagickFalse);
+</pre>
+
<p>The format of the PaintOpaqueImage method is:</p>
<pre class="code">
<p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ TransparentPaintImage(image,target,opacity,MagickFalse);
+</pre>
+
<p>The format of the PaintTransparentImage method is:</p>
<pre class="code">
<p>ParseSizeGeometry() returns a region as defined by the geometry string with respect to the image dimensions and aspect ratio.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ ParseMetaGeometry(geometry,®ion_info->x,®ion_info->y,
+ ®ion_info->width,®ion_info->height);
+</pre>
+
<p>The format of the ParseSizeGeometry method is:</p>
<pre class="code">
<p>PopImageList() removes the last image in the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ RemoveLastImageFromList(images);
+</pre>
+
<p>The format of the PopImageList method is:</p>
<pre class="code">
<p>PostscriptGeometry() replaces any page mneumonic with the equivalent size in picas.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetPageGeometry(page);
+</pre>
+
<p>The format of the PostscriptGeometry method is:</p>
<pre class="code">
<p>PushImageList() adds an image to the end of the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AppendImageToList(images,CloneImageList(image,exception));
+</pre>
+
<p>The format of the PushImageList method is:</p>
<pre class="code">
<h5>normalized_maximum_square_error</h5>
<ol><p>Thsi value is the normalized maximum quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in your image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageQuantizeError(image);
+</pre>
<p>The format of the QuantizationError method is:</p>
</div>
<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
+_8c.html" target="source" name="RecolorImage">RecolorImage</a></h2>
+<div class="doc-section">
+
+<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></ol>
+
+<p>The format of the RecolorImage method is:</p>
+
+<pre class="code">
+ Image *RecolorImage(const Image *image,const size_t order,
+ const double *color_matrix,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p></ol>
+
+<h5>image</h5>
+<ol><p>the image.</p></ol>
+
+<h5>order</h5>
+<ol><p>the number of columns and rows in the recolor matrix.</p></ol>
+
+<h5>color_matrix</h5>
+<ol><p>An array of double representing the recolor matrix.</p></ol>
+
+<h5>exception</h5>
+<ol><p>return any errors or warnings in this structure.</p></ol>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate
_8c.html" target="source" name="ResetImageAttributeIterator">ResetImageAttributeIterator</a></h2>
<div class="doc-section">
<p>ResetImageAttributeIterator() resets the image attributes iterator. Use it in conjunction with GetNextImageAttribute() to iterate over all the values associated with an image.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ ResetImagePropertyIterator(image);
+</pre>
+
<p>The format of the ResetImageAttributeIterator method is:</p>
<pre class="code">
<p>SetCacheViewPixels() gets pixels from the in-memory or disk pixel cache as defined by the geometry parameters. A pointer to the pixels is returned if the pixels are transferred, otherwise a NULL is returned.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ QueueCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
+ GetCacheViewException(cache_view));
+</pre>
+
<p>The format of the SetCacheViewPixels method is:</p>
<pre class="code">
- PixelPacket *SetCacheViewPixels(CacheView *cache_view,const long x,
- const long y,const unsigned long columns,const unsigned long rows)
+ PixelPacket *SetCacheViewPixels(CacheView *cache_view,const ssize_t x,
+ const ssize_t y,const size_t columns,const size_t rows)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>SetImageAttribute() searches the list of image attributes and replaces the attribute value. If it is not found in the list, the attribute name and value is added to the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ SetImageProperty(image,key,value);
+</pre>
+
<p>The format of the SetImageAttribute method is:</p>
<pre class="code">
<pre class="code">
unsigned int SetImageList(Image *images,const Image *image,
- const long offset,ExceptionInfo *exception)
+ const ssize_t offset,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>Pixels accessed via the returned pointer represent a simple array of type PixelPacket. If the image type is CMYK or the storage class is PseudoClass, call GetAuthenticIndexQueue() after invoking GetAuthenticPixels() to obtain the black color component or the colormap indexes (of type IndexPacket) corresponding to the region. Once the PixelPacket (and/or IndexPacket) array has been updated, the changes must be saved back to the underlying image using SyncAuthenticPixels() or they may be lost.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ QueueAuthenticPixels(image,x,y,columns,rows,&image->exception);
+</pre>
+
<p>The format of the SetImagePixels() method is:</p>
<pre class="code">
- PixelPacket *SetImagePixels(Image *image,const long x,const long y,
- const unsigned long columns,const unsigned long rows)
+ PixelPacket *SetImagePixels(Image *image,const ssize_t x,const ssize_t y,
+ const size_t columns,const size_t rows)
</pre>
<p>A description of each parameter follows:</p></ol>
<p>The format of the SetMagickRegistry method is:</p>
<pre class="code">
- long SetMagickRegistry(const RegistryType type,const void *blob,
+ ssize_t SetMagickRegistry(const RegistryType type,const void *blob,
const size_t length,ExceptionInfo *exception)
</pre>
<p>ShiftImageList() removes an image from the beginning of the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ RemoveFirstImageFromList(images);
+</pre>
+
<p>The format of the ShiftImageList method is:</p>
<pre class="code">
<p>The format of the SpliceImageList method is:</p>
<pre class="code">
- Image *SpliceImageList(Image *images,const long offset,
- const unsigned long length,const Image *splices,
+ Image *SpliceImageList(Image *images,const ssize_t offset,
+ const size_t length,const Image *splices,
ExceptionInfo *exception)
</pre>
<p>SyncCacheView() saves the cache view pixels to the in-memory or disk cache. It returns MagickTrue if the pixel region is synced, otherwise MagickFalse.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view));
+</pre>
+
<p>The format of the SyncCacheView method is:</p>
<pre class="code">
<p>SyncCacheViewPixels() saves the cache view pixels to the in-memory or disk cache. It returns MagickTrue if the pixel region is flushed, otherwise MagickFalse.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view));
+</pre>
+
<p>The format of the SyncCacheViewPixels method is:</p>
<pre class="code">
<p>SyncImagePixels() saves the image pixels to the in-memory or disk cache. The method returns MagickTrue if the pixel region is synced, otherwise MagickFalse.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ SyncAuthenticPixels(image,&image->exception);
+</pre>
+
<p>The format of the SyncImagePixels() method is:</p>
<pre class="code">
<p>TranslateText() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ InterpretImageProperties(image_info,image,embed_text);
+</pre>
+
<p>The format of the TranslateText method is:</p>
<pre class="code">
<p>UnshiftImageList() adds the image to the beginning of the list.</p></ol>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ PrependImageToList(images,CloneImageList(image,exception));
+</pre>
+
<p>The format of the UnshiftImageList method is:</p>
<pre class="code">
<!-- <span id="linkbar-west"> </span> -->\r
<span id="linkbar-center">\r
<a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> •\r
- <a href="../../www/mailing-list.html">Mailing Lists</a> •\r
- <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
+ <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
</span>\r
<span id="linkbar-east"> </span>\r
</div>\r
<div class="footer">\r
- <span id="footer-west">© 1999-2009 ImageMagick Studio LLC</span>\r
+ <span id="footer-west">© 1999-2010 ImageMagick Studio LLC</span>\r
<span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
</div>\r
<div style="clear: both; margin: 0; width: 100%; "></div>\r
projects / imagemagick / blobdiff