## ClearMagickWand

ClearMagickWand() clears resources associated with the wand.

The format of the ClearMagickWand method is:

      void ClearMagickWand(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## CloneMagickWand

CloneMagickWand() makes an exact copy of the specified wand.

The format of the CloneMagickWand method is:

      MagickWand *CloneMagickWand(const MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## DestroyMagickWand

DestroyMagickWand() deallocates memory associated with an MagickWand.

The format of the DestroyMagickWand method is:

      MagickWand *DestroyMagickWand(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## GetImageFromMagickWand

GetImageFromMagickWand() returns the current image from the magick wand.

The format of the GetImageFromMagickWand method is:

      MagickWand *GetImageFromMagickWand(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## IsMagickWand

IsMagickWand() returns MagickTrue if the wand is verified as a magick wand.

The format of the IsMagickWand method is:

      MagickBooleanType IsMagickWand(const MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickAdaptiveThresholdImage

MagickAdaptiveThresholdImage() selects an individual threshold for each pixel based on the range of intensity values in its local neighborhood. This allows for thresholding of an image whose global intensity histogram doesn't contain distinctive peaks.

The format of the AdaptiveThresholdImage method is:

      MagickBooleanType MagickAdaptiveThresholdImage(MagickWand *wand,
        const unsigned long width,const unsigned long height,const long offset)

A description of each parameter follows:

#### wand

The magick wand.

#### width

The width of the local neighborhood.

#### height

The height of the local neighborhood.

#### offset

The mean offset.

## MagickAddImage

MagickAddImage() adds the specified images at the current image location.

The format of the MagickAddImage method is:

      MagickBooleanType MagickAddImage(MagickWand *wand,
        const MagickWand *add_wand)

A description of each parameter follows:

#### wand

The magick wand.

#### insert

The splice wand.

## MagickAddNoiseImage

MagickAddNoiseImage() adds random noise to the image.

The format of the MagickAddNoiseImage method is:

      MagickBooleanType MagickAddNoiseImage(MagickWand *wand,
        const NoiseType noise_type)

A description of each parameter follows:

#### wand

The magick wand.

#### noise_type

The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.

## MagickAffineTransformImage

MagickAffineTransformImage() transforms an image as dictated by the affine matrix of the drawing wand.

The format of the MagickAffineTransformImage method is:

      MagickBooleanType MagickAffineTransformImage(MagickWand *wand,
        const DrawingWand *drawing_wand)

A description of each parameter follows:

#### wand

The magick wand.

#### drawing_wand

The draw wand.

## MagickAnnotateImage

MagickAnnotateImage() annotates an image with text.

The format of the MagickAnnotateImage method is:

      MagickBooleanType MagickAnnotateImage(MagickWand *wand,
        const DrawingWand *drawing_wand,const double x,const double y,
        const double angle,const char *text)

A description of each parameter follows:

#### wand

The magick wand.

#### drawing_wand

The draw wand.

#### x

x ordinate to left of text

#### y

y ordinate to text baseline

#### angle

rotate text relative to this angle.

#### text

text to draw

## MagickAnimateImages

MagickAnimateImages() animates an image or image sequence.

The format of the MagickAnimateImages method is:

      MagickBooleanType MagickAnimateImages(MagickWand *wand,
        const char *server_name)

A description of each parameter follows:

#### wand

The magick wand.

#### server_name

The X server name.

## MagickAppendImages

MagickAppendImages() append a set of images.

The format of the MagickAppendImages method is:

      MagickWand *MagickAppendImages(MagickWand *wand,
        const MagickBooleanType stack)

A description of each parameter follows:

#### wand

The magick wand.

#### stack

By default, images are stacked left-to-right. Set stack to MagickTrue to stack them top-to-bottom.

## MagickAverageImages

MagickAverageImages() average a set of images.

The format of the MagickAverageImages method is:

      MagickWand *MagickAverageImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickBlackThresholdImage

MagickBlackThresholdImage() is like MagickThresholdImage() but forces all pixels below the threshold into black while leaving all pixels above the threshold unchanged.

The format of the MagickBlackThresholdImage method is:

      MagickBooleanType MagickBlackThresholdImage(MagickWand *wand,
        const PixelWand *threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### threshold

The pixel wand.

## MagickBlurImage

MagickBlurImage() blurs an image. We convolve the image with a gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and BlurImage() selects a suitable radius for you.

The format of the MagickBlurImage method is:

      MagickBooleanType MagickBlurImage(MagickWand *wand,const double radius,
        const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the , in pixels, not counting the center pixel.

#### sigma

The standard deviation of the , in pixels.

## MagickBlurImageChannel

MagickBlurImageChannel() blurs one or more image channels. We convolve the image cnannel with a gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and GaussinBlurImageChannel() selects a suitable radius for you.

The format of the MagickBlurImageChannel method is:

      MagickBooleanType MagickBlurImageChannel(MagickWand *wand,
        const ChannelType channel,const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### radius

The radius of the , in pixels, not counting the center pixel.

#### sigma

The standard deviation of the , in pixels.

## MagickBorderImage

MagickBorderImage() surrounds the image with a border of the color defined by the bordercolor pixel wand.

The format of the MagickBorderImage method is:

      MagickBooleanType MagickBorderImage(MagickWand *wand,
        const PixelWand *bordercolor,const unsigned long width,
        const unsigned long height)

A description of each parameter follows:

#### wand

The magick wand.

#### bordercolor

The border color pixel wand.

#### width

The border width.

#### height

The border height.

## MagickCharcoalImage

MagickCharcoalImage() simulates a charcoal drawing.

The format of the MagickCharcoalImage method is:

      MagickBooleanType MagickCharcoalImage(MagickWand *wand,
        const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

## MagickChopImage

MagickChopImage() removes a region of an image and collapses the image to occupy the removed portion

The format of the MagickChopImage method is:

      MagickBooleanType MagickChopImage(MagickWand *wand,
        const unsigned long width,const unsigned long height,const long x,
        const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### width

The region width.

#### height

The region height.

#### x

The region x offset.

#### y

The region y offset.

## MagickClearException

MagickClearException() clear any exceptions associated with the wand.

The format of the MagickClearException method is:

      MagickBooleanType MagickClearException(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickClipImage

MagickClipImage() clips along the first path from the 8BIM profile, if present.

The format of the MagickClipImage method is:

      MagickBooleanType MagickClipImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickClipPathImage

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.

The format of the MagickClipPathImage method is:

      MagickBooleanType MagickClipPathImage(MagickWand *wand,
        const char *pathname,const MagickBooleanType inside)

A description of each parameter follows:

#### wand

The magick wand.

#### pathname

name of clipping path resource. If name is preceded by #, use clipping path numbered by name.

#### inside

if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.

## MagickCoalesceImages

MagickCoalesceImages() composites a set of images while respecting any page offsets and disposal methods. GIF, MIFF, and MNG animation sequences typically start with an image background and each subsequent image varies in size and offset. MagickCoalesceImages() returns a new sequence where each image in the sequence is the same size as the first and composited with the next image in the sequence.

The format of the MagickCoalesceImages method is:

      MagickWand *MagickCoalesceImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickColorFloodfillImage

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.

The format of the MagickColorFloodfillImage method is:

      MagickBooleanType MagickColorFloodfillImage(MagickWand *wand,
        const PixelWand *fill,const double fuzz,const PixelWand *bordercolor,
        const long x,const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### fill

The floodfill color pixel wand.

#### fuzz

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.

#### bordercolor

The border color pixel wand.

#### x,y

The starting location of the operation.

## MagickColorizeImage

MagickColorizeImage() blends the fill color with each pixel in the image.

The format of the MagickColorizeImage method is:

      MagickBooleanType MagickColorizeImage(MagickWand *wand,
        const PixelWand *colorize,const PixelWand *opacity)

A description of each parameter follows:

#### wand

The magick wand.

#### colorize

The colorize pixel wand.

#### opacity

The opacity pixel wand.

## MagickCombineImages

MagickCombineImages() combines one or more images into a single image. The grayscale value of the pixels of each image in the sequence is assigned in order to the specified hannels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc.

The format of the MagickCombineImages method is:

      MagickWand *MagickCombineImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickCommentImage

MagickCommentImage() adds a comment to your image.

The format of the MagickCommentImage method is:

      MagickBooleanType MagickCommentImage(MagickWand *wand,const char *comment)

A description of each parameter follows:

#### wand

The magick wand.

#### comment

The image comment.

## MagickCompareImageChannels

MagickCompareImageChannels() compares one or more image channels of an image to a reconstructed image and returns the difference image.

The format of the MagickCompareImageChannels method is:

      MagickWand *MagickCompareImageChannels(MagickWand *wand,
        const MagickWand *reference,const ChannelType channel,
        const MetricType metric,double *distortion)

A description of each parameter follows:

#### wand

The magick wand.

#### reference

The reference wand.

#### channel

The channel.

#### metric

The metric.

#### distortion

The computed distortion between the images.

## MagickCompareImage

MagickCompareImage() compares an image to a reconstructed image and returns the specified difference image.

The format of the MagickCompareImages method is:

      MagickWand *MagickCompareImages(MagickWand *wand,
        const MagickWand *reference,const MetricType metric,
        double *distortion)

A description of each parameter follows:

#### wand

The magick wand.

#### reference

The reference wand.

#### metric

The metric.

#### distortion

The computed distortion between the images.

## MagickCompositeImage

MagickCompositeImage() composite one image onto another at the specified offset.

The format of the MagickCompositeImage method is:

      MagickBooleanType MagickCompositeImage(MagickWand *wand,
        const MagickWand *composite_wand,const CompositeOperator compose,
        const long x,const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### composite_image

The composite image.

#### compose

This operator affects how the composite is applied to the image. The default is Over. Choose from these operators:

        OverCompositeOp       InCompositeOp         OutCompositeOP
        AtopCompositeOP       XorCompositeOP        PlusCompositeOP
        MinusCompositeOP      AddCompositeOP        SubtractCompositeOP
        DifferenceCompositeOP BumpmapCompositeOP    CopyCompositeOP
        DisplaceCompositeOP

#### x_offset

The column offset of the composited image.

#### y_offset

The row offset of the composited image.

## MagickEvaluateImage

MagickEvaluateImage() applies an arithmetic, relational, or logical operator to an image. These operations can be used to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.

The format of the MagickEvaluateImageChannel method is:

      MagickBooleanType MagickEvaluateImageChannel(MagickWand *wand,
        const MagickEvaluateOperator op,const double constant)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

The channel.

#### op

A channel operator.

#### constant

A constant value.

## MagickContrastImage

MagickContrastImage() enhances the intensity differences between the lighter and darker elements of the image. Set sharpen to a value other than 0 to increase the image contrast otherwise the contrast is reduced.

The format of the MagickContrastImage method is:

      MagickBooleanType MagickContrastImage(MagickWand *wand,
        const MagickBooleanType sharpen)

A description of each parameter follows:

#### wand

The magick wand.

#### sharpen

Increase or decrease image contrast.

## MagickConvolveImage

MagickConvolveImage() applies a custom convolution kernel to the image.

The format of the MagickConvolveImage method is:

      MagickBooleanType MagickConvolveImage(MagickWand *wand,
        const unsigned long order,const double *kernel)

A description of each parameter follows:

#### wand

The magick wand.

#### order

The number of columns and rows in the filter kernel.

#### kernel

An array of doubles representing the convolution kernel.

## MagickConvolveImageChannel

MagickConvolveImageChannel() applies a custom convolution kernel to one or more image channels.

The format of the MagickConvolveImage method is:

      MagickBooleanType MagickConvolveImageChannel(MagickWand *wand,
        const ChannelType channel,const unsigned long order,
        const double *kernel)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

The channel.

#### order

The number of columns and rows in the filter kernel.

#### kernel

An array of doubles representing the convolution kernel.

## MagickCropImage

MagickCropImage() extracts a region of the image.

The format of the MagickCropImage method is:

      MagickBooleanType MagickCropImage(MagickWand *wand,
        const unsigned long width,const unsigned long height,const long x,
        const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### width

The region width.

#### height

The region height.

#### x

The region x offset.

#### y

The region y offset.

## MagickCycleColormapImage

MagickCycleColormapImage() displaces an image's colormap by a given number of positions. If you cycle the colormap a number of times you can produce a psychodelic effect.

The format of the MagickCycleColormapImage method is:

      MagickBooleanType MagickCycleColormapImage(MagickWand *wand,
        const long displace)

A description of each parameter follows:

#### wand

The magick wand.

#### pixel_wand

The pixel wand.

## MagickConstituteImage

MagickConstituteImage() adds an image to the wand comprised of the the pixel data you supply. The pixel data must be in scanline order top-to-bottom. The data can be char, short int, int, float, or double. Float and double require the pixels to be normalized [0..1], otherwise [0..Max], where Max is the maximum value the type can accomodate (e.g. 255 for char). For example, to create a 640x480 image from unsigned red-green-blue character data, use

MagickConstituteImage(wand,640,640,"RGB",CharPixel,pixels);

The format of the MagickConstituteImage method is:

      MagickBooleanType MagickConstituteImage(MagickWand *wand,
        const unsigned long columns,const unsigned long rows,const char *map,
        const StorageType storage,void *pixels)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

width in pixels of the image.

#### rows

height in pixels of the image.

#### 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 (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.

#### storage

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.

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

## MagickDeconstructImages

MagickDeconstructImages() compares each image with the next in a sequence and returns the maximum bounding region of any pixel differences it discovers.

The format of the MagickDeconstructImages method is:

      MagickWand *MagickDeconstructImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickDespeckleImage

MagickDespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.

The format of the MagickDespeckleImage method is:

      MagickBooleanType MagickDespeckleImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickDisplayImage

MagickDisplayImage() displays an image.

The format of the MagickDisplayImage method is:

      MagickBooleanType MagickDisplayImage(MagickWand *wand,
        const char *server_name)

A description of each parameter follows:

#### wand

The magick wand.

#### server_name

The X server name.

## MagickDisplayImages

MagickDisplayImages() displays an image or image sequence.

The format of the MagickDisplayImages method is:

      MagickBooleanType MagickDisplayImages(MagickWand *wand,
        const char *server_name)

A description of each parameter follows:

#### wand

The magick wand.

#### server_name

The X server name.

## MagickDrawImage

MagickDrawImage() renders the drawing wand on the current image.

The format of the MagickDrawImage method is:

      MagickBooleanType MagickDrawImage(MagickWand *wand,
        const DrawingWand *drawing_wand)

A description of each parameter follows:

#### wand

The magick wand.

#### drawing_wand

The draw wand.

## MagickEdgeImage

MagickEdgeImage() enhance edges within the image with a convolution filter of the given radius. Use a radius of 0 and Edge() selects a suitable radius for you.

The format of the MagickEdgeImage method is:

      MagickBooleanType MagickEdgeImage(MagickWand *wand,const double radius)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

the radius of the pixel neighborhood.

## MagickEmbossImage

MagickEmbossImage() returns a grayscale image with a three-dimensional effect. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and Emboss() selects a suitable radius for you.

The format of the MagickEmbossImage method is:

      MagickBooleanType MagickEmbossImage(MagickWand *wand,const double radius,
        const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

## MagickEnhanceImage

MagickEnhanceImage() applies a digital filter that improves the quality of a noisy image.

The format of the MagickEnhanceImage method is:

      MagickBooleanType MagickEnhanceImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickEqualizeImage

MagickEqualizeImage() equalizes the image histogram.

The format of the MagickEqualizeImage method is:

      MagickBooleanType MagickEqualizeImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickEvaluateImage

MagickEvaluateImage() applys an arithmetic, relational, or logical expression to an image. Use these operators to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.

The format of the MagickEvaluateImage method is:

      MagickBooleanType MagickEvaluateImage(MagickWand *wand,
        const MagickEvaluateOperator op,const double constant)

A description of each parameter follows:

#### wand

The magick wand.

#### op

A channel operator.

#### constant

A constant value.

## MagickFlattenImages

MagickFlattenImages() merges a sequence of images. This is useful for combining Photoshop layers into a single image.

The format of the MagickFlattenImages method is:

      MagickWand *MagickFlattenImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickFlipImage

MagickFlipImage() creates a vertical mirror image by reflecting the pixels around the central x-axis.

The format of the MagickFlipImage method is:

      MagickBooleanType MagickFlipImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickFlopImage

MagickFlopImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis.

The format of the MagickFlopImage method is:

      MagickBooleanType MagickFlopImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickFrameImage

MagickFrameImage() adds a simulated three-dimensional border around the image. The width and height specify the border width of the vertical and horizontal sides of the frame. The inner and outer bevels indicate the width of the inner and outer shadows of the frame.

The format of the MagickFrameImage method is:

      MagickBooleanType MagickFrameImage(MagickWand *wand,
        const PixelWand *matte_color,const unsigned long width,
        const unsigned long height,const long inner_bevel,
        const long outer_bevel)

A description of each parameter follows:

#### wand

The magick wand.

#### matte_color

The frame color pixel wand.

#### width

The border width.

#### height

The border height.

#### inner_bevel

The inner bevel width.

#### outer_bevel

The outer bevel width.

## MagickFxImage

MagickFxImage() evaluate expression for each pixel in the image.

The format of the MagickFxImage method is:

      MagickWand *MagickFxImage(MagickWand *wand,const char *expression)

A description of each parameter follows:

#### wand

The magick wand.

#### expression

The expression.

## MagickFxImageChannel

MagickFxImageChannel() evaluate expression for each pixel in the specified channel.

The format of the MagickFxImageChannel method is:

      MagickWand *MagickFxImageChannel(MagickWand *wand,
        const ChannelType channel,const char *expression)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### expression

The expression.

## MagickGammaImage

MagickGammaImage() gamma-corrects an image. The same image viewed on different devices will have perceptual differences in the way the image's intensities are represented on the screen. Specify individual gamma levels for the red, green, and blue channels, or adjust all three with the gamma parameter. Values typically range from 0.8 to 2.3.

You can also reduce the influence of a particular channel with a gamma value of 0.

The format of the MagickGammaImage method is:

      MagickBooleanType MagickGammaImage(MagickWand *wand,const double gamma)

A description of each parameter follows:

#### wand

The magick wand.

#### gamma

Define the level of gamma correction.

## MagickGammaImageChannel

MagickGammaImageChannel() gamma-corrects a particular image channel. The same image viewed on different devices will have perceptual differences in the way the image's intensities are represented on the screen. Specify individual gamma levels for the red, green, and blue channels, or adjust all three with the gamma parameter. Values typically range from 0.8 to 2.3.

You can also reduce the influence of a particular channel with a gamma value of 0.

The format of the MagickGammaImageChannel method is:

      MagickBooleanType MagickGammaImageChannel(MagickWand *wand,
        const ChannelType channel,const double gamma)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

The channel.

#### level

Define the level of gamma correction.

## MagickGaussianBlurImage

MagickGaussianBlurImage() blurs an image. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and MagickGaussianBlurImage() selects a suitable radius for you.

The format of the MagickGaussianBlurImage method is:

      MagickBooleanType MagickGaussianBlurImage(MagickWand *wand,
        const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

## MagickGaussianBlurImageChannel

MagickGaussianBlurImageChannel() blurs one or more image channels. We convolve the image cnannel with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and MagickGaussianBlurImageChannel() selects a suitable radius for you.

The format of the MagickGaussianBlurImageChannel method is:

      MagickBooleanType MagickGaussianBlurImageChannel(MagickWand *wand,
        const ChannelType channel,const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

## MagickGetCopyright

MagickGetCopyright() returns the ImageMagick API copyright as a string constant.

The format of the MagickGetCopyright method is:

      const char *MagickGetCopyright(void)

## MagickGetException

MagickGetException() returns the severity, reason, and description of any error that occurs when using other methods in this API.

The format of the MagickGetException method is:

      char *MagickGetException(MagickWand *wand,ExceptionType *severity)

A description of each parameter follows:

#### wand

The magick wand.

#### severity

The severity of the error is returned here.

## MagickGetFilename

MagickGetFilename() returns the filename associated with an image sequence.

The format of the MagickGetFilename method is:

      const char *MagickGetFilename(const MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetFormat

MagickGetFormat() returns the format of the magick wand.

The format of the MagickGetFormat method is:

      const char MagickGetFormat(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetHomeURL

MagickGetHomeURL() returns the ImageMagick home URL.

The format of the MagickGetHomeURL method is:

      char *MagickGetHomeURL(void)

## MagickGetImage

MagickGetImage() gets the image at the current image index.

The format of the MagickGetImage method is:

      MagickWand *MagickGetImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageRegion

MagickGetImageRegion() extracts a region of the image and returns it as a a new wand.

The format of the MagickGetImageRegion method is:

      MagickBooleanType MagickGetImageRegion(MagickWand *wand,
        const unsigned long width,const unsigned long height,const long x,
        const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### width

The region width.

#### height

The region height.

#### x

The region x offset.

#### y

The region y offset.

## MagickGetImageBackgroundColor

MagickGetImageBackgroundColor() returns the image background color.

The format of the MagickGetImageBackgroundColor method is:

      MagickBooleanType MagickGetImageBackgroundColor(MagickWand *wand,
        PixelWand *background_color)

A description of each parameter follows:

#### wand

The magick wand.

#### background_color

Return the background color.

## MagickGetImageBlob

MagickGetImageBlob() implements direct to memory image formats. It returns the image as a blob and its length. The format of the image determines the format of the returned blob (GIF, JPEG, PNG, etc.). To return a different image format, use MagickSetImageFormat().

The format of the MagickGetImageBlob method is:

      unsigned char *MagickGetImageBlob(MagickWand *wand,size_t *length)

A description of each parameter follows:

#### wand

The magick wand.

#### length

The length of the blob.

## MagickGetImageBlob

MagickGetImageBlob() implements direct to memory image formats. It returns the image sequence as a blob and its length. The format of the image determines the format of the returned blob (GIF, JPEG, PNG, etc.). To return a different image format, use MagickSetImageFormat().

Note, some image formats do not permit multiple images to the same image stream (e.g. JPEG). in this instance, just the first image of the sequence is returned as a blob.

The format of the MagickGetImagesBlob method is:

      unsigned char *MagickGetImagesBlob(MagickWand *wand,size_t *length)

A description of each parameter follows:

#### wand

The magick wand.

#### length

The length of the blob.

## MagickGetImageBluePrimary

MagickGetImageBluePrimary() returns the chromaticy blue primary point for the image.

The format of the MagickGetImageBluePrimary method is:

      MagickBooleanType MagickGetImageBluePrimary(MagickWand *wand,double *x,
        double *y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The chromaticity blue primary x-point.

#### y

The chromaticity blue primary y-point.

## MagickGetImageBorderColor

MagickGetImageBorderColor() returns the image border color.

The format of the MagickGetImageBorderColor method is:

      MagickBooleanType MagickGetImageBorderColor(MagickWand *wand,
        PixelWand *border_color)

A description of each parameter follows:

#### wand

The magick wand.

#### border_color

Return the border color.

## MagickGetImageChannelDepth

MagickGetImageChannelDepth() gets the depth for a particular image channel.

The format of the MagickGetImageChannelDepth method is:

      unsigned long MagickGetImageChannelDepth(MagickWand *wand,
        const ChannelType channel)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

## MagickGetImageChannelDistortion

MagickGetImageChannelDistortion() compares one or more image channels of an image to a reconstructed image and returns the specified distortion metric.

The format of the MagickGetImageChannelDistortion method is:

      MagickBooleanType MagickGetImageChannelDistortion(MagickWand *wand,
        const MagickWand *reference,const ChannelType channel,
        const MetricType metric,double *distortion)

A description of each parameter follows:

#### wand

The magick wand.

#### reference

The reference wand.

#### channel

The channel.

#### metric

The metric.

#### distortion

The computed distortion between the images.

## MagickGetImageChannelExtrema

MagickGetImageChannelExtrema() gets the extrema for one or more image channels.

The format of the MagickGetImageChannelExtrema method is:

      MagickBooleanType MagickGetImageChannelExtrema(MagickWand *wand,
        const ChannelType channel,unsigned long *minima,unsigned long *maxima)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### minima

The minimum pixel value for the specified channel(s).

#### maxima

The maximum pixel value for the specified channel(s).

## MagickGetImageChannelMean

MagickGetImageChannelMean() gets the mean and standard deviation of one or more image channels.

The format of the MagickGetImageChannelMean method is:

      MagickBooleanType MagickGetImageChannelMean(MagickWand *wand,
        const ChannelType channel,double *mean,double *standard_deviation)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### mean

The mean pixel value for the specified channel(s).

#### standard_deviation

The standard deviation for the specified channel(s).

## MagickGetImageChannelStatistics

MagickGetImageChannelStatistics() returns statistics for each channel in the image. The statistics incude the channel depth, its minima and maxima, the mean, and the standard deviation. You can access the red channel mean, for example, like this:

      channel_statistics=MagickGetImageChannelStatistics(image,excepton);
      red_mean=channel_statistics[RedChannel].mean;

Use MagickRelinquishMemory() to free the statistics buffer.

The format of the MagickGetImageChannelStatistics method is:

      ChannelStatistics *MagickGetImageChannelStatistics(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageColormapColor

MagickGetImageColormapColor() returns the color of the specified colormap index.

The format of the MagickGetImageColormapColor method is:

      MagickBooleanType MagickGetImageColormapColor(MagickWand *wand,
        const unsigned long index,PixelWand *color)

A description of each parameter follows:

#### wand

The magick wand.

#### index

The offset into the image colormap.

#### color

Return the colormap color in this wand.

## MagickGetImageColors

MagickGetImageColors() gets the number of unique colors in the image.

The format of the MagickGetImageColors method is:

      unsigned long MagickGetImageColors(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageColorspace

MagickGetImageColorspace() gets the image colorspace.

The format of the MagickGetImageColorspace method is:

      ColorspaceType MagickGetImageColorspace(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageCompose

MagickGetImageCompose() returns the composite operator associated with the image.

The format of the MagickGetImageCompose method is:

      CompositeOperator MagickGetImageCompose(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageCompression

MagickGetImageCompression() gets the image compression.

The format of the MagickGetImageCompression method is:

      CompressionType MagickGetImageCompression(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageCompression

MagickGetImageCompression() gets the image compression quality.

The format of the MagickGetImageCompression method is:

      unsigned long MagickGetImageCompression(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageDelay

MagickGetImageDelay() gets the image delay.

The format of the MagickGetImageDelay method is:

      unsigned long MagickGetImageDelay(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageDepth

MagickGetImageDepth() gets the image depth.

The format of the MagickGetImageDepth method is:

      unsigned long MagickGetImageDepth(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageDistortion

MagickGetImageDistortion() compares an image to a reconstructed image and returns the specified distortion metric.

The format of the MagickGetImageDistortion method is:

      MagickBooleanType MagickGetImageDistortion(MagickWand *wand,
        const MagickWand *reference,const MetricType metric,
        double *distortion)

A description of each parameter follows:

#### wand

The magick wand.

#### reference

The reference wand.

#### metric

The metric.

#### distortion

The computed distortion between the images.

## MagickGetImageExtrema

MagickGetImageExtrema() gets the extrema for the image.

The format of the MagickGetImageExtrema method is:

      MagickBooleanType MagickGetImageExtrema(MagickWand *wand,
        unsigned long *min,unsigned long *max)

A description of each parameter follows:

#### wand

The magick wand.

#### min

The minimum pixel value for the specified channel(s).

#### max

The maximum pixel value for the specified channel(s).

## MagickGetImageDispose

MagickGetImageDispose() gets the image disposal method.

The format of the MagickGetImageDispose method is:

      DisposeType MagickGetImageDispose(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageAttribute

MagickGetImageAttribute() returns a value associated with the specified key.

The format of the MagickGetImageAttribute method is:

      char *MagickGetImageAttribute(MagickWand *wand,const char *key)

A description of each parameter follows:

#### wand

The magick wand.

#### key

The key.

## MagickGetImageFilename

MagickGetImageFilename() returns the filename of a particular image in a sequence.

The format of the MagickGetImageFilename method is:

      char *MagickGetImageFilename(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageFormat

MagickGetImageFormat() returns the format of a particular image in a sequence.

The format of the MagickGetImageFormat method is:

      const char MagickGetImageFormat(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageGamma

MagickGetImageGamma() gets the image gamma.

The format of the MagickGetImageGamma method is:

      double MagickGetImageGamma(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageGreenPrimary

MagickGetImageGreenPrimary() returns the chromaticy green primary point.

The format of the MagickGetImageGreenPrimary method is:

      MagickBooleanType MagickGetImageGreenPrimary(MagickWand *wand,double *x,
        double *y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The chromaticity green primary x-point.

#### y

The chromaticity green primary y-point.

## MagickGetImageHeight

MagickGetImageHeight() returns the image height.

The format of the MagickGetImageHeight method is:

      unsigned long MagickGetImageHeight(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageHistogram

MagickGetImageHistogram() returns the image histogram as an array of PixelWand wands.

The format of the MagickGetImageHistogram method is:

      PixelWand *MagickGetImageHistogram(MagickWand *wand,
        unsigned long *number_colors)

A description of each parameter follows:

#### wand

The magick wand.

#### number_colors

The number of unique colors in the image and the number of pixel wands returned.

## MagickGetImageIndex

MagickGetImageIndex() returns the index of the current image.

The format of the MagickGetImageIndex method is:

      MagickBooleanType MagickGetImageIndex(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageInterlaceScheme

MagickGetImageInterlaceScheme() gets the image interlace scheme.

The format of the MagickGetImageInterlaceScheme method is:

      InterlaceType MagickGetImageInterlaceScheme(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageIterations

MagickGetImageIterations() gets the image iterations.

The format of the MagickGetImageIterations method is:

      unsigned long MagickGetImageIterations(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageMatteColor

MagickGetImageMatteColor() returns the image matte color.

The format of the MagickGetImageMatteColor method is:

      MagickBooleanType MagickGetImagematteColor(MagickWand *wand,
        PixelWand *matte_color)

A description of each parameter follows:

#### wand

The magick wand.

#### matte_color

Return the matte color.

## MagickGetImagePixels

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

      MagickGetImagePixels(wand,0,0,640,1,"RGB",CharPixel,pixels);

The format of the MagickGetImagePixels method is:

      MagickBooleanType MagickGetImagePixels(MagickWand *wand,
        const long x_offset,const long y_offset,const unsigned long columns,
        const unsigned long rows,const char *map,const StorageType storage,
        void *pixels)

A description of each parameter follows:

#### wand

The magick wand.

#### 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 (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.

#### storage

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.

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

## MagickGetImageProfile

MagickGetImageProfile() returns the named image profile.

The format of the MagickGetImageProfile method is:

      unsigned char *MagickGetImageProfile(MagickWand *wand,const char *name,
        unsigned long *length)

A description of each parameter follows:

#### wand

The magick wand.

#### name

Name of profile to return: ICC, IPTC, or generic profile.

#### length

The length of the profile.

## MagickGetImageRedPrimary

MagickGetImageRedPrimary() returns the chromaticy red primary point.

The format of the MagickGetImageRedPrimary method is:

      MagickBooleanType MagickGetImageRedPrimary(MagickWand *wand,double *x,
        double *y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The chromaticity red primary x-point.

#### y

The chromaticity red primary y-point.

## MagickGetImageRenderingIntent

MagickGetImageRenderingIntent() gets the image rendering intent.

The format of the MagickGetImageRenderingIntent method is:

      RenderingIntent MagickGetImageRenderingIntent(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageXResolution

MagickGetImageXResolution() gets the image X and Y resolution.

The format of the MagickGetImageXResolution method is:

      MagickBooleanType MagickGetImageXResolution(MagickWand *wand,double *x,
        double *y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The image x-resolution.

#### y

The image y-resolution.

## MagickGetImageScene

MagickGetImageScene() gets the image scene.

The format of the MagickGetImageScene method is:

      unsigned long MagickGetImageScene(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageSignature

MagickGetImageSignature() generates an SHA-256 message digest for the image pixel stream.

The format of the MagickGetImageSignature method is:

      const char MagickGetImageSignature(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageSize

MagickGetImageSize() returns the image size.

The format of the MagickGetImageSize method is:

      MagickSizeType MagickGetImageSize(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageType

MagickGetImageType() gets the potential image type:

Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte

To ensure the image type matches its potential, use MagickSetImageType():

          (void) MagickSetImageType(wand,MagickGetImageType(wand));

The format of the MagickGetImageType method is:

      ImageType MagickGetImageType(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageUnits

MagickGetImageUnits() gets the image units of resolution.

The format of the MagickGetImageUnits method is:

      ResolutionType MagickGetImageUnits(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageVirtualPixelMethod

MagickGetImageVirtualPixelMethod() returns the virtual pixel method for the sepcified image.

The format of the MagickGetImageVirtualPixelMethod method is:

      VirtualPixelMethod MagickGetImageVirtualPixelMethod(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetImageWhitePoint

MagickGetImageWhitePoint() returns the chromaticy white point.

The format of the MagickGetImageWhitePoint method is:

      MagickBooleanType MagickGetImageWhitePoint(MagickWand *wand,double *x,
        double *y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The chromaticity white x-point.

#### y

The chromaticity white y-point.

## MagickGetImageWidth

MagickGetImageWidth() returns the image width.

The format of the MagickGetImageWidth method is:

      unsigned long MagickGetImageWidth(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetInterlaceScheme

MagickGetInterlaceScheme() gets the wand interlace scheme.

The format of the MagickGetInterlaceScheme method is:

      InterlaceType MagickGetInterlaceScheme(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetNumberImages

MagickGetNumberImages() returns the number of images associated with a magick wand.

The format of the MagickGetNumberImages method is:

      unsigned long MagickGetNumberImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetName

MagickGetName() returns the ImageMagick package name as a string constant.

The format of the MagickGetName method is:

      const char *MagickGetName(void)

## MagickGetQuantumDepth

MagickGetQuantumDepth() returns the ImageMagick quantum depth as a string constant.

The format of the MagickGetQuantumDepth method is:

      const char *MagickGetQuantumDepth(unsigned long *depth)

A description of each parameter follows:

#### depth

The quantum depth is returned as a number.

## MagickGetQuantumRange

MagickGetQuantumRange() returns the ImageMagick quantum range as a string constant.

The format of the MagickGetQuantumRange method is:

      const char *MagickGetQuantumRange(unsigned long *range)

A description of each parameter follows:

#### range

The quantum range is returned as a number.

## MagickGetReleaseDate

MagickGetReleaseDate() returns the ImageMagick release date as a string constant.

The format of the MagickGetReleaseDate method is:

      const char *MagickGetReleaseDate(void)

## MagickGetResourceLimit

MagickGetResourceLimit() returns the the specified resource in megabytes.

The format of the MagickGetResourceLimit method is:

      unsigned long MagickGetResourceLimit(const ResourceType type)

A description of each parameter follows:

#### wand

The magick wand.

## MagickGetSamplingFactors

MagickGetSamplingFactors() gets the horizontal and vertical sampling factor.

The format of the MagickGetSamplingFactors method is:

      double *MagickGetSamplingFactor(MagickWand *wand,
        unsigned long *number_factors)

A description of each parameter follows:

#### wand

The magick wand.

#### number_factors

The number of factors in the returned array.

## MagickGetSize

MagickGetSize() returns the size associated with the magick wand.

The format of the MagickGetSize method is:

      MagickBooleanType MagickGetSize(const MagickWand *wand,
        unsigned long *columns,unsigned long *rows)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

The width in pixels.

#### height

The height in pixels.

## MagickGetVersion

MagickGetVersion() returns the ImageMagick API version as a string constant and as a number.

The format of the MagickGetVersion method is:

      const char *MagickGetVersion(unsigned long *version)

A description of each parameter follows:

#### version

The ImageMagick version is returned as a number.

## MagickHasNextImage

MagickHasNextImage() returns MagickTrue if the wand has more images when traversing the list in the forward direction

The format of the MagickHasNextImage method is:

      MagickBooleanType MagickHasNextImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickHasPreviousImage

MagickHasPreviousImage() returns MagickTrue if the wand has more images when traversing the list in the reverse direction

The format of the MagickHasPreviousImage method is:

      MagickBooleanType MagickHasPreviousImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickIdentifyImage

MagickIdentifyImage() identifies an image by printing its attributes to the file. Attributes include the image width, height, size, and others.

The format of the MagickIdentifyImage method is:

      const char *MagickIdentifyImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickImplodeImage

MagickImplodeImage() creates a new image that is a copy of an existing one with the image pixels "implode" by the specified percentage. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

The format of the MagickImplodeImage method is:

      MagickBooleanType MagickImplodeImage(MagickWand *wand,
        const double radius)

A description of each parameter follows:

#### wand

The magick wand.

#### amount

Define the extent of the implosion.

## MagickLabelImage

MagickLabelImage() adds a label to your image.

The format of the MagickLabelImage method is:

      MagickBooleanType MagickLabelImage(MagickWand *wand,const char *label)

A description of each parameter follows:

#### wand

The magick wand.

#### label

The image label.

## MagickLevelImage

MagickLevelImage() adjusts the levels of an image by scaling the colors falling between specified white and black points to the full available quantum range. The parameters provided represent the black, mid, and white points. The black point specifies the darkest color in the image. Colors darker than the black point are set to zero. Mid point specifies a gamma correction to apply to the image. White point specifies the lightest color in the image. Colors brighter than the white point are set to the maximum quantum value.

The format of the MagickLevelImage method is:

      MagickBooleanType MagickLevelImage(MagickWand *wand,
        const double black_point,const double gamma,const double white_point)

A description of each parameter follows:

#### wand

The magick wand.

#### black_point

The black point.

#### gamma

The gamma.

#### white_point

The white point.

## MagickLevelImageChannel

MagickLevelImageChannel() adjusts the levels of the specified channel of the reference image by scaling the colors falling between specified white and black points to the full available quantum range. The parameters provided represent the black, mid, and white points. The black point specifies the darkest color in the image. Colors darker than the black point are set to zero. Mid point specifies a gamma correction to apply to the image. White point specifies the lightest color in the image. Colors brighter than the white point are set to the maximum quantum value.

The format of the MagickLevelImageChannel method is:

      MagickBooleanType MagickLevelImageChannel(MagickWand *wand,
        const ChannelType channel,const double black_point,const double gamma,
        const double white_point)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### black_point

The black point.

#### gamma

The gamma.

#### white_point

The white point.

## MagickMagnifyImage

MagickMagnifyImage() is a convenience method that scales an image proportionally to twice its original size.

The format of the MagickMagnifyImage method is:

      MagickBooleanType MagickMagnifyImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickMapImage

MagickMapImage() replaces the colors of an image with the closest color from a reference image.

The format of the MagickMapImage method is:

      MagickBooleanType MagickMapImage(MagickWand *wand,
        const MagickWand *map_wand,const MagickBooleanType dither)

A description of each parameter follows:

#### wand

The magick wand.

#### map

The map wand.

#### dither

Set this integer value to something other than zero to dither the mapped image.

## MagickMatteFloodfillImage

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.

The format of the MagickMatteFloodfillImage method is:

      MagickBooleanType MagickMatteFloodfillImage(MagickWand *wand,
        const Quantum opacity,const double fuzz,const PixelWand *bordercolor,
        const long x,const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### opacity

The opacity.

#### fuzz

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.

#### bordercolor

The border color pixel wand.

#### x,y

The starting location of the operation.

## MagickMedianFilterImage

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.

The format of the MagickMedianFilterImage method is:

      MagickBooleanType MagickMedianFilterImage(MagickWand *wand,
        const double radius)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the pixel neighborhood.

## MagickMinifyImage

MagickMinifyImage() is a convenience method that scales an image proportionally to one-half its original size

The format of the MagickMinifyImage method is:

      MagickBooleanType MagickMinifyImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickModulateImage

MagickModulateImage() lets you control the brightness, saturation, and hue of an image. Hue is the percentage of absolute rotation from the current position. For example 50 results in a counter-clockwise rotation of 90 degrees, 150 results in a clockwise rotation of 90 degrees, with 0 and 200 both resulting in a rotation of 180 degrees.

To increase the color brightness by 20 and decrease the color saturation by 10 and leave the hue unchanged, use: 120,90,100.

The format of the MagickModulateImage method is:

      MagickBooleanType MagickModulateImage(MagickWand *wand,
        const double brightness,const double saturation,const double hue)

A description of each parameter follows:

#### wand

The magick wand.

#### brightness

The percent change in brighness.

#### saturation

The percent change in saturation.

#### hue

The percent change in hue.

## MagickMontageImage

MagickMontageImage() creates a composite image by combining several separate images. The images are tiled on the composite image with the name of the image optionally appearing just below the individual tile.

The format of the MagickMontageImage method is:

      MagickWand *MagickMontageImage(MagickWand *wand,
        const DrawingWand drawing_wand,const char *tile_geometry,
        const char *thumbnail_geometry,const MontageMode mode,
        const char *frame)

A description of each parameter follows:

#### wand

The magick wand.

#### drawing_wand

The drawing wand. The font name, size, and color are obtained from this wand.

#### tile_geometry

the number of tiles per row and page (e.g. 6x4+0+0).

#### thumbnail_geometry

Preferred image size and border size of each thumbnail (e.g. 120x120+4+3>).

#### mode

Thumbnail framing mode: Frame, Unframe, or Concatenate.

#### frame

Surround the image with an ornamental border (e.g. 15x15+3+3). The frame color is that of the thumbnail's matte color.

## MagickMorphImages

MagickMorphImages() method morphs a set of images. Both the image pixels and size are linearly interpolated to give the appearance of a meta-morphosis from one image to the next.

The format of the MagickMorphImages method is:

      MagickWand *MagickMorphImages(MagickWand *wand,
        const unsigned long number_frames)

A description of each parameter follows:

#### wand

The magick wand.

#### number_frames

The number of in-between images to generate.

## MagickMosaicImages

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.

The format of the MagickMosaicImages method is:

      MagickWand *MagickMosaicImages(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickMotionBlurImage

MagickMotionBlurImage() simulates motion blur. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and MotionBlurImage() selects a suitable radius for you. Angle gives the angle of the blurring motion.

The format of the MagickMotionBlurImage method is:

      MagickBooleanType MagickMotionBlurImage(MagickWand *wand,
        const double radius,const double sigma,const double angle)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

#### angle

Apply the effect along this angle.

## MagickNegateImage

MagickNegateImage() negates the colors in the reference image. The Grayscale option means that only grayscale values within the image are negated.

You can also reduce the influence of a particular channel with a gamma value of 0.

The format of the MagickNegateImage method is:

      MagickBooleanType MagickNegateImage(MagickWand *wand,
        const MagickBooleanType gray)

A description of each parameter follows:

#### wand

The magick wand.

#### gray

If MagickTrue, only negate grayscale pixels within the image.

## MagickNegateImage

MagickNegateImage() negates the colors in the specified channel of the reference image. The Grayscale option means that only grayscale values within the image are negated.

You can also reduce the influence of a particular channel with a gamma value of 0.

The format of the MagickNegateImage method is:

      MagickBooleanType MagickNegateImage(MagickWand *wand,
        const ChannelType channel,const MagickBooleanType gray)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### gray

If MagickTrue, only negate grayscale pixels within the image.

## MagickNewImage

MagickNewImage() adds a blank image canvas of the specified size and background color to the wand.

The format of the MagickNewImage method is:

      MagickBooleanType MagickNewImage(MagickWand *wand,
        const unsigned long columns,const unsigned long rows,
        const PixelWand *background)

A description of each parameter follows:

#### wand

The magick wand.

#### width

The image width.

#### height

The image height.

#### background

The image color.

## MagickNextImage

MagickNextImage() associates the next image in the image list with a magick wand.

The format of the MagickNextImage method is:

      MagickBooleanType MagickNextImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickNormalizeImage

MagickNormalizeImage() enhances the contrast of a color image by adjusting the pixels color to span the entire range of colors available

You can also reduce the influence of a particular channel with a gamma value of 0.

The format of the MagickNormalizeImage method is:

      MagickBooleanType MagickNormalizeImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickOilPaintImage

MagickOilPaintImage() applies a special effect filter that simulates an oil painting. Each pixel is replaced by the most frequent color occurring in a circular region defined by radius.

The format of the MagickOilPaintImage method is:

      MagickBooleanType MagickOilPaintImage(MagickWand *wand,
        const double radius)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the circular neighborhood.

## MagickPaintOpaqueImage

MagickPaintOpaqueImage() changes any pixel that matches color with the color defined by fill.

The format of the MagickPaintOpaqueImage method is:

      MagickBooleanType MagickPaintOpaqueImage(MagickWand *wand,
        const PixelWand *target,const PixelWand *fill,const double fuzz)

A description of each parameter follows:

#### wand

The magick wand.

#### target

Change this target color to the fill color within the image.

#### fill

The fill pixel wand.

#### fuzz

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.

## MagickPaintTransparentImage

MagickPaintTransparentImage() changes any pixel that matches color with the color defined by fill.

The format of the MagickPaintTransparentImage method is:

      MagickBooleanType MagickPaintTransparentImage(MagickWand *wand,
        const PixelWand *target,const Quantum opacity,const double fuzz)

A description of each parameter follows:

#### wand

The magick wand.

#### target

Change this target color to specified opacity value within the image.

#### opacity

The replacement opacity value.

#### fuzz

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.

## MagickPingImage

MagickPingImage() is like MagickReadImage() except the only valid information returned is the image width, height, size, and format. It is designed to efficiently obtain this information from a file without reading the entire image sequence into memory.

The format of the MagickPingImage method is:

      MagickBooleanType MagickPingImage(MagickWand *wand,const char *filename)

A description of each parameter follows:

#### wand

The magick wand.

#### filename

The image filename.

## MagickPosterizeImage

MagickPosterizeImage() reduces the image to a limited number of color level.

The format of the MagickPosterizeImage method is:

      MagickBooleanType MagickPosterizeImage(MagickWand *wand,
        const unsigned levels,const MagickBooleanType dither)

A description of each parameter follows:

#### wand

The magick wand.

#### levels

Number of color levels allowed in each channel. Very low values (2, 3, or 4) have the most visible effect.

#### dither

Set this integer value to something other than zero to dither the mapped image.

## MagickPreviewImages

MagickPreviewImages() tiles 9 thumbnails of the specified image with an image processing operation applied at varying strengths. This is helpful to quickly pin-point an appropriate parameter for an image processing operation.

The format of the MagickPreviewImages method is:

      MagickWand *MagickPreviewImages(MagickWand *wand,
        const PreviewType preview)

A description of each parameter follows:

#### wand

The magick wand.

#### preview

The preview type.

## MagickPreviousImage

MagickPreviousImage() assocates the previous image in an image list with the magick wand.

The format of the MagickPreviousImage method is:

      MagickBooleanType MagickPreviousImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickProfileImage

MagickProfileImage() adds or removes a ICC, IPTC, or generic profile from an image. If the profile is NULL, it is removed from the image otherwise added. Use a name of '*' and a profile of NULL to remove all profiles from the image.

The format of the MagickProfileImage method is:

      MagickBooleanType MagickProfileImage(MagickWand *wand,const char *name,
        const void *profile,const unsigned long length)

A description of each parameter follows:

#### wand

The magick wand.

#### name

Name of profile to add or remove: ICC, IPTC, or generic profile.

#### profile

The profile.

#### length

The length of the profile.

## MagickQuantizeImage

MagickQuantizeImage() analyzes the colors within a reference image and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time.

The format of the MagickQuantizeImage method is:

      MagickBooleanType MagickQuantizeImage(MagickWand *wand,
        const unsigned long number_colors,const ColorspaceType colorspace,
        const unsigned long treedepth,const MagickBooleanType dither,
        const MagickBooleanType measure_error)

A description of each parameter follows:

#### wand

The magick wand.

#### number_colors

The number of colors.

#### colorspace

Perform color reduction in this colorspace, typically RGBColorspace.

#### treedepth

Normally, this integer value is zero or one. A zero or one tells Quantize to choose a optimal tree depth of Log4(number_colors). A tree of this depth generally allows the best representation of the reference image with the least amount of memory and the fastest computational speed. In some cases, such as an image with low color dispersion (a few number of colors), a value other than Log4(number_colors) is required. To expand the color tree completely, use a value of 8.

#### dither

A value other than zero distributes the difference between an original image and the corresponding color reduced image to neighboring pixels along a Hilbert curve.

#### measure_error

A value other than zero 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.

## MagickQuantizeImages

MagickQuantizeImages() analyzes the colors within a sequence of images and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time.

The format of the MagickQuantizeImages method is:

      MagickBooleanType MagickQuantizeImages(MagickWand *wand,
        const unsigned long number_colors,const ColorspaceType colorspace,
        const unsigned long treedepth,const MagickBooleanType dither,
        const MagickBooleanType measure_error)

A description of each parameter follows:

#### wand

The magick wand.

#### number_colors

The number of colors.

#### colorspace

Perform color reduction in this colorspace, typically RGBColorspace.

#### treedepth

Normally, this integer value is zero or one. A zero or one tells Quantize to choose a optimal tree depth of Log4(number_colors). A tree of this depth generally allows the best representation of the reference image with the least amount of memory and the fastest computational speed. In some cases, such as an image with low color dispersion (a few number of colors), a value other than Log4(number_colors) is required. To expand the color tree completely, use a value of 8.

#### dither

A value other than zero distributes the difference between an original image and the corresponding color reduced algorithm to neighboring pixels along a Hilbert curve.

#### measure_error

A value other than zero 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.

## MagickQueryConfigureOption

MagickQueryConfigureOption() returns the value associated with the specified configure option.

The format of the MagickQueryConfigureOption function is:

      char *MagickQueryConfigureOption(const char *option)

A description of each parameter follows:

#### option

The option name.

## MagickQueryConfigureOptions

MagickQueryConfigureOptions() returns any configure options that match the specified pattern (e.g. "*" for all). Options include NAME, VERSION, LIB_VERSION, etc.

The format of the MagickQueryConfigureOptions function is:

      char **MagickQueryConfigureOptions(const char *pattern,
        unsigned long *number_options)

A description of each parameter follows:

#### pattern

Specifies a pointer to a text string containing a pattern.

#### number_options

Returns the number of configure options in the list.

## MagickQueryFontMetrics

MagickQueryFontMetrics() returns a 7 element array representing the following font metrics:

          Element Description
          -------------------------------------------------
          0 character width
          1 character height
          2 ascender
          3 descender
          4 text width
          5 text height
          6 maximum horizontal advance

The format of the MagickQueryFontMetrics method is:

      double *MagickQueryFontMetrics(MagickWand *wand,
        const DrawingWand *drawing_wand,const char *text)

A description of each parameter follows:

#### wand

The Magick wand.

#### drawing_wand

The drawing wand.

#### text

The text.

## MagickQueryMultilineFontMetrics

MagickQueryMultilineFontMetrics() returns a 7 element array representing the following font metrics:

          Element Description
          -------------------------------------------------
          0 character width
          1 character height
          2 ascender
          3 descender
          4 text width
          5 text height
          6 maximum horizontal advance

This method is like MagickQueryFontMetrics() but it returns the maximum text width and height for multiple lines of text.

The format of the MagickQueryFontMetrics method is:

      double *MagickQueryMultilineFontMetrics(MagickWand *wand,
        const DrawingWand *drawing_wand,const char *text)

A description of each parameter follows:

#### wand

The Magick wand.

#### drawing_wand

The drawing wand.

#### text

The text.

## MagickQueryFonts

MagickQueryFonts() returns any font that match the specified pattern (e.g. "*" for all).

The format of the MagickQueryFonts function is:

      char **MagickQueryFonts(const char *pattern,unsigned long *number_fonts)

A description of each parameter follows:

#### pattern

Specifies a pointer to a text string containing a pattern.

#### number_fonts

Returns the number of fonts in the list.

## MagickQueryFonts

MagickQueryFonts() returns any image formats that match the specified pattern (e.g. "*" for all).

The format of the MagickQueryFonts function is:

      char **MagickQueryFonts(const char *pattern,
        unsigned long *number_formats)

A description of each parameter follows:

#### pattern

Specifies a pointer to a text string containing a pattern.

#### number_formats

This integer returns the number of image formats in the list.

## MagickRadialBlurImage

MagickRadialBlurImage() radial blurs an image.

The format of the MagickRadialBlurImage method is:

      MagickBooleanType MagickRadialBlurImage(MagickWand *wand,
        const double angle)

A description of each parameter follows:

#### wand

The magick wand.

#### angle

The angle of the blur in degrees.

## MagickRaiseImage

MagickRaiseImage() creates a simulated three-dimensional button-like effect by lightening and darkening the edges of the image. Members width and height of raise_info define the width of the vertical and horizontal edge of the effect.

The format of the MagickRaiseImage method is:

      MagickBooleanType MagickRaiseImage(MagickWand *wand,
        const unsigned long width,const unsigned long height,const long x,
        const long y,const MagickBooleanType raise)

A description of each parameter follows:

#### wand

The magick wand.

#### width,height,x,y

Define the dimensions of the area to raise.

#### raise

A value other than zero creates a 3-D raise effect, otherwise it has a lowered effect.

## MagickReadImage

MagickReadImage() reads an image or image sequence.

The format of the MagickReadImage method is:

      MagickBooleanType MagickReadImage(MagickWand *wand,const char *filename)

A description of each parameter follows:

#### wand

The magick wand.

#### filename

The image filename.

## MagickReadImageBlob

MagickReadImageBlob() reads an image or image sequence from a blob.

The format of the MagickReadImageBlob method is:

      MagickBooleanType MagickReadImageBlob(MagickWand *wand,
        const void *blob,const size_t length)

A description of each parameter follows:

#### wand

The magick wand.

#### blob

The blob.

#### length

The blob length.

## MagickReadImageFile

MagickReadImageFile() reads an image or image sequence from an open file descriptor.

The format of the MagickReadImageFile method is:

      MagickBooleanType MagickReadImageFile(MagickWand *wand,FILE *file)

A description of each parameter follows:

#### wand

The magick wand.

#### file

The file descriptor.

## MagickReduceNoiseImage

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.

The format of the MagickReduceNoiseImage method is:

      MagickBooleanType MagickReduceNoiseImage(MagickWand *wand,
        const double radius)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the pixel neighborhood.

## MagickRelinquishMemory

MagickRelinquishMemory() relinquishes memory resources returned by such methods as MagickIdentifyImage(), MagickGetException(), etc.

The format of the MagickRelinquishMemory method is:

      void *MagickRelinquishMemory(void *resource)

A description of each parameter follows:

#### resource

Relinquish the memory associated with this resource.

## MagickRemoveImage

MagickRemoveImage() removes an image from the image list.

The format of the MagickRemoveImage method is:

      MagickBooleanType MagickRemoveImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

#### insert

The splice wand.

## MagickRemoveImageProfile

MagickRemoveImageProfile() removes the named image profile and returns it.

The format of the MagickRemoveImageProfile method is:

      unsigned char *MagickRemoveImageProfile(MagickWand *wand,
        const char *name,unsigned long *length)

A description of each parameter follows:

#### wand

The magick wand.

#### name

Name of profile to return: ICC, IPTC, or generic profile.

#### length

The length of the profile.

## MagickResetIterator

MagickResetIterator() resets the wand iterator. Use it in conjunction with MagickNextImage() to iterate over all the images in a wand container.

The format of the MagickResetIterator method is:

      void MagickResetIterator(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickResampleImage

MagickResampleImage() resample image to desired resolution.

Bessel Blackman Box Catrom Cubic Gaussian Hanning Hermite Lanczos Mitchell Point Quandratic Sinc Triangle

Most of the filters are FIR (finite impulse response), however, Bessel, Gaussian, and Sinc are IIR (infinite impulse response). Bessel and Sinc are windowed (brought down to zero) with the Blackman filter.

The format of the MagickResampleImage method is:

      MagickBooleanType MagickResampleImage(MagickWand *wand,
        const double x_resolution,const double y_resolution,
        const FilterTypes filter,const double blur)

A description of each parameter follows:

#### wand

The magick wand.

#### x_resolution

The new image x resolution.

#### y_resolution

The new image y resolution.

#### filter

Image filter to use.

#### blur

The blur factor where > 1 is blurry, < 1 is sharp.

## MagickResizeImage

MagickResizeImage() scales an image to the desired dimensions with one of these filters:

          Bessel   Blackman   Box
          Catrom   CubicGaussian
          Hanning  Hermite    Lanczos
          Mitchell PointQuandratic
          Sinc     Triangle

Most of the filters are FIR (finite impulse response), however, Bessel, Gaussian, and Sinc are IIR (infinite impulse response). Bessel and Sinc are windowed (brought down to zero) with the Blackman filter.

The format of the MagickResizeImage method is:

      MagickBooleanType MagickResizeImage(MagickWand *wand,
        const unsigned long columns,const unsigned long rows,
        const FilterTypes filter,const double blur)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

The number of columns in the scaled image.

#### rows

The number of rows in the scaled image.

#### filter

Image filter to use.

#### blur

The blur factor where > 1 is blurry, < 1 is sharp.

## MagickRollImage

MagickRollImage() offsets an image as defined by x_offset and y_offset.

The format of the MagickRollImage method is:

      MagickBooleanType MagickRollImage(MagickWand *wand,const long x_offset,
        const unsigned long y_offset)

A description of each parameter follows:

#### wand

The magick wand.

#### x_offset

The x offset.

#### y_offset

The y offset.

## MagickRotateImage

MagickRotateImage() rotates an image the specified number of degrees. Empty triangles left over from rotating the image are filled with the background color.

The format of the MagickRotateImage method is:

      MagickBooleanType MagickRotateImage(MagickWand *wand,
        const PixelWand *background,const double degrees)

A description of each parameter follows:

#### wand

The magick wand.

#### background

The background pixel wand.

#### degrees

The number of degrees to rotate the image.

## MagickSampleImage

MagickSampleImage() scales an image to the desired dimensions with pixel sampling. Unlike other scaling methods, this method does not introduce any additional color into the scaled image.

The format of the MagickSampleImage method is:

      MagickBooleanType MagickSampleImage(MagickWand *wand,
        const unsigned long columns,const unsigned long rows)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

The number of columns in the scaled image.

#### rows

The number of rows in the scaled image.

## MagickScaleImage

MagickScaleImage() scales the size of an image to the given dimensions.

The format of the MagickScaleImage method is:

      MagickBooleanType MagickScaleImage(MagickWand *wand,
        const unsigned long columns,const unsigned long rows)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

The number of columns in the scaled image.

#### rows

The number of rows in the scaled image.

## MagickChannelImage

MagickChannelImage() separates a channel from the image and returns a grayscale image. A channel is a particular color component of each pixel in the image.

The format of the MagickChannelImage method is:

      MagickBooleanType MagickSeparateImageChannel(MagickWand *wand,
        const ChannelType channel)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

## MagickSolarizeImage

MagickSolarizeImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by sepia toning. Threshold ranges from 0 to QuantumRange and is a measure of the extent of the sepia toning. A threshold of 80 is a good starting point for a reasonable tone.

The format of the MagickSolarizeImage method is:

      MagickBooleanType MagickSolarizeImage(MagickWand *wand,
        const double threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### threshold

Define the extent of the sepia toning.

## MagickSetCompressionQuality

MagickSetCompressionQuality() sets the image compression quality.

The format of the MagickSetImageCompressionQuality method is:

      MagickBooleanType MagickSetCompressionQuality(MagickWand *wand,
        const unsigned long quality)

A description of each parameter follows:

#### wand

The magick wand.

#### quality

The image compression quality.

## MagickSetFilename

MagickSetFilename() sets the filename before you read or write an image file.

The format of the MagickSetFilename method is:

      MagickBooleanType MagickSetFilename(MagickWand *wand,
        const char *filename)

A description of each parameter follows:

#### wand

The magick wand.

#### filename

The image filename.

## MagickSetFirstIterator

MagickSetFirstIterator() sets the wand iterator to the first image.

The format of the MagickSetFirstIterator method is:

      void MagickSetFirstIterator(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickSetFormat

MagickSetFormat() sets the format of the magick wand.

The format of the MagickSetFormat method is:

      MagickBooleanType MagickSetFormat(MagickWand *wand,const char *format)

A description of each parameter follows:

#### wand

The magick wand.

#### format

The image format.

## MagickSetImage

MagickSetImage() replaces the last image returned by MagickSetImageIndex(), MagickNextImage(), MagickPreviousImage() with the images from the specified wand.

The format of the MagickSetImage method is:

      MagickBooleanType MagickSetImage(MagickWand *wand,
        const MagickWand *set_wand)

A description of each parameter follows:

#### wand

The magick wand.

#### set_wand

The set_wand wand.

## MagickSetImageBackgroundColor

MagickSetImageBackgroundColor() sets the image background color.

The format of the MagickSetImageBackgroundColor method is:

      MagickBooleanType MagickSetImageBackgroundColor(MagickWand *wand,
        const PixelWand *background)

A description of each parameter follows:

#### wand

The magick wand.

#### background

The background pixel wand.

## MagickSetImageBias

MagickSetImageBias() sets the image bias for any method that convolves an image (e.g. MagickConvolveImage()).

The format of the MagickSetImageBias method is:

      MagickBooleanType MagickSetImageBias(MagickWand *wand,
        const double bias)

A description of each parameter follows:

#### wand

The magick wand.

#### bias

The image bias.

## MagickSetImageBluePrimary

MagickSetImageBluePrimary() sets the image chromaticity blue primary point.

The format of the MagickSetImageBluePrimary method is:

      MagickBooleanType MagickSetImageBluePrimary(MagickWand *wand,
        const double x,const double y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The blue primary x-point.

#### y

The blue primary y-point.

## MagickSetImageBorderColor

MagickSetImageBorderColor() sets the image border color.

The format of the MagickSetImageBorderColor method is:

      MagickBooleanType MagickSetImageBorderColor(MagickWand *wand,
        const PixelWand *border)

A description of each parameter follows:

#### wand

The magick wand.

#### border

The border pixel wand.

## MagickSetImageChannelDepth

MagickSetImageChannelDepth() sets the depth of a particular image channel.

The format of the MagickSetImageChannelDepth method is:

      MagickBooleanType MagickSetImageChannelDepth(MagickWand *wand,
        const ChannelType channel,const unsigned long depth)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### depth

The image depth in bits.

## MagickSetImageColormapColor

MagickSetImageColormapColor() sets the color of the specified colormap index.

The format of the MagickSetImageColormapColor method is:

      MagickBooleanType MagickSetImageColormapColor(MagickWand *wand,
        const unsigned long index,const PixelWand *color)

A description of each parameter follows:

#### wand

The magick wand.

#### index

The offset into the image colormap.

#### color

Return the colormap color in this wand.

## MagickSetImageColorspace

MagickSetImageColorspace() sets the image colorspace.

The format of the MagickSetImageColorspace method is:

      MagickBooleanType MagickSetImageColorspace(MagickWand *wand,
        const ColorspaceType colorspace)

A description of each parameter follows:

#### wand

The magick wand.

#### colorspace

The image colorspace: UndefinedColorspace, RGBColorspace, GRAYColorspace, TransparentColorspace, OHTAColorspace, XYZColorspace, YCbCrColorspace, YCCColorspace, YIQColorspace, YPbPrColorspace, YPbPrColorspace, YUVColorspace, CMYKColorspace, sRGBColorspace, HSLColorspace, or HWBColorspace.

## MagickSetImageCompose

MagickSetImageCompose() sets the image composite operator, useful for specifying how to composite the image thumbnail when using the MagickMontageImage() method.

The format of the MagickSetImageCompose method is:

      MagickBooleanType MagickSetImageCompose(MagickWand *wand,
        const CompositeOperator compose)

A description of each parameter follows:

#### wand

The magick wand.

#### compose

The image composite operator.

## MagickSetImageCompression

MagickSetImageCompression() sets the image compression.

The format of the MagickSetImageCompression method is:

      MagickBooleanType MagickSetImageCompression(MagickWand *wand,
        const CompressionType compression)

A description of each parameter follows:

#### wand

The magick wand.

#### compression

The image compression type.

## MagickSetImageCompressionQuality

MagickSetImageCompressionQuality() sets the image compression quality.

The format of the MagickSetImageCompressionQuality method is:

      MagickBooleanType MagickSetImageCompressionQuality(MagickWand *wand,
        const unsigned long quality)

A description of each parameter follows:

#### wand

The magick wand.

#### quality

The image compression tlityype.

## MagickSetImageDelay

MagickSetImageDelay() sets the image delay.

The format of the MagickSetImageDelay method is:

      MagickBooleanType MagickSetImageDelay(MagickWand *wand,
        const unsigned long delay)

A description of each parameter follows:

#### wand

The magick wand.

#### delay

The image delay in 1/100th of a second.

## MagickSetImageDepth

MagickSetImageDepth() sets the image depth.

The format of the MagickSetImageDepth method is:

      MagickBooleanType MagickSetImageDepth(MagickWand *wand,
        const unsigned long depth)

A description of each parameter follows:

#### wand

The magick wand.

#### depth

The image depth in bits: 8, 16, or 32.

## MagickSetImageDispose

MagickSetImageDispose() sets the image disposal method.

The format of the MagickSetImageDispose method is:

      MagickBooleanType MagickSetImageDispose(MagickWand *wand,
        const DisposeType dispose)

A description of each parameter follows:

#### wand

The magick wand.

#### dispose

The image disposeal type.

## MagickSetImageFilename

MagickSetImageFilename() sets the filename of a particular image in a sequence.

The format of the MagickSetImageFilename method is:

      MagickBooleanType MagickSetImageFilename(MagickWand *wand,
        const char *filename)

A description of each parameter follows:

#### wand

The magick wand.

#### filename

The image filename.

## MagickSetImageFormat

MagickSetImageFormat() sets the format of a particular image in a sequence.

The format of the MagickSetImageFormat method is:

      MagickBooleanType MagickSetImageFormat(MagickWand *wand,
        const char *format)

A description of each parameter follows:

#### wand

The magick wand.

#### format

The image format.

## MagickSetImageGamma

MagickSetImageGamma() sets the image gamma.

The format of the MagickSetImageGamma method is:

      MagickBooleanType MagickSetImageGamma(MagickWand *wand,
        const double gamma)

A description of each parameter follows:

#### wand

The magick wand.

#### gamma

The image gamma.

## MagickSetImageGreenPrimary

MagickSetImageGreenPrimary() sets the image chromaticity green primary point.

The format of the MagickSetImageGreenPrimary method is:

      MagickBooleanType MagickSetImageGreenPrimary(MagickWand *wand,
        const double x,const double y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The green primary x-point.

#### y

The green primary y-point.

## MagickSetImageIndex

MagickSetImageIndex() set the current image to the position of the list specified with the index parameter.

The format of the MagickSetImageIndex method is:

      MagickBooleanType MagickSetImageIndex(MagickWand *wand,const long index)

A description of each parameter follows:

#### wand

The magick wand.

#### index

The scene number.

## MagickSetImageInterlaceScheme

MagickSetImageInterlaceScheme() sets the image compression.

The format of the MagickSetImageInterlaceScheme method is:

      MagickBooleanType MagickSetImageInterlaceScheme(MagickWand *wand,
        const InterlaceType interlace_scheme)

A description of each parameter follows:

#### wand

The magick wand.

#### interlace_scheme

The image interlace scheme: NoInterlace, LineInterlace, PlaneInterlace, PartitionInterlace.

## MagickSetImageIterations

MagickSetImageIterations() sets the image iterations.

The format of the MagickSetImageIterations method is:

      MagickBooleanType MagickSetImageIterations(MagickWand *wand,
        const unsigned long iterations)

A description of each parameter follows:

#### wand

The magick wand.

#### delay

The image delay in 1/100th of a second.

## MagickSetImageMatteColor

MagickSetImageMatteColor() sets the image matte color.

The format of the MagickSetImageMatteColor method is:

      MagickBooleanType MagickSetImageMatteColor(MagickWand *wand,
        const PixelWand *matte)

A description of each parameter follows:

#### wand

The magick wand.

#### matte

The matte pixel wand.

## MagickSetImageOption

MagickSetImageOption() associates one or options with a particular image format (.e.g MagickSetImageOption(wand,"jpeg","perserve","yes").

The format of the MagickSetImageOption method is:

      MagickBooleanType MagickSetImageOption(MagickWand *wand,
        const char *format,const char *key,const char *value)

A description of each parameter follows:

#### wand

The magick wand.

#### format

The image format.

#### key

The key.

#### value

The value.

## MagickSetImagePixels

MagickSetImagePixels() accepts pixel data and 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, long, float, or double in the order specified by map.

Suppose your want want to upload the first scanline of a 640x480 image from character data in red-green-blue order:

      MagickSetImagePixels(wand,0,0,0,640,1,"RGB",CharPixel,pixels);

The format of the MagickSetImagePixels method is:

      MagickBooleanType MagickSetImagePixels(MagickWand *wand,
        const long x_offset,const long y_offset,const unsigned long columns,
        const unsigned long rows,const char *map,const StorageType storage,
        const void *pixels)

A description of each parameter follows:

#### wand

The magick wand.

#### x_offset, y_offset, columns, rows

These values define the perimeter of a region of pixels you want to define.

#### 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 (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.

#### storage

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.

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

## MagickSetImageProfile

MagickSetImageProfile() adds a named profile to the magick wand. If a profile with the same name already exists, it is replaced. This method differs from the MagickProfileImage() method in that it does not apply any CMS color profiles.

The format of the MagickSetImageProfile method is:

      MagickBooleanType MagickSetImageProfile(MagickWand *wand,
        const char *name,const void *profile,const unsigned long length)

A description of each parameter follows:

#### wand

The magick wand.

#### name

Name of profile to add or remove: ICC, IPTC, or generic profile.

#### profile

The profile.

#### length

The length of the profile.

## MagickSetImageRedPrimary

MagickSetImageRedPrimary() sets the image chromaticity red primary point.

The format of the MagickSetImageRedPrimary method is:

      MagickBooleanType MagickSetImageRedPrimary(MagickWand *wand,
        const double x,const double y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The red primary x-point.

#### y

The red primary y-point.

## MagickSetImageRenderingIntent

MagickSetImageRenderingIntent() sets the image rendering intent.

The format of the MagickSetImageRenderingIntent method is:

      MagickBooleanType MagickSetImageRenderingIntent(MagickWand *wand,
        const RenderingIntent rendering_intent)

A description of each parameter follows:

#### wand

The magick wand.

#### rendering_intent

The image rendering intent: UndefinedIntent, SaturationIntent, PerceptualIntent, AbsoluteIntent, or RelativeIntent.

## MagickSetImageResolution

MagickSetImageResolution() sets the image resolution.

The format of the MagickSetImageResolution method is:

      MagickBooleanType MagickSetImageResolution(MagickWand *wand,
        const double x_resolution,const doubtl y_resolution)

A description of each parameter follows:

#### wand

The magick wand.

#### x_resolution

The image x resolution.

#### y_resolution

The image y resolution.

## MagickSetImageScene

MagickSetImageScene() sets the image scene.

The format of the MagickSetImageScene method is:

      MagickBooleanType MagickSetImageScene(MagickWand *wand,
        const unsigned long scene)

A description of each parameter follows:

#### wand

The magick wand.

#### delay

The image scene number.

## MagickSetImageType

MagickSetImageType() sets the image type.

The format of the MagickSetImageType method is:

      MagickBooleanType MagickSetImageType(MagickWand *wand,
        const ImageType image_type)

A description of each parameter follows:

#### wand

The magick wand.

#### image_type

The image type: UndefinedType, BilevelType, GrayscaleType, GrayscaleMatteType, PaletteType, PaletteMatteType, TrueColorType, TrueColorMatteType, ColorSeparationType, ColorSeparationMatteType, or OptimizeType.

## MagickSetImageUnits

MagickSetImageUnits() sets the image units of resolution.

The format of the MagickSetImageUnits method is:

      MagickBooleanType MagickSetImageUnits(MagickWand *wand,
        const ResolutionType units)

A description of each parameter follows:

#### wand

The magick wand.

#### units

The image units of resolution : UndefinedResolution, PixelsPerInchResolution, or PixelsPerCentimeterResolution.

## MagickSetImageVirtualPixelMethod

MagickSetImageVirtualPixelMethod() sets the image virtual pixel method.

The format of the MagickSetImageVirtualPixelMethod method is:

      MagickBooleanType MagickSetImageVirtualPixelMethod(MagickWand *wand,
        const VirtualPixelMethod method)

A description of each parameter follows:

#### wand

The magick wand.

#### method

The image virtual pixel method : UndefinedVirtualPixelMethod, ConstantVirtualPixelMethod, EdgeVirtualPixelMethod, MirrorVirtualPixelMethod, or TileVirtualPixelMethod.

## MagickSetInterlaceScheme

MagickSetInterlaceScheme() sets the image compression.

The format of the MagickSetInterlaceScheme method is:

      MagickBooleanType MagickSetInterlaceScheme(MagickWand *wand,
        const InterlaceType interlace_scheme)

A description of each parameter follows:

#### wand

The magick wand.

#### interlace_scheme

The image interlace scheme: NoInterlace, LineInterlace, PlaneInterlace, PartitionInterlace.

## MagickSetLastIterator

MagickSetLastIterator() sets the wand iterator to the last image.

The format of the MagickSetLastIterator method is:

      void MagickSetLastIterator(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickSetProgressMonitor

MagickSetProgressMonitor() sets the wand progress monitor to the specified method and returns the previous progress monitor if any. The progress monitor method looks like this:

          MagickBooleanType MagickProgressMonitor(const char *text,
      const MagickOffsetType offset,const MagickSizeType span,
      void *client_data)

If the progress monitor returns MagickFalse, the current operation is interrupted.

The format of the MagickSetProgressMonitor method is:

      MagickProgressMonitor MagickSetProgressMonitor(MagickWand *wand
        const MagickProgressMonitor progress_monitor,void *client_data)

A description of each parameter follows:

#### wand

The magick wand.

#### progress_monitor

Specifies a pointer to a method to monitor progress of an image operation.

#### client_data

Specifies a pointer to any client data.

## MagickSetResourceLimit

MagickSetResourceLimit() sets the limit for a particular resource in megabytes.

The format of the MagickSetResourceLimit method is:

      MagickBooleanType MagickSetResourceLimit(const ResourceType type,
        const unsigned long *limit)

A description of each parameter follows:

#### type

The type of resource: AreaResource, MemoryResource, MapResource, DiskResource, FileResource.

o The maximum limit for the resource.

## MagickSetSamplingFactors

MagickSetSamplingFactors() sets the image sampling factors.

The format of the MagickSetSamplingFactors method is:

      MagickBooleanType MagickSetSamplingFactors(MagickWand *wand,
        const unsigned long number_factors,const double *sampling_factors)

A description of each parameter follows:

#### wand

The magick wand.

#### number_factoes

The number of factors.

#### sampling_factors

An array of doubles representing the sampling factor for each color component (in RGB order).

## MagickSetSize

MagickSetSize() sets the size of the magick wand. Set it before you read a raw image format such as RGB, GRAY, or CMYK.

The format of the MagickSetSize method is:

      MagickBooleanType MagickSetSize(MagickWand *wand,
        const unsigned long columns,const unsigned long rows)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

The width in pixels.

#### height

The height in pixels.

## MagickSetImageWhitePoint

MagickSetImageWhitePoint() sets the image chromaticity white point.

The format of the MagickSetImageWhitePoint method is:

      MagickBooleanType MagickSetImageWhitePoint(MagickWand *wand,
        const double x,const double y)

A description of each parameter follows:

#### wand

The magick wand.

#### x

The white x-point.

#### y

The white y-point.

## MagickSetPassphrase

MagickSetPassphrase() sets the passphrase.

The format of the MagickSetPassphrase method is:

      MagickBooleanType MagickSetPassphrase(MagickWand *wand,
        const char *passphrase)

A description of each parameter follows:

#### wand

The magick wand.

#### passphrase

The passphrase.

## MagickSetResolution

MagickSetResolution() sets the image resolution.

The format of the MagickSetResolution method is:

      MagickBooleanType MagickSetResolution(MagickWand *wand,
        const double x_resolution,const doubtl y_resolution)

A description of each parameter follows:

#### wand

The magick wand.

#### x_resolution

The image x resolution.

#### y_resolution

The image y resolution.

## MagickShadowImage

MagickShadowImage() simulates an image shadow.

The format of the MagickShadowImage method is:

      MagickBooleanType MagickShadowImage(MagickWand *wand,
        const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

## MagickSharpenImage

MagickSharpenImage() sharpens an image. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and SharpenImage() selects a suitable radius for you.

The format of the MagickSharpenImage method is:

      MagickBooleanType MagickSharpenImage(MagickWand *wand,
        const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

## MagickSharpenImageChannel

MagickSharpenImageChannel() sharpens one or more image channels. We convolve the image cnannel with a gaussian operator of the given radius and standard deviation (sigma). For reasonable results, the radius should be larger than sigma. Use a radius of 0 and GaussinSharpenImageChannel() selects a suitable radius for you.

The format of the MagickSharpenImageChannel method is:

      MagickBooleanType MagickSharpenImageChannel(MagickWand *wand,
        const ChannelType channel,const double radius,const double sigma)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### radius

The radius of the , in pixels, not counting the center pixel.

#### sigma

The standard deviation of the , in pixels.

## MagickShaveImage

MagickShaveImage() shaves pixels from the image edges. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

The format of the MagickShaveImage method is:

      MagickBooleanType MagickShaveImage(MagickWand *wand,
        const unsigned long columns,const unsigned long rows)

A description of each parameter follows:

#### wand

The magick wand.

#### columns

The number of columns in the scaled image.

#### rows

The number of rows in the scaled image.

## MagickShearImage

MagickShearImage() slides one edge of an image along the X or Y axis, creating a parallelogram. An X direction shear slides an edge along the X axis, while a Y direction shear slides an edge along the Y axis. The amount of the shear is controlled by a shear angle. For X direction shears, x_shear is measured relative to the Y axis, and similarly, for Y direction shears y_shear is measured relative to the X axis. Empty triangles left over from shearing the image are filled with the background color.

The format of the MagickShearImage method is:

      MagickBooleanType MagickShearImage(MagickWand *wand,
        const PixelWand *background,const double x_shear,onst double y_shear)

A description of each parameter follows:

#### wand

The magick wand.

#### background

The background pixel wand.

#### x_shear

The number of degrees to shear the image.

#### y_shear

The number of degrees to shear the image.

## MagickSigmoidalContrastImage

MagickSigmoidalContrastImage() adjusts the contrast of an image with a non-linear sigmoidal contrast algorithm. Increase the contrast of the image using a sigmoidal transfer function without saturating highlights or shadows. Contrast indicates how much to increase the contrast (0 is none; 3 is typical; 20 is pushing it); mid-point indicates where midtones fall in the resultant image (0 is white; 50 is middle-gray; 100 is black). Set sharpen to MagickTrue to increase the image contrast otherwise the contrast is reduced.

The format of the MagickSigmoidalContrastImage method is:

      MagickBooleanType MagickSigmoidalContrastImage(MagickWand *wand,
        const MagickBooleanType sharpen,const double contrast,
        const double midpoint)

A description of each parameter follows:

#### wand

The magick wand.

#### sharpen

Increase or decrease image contrast.

#### contrast

control the "shoulder" of the contast curve.

#### midpoint

control the "toe" of the contast curve.

## MagickSigmoidalContrastImageChannel

MagickSigmoidalContrastImageChannel() adjusts the contrast of an image channel with a non-linear sigmoidal contrast algorithm. Increase the contrast of the image using a sigmoidal transfer function without saturating highlights or shadows. Contrast indicates how much to increase the contrast (0 is none; 3 is typical; 20 is pushing it); mid-point indicates where midtones fall in the resultant image (0 is white; 50 is middle-gray; 100 is black). Set sharpen to MagickTrue to increase the image contrast otherwise the contrast is reduced.

The format of the MagickSigmoidalContrastImageChannel method is:

      MagickBooleanType MagickSigmoidalContrastImageChannel(MagickWand *wand,
        const ChannelType channel,const MagickBooleanType sharpen,
        const double alpha,const double beta)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### sharpen

Increase or decrease image contrast.

#### alpha

control the "shoulder" of the contast curve.

#### beta

control the "toe" of the contast curve.

## MagickSolarizeImage

MagickSolarizeImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by selectively exposing areas of photo sensitive paper to light. Threshold ranges from 0 to QuantumRange and is a measure of the extent of the solarization.

The format of the MagickSolarizeImage method is:

      MagickBooleanType MagickSolarizeImage(MagickWand *wand,
        const double threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### threshold

Define the extent of the solarization.

## MagickSpliceImage

MagickSpliceImage() splices a solid color intop the image.

The format of the MagickSpliceImage method is:

      MagickBooleanType MagickSpliceImage(MagickWand *wand,
        const unsigned long width,const unsigned long height,const long x,
        const long y)

A description of each parameter follows:

#### wand

The magick wand.

#### width

The region width.

#### height

The region height.

#### x

The region x offset.

#### y

The region y offset.

## MagickSpreadImage

MagickSpreadImage() is a special effects method that randomly displaces each pixel in a block defined by the radius parameter.

The format of the MagickSpreadImage method is:

      MagickBooleanType MagickSpreadImage(MagickWand *wand,const double radius)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

Choose a random pixel in a neighborhood of this extent.

## MagickSteganoImage

MagickSteganoImage() hides a digital watermark within the image. Recover the hidden watermark later to prove that the authenticity of an image. Offset defines the start position within the image to hide the watermark.

The format of the MagickSteganoImage method is:

      MagickWand *MagickSteganoImage(MagickWand *wand,
        const MagickWand *watermark_wand,const long offset)

A description of each parameter follows:

#### wand

The magick wand.

#### watermark_wand

The watermark wand.

#### offset

Start hiding at this offset into the image.

## MagickStereoImage

MagickStereoImage() composites two images and produces a single image that is the composite of a left and right image of a stereo pair

The format of the MagickStereoImage method is:

      MagickWand *MagickStereoImage(MagickWand *wand,
        const MagickWand *offset_wand)

A description of each parameter follows:

#### wand

The magick wand.

#### offset_wand

Another image wand.

## MagickStripImage

MagickStripImage() strips an image of all profiles and comments.

The format of the MagickStripImage method is:

      MagickBooleanType MagickStripImage(MagickWand *wand)

A description of each parameter follows:

#### wand

The magick wand.

## MagickSwirlImage

MagickSwirlImage() swirls the pixels about the center of the image, where degrees indicates the sweep of the arc through which each pixel is moved. You get a more dramatic effect as the degrees move from 1 to 360.

The format of the MagickSwirlImage method is:

      MagickBooleanType MagickSwirlImage(MagickWand *wand,const double degrees)

A description of each parameter follows:

#### wand

The magick wand.

#### degrees

Define the tightness of the swirling effect.

## MagickTextureImage

MagickTextureImage() repeatedly tiles the texture image across and down the image canvas.

The format of the MagickTextureImage method is:

      MagickWand *MagickTextureImage(MagickWand *wand,
        const MagickWand *texture_wand)

A description of each parameter follows:

#### wand

The magick wand.

#### texture_wand

The texture wand

## MagickThresholdImage

MagickThresholdImage() 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 MagickThresholdImage method is:

      MagickBooleanType MagickThresholdImage(MagickWand *wand,
        const double threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### threshold

Define the threshold value.

## MagickThresholdImageChannel

MagickThresholdImageChannel() changes the value of individual pixel component based on the intensity of each pixel compared to threshold. The result is a high-contrast, two color image.

The format of the MagickThresholdImage method is:

      MagickBooleanType MagickThresholdImageChannel(MagickWand *wand,
        const ChannelType channel,const double threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

The channel.

#### threshold

Define the threshold value.

## MagickTintImage

MagickTintImage() applies a color vector to each pixel in the image. The length of the vector is 0 for black and white and at its maximum for the midtones. The vector weighting function is f(x)=(1-(4.0*((x-0.5)*(x-0.5)))).

The format of the MagickTintImage method is:

      MagickBooleanType MagickTintImage(MagickWand *wand,
        const PixelWand *tint,const PixelWand *opacity)

A description of each parameter follows:

#### wand

The magick wand.

#### tint

The tint pixel wand.

#### opacity

The opacity pixel wand.

## MagickTransformImage

MagickTransformImage() is a convenience method that behaves like MagickResizeImage() or MagickCropImage() but accepts scaling and/or cropping information as a region geometry specification. If the operation fails, the original image handle is returned.

The format of the MagickTransformImage method is:

      MagickWand *MagickTransformImage(MagickWand *wand,const char *crop,
        const char *geometry)

A description of each parameter follows:

#### wand

The magick wand.

#### crop

A crop geometry string. This geometry defines a subregion of the image to crop.

#### geometry

An image geometry string. This geometry defines the final size of the image.

## MagickTrimImage

MagickTrimImage() remove edges that are the background color from the image.

The format of the MagickTrimImage method is:

      MagickBooleanType MagickTrimImage(MagickWand *wand,const double fuzz)

A description of each parameter follows:

#### wand

The magick wand.

#### fuzz

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.

## MagickUnsharpMaskImage

MagickUnsharpMaskImage() sharpens an image. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and UnsharpMaskImage() selects a suitable radius for you.

The format of the MagickUnsharpMaskImage method is:

      MagickBooleanType MagickUnsharpMaskImage(MagickWand *wand,
        const double radius,const double sigma,const double amount,
        const double threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

#### amount

The percentage of the difference between the original and the blur image that is added back into the original.

#### threshold

The threshold in pixels needed to apply the diffence amount.

## MagickUnsharpMaskImageChannel

MagickUnsharpMaskImageChannel() sharpens one or more image channels. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and UnsharpMaskImage() selects a suitable radius for you.

The format of the MagickUnsharpMaskImageChannel method is:

      MagickBooleanType MagickUnsharpMaskImageChannel(MagickWand *wand,
        const ChannelType channel,const double radius,const double sigma,
        const double amount,const double threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### channel

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

#### radius

The radius of the Gaussian, in pixels, not counting the center pixel.

#### sigma

The standard deviation of the Gaussian, in pixels.

#### amount

The percentage of the difference between the original and the blur image that is added back into the original.

#### threshold

The threshold in pixels needed to apply the diffence amount.

## MagickWaveImage

MagickWaveImage() creates a "ripple" effect in the image by shifting the pixels vertically along a sine wave whose amplitude and wavelength is specified by the given parameters.

The format of the MagickWaveImage method is:

      MagickBooleanType MagickWaveImage(MagickWand *wand,const double amplitude,
        const double wave_length)

A description of each parameter follows:

#### wand

The magick wand.

#### amplitude, wave_length

Define the amplitude and wave length of the sine wave.

## MagickWhiteThresholdImage

MagickWhiteThresholdImage() is like ThresholdImage() but forces all pixels above the threshold into white while leaving all pixels below the threshold unchanged.

The format of the MagickWhiteThresholdImage method is:

      MagickBooleanType MagickWhiteThresholdImage(MagickWand *wand,
        const PixelWand *threshold)

A description of each parameter follows:

#### wand

The magick wand.

#### threshold

The pixel wand.

## MagickWriteImage

MagickWriteImage() writes an image to the specified filename. If the filename parameter is NULL, the image is written to the filename set by MagickReadImage() or MagickSetImageFilename().

The format of the MagickWriteImage method is:

      MagickBooleanType MagickWriteImage(MagickWand *wand,
        const char *filename)

A description of each parameter follows:

#### wand

The magick wand.

#### filename

The image filename.

## MagickWriteImageFile

MagickWriteImageFile() writes an image to an open file descriptor.

The format of the MagickWriteImageFile method is:

      MagickBooleanType MagickWriteImageFile(MagickWand *wand,FILE *file)

A description of each parameter follows:

#### wand

The magick wand.

#### file

The file descriptor.

## MagickWriteImages

MagickWriteImages() writes an image or image sequence.

The format of the MagickWriteImages method is:

      MagickBooleanType MagickWriteImages(MagickWand *wand,
        const char *filename,const MagickBooleanType adjoin)

A description of each parameter follows:

#### wand

The magick wand.

#### filename

The image filename.

#### adjoin

join images into a single multi-image file.

## MagickWriteImagesFile

MagickWriteImagesFile() writes an image sequence to an open file descriptor.

The format of the MagickWriteImagesFile method is:

      MagickBooleanType MagickWriteImagesFile(MagickWand *wand,FILE *file)

A description of each parameter follows:

#### wand

The magick wand.

#### file

The file descriptor.

## NewMagickWand

NewMagickWand() returns a wand required for all other methods in the API.

The format of the NewMagickWand method is:

      MagickWand NewMagickWand(void)

## NewMagickWandWithImage

NewMagickWandWithImage() returns a wand with an image.

The format of the NewMagickWandWithImage method is:

      MagickWand NewMagickWandWithImage(const Image *image)

A description of each parameter follows:

#### image

The image.

Discourse Server | Mailing Lists | Image Gallery | ImageMagick Studio
© 1999-2005 ImageMagick Studio LLC