Construct an Image by reading from the file or URL specified by filename.
Construct a blank image with the specified color.
Construct an image from an in-memory blob. The Blob size, depth and magick format may also be specified.
Constructs an image from an array of pixels.
Applies a rotational blur to the image.
Adaptively blurs the image by blurring more intensely near image edges and less intensely far from edges. The adaptiveBlur method blurs 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 adaptiveBlur selects a suitable radius for you.
adaptiveResize uses the special Mesh Interpolation method to resize images. Basically adaptiveResize avoids the excessive blurring that resize can produce with sharp color changes. This works well for slight image size adjustments and in particularly for magnification, And especially with images with sharp color changes. But when images are enlarged or reduced by more than 50% it will start to produce aliasing, and Moiré effects in the results.
Adaptively sharpens the image by sharpening more intensely near image edges and less intensely far from edges. The adaptiveSharpen method sharpens 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 adaptiveSharpen selects a suitable radius for you.
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.
Adds random noise to the specified channel or channels in the image. The amount of time addNoise requires depends on the NoiseType argument.
Transforms the image as specified by the affine matrix.
Set a flag to indicate whether or not to use alpha channel data.
Number time which must expire before displaying the next image in an animated sequence.
Number of iterations to loop an animation.
Annotates an image with text. Optionally you can include any of the following bits of information about the image by embedding the appropriate special characters:
Ditto, but word wraps the text so it stays withing the boundingArea. if the height and width are 0 the height and with of the image are used to calculate the bounding area.
extract the 'mean' from the image and adjust the image to try make set its gamma appropriatally.
adjusts the levels of a particular image channel by scaling the minimum and maximum values to the full quantum range.
Adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation). Note that only some models of modern digital cameras can tag an image with the orientation.
Set the image background color. The default is "white".
Changes the value of individual pixels based on the intensity of each pixel channel. The result is a high-contrast image.
Forces all pixels below the threshold into black while leaving all pixels above the threshold unchanged.
Adds the overlay image to the target image according to srcPercent and dstPercent.
mutes the colors of the image to simulate a scene at nighttime in the moonlight.
Blurs the specified channel. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). The blur method differs from gaussianBlur in that it uses a separable kernel which is faster but mathematically equivalent to the non-separable kernel.
Surrounds the image with a border of the color defined by the borderColor property.
Set the image border color. The default is "#dfdfdf".
Return smallest bounding box enclosing non-border pixels. The current fuzz value is used when discriminating between pixels.
returns true if any pixel in the image has been altered since it was first constituted.
Extract channel from image. Use this option to extract a particular channel from the image. ChannelType.MatteChannel for example, is useful for extracting the opacity values from an image.
Channel modulus depth. The channel modulus depth represents the minimum number of bits required to support the channel without loss. Setting the channel's modulus depth modifies the channel (i.e. discards resolution) if the requested modulus depth is less than the current modulus depth, otherwise the channel is not altered. There is no attribute associated with the modulus depth so the current modulus depth is obtained by inspecting the pixels. As a result, the depth returned may be less than the most recently set channel depth. Subsequent image processing may result in increasing the channel depth.
Adds a "charcoal" effect to the image. You can alter the intensity of the effect by changing the radius and sigma arguments.
Removes the specified rectangle and collapses the rest of the image to fill the removed portion.
The red, green, blue, and white-point chromaticity values.
The image's storage class. If DirectClass then the pixels contain valid RGB or CMYK colors. If PseudoClass then the image has a colormap referenced by the pixel's index member.
Associate a clip mask image with the current image. The clip mask image must have the same dimensions as the current image or an exception is thrown. Clipping occurs wherever pixels are transparent in the clip mask image. Clipping Pass an invalid image to unset an existing clip mask.
Associate a clip mask image with the current image. The clip mask image must have the same dimensions as the current image or an exception is thrown. Clipping occurs wherever pixels are transparent in the clip mask image. Clipping Pass an invalid image to unset an existing clip mask.
Returns a copy of the image.
replaces each color value in the given image, by using it as an index to lookup a replacement color value in a Color Look UP Table in the form of an image. The values are extracted along a diagonal of the CLUT image so either a horizontal or vertial gradient image can be used.
Applies a lightweight Color Correction Collection (CCC) file to the image. The file solely contains one or more color corrections. Here is a sample:
Applies color transformation to an image. This method permits saturation changes, hue rotation, luminance to alpha, and various other effects. Although variable-sized transformation matrices can be used, typically one uses a 5x5 matrix for an RGBA image and a 6x6 for CMYKA (or RGBA with offsets). The matrix is similar to those used by Adobe Flash except offsets are in column 6 rather than 5 (in support of CMYKA images) and offsets are normalized (divide Flash offset by 255)
Blend the fill color with the image pixels. The opacityRed, opacityGreen, opacityBlue and opacityAlpha arguments are the percentage to blend with the red, green, blue and alpha channels.
Access the image color map. Only ClassType.PsseudoClass images have a colormap.
The number of colors in the colormap. Only meaningful for PseudoClass images.
The number of colors in the colormap. Only meaningful for PseudoClass images.
The colorspace used to represent the image pixel colors. Image pixels are always stored as RGB(A) except for the case of CMY(K).
The colorspace used to represent the image pixel colors. Image pixels are always stored as RGB(A) except for the case of CMY(K).
The width of the image in pixels.
Compare current image with another image. Sets meanErrorPerPixel, normalizedMaxError , and normalizedMeanError in the current image. false is returned if the images are identical. An ErrorOption exception is thrown if the reference image columns, rows, colorspace, or matte differ from the current image.
Composition operator to be used when composition is implicitly used (such as for image flattening).
Composition operator to be used when composition is implicitly used (such as for image flattening).
Composites dest onto this image using the specified composite operator.
Merge the source and destination images according to the formula a*Sc*Dc + b*Sc + c*Dc + d where Sc is the source pixel and Dc is the destination pixel.
Composites multiple copies of the source image across and down the image, producing the same results as ImageMagick's composite command with the -tile option.
The image compression type. The default is the compression type of the specified image file.
The image compression type. The default is the compression type of the specified image file.
enhances the intensity differences between the lighter and darker elements of the image.
This is a simple image enhancement technique that attempts to improve the contrast in an image by `stretching' the range of intensity values it contains to span a desired range of values. It differs from the more sophisticated histogram equalization in that it can only apply a linear scaling function to the image pixel values. As a result the `enhancement' is less harsh.
Applies a custom convolution kernel to the image.
Extract a region of the image starting at the offset defined by geometry. Region must be fully defined, and no special handling of geometry flags is performed.
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.
Decipher an enciphered image.
The vertical and horizontal resolution in pixels of the image. This option specifies an image density when decoding a Postscript or Portable Document page.
The vertical and horizontal resolution in pixels of the image. This option specifies an image density when decoding a Postscript or Portable Document page.
Image depth. Used to specify the bit depth when reading or writing raw images or when the output format supports multiple depths. Defaults to the quantum depth that ImageMagick is compiled with.
Image depth. Used to specify the bit depth when reading or writing raw images or when the output format supports multiple depths. Defaults to the quantum depth that ImageMagick is compiled with.
Straightens an image. A threshold of 40% works for most images.
Reduces the speckle noise in an image while perserving the edges of the original image.
Tile names from within an image montage. Only valid after calling montage or reading a MIFF file which contains a directory.
Uses displacementMap to move color from img to the output image.
Display image on screen.
Composites the overlay image onto this image. The opacity of this image is multiplied by dstPercentage and opacity of overlay is multiplied by srcPercentage.
Distort an image using the specified distortion type and its required arguments. This method is equivalent to ImageMagick's -distort option.
Finds edges in an image.
Emboss image (hilight edges with 3D effect).
Encipher an image.
Specify (or obtain) endian option for formats which support it.
Specify (or obtain) endian option for formats which support it.
Applies a digital filter that improves the quality of a noisy image.
Applies a histogram equalization to the image.
Initializes the image pixels to the image background color.
Applies a value to the image with an arithmetic, relational, or logical operator to an image. Use these operations to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.
This method is very similar to crop. It extracts the rectangle specified by its arguments from the image and returns it as a new image. However, excerpt does not respect the virtual page offset and does not update the page offset and is more efficient than cropping.
The EXIF profile.
The EXIF profile.
Extracts the pixel data from the specified rectangle.
Ditto, but takes an existing pixel buffer.
If the Geometry is larger than this Image, extends the image to the specified geometry. And the new pixels are set to the background color. If the Geometry is smaller than this image crops the image.
The image filesize in bytes.
The image filename.
The image filename.
Filter to use when resizing image. The reduction filter employed has a significant effect on the time required to resize an image and the resulting quality. The default filter is Lanczos which has been shown to produce high quality results when reducing most images.
Filter to use when resizing image. The reduction filter employed has a significant effect on the time required to resize an image and the resulting quality. The default filter is Lanczos which has been shown to produce high quality results when reducing most images.
This interesting method searches for a rectangle in the image that is similar to the target. For the rectangle to be similar each pixel in the rectangle must match the corresponding pixel in the target image within the range specified by the fuzz property of this image and the target image.
creates a vertical mirror image by reflecting the pixels around the central x-axis.
Changes the color value of any pixel that matches target and is an immediate neighbor. To the fillColor or fillPattern set for this image. If fillToBorder is true, the color value is changed for any neighbor pixel that does not match the borderColor.
Fill the image like floodFill but use the specified colors.
Fill the image like floodFill but use the specified pattern an borderColor.
creates a horizontal mirror image by reflecting the pixels around the central y-axis.
The image encoding format. For example, "GIF" or "PNG".
Adds a simulated 3D border. The matteColor is used to draw the frame.
Applies a value to the image with an arithmetic, relational, or logical operator to an image. Use these operations to lighten or darken an image, to increase or decrease contrast in an image, or to produce the "negative" of an image.
Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this option to match colors that are close to the target color in RGB space.
Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this option to match colors that are close to the target color in RGB space.
Applies a mathematical expression to the specified image.
Gamma level of the image. The same color image displayed on two different workstations may look different due to differences in the display monitor. Use gamma correction to adjust for this color difference.
gamma gamma-corrects a particular image channel. The same image viewed on different devices will have perceptual differences in the way the image's intensities are represented on the screen. Specify individual gamma levels for the red, green, and blue channels, or adjust all three with the gamma function. Values typically range from 0.8 to 2.3.
gamma gamma-corrects a particular image channel. The same image viewed on different devices will have perceptual differences in the way the image's intensities are represented on the screen. Specify individual gamma levels for the red, green, and blue channels, or adjust all three with the gamma function. Values typically range from 0.8 to 2.3.
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.
Preferred size of the image when encoding.
Preferred size of the image when encoding.
Returns the TypeMetric class witch provides the information regarding font metrics such as ascent, descent, text width, text height, and maximum horizontal advance. The units of these font metrics are in pixels, and that the metrics are dependent on the current Image font (default Ghostscript's "Helvetica"), pointsize (default 12 points), and x/y resolution (default 72 DPI) settings.
GIF disposal method. This attribute is used to control how successive images are rendered (how the preceding image is disposed of) when creating a GIF animation.
GIF disposal method. This attribute is used to control how successive images are rendered (how the preceding image is disposed of) when creating a GIF animation.
Returns true if all the pixels in the image have the same red, green, and blue intensities.
applies a Hald color lookup table to the image. A Hald color lookup table is a 3-dimensional color cube mapped to 2 dimensions. Create it with the HALD coder. You can apply any color transformation to the Hald image and then use this method to apply the transform to the image.
Computes the number of times each unique color appears in the image. You may want to quantize the image before using this property.
ICC color profile.
ICC color profile.
A funhouse mirror effect.
Replaces the pixels in the specified area with pixel data from the supplied array.
Specify the _type of interlacing scheme for raw image formats such as RGB or YUV. NoInterlace means do not interlace, LineInterlace uses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlace is like PlaneInterlace except the different planes are saved to individual files (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image. The default is NoInterlace.
Specify the _type of interlacing scheme for raw image formats such as RGB or YUV. NoInterlace means do not interlace, LineInterlace uses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlace is like PlaneInterlace except the different planes are saved to individual files (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image. The default is NoInterlace.
The International Press Telecommunications Council profile.
The International Press Telecommunications Council profile.
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. Colors darker than the black point are set to zero. Colors brighter than the white point are set to the maximum quantum value.
applies the reversed level operation to just the channels specified. It compresses the full range of color values, so that they lie between the given black and white points. Gamma is applied before the values are mapped.
Discards any pixels below the black point and above the white point and levels the remaining pixels.
Rescale image with seam carving. To use this method, you must have installed and configured ImageMagick to use the Liquid Rescale Library.
Image format (e.g. "GIF")
Image format (e.g. "GIF")
A convenience method that scales an image proportionally to twice its size.
Set the image transparent color. The default is "#bdbdbd".
Set the image transparent color. The default is "#bdbdbd".
The mean error per pixel computed when an image is color reduced. This parameter is only valid if verbose is set to true and the image has just been quantized.
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.
A convenience method that scales an image proportionally to half its size.
Modulate percent hue, saturation, and brightness of an image. Modulation of saturation and brightness is as a ratio of the current value (1 ( == 100% ) for no change).
Image modulus depth (minimum number of bits required to support red/green/blue components without loss of accuracy). The pixel modulus depth may be decreased by supplying a value which is less than the current value, updating the pixels (reducing accuracy) to the new depth. The pixel modulus depth can not be increased over the current value using this method.
Image modulus depth (minimum number of bits required to support red/green/blue components without loss of accuracy). The pixel modulus depth may be decreased by supplying a value which is less than the current value, updating the pixels (reducing accuracy) to the new depth. The pixel modulus depth can not be increased over the current value using this method.
Establish a progress monitor. Most Image and ImageList methods will periodically call the monitor with arguments indicating the progress of the method.
Establish a progress monitor. Most Image and ImageList methods will periodically call the monitor with arguments indicating the progress of the method.
Tile size and offset within an image montage. Only valid for images produced by montage.
Simulates motion blur. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). Use a radius of 0 and motion_blur selects a suitable radius for you. Angle gives the angle of the blurring motion.
Negates the colors in the reference image.
Enhances the contrast of a color image by adjusting the pixel color to span the entire range of colors available.
The normalized max error per pixel computed when an image is color reduced. This parameter is only valid if verbose is set to true and the image has just been quantized.
The normalized mean error per pixel computed when an image is color reduced. This parameter is only valid if verbose is set to true and the image has just been quantized.
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.
Sets the value of the image property. An image may have any number of properties. ImageMagick predefines some properties, including attribute, label, caption, comment, signature, and in some cases EXIF.
Returns the value of the image property.
Set or attenuate the opacity channel in the image. If the image pixels are opaque then they are set to the specified opacity value, otherwise they are blended with the supplied opacity value.
Changes all pixels having the target color to the fill color.
Dithers the image to a predefined pattern.
Image orientation. Supported by some file formats such as DPX and TIFF. Useful for turning the right way up.
When compositing, this attribute describes the position of this image with respect to the underlying image.
Ping is similar to read except only enough of the image is read to determine the image columns, rows, and filesize. The columns, rows, and fileSize attributes are valid after invoking ping. The image data is not valid after calling ping.
Ping is similar to read except only enough of the image is read to determine the image columns, rows, and filesize. The columns, rows, and fileSize attributes are valid after invoking ping. The image data is not valid after calling ping.
The pixel color interpolation method. Some methods (such as wave, swirl, implode, and composite) use the pixel color interpolation method to determine how to blend adjacent pixels.
Produce an image that looks like a Polaroid® instant picture. If the image has a "Caption" property, the value is used as a caption.
Reduces the image to a limited number of colors for a "poster" effect.
Creates an image that contains 9 small versions of the receiver image. The center image is the unchanged receiver. The other 8 images are variations created by transforming the receiver according to the specified preview type with varying parameters.
Execute the named process module, passing any arguments arguments. An exception is thrown if the requested process module does not exist, fails to load, or fails during execution.
Get/set/remove a named profile. Valid names include "*", "8BIM", "ICM", "IPTC", or a user/format-defined profile name.
JPEG/MIFF/PNG compression level (default 75).
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 difference between the input and output image while minimizing the processing time.
Creates a simulated three-dimensional button-like effect by lightening and darkening the edges of the image.
Changes the value of individual pixels based on the intensity of each pixel compared to a random threshold. The result is a low-contrast, two color image.
Reads an image from an array of pixels.
Reads an image from an in-memory blob. The Blob size, depth and magick format may also be specified.
Reads an image from an in-memory blob. The Blob size, depth and magick format may also be specified.
Read an Image by reading from the file or URL specified by filename with the specified size. Usefull for images that don't specify their size.
Read an Image by reading from the file or URL specified by filename.
Smooths the contours of an image while still preserving edge information. The algorithm works by replacing each pixel with its neighbor closest in value.
Reduce the number of colors in img to the colors used by reference. If a dither method is set then the given colors are dithered over the image as necessary, otherwise the closest color (in RGB colorspace) is selected to replace that pixel in the image.
The type of rendering intent.
Resize image in terms of its pixel size, so that when displayed at the given resolution it will be the same size in terms of real world units as the original image at the original resolution.
scales an image to the desired dimensions, using the given filter.
Units of image resolution
Units of image resolution
Offsets an image as defined by xOffset and yOffset.
Rotate the image by specified number of degrees. Rotated images are usually larger than the originals and have 'empty' triangular corners. Empty triangles left over from shearing the image are filled with the background color defined by the 'backgroundColor' property of the image.
Applies a rotational blur to the image.
The height of the image in pixels.
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.
Resize image by using simple ratio algorithm.
The scene number assigned to the image the last time the image was written to a multi-image image file.
Segments an image by analyzing the histograms of the color components and identifying units that are homogeneous with the fuzzy c-means technique. Also uses quantizeColorSpace and verbose image properties.
Selectively blur pixels within a contrast threshold.
applies a special effect to the image, similar to the effect achieved in a photo darkroom by sepia toning. A threshold of 80% is a good starting point for a reasonable tone.
shines a distant light on an image to create a three-dimensional effect. You control the positioning of the light with azimuth and elevation.
Simulates a shadow from the specified image and returns it. This method only works when the image has opaque parts and transparent parts. Note that the resulting image is just the shadow.
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 sharpen selects a suitable radius for you.
Removes pixels from the edges of the image, leaving the center rectangle.
Shearing 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, xShearAngle is measured relative to the Y axis, and similarly, for Y direction shears yShearAngle is measured relative to the X axis. Empty triangles left over from shearing the image are filled with the background color.
Adjusts the contrast of an image channel with a non-linear sigmoidal contrast algorithm. Increases the contrast of the image using a sigmoidal transfer function without saturating highlights or shadows.
Width and height of a image.
Simulates a pencil sketch. For best results start with a grayscale image.
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.
Fills the image with the specified color or colors, starting at the x,y coordinates associated with the color and using the specified interpolation method.
Splice the background color into the image as defined by the geometry. This method is the opposite of chop.
Randomly displaces each pixel in a block defined by the radius parameter.
Makes each pixel the min / max / median / mode / etc. of the neighborhood of the specified width and height.
Hides a digital watermark in the receiver. You can retrieve the watermark by reading the file with the stegano: prefix, thereby proving the authenticity of the file.
Combines two images and produces a single image that is the composite of a left and right image of a stereo pair. Special red-green stereo glasses are required to view this effect.
Strips an image of all profiles and comments.
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.
synchronizes image properties with the image profiles. Currently we only support updating the EXIF resolution and orientation.
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.
changes the size of an image to the given dimensions and removes any associated profiles. The goal is to produce small low cost thumbnail images suited for display on the Web.
Creates a Binary Large OBject, a direct-to-memory version of the image.
Constructs a description of the image as a string. The string contains some or all of the following fields:
Number of colors in the image.
Changes the opacity value of all the pixels that match color to the value specified by opacity. By default the pixel must match exactly, but you can specify a tolerance level by setting the fuzz attribute on the image.
Changes the opacity value associated with any pixel between low and high to the value defined by opacity.
Creates a horizontal mirror image by reflecting the pixels around the central y-axis while rotating them by 90 degrees.
Creates a vertical mirror image by reflecting the pixels around the central x-axis while rotating them by 270 degrees
Removes the edges that are exactly the same color as the corner pixels. Use the fuzz property to make trim remove edges that are nearly the same color as the corner pixels.
Image type.
Constructs a new image with one pixel for each unique color in the image. The new image has 1 row. The row has 1 column for each unique pixel in the image.
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 unsharpMask selects a suitable radius for you.
Get a view into the image. The ImageView can be used to modify individual pixels of the image.
Gradually shades the edges of the image by transforming the pixels into the background color.
Specify how "virtual pixels" behave. Virtual pixels are pixels that are outside the boundaries of the image. Methods such as blurImage, sharpen, and wave use virtual pixels.
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.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.
Forces all pixels above the threshold into white while leaving all pixels below the threshold unchanged.
Forces all pixels above the threshold into white while leaving all pixels below the threshold unchanged.
Writes the image to the specified file. ImageMagick determines image format from the prefix or extension.
Horizontal resolution of the image.
Vertical resolution of the image.
Pixel cache threshold in megabytes. Once this threshold is exceeded, all subsequent pixels cache operations are to/from disk. This is a static method and the attribute it sets is shared by all Image objects
The options for this image.
The image