- NAME
- SYNOPSIS
- FUNCTION DESCRIPTIONS

- AcquireMemory
- AcquireString
- ChannelImage
- ChannelThresholdImage
- CloneMemory
- DeleteImageList
- DestroyBlobInfo
- DestroyImages
- DispatchImage
- FormatString
- GetConfigureBlob
- GetImageGeometry
- GetImageList
- GetImageListIndex
- GetImageListSize
- GetNextImage
- GetNumberScenes
- GetPreviousImage
- IdentityAffine
- LiberateMemory
- LiberateSemaphoreInfo
- MagickIncarnate
- PopImageList
- PostscriptGeometry
- PushImageList
- QuantizationError
- RandomChannelThresholdImage
- ReacquireMemory
- SetImageList
- ShiftImageList
- SpliceImageList
- Strip
- TemporaryFilename
- ThresholdImage
- ThresholdImageChannel
- UnshiftImageList

# NAME

deprecate - Deprecated

# SYNOPSIS

void * AcquireMemory( const size_t size );

unsigned int ChannelImage( Image *image, const ChannelType channel );

unsigned int ChannelThresholdImage( Image *image, const char *level );

void * CloneMemory( void *destination, const void *source, const size_t size );

unsigned int DeleteImageList( Image *images, const long offset );

void DestroyBlobInfo( BlobInfo *blob );

void DestroyImages( Image *image );

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, void *pixels, ExceptionInfo *exception );

void FormatString( char *string, const char *format, ... );

void * GetConfigureBlob( const char *filename, ExceptionInfo *exception );

int GetImageGeometry( Image *image, const char *geometry, const unsigned int size_to_fit, RectangeInfo *region_info );

Image * GetImageList( const Image *images, const long offset, ExceptionInfo *exception );

long GetImageListIndex( const Image *images );

unsigned long GetImageListSize( const Image *images );

Image * GetNextImage( const Image *images );

unsigned int GetNumberScenes( const Image *images );

Image * GetPreviousImage( const Image *images );

IdentityAffine( AffineMatrix *affine );

void LiberateMemory( void ** memory );

LiberateSemaphoreInfo( void ** semaphore_info );

MagickIncarnate( const char *path );

Image * PopImageList( Image ** images );

char * PostscriptGeometry( const char *page );

unsigned int PushImageList( Image *images, const Image *image, ExceptionInfo *exception );

unsigned int QuantizationError( Image *image );

unsigned int RandomChannelThresholdImage( Image *image, const char *channel, const char *thresholds, ExceptionInfo *exception );

void ReacquireMemory( void ** memory, const size_t size );

unsigned int SetImageList( Image *images, const Image *image, const long offset, ExceptionInfo *exception );

Image * ShiftImageList( Image ** images );

Image * SpliceImageList( Image *images, const long offset, const unsigned long length, const Image *splices, ExceptionInfo *exception );

void Strip( char *message );

void TemporaryFilename( char *path );

unsigned int ThresholdImage( Image *image, const double threshold );

unsigned int ThresholdImageChannel( Image *image, const char *threshold );

unsigned int UnshiftImageList( Image *images, const Image *image, ExceptionInfo *exception );

# FUNCTION DESCRIPTIONS

## AcquireMemory

> AcquireMemory() returns a pointer to a block of memory at least size bytes suitably aligned for any use.

The format of the AcquireMemory method is:

> void *AcquireMemory ( const size_t size );

A description of each parameter follows:

size:
  The size of the memory in bytes to allocate.

## AcquireString

`AllocateString()` allocates memory for a string and copies the source string to that memory location (and returns it).

The format of the AllocateString method is:

        char *AllocateString(const char *source)

A description of each parameter follows:

source:
  A character string.

## ChannelImage

Extract a channel from the image. A channel is a particular color component of each pixel in the image.

The format of the ChannelImage method is:

> unsigned int ChannelImage ( Image *image, const ChannelType channel );

A description of each parameter follows:

image:
  The image.

channel:
  Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, or BlackChannel.

## ChannelThresholdImage

> ChannelThresholdImage() changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.

The format of the ChannelThresholdImage method is:

> unsigned int ChannelThresholdImage ( Image *image, const char *level );

A description of each parameter follows:

image:
  The image.

level:
  define the threshold values.

## CloneMemory

> CloneMemory() copies size bytes from memory area source to the destination. Copying between objects that overlap will take place correctly. It returns destination.

The format of the CloneMemory method is:

> void *CloneMemory ( void *destination, const void *source, const size_t size );

A description of each parameter follows:

destination:
  The destination.

source:
  The source.

size:
  The size of the memory in bytes to allocate.

## DeleteImageList

> DeleteImageList() deletes an image at the specified position in the list.

The format of the DeleteImageList method is:

> unsigned int DeleteImageList ( Image *images, const long offset );

