<a title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
</div>
<div class="sponsor">
- <a title="Sponsor: Autoteile Online Shop" href="http://www.autoteile-carparts.de">Autoteile Online Shop</a><!-- 2011070100030 autoteile-Carparts-->
+ <a title="Sponsor: alaTest.com" href="http://alatest.com">alaTest.com</a><!-- 20110801000300 -->
</div>
</div>
</div>
<div class="main">\r
\r
<h1>Module deprecate Methods</h1>
-<p class="navigation-index">[<a href="#MagickAverageImages">MagickAverageImages</a> • <a href="#ClonePixelView">ClonePixelView</a> • <a href="#DestroyPixelView">DestroyPixelView</a> • <a href="#DuplexTransferPixelViewIterator">DuplexTransferPixelViewIterator</a> • <a href="#GetPixelViewException">GetPixelViewException</a> • <a href="#GetPixelViewHeight">GetPixelViewHeight</a> • <a href="#GetPixelViewIterator">GetPixelViewIterator</a> • <a href="#GetPixelViewPixels">GetPixelViewPixels</a> • <a href="#GetPixelViewWand">GetPixelViewWand</a> • <a href="#GetPixelViewWidth">GetPixelViewWidth</a> • <a href="#GetPixelViewX">GetPixelViewX</a> • <a href="#GetPixelViewY">GetPixelViewY</a> • <a href="#IsPixelView">IsPixelView</a> • <a href="#MagickClipPathImage">MagickClipPathImage</a> • <a href="#DrawGetFillAlpha">DrawGetFillAlpha</a> • <a href="#DrawGetStrokeAlpha">DrawGetStrokeAlpha</a> • <a href="#DrawPeekGraphicWand">DrawPeekGraphicWand</a> • <a href="#DrawPopGraphicContext">DrawPopGraphicContext</a> • <a href="#DrawPushGraphicContext">DrawPushGraphicContext</a> • <a href="#DrawSetFillAlpha">DrawSetFillAlpha</a> • <a href="#DrawSetStrokeAlpha">DrawSetStrokeAlpha</a> • <a href="#MagickColorFloodfillImage">MagickColorFloodfillImage</a> • <a href="#MagickDescribeImage">MagickDescribeImage</a> • <a href="#MagickFlattenImages">MagickFlattenImages</a> • <a href="#MagickGetImageAttribute">MagickGetImageAttribute</a> • <a href="#MagickGetImageMatte">MagickGetImageMatte</a> • <a href="#MagickGetImagePixels">MagickGetImagePixels</a> • <a href="#MagickGetImageSize">MagickGetImageSize</a> • <a href="#MagickMapImage">MagickMapImage</a> • <a href="#MagickMatteFloodfillImage">MagickMatteFloodfillImage</a> • <a href="#MagickMedianFilterImage">MagickMedianFilterImage</a> • <a href="#MagickMinimumImages">MagickMinimumImages</a> • <a href="#MagickModeImage">MagickModeImage</a> • <a href="#MagickMosaicImages">MagickMosaicImages</a> • <a href="#MagickOpaqueImage">MagickOpaqueImage</a> • <a href="#MagickPaintFloodfillImage">MagickPaintFloodfillImage</a> • <a href="#MagickPaintOpaqueImage">MagickPaintOpaqueImage</a> • <a href="#MagickPaintTransparentImage">MagickPaintTransparentImage</a> • <a href="#MagickRecolorImage">MagickRecolorImage</a> • <a href="#MagickReduceNoiseImage">MagickReduceNoiseImage</a> • <a href="#MagickMaximumImages">MagickMaximumImages</a> • <a href="#MagickSetImageAttribute">MagickSetImageAttribute</a> • <a href="#MagickSetImageIndex">MagickSetImageIndex</a> • <a href="#MagickTransparentImage">MagickTransparentImage</a> • <a href="#MagickRegionOfInterestImage">MagickRegionOfInterestImage</a> • <a href="#MagickSetImagePixels">MagickSetImagePixels</a> • <a href="#MagickWriteImageBlob">MagickWriteImageBlob</a> • <a href="#NewPixelView">NewPixelView</a> • <a href="#NewPixelViewRegion">NewPixelViewRegion</a> • <a href="#PixelGetNextRow">PixelGetNextRow</a> • <a href="#PixelIteratorGetException">PixelIteratorGetException</a> • <a href="#SetPixelViewIterator">SetPixelViewIterator</a> • <a href="#TransferPixelViewIterator">TransferPixelViewIterator</a> • <a href="#UpdatePixelViewIterator">UpdatePixelViewIterator</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="#MedianFilterImage">MedianFilterImage</a> • <a href="#ModeImage">ModeImage</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="#ReduceNoiseImage">ReduceNoiseImage</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> • <a href="#ZoomImage">ZoomImage</a>]</p>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickAverageImages">MagickAverageImages</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireCacheViewIndexes">AcquireCacheViewIndexes</a></h2>
<div class="doc-section">
-<p>MagickAverageImages() average a set of images.</p>
+<p>AcquireCacheViewIndexes() returns the indexes associated with the specified view.</p>
-<p>The format of the MagickAverageImages method is:</p>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewVirtualIndexQueue(cache_view);
+</pre>
+
+<p>The format of the AcquireCacheViewIndexes method is:</p>
<pre class="code">
- MagickWand *MagickAverageImages(MagickWand *wand)
+ const IndexPacket *AcquireCacheViewIndexes(const CacheView *cache_view)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>cache_view</h5>
+<p>the cache view.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ClonePixelView">ClonePixelView</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireCacheViewPixels">AcquireCacheViewPixels</a></h2>
<div class="doc-section">
-<p>ClonePixelView() makes a copy of the specified pixel view.</p>
+<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>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewVirtualPixels(cache_view,x,y,columns,rows,exception);
+</pre>
-<p>The format of the ClonePixelView method is:</p>
+<p>The format of the AcquireCacheViewPixels method is:</p>
<pre class="code">
- PixelView *ClonePixelView(const PixelView *pixel_view)
+ const PixelPacket *AcquireCacheViewPixels(const CacheView *cache_view,
+ 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>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>cache_view</h5>
+<p>the cache view.</p>
+
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyPixelView">DestroyPixelView</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireImagePixels">AcquireImagePixels</a></h2>
<div class="doc-section">
-<p>DestroyPixelView() deallocates memory associated with a pixel view.</p>
+<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>
+
+<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>
+
+<p>If you plan to modify the pixels, use GetAuthenticPixels() instead.</p>
+
+<p>Note, the AcquireImagePixels() and GetAuthenticPixels() methods are not thread-safe. In a threaded environment, use GetCacheViewVirtualPixels() or GetCacheViewAuthenticPixels() instead.</p>
+
+<p>Deprecated, replace with:</p>
-<p>The format of the DestroyPixelView method is:</p>
+<pre class="text">
+ GetVirtualPixels(image,x,y,columns,rows,exception);
+</pre>
+
+<p>The format of the AcquireImagePixels() method is:</p>
<pre class="code">
- PixelView *DestroyPixelView(PixelView *pixel_view,
- const size_t number_wands,const size_t number_threads)
+ 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>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>number_wand</h5>
-<p>the number of pixel wands.</p>
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
-<h5>number_threads</h5>
-<p>number of threads.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DuplexTransferPixelViewIterator">DuplexTransferPixelViewIterator</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireIndexes">AcquireIndexes</a></h2>
<div class="doc-section">
-<p>DuplexTransferPixelViewIterator() iterates over three pixel views in parallel and calls your transfer method for each scanline of the view. The source and duplex pixel region is not confined to the image canvas-- that is you can include negative offsets or widths or heights that exceed the image dimension. However, the destination pixel view is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension are permitted.</p>
+<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>
-<p>Use this pragma:</p>
+<p>Deprecated, replace with:</p>
<pre class="text">
- #pragma omp critical
+ GetVirtualIndexQueue(image);
+</pre>
+
+<p>The format of the AcquireIndexes() method is:</p>
+
+<pre class="code">
+ const IndexPacket *AcquireIndexes(const Image *image)
</pre>
-<p>to define a section of code in your callback transfer method that must be executed by a single thread at a time.</p>
+<p>A description of each parameter follows:</p>
+
+<h5>indexes</h5>
+<p>AcquireIndexes() returns the indexes associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireMemory">AcquireMemory</a></h2>
+<div class="doc-section">
-<p>The format of the DuplexTransferPixelViewIterator method is:</p>
+<p>AcquireMemory() returns a pointer to a block of memory at least size bytes suitably aligned for any use.</p>
+
+<p>The format of the AcquireMemory method is:</p>
<pre class="code">
- MagickBooleanType DuplexTransferPixelViewIterator(PixelView *source,
- PixelView *duplex,PixelView *destination,
- DuplexTransferPixelViewMethod transfer,void *context)
+ void *AcquireMemory(const size_t size)
</pre>
<p>A description of each parameter follows:</p>
-<h5>source</h5>
-<p>the source pixel view.</p>
+<h5>size</h5>
+<p>the size of the memory in bytes to allocate.</p>
-<h5>duplex</h5>
-<p>the duplex pixel view.</p>
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneCacheViewPixel">AcquireOneCacheViewPixel</a></h2>
+<div class="doc-section">
-<h5>destination</h5>
-<p>the destination pixel view.</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>
+
+<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 ssize_t x,const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>cache_view</h5>
+<p>the cache view.</p>
+
+<h5>x,y</h5>
+<p>These values define the offset of the pixel.</p>
-<h5>transfer</h5>
-<p>the transfer callback method.</p>
+<h5>pixel</h5>
+<p>return a pixel at the specified (x,y) location.</p>
-<h5>context</h5>
-<p>the user defined context.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewException">GetPixelViewException</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneCacheViewVirtualPixel">AcquireOneCacheViewVirtualPixel</a></h2>
<div class="doc-section">
-<p>GetPixelViewException() returns the severity, reason, and description of any error that occurs when utilizing a pixel view.</p>
+<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>
-<p>The format of the GetPixelViewException method is:</p>
+<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">
- char *GetPixelViewException(const PixelWand *pixel_view,
- ExceptionType *severity)
+ MagickBooleanType AcquireOneCacheViewVirtualPixel(
+ const CacheView *cache_view,
+ 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>
-<h5>pixel_view</h5>
-<p>the pixel pixel_view.</p>
+<h5>cache_view</h5>
+<p>the cache view.</p>
-<h5>severity</h5>
-<p>the severity of the error is returned here.</p>
+<h5>virtual_pixel_method</h5>
+<p>the virtual pixel method.</p>
+
+<h5>x,y</h5>
+<p>These values define the offset of the pixel.</p>
+
+<h5>pixel</h5>
+<p>return a pixel at the specified (x,y) location.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneMagickPixel">AcquireOneMagickPixel</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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 ssize_t x,
+ const ssize_t y,ExceptionInfo exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>x,y</h5>
+<p>These values define the location of the pixel to return.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOnePixel">AcquireOnePixel</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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 ssize_t x,
+ const ssize_t y,ExceptionInfo exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>x,y</h5>
+<p>These values define the location of the pixel to return.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquireOneVirtualPixel">AcquireOneVirtualPixel</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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 ssize_t x,
+ const ssize_t y,ExceptionInfo exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>virtual_pixel_method</h5>
+<p>the virtual pixel method.</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>x,y</h5>
+<p>These values define the location of the pixel to return.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AcquirePixels">AcquirePixels</a></h2>
+<div class="doc-section">
+
+<p>AcquirePixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetVirtualPixelQueue(image);
+</pre>
+
+<p>The format of the AcquirePixels() method is:</p>
+
+<pre class="code">
+ const PixelPacket *AcquirePixels(const Image image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AffinityImage">AffinityImage</a></h2>
+<div class="doc-section">
+
+<p>AffinityImage() replaces the colors of an image with the closest color from a reference image.</p>
+
+<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">
+ MagickBooleanType AffinityImage(const QuantizeInfo *quantize_info,
+ Image *image,const Image *affinity_image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>quantize_info</h5>
+<p>Specifies a pointer to an QuantizeInfo structure.</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>affinity_image</h5>
+<p>the reference image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AffinityImages">AffinityImages</a></h2>
+<div class="doc-section">
+
+<p>AffinityImages() replaces the colors of a sequence of images with the closest color from a reference image.</p>
+
+<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">
+ MagickBooleanType AffinityImages(const QuantizeInfo *quantize_info,
+ Image *images,Image *affinity_image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>quantize_info</h5>
+<p>Specifies a pointer to an QuantizeInfo structure.</p>
+
+<h5>images</h5>
+<p>the image sequence.</p>
+
+<h5>affinity_image</h5>
+<p>the reference image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateImage">AllocateImage</a></h2>
+<div class="doc-section">
+
+<p>AllocateImage() returns a pointer to an image structure initialized to default values.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireImage(image_info);
+</pre>
+
+<p>The format of the AllocateImage method is:</p>
+
+<pre class="code">
+ Image *AllocateImage(const ImageInfo *image_info)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image_info</h5>
+<p>Many of the image default values are set from this structure. For example, filename, compression, depth, background color, and others.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewHeight">GetPixelViewHeight</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateImageColormap">AllocateImageColormap</a></h2>
<div class="doc-section">
-<p>GetPixelViewHeight() returns the pixel view height.</p>
+<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>
-<p>The format of the GetPixelViewHeight method is:</p>
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireImageColormap(image,colors);
+</pre>
+
+<p>The format of the AllocateImageColormap method is:</p>
<pre class="code">
- size_t GetPixelViewHeight(const PixelView *pixel_view)
+ MagickBooleanType AllocateImageColormap(Image *image,
+ const size_t colors)
</pre>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>colors</h5>
+<p>the number of colors in the image colormap.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewIterator">GetPixelViewIterator</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateNextImage">AllocateNextImage</a></h2>
<div class="doc-section">
-<p>GetPixelViewIterator() iterates over the pixel view in parallel and calls your get method for each scanline of the view. The pixel region is not confined to the image canvas-- that is you can include negative offsets or widths or heights that exceed the image dimension. Any updates to the pixels in your callback are ignored.</p>
+<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>
-<p>Use this pragma:</p>
+<p>Deprecated, replace with:</p>
<pre class="text">
- #pragma omp critical
+ AcquireNextImage(image_info,image);
+</pre>
+
+<p>The format of the AllocateNextImage method is:</p>
+
+<pre class="code">
+ void AllocateNextImage(const ImageInfo *image_info,Image *image)
</pre>
-<p>to define a section of code in your callback get method that must be executed by a single thread at a time.</p>
+<p>A description of each parameter follows:</p>
+
+<h5>image_info</h5>
+<p>Many of the image default values are set from this structure. For example, filename, compression, depth, background color, and others.</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="AllocateString">AllocateString</a></h2>
+<div class="doc-section">
+
+<p>AllocateString() allocates memory for a string and copies the source string to that memory location (and returns it).</p>
-<p>The format of the GetPixelViewIterator method is:</p>
+<p>The format of the AllocateString method is:</p>
<pre class="code">
- MagickBooleanType GetPixelViewIterator(PixelView *source,
- GetPixelViewMethod get,void *context)
+ char *AllocateString(const char *source)
</pre>
<p>A description of each parameter follows:</p>
<h5>source</h5>
-<p>the source pixel view.</p>
+<p>A character string.</p>
-<h5>get</h5>
-<p>the get callback method.</p>
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="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>
+
+<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>
+
+<h5>image</h5>
+<p>the image sequence.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ChannelThresholdImage">ChannelThresholdImage</a></h2>
+<div class="doc-section">
+
+<p>ChannelThresholdImage() changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.</p>
+
+<p>The format of the ChannelThresholdImage method is:</p>
+
+<pre class="code">
+ unsigned int ChannelThresholdImage(Image *image,const char *level)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>level</h5>
+<p>define the threshold values.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ClipPathImage">ClipPathImage</a></h2>
+<div class="doc-section">
+
+<p>ClipPathImage() sets the image clip mask based any clipping path information if it exists.</p>
+
+<p>Deprecated, replace with:</p>
-<h5>context</h5>
-<p>the user defined context.</p>
+<pre class="text">
+ ClipImagePath(image,pathname,inside);
+</pre>
+
+<p>The format of the ClipImage method is:</p>
+
+<pre class="code">
+ MagickBooleanType ClipPathImage(Image *image,const char *pathname,
+ const MagickBooleanType inside)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>pathname</h5>
+<p>name of clipping path resource. If name is preceded by #, use clipping path numbered by name.</p>
+
+<h5>inside</h5>
+<p>if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="CloneImageAttributes">CloneImageAttributes</a></h2>
+<div class="doc-section">
+
+<p>CloneImageAttributes() clones one or more image attributes.</p>
+
+<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">
+ MagickBooleanType CloneImageAttributes(Image *image,
+ const Image *clone_image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>clone_image</h5>
+<p>the clone image.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewPixels">GetPixelViewPixels</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="CloneMemory">CloneMemory</a></h2>
<div class="doc-section">
-<p>GetPixelViewPixels() returns the pixel view pixel_wands.</p>
+<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>
+
+<p>The format of the CloneMemory method is:</p>
+
+<pre class="code">
+ void *CloneMemory(void *destination,const void *source,
+ const size_t size)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>destination</h5>
+<p>the destination.</p>
+
+<h5>source</h5>
+<p>the source.</p>
+
+<h5>size</h5>
+<p>the size of the memory in bytes to allocate.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="CloseCacheView">CloseCacheView</a></h2>
+<div class="doc-section">
+
+<p>CloseCacheView() closes the specified view returned by a previous call to OpenCacheView().</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ DestroyCacheView(view_info);
+</pre>
+
+<p>The format of the CloseCacheView method is:</p>
+
+<pre class="code">
+ CacheView *CloseCacheView(CacheView *view_info)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>view_info</h5>
+<p>the address of a structure of type CacheView.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ColorFloodfill">ColorFloodfill</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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>
+
+<p>The format of the ColorFloodfillImage method is:</p>
+
+<pre class="code">
+ MagickBooleanType ColorFloodfillImage(Image *image,
+ const DrawInfo *draw_info,const PixelPacket target,
+ const ssize_t x_offset,const ssize_t y_offset,const PaintMethod method)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>draw_info</h5>
+<p>the draw info.</p>
+
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
+
+<h5>x,y</h5>
+<p>the starting location of the operation.</p>
+
+<h5>method</h5>
+<p>Choose either FloodfillMethod or FillToBorderMethod.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DeleteImageAttribute">DeleteImageAttribute</a></h2>
+<div class="doc-section">
+
+<p>DeleteImageAttribute() deletes an attribute from the image.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ DeleteImageProperty(image,key);
+</pre>
+
+<p>The format of the DeleteImageAttribute method is:</p>
+
+<pre class="code">
+ MagickBooleanType DeleteImageAttribute(Image *image,const char *key)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image info.</p>
+
+<h5>key</h5>
+<p>the image key.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DeleteImageList">DeleteImageList</a></h2>
+<div class="doc-section">
+
+<p>DeleteImageList() deletes an image at the specified position in the list.</p>
+
+<p>The format of the DeleteImageList method is:</p>
+
+<pre class="code">
+ unsigned int DeleteImageList(Image *images,const ssize_t offset)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+<h5>offset</h5>
+<p>the position within the list.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DeleteMagickRegistry">DeleteMagickRegistry</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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 ssize_t id)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>id</h5>
+<p>the registry id.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DescribeImage">DescribeImage</a></h2>
+<div class="doc-section">
+
+<p>DescribeImage() describes an image by printing its attributes to the file. Attributes include the image width, height, size, and others.</p>
+
+<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">
+ MagickBooleanType DescribeImage(Image *image,FILE *file,
+ const MagickBooleanType verbose)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>file</h5>
+<p>the file, typically stdout.</p>
+
+<h5>verbose</h5>
+<p>A value other than zero prints more detailed information about the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyImageAttributes">DestroyImageAttributes</a></h2>
+<div class="doc-section">
+
+<p>DestroyImageAttributes() deallocates memory associated with the image attribute list.</p>
+
+<p>The format of the DestroyImageAttributes method is:</p>
+
+<pre class="code">
+ DestroyImageAttributes(Image *image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyImages">DestroyImages</a></h2>
+<div class="doc-section">
+
+<p>DestroyImages() destroys an image list.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ DestroyImageList(image);
+</pre>
+
+<p>The format of the DestroyImages method is:</p>
+
+<pre class="code">
+ void DestroyImages(Image *image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image sequence.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DestroyMagick">DestroyMagick</a></h2>
+<div class="doc-section">
+
+<p>DestroyMagick() destroys the ImageMagick environment.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickCoreTerminus();
+</pre>
+
+<p>The format of the DestroyMagick function is:</p>
+
+<pre class="text">
+ DestroyMagick(void)
+</pre>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="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, ssize_t, float, or double in the order specified by map.</p>
+
+<p>Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:</p>
+
+<pre class="text">
+ 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 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>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>x_offset, y_offset, columns, rows</h5>
+<p>These values define the perimeter of a region of pixels you want to extract.</p>
+
+<h5>map</h5>
+<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>
+
+<h5>type</h5>
+<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>
+
+<h5>pixels</h5>
+<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>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ExtractSubimageFromImageImage">ExtractSubimageFromImageImage</a></h2>
+<div class="doc-section">
+
+<p>ExtractSubimageFromImageImage() extracts a region of the image that most closely resembles the reference.</p>
+
+<p>The format of the ExtractSubimageFromImageImage method is:</p>
+
+<pre class="code">
+ Image *ExtractSubimageFromImage(const Image *image,
+ const Image *reference,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>reference</h5>
+<p>find an area of the image that closely resembles this image.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FlattenImages">FlattenImages</a></h2>
+<div class="doc-section">
+
+<p>FlattenImages() Obsolete Function: Use MergeImageLayers() instead.</p>
+
+<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">
+ Image *FlattenImage(Image *image,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image sequence.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FormatImageAttribute">FormatImageAttribute</a></h2>
+<div class="doc-section">
+
+<p>FormatImageAttribute() permits formatted key/value pairs to be saved as an image attribute.</p>
+
+<p>The format of the FormatImageAttribute method is:</p>
+
+<pre class="code">
+ MagickBooleanType FormatImageAttribute(Image *image,const char *key,
+ const char *format,...)
+</pre>
+
+<p>A description of each parameter follows.</p>
+
+<h5> image</h5>
+<p>The image.</p>
+
+<h5> key</h5>
+<p>The attribute key.</p>
+
+<h5> format</h5>
+<p>A string describing the format to use to write the remaining arguments.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="FormatString">FormatString</a></h2>
+<div class="doc-section">
+
+<p>FormatString() prints formatted output of a variable argument list.</p>
+
+<p>The format of the FormatString method is:</p>
+
+<pre class="code">
+ void FormatString(char *string,const char *format,...)
+</pre>
+
+<p>A description of each parameter follows.</p>
+
+<h5> string</h5>
+<p>Method FormatString returns the formatted string in this character buffer.</p>
+
+<h5> format</h5>
+<p>A string describing the format to use to write the remaining arguments.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetConfigureBlob">GetConfigureBlob</a></h2>
+<div class="doc-section">
+
+<p>GetConfigureBlob() returns the specified configure file as a blob.</p>
+
+<p>The format of the GetConfigureBlob method is:</p>
+
+<pre class="code">
+ void *GetConfigureBlob(const char *filename,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>filename</h5>
+<p>the configure file name.</p>
+
+<h5>path</h5>
+<p>return the full path information of the configure file.</p>
+
+<h5>length</h5>
+<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>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetCacheView">GetCacheView</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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 ssize_t x,
+ const ssize_t y,const size_t columns,const size_t rows)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>cache_view</h5>
+<p>the address of a structure of type CacheView.</p>
+
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetCacheViewIndexes">GetCacheViewIndexes</a></h2>
+<div class="doc-section">
+
+<p>GetCacheViewIndexes() returns the indexes associated with the specified view.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetCacheViewAuthenticIndexQueue(cache_view);
+</pre>
+
+<p>The format of the GetCacheViewIndexes method is:</p>
+
+<pre class="code">
+ IndexPacket *GetCacheViewIndexes(CacheView *cache_view)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>cache_view</h5>
+<p>the cache view.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetCacheViewPixels">GetCacheViewPixels</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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 ssize_t x,
+ const ssize_t y,const size_t columns,const size_t rows)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>cache_view</h5>
+<p>the cache view.</p>
+
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageAttribute">GetImageAttribute</a></h2>
+<div class="doc-section">
+
+<p>GetImageAttribute() searches the list of image attributes and returns a pointer to the attribute if it exists otherwise NULL.</p>
+
+<p>The format of the GetImageAttribute method is:</p>
+
+<pre class="code">
+ const ImageAttribute *GetImageAttribute(const Image *image,
+ const char *key)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>key</h5>
+<p>These character strings are the name of an image attribute to return.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageClippingPathAttribute">GetImageClippingPathAttribute</a></h2>
+<div class="doc-section">
+
+<p>GetImageClippingPathAttribute() searches the list of image attributes and returns a pointer to a clipping path if it exists otherwise NULL.</p>
+
+<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">
+ const ImageAttribute *GetImageClippingPathAttribute(Image *image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>attribute</h5>
+<p>Method GetImageClippingPathAttribute returns the clipping path if it exists otherwise NULL.</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageFromMagickRegistry">GetImageFromMagickRegistry</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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,ssize_t *id,
+ ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>name</h5>
+<p>the name of the image to retrieve from the registry.</p>
+
+<h5>id</h5>
+<p>the registry id.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetMagickRegistry">GetMagickRegistry</a></h2>
+<div class="doc-section">
+
+<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>
+
+<p>The format of the GetMagickRegistry method is:</p>
+
+<pre class="code">
+ const void *GetMagickRegistry(const ssize_t id,RegistryType *type,
+ size_t *length,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>id</h5>
+<p>the registry id.</p>
+
+<h5>type</h5>
+<p>the registry type.</p>
+
+<h5>length</h5>
+<p>the blob length in number of bytes.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageGeometry">GetImageGeometry</a></h2>
+<div class="doc-section">
+
+<p>GetImageGeometry() returns a region as defined by the geometry string with respect to the image and its gravity.</p>
+
+<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">
+ int GetImageGeometry(Image *image,const char *geometry,
+ const unsigned int size_to_fit,RectangeInfo *region_info)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>flags</h5>
+<p>Method GetImageGeometry returns a bitmask that indicates which of the four values were located in the geometry string.</p>
+
+<h5>geometry</h5>
+<p>The geometry (e.g. 100x100+10+10).</p>
+
+<h5>size_to_fit</h5>
+<p>A value other than 0 means to scale the region so it fits within the specified width and height.</p>
+
+<h5>region_info</h5>
+<p>the region as defined by the geometry string with respect to the image and its gravity.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageList">GetImageList</a></h2>
+<div class="doc-section">
+
+<p>GetImageList() returns an image at the specified position in the list.</p>
+
+<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 ssize_t offset,
+ ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+<h5>offset</h5>
+<p>the position within the list.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageListIndex">GetImageListIndex</a></h2>
+<div class="doc-section">
+
+<p>GetImageListIndex() returns the position in the list of the specified image.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageIndexInList(images);
+</pre>
+
+<p>The format of the GetImageListIndex method is:</p>
+
+<pre class="code">
+ ssize_t GetImageListIndex(const Image *images)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImageListSize">GetImageListSize</a></h2>
+<div class="doc-section">
+
+<p>GetImageListSize() returns the number of images in the list.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageListLength(images);
+</pre>
+
+<p>The format of the GetImageListSize method is:</p>
+
+<pre class="code">
+ size_t GetImageListSize(const Image *images)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetImagePixels">GetImagePixels</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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>
+
+<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>
+
+<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 ssize_t x,const ssize_t y,
+ const size_t columns,const size_t rows)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetIndexes">GetIndexes</a></h2>
+<div class="doc-section">
+
+<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>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetAuthenticIndexQueue(image);
+</pre>
+
+<p>The format of the GetIndexes() method is:</p>
+
+<pre class="code">
+ IndexPacket *GetIndexes(const Image *image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>indexes</h5>
+<p>GetIndexes() returns the indexes associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetNextImage">GetNextImage</a></h2>
+<div class="doc-section">
+
+<p>GetNextImage() returns the next image in a list.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetNextImageInList(images);
+</pre>
+
+<p>The format of the GetNextImage method is:</p>
+
+<pre class="code">
+ Image *GetNextImage(const Image *images)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetNextImageAttribute">GetNextImageAttribute</a></h2>
+<div class="doc-section">
+
+<p>GetNextImageAttribute() gets the next image attribute.</p>
+
+<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">
+ const ImageAttribute *GetNextImageAttribute(const Image *image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetNumberScenes">GetNumberScenes</a></h2>
+<div class="doc-section">
+
+<p>GetNumberScenes() returns the number of images in the list.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetImageListLength(image);
+</pre>
+
+<p>The format of the GetNumberScenes method is:</p>
+
+<pre class="code">
+ unsigned int GetNumberScenes(const Image *images)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetOnePixel">GetOnePixel</a></h2>
+<div class="doc-section">
+
+<p>GetOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs.</p>
+
+<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 ssize_t x,const ssize_t y)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>x,y</h5>
+<p>These values define the location of the pixel to return.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixels">GetPixels</a></h2>
+<div class="doc-section">
+
+<p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetAuthenticPixelQueue(image);
+</pre>
+
+<p>The format of the GetPixels() method is:</p>
+
+<pre class="code">
+ PixelPacket *GetPixels(const Image image)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>pixels</h5>
+<p>GetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPreviousImage">GetPreviousImage</a></h2>
+<div class="doc-section">
+
+<p>GetPreviousImage() returns the previous image in a list.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetPreviousImageInList(images));
+</pre>
+
+<p>The format of the GetPreviousImage method is:</p>
+
+<pre class="code">
+ Image *GetPreviousImage(const Image *images)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>images</h5>
+<p>the image list.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="HSLTransform">HSLTransform</a></h2>
+<div class="doc-section">
+
+<p>HSLTransform() converts a (hue, saturation, lightness) to a (red, green, blue) triple.</p>
+
+<p>The format of the HSLTransformImage method is:</p>
+
+<pre class="code">
+ void HSLTransform(const double hue,const double saturation,
+ const double lightness,Quantum *red,Quantum *green,Quantum *blue)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>hue, saturation, lightness</h5>
+<p>A double value representing a component of the HSL color space.</p>
+
+<h5>red, green, blue</h5>
+<p>A pointer to a pixel component of type Quantum.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="IdentityAffine">IdentityAffine</a></h2>
+<div class="doc-section">
+
+<p>IdentityAffine() initializes the affine transform to the identity matrix.</p>
+
+<p>The format of the IdentityAffine method is:</p>
+
+<pre class="code">
+ IdentityAffine(AffineMatrix *affine)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>affine</h5>
+<p>A pointer the affine transform of type AffineMatrix.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="InitializeMagick">InitializeMagick</a></h2>
+<div class="doc-section">
+
+<p>InitializeMagick() initializes the ImageMagick environment.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickCoreGenesis(path,MagickFalse);
+</pre>
+
+<p>The format of the InitializeMagick function is:</p>
+
+<pre class="text">
+ InitializeMagick(const char *path)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>path</h5>
+<p>the execution path of the current ImageMagick client.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="InterpolatePixelColor">InterpolatePixelColor</a></h2>
+<div class="doc-section">
+
+<p>InterpolatePixelColor() applies bi-linear or tri-linear interpolation between a pixel and it's neighbors.</p>
+
+<p>The format of the InterpolatePixelColor method is:</p>
+
+<pre class="code">
+ MagickPixelPacket InterpolatePixelColor(const Image *image,
+ CacheView *view_info,InterpolatePixelMethod method,const double x,
+ const double y,ExceptionInfo *exception)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>image_view</h5>
+<p>the image cache view.</p>
+
+<h5>type</h5>
+<p>the type of pixel color interpolation.</p>
+
+<h5>x,y</h5>
+<p>A double representing the current (x,y) position of the pixel.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="InterpretImageAttributes">InterpretImageAttributes</a></h2>
+<div class="doc-section">
+
+<p>InterpretImageAttributes() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p>
+
+<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">
+ char *InterpretImageAttributes(const ImageInfo *image_info,Image *image,
+ const char *embed_text)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image_info</h5>
+<p>the image info.</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>embed_text</h5>
+<p>the address of a character string containing the embedded formatting characters.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="LevelImageColor">LevelImageColor</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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>
+
+<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">
+ MagickBooleanType LevelImageColors(Image *image,const ChannelType channel,
+ const MagickPixelPacket *black_color,const MagickPixelPacket *white_color,
+ const MagickBooleanType invert)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>channel</h5>
+<p>the channel.</p>
+
+<h5>black_color</h5>
+<p>The color to map black to/from</p>
+
+<h5>white_point</h5>
+<p>The color to map white to/from</p>
+
+<h5>invert</h5>
+<p>if true map the colors (levelize), rather than from (level)</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="LiberateMemory">LiberateMemory</a></h2>
+<div class="doc-section">
+
+<p>LiberateMemory() frees memory that has already been allocated, and NULL's the pointer to it.</p>
+
+<p>The format of the LiberateMemory method is:</p>
+
+<pre class="code">
+ void LiberateMemory(void **memory)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>memory</h5>
+<p>A pointer to a block of memory to free for reuse.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="LiberateSemaphoreInfo">LiberateSemaphoreInfo</a></h2>
+<div class="doc-section">
+
+<p>LiberateSemaphoreInfo() relinquishes a semaphore.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ UnlockSemaphoreInfo(*semaphore_info);
+</pre>
+
+<p>The format of the LiberateSemaphoreInfo method is:</p>
+
+<pre class="code">
+ LiberateSemaphoreInfo(void **semaphore_info)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>semaphore_info</h5>
+<p>Specifies a pointer to an SemaphoreInfo structure.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickIncarnate">MagickIncarnate</a></h2>
+<div class="doc-section">
+
+<p>MagickIncarnate() initializes the ImageMagick environment.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MagickCoreGenesis(path,MagickFalse);
+</pre>
+
+<p>The format of the MagickIncarnate function is:</p>
+
+<pre class="text">
+ MagickIncarnate(const char *path)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>path</h5>
+<p>the execution path of the current ImageMagick client.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMonitor">MagickMonitor</a></h2>
+<div class="doc-section">
+
+<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>
+
+<p>The format of the MagickMonitor method is:</p>
+
+<pre class="code">
+ MagickBooleanType MagickMonitor(const char *text,
+ const MagickOffsetType offset,const MagickSizeType span,
+ void *client_data)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>offset</h5>
+<p>the position relative to the span parameter which represents how much progress has been made toward completing a task.</p>
+
+<h5>span</h5>
+<p>the span relative to completing a task.</p>
+
+<h5>client_data</h5>
+<p>the client data.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MapImage">MapImage</a></h2>
+<div class="doc-section">
+
+<p>MapImage() replaces the colors of an image with the closest color from a reference image.</p>
+
+<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">
+ MagickBooleanType MapImage(Image *image,const Image *map_image,
+ const MagickBooleanType dither)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>Specifies a pointer to an Image structure.</p>
+
+<h5>map_image</h5>
+<p>the image. Reduce image to a set of colors represented by this image.</p>
+
+<h5>dither</h5>
+<p>Set this integer value to something other than zero to dither the mapped image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MapImages">MapImages</a></h2>
+<div class="doc-section">
+
+<p>MapImages() replaces the colors of a sequence of images with the closest color from a reference image.</p>
+
+<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">
+ MagickBooleanType MapImages(Image *images,Image *map_image,
+ const MagickBooleanType dither)
+</pre>
+
+<p>A description of each parameter follows:</p>
+
+<h5>image</h5>
+<p>Specifies a pointer to a set of Image structures.</p>
+
+<h5>map_image</h5>
+<p>the image. Reduce image to a set of colors represented by this image.</p>
+
+<h5>dither</h5>
+<p>Set this integer value to something other than zero to dither the quantized image.</p>
+
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MatteFloodfill">MatteFloodfill</a></h2>
+<div class="doc-section">
+
+<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>
+
+<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>
-<p>The format of the GetPixelViewPixels method is:</p>
+<p>The format of the MatteFloodfillImage method is:</p>
<pre class="code">
- PixelWand *GetPixelViewPixels(const PixelView *pixel_view)
+ MagickBooleanType MatteFloodfillImage(Image *image,
+ 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>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
+
+<h5>opacity</h5>
+<p>the level of transparency: 0 is fully opaque and QuantumRange is fully transparent.</p>
+
+<h5>x,y</h5>
+<p>the starting location of the operation.</p>
+
+<h5>method</h5>
+<p>Choose either FloodfillMethod or FillToBorderMethod.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewWand">GetPixelViewWand</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MaximumImages">MaximumImages</a></h2>
<div class="doc-section">
-<p>GetPixelViewWand() returns the magick wand associated with the pixel view.</p>
+<p>MaximumImages() returns the maximum intensity of an image sequence.</p>
+
+<p>Deprecated, replace with:</p>
-<p>The format of the GetPixelViewWand method is:</p>
+<pre class="text">
+ EvaluateImages(images,MinEvaluateOperator,exception);
+</pre>
+
+<p>The format of the MaxImages method is:</p>
<pre class="code">
- MagickWand *GetPixelViewWand(const PixelView *pixel_view)
+ Image *MaximumImages(Image *images,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>images</h5>
+<p>the image sequence.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewWidth">GetPixelViewWidth</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MinimumImages">MinimumImages</a></h2>
<div class="doc-section">
-<p>GetPixelViewWidth() returns the pixel view width.</p>
+<p>MinimumImages() returns the minimum intensity of an image sequence.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ EvaluateImages(images,MinEvaluateOperator,exception);
+</pre>
-<p>The format of the GetPixelViewWidth method is:</p>
+<p>The format of the MinimumImages method is:</p>
<pre class="code">
- size_t GetPixelViewWidth(const PixelView *pixel_view)
+ Image *MinimumImages(Image *images,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>images</h5>
+<p>the image sequence.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewX">GetPixelViewX</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MedianFilterImage">MedianFilterImage</a></h2>
<div class="doc-section">
-<p>GetPixelViewX() returns the pixel view x offset.</p>
+<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>
+
+<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>
-<p>The format of the GetPixelViewX method is:</p>
+<p>The format of the MedianFilterImage method is:</p>
<pre class="code">
- ssize_t GetPixelViewX(const PixelView *pixel_view)
+ Image *MedianFilterImage(const Image *image,const double radius,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>radius</h5>
+<p>the radius of the pixel neighborhood.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="GetPixelViewY">GetPixelViewY</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ModeImage">ModeImage</a></h2>
<div class="doc-section">
-<p>GetPixelViewY() returns the pixel view y offset.</p>
+<p>ModeImage() makes each pixel the 'predominate color' of the neighborhood of the specified radius.</p>
-<p>The format of the GetPixelViewY method is:</p>
+<p>The format of the ModeImage method is:</p>
<pre class="code">
- ssize_t GetPixelViewY(const PixelView *pixel_view)
+ Image *ModeImage(const Image *image,const double radius,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>radius</h5>
+<p>the radius of the pixel neighborhood.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="IsPixelView">IsPixelView</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MosaicImages">MosaicImages</a></h2>
<div class="doc-section">
-<p>IsPixelView() returns MagickTrue if the the parameter is verified as a pixel view container.</p>
+<p>MosaicImages() Obsolete Function: Use MergeImageLayers() instead.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ MergeImageLayers(image,MosaicLayer,exception);
+</pre>
-<p>The format of the IsPixelView method is:</p>
+<p>The format of the MosaicImage method is:</p>
<pre class="code">
- MagickBooleanType IsPixelView(const PixelView *pixel_view)
+ Image *MosaicImages(const Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>pixel_view</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image list to be composited together</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickClipPathImage">MagickClipPathImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="OpaqueImage">OpaqueImage</a></h2>
<div class="doc-section">
-<p>MagickClipPathImage() clips along the named paths from the 8BIM profile, if present. Later operations take effect inside the path. Id may be a number if preceded with #, to work on a numbered path, e.g., "#1" to use the first path.</p>
+<p>OpaqueImage() changes any pixel that matches color with the color defined by fill.</p>
+
+<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>
-<p>The format of the MagickClipPathImage method is:</p>
+<p>The format of the OpaqueImage method is:</p>
<pre class="code">
- MagickBooleanType MagickClipPathImage(MagickWand *wand,
- const char *pathname,const MagickBooleanType inside)
+ MagickBooleanType OpaqueImage(Image *image,
+ const PixelPacket *target,const PixelPacket fill)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>pathname</h5>
-<p>name of clipping path resource. If name is preceded by #, use clipping path numbered by name.</p>
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
-<h5>inside</h5>
-<p>if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.</p>
+<h5>fill</h5>
+<p>the replacement color.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawGetFillAlpha">DrawGetFillAlpha</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="OpenCacheView">OpenCacheView</a></h2>
<div class="doc-section">
-<p>DrawGetFillAlpha() returns the alpha used when drawing using the fill color or fill texture. Fully opaque is 1.0.</p>
+<p>OpenCacheView() opens a view into the pixel cache, using the VirtualPixelMethod that is defined within the given image itself.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AcquireCacheView(image);
+</pre>
-<p>The format of the DrawGetFillAlpha method is:</p>
+<p>The format of the OpenCacheView method is:</p>
<pre class="code">
- double DrawGetFillAlpha(const DrawingWand *wand)
+ CacheView *OpenCacheView(const Image *image)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the drawing wand.</p>
+<h5>image</h5>
+<p>the image.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawGetStrokeAlpha">DrawGetStrokeAlpha</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PaintFloodfill">PaintFloodfill</a></h2>
<div class="doc-section">
-<p>DrawGetStrokeAlpha() returns the alpha of stroked object outlines.</p>
+<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>
+
+<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>
+
+<p>Deprecated, replace with:</p>
-<p>The format of the DrawGetStrokeAlpha method is:</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">
- double DrawGetStrokeAlpha(const DrawingWand *wand)
+ MagickBooleanType PaintFloodfillImage(Image *image,
+ 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>
-<h5>wand</h5>
-<p>the drawing wand. </p>
- </div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawPeekGraphicWand">DrawPeekGraphicWand</a></h2>
-<div class="doc-section">
+<h5>image</h5>
+<p>the image.</p>
-<p>DrawPeekGraphicWand() returns the current drawing wand.</p>
+<h5>channel</h5>
+<p>the channel(s).</p>
-<p>The format of the PeekDrawingWand method is:</p>
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
-<pre class="code">
- DrawInfo *DrawPeekGraphicWand(const DrawingWand *wand)
-</pre>
+<h5>x,y</h5>
+<p>the starting location of the operation.</p>
-<p>A description of each parameter follows:</p>
+<h5>draw_info</h5>
+<p>the draw info.</p>
-<h5>wand</h5>
-<p>the drawing wand.</p>
+<h5>method</h5>
+<p>Choose either FloodfillMethod or FillToBorderMethod.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawPopGraphicContext">DrawPopGraphicContext</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PaintOpaqueImage">PaintOpaqueImage</a></h2>
<div class="doc-section">
-<p>DrawPopGraphicContext() destroys the current drawing wand and returns to the previously pushed drawing wand. Multiple drawing wands may exist. It is an error to attempt to pop more drawing wands than have been pushed, and it is proper form to pop all drawing wands which have been pushed.</p>
+<p>PaintOpaqueImage() changes any pixel that matches color with the color defined by fill.</p>
+
+<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>
+
+<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 DrawPopGraphicContext method is:</p>
+<p>The format of the PaintOpaqueImage method is:</p>
<pre class="code">
- MagickBooleanType DrawPopGraphicContext(DrawingWand *wand)
+ MagickBooleanType PaintOpaqueImage(Image *image,
+ const PixelPacket *target,const PixelPacket *fill)
+ MagickBooleanType PaintOpaqueImageChannel(Image *image,
+ const ChannelType channel,const PixelPacket *target,
+ const PixelPacket *fill)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the drawing wand.</p>
+<h5>image</h5>
+<p>the image.</p>
- </div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawPushGraphicContext">DrawPushGraphicContext</a></h2>
-<div class="doc-section">
+<h5>channel</h5>
+<p>the channel(s).</p>
-<p>DrawPushGraphicContext() clones the current drawing wand to create a new drawing wand. The original drawing wand(s) may be returned to by invoking PopDrawingWand(). The drawing wands are stored on a drawing wand stack. For every Pop there must have already been an equivalent Push.</p>
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
-<p>The format of the DrawPushGraphicContext method is:</p>
+<h5>fill</h5>
+<p>the replacement color.</p>
-<pre class="code">
- MagickBooleanType DrawPushGraphicContext(DrawingWand *wand)
-</pre>
+ </div>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PaintTransparentImage">PaintTransparentImage</a></h2>
+<div class="doc-section">
-<p>A description of each parameter follows:</p>
+<p>PaintTransparentImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p>
-<h5>wand</h5>
-<p>the drawing wand.</p>
+<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>
- </div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawSetFillAlpha">DrawSetFillAlpha</a></h2>
-<div class="doc-section">
+<p>Deprecated, replace with:</p>
-<p>DrawSetFillAlpha() sets the alpha to use when drawing using the fill color or fill texture. Fully opaque is 1.0.</p>
+<pre class="text">
+ TransparentPaintImage(image,target,opacity,MagickFalse);
+</pre>
-<p>The format of the DrawSetFillAlpha method is:</p>
+<p>The format of the PaintTransparentImage method is:</p>
<pre class="code">
- void DrawSetFillAlpha(DrawingWand *wand,const double fill_alpha)
+ MagickBooleanType PaintTransparentImage(Image *image,
+ const MagickPixelPacket *target,const Quantum opacity)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the drawing wand.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
-<h5>fill_alpha</h5>
-<p>fill alpha</p>
+<h5>opacity</h5>
+<p>the replacement opacity value.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="DrawSetStrokeAlpha">DrawSetStrokeAlpha</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ParseSizeGeometry">ParseSizeGeometry</a></h2>
<div class="doc-section">
-<p>DrawSetStrokeAlpha() specifies the alpha of stroked object outlines.</p>
+<p>ParseSizeGeometry() returns a region as defined by the geometry string with respect to the image dimensions and aspect ratio.</p>
+
+<p>Deprecated, replace with:</p>
-<p>The format of the DrawSetStrokeAlpha method is:</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">
- void DrawSetStrokeAlpha(DrawingWand *wand,const double stroke_alpha)
+ MagickStatusType ParseSizeGeometry(const Image *image,
+ const char *geometry,RectangeInfo *region_info)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the drawing wand.</p>
+<h5>geometry</h5>
+<p>The geometry (e.g. 100x100+10+10).</p>
-<h5>stroke_alpha</h5>
-<p>stroke alpha. The value 1.0 is opaque.</p>
+<h5>region_info</h5>
+<p>the region as defined by the geometry string.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickColorFloodfillImage">MagickColorFloodfillImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PopImageList">PopImageList</a></h2>
<div class="doc-section">
-<p>MagickColorFloodfillImage() 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>
+<p>PopImageList() removes the last image in the list.</p>
-<p>The format of the MagickColorFloodfillImage method is:</p>
+<p>Deprecated, replace with:</p>
-<pre class="code">
- MagickBooleanType MagickColorFloodfillImage(MagickWand *wand,
- const PixelWand *fill,const double fuzz,const PixelWand *bordercolor,
- const ssize_t x,const ssize_t y)
+<pre class="text">
+ RemoveLastImageFromList(images);
</pre>
-<p>A description of each parameter follows:</p>
-
-<h5>wand</h5>
-<p>the magick wand.</p>
-
-<h5>fill</h5>
-<p>the floodfill color pixel wand.</p>
+<p>The format of the PopImageList method is:</p>
-<h5>fuzz</h5>
-<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>
+<pre class="code">
+ Image *PopImageList(Image **images)
+</pre>
-<h5>bordercolor</h5>
-<p>the border color pixel wand.</p>
+<p>A description of each parameter follows:</p>
-<h5>x,y</h5>
-<p>the starting location of the operation.</p>
+<h5>images</h5>
+<p>the image list.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickDescribeImage">MagickDescribeImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PopImagePixels">PopImagePixels</a></h2>
<div class="doc-section">
-<p>MagickDescribeImage() identifies an image by printing its attributes to the file. Attributes include the image width, height, size, and others.</p>
+<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>
-<p>The format of the MagickDescribeImage method is:</p>
+<p>The format of the PopImagePixels method is:</p>
<pre class="code">
- const char *MagickDescribeImage(MagickWand *wand)
+ size_t PopImagePixels(Image *,const QuantumType quantum,
+ unsigned char *destination)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>quantum</h5>
+<p>Declare which pixel components to transfer (RGB, RGBA, etc).</p>
+
+<h5>destination</h5>
+<p>The components are transferred to this buffer.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickFlattenImages">MagickFlattenImages</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PostscriptGeometry">PostscriptGeometry</a></h2>
<div class="doc-section">
-<p>MagickFlattenImages() merges a sequence of images. This useful for combining Photoshop layers into a single image.</p>
+<p>PostscriptGeometry() replaces any page mneumonic with the equivalent size in picas.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ GetPageGeometry(page);
+</pre>
-<p>The format of the MagickFlattenImages method is:</p>
+<p>The format of the PostscriptGeometry method is:</p>
<pre class="code">
- MagickWand *MagickFlattenImages(MagickWand *wand)
+ char *PostscriptGeometry(const char *page)
</pre>
-<p>A description of each parameter follows:</p>
+<p>A description of each parameter follows.</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5> page</h5>
+<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>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickGetImageAttribute">MagickGetImageAttribute</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PushImageList">PushImageList</a></h2>
<div class="doc-section">
-<p>MagickGetImageAttribute() returns a value associated with the specified property. Use MagickRelinquishMemory() to free the value when you are finished with it.</p>
+<p>PushImageList() adds an image to the end of the list.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ AppendImageToList(images,CloneImageList(image,exception));
+</pre>
-<p>The format of the MagickGetImageAttribute method is:</p>
+<p>The format of the PushImageList method is:</p>
<pre class="code">
- char *MagickGetImageAttribute(MagickWand *wand,const char *property)
+ unsigned int PushImageList(Image *images,const Image *image,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>images</h5>
+<p>the image list.</p>
-<h5>property</h5>
-<p>the property.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickGetImageMatte">MagickGetImageMatte</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PushImagePixels">PushImagePixels</a></h2>
<div class="doc-section">
-<p>MagickGetImageMatte() returns MagickTrue if the image has a matte channel otherwise MagickFalse.</p>
+<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>
-<p>The format of the MagickGetImageMatte method is:</p>
+<p>The format of the PushImagePixels method is:</p>
<pre class="code">
- size_t MagickGetImageMatte(MagickWand *wand)
+ size_t PushImagePixels(Image *image,const QuantumType quantum,
+ const unsigned char *source)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>quantum</h5>
+<p>Declare which pixel components to transfer (red, green, blue, opacity, RGB, or RGBA).</p>
+
+<h5>source</h5>
+<p>The pixel components are transferred from this buffer.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickGetImagePixels">MagickGetImagePixels</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="QuantizationError">QuantizationError</a></h2>
<div class="doc-section">
-<p>MagickGetImagePixels() extracts pixel data from an image and returns it to you. The method returns MagickTrue on success otherwise MagickFalse 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>
-
-<p>Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:</p>
+<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>
<pre class="text">
- MagickGetImagePixels(wand,0,0,640,1,"RGB",CharPixel,pixels);
+ o mean_error_per_pixel: This value is the mean error for any single
+ pixel in the image.
</pre>
-<p>The format of the MagickGetImagePixels method is:</p>
+<h5>normalized_mean_square_error</h5>
+<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>
-<pre class="code">
- MagickBooleanType MagickGetImagePixels(MagickWand *wand,
- const ssize_t x,const ssize_t y,const size_t columns,
- const size_t rows,const char *map,const StorageType storage,
- void *pixels)
-</pre>
+<h5>normalized_maximum_square_error</h5>
+<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>
-<p>A description of each parameter follows:</p>
+<p>Deprecated, replace with:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<pre class="text">
+ GetImageQuantizeError(image);
+</pre>
-<h5>x, y, columns, rows</h5>
-<p>These values define the perimeter of a region of pixels you want to extract.</p>
+<p>The format of the QuantizationError method is:</p>
-<h5>map</h5>
-<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 (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.</p>
+<pre class="code">
+ unsigned int QuantizationError(Image *image)
+</pre>
-<h5>storage</h5>
-<p>Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, DoublePixel, FloatPixel, IntegerPixel, LongPixel, QuantumPixel, or ShortPixel.</p>
+<p>A description of each parameter follows.</p>
-<h5>pixels</h5>
-<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>
+<h5>image</h5>
+<p>Specifies a pointer to an Image structure; returned from ReadImage.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickGetImageSize">MagickGetImageSize</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="RandomChannelThresholdImage">RandomChannelThresholdImage</a></h2>
<div class="doc-section">
-<p>MagickGetImageSize() returns the image length in bytes.</p>
+<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>
-<p>The format of the MagickGetImageSize method is:</p>
+<p>The format of the RandomChannelThresholdImage method is:</p>
<pre class="code">
- MagickBooleanType MagickGetImageSize(MagickWand *wand,
- MagickSizeType *length)
+ unsigned int RandomChannelThresholdImage(Image *image,
+ const char *channel, const char *thresholds,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>length</h5>
-<p>the image length in bytes.</p>
+<h5>channel</h5>
+<p>the channel or channels to be thresholded.</p>
+
+<h5>thresholds</h5>
+<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>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMapImage">MagickMapImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ReacquireMemory">ReacquireMemory</a></h2>
<div class="doc-section">
-<p>MagickMapImage() replaces the colors of an image with the closest color from a reference image.</p>
+<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>
-<p>The format of the MagickMapImage method is:</p>
+<p>The format of the ReacquireMemory method is:</p>
<pre class="code">
- MagickBooleanType MagickMapImage(MagickWand *wand,
- const MagickWand *map_wand,const MagickBooleanType dither)
+ void ReacquireMemory(void **memory,const size_t size)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>memory</h5>
+<p>A pointer to a memory allocation. On return the pointer may change but the contents of the original allocation will not.</p>
-<h5>map</h5>
-<p>the map wand.</p>
-
-<h5>dither</h5>
-<p>Set this integer value to something other than zero to dither the mapped image.</p>
+<h5>size</h5>
+<p>the new size of the allocated memory.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMatteFloodfillImage">MagickMatteFloodfillImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="RecolorImage">RecolorImage</a></h2>
<div class="doc-section">
-<p>MagickMatteFloodfillImage() 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>
+<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>
-<p>The format of the MagickMatteFloodfillImage method is:</p>
+<p>The format of the RecolorImage method is:</p>
<pre class="code">
- MagickBooleanType MagickMatteFloodfillImage(MagickWand *wand,
- const double alpha,const double fuzz,const PixelWand *bordercolor,
- const ssize_t x,const ssize_t y)
+ Image *RecolorImage(const Image *image,const size_t order,
+ const double *color_matrix,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>alpha</h5>
-<p>the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent.</p>
-
-<h5>fuzz</h5>
-<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>
+<h5>order</h5>
+<p>the number of columns and rows in the recolor matrix.</p>
-<h5>bordercolor</h5>
-<p>the border color pixel wand.</p>
+<h5>color_matrix</h5>
+<p>An array of double representing the recolor matrix.</p>
-<h5>x,y</h5>
-<p>the starting location of the operation.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMedianFilterImage">MagickMedianFilterImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ReduceNoiseImage">ReduceNoiseImage</a></h2>
<div class="doc-section">
-<p>MagickMedianFilterImage() 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>
+<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>
-<p>The format of the MagickMedianFilterImage method is:</p>
+<p>The format of the ReduceNoiseImage method is:</p>
<pre class="code">
- MagickBooleanType MagickMedianFilterImage(MagickWand *wand,
- const double radius)
+ Image *ReduceNoiseImage(const Image *image,const double radius,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
<h5>radius</h5>
<p>the radius of the pixel neighborhood.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
+
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMinimumImages">MagickMinimumImages</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ResetImageAttributeIterator">ResetImageAttributeIterator</a></h2>
<div class="doc-section">
-<p>MagickMinimumImages() returns the minimum intensity of an image sequence.</p>
+<p>ResetImageAttributeIterator() resets the image attributes iterator. Use it in conjunction with GetNextImageAttribute() to iterate over all the values associated with an image.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ ResetImagePropertyIterator(image);
+</pre>
-<p>The format of the MagickMinimumImages method is:</p>
+<p>The format of the ResetImageAttributeIterator method is:</p>
<pre class="code">
- MagickWand *MagickMinimumImages(MagickWand *wand)
+ ResetImageAttributeIterator(const ImageInfo *image)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickModeImage">MagickModeImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetCacheViewPixels">SetCacheViewPixels</a></h2>
<div class="doc-section">
-<p>MagickModeImage() makes each pixel the 'predominate color' of the neighborhood of the specified radius.</p>
+<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>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ QueueCacheViewAuthenticPixels(cache_view,x,y,columns,rows,
+ GetCacheViewException(cache_view));
+</pre>
-<p>The format of the MagickModeImage method is:</p>
+<p>The format of the SetCacheViewPixels method is:</p>
<pre class="code">
- MagickBooleanType MagickModeImage(MagickWand *wand,
- const double radius)
+ 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>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>cache_view</h5>
+<p>the cache view.</p>
-<h5>radius</h5>
-<p>the radius of the pixel neighborhood.</p>
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMosaicImages">MagickMosaicImages</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetExceptionInfo">SetExceptionInfo</a></h2>
<div class="doc-section">
-<p>MagickMosaicImages() inlays an image sequence to form a single coherent picture. It returns a wand with each image in the sequence composited at the location defined by the page offset of the image.</p>
+<p>SetExceptionInfo() sets the exception severity.</p>
-<p>The format of the MagickMosaicImages method is:</p>
+<p>The format of the SetExceptionInfo method is:</p>
<pre class="code">
- MagickWand *MagickMosaicImages(MagickWand *wand)
+ MagickBooleanType SetExceptionInfo(ExceptionInfo *exception,
+ ExceptionType severity)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>exception</h5>
+<p>the exception info.</p>
+
+<h5>severity</h5>
+<p>the exception severity.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickOpaqueImage">MagickOpaqueImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImage">SetImage</a></h2>
<div class="doc-section">
-<p>MagickOpaqueImage() changes any pixel that matches color with the color defined by fill.</p>
+<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>
-<p>The format of the MagickOpaqueImage method is:</p>
+<p>The format of the SetImage method is:</p>
<pre class="code">
- MagickBooleanType MagickOpaqueImage(MagickWand *wand,
- const PixelWand *target,const PixelWand *fill,const double fuzz)
+ void SetImage(Image *image,const Quantum opacity)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
-
-<h5>channel</h5>
-<p>the channel(s).</p>
-
-<h5>target</h5>
-<p>Change this target color to the fill color within the image.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>fill</h5>
-<p>the fill pixel wand.</p>
-
-<h5>fuzz</h5>
-<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>
+<h5>opacity</h5>
+<p>Set each pixel to this level of transparency.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickPaintFloodfillImage">MagickPaintFloodfillImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImageAttribute">SetImageAttribute</a></h2>
<div class="doc-section">
-<p>MagickPaintFloodfillImage() 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>
+<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>
-<p>The format of the MagickPaintFloodfillImage method is:</p>
+<p>Deprecated, replace with:</p>
-<pre class="code">
- MagickBooleanType MagickPaintFloodfillImage(MagickWand *wand,
- const ChannelType channel,const PixelWand *fill,const double fuzz,
- const PixelWand *bordercolor,const ssize_t x,const ssize_t y)
+<pre class="text">
+ SetImageProperty(image,key,value);
</pre>
-<p>A description of each parameter follows:</p>
-
-<h5>wand</h5>
-<p>the magick wand.</p>
+<p>The format of the SetImageAttribute method is:</p>
-<h5>channel</h5>
-<p>the channel(s).</p>
+<pre class="code">
+ MagickBooleanType SetImageAttribute(Image *image,const char *key,
+ const char *value)
+</pre>
-<h5>fill</h5>
-<p>the floodfill color pixel wand.</p>
+<p>A description of each parameter follows:</p>
-<h5>fuzz</h5>
-<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>
+<h5>image</h5>
+<p>the image.</p>
-<h5>bordercolor</h5>
-<p>the border color pixel wand.</p>
+<h5>key</h5>
+<p>the key.</p>
-<h5>x,y</h5>
-<p>the starting location of the operation.</p>
+<h5>value</h5>
+<p>the value.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickPaintOpaqueImage">MagickPaintOpaqueImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImageList">SetImageList</a></h2>
<div class="doc-section">
-<p>MagickPaintOpaqueImage() changes any pixel that matches color with the color defined by fill.</p>
+<p>SetImageList() inserts an image into the list at the specified position.</p>
-<p>The format of the MagickPaintOpaqueImage method is:</p>
+<p>The format of the SetImageList method is:</p>
<pre class="code">
- MagickBooleanType MagickPaintOpaqueImage(MagickWand *wand,
- const PixelWand *target,const PixelWand *fill,const double fuzz)
- MagickBooleanType MagickPaintOpaqueImageChannel(MagickWand *wand,
- const ChannelType channel,const PixelWand *target,
- const PixelWand *fill,const double fuzz)
+ unsigned int SetImageList(Image *images,const Image *image,
+ const ssize_t offset,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>images</h5>
+<p>the image list.</p>
-<h5>channel</h5>
-<p>the channel(s).</p>
-
-<h5>target</h5>
-<p>Change this target color to the fill color within the image.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>fill</h5>
-<p>the fill pixel wand.</p>
+<h5>offset</h5>
+<p>the position within the list.</p>
-<h5>fuzz</h5>
-<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>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickPaintTransparentImage">MagickPaintTransparentImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetImagePixels">SetImagePixels</a></h2>
<div class="doc-section">
-<p>MagickPaintTransparentImage() changes any pixel that matches color with the color defined by fill.</p>
+<p>SetImagePixels() queues a mutable pixel region. If the region is successfully intialized a pointer to a PixelPacket array representing the region is returned, otherwise NULL is returned. The returned pointer may point to a temporary working buffer for the pixels or it may point to the final location of the pixels in memory.</p>
+
+<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>
+
+<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>
+
+<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>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ QueueAuthenticPixels(image,x,y,columns,rows,&image->exception);
+</pre>
-<p>The format of the MagickPaintTransparentImage method is:</p>
+<p>The format of the SetImagePixels() method is:</p>
<pre class="code">
- MagickBooleanType MagickPaintTransparentImage(MagickWand *wand,
- const PixelWand *target,const double alpha,const double fuzz)
+ 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>
-<h5>wand</h5>
-<p>the magick wand.</p>
-
-<h5>target</h5>
-<p>Change this target color to specified opacity value within the image.</p>
+<h5>pixels</h5>
+<p>SetImagePixels returns a pointer to the pixels if they are transferred, otherwise a NULL is returned.</p>
-<h5>alpha</h5>
-<p>the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>fuzz</h5>
-<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>
+<h5>x,y,columns,rows</h5>
+<p>These values define the perimeter of a region of pixels.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickRecolorImage">MagickRecolorImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetMagickRegistry">SetMagickRegistry</a></h2>
<div class="doc-section">
-<p>MagickRecolorImage() 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>
+<p>SetMagickRegistry() sets a blob into the registry and returns a unique ID. If an error occurs, -1 is returned.</p>
-<p>The format of the MagickRecolorImage method is:</p>
+<p>The format of the SetMagickRegistry method is:</p>
<pre class="code">
- MagickBooleanType MagickRecolorImage(MagickWand *wand,
- const size_t order,const double *color_matrix)
+ ssize_t SetMagickRegistry(const RegistryType type,const void *blob,
+ const size_t length,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>type</h5>
+<p>the registry type.</p>
-<h5>order</h5>
-<p>the number of columns and rows in the color matrix.</p>
+<h5>blob</h5>
+<p>the address of a Binary Large OBject.</p>
-<h5>color_matrix</h5>
-<p>An array of doubles representing the color matrix.</p>
+<h5>length</h5>
+<p>For a registry type of ImageRegistryType use sizeof(Image) otherise the blob length in number of bytes.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickReduceNoiseImage">MagickReduceNoiseImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetMonitorHandler">SetMonitorHandler</a></h2>
<div class="doc-section">
-<p>MagickReduceNoiseImage() 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>
+<p>SetMonitorHandler() sets the monitor handler to the specified method and returns the previous monitor handler.</p>
-<p>The format of the MagickReduceNoiseImage method is:</p>
+<p>The format of the SetMonitorHandler method is:</p>
<pre class="code">
- MagickBooleanType MagickReduceNoiseImage(MagickWand *wand,
- const double radius)
+ MonitorHandler SetMonitorHandler(MonitorHandler handler)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
-
-<h5>radius</h5>
-<p>the radius of the pixel neighborhood.</p>
+<h5>handler</h5>
+<p>Specifies a pointer to a method to handle monitors.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickMaximumImages">MagickMaximumImages</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ShiftImageList">ShiftImageList</a></h2>
<div class="doc-section">
-<p>MagickMaximumImages() returns the maximum intensity of an image sequence.</p>
+<p>ShiftImageList() removes an image from the beginning of the list.</p>
+
+<p>Deprecated, replace with:</p>
-<p>The format of the MagickMaximumImages method is:</p>
+<pre class="text">
+ RemoveFirstImageFromList(images);
+</pre>
+
+<p>The format of the ShiftImageList method is:</p>
<pre class="code">
- MagickWand *MagickMaximumImages(MagickWand *wand)
+ Image *ShiftImageList(Image **images)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>images</h5>
+<p>the image list.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickSetImageAttribute">MagickSetImageAttribute</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SpliceImageList">SpliceImageList</a></h2>
<div class="doc-section">
-<p>MagickSetImageAttribute() associates a property with an image.</p>
+<p>SpliceImageList() removes the images designated by offset and length from the list and replaces them with the specified list.</p>
-<p>The format of the MagickSetImageAttribute method is:</p>
+<p>The format of the SpliceImageList method is:</p>
<pre class="code">
- MagickBooleanType MagickSetImageAttribute(MagickWand *wand,
- const char *property,const char *value)
+ Image *SpliceImageList(Image *images,const ssize_t offset,
+ const size_t length,const Image *splices,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>images</h5>
+<p>the image list.</p>
-<h5>property</h5>
-<p>the property.</p>
+<h5>offset</h5>
+<p>the position within the list.</p>
-<h5>value</h5>
-<p>the value.</p>
+<h5>length</h5>
+<p>the length of the image list to remove.</p>
+
+<h5>splice</h5>
+<p>Replace the removed image list with this list.</p>
+
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickSetImageIndex">MagickSetImageIndex</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="Strip">Strip</a></h2>
<div class="doc-section">
-<p>MagickSetImageIndex() set the current image to the position of the list specified with the index parameter.</p>
+<p>Strip() strips any whitespace or quotes from the beginning and end of a string of characters.</p>
-<p>The format of the MagickSetImageIndex method is:</p>
+<p>The format of the Strip method is:</p>
<pre class="code">
- MagickBooleanType MagickSetImageIndex(MagickWand *wand,
- const ssize_t index)
+ void Strip(char *message)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
-
-<h5>index</h5>
-<p>the scene number.</p>
+<h5>message</h5>
+<p>Specifies an array of characters.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickTransparentImage">MagickTransparentImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SyncCacheView">SyncCacheView</a></h2>
<div class="doc-section">
-<p>MagickTransparentImage() changes any pixel that matches color with the color defined by fill.</p>
+<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>
-<p>The format of the MagickTransparentImage method is:</p>
+<p>Deprecated, replace with:</p>
-<pre class="code">
- MagickBooleanType MagickTransparentImage(MagickWand *wand,
- const PixelWand *target,const double alpha,const double fuzz)
+<pre class="text">
+ SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view));
</pre>
-<p>A description of each parameter follows:</p>
-
-<h5>wand</h5>
-<p>the magick wand.</p>
+<p>The format of the SyncCacheView method is:</p>
-<h5>target</h5>
-<p>Change this target color to specified opacity value within the image.</p>
+<pre class="code">
+ MagickBooleanType SyncCacheView(CacheView *cache_view)
+</pre>
-<h5>alpha</h5>
-<p>the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent.</p>
+<p>A description of each parameter follows:</p>
-<h5>fuzz</h5>
-<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>
+<h5>cache_view</h5>
+<p>the cache view.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickRegionOfInterestImage">MagickRegionOfInterestImage</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SyncCacheViewPixels">SyncCacheViewPixels</a></h2>
<div class="doc-section">
-<p>MagickRegionOfInterestImage() extracts a region of the image and returns it as a new wand.</p>
+<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>
-<p>The format of the MagickRegionOfInterestImage method is:</p>
+<p>Deprecated, replace with:</p>
-<pre class="code">
- MagickWand *MagickRegionOfInterestImage(MagickWand *wand,
- const size_t width,const size_t height,const ssize_t x,
- const ssize_t y)
+<pre class="text">
+ SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view));
</pre>
-<p>A description of each parameter follows:</p>
-
-<h5>wand</h5>
-<p>the magick wand.</p>
+<p>The format of the SyncCacheViewPixels method is:</p>
-<h5>width</h5>
-<p>the region width.</p>
+<pre class="code">
+ MagickBooleanType SyncCacheViewPixels(CacheView *cache_view)
+</pre>
-<h5>height</h5>
-<p>the region height.</p>
+<p>A description of each parameter follows:</p>
-<h5>x</h5>
-<p>the region x offset.</p>
+<h5>cache_view</h5>
+<p>the cache view.</p>
-<h5>y</h5>
-<p>the region y offset.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickSetImagePixels">MagickSetImagePixels</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SyncImagePixels">SyncImagePixels</a></h2>
<div class="doc-section">
-<p>MagickSetImagePixels() accepts pixel datand stores it in the image at the location you specify. The method returns MagickFalse on success otherwise MagickTrue if an error is encountered. The pixel data can be either char, short int, int, ssize_t, float, or double in the order specified by map.</p>
+<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>
-<p>Suppose your want to upload the first scanline of a 640x480 image from character data in red-green-blue order:</p>
+<p>Deprecated, replace with:</p>
<pre class="text">
- MagickSetImagePixels(wand,0,0,640,1,"RGB",CharPixel,pixels);
+ SyncAuthenticPixels(image,&image->exception);
</pre>
-<p>The format of the MagickSetImagePixels method is:</p>
+<p>The format of the SyncImagePixels() method is:</p>
<pre class="code">
- MagickBooleanType MagickSetImagePixels(MagickWand *wand,
- const ssize_t x,const ssize_t y,const size_t columns,
- const size_t rows,const char *map,const StorageType storage,
- const void *pixels)
+ MagickBooleanType SyncImagePixels(Image *image)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
-
-<h5>x, y, columns, rows</h5>
-<p>These values define the perimeter of a region of pixels you want to define.</p>
-
-<h5>map</h5>
-<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 (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.</p>
-
-<h5>storage</h5>
-<p>Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, ShortPixel, IntegerPixel, LongPixel, FloatPixel, or DoublePixel.</p>
-
-<h5>pixels</h5>
-<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>
+<h5>image</h5>
+<p>the image.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="MagickWriteImageBlob">MagickWriteImageBlob</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TemporaryFilename">TemporaryFilename</a></h2>
<div class="doc-section">
-<p>MagickWriteImageBlob() implements direct to memory image formats. It returns the image as a blob and its length. Use MagickSetFormat() to set the format of the returned blob (GIF, JPEG, PNG, etc.).</p>
+<p>TemporaryFilename() replaces the contents of path by a unique path name.</p>
-<p>Use MagickRelinquishMemory() to free the blob when you are done with it.</p>
-
-<p>The format of the MagickWriteImageBlob method is:</p>
+<p>The format of the TemporaryFilename method is:</p>
<pre class="code">
- unsigned char *MagickWriteImageBlob(MagickWand *wand,size_t *length)
+ void TemporaryFilename(char *path)
</pre>
-<p>A description of each parameter follows:</p>
-
-<h5>wand</h5>
-<p>the magick wand.</p>
+<p>A description of each parameter follows.</p>
-<h5>length</h5>
-<p>the length of the blob.</p>
+<h5> path</h5>
+<p>Specifies a pointer to an array of characters. The unique path name is returned in this array.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="NewPixelView">NewPixelView</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ThresholdImage">ThresholdImage</a></h2>
<div class="doc-section">
-<p>NewPixelView() returns a pixel view required for all other methods in the Pixel View API.</p>
+<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>
-<p>The format of the NewPixelView method is:</p>
+<p>The format of the ThresholdImage method is:</p>
<pre class="code">
- PixelView *NewPixelView(MagickWand *wand)
+ unsigned int ThresholdImage(Image *image,const double threshold)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the wand.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>threshold</h5>
+<p>Define the threshold value</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="NewPixelViewRegion">NewPixelViewRegion</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ThresholdImageChannel">ThresholdImageChannel</a></h2>
<div class="doc-section">
-<p>NewPixelViewRegion() returns a pixel view required for all other methods in the Pixel View API.</p>
+<p>ThresholdImageChannel() changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.</p>
-<p>The format of the NewPixelViewRegion method is:</p>
+<p>The format of the ThresholdImageChannel method is:</p>
<pre class="code">
- PixelView *NewPixelViewRegion(MagickWand *wand,const ssize_t x,
- const ssize_t y,const size_t width,const size_t height)
+ unsigned int ThresholdImageChannel(Image *image,const char *threshold)
</pre>
<p>A description of each parameter follows:</p>
-<h5>wand</h5>
-<p>the magick wand.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>x,y,columns,rows</h5>
-<p>These values define the perimeter of a region of pixel_wands view.</p>
+<h5>threshold</h5>
+<p>define the threshold values.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PixelGetNextRow">PixelGetNextRow</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TransformHSL">TransformHSL</a></h2>
<div class="doc-section">
-<p>PixelGetNextRow() returns the next row as an array of pixel wands from the pixel iterator.</p>
+<p>TransformHSL() converts a (red, green, blue) to a (hue, saturation, lightness) triple.</p>
-<p>The format of the PixelGetNextRow method is:</p>
+<p>The format of the TransformHSL method is:</p>
<pre class="code">
- PixelWand **PixelGetNextRow(PixelIterator *iterator,
- size_t *number_wands)
+ void TransformHSL(const Quantum red,const Quantum green,
+ const Quantum blue,double *hue,double *saturation,double *lightness)
</pre>
<p>A description of each parameter follows:</p>
-<h5>iterator</h5>
-<p>the pixel iterator.</p>
+<h5>red, green, blue</h5>
+<p>A Quantum value representing the red, green, and blue component of a pixel..</p>
-<h5>number_wands</h5>
-<p>the number of pixel wands.</p>
+<h5>hue, saturation, lightness</h5>
+<p>A pointer to a double value representing a component of the HSL color space.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="PixelIteratorGetException">PixelIteratorGetException</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TranslateText">TranslateText</a></h2>
<div class="doc-section">
-<p>PixelIteratorGetException() returns the severity, reason, and description of any error that occurs when using other methods in this API.</p>
+<p>TranslateText() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.</p>
+
+<p>Deprecated, replace with:</p>
+
+<pre class="text">
+ InterpretImageProperties(image_info,image,embed_text);
+</pre>
-<p>The format of the PixelIteratorGetException method is:</p>
+<p>The format of the TranslateText method is:</p>
<pre class="code">
- char *PixelIteratorGetException(const Pixeliterator *iterator,
- ExceptionType *severity)
+ char *TranslateText(const ImageInfo *image_info,Image *image,
+ const char *embed_text)
</pre>
<p>A description of each parameter follows:</p>
-<h5>iterator</h5>
-<p>the pixel iterator.</p>
+<h5>image_info</h5>
+<p>the image info.</p>
-<h5>severity</h5>
-<p>the severity of the error is returned here.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>embed_text</h5>
+<p>the address of a character string containing the embedded formatting characters.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="SetPixelViewIterator">SetPixelViewIterator</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TransparentImage">TransparentImage</a></h2>
<div class="doc-section">
-<p>SetPixelViewIterator() iterates over the pixel view in parallel and calls your set method for each scanline of the view. The pixel region is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension. The pixels are initiallly undefined and any settings you make in the callback method are automagically synced back to your image.</p>
+<p>TransparentImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p>
-<p>Use this pragma:</p>
+<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>
-<pre class="text">
- #pragma omp critical
-</pre>
-
-<p>to define a section of code in your callback set method that must be executed by a single thread at a time.</p>
-
-<p>The format of the SetPixelViewIterator method is:</p>
+<p>The format of the TransparentImage method is:</p>
<pre class="code">
- MagickBooleanType SetPixelViewIterator(PixelView *destination,
- SetPixelViewMethod set,void *context)
+ MagickBooleanType TransparentImage(Image *image,
+ const PixelPacket target,const Quantum opacity)
</pre>
<p>A description of each parameter follows:</p>
-<h5>destination</h5>
-<p>the pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>set</h5>
-<p>the set callback method.</p>
+<h5>target</h5>
+<p>the RGB value of the target color.</p>
-<h5>context</h5>
-<p>the user defined context.</p>
+<h5>opacity</h5>
+<p>the replacement opacity value.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="TransferPixelViewIterator">TransferPixelViewIterator</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="UnshiftImageList">UnshiftImageList</a></h2>
<div class="doc-section">
-<p>TransferPixelViewIterator() iterates over two pixel views in parallel and calls your transfer method for each scanline of the view. The source pixel region is not confined to the image canvas-- that is you can include negative offsets or widths or heights that exceed the image dimension. However, the destination pixel view is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension are permitted.</p>
+<p>UnshiftImageList() adds the image to the beginning of the list.</p>
-<p>Use this pragma:</p>
+<p>Deprecated, replace with:</p>
<pre class="text">
- #pragma omp critical
+ PrependImageToList(images,CloneImageList(image,exception));
</pre>
-<p>to define a section of code in your callback transfer method that must be executed by a single thread at a time.</p>
-
-<p>The format of the TransferPixelViewIterator method is:</p>
+<p>The format of the UnshiftImageList method is:</p>
<pre class="code">
- MagickBooleanType TransferPixelViewIterator(PixelView *source,
- PixelView *destination,TransferPixelViewMethod transfer,void *context)
+ unsigned int UnshiftImageList(Image *images,const Image *image,
+ ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>source</h5>
-<p>the source pixel view.</p>
-
-<h5>destination</h5>
-<p>the destination pixel view.</p>
+<h5>images</h5>
+<p>the image list.</p>
-<h5>transfer</h5>
-<p>the transfer callback method.</p>
+<h5>image</h5>
+<p>the image.</p>
-<h5>context</h5>
-<p>the user defined context.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
-<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="UpdatePixelViewIterator">UpdatePixelViewIterator</a></h2>
+<h2><a href="http://www.imagemagick.org/api/MagickCore/deprecate_8c.html" id="ZoomImage">ZoomImage</a></h2>
<div class="doc-section">
-<p>UpdatePixelViewIterator() iterates over the pixel view in parallel and calls your update method for each scanline of the view. The pixel region is confined to the image canvas-- that is no negative offsets or widths or heights that exceed the image dimension are permitted. Updates to pixels in your callback are automagically synced back to the image.</p>
-
-<p>Use this pragma:</p>
-
-<pre class="text">
- #pragma omp critical
-</pre>
+<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>
-<p>to define a section of code in your callback update method that must be executed by a single thread at a time.</p>
+<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>
-<p>The format of the UpdatePixelViewIterator method is:</p>
+<p>The format of the ZoomImage method is:</p>
<pre class="code">
- MagickBooleanType UpdatePixelViewIterator(PixelView *source,
- UpdatePixelViewMethod update,void *context)
+ Image *ZoomImage(const Image *image,const size_t columns,
+ const size_t rows,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p>
-<h5>source</h5>
-<p>the source pixel view.</p>
+<h5>image</h5>
+<p>the image.</p>
+
+<h5>columns</h5>
+<p>An integer that specifies the number of columns in the zoom image.</p>
-<h5>update</h5>
-<p>the update callback method.</p>
+<h5>rows</h5>
+<p>An integer that specifies the number of rows in the scaled image.</p>
-<h5>context</h5>
-<p>the user defined context.</p>
+<h5>exception</h5>
+<p>return any errors or warnings in this structure.</p>
</div>
\r
projects / imagemagick / commitdiff