File: effects.html

package info (click to toggle)
imagemagick 4.2.8-9
links: PTS
area: main
in suites: potato
size: 11,116 kB
ctags: 5,107
sloc: ansic: 98,927; sh: 11,151; cpp: 8,810; perl: 1,922; tcl: 458; makefile: 347
file content (878 lines) | stat: -rw-r--r-- 24,552 bytes
parent folder | download | duplicates (2)
<HTML>
<HEAD>
<TITLE>effects - ImageMagick Image Effects Methods</TITLE>
<LINK REV="made" HREF="mailto:magick@wizards.dupont.com">
</HEAD>

<body background="../../images/background.gif">

<!-- INDEX BEGIN -->

<UL>

	<LI><A HREF="#NAME">NAME</A>
	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
	<LI><A HREF="#FUNCTION_DESCRIPTIONS">FUNCTION DESCRIPTIONS</A>
	<UL>

		<LI><A HREF="#AddNoiseImage">AddNoiseImage</A>
		<LI><A HREF="#BlurImage">BlurImage</A>
		<LI><A HREF="#ColorizeImage">ColorizeImage</A>
		<LI><A HREF="#DespeckleImage">DespeckleImage</A>
		<LI><A HREF="#EdgeImage">EdgeImage</A>
		<LI><A HREF="#EmbossImage">EmbossImage</A>
		<LI><A HREF="#EnhanceImage">EnhanceImage</A>
		<LI><A HREF="#ImplodeImage">ImplodeImage</A>
		<LI><A HREF="#MorphImages">MorphImages</A>
		<LI><A HREF="#OilPaintImage">OilPaintImage</A>
		<LI><A HREF="#PlasmaImage">PlasmaImage</A>
		<LI><A HREF="#ReduceNoiseImage">ReduceNoiseImage</A>
		<LI><A HREF="#ShadeImage">ShadeImage</A>
		<LI><A HREF="#SharpenImage">SharpenImage</A>
		<LI><A HREF="#SolarizeImage">SolarizeImage</A>
		<LI><A HREF="#SpreadImage">SpreadImage</A>
		<LI><A HREF="#SteganoImage">SteganoImage</A>
		<LI><A HREF="#StereoImage">StereoImage</A>
		<LI><A HREF="#SwirlImage">SwirlImage</A>
		<LI><A HREF="#ThresholdImage">ThresholdImage</A>
		<LI><A HREF="#WaveImage">WaveImage</A>
	</UL>

</UL>
<!-- INDEX END -->

<HR>
<P>
<H1><A NAME="NAME">NAME</A></H1>
<P>
effects - ImageMagick Image Effects Methods

<P>
<HR>
<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>
<P>
Image* <STRONG>AddNoiseImage</STRONG>(constImage*image,constNoiseTypenoise_type)

<P>
Image* <STRONG>BlurImage</STRONG>(constImage*image,constdoublefactor)

<P>
Image* <STRONG>DespeckleImage</STRONG>(Image*image)

<P>
Image* <STRONG>EdgeImage</STRONG>(constImage*image,constdoublefactor)

<P>
Image* <STRONG>EmbossImage</STRONG>(constImage*image)

<P>
Image* <STRONG>EnhanceImage</STRONG>(constImage*image)

<P>
Image* <STRONG>ImplodeImage</STRONG>(Image*image,constdoublefactor)

<P>
Image* <STRONG>MorphImages</STRONG>(Image*images,constunsigned intnumber_frames)

<P>
Image* <STRONG>OilPaintImage</STRONG>(Image*image,constunsigned intradius)

<P>
Image* <STRONG>ReduceNoiseImage</STRONG>(constImage*image)

<P>
Image* <STRONG>SharpenImage</STRONG>(constImage*image,constdoublefactor)

<P>
void <STRONG>SolarizeImage</STRONG>(Image*image,constdoublefactor)

<P>
Image* <STRONG>SpreadImage</STRONG>(Image*image,constunsigned intamount)

<P>
Image* <STRONG>SteganoImage</STRONG>(Image*image,Image*watermark)

<P>
Image* <STRONG>StereoImage</STRONG>(Image*left_image,constImage*right_image)

<P>
Image* <STRONG>SwirlImage</STRONG>(Image*image,doubledegrees)