A description of each parameter follows:

images:
  The image list.

offset:
  The position within the list.

## DestroyBlobInfo

> DestroyBlobInfo() deallocates memory associated with an BlobInfo structure.

The format of the DestroyBlobInfo method is:

> void DestroyBlobInfo ( BlobInfo *blob );

A description of each parameter follows:

blob:
  Specifies a pointer to a BlobInfo structure.

## DestroyImages

> DestroyImages() destroys an image list.

The format of the DestroyImages method is:

> void DestroyImages ( Image *image );

A description of each parameter follows:

image:
  The image sequence.

## DispatchImage

> DispatchImage() extracts pixel data from an image and returns it to you. The method returns False on success otherwise True if an error is encountered. The data is returned as char, short int, int, long, 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:

> DispatchImage ( image, 0, 0, 640, 1, "RGB", CharPixel, 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, void *pixels, ExceptionInfo *exception );

A description of each parameter follows:

image:
  The image.

x_offset, y_offset, columns, rows:
  These values define the perimeter of a region of pixels you want to extract.

map:
  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).

type:
  Define the data type of the pixels. Float and double types are normalized to [0..1] otherwise [0..MaxRGB]. Choose from these types: CharPixel, ShortPixel, IntegerPixel, LongPixel, FloatPixel, or DoublePixel.

pixels:
  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.

exception:
  Return any errors or warnings in this structure.

## FormatString

> FormatString() prints formatted output of a variable argument list.

The format of the FormatString method is:

> void FormatString ( char *string, const char *format, ... );

A description of each parameter follows.

string:
  Method FormatString returns the formatted string in this character buffer.

format:
  A string describing the format to use to write the remaining arguments.

## GetConfigureBlob

> GetConfigureBlob() returns the specified configure file as a blob.

The format of the GetConfigureBlob method is:

> void *GetConfigureBlob ( const char *filename, ExceptionInfo *exception );

A description of each parameter follows:

filename:
  The configure file name.

path:
  return the full path information of the configure file.

length:
  This pointer to a size_t integer sets the initial length of the blob. On return, it reflects the actual length of the blob.

exception:
  Return any errors or warnings in this structure.

## GetImageGeometry

> GetImageGeometry() returns a region as defined by the geometry string with respect to the image and its gravity.

The format of the GetImageGeometry method is:

> int GetImageGeometry ( Image *image, const char *geometry, const unsigned int size_to_fit, RectangeInfo *region_info );

A description of each parameter follows:

flags:
  Method GetImageGeometry returns a bitmask that indicates which of the four values were located in the geometry string.

geometry:
  The geometry (e.g. 100x100+10+10).

size_to_fit:
  A value other than 0 means to scale the region so it fits within the specified width and height.

region_info:
  The region as defined by the geometry string with respect to the image and its gravity.

## GetImageList

> GetImageList() returns an image at the specified position in the list.

The format of the GetImageList method is:

> Image *GetImageList ( const Image *images, const long offset, ExceptionInfo *exception );

A description of each parameter follows:

images:
  The image list.

offset:
  The position within the list.

exception:
  Return any errors or warnings in this structure.

## GetImageListIndex

> GetImageListIndex() returns the position in the list of the specified image.

The format of the GetImageListIndex method is:

> long GetImageListIndex ( const Image *images );

A description of each parameter follows:

images:
  The image list.

## GetImageListSize

> GetImageListSize() returns the number of images in the list.

The format of the GetImageListSize method is:

> unsigned long GetImageListSize ( const Image *images );

A description of each parameter follows:

images:
  The image list.

## GetNextImage

> GetNextImage() returns the next image in a list.

The format of the GetNextImage method is:

> Image *GetNextImage ( const Image *images );

A description of each parameter follows:

images:
  The image list.

## GetNumberScenes

> GetNumberScenes() returns the number of images in the list.

The format of the GetNumberScenes method is:

> unsigned int GetNumberScenes ( const Image *images );

A description of each parameter follows:

images:
  The image list.

## GetPreviousImage

> GetPreviousImage() returns the previous image in a list.

The format of the GetPreviousImage method is:

> Image *GetPreviousImage ( const Image *images );

A description of each parameter follows:

images:
  The image list.

## IdentityAffine

> IdentityAffine() initializes the affine transform to the identity matrix.

The format of the IdentityAffine method is:

> IdentityAffine ( AffineMatrix *affine );

A description of each parameter follows:

affine:
  A pointer the the affine transform of type AffineMatrix.

## LiberateMemory

> LiberateMemory() frees memory that has already been allocated, and NULL's the pointer to it.

The format of the LiberateMemory method is:

> void LiberateMemory ( void **memory );

A description of each parameter follows:

memory:
  A pointer to a block of memory to free for reuse.

## LiberateSemaphoreInfo

