GraphicsMagick
GraphicsMagick
Wand image processing interfaces
Contents
MagickWand *CloneMagickWand( const MagickWand *wand );
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:
The magick wand to clone.
void DestroyMagickWand( MagickWand *wand );
DestroyMagickWand() deallocates memory associated with an MagickWand.
The format of the DestroyMagickWand method is:
void DestroyMagickWand( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickAdaptiveThresholdImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long offset );
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 MagickAdaptiveThresholdImage method is:
unsigned int MagickAdaptiveThresholdImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long offset );
The magick wand.
The width of the local neighborhood.
The height of the local neighborhood.
The mean offset.
unsigned int MagickAddImage( MagickWand *wand, const MagickWand *add_wand );
MagickAddImage() adds the specified images at the current image location.
The format of the MagickAddImage method is:
unsigned int MagickAddImage( MagickWand *wand, const MagickWand *add_wand );
The magick wand.
The splice wand.
unsigned int MagickAddNoiseImage( MagickWand *wand, const NoiseType noise_type );
MagickAddNoiseImage() adds random noise to the image.
The format of the MagickAddNoiseImage method is:
unsigned int MagickAddNoiseImage( MagickWand *wand, const NoiseType noise_type );
The magick wand.
The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, Poisson, or Random.
unsigned int MagickAffineTransformImage( MagickWand *wand, const DrawingWand *drawing_wand );
MagickAffineTransformImage() transforms an image as dictated by the affine matrix of the drawing wand.
The format of the MagickAffineTransformImage method is:
unsigned int MagickAffineTransformImage( MagickWand *wand, const DrawingWand *drawing_wand );
The magick wand.
The draw wand.
unsigned int MagickAnnotateImage( MagickWand *wand, const DrawingWand *drawing_wand,
const double x, const double y, const double angle,
const char *text );
MagickAnnotateImage() annotates an image with text.
The format of the MagickAnnotateImage method is:
unsigned int MagickAnnotateImage( MagickWand *wand, const DrawingWand *drawing_wand,
const double x, const double y, const double angle,
const char *text );
The magick wand.
The draw wand.
x ordinate to left of text
y ordinate to text baseline
rotate text relative to this angle.
text to draw
unsigned int MagickAnimateImages( MagickWand *wand, const char *server_name );
MagickAnimateImages() animates an image or image sequence.
The format of the MagickAnimateImages method is:
unsigned int MagickAnimateImages( MagickWand *wand, const char *server_name );
The magick wand.
The X server name.
MagickWand *MagickAppendImages( MagickWand *wand, const unsigned int stack );
MagickAppendImages() append a set of images.
The format of the MagickAppendImages method is:
MagickWand *MagickAppendImages( MagickWand *wand, const unsigned int stack );
The magick wand.
By default, images are stacked left-to-right. Set stack to True to stack them top-to-bottom.
unsigned int MagickAutoOrientImage( MagickWand *wand,
const OrientationType current_orientation,
ExceptionInfo *exception );
MagickAutoOrientImage() adjusts the current image so that its orientation is suitable for viewing (i.e. top-left orientation).
The format of the MagickAutoOrientImage method is:
unsigned int MagickAutoOrientImage( MagickWand *wand,
const OrientationType current_orientation,
ExceptionInfo *exception );
The magick wand.
Current image orientation. May be one of: TopLeftOrientation Left to right and Top to bottom TopRightOrientation Right to left and Top to bottom BottomRightOrientation Right to left and Bottom to top BottomLeftOrientation Left to right and Bottom to top LeftTopOrientation Top to bottom and Left to right RightTopOrientation Top to bottom and Right to left RightBottomOrientation Bottom to top and Right to left LeftBottomOrientation Bottom to top and Left to right UndefinedOrientation Current orientation is not known. Use orientation defined by the current image if any. Equivalent to MagickGetImageOrientation().
Returns True on success, False otherwise.
Note that after successful auto-orientation the internal orientation will be set to TopLeftOrientation. However this internal value is only written to TIFF files. For JPEG files, there is currently no support for resetting the EXIF orientation tag to TopLeft so the JPEG should be stripped or EXIF profile removed if present to prevent saved auto-oriented images from being incorrectly rotated a second time by follow-on viewers that understand the EXIF orientation tag.
MagickWand *MagickAverageImages( MagickWand *wand );
MagickAverageImages() average a set of images.
The format of the MagickAverageImages method is:
MagickWand *MagickAverageImages( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickBlackThresholdImage( MagickWand *wand, const PixelWand *threshold );
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:
unsigned int MagickBlackThresholdImage( MagickWand *wand, const PixelWand *threshold );
The magick wand.
The pixel wand.
unsigned int MagickBlurImage( MagickWand *wand, const double radius, const double sigma );
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:
unsigned int MagickBlurImage( MagickWand *wand, const double radius, const double sigma );
The magick wand.
The radius of the Gaussian, in pixels, not counting the center pixel.
The standard deviation of the Gaussian, in pixels.
unsigned int MagickBorderImage( MagickWand *wand, const PixelWand *bordercolor,
const unsigned long width, const unsigned long height );
MagickBorderImage() surrounds the image with a border of the color defined by the bordercolor pixel wand.
The format of the MagickBorderImage method is:
unsigned int MagickBorderImage( MagickWand *wand, const PixelWand *bordercolor,
const unsigned long width, const unsigned long height );
The magick wand.
The border color pixel wand.
The border width.
The border height.
MagickPassFail MagickCdlImage( MagickWand *wand, const char *cdl );
The MagickCdlImage() method applies ("bakes in") the ASC-CDL which is a format for the exchange of basic primary color grading information between equipment and software from different manufacturers. The format defines the math for three functions: slope, offset and power. Each function uses a number for the red, green, and blue color channels for a total of nine numbers comprising a single color decision. A tenth number for chrominance (saturation) has been proposed but is not yet standardized.
The cdl argument string is comma delimited and is in the form (but without invervening spaces or line breaks):
redslope, redoffset, redpower : greenslope, greenoffset, greenpower : blueslope, blueoffset, bluepower : saturation
with the unity (no change) specification being:
"1.0,0.0,1.0:1.0,0.0,1.0:1.0,0.0,1.0:0.0"
See http://en.wikipedia.org/wiki/ASC_CDL for more information.
The format of the MagickCdlImage method is:
MagickPassFail MagickCdlImage( MagickWand *wand, const char *cdl );
A description of each parameter follows:
The image wand.
Define the coefficients for slope offset and power in the red green and blue channels, plus saturation.
unsigned int MagickCharcoalImage( MagickWand *wand, const double radius, const double sigma );
MagickCharcoalImage() simulates a charcoal drawing.
The format of the MagickCharcoalImage method is:
unsigned int MagickCharcoalImage( MagickWand *wand, const double radius, const double sigma );
The magick wand.
The radius of the Gaussian, in pixels, not counting the center pixel.
The standard deviation of the Gaussian, in pixels.
unsigned int MagickChopImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y );
MagickChopImage() removes a region of an image and collapses the image to occupy the removed portion
The format of the MagickChopImage method is:
unsigned int MagickChopImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y );
The magick wand.
The region width.
The region height.
The region x offset.
The region y offset.
void MagickClearException( MagickWand *wand );
MagickClearException() clears the last wand exception.
The format of the MagickClearException method is:
void MagickClearException( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickClipImage( MagickWand *wand );
MagickClipImage() clips along the first path from the 8BIM profile, if present.
The format of the MagickClipImage method is:
unsigned int MagickClipImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickClipPathImage( MagickWand *wand, const char *pathname,
const unsigned int inside );
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:
unsigned int MagickClipPathImage( MagickWand *wand, const char *pathname,
const unsigned int inside );
The magick wand.
name of clipping path resource. If name is preceded by #, use clipping path numbered by name.
if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.
MagickWand *MagickCoalesceImages( MagickWand *wand );
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:
The magick wand.
unsigned int MagickColorFloodfillImage( MagickWand *wand, const PixelWand *fill,
const double fuzz, const PixelWand *bordercolor,
const long x, const long y );
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:
unsigned int MagickColorFloodfillImage( MagickWand *wand, const PixelWand *fill,
const double fuzz, const PixelWand *bordercolor,
const long x, const long y );
The magick wand.
The floodfill color pixel wand.
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.
The border color pixel wand.
The starting location of the operation.
unsigned int MagickColorizeImage( MagickWand *wand, const PixelWand *colorize,
const PixelWand *opacity );
MagickColorizeImage() blends the fill color with each pixel in the image.
The format of the MagickColorizeImage method is:
unsigned int MagickColorizeImage( MagickWand *wand, const PixelWand *colorize,
const PixelWand *opacity );
The magick wand.
The colorize pixel wand.
The opacity pixel wand.
unsigned int MagickCommentImage( MagickWand *wand, const char *comment );
MagickCommentImage() adds a comment to your image.
The format of the MagickCommentImage method is:
unsigned int MagickCommentImage( MagickWand *wand, const char *comment );
A description of each parameter follows:
The magick wand.
The image comment.
MagickWand *MagickCompareImageChannels( MagickWand *wand, const MagickWand *reference,
const ChannelType channel, const MetricType metric,
double *distortion );
MagickCompareImageChannels() compares one or more image channels and returns the specified distortion metric.
The format of the MagickCompareImageChannels method is:
MagickWand *MagickCompareImageChannels( MagickWand *wand, const MagickWand *reference,
const ChannelType channel, const MetricType metric,
double *distortion );
The magick wand.
The reference wand.
The channel.
The metric.
The computed distortion between the images.
MagickWand *MagickCompareImages( MagickWand *wand, const MagickWand *reference,
const MetricType metric, double *distortion );
MagickCompareImage() compares one or more images and returns the specified distortion metric.
The format of the MagickCompareImages method is:
MagickWand *MagickCompareImages( MagickWand *wand, const MagickWand *reference,
const MetricType metric, double *distortion );
The magick wand.
The reference wand.
The metric.
The computed distortion between the images.
unsigned int MagickCompositeImage( MagickWand *wand, const MagickWand *composite_wand,
const CompositeOperator compose, const long x,
const long y );
MagickCompositeImage() composite one image onto another at the specified offset.
The format of the MagickCompositeImage method is:
unsigned int MagickCompositeImage( MagickWand *wand, const MagickWand *composite_wand,
const CompositeOperator compose, const long x,
const long y );
The magick wand.
The composite image.
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
The column offset of the composited image.
The row offset of the composited image.
unsigned int MagickContrastImage( MagickWand *wand, const unsigned int sharpen );
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:
unsigned int MagickContrastImage( MagickWand *wand, const unsigned int sharpen );
The magick wand.
Increase or decrease image contrast.
unsigned int MagickConvolveImage( MagickWand *wand, const unsigned long order,
const double *kernel );
MagickConvolveImage() applies a custom convolution kernel to the image.
The format of the MagickConvolveImage method is:
unsigned int MagickConvolveImage( MagickWand *wand, const unsigned long order,
const double *kernel );
The magick wand.
The number of columns and rows in the filter kernel.
An array of doubles representing the convolution kernel.
unsigned int MagickCropImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y );
MagickCropImage() extracts a region of the image.
The format of the MagickCropImage method is:
unsigned int MagickCropImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y );
The magick wand.
The region width.
The region height.
The region x offset.
The region y offset.
unsigned int MagickCycleColormapImage( MagickWand *wand, const long displace );
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:
unsigned int MagickCycleColormapImage( MagickWand *wand, const long displace );
The magick wand.
The pixel wand.
MagickWand *MagickDeconstructImages( MagickWand *wand );
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:
The magick wand.
const char *MagickDescribeImage( MagickWand *wand );
MagickDescribeImage() describes an image by formatting its attributes to an allocated string which must be freed by the user. Attributes include the image width, height, size, and others. The string is similar to the output of 'identify -verbose'.
The format of the MagickDescribeImage method is:
const char *MagickDescribeImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickDespeckleImage( MagickWand *wand );
MagickDespeckleImage() reduces the speckle noise in an image while perserving the edges of the original image.
The format of the MagickDespeckleImage method is:
unsigned int MagickDespeckleImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickDisplayImage( MagickWand *wand, const char *server_name );
MagickDisplayImage() displays an image.
The format of the MagickDisplayImage method is:
unsigned int MagickDisplayImage( MagickWand *wand, const char *server_name );
A description of each parameter follows:
The magick wand.
The X server name.
unsigned int MagickDisplayImages( MagickWand *wand, const char *server_name );
MagickDisplayImages() displays an image or image sequence.
The format of the MagickDisplayImages method is:
unsigned int MagickDisplayImages( MagickWand *wand, const char *server_name );
The magick wand.
The X server name.
unsigned int MagickDrawImage( MagickWand *wand, const DrawingWand *drawing_wand );
MagickDrawImage() draws vectors on the image as described by DrawingWand.
The format of the MagickDrawImage method is:
unsigned int MagickDrawImage( MagickWand *wand, const DrawingWand *drawing_wand );
The magick wand.
The draw wand.
unsigned int MagickEdgeImage( MagickWand *wand, const double radius );
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:
unsigned int MagickEdgeImage( MagickWand *wand, const double radius );
A description of each parameter follows:
The magick wand.
the radius of the pixel neighborhood.
unsigned int MagickEmbossImage( MagickWand *wand, const double radius, const double sigma );
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:
unsigned int MagickEmbossImage( MagickWand *wand, const double radius, const double sigma );
The magick wand.
The radius of the Gaussian, in pixels, not counting the center pixel.
The standard deviation of the Gaussian, in pixels.
unsigned int MagickEnhanceImage( MagickWand *wand );
MagickEnhanceImage() applies a digital filter that improves the quality of a noisy image.
The format of the MagickEnhanceImage method is:
unsigned int MagickEnhanceImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickEqualizeImage( MagickWand *wand );
MagickEqualizeImage() equalizes the image histogram.
The format of the MagickEqualizeImage method is:
unsigned int MagickEqualizeImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickExtentImage( MagickWand *wand, const size_t width, const size_t height,
const ssize_t x, const ssize_t y );
Use MagickExtentImage() to change the image dimensions as specified by geometry width and height. The existing image content is composited at the position specified by geometry x and y using the image compose method. Existing image content which falls outside the bounds of the new image dimensions is discarded.
The format of the MagickExtentImage method is:
unsigned int MagickExtentImage( MagickWand *wand, const size_t width, const size_t height,
const ssize_t x, const ssize_t y );
The magick wand.
New image width
New image height
Top left composition coordinate to place existing image content on the new image.
MagickWand *MagickFlattenImages( MagickWand *wand );
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:
The magick wand.
unsigned int MagickFlipImage( MagickWand *wand );
MagickFlipImage() creates a vertical mirror image by reflecting the pixels around the central x-axis.
The format of the MagickFlipImage method is:
unsigned int MagickFlipImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickFlopImage( MagickWand *wand );
MagickFlopImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis.
The format of the MagickFlopImage method is:
unsigned int MagickFlopImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickFrameImage( MagickWand *wand, const PixelWand *matte_color,
const unsigned long width, const unsigned long height,
const long inner_bevel, const long outer_bevel );
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:
unsigned int MagickFrameImage( MagickWand *wand, const PixelWand *matte_color,
const unsigned long width, const unsigned long height,
const long inner_bevel, const long outer_bevel );
The magick wand.
The frame color pixel wand.
The border width.
The border height.
The inner bevel width.
The outer bevel width.
MagickWand *MagickFxImage( MagickWand *wand, const char *expression );
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:
The magick wand.
The expression.
MagickWand *MagickFxImageChannel( MagickWand *wand, const ChannelType channel, const char *expression );
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 );
The magick wand.
Identify which channel to level: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, BlackChannel.
The expression.
unsigned int MagickGammaImage( MagickWand *wand, const double gamma );
Use MagickGammaImage() to gamma-correct 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:
unsigned int MagickGammaImage( MagickWand *wand, const double gamma );
A description of each parameter follows:
The magick wand.
Define the level of gamma correction.
unsigned int MagickGammaImageChannel( MagickWand *wand, const ChannelType channel, const double gamma );
Use MagickGammaImageChannel() to gamma-correct 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:
unsigned int MagickGammaImageChannel( MagickWand *wand, const ChannelType channel, const double gamma );
The magick wand.
The channel.
Define the level of gamma correction.
char *MagickGetConfigureInfo( MagickWand *wand, const char *name );
MagickGetConfigureInfo() returns ImageMagick configure attributes such as NAME, VERSION, LIB_VERSION, COPYRIGHT, etc.
The format of the MagickGetConfigureInfo() method is:
char *MagickGetConfigureInfo( MagickWand *wand, const char *name );
A description of each parameter follows:
The magick wand.
Return the attribute associated with this name.
const char *MagickGetCopyright( void );
MagickGetCopyright() returns the ImageMagick API copyright as a string.
The format of the MagickGetCopyright method is:
const char *MagickGetCopyright( void );
char *MagickGetException( const MagickWand *wand, ExceptionType *severity );
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( const MagickWand *wand, ExceptionType *severity );
A description of each parameter follows:
The magick wand.
The severity of the error is returned here.
const char *MagickGetFilename( const MagickWand *wand );
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:
The magick wand.
const char *MagickGetHomeURL( void );
MagickGetHomeURL() returns the ImageMagick home URL.
The format of the MagickGetHomeURL method is:
const char *MagickGetHomeURL( void );
MagickWand *MagickGetImage( MagickWand *wand );
MagickGetImage() clones the image at the current image index.
The format of the MagickGetImage method is:
MagickWand *MagickGetImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
char *MagickGetImageAttribute( MagickWand *wand, const char *name );
MagickGetImageAttribute returns an image attribute as a string
The format of the MagickGetImageAttribute method is:
char *MagickGetImageAttribute( MagickWand *wand, const char *name );
A description of each parameter follows:
The magick wand.
The name of the attribute
unsigned int MagickGetImageBackgroundColor( MagickWand *wand, PixelWand *background_color );
MagickGetImageBackgroundColor() returns the image background color.
The format of the MagickGetImageBackgroundColor method is:
unsigned int MagickGetImageBackgroundColor( MagickWand *wand, PixelWand *background_color );
The magick wand.
Return the background color.
unsigned int MagickGetImageBluePrimary( MagickWand *wand, double *x, double *y );
MagickGetImageBluePrimary() returns the chromaticy blue primary point for the image.
The format of the MagickGetImageBluePrimary method is:
unsigned int MagickGetImageBluePrimary( MagickWand *wand, double *x, double *y );
The magick wand.
The chromaticity blue primary x-point.
The chromaticity blue primary y-point.
unsigned int MagickGetImageBorderColor( MagickWand *wand, PixelWand *border_color );
MagickGetImageBorderColor() returns the image border color.
The format of the MagickGetImageBorderColor method is:
unsigned int MagickGetImageBorderColor( MagickWand *wand, PixelWand *border_color );
The magick wand.
Return the border color.
unsigned int MagickGetImageBoundingBox( MagickWand *wand, const double fuzz,
unsigned long *width, unsigned long *height,
long *x, long *y );
MagickGetImageBoundingBox() obtains the crop bounding box required to remove a solid-color border from the image. Color quantums which differ less than the fuzz setting are considered to be the same. If a border is not detected, then the the original image dimensions are returned. The crop bounding box estimation uses the same algorithm as MagickTrimImage().
The format of the MagickGetImageBoundingBox method is:
unsigned int MagickGetImageBoundingBox( MagickWand *wand, const double fuzz,
unsigned long *width, unsigned long *height,
long *x, long *y );
The magick wand.
Color comparison fuzz factor. Use 0.0 for exact match.
The crop width
The crop height
The crop x offset
The crop y offset
unsigned long MagickGetImageChannelDepth( MagickWand *wand, const ChannelType channel );
MagickGetImageChannelDepth() gets the depth for a particular image channel.
The format of the MagickGetImageChannelDepth method is:
unsigned long MagickGetImageChannelDepth( MagickWand *wand, const ChannelType channel );
The magick wand.
Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, BlackChannel.
unsigned int MagickGetImageChannelExtrema( MagickWand *wand, const ChannelType channel, unsigned long *minima, unsigned long *maxima );
MagickGetImageChannelExtrema() gets the extrema for one or more image channels.
The format of the MagickGetImageChannelExtrema method is:
unsigned int MagickGetImageChannelExtrema( MagickWand *wand, const ChannelType channel, unsigned long *minima, unsigned long *maxima );
The magick wand.
Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, or BlackChannel.
The minimum pixel value for the specified channel(s).
The maximum pixel value for the specified channel(s).
unsigned int MagickGetImageChannelMean( MagickWand *wand, const ChannelType channel, double *mean, double *standard_deviation );
MagickGetImageChannelMean() gets the mean and standard deviation of one or more image channels.
The format of the MagickGetImageChannelMean method is:
unsigned int MagickGetImageChannelMean( MagickWand *wand, const ChannelType channel, double *mean, double *standard_deviation );
The magick wand.
Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, or BlackChannel.
The mean pixel value for the specified channel(s).
The standard deviation for the specified channel(s).
unsigned int MagickGetImageColormapColor( MagickWand *wand, const unsigned long index,
PixelWand *color );
MagickGetImageColormapColor() returns the color of the specified colormap index.
The format of the MagickGetImageColormapColor method is:
unsigned int MagickGetImageColormapColor( MagickWand *wand, const unsigned long index,
PixelWand *color );
The magick wand.
The offset into the image colormap.
Return the colormap color in this wand.
unsigned long MagickGetImageColors( MagickWand *wand );
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:
The magick wand.
ColorspaceType MagickGetImageColorspace( MagickWand *wand );
MagickGetImageColorspace() gets the image colorspace.
The format of the MagickGetImageColorspace method is:
ColorspaceType MagickGetImageColorspace( MagickWand *wand );
A description of each parameter follows:
The magick wand.
CompositeOperator MagickGetImageCompose( MagickWand *wand );
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:
The magick wand.
CompressionType MagickGetImageCompression( MagickWand *wand );
MagickGetImageCompression() gets the image compression.
The format of the MagickGetImageCompression method is:
CompressionType MagickGetImageCompression( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned long MagickGetImageDelay( MagickWand *wand );
MagickGetImageDelay() gets the image delay.
The format of the MagickGetImageDelay method is:
unsigned long MagickGetImageDelay( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned long MagickGetImageDepth( MagickWand *wand );
MagickGetImageDepth() gets the image depth.
The format of the MagickGetImageDepth method is:
unsigned long MagickGetImageDepth( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickGetImageExtrema( MagickWand *wand, unsigned long *min,
unsigned long *max );
MagickGetImageExtrema() gets the extrema for the image.
The format of the MagickGetImageExtrema method is:
unsigned int MagickGetImageExtrema( MagickWand *wand, unsigned long *min,
unsigned long *max );
The magick wand.
The minimum pixel value for the specified channel(s).
The maximum pixel value for the specified channel(s).
DisposeType MagickGetImageDispose( MagickWand *wand );
MagickGetImageDispose() gets the image disposal method.
The format of the MagickGetImageDispose method is:
DisposeType MagickGetImageDispose( MagickWand *wand );
A description of each parameter follows:
The magick wand.
const char MagickGetImageFilename( MagickWand *wand );
MagickGetImageFilename() returns the filename of a particular image in a sequence.
The format of the MagickGetImageFilename method is:
const char MagickGetImageFilename( MagickWand *wand );
A description of each parameter follows:
The magick wand.
const char MagickGetImageFormat( MagickWand *wand );
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:
The magick wand.
double MagickGetImageFuzz( MagickWand *wand );
MagickGetImageFuzz() returns the color comparison fuzz factor. Colors closer than the fuzz factor are considered to be the same when comparing colors. Note that some other functions such as MagickColorFloodfillImage() implicitly set this value.
The format of the MagickGetImageFuzz method is:
double MagickGetImageFuzz( MagickWand *wand );
A description of each parameter follows:
The magick wand.
double MagickGetImageGamma( MagickWand *wand );
MagickGetImageGamma() gets the image gamma.
The format of the MagickGetImageGamma method is:
double MagickGetImageGamma( MagickWand *wand );
A description of each parameter follows:
The magick wand.
GravityType MagickGetImageGravity( MagickWand *wand );
MagickGetImageGravity() gets the image gravity.
The format of the MagickGetImageGravity method is:
GravityType MagickGetImageGravity( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickGetImageGreenPrimary( MagickWand *wand, double *x, double *y );
MagickGetImageGreenPrimary() returns the chromaticy green primary point.
The format of the MagickGetImageGreenPrimary method is:
unsigned int MagickGetImageGreenPrimary( MagickWand *wand, double *x, double *y );
The magick wand.
The chromaticity green primary x-point.
The chromaticity green primary y-point.
unsigned long MagickGetImageHeight( MagickWand *wand );
MagickGetImageHeight() returns the image height.
The format of the MagickGetImageHeight method is:
unsigned long MagickGetImageHeight( MagickWand *wand );
A description of each parameter follows:
The magick wand.
PixelWand *MagickGetImageHistogram( MagickWand *wand, unsigned long *number_colors );
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 );
The magick wand.
The number of unique colors in the image and the number of pixel wands returned.
unsigned int MagickGetImageIndex( MagickWand *wand );
MagickGetImageIndex() returns the index of the current image.
The format of the MagickGetImageIndex method is:
unsigned int MagickGetImageIndex( MagickWand *wand );
A description of each parameter follows:
The magick wand.
InterlaceType MagickGetImageInterlaceScheme( MagickWand *wand );
MagickGetImageInterlaceScheme() gets the image interlace scheme.
The format of the MagickGetImageInterlaceScheme method is:
InterlaceType MagickGetImageInterlaceScheme( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned long MagickGetImageIterations( MagickWand *wand );
MagickGetImageIterations() gets the image iterations.
The format of the MagickGetImageIterations method is:
unsigned long MagickGetImageIterations( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickGetImageMatteColor( MagickWand *wand, PixelWand *matte_color );
MagickGetImageMatteColor() returns the image matte color.
The format of the MagickGetImageMatteColor method is:
unsigned int MagickGetImageMatteColor( MagickWand *wand, PixelWand *matte_color );
The magick wand.
Return the matte color.
OrientationType MagickGetImageOrientation( MagickWand *wand );
MagickGetImageOrientation() gets the image orientation type. May be one of:
UndefinedOrientation Image orientation not specified or error. TopLeftOrientation Left to right and Top to bottom. TopRightOrientation Right to left and Top to bottom. BottomRightOrientation Right to left and Bottom to top. BottomLeftOrientation Left to right and Bottom to top. LeftTopOrientation Top to bottom and Left to right. RightTopOrientation Top to bottom and Right to left. RightBottomOrientation Bottom to top and Right to left. LeftBottomOrientation Bottom to top and Left to right.
The format of the MagickGetImageOrientation method is:
OrientationType MagickGetImageOrientation( MagickWand *wand );
A description of each parameter follows:
The magick wand.
MagickGetImagePage( MagickWand *wand, unsigned long *width, unsigned long *height, long *x,
long *y );
MagickGetImagePage() retrieves the image page size and offset used when placing (e.g. compositing) the image.
The format of the MagickGetImagePage method is:
MagickGetImagePage( MagickWand *wand, unsigned long *width, unsigned long *height, long *x,
long *y );
The magick wand.
The region size.
Offset (from top left) on base canvas image on which to composite image data.
unsigned int 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,
unsigned char *pixels );
MagickGetImagePixels() extracts pixel data from an image and returns it to you. The method returns False on success otherwise True if an error is encountered. The data is returned as char, short int, int, long, float, or double in the order specified by map.
Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:
MagickGetImagePixels(wand,0,0,640,1,"RGB",CharPixel,pixels);
The format of the MagickGetImagePixels method is:
unsigned int 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,
unsigned char *pixels );
The magick wand.
These values define the perimeter of a region of pixels you want to extract.
This string reflects the expected ordering of the pixel array. It can be any combination or order of R = red, G = green, B = blue, A = alpha, C = cyan, Y = yellow, M = magenta, K = black, or I = intensity (for grayscale).
Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..MaxRGB]. Choose from these types: CharPixel, ShortPixel, IntegerPixel, LongPixel, FloatPixel, or DoublePixel.
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.
unsigned char *MagickGetImageProfile( MagickWand *wand, const char *name,
unsigned long *length );
MagickGetImageProfile() returns the named image profile.
The format of the MagickGetImageProfile method is:
unsigned char *MagickGetImageProfile( MagickWand *wand, const char *name,
unsigned long *length );
The magick wand.
Name of profile to return: ICC, IPTC, or generic profile.
The length of the profile.
unsigned int MagickGetImageRedPrimary( MagickWand *wand, double *x, double *y );
MagickGetImageRedPrimary() returns the chromaticy red primary point.
The format of the MagickGetImageRedPrimary method is:
unsigned int MagickGetImageRedPrimary( MagickWand *wand, double *x, double *y );
The magick wand.
The chromaticity red primary x-point.
The chromaticity red primary y-point.
RenderingIntent MagickGetImageRenderingIntent( MagickWand *wand );
MagickGetImageRenderingIntent() gets the image rendering intent.
The format of the MagickGetImageRenderingIntent method is:
RenderingIntent MagickGetImageRenderingIntent( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickGetImageResolution( MagickWand *wand, double *x, double *y );
MagickGetImageResolution() gets the image X & Y resolution.
The format of the MagickGetImageResolution method is:
unsigned int MagickGetImageResolution( MagickWand *wand, double *x, double *y );
The magick wand.
The image x-resolution.
The image y-resolution.
unsigned long MagickGetImageScene( MagickWand *wand );
MagickGetImageScene() gets the image scene.
The format of the MagickGetImageScene method is:
unsigned long MagickGetImageScene( MagickWand *wand );
A description of each parameter follows:
The magick wand.
const char MagickGetImageSignature( MagickWand *wand );
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:
The magick wand.
MagickSizeType MagickGetImageSize( MagickWand *wand );
MagickGetImageSize() returns the image size.
The format of the MagickGetImageSize method is:
MagickSizeType MagickGetImageSize( MagickWand *wand );
A description of each parameter follows:
The magick wand.
ImageType MagickGetImageType( MagickWand *wand );
MagickGetImageType() gets the image type.
The format of the MagickGetImageType method is:
ImageType MagickGetImageType( MagickWand *wand );
A description of each parameter follows:
The magick wand.
ImageType MagickGetImageSavedType( MagickWand *wand );
MagickGetImageSavedType() gets the image type that will be used when the image is saved. This may be different to the current image type, returned by MagickGetImageType().
The format of the MagickGetImageSavedType method is:
ImageType MagickGetImageSavedType( MagickWand *wand );
A description of each parameter follows:
The magick wand.
ResolutionType MagickGetImageUnits( MagickWand *wand );
MagickGetImageUnits() gets the image units of resolution.
The format of the MagickGetImageUnits method is:
ResolutionType MagickGetImageUnits( MagickWand *wand );
A description of each parameter follows:
The magick wand.
VirtualPixelMethod MagickGetImageVirtualPixelMethod( MagickWand *wand );
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:
The magick wand.
unsigned int MagickGetImageWhitePoint( MagickWand *wand, double *x, double *y );
MagickGetImageWhitePoint() returns the chromaticy white point.
The format of the MagickGetImageWhitePoint method is:
unsigned int MagickGetImageWhitePoint( MagickWand *wand, double *x, double *y );
The magick wand.
The chromaticity white x-point.
The chromaticity white y-point.
unsigned long MagickGetImageWidth( MagickWand *wand );
MagickGetImageWidth() returns the image width.
The format of the MagickGetImageWidth method is:
unsigned long MagickGetImageWidth( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned long MagickGetNumberImages( MagickWand *wand );
MagickGetNumberOfImages() 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:
The magick wand.
const char *MagickGetPackageName( void );
MagickGetPackageName() returns the ImageMagick package name.
The format of the MagickGetPackageName method is:
const char *MagickGetPackageName( void );
const char *MagickGetQuantumDepth( unsigned long *depth );
MagickGetQuantumDepth() returns the ImageMagick quantum depth.
The format of the MagickGetQuantumDepth method is:
const char *MagickGetQuantumDepth( unsigned long *depth );
A description of each parameter follows:
The quantum depth is returned as a number.
const char *MagickGetReleaseDate( void );
MagickGetReleaseDate() returns the ImageMagick release date.
The format of the MagickGetReleaseDate method is:
const char *MagickGetReleaseDate( void );
unsigned long MagickGetResourceLimit( const ResourceType type );
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:
The magick wand.
double *MagickGetSamplingFactors( MagickWand *wand, unsigned long *number_factors );
MagickGetSamplingFactors() gets the horizontal and vertical sampling factor.
The format of the MagickGetSamplingFactors method is:
double *MagickGetSamplingFactors( MagickWand *wand, unsigned long *number_factors );
The magick wand.
The number of factors in the returned array.
unsigned int MagickGetSize( const MagickWand *wand, unsigned long *columns,
unsigned long *rows );
MagickGetSize() returns the size associated with the magick wand.
The format of the MagickGetSize method is:
unsigned int MagickGetSize( const MagickWand *wand, unsigned long *columns,
unsigned long *rows );
The magick wand.
The width in pixels.
The height in pixels.
const char *MagickGetVersion( unsigned long *version );
MagickGetVersion() returns the ImageMagick API version as a string and as a number.
The format of the MagickGetVersion method is:
const char *MagickGetVersion( unsigned long *version );
A description of each parameter follows:
The ImageMagick version is returned as a number.
MagickPassFail MagickHaldClutImage( MagickWand *wand, const MagickWand *clut_wand );
The MagickHaldClutImage() method apply a color lookup table (Hald CLUT) to the image. The fundamental principle of the Hald CLUT algorithm is that application of an identity CLUT causes no change to the input image, but an identity CLUT image which has had its colors transformed in some way (e.g. in Adobe Photoshop) may be used to implement an identical transform on any other image.
The minimum CLUT level is 2, and the maximum depends on available memory (largest successfully tested is 24). A CLUT image is required to have equal width and height. A CLUT of level 8 is an image of dimension 512x512, a CLUT of level 16 is an image of dimension 4096x4096. Interpolation is used so extremely large CLUT images are not required.
GraphicsMagick provides an 'identity' coder which may be used to generate identity HLUTs. For example, reading from "identity:8" creates an identity CLUT of order 8.
The Hald CLUT algorithm has been developed by Eskil Steenberg as described at http://www.quelsolaar.com/technology/clut.html, and was adapted for GraphicsMagick by Clément Follet with support from Cédric Lejeune of Workflowers.
The format of the HaldClutImage method is:
MagickPassFail MagickHaldClutImage( MagickWand *wand, const MagickWand *clut_wand );
A description of each parameter follows:
The image wand.
The color lookup table image wand
unsigned int MagickHasColormap( MagickWand *wand, unsigned int *colormap );
MagickHasColormap() returns True if the check was successful with the colormap parameter set to a boolean value indicating whether the current wand image uses a color map or not. Returns False if there are no wand images available.
The format of the MagickHasColormap method is:
unsigned int MagickHasColormap( MagickWand *wand, unsigned int *colormap );
The magick wand.
Set to True if current image uses a color map, False if not.
unsigned int MagickHasNextImage( MagickWand *wand );
MagickHasNextImage() returns True if the wand has more images when traversing the list in the forward direction
The format of the MagickHasNextImage method is:
unsigned int MagickHasNextImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickHasPreviousImage( MagickWand *wand );
MagickHasPreviousImage() returns True if the wand has more images when traversing the list in the reverse direction
The format of the MagickHasPreviousImage method is:
unsigned int MagickHasPreviousImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickImplodeImage( MagickWand *wand, const double radius );
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:
unsigned int MagickImplodeImage( MagickWand *wand, const double radius );
A description of each parameter follows:
The magick wand.
Define the extent of the implosion.
unsigned int MagickIsGrayImage( MagickWand *wand, unsigned int *grayimage );
MagickIsGrayImage() returns True if the check was successful with the grayimage parameter set to a boolean value indicating whether the current wand image is a gray-scale image or not. Returns False if there was an error.
The format of the MagickIsGrayImage method is:
unsigned int MagickIsGrayImage( MagickWand *wand, unsigned int *grayimage );
The magick wand.
Set to True if current image is a gray-scale image, False if not.
unsigned int MagickIsMonochromeImage( MagickWand *wand, unsigned int *monochrome );
MagickIsMonochromeImage() returns True if the check was successful with the monochrome parameter set to a boolean value indicating whether the current wand image is a monochrome image or not. Returns False if there was an error.
The format of the MagickIsMonochromeImage method is:
unsigned int MagickIsMonochromeImage( MagickWand *wand, unsigned int *monochrome );
The magick wand.
Set to True if current image is a monochrome image, False if not.
unsigned int MagickIsOpaqueImage( MagickWand *wand, unsigned int *opaque );
MagickIsOpaqueImage() returns True if the check was successful with the opaque parameter set to a boolean value indicating whether the current wand image is entirely opaque or not. Returns False if there was an error.
The format of the MagickIsOpaqueImage method is:
unsigned int MagickIsOpaqueImage( MagickWand *wand, unsigned int *opaque );
The magick wand.
Set to True if current image is entirely opaque, False if not.
unsigned int MagickIsPaletteImage( MagickWand *wand, unsigned int *palette );
MagickIsPaletteImage() returns True if the check was successful with the palette parameter set to a boolean value indicating whether the current wand image is an image with 256 unique colors or less. Returns False if there was an error. Note that a palette image does not necessarily use a colormap. See MagickHasColormap() if needing to determine whether a colormap is in use.
The format of the MagickIsPaletteImage method is:
unsigned int MagickIsPaletteImage( MagickWand *wand, unsigned int *palette );
The magick wand.
Set to True if current image is 256 colors or less, False if not.
unsigned int MagickLabelImage( MagickWand *wand, const char *label );
MagickLabelImage() adds a label to your image.
The format of the MagickLabelImage method is:
unsigned int MagickLabelImage( MagickWand *wand, const char *label );
A description of each parameter follows:
The magick wand.
The image label.
unsigned int MagickLevelImage( MagickWand *wand, const double black_point, const double gamma,
const double white_point );
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:
unsigned int MagickLevelImage( MagickWand *wand, const double black_point, const double gamma,
const double white_point );
The magick wand.
The black point.
The gamma.
The white point.
unsigned int MagickLevelImageChannel( MagickWand *wand, const ChannelType channel, const double black_point, const double gamma, const double white_point );
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:
unsigned int MagickLevelImageChannel( MagickWand *wand, const ChannelType channel, const double black_point, const double gamma, const double white_point );
The magick wand.
Identify which channel to level: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, BlackChannel.
The black point.
The gamma.
The white point.
unsigned int MagickMagnifyImage( MagickWand *wand );
MagickMagnifyImage() is a convenience method that scales an image proportionally to twice its original size.
The format of the MagickMagnifyImage method is:
unsigned int MagickMagnifyImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickMapImage( MagickWand *wand, const MagickWand *map_wand,
const unsigned int dither );
MagickMapImage() replaces the colors of an image with the closest color from a reference image.
The format of the MagickMapImage method is:
unsigned int MagickMapImage( MagickWand *wand, const MagickWand *map_wand,
const unsigned int dither );
The magick wand.
The map wand.
Set this integer value to something other than zero to dither the mapped image.
unsigned int MagickMatteFloodfillImage( MagickWand *wand, const Quantum opacity, const double fuzz, const PixelWand *bordercolor, const long x, const long y );
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:
unsigned int MagickMatteFloodfillImage( MagickWand *wand, const Quantum opacity, const double fuzz, const PixelWand *bordercolor, const long x, const long y );
The magick wand.
The opacity.
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.
The border color pixel wand.
The starting location of the operation.
unsigned int MagickMedianFilterImage( MagickWand *wand, const double radius );
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:
unsigned int MagickMedianFilterImage( MagickWand *wand, const double radius );
The magick wand.
The radius of the pixel neighborhood.
unsigned int MagickMinifyImage( MagickWand *wand );
MagickMinifyImage() is a convenience method that scales an image proportionally to one-half its original size
The format of the MagickMinifyImage method is:
unsigned int MagickMinifyImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickModulateImage( MagickWand *wand, const double brightness,
const double saturation, const double hue );
MagickModulateImage() lets you control the brightness, saturation, and hue of an image.
The format of the MagickModulateImage method is:
unsigned int MagickModulateImage( MagickWand *wand, const double brightness,
const double saturation, const double hue );
The magick wand.
The percent change in brighness (-100 thru +100).
The percent change in saturation (-100 thru +100)
The percent change in hue (-100 thru +100)
MagickWand MagickMontageImage( MagickWand *wand, const DrawingWand drawing_wand,
const char *tile_geometry, const char *thumbnail_geometry,
const MontageMode mode, const char *frame );
Use MagickMontageImage() to create 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 );
The magick wand.
The drawing wand. The font name, size, and color are obtained from this wand.
the number of tiles per row and page (e.g. 6x4+0+0).
Preferred image size and border size of each thumbnail (e.g. 120x120+4+3>).
Thumbnail framing mode: Frame, Unframe, or Concatenate.
Surround the image with an ornamental border (e.g. 15x15+3+3). The frame color is that of the thumbnail's matte color.
MagickWand *MagickMorphImages( MagickWand *wand, const unsigned long number_frames );
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 );
The magick wand.
The number of in-between images to generate.
MagickWand *MagickMosaicImages( MagickWand *wand );
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:
The magick wand.
unsigned int MagickMotionBlurImage( MagickWand *wand, const double radius, const double sigma,
const double angle );
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:
unsigned int MagickMotionBlurImage( MagickWand *wand, const double radius, const double sigma,
const double angle );
The magick wand.
The radius of the Gaussian, in pixels, not counting the center pixel.
The standard deviation of the Gaussian, in pixels.
Apply the effect along this angle.
unsigned int MagickNegateImage( MagickWand *wand, const unsigned int gray );
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:
unsigned int MagickNegateImage( MagickWand *wand, const unsigned int gray );
A description of each parameter follows:
The magick wand.
If True, only negate grayscale pixels within the image.
unsigned int MagickNegateImageChannel( MagickWand *wand, const ChannelType channel, const unsigned int gray );
MagickNegateImageChannel() negates the colors in the specified channel of the reference image. The Grayscale option means that only grayscale values within the image are negated. Note that the Grayscale option has no effect for GraphicsMagick.
You can also reduce the influence of a particular channel with a gamma value of 0.
The format of the MagickNegateImageChannel method is:
unsigned int MagickNegateImageChannel( MagickWand *wand, const ChannelType channel, const unsigned int gray );
The magick wand.
Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, BlackChannel.
If True, only negate grayscale pixels within the image.
unsigned int MagickNextImage( MagickWand *wand );
MagickNextImage() associates the next image in the image list with a magick wand. True is returned if the Wand iterated to a next image, or False is returned if the wand did not iterate to a next image.
The format of the MagickNextImage method is:
unsigned int MagickNextImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickNormalizeImage( MagickWand *wand );
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:
unsigned int MagickNormalizeImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickOilPaintImage( MagickWand *wand, const double radius );
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:
unsigned int MagickOilPaintImage( MagickWand *wand, const double radius );
A description of each parameter follows:
The magick wand.
The radius of the circular neighborhood.
unsigned int MagickOpaqueImage( MagickWand *wand, const PixelWand *target,
const PixelWand *fill, const double fuzz );
MagickOpaqueImage() changes any pixel that matches color with the color defined by fill.
The format of the MagickOpaqueImage method is:
unsigned int MagickOpaqueImage( MagickWand *wand, const PixelWand *target,
const PixelWand *fill, const double fuzz );
The magick wand.
Change this target color to the fill color within the image.
The fill pixel wand.
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.
unsigned int MagickPingImage( MagickWand *wand, const char *filename );
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:
unsigned int MagickPingImage( MagickWand *wand, const char *filename );
A description of each parameter follows:
The magick wand.
The image filename.
MagickWand *MagickPreviewImages( MagickWand *wand, const PreviewType preview );
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 );
The magick wand.
The preview type.
unsigned int MagickPreviousImage( MagickWand *wand );
MagickPreviousImage() selects the previous image associated with a magick wand.
The format of the MagickPreviousImage method is:
unsigned int MagickPreviousImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickProfileImage( MagickWand *wand, const char *name,
const unsigned char *profile, const size_t length );
Use MagickProfileImage() to add or remove 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:
unsigned int MagickProfileImage( MagickWand *wand, const char *name,
const unsigned char *profile, const size_t length );
The magick wand.
Name of profile to add or remove: ICC, IPTC, or generic profile.
The profile.
The length of the profile.
unsigned int MagickQuantizeImage( MagickWand *wand, const unsigned long number_colors,
const ColorspaceType colorspace,
const unsigned long treedepth, const unsigned int dither,
const unsigned int measure_error );
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:
unsigned int MagickQuantizeImage( MagickWand *wand, const unsigned long number_colors,
const ColorspaceType colorspace,
const unsigned long treedepth, const unsigned int dither,
const unsigned int measure_error );
The magick wand.
The number of colors.
Perform color reduction in this colorspace, typically RGBColorspace.
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.
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.
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.
unsigned int MagickQuantizeImages( MagickWand *wand, const unsigned long number_colors,
const ColorspaceType colorspace,
const unsigned long treedepth, const unsigned int dither,
const unsigned int measure_error );
MagickQuantizeImage() 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:
unsigned int MagickQuantizeImages( MagickWand *wand, const unsigned long number_colors,
const ColorspaceType colorspace,
const unsigned long treedepth, const unsigned int dither,
const unsigned int measure_error );
The magick wand.
The number of colors.
Perform color reduction in this colorspace, typically RGBColorspace.
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.
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.
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.
double *MagickQueryFontMetrics( MagickWand *wand, const DrawingWand *drawing_wand,
const char *text );
MagickQueryFontMetrics() returns a 7 element array representing the following font metrics:
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 );
The Magick wand.
The drawing wand.
The text.
char ** MagickQueryFonts( const char *pattern, unsigned long *number_fonts );
MagickQueryFonts() returns any font that match the specified pattern.
The format of the MagickQueryFonts function is:
char ** MagickQueryFonts( const char *pattern, unsigned long *number_fonts );
A description of each parameter follows:
Specifies a pointer to a text string containing a pattern.
This integer returns the number of fonts in the list.
char ** MagickQueryFormats( const char *pattern, unsigned long *number_formats );
MagickQueryFormats() returns any image formats that match the specified pattern.
The format of the MagickQueryFormats function is:
char ** MagickQueryFormats( const char *pattern, unsigned long *number_formats );
Specifies a pointer to a text string containing a pattern.
This integer returns the number of image formats in the list.
unsigned int MagickRadialBlurImage( MagickWand *wand, const double angle );
MagickRadialBlurImage() radial blurs an image.
The format of the MagickRadialBlurImage method is:
unsigned int MagickRadialBlurImage( MagickWand *wand, const double angle );
A description of each parameter follows:
The magick wand.
The angle of the blur in degrees.
unsigned int MagickRaiseImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y,
const unsigned int raise_flag );
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:
unsigned int MagickRaiseImage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y,
const unsigned int raise_flag );
The magick wand.
Define the dimensions of the area to raise.
A value other than zero creates a 3-D raise effect, otherwise it has a lowered effect.
unsigned int MagickReadImage( MagickWand *wand, const char *filename );
MagickReadImage() reads an image or image sequence.
The format of the MagickReadImage method is:
unsigned int MagickReadImage( MagickWand *wand, const char *filename );
A description of each parameter follows:
The magick wand.
The image filename.
unsigned int MagickReadImageBlob( MagickWand *wand, const unsigned char *blob,
const size_t length );
MagickReadImageBlob() reads an image or image sequence from a blob.
The format of the MagickReadImageBlob method is:
unsigned int MagickReadImageBlob( MagickWand *wand, const unsigned char *blob,
const size_t length );
The magick wand.
The blob.
The blob length.
unsigned int MagickReadImageFile( MagickWand *wand, FILE *file );
MagickReadImageFile() reads an image or image sequence from an open file descriptor.
The format of the MagickReadImageFile method is:
unsigned int MagickReadImageFile( MagickWand *wand, FILE *file );
A description of each parameter follows:
The magick wand.
The file descriptor.
unsigned int MagickReduceNoiseImage( MagickWand *wand, const double radius );
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:
unsigned int MagickReduceNoiseImage( MagickWand *wand, const double radius );
A description of each parameter follows:
The magick wand.
The radius of the pixel neighborhood.
unsigned int MagickRelinquishMemory( void *resource );
MagickRelinquishMemory() relinquishes memory resources returned by such methods as MagickDescribeImage(), MagickGetException(), etc.
The format of the MagickRelinquishMemory method is:
unsigned int MagickRelinquishMemory( void *resource );
A description of each parameter follows:
Relinquish the memory associated with this resource.
unsigned int MagickRemoveImage( MagickWand *wand );
MagickRemoveImage() removes an image from the image list.
The format of the MagickRemoveImage method is:
unsigned int MagickRemoveImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickRemoveImageOption( MagickWand *wand, const char *format,
const char *key );
MagickRemoveImageOption() removes an image format-specific option from the the image (.e.g MagickRemoveImageOption(wand,"jpeg","preserve-settings").
The format of the MagickRemoveImageOption method is:
unsigned int MagickRemoveImageOption( MagickWand *wand, const char *format,
const char *key );
The magick wand.
The image format.
The key.
unsigned char *MagickRemoveImageProfile( MagickWand *wand, const char *name,
unsigned long *length );
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 );
The magick wand.
Name of profile to return: ICC, IPTC, or generic profile.
The length of the profile.
void MagickResetIterator( MagickWand *wand );
MagickReset() resets the wand iterator. Use it in conjunction with MagickNextImage() to iterate over all the images in a wand container.
The format of the MagickReset method is:
void MagickResetIterator( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickResampleImage( MagickWand *wand, const double x_resolution,
const double y_resolution, const FilterTypes filter,
const double blur );
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:
unsigned int MagickResampleImage( MagickWand *wand, const double x_resolution,
const double y_resolution, const FilterTypes filter,
const double blur );
The magick wand.
The new image x resolution.
The new image y resolution.
Image filter to use.
The blur factor where > 1 is blurry, < 1 is sharp.
unsigned int MagickResizeImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows, const FilterTypes filter,
const double blur );
MagickResizeImage() scales an image to the desired dimensions with one of these filters:
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 MagickResizeImage method is:
unsigned int MagickResizeImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows, const FilterTypes filter,
const double blur );
The magick wand.
The number of columns in the scaled image.
The number of rows in the scaled image.
Image filter to use.
The blur factor where > 1 is blurry, < 1 is sharp.
unsigned int MagickRollImage( MagickWand *wand, const long x_offset,
const unsigned long y_offset );
MagickRollImage() offsets an image as defined by x_offset and y_offset.
The format of the MagickRollImage method is:
unsigned int MagickRollImage( MagickWand *wand, const long x_offset,
const unsigned long y_offset );
The magick wand.
The x offset.
The y offset.
unsigned int MagickRotateImage( MagickWand *wand, const PixelWand *background,
const double degrees );
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:
unsigned int MagickRotateImage( MagickWand *wand, const PixelWand *background,
const double degrees );
The magick wand.
The background pixel wand.
The number of degrees to rotate the image.
unsigned int MagickSampleImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
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:
unsigned int MagickSampleImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
The magick wand.
The number of columns in the scaled image.
The number of rows in the scaled image.
unsigned int MagickScaleImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
MagickScaleImage() scales the size of an image to the given dimensions.
The format of the MagickScaleImage method is:
unsigned int MagickScaleImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
The magick wand.
The number of columns in the scaled image.
The number of rows in the scaled image.
unsigned int MagickSeparateImageChannel( MagickWand *wand, const ChannelType channel );
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:
unsigned int MagickSeparateImageChannel( MagickWand *wand, const ChannelType channel );
The magick wand.
Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, BlackChannel.
unsigned int MagickSetCompressionQuality( MagickWand *wand, const unsigned long quality );
MagickSetCompressionQuality() sets the image quality factor, which determines compression options when saving the file.
For the JPEG and MPEG image formats, quality is 0 (lowest image quality and highest compression) to 100 (best quality but least effective compression). The default quality is 75. Use the -sampling-factor option to specify the factors for chroma downsampling. To use the same quality value as that found by the JPEG decoder, use the -define jpeg:preserve-settings flag.
For the MIFF image format, and the TIFF format while using ZIP compression, quality/10 is the zlib compres- sion level, which is 0 (worst but fastest compression) to 9 (best but slowest). It has no effect on the image appearance, since the compression is always lossless.
For the JPEG-2000 image format, quality is mapped using a non-linear equation to the compression ratio required by the Jasper library. This non-linear equation is intended to loosely approximate the quality provided by the JPEG v1 format. The default quality value 75 results in a request for 16:1 compression. The quality value 100 results in a request for non-lossy compres- sion.
For the MNG and PNG image formats, the quality value sets the zlib compression level (quality / 10) and filter-type (quality % 10). Compression levels range from 0 (fastest compression) to 100 (best but slowest). For compression level 0, the Huffman-only strategy is used, which is fastest but not necessarily the worst compression. If filter-type is 4 or less, the specified filter-type is used for all scanlines:
none
sub
up
average
Paeth
If filter-type is 5, adaptive filtering is used when quality is greater than 50 and the image does not have a color map, otherwise no filtering is used.
If filter-type is 6, adaptive filtering with minimum- sum-of-absolute-values is used.
Only if the output is MNG, if filter-type is 7, the LOCO color transformation and adaptive filtering with minimum-sum-of-absolute-values are used.
The default is quality is 75, which means nearly the best compression with adaptive filtering. The quality setting has no effect on the appearance of PNG and MNG images, since the compression is always lossless.
For further information, see the PNG specification.
When writing a JNG image with transparency, two quality values are required, one for the main image and one for the grayscale image that conveys the opacity channel. These are written as a single integer equal to the main image quality plus 1000 times the opacity quality. For example, if you want to use quality 75 for the main image and quality 90 to compress the opacity data, use -quality 90075.
For the PNM family of formats (PNM, PGM, and PPM) specify a quality factor of zero in order to obtain the ASCII variant of the format. Note that -compress none used to be used to trigger ASCII output but provided the opposite result of what was expected as compared with other formats.
The format of the MagickSetCompressionQuality method is:
unsigned int MagickSetCompressionQuality( MagickWand *wand, const unsigned long quality );
The magick wand.
The image quality.
unsigned int MagickSetDepth( MagickWand *wand, const size_t depth );
MagickSetDepth() sets the sample depth to be used when reading from a raw image or a format which requires that the depth be specified in advance by the user.
The format of the MagickSetDepth method is:
unsigned int MagickSetDepth( MagickWand *wand, const size_t depth );
A description of each parameter follows:
The magick wand.
The sample depth.
unsigned int MagickSetFilename( MagickWand *wand, const char *filename );
MagickSetFilename() sets the filename before you read or write an image file.
The format of the MagickSetFilename method is:
unsigned int MagickSetFilename( MagickWand *wand, const char *filename );
A description of each parameter follows:
The magick wand.
The image filename.
unsigned int MagickSetFormat( MagickWand *wand, const char *format );
MagickSetFormat() sets the file or blob format (e.g. "BMP") to be used when a file or blob is read. Usually this is not necessary because GraphicsMagick is able to auto-detect the format based on the file header (or the file extension), but some formats do not use a unique header or the selection may be ambigious. Use MagickSetImageFormat() to set the format to be used when a file or blob is to be written.
The format of the MagickSetFormat method is:
unsigned int MagickSetFormat( MagickWand *wand, const char *format );
A description of each parameter follows:
The magick wand.
The file or blob format.
unsigned int MagickSetImage( MagickWand *wand, const MagickWand *set_wand );
MagickSetImage() replaces the last image returned by MagickSetImageIndex(), MagickNextImage(), MagickPreviousImage() with the images from the specified wand.
The format of the MagickSetImage method is:
unsigned int MagickSetImage( MagickWand *wand, const MagickWand *set_wand );
A description of each parameter follows:
The magick wand.
The set_wand wand.
unsigned int MagickSetImageAttribute( MagickWand *wand, const char *name,
const char *value );
MagickSetImageAttribute sets an image attribute
The format of the MagickSetImageAttribute method is:
unsigned int MagickSetImageAttribute( MagickWand *wand, const char *name,
const char *value );
A description of each parameter follows:
The magick wand.
The name of the attribute
The value of the attribute
unsigned int MagickSetImageBackgroundColor( MagickWand *wand, const PixelWand *background );
MagickSetImageBackgroundColor() sets the image background color.
The format of the MagickSetImageBackgroundColor method is:
unsigned int MagickSetImageBackgroundColor( MagickWand *wand, const PixelWand *background );
The magick wand.
The background pixel wand.
unsigned int MagickSetImageBluePrimary( MagickWand *wand, const double x, const double y );
MagickSetImageBluePrimary() sets the image chromaticity blue primary point.
The format of the MagickSetImageBluePrimary method is:
unsigned int MagickSetImageBluePrimary( MagickWand *wand, const double x, const double y );
The magick wand.
The blue primary x-point.
The blue primary y-point.
unsigned int MagickSetImageBorderColor( MagickWand *wand, const PixelWand *border );
MagickSetImageBorderColor() sets the image border color.
The format of the MagickSetImageBorderColor method is:
unsigned int MagickSetImageBorderColor( MagickWand *wand, const PixelWand *border );
The magick wand.
The border pixel wand.
unsigned int MagickSetImageColormapColor( MagickWand *wand, const unsigned long index,
const PixelWand *color );
MagickSetImageColormapColor() sets the color of the specified colormap index.
The format of the MagickSetImageColormapColor method is:
unsigned int MagickSetImageColormapColor( MagickWand *wand, const unsigned long index,
const PixelWand *color );
The magick wand.
The offset into the image colormap.
Return the colormap color in this wand.
unsigned int MagickSetImageColorspace( MagickWand *wand, const ColorspaceType colorspace );
MagickSetImageColorspace() sets the image colorspace.
The format of the MagickSetImageColorspace method is:
unsigned int MagickSetImageColorspace( MagickWand *wand, const ColorspaceType colorspace );
The magick wand.
The image colorspace: UndefinedColorspace, RGBColorspace, GRAYColorspace, TransparentColorspace, OHTAColorspace, XYZColorspace, YCbCrColorspace, YCCColorspace, YIQColorspace, YPbPrColorspace, YPbPrColorspace, YUVColorspace, CMYKColorspace, sRGBColorspace, HSLColorspace, or HWBColorspace.
unsigned int MagickSetImageCompose( MagickWand *wand, const CompositeOperator compose );
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:
unsigned int MagickSetImageCompose( MagickWand *wand, const CompositeOperator compose );
The magick wand.
The image composite operator.
unsigned int MagickSetImageCompression( MagickWand *wand,
const CompressionType compression );
MagickSetImageCompression() sets the image compression.
The format of the MagickSetImageCompression method is:
unsigned int MagickSetImageCompression( MagickWand *wand,
const CompressionType compression );
The magick wand.
The image compression type.
unsigned int MagickSetImageDelay( MagickWand *wand, const unsigned long delay );
MagickSetImageDelay() sets the image delay.
The format of the MagickSetImageDelay method is:
unsigned int MagickSetImageDelay( MagickWand *wand, const unsigned long delay );
The magick wand.
The image delay in 1/100th of a second.
unsigned int MagickSetImageChannelDepth( MagickWand *wand, const ChannelType channel, const unsigned long depth );
MagickSetImageChannelDepth() sets the depth of a particular image channel.
The format of the MagickSetImageChannelDepth method is:
unsigned int MagickSetImageChannelDepth( MagickWand *wand, const ChannelType channel, const unsigned long depth );
The magick wand.
Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, BlackChannel.
The image depth in bits.
unsigned int MagickSetImageDepth( MagickWand *wand, const unsigned long depth );
MagickSetImageDepth() sets the image depth.
The format of the MagickSetImageDepth method is:
unsigned int MagickSetImageDepth( MagickWand *wand, const unsigned long depth );
The magick wand.
The image depth in bits: 8, 16, or 32.
unsigned int MagickSetImageDispose( MagickWand *wand, const DisposeType dispose );
MagickSetImageDispose() sets the image disposal method.
The format of the MagickSetImageDispose method is:
unsigned int MagickSetImageDispose( MagickWand *wand, const DisposeType dispose );
The magick wand.
The image disposeal type.
unsigned int MagickSetImageFilename( MagickWand *wand, const char *filename );
MagickSetImageFilename() sets the filename of a particular image in a sequence.
The format of the MagickSetImageFilename method is:
unsigned int MagickSetImageFilename( MagickWand *wand, const char *filename );
The magick wand.
The image filename.
unsigned int MagickSetImageFormat( MagickWand *wand, const char *format );
MagickSetImageFormat() sets the format of a particular image in a sequence. The format is designated by a magick string (e.g. "GIF").
The format of the MagickSetImageFormat method is:
unsigned int MagickSetImageFormat( MagickWand *wand, const char *format );
The magick wand.
The image format.
unsigned int MagickSetImageFuzz( MagickWand *wand, const double fuzz );
MagickSetImageFuzz() sets the color comparison fuzz factor. Colors closer than the fuzz factor are considered to be the same when comparing colors. Note that some other functions such as MagickColorFloodfillImage() implicitly set this value.
The format of the MagickSetImageFuzz method is:
unsigned int MagickSetImageFuzz( MagickWand *wand, const double fuzz );
A description of each parameter follows:
The magick wand.
The color comparison fuzz factor
unsigned int MagickSetImageGamma( MagickWand *wand, const double gamma );
MagickSetImageGamma() sets the image gamma.
The format of the MagickSetImageGamma method is:
unsigned int MagickSetImageGamma( MagickWand *wand, const double gamma );
A description of each parameter follows:
The magick wand.
The image gamma.
unsigned int MagickSetImageGravity( MagickWand *wand, const GravityType );
MagickSetImageGravity() sets the image gravity. This is used when evaluating regions defined by a geometry and the image dimensions. It may be used in conjunction with operations which use a geometry parameter to adjust the x, y parameters of the final operation. Gravity is used in composition to determine where the image should be placed within the defined geometry region. It may be used with montage to effect placement of the image within the tile.
The format of the MagickSetImageGravity method is:
unsigned int MagickSetImageGravity( MagickWand *wand, const GravityType );
A description of each parameter follows:
The magick wand.
The image gravity. Available values are ForgetGravity, NorthWestGravity, NorthGravity, NorthEastGravity, WestGravity, CenterGravity, EastGravity, SouthWestGravity, SouthGravity, SouthEastGravity, and StaticGravity
unsigned int MagickSetImageGreenPrimary( MagickWand *wand, const double x, const double y );
MagickSetImageGreenPrimary() sets the image chromaticity green primary point.
The format of the MagickSetImageGreenPrimary method is:
unsigned int MagickSetImageGreenPrimary( MagickWand *wand, const double x, const double y );
The magick wand.
The green primary x-point.
The green primary y-point.
unsigned int MagickSetImageIndex( MagickWand *wand, const long index );
MagickSetImageIndex() set the current image to the position of the list specified with the index parameter.
The format of the MagickSetImageIndex method is:
unsigned int MagickSetImageIndex( MagickWand *wand, const long index );
A description of each parameter follows:
The magick wand.
The scene number.
unsigned int MagickSetImageInterlaceScheme( MagickWand *wand,
const InterlaceType interlace_scheme );
MagickSetImageInterlaceScheme() sets the image interlace scheme. Please use SetInterlaceScheme() instead to change the interlace scheme used when writing the image.
The format of the MagickSetImageInterlaceScheme method is:
unsigned int MagickSetImageInterlaceScheme( MagickWand *wand,
const InterlaceType interlace_scheme );
The magick wand.
The image interlace scheme: NoInterlace, LineInterlace, PlaneInterlace, PartitionInterlace.
unsigned int MagickSetImageIterations( MagickWand *wand, const unsigned long iterations );
MagickSetImageIterations() sets the image iterations.
The format of the MagickSetImageIterations method is:
unsigned int MagickSetImageIterations( MagickWand *wand, const unsigned long iterations );
The magick wand.
The image delay in 1/100th of a second.
unsigned int MagickSetImageMatteColor( MagickWand *wand, const PixelWand *matte );
MagickSetImageMatteColor() sets the image matte color.
The format of the MagickSetImageMatteColor method is:
unsigned int MagickSetImageMatteColor( MagickWand *wand, const PixelWand *matte );
The magick wand.
The matte pixel wand.
unsigned int MagickSetImageOption( MagickWand *wand, const char *format, const char *key,
const char *value );
MagickSetImageOption() associates one or options with a particular image format (.e.g MagickSetImageOption(wand,"jpeg","preserve-settings","true").
The format of the MagickSetImageOption method is:
unsigned int MagickSetImageOption( MagickWand *wand, const char *format, const char *key,
const char *value );
The magick wand.
The image format.
The key.
The value.
MagickSetImageOrientation( MagickWand *wand, OrientationType new_orientation );
MagickSetImageOrientation() sets the internal image orientation type. The EXIF orientation tag will be updated if present.
The format of the MagickSetImageOrientation method is:
MagickSetImageOrientation( MagickWand *wand, OrientationType new_orientation );
The magick wand.
The new orientation of the image. One of:
UndefinedOrientation Image orientation not specified. TopLeftOrientation Left to right and Top to bottom. TopRightOrientation Right to left and Top to bottom. BottomRightOrientation Right to left and Bottom to top. BottomLeftOrientation Left to right and Bottom to top. LeftTopOrientation Top to bottom and Left to right. RightTopOrientation Top to bottom and Right to left. RightBottomOrientation Bottom to top and Right to left. LeftBottomOrientation Bottom to top and Left to right.
Returns True on success, False otherwise.
unsigned int MagickSetImagePage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y );
MagickSetImagePage() sets the image page size and offset used when placing (e.g. compositing) the image. Pass all zeros for the default placement.
The format of the MagickSetImagePage method is:
unsigned int MagickSetImagePage( MagickWand *wand, const unsigned long width,
const unsigned long height, const long x, const long y );
The magick wand.
The region size.
Offset (from top left) on base canvas image on which to composite image data.
unsigned int 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,
unsigned char *pixels );
MagickSetImagePixels() accepts pixel data and stores it in the image at the location you specify. The method returns False on success otherwise True 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:
unsigned int 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,
unsigned char *pixels );
The magick wand.
Offset (from top left) on base canvas image on which to composite image data.
Dimensions of image.
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 (same as Transparency), O = Opacity, T = Transparency, C = cyan, Y = yellow, M = magenta, K = black, or I = intensity (for grayscale). Specify "P" = pad, to skip over a quantum which is intentionally ignored. Creation of an alpha channel for CMYK images is currently not supported.
Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..MaxRGB]. Choose from these types: CharPixel, ShortPixel, IntegerPixel, LongPixel, FloatPixel, or DoublePixel.
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.
unsigned int MagickSetImageProfile( MagickWand *wand, const char *name,
const unsigned char *profile,
const unsigned long length );
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:
unsigned int MagickSetImageProfile( MagickWand *wand, const char *name,
const unsigned char *profile,
const unsigned long length );
The magick wand.
Name of profile to add or remove: ICC, IPTC, or generic profile.
The profile.
The length of the profile.
unsigned int MagickSetImageRedPrimary( MagickWand *wand, const double x, const double y );
MagickSetImageRedPrimary() sets the image chromaticity red primary point.
The format of the MagickSetImageRedPrimary method is:
unsigned int MagickSetImageRedPrimary( MagickWand *wand, const double x, const double y );
The magick wand.
The red primary x-point.
The red primary y-point.
unsigned int MagickSetImageRenderingIntent( MagickWand *wand,
const RenderingIntent rendering_intent );
MagickSetImageRenderingIntent() sets the image rendering intent.
The format of the MagickSetImageRenderingIntent method is:
unsigned int MagickSetImageRenderingIntent( MagickWand *wand,
const RenderingIntent rendering_intent );
The magick wand.
The image rendering intent: UndefinedIntent, SaturationIntent, PerceptualIntent, AbsoluteIntent, or RelativeIntent.
unsigned int MagickSetImageResolution( MagickWand *wand, const double x_resolution,
const doubtl y_resolution );
MagickSetImageResolution() sets the image resolution.
The format of the MagickSetImageResolution method is:
unsigned int MagickSetImageResolution( MagickWand *wand, const double x_resolution,
const doubtl y_resolution );
The magick wand.
The image x resolution.
The image y resolution.
unsigned int MagickSetImageScene( MagickWand *wand, const unsigned long scene );
MagickSetImageScene() sets the image scene.
The format of the MagickSetImageScene method is:
unsigned int MagickSetImageScene( MagickWand *wand, const unsigned long scene );
The magick wand.
The image scene number.
unsigned int MagickSetImageType( MagickWand *wand, const ImageType image_type );
MagickSetImageType() sets the image type.
The format of the MagickSetImageType method is:
unsigned int MagickSetImageType( MagickWand *wand, const ImageType image_type );
The magick wand.
The image type: UndefinedType, BilevelType, GrayscaleType, GrayscaleMatteType, PaletteType, PaletteMatteType, TrueColorType, TrueColorMatteType, ColorSeparationType, ColorSeparationMatteType, or OptimizeType.
unsigned int MagickSetImageSavedType( MagickWand *wand, const ImageType image_type );
MagickSetImageSavedType() sets the image type that will be used when the image is saved.
The format of the MagickSetImageSavedType method is:
unsigned int MagickSetImageSavedType( MagickWand *wand, const ImageType image_type );
The magick wand.
The image type: UndefinedType, BilevelType, GrayscaleType, GrayscaleMatteType, PaletteType, PaletteMatteType, TrueColorType, TrueColorMatteType, ColorSeparationType, ColorSeparationMatteType, or OptimizeType.
unsigned int MagickSetImageUnits( MagickWand *wand, const ResolutionType units );
MagickSetImageUnits() sets the image units of resolution.
The format of the MagickSetImageUnits method is:
unsigned int MagickSetImageUnits( MagickWand *wand, const ResolutionType units );
The magick wand.
The image units of resolution : Undefinedresolution, PixelsPerInchResolution, or PixelsPerCentimeterResolution.
unsigned int MagickSetImageVirtualPixelMethod( MagickWand *wand,
const VirtualPixelMethod method );
MagickSetImageVirtualPixelMethod() sets the image virtual pixel method.
The format of the MagickSetImageVirtualPixelMethod method is:
unsigned int MagickSetImageVirtualPixelMethod( MagickWand *wand,
const VirtualPixelMethod method );
The magick wand.
The image virtual pixel method : UndefinedVirtualPixelMethod, ConstantVirtualPixelMethod, EdgeVirtualPixelMethod, MirrorVirtualPixelMethod, or TileVirtualPixelMethod.
unsigned int MagickSetInterlaceScheme( MagickWand *wand,
const InterlaceType interlace_scheme );
MagickSetInterlaceScheme() sets the interlace scheme used when writing the image.
The format of the MagickSetInterlaceScheme method is:
unsigned int MagickSetInterlaceScheme( MagickWand *wand,
const InterlaceType interlace_scheme );
The magick wand.
The image interlace scheme: NoInterlace, LineInterlace, PlaneInterlace, PartitionInterlace.
unsigned int MagickSetResolution( MagickWand *wand, const double x_resolution,
const double y_resolution );
MagickSetResolution() sets the resolution (density) of the magick wand. Set it before you read an EPS, PDF, or Postscript file in order to influence the size of the returned image, or after an image has already been created to influence the rendered image size when used with typesetting software.
Also see MagickSetResolutionUnits() which specifies the units to use for the image resolution.
The format of the MagickSetResolution method is:
unsigned int MagickSetResolution( MagickWand *wand, const double x_resolution,
const double y_resolution );
The magick wand.
The horizontal resolution
The vertical reesolution
unsigned int MagickSetResolutionUnits( MagickWand *wand, const ResolutionType units );
MagickSetResolutionUnits() sets the resolution units of the magick wand. It should be used in conjunction with MagickSetResolution(). This method works both before and after an image has been read.
Also see MagickSetImageUnits() which specifies the units which apply to the image resolution setting after an image has been read.
The format of the MagickSetResolutionUnits method is:
unsigned int MagickSetResolutionUnits( MagickWand *wand, const ResolutionType units );
The magick wand.
The image units of resolution : Undefinedresolution, PixelsPerInchResolution, or PixelsPerCentimeterResolution.
unsigned int MagickSetResourceLimit( const ResourceType type, const unsigned long *limit );
MagickSetResourceLimit() sets the limit for a particular resource in megabytes.
The format of the MagickSetResourceLimit method is:
unsigned int MagickSetResourceLimit( const ResourceType type, const unsigned long *limit );
The type of resource: DiskResource, FileResource, MapResource, MemoryResource, PixelsResource, ThreadsResource, WidthResource, HeightResource.
o The maximum limit for the resource.
unsigned int MagickSetSamplingFactors( MagickWand *wand, const unsigned long number_factors,
const double *sampling_factors );
MagickSetSamplingFactors() sets the image sampling factors.
The format of the MagickSetSamplingFactors method is:
unsigned int MagickSetSamplingFactors( MagickWand *wand, const unsigned long number_factors,
const double *sampling_factors );
The magick wand.
The number of factors. This value should be evenly divisible by two.
An array of doubles representing the sampling factor for each color component (in RGB order). Two double values must be provided for each color component.
unsigned int MagickSetSize( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
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:
unsigned int MagickSetSize( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
The magick wand.
The width in pixels.
The height in pixels.
unsigned int MagickSetImageWhitePoint( MagickWand *wand, const double x, const double y );
MagickSetImageWhitePoint() sets the image chromaticity white point.
The format of the MagickSetImageWhitePoint method is:
unsigned int MagickSetImageWhitePoint( MagickWand *wand, const double x, const double y );
The magick wand.
The white x-point.
The white y-point.
unsigned int MagickSetPassphrase( MagickWand *wand, const char *passphrase );
MagickSetPassphrase() sets the passphrase.
The format of the MagickSetPassphrase method is:
unsigned int MagickSetPassphrase( MagickWand *wand, const char *passphrase );
A description of each parameter follows:
The magick wand.
The passphrase.
unsigned int MagickSharpenImage( MagickWand *wand, const double radius, const double sigma );
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:
unsigned int MagickSharpenImage( MagickWand *wand, const double radius, const double sigma );
The magick wand.
The radius of the Gaussian, in pixels, not counting the center pixel.
The standard deviation of the Gaussian, in pixels.
unsigned int MagickShaveImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
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:
unsigned int MagickShaveImage( MagickWand *wand, const unsigned long columns,
const unsigned long rows );
The magick wand.
The number of columns in the scaled image.
The number of rows in the scaled image.
unsigned int MagickShearImage( MagickWand *wand, const PixelWand *background,
const double x_shear, onst double y_shear );
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:
unsigned int MagickShearImage( MagickWand *wand, const PixelWand *background,
const double x_shear, onst double y_shear );
The magick wand.
The background pixel wand.
The number of degrees to shear the image.
The number of degrees to shear the image.
unsigned int MagickSolarizeImage( MagickWand *wand, const double threshold );
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 MaxRGB and is a measure of the extent of the solarization.
The format of the MagickSolarizeImage method is:
unsigned int MagickSolarizeImage( MagickWand *wand, const double threshold );
A description of each parameter follows:
The magick wand.
Define the extent of the solarization.
unsigned int MagickSpreadImage( MagickWand *wand, const double radius );
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:
unsigned int MagickSpreadImage( MagickWand *wand, const double radius );
A description of each parameter follows:
The magick wand.
Choose a random pixel in a neighborhood of this extent.
MagickWand *MagickSteganoImage( MagickWand *wand, const MagickWand *watermark_wand,
const long offset );
Use MagickSteganoImage() to hide 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 );
The magick wand.
The watermark wand.
Start hiding at this offset into the image.
MagickWand *MagickStereoImage( MagickWand *wand, const MagickWand *offset_wand );
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 );
The magick wand.
Another image wand.
unsigned int MagickStripImage( MagickWand *wand );
MagickStripImage() removes all profiles and text attributes from the image.
The format of the MagickStripImage method is:
unsigned int MagickStripImage( MagickWand *wand );
A description of each parameter follows:
The magick wand.
unsigned int MagickSwirlImage( MagickWand *wand, const double degrees );
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:
unsigned int MagickSwirlImage( MagickWand *wand, const double degrees );
A description of each parameter follows:
The magick wand.
Define the tightness of the swirling effect.
MagickWand *MagickTextureImage( MagickWand *wand, const MagickWand *texture_wand );
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 );
The magick wand.
The texture wand
unsigned int MagickThresholdImage( MagickWand *wand, const double threshold );
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:
unsigned int MagickThresholdImage( MagickWand *wand, const double threshold );
The magick wand.
Define the threshold value.
unsigned int MagickThresholdImageChannel( MagickWand *wand, const ChannelType channel, const double threshold );
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:
unsigned int MagickThresholdImageChannel( MagickWand *wand, const ChannelType channel, const double threshold );
The magick wand.
The channel.
Define the threshold value.
unsigned int MagickTintImage( MagickWand *wand, const PixelWand *tint,
const PixelWand *opacity );
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:
unsigned int MagickTintImage( MagickWand *wand, const PixelWand *tint,
const PixelWand *opacity );
The magick wand.
The tint pixel wand.
The opacity pixel wand.
MagickWand *MagickTransformImage( MagickWand *wand, const char *crop,
const char *geometry );
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 );
The magick wand.
A crop geometry string. This geometry defines a subregion of the image to crop.
An image geometry string. This geometry defines the final size of the image.
unsigned int MagickTransparentImage( MagickWand *wand, const PixelWand *target,
const unsigned int opacity, const double fuzz );
MagickTransparentImage() changes any pixel that matches color with the color defined by fill.
The format of the MagickTransparentImage method is:
unsigned int MagickTransparentImage( MagickWand *wand, const PixelWand *target,
const unsigned int opacity, const double fuzz );
The magick wand.
Change this target color to specified opacity value within the image.
The replacement opacity value.
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.
unsigned int MagickTrimImage( MagickWand *wand, const double fuzz );
MagickTrimImage() remove edges that are the background color from the image.
The format of the MagickTrimImage method is:
unsigned int MagickTrimImage( MagickWand *wand, const double fuzz );
A description of each parameter follows:
The magick wand.
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.
unsigned int MagickUnsharpMaskImage( MagickWand *wand, const double radius, const double sigma,
const double amount, const double threshold );
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:
unsigned int MagickUnsharpMaskImage( MagickWand *wand, const double radius, const double sigma,
const double amount, const double threshold );
The magick wand.
The radius of the Gaussian, in pixels, not counting the center pixel.
The standard deviation of the Gaussian, in pixels.
The percentage of the difference between the original and the blur image that is added back into the original.
The threshold in pixels needed to apply the diffence amount.
unsigned int MagickWaveImage( MagickWand *wand, const double amplitude,
const double wave_length );
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:
unsigned int MagickWaveImage( MagickWand *wand, const double amplitude,
const double wave_length );
The magick wand.
Define the amplitude and wave length of the sine wave.
unsigned int MagickWhiteThresholdImage( MagickWand *wand, const PixelWand *threshold );
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:
unsigned int MagickWhiteThresholdImage( MagickWand *wand, const PixelWand *threshold );
The magick wand.
The pixel wand.
unsigned int MagickWriteImage( MagickWand *wand, const char *filename );
MagickWriteImage() writes an image.
The format of the MagickWriteImage method is:
unsigned int MagickWriteImage( MagickWand *wand, const char *filename );
A description of each parameter follows:
The magick wand.
The image filename.
unsigned int MagickWriteImagesFile( MagickWand *wand, FILE *file, const unsigned int adjoin );
MagickWriteImagesFile() writes an image or image sequence to a stdio FILE handle. This may be used to append an encoded image to an already existing appended image sequence if the file seek position is at the end of an existing file.
The format of the MagickWriteImages method is:
unsigned int MagickWriteImagesFile( MagickWand *wand, FILE *file, const unsigned int adjoin );
The magick wand.
The open (and positioned) file handle.
join images into a single multi-image file.
unsigned char *MagickWriteImageBlob( MagickWand *wand, size_t *length );
MagickWriteImageBlob() implements direct to memory image formats. It returns the image as a blob (a formatted "file" in memory) and its length, starting from the current position in the image sequence. Use MagickSetImageFormat() to set the format to write to the blob (GIF, JPEG, PNG, etc.).
Use MagickResetIterator() on the wand if it is desired to write a sequence from the beginning and the iterator is not currently at the beginning.
The format of the MagickWriteImageBlob method is:
unsigned char *MagickWriteImageBlob( MagickWand *wand, size_t *length );
A description of each parameter follows:
The magick wand.
The length of the blob.
unsigned int MagickWriteImageFile( MagickWand *wand, FILE *file );
MagickWriteImageFile() writes an image to an open file descriptor.
The format of the MagickWandToFile method is:
unsigned int MagickWriteImageFile( MagickWand *wand, FILE *file );
A description of each parameter follows:
The magick wand.
The file descriptor.
unsigned int MagickWriteImages( MagickWand *wand, const char *filename,
const unsigned int adjoin );
MagickWriteImages() writes an image or image sequence. If the wand represents an image sequence, then it is written starting at the first frame in the sequence.
The format of the MagickWriteImages method is:
unsigned int MagickWriteImages( MagickWand *wand, const char *filename,
const unsigned int adjoin );
The magick wand.
The image filename.
join images into a single multi-image file.
MagickWand NewMagickWand( void );
NewMagickWand() returns a wand required for all other methods in the API.
The format of the NewMagickWand method is:
MagickWand NewMagickWand( void );
Copyright © GraphicsMagick Group 2002 - 2023