<P>
void <STRONG>ThresholdImage</STRONG>(Image*image,constdoublethreshold)

<P>
<HR>
<H1><A NAME="FUNCTION_DESCRIPTIONS">FUNCTION DESCRIPTIONS</A></H1>
<P>
<HR>
<H2><A NAME="AddNoiseImage">AddNoiseImage</A></H2>
<P>
Method AddNoiseImage creates a new image that is a copy of an existing one
with noise added. It allocates the memory necessary for the new Image
structure and returns a pointer to the new image.

<P>
The format of the AddNoiseImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *AddNoiseImage (const <A HREF="types/Image.html">Image</A> *image, const <A HREF="types/Enumerations.html#NoiseType">NoiseType</A> noise_type) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG><A NAME="item_o">noisy_image:</A></STRONG><DD>
<P>
Method AddNoiseImage returns a pointer to the image after the noise is minified. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory shortage.


<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>noise_type:</STRONG><DD>
<P>
The type of noise: Gaussian, multiplicative Gaussian, impulse, laplacian,
or Poisson.

</DL></DL>
<P>
<HR>
<H2><A NAME="BlurImage">BlurImage</A></H2>
<P>
Method BlurImage creates a new image that is a copy of an existing one with
the pixels blurred. It allocates the memory necessary for the new Image
structure and returns a pointer to the new image.

<P>
BlurImage convolves the pixel neighborhood with this blurring mask:

<P>
<PRE>   1  2  1
   2  W  2
   1  2  1
</PRE>
<P>
The scan only processes pixels that have a full set of neighbors. Pixels in
the top, bottom, left, and right pairs of rows and columns are omitted from
the scan.

<P>
The format of the BlurImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *BlurImage (const <A HREF="types/Image.html">Image</A> *image, const double factor) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>blurred_image:</STRONG><DD>
<P>
Method BlurImage returns a pointer to the image after it is blurred. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>factor:</STRONG><DD>
<P>
An double value reflecting the percent weight to give to the center pixel
of the neighborhood.

</DL></DL>
<P>
<HR>
<H2><A NAME="ColorizeImage">ColorizeImage</A></H2>
<P>
Method ColorizeImage colorizes an image with the pen color. The amount of
the coloring is controlled with the opacity levels.

<P>
The format of the ColorizeImage method is:

<P>
<PRE>    void ColorizeImage(Image *image,const char *opacity,
      const char *pen_color)
</PRE>
<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>opaque_color, pen_color:</STRONG><DD>
<P>

<FONT SIZE=-1>A</FONT> character string that contain an 
<FONT SIZE=-1>X11</FONT> color string.


</DL></DL>
<P>
<HR>
<H2><A NAME="DespeckleImage">DespeckleImage</A></H2>
<P>
Method DespeckleImage creates a new image that is a copy of an existing one with the speckle noise minified. It uses the eight hull algorithm described in Applied Optics, Vol. 24, No. 10, 15 May 1985, ``Geometric filter for Speckle Reduction'', by Thomas 
<FONT SIZE=-1>R</FONT> Crimmins. Each pixel in the image is replaced by one of its eight of its surrounding pixels using a polarity and negative hull function. DespeckleImage allocates the memory necessary for the new Image structure and returns a pointer to the new image.


<P>
The format of the DespeckleImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *DespeckleImage (<A HREF="types/Image.html">Image</A> *image) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>despeckled_image:</STRONG><DD>
<P>
Method DespeckleImage returns a pointer to the image after it is despeckled. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory shortage.


<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

</DL></DL>
<P>
<HR>
<H2><A NAME="EdgeImage">EdgeImage</A></H2>
<P>
Method EdgeImage creates a new image that is a copy of an existing one with
the edges highlighted. It allocates the memory necessary for the new Image
structure and returns a pointer to the new image.

<P>
EdgeImage convolves the pixel neighborhood with this edge detection mask:

<P>
<PRE>  -1 -1 -1
  -1  W -1
  -1 -1 -1
</PRE>
<P>
The scan only processes pixels that have a full set of neighbors. Pixels in
the top, bottom, left, and right pairs of rows and columns are omitted from
the scan.