> LiberateSemaphoreInfo() relinquishes a semaphore.

The format of the LiberateSemaphoreInfo method is:

> LiberateSemaphoreInfo ( void **semaphore_info );

A description of each parameter follows:

semaphore_info:
  Specifies a pointer to an SemaphoreInfo structure.

## MagickIncarnate

> MagickIncarnate() initializes the ImageMagick environment.

The format of the MagickIncarnate function is:

> MagickIncarnate ( const char *path );

A description of each parameter follows:

path:
  The execution path of the current ImageMagick client.

## PopImageList

> PopImageList() removes the last image in the list.

The format of the PopImageList method is:

> Image *PopImageList ( Image **images );

A description of each parameter follows:

images:
  The image list.

## PostscriptGeometry

> PostscriptGeometry() replaces any page mneumonic with the equivalent size in picas.

The format of the PostscriptGeometry method is:

> char *PostscriptGeometry ( const char *page );

A description of each parameter follows.

page:
  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).

## PushImageList

> PushImageList() adds an image to the end of the list.

The format of the PushImageList method is:

> unsigned int PushImageList ( Image *images, const Image *image, ExceptionInfo *exception );

A description of each parameter follows:

images:
  The image list.

image:
  The image.

exception:
  Return any errors or warnings in this structure.

## QuantizationError

> 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:

mean_error_per_pixel:
  This value is the mean error for any single pixel in the image.

normalized_mean_square_error:
  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.

normalized_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.

The format of the QuantizationError method is:

> unsigned int QuantizationError ( Image *image );

A description of each parameter follows.

image:
  Specifies a pointer to an Image structure; returned from ReadImage.

## RandomChannelThresholdImage

> 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.

The format of the RandomChannelThresholdImage method is:

> unsigned int RandomChannelThresholdImage ( Image *image, const char *channel, const char *thresholds, ExceptionInfo *exception );

A description of each parameter follows:

image:
  The image.

channel:
  The channel or channels to be thresholded.

thresholds:
  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.

exception:
  Return any errors or warnings in this structure.

## ReacquireMemory

> 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.

The format of the ReacquireMemory method is:

> void ReacquireMemory ( void **memory, const size_t size );

A description of each parameter follows:

memory:
  A pointer to a memory allocation. On return the pointer may change but the contents of the original allocation will not.

size:
  The new size of the allocated memory.

## SetImageList

> SetImageList() inserts an image into the list at the specified position.

The format of the SetImageList method is:

> unsigned int SetImageList ( Image *images, const Image *image, const long offset, ExceptionInfo *exception );

A description of each parameter follows:

images:
  The image list.

image:
  The image.

offset:
  The position within the list.

exception:
  Return any errors or warnings in this structure.

## ShiftImageList

> ShiftImageList() removes an image from the beginning of the list.

The format of the ShiftImageList method is:

> Image *ShiftImageList ( Image **images );

A description of each parameter follows:

images:
  The image list.

## SpliceImageList

> SpliceImageList() removes the images designated by offset and length from the list and replaces them with the specified list.

The format of the SpliceImageList method is:

> Image *SpliceImageList ( Image *images, const long offset, const unsigned long length, const Image *splices, ExceptionInfo *exception );

A description of each parameter follows:

images:
  The image list.

offset:
  The position within the list.

length:
  The length of the image list to remove.

splice:
  Replace the removed image list with this list.

exception:
  Return any errors or warnings in this structure.

## Strip

> Strip() strips any whitespace or quotes from the beginning and end of a string of characters.

The format of the Strip method is:

> void Strip ( char *message );

A description of each parameter follows:

message:
  Specifies an array of characters.

## TemporaryFilename

> TemporaryFilename() replaces the contents of path by a unique path name.

The format of the TemporaryFilename method is:

> void TemporaryFilename ( char *path );

A description of each parameter follows.

path:
  Specifies a pointer to an array of characters. The unique path name is returned in this array.

## ThresholdImage

> 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.

The format of the ThresholdImage method is:

> unsigned int ThresholdImage ( Image *image, const double threshold );

A description of each parameter follows:

image:
  The image.

threshold:
  Define the threshold value

## ThresholdImageChannel

> ThresholdImageChannel() changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.

The format of the ThresholdImageChannel method is:

> unsigned int ThresholdImageChannel ( Image *image, const char *threshold );

A description of each parameter follows:

image:
  The image.

threshold:
  define the threshold values.

## UnshiftImageList

> UnshiftImageList() adds the image to the beginning of the list.

The format of the UnshiftImageList method is:

> unsigned int UnshiftImageList ( Image *images, const Image *image, ExceptionInfo *exception );

A description of each parameter follows:

images:
  The image list.

image:
  The image.

exception:
  Return any errors or warnings in this structure.

"Image manipulation software that works like magick"