m+I9effect - ImageMagick Image Effects Methods>j Pair








NAME

1

effect - ImageMagick Image Effects Methods






(

SYNOPSIS

z

Image * AddNoiseImage( const Image *image, const NoiseType noise_type, ExceptionInfo *exception );

Image * BlurImage( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

_

Image * DespeckleImage( const Image *image, ExceptionInfo *exception );

o

Image * EdgeImage( const Image *image, const double radius, ExceptionInfo *exception );

Image * EmbossImage( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

]

Image * EnhanceImage( const Image *image, ExceptionInfo *exception );

Image * GaussianBlurImage( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

w

Image * MedianFilterImage( const Image *image, const double radius, ExceptionInfo *exception );

Image * MotionBlurImage( const Image *image, const double radius, const double sigma, const double angle, ExceptionInfo *exception );

v

Image * ReduceNoiseImage( const Image *image, const double radius, ExceptionInfo *exception );

Image * ShadeImage( const Image *image, const unsigned int gray, double azimuth, double elevation, ExceptionInfo *exception );

Image * SharpenImage( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

w

Image * SpreadImage( const Image *image, const unsigned int radius, ExceptionInfo *exception );

\

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

Image * UnsharpMaskImage( const Image *image, const double radius, const double sigma, const double amount, const double threshold, ExceptionInfo *exception );






B

FUNCTION DESCRIPTIONS





2

AddNoiseImage

z
AddNoiseImage() adds random noise to the image.

The format of the AddNoiseImage method is:

@
Image *AddNoiseImage ( const Image *image, const NoiseType noise_type, ExceptionInfo *exception );

A description of each parameter follows:


A
o image:


The image.


K
o noise_type:


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


I
o exception:


0Return any errors or warnings in this structure.





*

BlurImage

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


Image *BlurImage ( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

A description of each parameter follows:


C
o radius:


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


A
o sigma:


2The standard deviation of the Gaussian, in pixels.


'
o exception:


0Return any errors or warnings in this structure.





4

DespeckleImage

w

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

2

The format of the DespeckleImage method is:

Image *DespeckleImage ( const Image *image, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


'
o exception:


0Return any errors or warnings in this structure.





*

EdgeImage

EdgeImage() finds edges in an image. Radius defines the radius of the convolution filter. Use a radius of 0 and Edge ( ) selects a suitable radius for you.

The format of the EdgeImage method is:


Image *EdgeImage ( const Image *image, const double radius, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


%the radius of the pixel neighborhood.


'
o exception:


0Return any errors or warnings in this structure.





.

EmbossImage

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


Image *EmbossImage ( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


%the radius of the pixel neighborhood.


#
o sigma:


2The standard deviation of the Gaussian, in pixels.


'
o exception:


0Return any errors or warnings in this structure.





0

EnhanceImage

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

The format of the EnhanceImage method is:

Image *EnhanceImage ( const Image *image, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


'
o exception:


0Return any errors or warnings in this structure.





:

GaussianBlurImage

^
GaussianBlurImage() 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 GaussianBlurImage ( ) selects a suitable radius for you

The format of the BlurImage method is:

!
Image *GaussianBlurImage ( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

A description of each parameter follows:


K
o blur_image:


Method GaussianBlurImage returns a pointer to the image after it is blur. A null image is returned if there is a memory shortage.


$
o radius:


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


#
o sigma:


2the standard deviation of the Gaussian, in pixels.


'
o exception:


0Return any errors or warnings in this structure.





:

MedianFilterImage


MedianFilterImage() 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 algorithm was contributed by Mike Edmonds and implements an insertion sort for selecting median color-channel values. For more on this algorithm see ``Skip Lists: A probabilistic Alternative to Balanced Trees'' by William Pugh in the June 1990 of Communications of the ACM.

5

The format of the MedianFilterImage method is:


Image *MedianFilterImage ( const Image *image, const double radius, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


%The radius of the pixel neighborhood.


'
o exception:


0Return any errors or warnings in this structure.





6

MotionBlurImage


MotionBlurImage() 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.

Andrew Protano contributed this effect.

3

The format of the MotionBlurImage method is:

3
Image *MotionBlurImage ( const Image *image, const double radius, const double sigma, const double angle, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


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


#
o sigma:


2The standard deviation of the Gaussian, in pixels.


A
o angle:


"Apply the effect along this angle.


'
o exception:


0Return any errors or warnings in this structure.





8

ReduceNoiseImage

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


Image *ReduceNoiseImage ( const Image *image, const double radius, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


%The radius of the pixel neighborhood.


'
o exception:


0Return any errors or warnings in this structure.





,

ShadeImage

F
ShadeImage() shines a distant light on an image to create a three-dimensional effect. You control the positioning of the light with azimuth and elevation; azimuth is measured in degrees off the x axis and elevation is measured in pixels above the Z axis.

The format of the ShadeImage method is:

,
Image *ShadeImage ( const Image *image, const unsigned int gray, double azimuth, double elevation, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


?
o gray:


;A value other than zero shades the intensity of each pixel.


]
o azimuth, elevation:


"Define the light source direction.


'
o exception:


0Return any errors or warnings in this structure.





0

SharpenImage

W
SharpenImage() 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 SharpenImage ( ) selects a suitable radius for you.

The format of the SharpenImage method is:


Image *SharpenImage ( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


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


#
o sigma:


3The standard deviation of the Laplacian, in pixels.


'
o exception:


0Return any errors or warnings in this structure.





.

SpreadImage

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

The format of the SpreadImage method is:


Image *SpreadImage ( const Image *image, const unsigned int radius, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


7Choose a random pixel in a neighborhood of this extent.


'
o exception:


0Return any errors or warnings in this structure.





4

ThresholdImage

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

The format of the ThresholdImage method is:

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

A description of each parameter follows:


#
o image:


The image.


I
o threshold:


Define the threshold value





8

UnsharpMaskImage

b
UnsharpMaskImage() sharpens an image. We convolve the image with a Gaussian operatorof 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 UnsharpMaskImage method is:

M
Image *UnsharpMaskImage ( const Image *image, const double radius, const double sigma, const double amount, const double threshold, ExceptionInfo *exception );

A description of each parameter follows:


#
o image:


The image.


$
o radius:


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


#
o sigma:


2The standard deviation of the Gaussian, in pixels.


C
o amount:


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


'
o threshold:


<The threshold in pixels needed to apply the diffence amount.


'
o exception:


0Return any errors or warnings in this structure.