<P>
The format of the EdgeImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *EdgeImage (const <A HREF="types/Image.html">Image</A> *image, const double factor) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>edged_image:</STRONG><DD>
<P>
Method EdgeImage returns a pointer to the image after it is edged. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>factor:</STRONG><DD>
<P>
An double value reflecting the percent weight to give to the center pixel
of the neighborhood.

</DL></DL>
<P>
<HR>
<H2><A NAME="EmbossImage">EmbossImage</A></H2>
<P>
Method EmbossImage creates a new image that is a copy of an existing one
with the edge highlighted. It allocates the memory necessary for the new
Image structure and returns a pointer to the new image.

<P>
EmbossImage convolves the pixel neighborhood with this edge detection mask:

<P>
<PRE>  -1 -2  0
  -2  0  2
   0  2  1
</PRE>
<P>
The scan only processes pixels that have a full set of neighbors. Pixels in
the top, bottom, left, and right pairs of rows and columns are omitted from
the scan.

<P>
The format of the EmbossImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *EmbossImage (const <A HREF="types/Image.html">Image</A> *image) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>embossed_image:</STRONG><DD>
<P>
Method EmbossImage returns a pointer to the image after it is embossed. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

</DL></DL>
<P>
<HR>
<H2><A NAME="EnhanceImage">EnhanceImage</A></H2>
<P>
Method EnhanceImage creates a new image that is a copy of an existing one
with the noise minified. It allocates the memory necessary for the new
Image structure and returns a pointer to the new image.

<P>
EnhanceImage does a weighted average of pixels in a 5x5 cell around each target pixel. Only pixels in the 5x5 cell that are within a 
<FONT SIZE=-1>RGB</FONT> distance threshold of the target pixel are averaged.


<P>
Weights assume that the importance of neighboring pixels is negately
proportional to the square of their distance from the target pixel.

<P>
The scan only processes pixels that have a full set of neighbors. Pixels in
the top, bottom, left, and right pairs of rows and columns are omitted from
the scan.

<P>
The format of the EnhanceImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *EnhanceImage (const <A HREF="types/Image.html">Image</A> *image) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>enhanced_image:</STRONG><DD>
<P>
Method EnhanceImage returns a pointer to the image after it is enhanced. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

</DL></DL>
<P>
<HR>
<H2><A NAME="ImplodeImage">ImplodeImage</A></H2>
<P>
Method ImplodeImage creates a new image that is a copy of an existing one
with the image pixels ``imploded'' by the specified percentage. It
allocates the memory necessary for the new Image structure and returns a
pointer to the new image.

<P>
The format of the ImplodeImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *ImplodeImage (<A HREF="types/Image.html">Image</A> *image, const double factor) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>imploded_image:</STRONG><DD>
<P>
Method ImplodeImage returns a pointer to the image after it is imploded. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>factor:</STRONG><DD>
<P>

<FONT SIZE=-1>A</FONT> double value that defines the extent of the
implosion.

</DL></DL>
<P>
<HR>
<H2><A NAME="MorphImages">MorphImages</A></H2>
<P>
Method MorphImages 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.

<P>
The format of the MorphImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *MorphImages (<A HREF="types/Image.html">Image</A> *images, const unsigned int number_frames) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>morphed_image:</STRONG><DD>
<P>
Method MorphImages returns an image sequence that has linearly interpolated
pixels and size between two input images.

<DT><STRONG>images:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>number_frames:</STRONG><DD>
<P>
This unsigned integer reflects the number of in-between images to generate.
The more in-between frames, the smoother the morph.

</DL></DL>
<P>
<HR>
<H2><A NAME="OilPaintImage">OilPaintImage</A></H2>
<P>
Method OilPaintImage creates a new image that is a copy of an existing one
with each pixel component replaced with the color of greatest frequency in
a circular neighborhood.

<P>
The format of the OilPaintImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *OilPaintImage (<A HREF="types/Image.html">Image</A> *image, const unsigned int radius) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>painted_image:</STRONG><DD>
<P>
Method OilPaintImage returns a pointer to the image after it is `painted'. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>radius:</STRONG><DD>
<P>
An unsigned int that is the radius of the circular neighborhood.

</DL></DL>
<P>
<HR>
<H2><A NAME="PlasmaImage">PlasmaImage</A></H2>
<P>
Method PlasmaImage initializes an image with plasma fractal values. The
image must be initialized with a base color and the random number generator
seeded before this method is called.

<P>
The format of the PlasmaImage method is:

<P>
<PRE>    unsigned int PlasmaImage(Image *image,const SegmentInfo *segment_info,
      int attenuate,int depth)
</PRE>
<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>status:</STRONG><DD>
<P>
Method PlasmaImage returns True when the fractal process is complete.
Otherwise False is returned.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>segment_info:</STRONG><DD>
<P>
specifies a structure of type SegmentInfo that defines the boundaries of
the area where the plasma fractals are applied.

<DT><STRONG>attenuate:</STRONG><DD>
<P>
specifies the plasma attenuation factor.

<DT><STRONG>depth:</STRONG><DD>
<P>
this integer values define the plasma recursion depth.

</DL></DL>
<P>
<HR>
<H2><A NAME="ReduceNoiseImage">ReduceNoiseImage</A></H2>
<P>
Method ReduceNoiseImage creates a new image that is a copy of an existing
one with the noise minified with a noise peak elimination filter. It
allocates the memory necessary for the new Image structure and returns a
pointer to the new image.

<P>
The principal function of noise peak elimination filter is to smooth the objects within an image without losing edge information and without creating undesired structures. The central idea of the algorithm is to replace a pixel with its next neighbor in value within a 3 x 3 window, if this pixel has been found to be noise. 
<FONT SIZE=-1>A</FONT> pixel is defined as noise if and only if this pixel is a maximum or minimum within the 3 x 3 window.


<P>
The format of the ReduceNoiseImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *ReduceNoiseImage (const <A HREF="types/Image.html">Image</A> *image) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>noisy_image:</STRONG><DD>
<P>
Method ReduceNoiseImage returns a pointer to the image after the noise is minified. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory shortage.


<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

</DL></DL>
<P>
<HR>
<H2><A NAME="ShadeImage">ShadeImage</A></H2>
<P>
Method ShadeImage creates a new image that is a copy of an existing one
with the image pixels shaded using a distance light source. It allocates
the memory necessary for the new Image structure and returns a pointer to
the new image.

<P>
The format of the ShadeImage method is:

<P>
<PRE>    Image *ShadeImage(Image *image,const unsigned int color_shading,
      double azimuth,double elevation)
</PRE>
<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>shaded_image:</STRONG><DD>
<P>
Method ShadeImage returns a pointer to the image after it is shaded. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>color_shading:</STRONG><DD>
<P>

<FONT SIZE=-1>A</FONT> value other than zero shades the red, green, and
blue components of the image.

<DT><STRONG>azimuth, elevation:</STRONG><DD>
<P>

<FONT SIZE=-1>A</FONT> double value that indicates the light source
direction.

</DL></DL>
<P>
<HR>
<H2><A NAME="SharpenImage">SharpenImage</A></H2>
<P>
Method SharpenImage creates a new image that is a copy of an existing one
with the pixels sharpened. It allocates the memory necessary for the new
Image structure and returns a pointer to the new image.

<P>
SharpenImage convolves the pixel neighborhood with this sharpening mask:

<P>
<PRE>  -1 -2 -1
  -2  W -2
  -1 -2 -1
</PRE>
<P>
The scan only processes pixels that have a full set of neighbors. Pixels in
the top, bottom, left, and right pairs of rows and columns are omitted from
the scan.

<P>
The format of the SharpenImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *SharpenImage (const <A HREF="types/Image.html">Image</A> *image, const double factor) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>sharpened_image:</STRONG><DD>
<P>
Method SharpenImage returns a pointer to the image after it is sharpened. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>factor:</STRONG><DD>
<P>
An double value reflecting the percent weight to give to the center pixel
of the neighborhood.

</DL></DL>
<P>
<HR>
<H2><A NAME="SolarizeImage">SolarizeImage</A></H2>
<P>
Method SolarizeImage produces a 'solarization' effect seen when exposing a
photographic film to light during the development process.

<P>
The format of the SolarizeImage method is:

<blockquote>void SolarizeImage (<A HREF="types/Image.html">Image</A> *image, const double factor) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>factor:</STRONG><DD>
<P>
An double value that defines the extent of the solarization.

</DL></DL>
<P>
<HR>
<H2><A NAME="SpreadImage">SpreadImage</A></H2>
<P>
Method SpreadImage creates a new image that is a copy of an existing one
with the image pixels randomly displaced. It allocates the memory necessary
for the new Image structure and returns a pointer to the new image.

<P>
The format of the SpreadImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *SpreadImage (<A HREF="types/Image.html">Image</A> *image, const unsigned int amount) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>spread_image:</STRONG><DD>
<P>
Method SpreadImage returns a pointer to the image after it is spread. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>amount:</STRONG><DD>
<P>
An unsigned value constraining the ``vicinity'' for choosing a random pixel
to swap.

</DL></DL>
<P>
<HR>
<H2><A NAME="SteganoImage">SteganoImage</A></H2>
<P>
Method SteganoImage hides a digital watermark within the image.

<P>
The format of the SteganoImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *SteganoImage (<A HREF="types/Image.html">Image</A> *image, <A HREF="types/Image.html">Image</A> *watermark) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>stegano_image:</STRONG><DD>
<P>
Method SteganoImage returns a pointer to the steganographic image with the watermark hidden. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory shortage.


<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image.

<DT><STRONG>watermark:</STRONG><DD>
<P>
The address of a structure of type Image.

</DL></DL>
<P>
<HR>
<H2><A NAME="StereoImage">StereoImage</A></H2>
<P>
Method StereoImage combines two images and produces a single image that is
the composite of a left and right image of a stereo pair. The left image is
converted to gray scale and written to the red channel of the stereo image.
The right image is converted to gray scale and written to the blue channel
of the stereo image. View the composite image with red-blue glasses to
create a stereo effect.

<P>
The format of the StereoImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *StereoImage (<A HREF="types/Image.html">Image</A> *left_image, const <A HREF="types/Image.html">Image</A> *right_image) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>stereo_image:</STRONG><DD>
<P>
Method StereoImage returns a pointer to the stereo image. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>left_image:</STRONG><DD>
<P>
The address of a structure of type Image.

<DT><STRONG>right_image:</STRONG><DD>
<P>
The address of a structure of type Image.

</DL></DL>
<P>
<HR>
<H2><A NAME="SwirlImage">SwirlImage</A></H2>
<P>
Method SwirlImage creates a new image that is a copy of an existing one
with the image pixels ``swirled'' at a specified angle. It allocates the
memory necessary for the new Image structure and returns a pointer to the
new image.

<P>
The format of the SwirlImage method is:

<blockquote><A HREF="types/Image.html">Image</A> *SwirlImage (<A HREF="types/Image.html">Image</A> *image, double degrees) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>swirled_image:</STRONG><DD>
<P>
Method SwirlImage returns a pointer to the image after it is swirled. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>degrees:</STRONG><DD>
<P>
An double value that defines the tightness of the swirling.

</DL></DL>
<P>
<HR>
<H2><A NAME="ThresholdImage">ThresholdImage</A></H2>
<P>
Method ThresholdImage thresholds the reference image.

<P>
The format of the ThresholdImage method is:

<blockquote>void ThresholdImage (<A HREF="types/Image.html">Image</A> *image, const double threshold) </blockquote>

<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>threshold:</STRONG><DD>
<P>

<FONT SIZE=-1>A</FONT> double indicating the threshold value.

</DL></DL>
<P>
<HR>
<H2><A NAME="WaveImage">WaveImage</A></H2>
<P>
Method WaveImage creates a new image that is a copy of an existing one with
the image pixels altered along a sine wave. It allocates the memory
necessary for the new Image structure and returns a pointer to the new
image.

<P>
The format of the WaveImage method is:

<P>
<PRE>    Image *WaveImage(Image *image,const double amplitude,
      const double wavelength)
</PRE>
<P>

<FONT SIZE=-1>A</FONT> description of each parameter follows:

<DL><DL>
<DT><STRONG>shaded_image:</STRONG><DD>
<P>
Method WaveImage returns a pointer to the image after it is shaded. 
<FONT SIZE=-1>A</FONT> null image is returned if there is a memory
shortage.

<DT><STRONG>image:</STRONG><DD>
<P>
The address of a structure of type Image; returned from ReadImage.

<DT><STRONG>amplitude, frequency:</STRONG><DD>
<P>

<FONT SIZE=-1>A</FONT> double value that indicates the amplitude and
wavelength of the sine wave.

</DL></DL>
</BODY>

</HTML>