AcquireCacheViewIndexes
@@ -163,6 +160,12 @@ _8c.html" target="source" name="AcquireCacheViewIndexes">AcquireCacheViewIndexesAcquireCacheViewIndexes() returns the indexes associated with the specified view.
+Deprecated, replace with:
+ ++ GetCacheViewVirtualIndexQueue(cache_view); ++
The format of the AcquireCacheViewIndexes method is:
@@ -181,12 +184,18 @@ _8c.html" target="source" name="AcquireCacheViewPixels">AcquireCacheViewPixelsAcquireCacheViewPixels() 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. +Deprecated, replace with:
+ ++ GetCacheViewVirtualPixels(cache_view,x,y,columns,rows,exception); ++The format of the AcquireCacheViewPixels method is:
const PixelPacket *AcquireCacheViewPixels(const CacheView *cache_view, - const long x,const long y,const unsigned long columns, - const unsigned long rows,ExceptionInfo *exception) + const ssize_t x,const ssize_t y,const size_t columns, + const size_t rows,ExceptionInfo *exception)A description of each parameter follows:
@@ -213,11 +222,17 @@ _8c.html" target="source" name="AcquireImagePixels">AcquireImagePixelsNote, the AcquireImagePixels() and GetAuthenticPixels() methods are not thread-safe. In a threaded environment, use GetCacheViewVirtualPixels() or GetCacheViewAuthenticPixels() instead.
+Deprecated, replace with:
+ ++ GetVirtualPixels(image,x,y,columns,rows,exception); ++The format of the AcquireImagePixels() method is:
- const PixelPacket *AcquireImagePixels(const Image *image,const long x, - const long y,const unsigned long columns,const unsigned long rows, + const PixelPacket *AcquireImagePixels(const Image *image,const ssize_t x, + const ssize_t y,const size_t columns,const size_t rows, ExceptionInfo *exception)@@ -237,7 +252,13 @@ _8c.html" target="source" name="AcquireImagePixels">AcquireImagePixels _8c.html" target="source" name="AcquireIndexes">AcquireIndexes-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.
+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.
+ +Deprecated, replace with:
+ ++ GetVirtualIndexQueue(image); +The format of the AcquireIndexes() method is:
@@ -278,11 +299,17 @@ _8c.html" target="source" name="AcquireOneCacheViewPixel">AcquireOneCacheViewPixAcquireOneCacheViewPixel() 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.
+Deprecated, replace with:
+ ++ GetOneCacheViewVirtualPixel(cache_view,x,y,pixel,exception); ++The format of the AcquireOneCacheViewPixel method is:
MagickBooleanType AcquireOneCacheViewPixel(const CacheView *cache_view, - const long x,const long y,PixelPacket *pixel,ExceptionInfo *exception) + const ssize_t x,const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)A description of each parameter follows:
@@ -306,13 +333,20 @@ _8c.html" target="source" name="AcquireOneCacheViewVirtualPixel">AcquireOneCacheAcquireOneCacheViewVirtualPixel() 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.
+Deprecated, replace with:
+ ++ GetOneCacheViewVirtualMethodPixel(cache_view,virtual_pixel_method, + x,y,pixel,exception); ++The format of the AcquireOneCacheViewPixel method is:
MagickBooleanType AcquireOneCacheViewVirtualPixel( const CacheView *cache_view, - const VirtualPixelMethod virtual_pixel_method,const long x, - const long y,PixelPacket *pixel,ExceptionInfo *exception) + const VirtualPixelMethod virtual_pixel_method,const ssize_t x, + const ssize_t y,PixelPacket *pixel,ExceptionInfo *exception)A description of each parameter follows:
@@ -339,11 +373,18 @@ _8c.html" target="source" name="AcquireOneMagickPixel">AcquireOneMagickPixelAcquireOneMagickPixel() 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.
+Deprecated, replace with:
+ ++ MagickPixelPacket pixel; + GetOneVirtualMagickPixel(image,x,y,&pixel,exception); ++The format of the AcquireOneMagickPixel() method is:
- MagickPixelPacket AcquireOneMagickPixel(const Image image,const long x, - const long y,ExceptionInfo exception) + MagickPixelPacket AcquireOneMagickPixel(const Image image,const ssize_t x, + const ssize_t y,ExceptionInfo exception)A description of each parameter follows:
@@ -364,11 +405,18 @@ _8c.html" target="source" name="AcquireOnePixel">AcquireOnePixelAcquireOnePixel() 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.
+Deprecated, replace with:
+ ++ PixelPacket pixel; + GetOneVirtualPixel(image,x,y,&pixel,exception); ++The format of the AcquireOnePixel() method is:
- PixelPacket AcquireOnePixel(const Image image,const long x, - const long y,ExceptionInfo exception) + PixelPacket AcquireOnePixel(const Image image,const ssize_t x, + const ssize_t y,ExceptionInfo exception)A description of each parameter follows:
@@ -389,12 +437,19 @@ _8c.html" target="source" name="AcquireOneVirtualPixel">AcquireOneVirtualPixelAcquireOneVirtualPixel() 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. +Deprecated, replace with:
+ ++ PixelPacket pixel; + GetOneVirtualMethodPixel(image,virtual_pixel_method,x,y,&pixel,exception); ++The format of the AcquireOneVirtualPixel() method is:
PixelPacket AcquireOneVirtualPixel(const Image image, - const VirtualPixelMethod virtual_pixel_method,const long x, - const long y,ExceptionInfo exception) + const VirtualPixelMethod virtual_pixel_method,const ssize_t x, + const ssize_t y,ExceptionInfo exception)A description of each parameter follows:
@@ -418,6 +473,12 @@ _8c.html" target="source" name="AcquirePixels">AcquirePixelsAcquirePixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetVirtualPixels().
+Deprecated, replace with:
+ ++ GetVirtualPixelQueue(image); ++The format of the AcquirePixels() method is:
@@ -436,6 +497,12 @@ _8c.html" target="source" name="AffinityImage">AffinityImageAffinityImage() replaces the colors of an image with the closest color from a reference image.
+Deprecated, replace with:
+ ++ RemapImage(quantize_info,image,affinity_image); ++The format of the AffinityImage method is:
@@ -461,6 +528,12 @@ _8c.html" target="source" name="AffinityImages">AffinityImagesAffinityImages() replaces the colors of a sequence of images with the closest color from a reference image.
+Deprecated, replace with:
+ ++ RemapImages(quantize_info,images,affinity_image); ++The format of the AffinityImage method is:
@@ -486,6 +559,12 @@ _8c.html" target="source" name="AllocateImage">AllocateImageAllocateImage() returns a pointer to an image structure initialized to default values.
+Deprecated, replace with:
+ ++ AcquireImage(image_info); ++The format of the AllocateImage method is:
@@ -504,11 +583,17 @@ _8c.html" target="source" name="AllocateImageColormap">AllocateImageColormapAllocateImageColormap() 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.
+Deprecated, replace with:
+ ++ AcquireImageColormap(image,colors); ++The format of the AllocateImageColormap method is:
MagickBooleanType AllocateImageColormap(Image *image, - const unsigned long colors) + const size_t colors)A description of each parameter follows:
@@ -526,6 +611,12 @@ _8c.html" target="source" name="AllocateNextImage">AllocateNextImageAllocateNextImage() 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.
+Deprecated, replace with:
+ ++ AcquireNextImage(image_info,image); ++The format of the AllocateNextImage method is:
@@ -565,6 +656,12 @@ _8c.html" target="source" name="AverageImages">AverageImagesAverageImages() 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.
+Deprecated, replace with:
+ ++ EvaluateImages(images,MeanEvaluateOperator,exception); ++The format of the AverageImages method is:
@@ -607,6 +704,12 @@ _8c.html" target="source" name="ClipPathImage">ClipPathImageClipPathImage() sets the image clip mask based any clipping path information if it exists.
+Deprecated, replace with:
+ ++ ClipImagePath(image,pathname,inside); ++The format of the ClipImage method is:
@@ -632,6 +735,12 @@ _8c.html" target="source" name="CloneImageAttributes">CloneImageAttributesCloneImageAttributes() clones one or more image attributes. +Deprecated, replace with:
+ ++ CloneImageProperties(image,clone_image); ++The format of the CloneImageAttributes method is:
@@ -679,6 +788,12 @@ _8c.html" target="source" name="CloseCacheView">CloseCacheViewCloseCacheView() closes the specified view returned by a previous call to OpenCacheView().
+Deprecated, replace with:
+ ++ DestroyCacheView(view_info); ++The format of the CloseCacheView method is:
@@ -704,7 +819,7 @@ _8c.html" target="source" name="ColorFloodfill">ColorFloodfillMagickBooleanType ColorFloodfillImage(Image *image, const DrawInfo *draw_info,const PixelPacket target, - const long x_offset,const long y_offset,const PaintMethod method) + const ssize_t x_offset,const ssize_t y_offset,const PaintMethod method)A description of each parameter follows:
@@ -731,6 +846,12 @@ _8c.html" target="source" name="DeleteImageAttribute">DeleteImageAttributeDeleteImageAttribute() deletes an attribute from the image. +Deprecated, replace with:
+ ++ DeleteImageProperty(image,key); ++The format of the DeleteImageAttribute method is:
@@ -755,7 +876,7 @@ _8c.html" target="source" name="DeleteImageList">DeleteImageListThe format of the DeleteImageList method is:
- unsigned int DeleteImageList(Image *images,const long offset) + unsigned int DeleteImageList(Image *images,const ssize_t offset)A description of each parameter follows:
@@ -773,10 +894,18 @@ _8c.html" target="source" name="DeleteMagickRegistry">DeleteMagickRegistryDeleteMagickRegistry() 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. +Deprecated, replace with:
+ ++ char key[MaxTextExtent]; + FormatMagickString(key,MaxTextExtent,"ld\n",id); + DeleteImageRegistry(key); ++The format of the DeleteMagickRegistry method is:
- MagickBooleanType DeleteMagickRegistry(const long id) + MagickBooleanType DeleteMagickRegistry(const ssize_t id)A description of each parameter follows:
@@ -791,6 +920,12 @@ _8c.html" target="source" name="DescribeImage">DescribeImageDescribeImage() describes an image by printing its attributes to the file. Attributes include the image width, height, size, and others.
+Deprecated, replace with:
+ ++ IdentifyImage(image,file,verbose); ++The format of the DescribeImage method is:
@@ -834,6 +969,12 @@ _8c.html" target="source" name="DestroyImages">DestroyImagesDestroyImages() destroys an image list.
+Deprecated, replace with:
+ ++ DestroyImageList(image); ++The format of the DestroyImages method is:
@@ -852,6 +993,12 @@ _8c.html" target="source" name="DestroyMagick">DestroyMagickDestroyMagick() destroys the ImageMagick environment.
+Deprecated, replace with:
+ ++ MagickCoreTerminus(); ++The format of the DestroyMagick function is:
@@ -863,7 +1010,7 @@ _8c.html" target="source" name="DestroyMagick">DestroyMagick _8c.html" target="source" name="DispatchImage">DispatchImage-DispatchImage() extracts pixel data from an image and returns it to you. The method returns MagickFalse on success otherwise MagickTrue if an error is encountered. The data is returned as char, short int, int, long, float, or double in the order specified by map.
+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.
Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:
@@ -871,12 +1018,19 @@ _8c.html" target="source" name="DispatchImage">DispatchImage DispatchImage(image,0,0,640,1,"RGB",CharPixel,pixels,exception); +Deprecated, replace with:
+ ++ ExportImagePixels(image,x_offset,y_offset,columns,rows,map,type,pixels, + exception); ++The format of the DispatchImage method is:
- unsigned int DispatchImage(const Image *image,const long x_offset, - const long y_offset,const unsigned long columns, - const unsigned long rows,const char *map,const StorageType type, + unsigned int DispatchImage(const Image *image,const ssize_t x_offset, + const ssize_t y_offset,const size_t columns, + const size_t rows,const char *map,const StorageType type, void *pixels,ExceptionInfo *exception)@@ -910,8 +1064,8 @@ _8c.html" target="source" name="ExtractSubimageFromImageImage">ExtractSubimageFrThe format of the ExtractSubimageFromImageImage method is:
- Image *ExtractSubimageFromImage(const Image *image,const Image *reference, - ExceptionInfo *exception) + Image *ExtractSubimageFromImage(const Image *image, + const Image *reference,ExceptionInfo *exception)A description of each parameter follows:
@@ -932,6 +1086,12 @@ _8c.html" target="source" name="FlattenImages">FlattenImagesFlattenImages() Obsolete Function: Use MergeImageLayers() instead.
+Deprecated, replace with:
+ ++ MergeImageLayers(image,FlattenLayer,exception); ++The format of the FlattenImage method is:
@@ -1026,11 +1186,18 @@ _8c.html" target="source" name="GetCacheView">GetCacheViewGetCacheView() 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.
+Deprecated, replace with:
+ ++ GetCacheViewAuthenticPixels(cache_view,x,y,columns,rows, + GetCacheViewException(cache_view)); ++The format of the GetCacheView method is:
- PixelPacket *GetCacheView(CacheView *cache_view,const long x, - const long y,const unsigned long columns,const unsigned long rows) + PixelPacket *GetCacheView(CacheView *cache_view,const ssize_t x, + const ssize_t y,const size_t columns,const size_t rows)A description of each parameter follows:
@@ -1048,6 +1215,12 @@ _8c.html" target="source" name="GetCacheViewIndexes">GetCacheViewIndexesGetCacheViewIndexes() returns the indexes associated with the specified view. +Deprecated, replace with:
+ ++ GetCacheViewAuthenticIndexQueue(cache_view); ++The format of the GetCacheViewIndexes method is:
@@ -1066,11 +1239,18 @@ _8c.html" target="source" name="GetCacheViewPixels">GetCacheViewPixelsGetCacheViewPixels() 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.
+Deprecated, replace with:
+ ++ GetCacheViewAuthenticPixels(cache_view,x,y,columns,rows, + GetCacheViewException(cache_view)); ++The format of the GetCacheViewPixels method is:
- PixelPacket *GetCacheViewPixels(CacheView *cache_view,const long x, - const long y,const unsigned long columns,const unsigned long rows) + PixelPacket *GetCacheViewPixels(CacheView *cache_view,const ssize_t x, + const ssize_t y,const size_t columns,const size_t rows)A description of each parameter follows:
@@ -1110,6 +1290,12 @@ _8c.html" target="source" name="GetImageClippingPathAttribute">GetImageClippingPGetImageClippingPathAttribute() searches the list of image attributes and returns a pointer to a clipping path if it exists otherwise NULL.
+Deprecated, replace with:
+ ++ GetImageAttribute(image,"8BIM:1999,2998"); ++The format of the GetImageClippingPathAttribute method is:
@@ -1131,10 +1317,16 @@ _8c.html" target="source" name="GetImageFromMagickRegistry">GetImageFromMagickReGetImageFromMagickRegistry() gets an image from the registry as defined by its name. If the image is not found, a NULL image is returned.
+Deprecated, replace with:
+ ++ GetImageRegistry(ImageRegistryType,name,exception); ++The format of the GetImageFromMagickRegistry method is:
- Image *GetImageFromMagickRegistry(const char *name,long *id, + Image *GetImageFromMagickRegistry(const char *name,ssize_t *id, ExceptionInfo *exception)@@ -1159,7 +1351,7 @@ _8c.html" target="source" name="GetMagickRegistry">GetMagickRegistryThe format of the GetMagickRegistry method is:
- const void *GetMagickRegistry(const long id,RegistryType *type, + const void *GetMagickRegistry(const ssize_t id,RegistryType *type, size_t *length,ExceptionInfo *exception)@@ -1184,6 +1376,14 @@ _8c.html" target="source" name="GetImageGeometry">GetImageGeometryGetImageGeometry() returns a region as defined by the geometry string with respect to the image and its gravity.
+Deprecated, replace with:
+ ++ if (size_to_fit != MagickFalse) + ParseRegionGeometry(image,geometry,region_info,&image->exception); else + ParsePageGeometry(image,geometry,region_info,&image->exception); ++The format of the GetImageGeometry method is:
@@ -1212,10 +1412,17 @@ _8c.html" target="source" name="GetImageList">GetImageListGetImageList() returns an image at the specified position in the list.
+Deprecated, replace with:
+ ++ CloneImage(GetImageFromList(images,(ssize_t) offset),0,0,MagickTrue, + exception); ++The format of the GetImageList method is:
- Image *GetImageList(const Image *images,const long offset, + Image *GetImageList(const Image *images,const ssize_t offset, ExceptionInfo *exception)@@ -1237,10 +1444,16 @@ _8c.html" target="source" name="GetImageListIndex">GetImageListIndexGetImageListIndex() returns the position in the list of the specified image.
+Deprecated, replace with:
+ ++ GetImageIndexInList(images); ++The format of the GetImageListIndex method is:
- long GetImageListIndex(const Image *images) + ssize_t GetImageListIndex(const Image *images)A description of each parameter follows:
@@ -1255,10 +1468,16 @@ _8c.html" target="source" name="GetImageListSize">GetImageListSizeGetImageListSize() returns the number of images in the list.
+Deprecated, replace with:
+ ++ GetImageListLength(images); ++The format of the GetImageListSize method is:
- unsigned long GetImageListSize(const Image *images) + size_t GetImageListSize(const Image *images)A description of each parameter follows:
@@ -1277,11 +1496,17 @@ _8c.html" target="source" name="GetImagePixels">GetImagePixelsPixels 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.
+Deprecated, replace with:
+ ++ GetAuthenticPixels(image,x,y,columns,rows,&image->exception); ++The format of the GetImagePixels() method is:
- PixelPacket *GetImagePixels(Image *image,const long x,const long y, - const unsigned long columns,const unsigned long rows) + PixelPacket *GetImagePixels(Image *image,const ssize_t x,const ssize_t y, + const size_t columns,const size_t rows)A description of each parameter follows:
@@ -1299,6 +1524,12 @@ _8c.html" target="source" name="GetIndexes">GetIndexesGetIndexes() 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.
+Deprecated, replace with:
+ ++ GetAuthenticIndexQueue(image); ++The format of the GetIndexes() method is:
@@ -1320,6 +1551,12 @@ _8c.html" target="source" name="GetNextImage">GetNextImageGetNextImage() returns the next image in a list.
+Deprecated, replace with:
+ ++ GetNextImageInList(images); ++The format of the GetNextImage method is:
@@ -1338,6 +1575,15 @@ _8c.html" target="source" name="GetNextImageAttribute">GetNextImageAttributeGetNextImageAttribute() gets the next image attribute.
+Deprecated, replace with:
+ ++ const char *property; + property=GetNextImageProperty(image); + if (property != (const char *) NULL) + GetImageAttribute(image,property); ++The format of the GetNextImageAttribute method is:
@@ -1356,6 +1602,12 @@ _8c.html" target="source" name="GetNumberScenes">GetNumberScenesGetNumberScenes() returns the number of images in the list.
+Deprecated, replace with:
+ ++ GetImageListLength(image); ++The format of the GetNumberScenes method is:
@@ -1374,10 +1626,16 @@ _8c.html" target="source" name="GetOnePixel">GetOnePixelGetOnePixel() returns a single pixel at the specified (x,y) location. The image background color is returned if an error occurs.
+Deprecated, replace with:
+ ++ GetOneAuthenticPixel(image,x,y,&pixel,&image->exception); ++The format of the GetOnePixel() method is:
- PixelPacket GetOnePixel(const Image image,const long x,const long y) + PixelPacket GetOnePixel(const Image image,const ssize_t x,const ssize_t y)A description of each parameter follows:
@@ -1395,6 +1653,12 @@ _8c.html" target="source" name="GetPixels">GetPixelsGetPixels() returns the pixels associated with the last call to QueueAuthenticPixels() or GetAuthenticPixels().
+Deprecated, replace with:
+ ++ GetAuthenticPixelQueue(image); ++The format of the GetPixels() method is:
@@ -1416,6 +1680,12 @@ _8c.html" target="source" name="GetPreviousImage">GetPreviousImageGetPreviousImage() returns the previous image in a list.
+Deprecated, replace with:
+ ++ GetPreviousImageInList(images)); ++The format of the GetPreviousImage method is:
@@ -1474,6 +1744,12 @@ _8c.html" target="source" name="InitializeMagick">InitializeMagickInitializeMagick() initializes the ImageMagick environment.
+Deprecated, replace with:
+ ++ MagickCoreGenesis(path,MagickFalse); ++The format of the InitializeMagick function is:
@@ -1524,6 +1800,12 @@ _8c.html" target="source" name="InterpretImageAttributes">InterpretImageAttributInterpretImageAttributes() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.
+Deprecated, replace with:
+ ++ InterpretImageProperties(image_info,image,embed_text); ++The format of the InterpretImageAttributes method is:
@@ -1551,6 +1833,12 @@ _8c.html" target="source" name="LevelImageColor">LevelImageColorIf 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.
+Deprecated, replace with:
+ ++ LevelColorsImageChannel(image,channel,black_color,white_color,invert); ++The format of the LevelImageColors method is:
@@ -1601,6 +1889,12 @@ _8c.html" target="source" name="LiberateSemaphoreInfo">LiberateSemaphoreInfoLiberateSemaphoreInfo() relinquishes a semaphore.
+Deprecated, replace with:
+ ++ UnlockSemaphoreInfo(*semaphore_info); ++The format of the LiberateSemaphoreInfo method is:
@@ -1619,6 +1913,12 @@ _8c.html" target="source" name="MagickIncarnate">MagickIncarnateMagickIncarnate() initializes the ImageMagick environment.
+Deprecated, replace with:
+ ++ MagickCoreGenesis(path,MagickFalse); ++The format of the MagickIncarnate function is:
@@ -1663,6 +1963,15 @@ _8c.html" target="source" name="MapImage">MapImageMapImage() replaces the colors of an image with the closest color from a reference image.
+Deprecated, replace with:
+ ++ QuantizeInfo quantize_info; + GetQuantizeInfo(&quantize_info); + quantize_info.dither=dither; + RemapImage(&quantize_info,image,map_image); ++The format of the MapImage method is:
@@ -1688,6 +1997,15 @@ _8c.html" target="source" name="MapImages">MapImagesMapImages() replaces the colors of a sequence of images with the closest color from a reference image.
+Deprecated, replace with:
+ ++ QuantizeInfo quantize_info; + GetQuantizeInfo(&quantize_info); + quantize_info.dither=dither; + RemapImages(&quantize_info,images,map_image); ++The format of the MapImage method is:
@@ -1719,8 +2037,8 @@ _8c.html" target="source" name="MatteFloodfill">MatteFloodfillMagickBooleanType MatteFloodfillImage(Image *image, - const PixelPacket target,const Quantum opacity,const long x_offset, - const long y_offset,const PaintMethod method) + const PixelPacket target,const Quantum opacity,const ssize_t x_offset, + const ssize_t y_offset,const PaintMethod method)A description of each parameter follows:
@@ -1747,6 +2065,12 @@ _8c.html" target="source" name="MaximumImages">MaximumImagesMaximumImages() returns the maximum intensity of an image sequence.
+Deprecated, replace with:
+ ++ EvaluateImages(images,MinEvaluateOperator,exception); ++The format of the MaxImages method is:
@@ -1768,6 +2092,12 @@ _8c.html" target="source" name="MinimumImages">MinimumImagesMinimumImages() returns the minimum intensity of an image sequence.
+Deprecated, replace with:
+ ++ EvaluateImages(images,MinEvaluateOperator,exception); ++The format of the MinimumImages method is:
@@ -1789,6 +2119,12 @@ _8c.html" target="source" name="MosaicImages">MosaicImagesMosaicImages() Obsolete Function: Use MergeImageLayers() instead.
+Deprecated, replace with:
+ ++ MergeImageLayers(image,MosaicLayer,exception); ++The format of the MosaicImage method is:
@@ -1837,6 +2173,12 @@ _8c.html" target="source" name="OpenCacheView">OpenCacheViewOpenCacheView() opens a view into the pixel cache, using the VirtualPixelMethod that is defined within the given image itself.
+Deprecated, replace with:
+ ++ AcquireCacheView(image); ++The format of the OpenCacheView method is:
@@ -1857,12 +2199,19 @@ _8c.html" target="source" name="PaintFloodfill">PaintFloodfillBy 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.
+Deprecated, replace with:
+ ++ FloodfillPaintImage(image,channel,draw_info,target,x,y, + method == FloodfillMethod ? MagickFalse : MagickTrue); ++The format of the PaintFloodfillImage method is:
MagickBooleanType PaintFloodfillImage(Image *image, - const ChannelType channel,const MagickPixelPacket target,const long x, - const long y,const DrawInfo *draw_info,const PaintMethod method) + const ChannelType channel,const MagickPixelPacket target,const ssize_t x, + const ssize_t y,const DrawInfo *draw_info,const PaintMethod method)A description of each parameter follows:
@@ -1894,6 +2243,13 @@ _8c.html" target="source" name="PaintOpaqueImage">PaintOpaqueImageBy 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.
+Deprecated, replace with:
+ ++ OpaquePaintImageChannel(image,DefaultChannels,target,fill,MagickFalse); + OpaquePaintImageChannel(image,channel,target,fill,MagickFalse); ++The format of the PaintOpaqueImage method is:
@@ -1927,6 +2283,12 @@ _8c.html" target="source" name="PaintTransparentImage">PaintTransparentImageBy 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.
+Deprecated, replace with:
+ ++ TransparentPaintImage(image,target,opacity,MagickFalse); ++The format of the PaintTransparentImage method is:
@@ -1952,6 +2314,13 @@ _8c.html" target="source" name="ParseSizeGeometry">ParseSizeGeometryParseSizeGeometry() returns a region as defined by the geometry string with respect to the image dimensions and aspect ratio.
+Deprecated, replace with:
+ ++ ParseMetaGeometry(geometry,®ion_info->x,®ion_info->y, + ®ion_info->width,®ion_info->height); ++The format of the ParseSizeGeometry method is:
@@ -1974,6 +2343,12 @@ _8c.html" target="source" name="PopImageList">PopImageListPopImageList() removes the last image in the list.
+Deprecated, replace with:
+ ++ RemoveLastImageFromList(images); ++The format of the PopImageList method is:
@@ -2017,6 +2392,12 @@ _8c.html" target="source" name="PostscriptGeometry">PostscriptGeometryPostscriptGeometry() replaces any page mneumonic with the equivalent size in picas.
+Deprecated, replace with:
+ ++ GetPageGeometry(page); ++The format of the PostscriptGeometry method is:
@@ -2035,6 +2416,12 @@ _8c.html" target="source" name="PushImageList">PushImageListPushImageList() adds an image to the end of the list.
+Deprecated, replace with:
+ ++ AppendImageToList(images,CloneImageList(image,exception)); ++The format of the PushImageList method is:
@@ -2096,6 +2483,11 @@ _8c.html" target="source" name="QuantizationError">QuantizationErrornormalized_maximum_square_error
+
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.
Deprecated, replace with:
+ ++ GetImageQuantizeError(image); +The format of the QuantizationError method is:
@@ -2160,11 +2552,45 @@ _8c.html" target="source" name="ReacquireMemory">ReacquireMemoryRecolorImage
++ ++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).
+ +The format of the RecolorImage method is:
+ ++ Image *RecolorImage(const Image *image,const size_t order, + const double *color_matrix,ExceptionInfo *exception) ++ +A description of each parameter follows:
+ +image
++ +
the image.
order
++ +
the number of columns and rows in the recolor matrix.
color_matrix
++ +
An array of double representing the recolor matrix.
exception
++ +
return any errors or warnings in this structure.
ResetImageAttributeIterator
ResetImageAttributeIterator() resets the image attributes iterator. Use it in conjunction with GetNextImageAttribute() to iterate over all the values associated with an image.
+Deprecated, replace with:
+ ++ ResetImagePropertyIterator(image); ++The format of the ResetImageAttributeIterator method is:
@@ -2183,11 +2609,18 @@ _8c.html" target="source" name="SetCacheViewPixels">SetCacheViewPixelsSetCacheViewPixels() 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.
+Deprecated, replace with:
+ ++ QueueCacheViewAuthenticPixels(cache_view,x,y,columns,rows, + GetCacheViewException(cache_view)); ++The format of the SetCacheViewPixels method is:
- PixelPacket *SetCacheViewPixels(CacheView *cache_view,const long x, - const long y,const unsigned long columns,const unsigned long rows) + PixelPacket *SetCacheViewPixels(CacheView *cache_view,const ssize_t x, + const ssize_t y,const size_t columns,const size_t rows)A description of each parameter follows:
@@ -2248,6 +2681,12 @@ _8c.html" target="source" name="SetImageAttribute">SetImageAttributeSetImageAttribute() 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.
+Deprecated, replace with:
+ ++ SetImageProperty(image,key,value); ++The format of the SetImageAttribute method is:
@@ -2277,7 +2716,7 @@ _8c.html" target="source" name="SetImageList">SetImageListunsigned int SetImageList(Image *images,const Image *image, - const long offset,ExceptionInfo *exception) + const ssize_t offset,ExceptionInfo *exception)A description of each parameter follows:
@@ -2307,11 +2746,17 @@ _8c.html" target="source" name="SetImagePixels">SetImagePixelsPixels 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.
+Deprecated, replace with:
+ ++ QueueAuthenticPixels(image,x,y,columns,rows,&image->exception); ++The format of the SetImagePixels() method is:
- PixelPacket *SetImagePixels(Image *image,const long x,const long y, - const unsigned long columns,const unsigned long rows) + PixelPacket *SetImagePixels(Image *image,const ssize_t x,const ssize_t y, + const size_t columns,const size_t rows)A description of each parameter follows:
@@ -2335,7 +2780,7 @@ _8c.html" target="source" name="SetMagickRegistry">SetMagickRegistryThe format of the SetMagickRegistry method is:
- long SetMagickRegistry(const RegistryType type,const void *blob, + ssize_t SetMagickRegistry(const RegistryType type,const void *blob, const size_t length,ExceptionInfo *exception)@@ -2378,6 +2823,12 @@ _8c.html" target="source" name="ShiftImageList">ShiftImageListShiftImageList() removes an image from the beginning of the list.
+Deprecated, replace with:
+ ++ RemoveFirstImageFromList(images); ++The format of the ShiftImageList method is:
@@ -2399,8 +2850,8 @@ _8c.html" target="source" name="SpliceImageList">SpliceImageListThe format of the SpliceImageList method is:
- Image *SpliceImageList(Image *images,const long offset, - const unsigned long length,const Image *splices, + Image *SpliceImageList(Image *images,const ssize_t offset, + const size_t length,const Image *splices, ExceptionInfo *exception)@@ -2446,6 +2897,12 @@ _8c.html" target="source" name="SyncCacheView">SyncCacheViewSyncCacheView() saves the cache view pixels to the in-memory or disk cache. It returns MagickTrue if the pixel region is synced, otherwise MagickFalse.
+Deprecated, replace with:
+ ++ SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view)); ++The format of the SyncCacheView method is:
@@ -2464,6 +2921,12 @@ _8c.html" target="source" name="SyncCacheViewPixels">SyncCacheViewPixelsSyncCacheViewPixels() saves the cache view pixels to the in-memory or disk cache. It returns MagickTrue if the pixel region is flushed, otherwise MagickFalse. +Deprecated, replace with:
+ ++ SyncCacheViewAuthenticPixels(cache_view,GetCacheViewException(cache_view)); ++The format of the SyncCacheViewPixels method is:
@@ -2485,6 +2948,12 @@ _8c.html" target="source" name="SyncImagePixels">SyncImagePixelsSyncImagePixels() saves the image pixels to the in-memory or disk cache. The method returns MagickTrue if the pixel region is synced, otherwise MagickFalse.
+Deprecated, replace with:
+ ++ SyncAuthenticPixels(image,&image->exception); ++The format of the SyncImagePixels() method is:
@@ -2585,6 +3054,12 @@ _8c.html" target="source" name="TranslateText">TranslateTextTranslateText() replaces any embedded formatting characters with the appropriate image attribute and returns the translated text.
+Deprecated, replace with:
+ ++ InterpretImageProperties(image_info,image,embed_text); ++The format of the TranslateText method is:
@@ -2637,6 +3112,12 @@ _8c.html" target="source" name="UnshiftImageList">UnshiftImageListUnshiftImageList() adds the image to the beginning of the list.
+Deprecated, replace with:
+ ++ PrependImageToList(images,CloneImageList(image,exception)); ++The format of the UnshiftImageList method is: