<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><HTML> <HEAD><meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <TITLE>fx - ImageMagick Special Effects Methods</TITLE> <link rel="StyleSheet" href="../magick.css" type="text/css"> </HEAD> <body bgcolor="#FFFFFF" text="#000000" link="#0085c0" alink="#0085c0" vlink="#800080"> <A NAME="__index__"></A> <!-- INDEX BEGIN --> <UL> <LI><A HREF="#name"> <FONT SIZE=-1>NAME</FONT></A> <LI><A HREF="#synopsis"> <FONT SIZE=-1>SYNOPSIS</FONT></A> <LI><A HREF="#function descriptions"> <FONT SIZE=-1>FUNCTION</FONT> <FONT SIZE=-1>DESCRIPTIONS</FONT></A> <UL> <LI><A HREF="#charcoalimage">CharcoalImage</A> <LI><A HREF="#colorizeimage">ColorizeImage</A> <LI><A HREF="#convolveimage">ConvolveImage</A> <LI><A HREF="#implodeimage">ImplodeImage</A> <LI><A HREF="#morphimages">MorphImages</A> <LI><A HREF="#oilpaintimage">OilPaintImage</A> <LI><A HREF="#solarizeimage">SolarizeImage</A> <LI><A HREF="#steganoimage">SteganoImage</A> <LI><A HREF="#stereoimage">StereoImage</A> <LI><A HREF="#swirlimage">SwirlImage</A> <LI><A HREF="#waveimage">WaveImage</A> </UL> </UL> <!-- INDEX END --> <HR> <P> <H1><A NAME="name"> <FONT SIZE=-1>NAME</FONT></A></H1> <P>fx - ImageMagick Special Effects Methods</P> <P> <HR> <H1><A NAME="synopsis"> <FONT SIZE=-1>SYNOPSIS</FONT></A></H1> <P>Image * <STRONG>CharcoalImage</STRONG>( const Image *image, const double radius, const double sigma, ExceptionInfo *exception );</P> <P>Image * <STRONG>ColorizeImage</STRONG>( const Image *image, const char *opacity, const PixelPacket target, ExceptionInfo *exception );</P> <P>Image * <STRONG>ConvolveImage</STRONG>( const Image *image, const unsigned int order, const double *kernel, ExceptionInfo *exception );</P> <P>Image * <STRONG>ImplodeImage</STRONG>( const Image *image, const double amount, ExceptionInfo *exception );</P> <P>Image * <STRONG>MorphImages</STRONG>( const Image *image, const unsigned long number_frames, ExceptionInfo *exception );</P> <P>Image * <STRONG>OilPaintImage</STRONG>( const Image *image, const double radius, ExceptionInfo *exception );</P> <P>void <STRONG>SolarizeImage</STRONG>( Image *image, const double threshold );</P> <P>Image * <STRONG>SteganoImage</STRONG>( const Image *image, Image *watermark, ExceptionInfo *exception );</P> <P>Image * <STRONG>StereoImage</STRONG>( const Image *image, const Image *offset_image, ExceptionInfo *exception );</P> <P>Image * <STRONG>SwirlImage</STRONG>( const Image *image, double degrees, ExceptionInfo *exception );</P> <P>Image * <STRONG>WaveImage</STRONG>( const Image *image, const double amplitude, const double wave_length, ExceptionInfo *exception );</P> <P> <HR> <H1><A NAME="function descriptions"> <FONT SIZE=-1>FUNCTION</FONT> <FONT SIZE=-1>DESCRIPTIONS</FONT></A></H1> <P> <H2><A NAME="charcoalimage">CharcoalImage</A></H2> <P>Method CharcoalImage 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> <P>The format of the CharcoalImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *CharcoalImage ( const <A HREF="types/Image.html">Image</A> *image, const double radius, const double sigma, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG><A NAME="item_o_charcoal_image%3A">charcoal_image:</A></STRONG><BR> <DD> Method CharcoalImage 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. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_image%3A">image:</A></STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_radius%3A">radius:</A></STRONG><BR> <DD> the radius of the pixel neighborhood. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_sigma%3A">sigma:</A></STRONG><BR> <DD> The standard deviation of the Gaussian, in pixels. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_exception%3A">exception:</A></STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="colorizeimage">ColorizeImage</A></H2> <blockquote>ColorizeImage() blends the fill color with each pixel in the image. A percentage blend is specified with opacity. Control the application of different color components by specifying a different percentage for </blockquote><P>The format of the ColorizeImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *ColorizeImage ( const <A HREF="types/Image.html">Image</A> *image, const char *opacity, const <A HREF="types/PixelPacket.html">PixelPacket</A> target, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_opacity%3A">opacity:</A></STRONG><BR> <DD> <FONT SIZE=-1>A</FONT> character string indicating the level of opacity as a percentage. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_target%3A">target:</A></STRONG><BR> <DD> <FONT SIZE=-1>A</FONT> color value. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="convolveimage">ConvolveImage</A></H2> <blockquote>ConvolveImage() applies a custom convolution kernel to the image. </blockquote><P>The format of the ConvolveImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *ConvolveImage ( const <A HREF="types/Image.html">Image</A> *image, const unsigned int order, const double *kernel, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_order%3A">order:</A></STRONG><BR> <DD> The number of columns and rows in the filter kernel. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_kernel%3A">kernel:</A></STRONG><BR> <DD> An array of double representing the convolution kernel. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <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 ``implode'' by the specified percentage. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</P> <P>The format of the ImplodeImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *ImplodeImage ( const <A HREF="types/Image.html">Image</A> *image, const double amount, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG><A NAME="item_o_implode_image%3A">implode_image:</A></STRONG><BR> <DD> Method ImplodeImage returns a pointer to the image after it is implode. <FONT SIZE=-1>A</FONT> null image is returned if there is a memory shortage. <P></P> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_amount%3A">amount:</A></STRONG><BR> <DD> Define the extent of the implosion. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="morphimages">MorphImages</A></H2> <blockquote>The MorphImages() method requires a minimum of two images. The first image is transformed into the second by a number of intervening images as specified by frames. </blockquote><P>The format of the MorphImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *MorphImages ( const <A HREF="types/Image.html">Image</A> *image, const unsigned long number_frames, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_number_frames%3A">number_frames:</A></STRONG><BR> <DD> Define the number of in-between image to generate. The more in-between frames, the smoother the morph. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="oilpaintimage">OilPaintImage</A></H2> <blockquote>OilPaintImage() 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. </blockquote><P>The format of the OilPaintImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *OilPaintImage ( const <A HREF="types/Image.html">Image</A> *image, const double radius, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG>radius:</STRONG><BR> <DD> The radius of the circular neighborhood. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="solarizeimage">SolarizeImage</A></H2> <blockquote>SolarizeImage() 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. </blockquote><P>The format of the SolarizeImage method is:</P> <blockquote>void SolarizeImage ( <A HREF="types/Image.html">Image</A> *image, const double threshold ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_threshold%3A">threshold:</A></STRONG><BR> <DD> Define the extent of the solarization. <P></P></DL></DL> <P> <H2><A NAME="steganoimage">SteganoImage</A></H2> <blockquote>Use SteganoImage() 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. </blockquote><P>The format of the SteganoImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *SteganoImage ( const <A HREF="types/Image.html">Image</A> *image, <A HREF="types/Image.html">Image</A> *watermark, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_watermark%3A">watermark:</A></STRONG><BR> <DD> The watermark image. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="stereoimage">StereoImage</A></H2> <blockquote>StereoImage() 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. </blockquote><P>The format of the StereoImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *StereoImage ( const <A HREF="types/Image.html">Image</A> *image, const <A HREF="types/Image.html">Image</A> *offset_image, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG><A NAME="item_o_stereo_image%3A">stereo_image:</A></STRONG><BR> <DD> Method StereoImage returns a pointer to the stereo image. <FONT SIZE=-1>A</FONT> null image is returned if there is a memory shortage. <P></P> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_offset_image%3A">offset_image:</A></STRONG><BR> <DD> Another image. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="swirlimage">SwirlImage</A></H2> <blockquote>SwirlImage() 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. </blockquote><P>The format of the SwirlImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *SwirlImage ( const <A HREF="types/Image.html">Image</A> *image, double degrees, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_degrees%3A">degrees:</A></STRONG><BR> <DD> Define the tightness of the swirling effect. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. <P></P></DL></DL> <P> <H2><A NAME="waveimage">WaveImage</A></H2> <blockquote>The WaveImage() filter 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. </blockquote><P>The format of the WaveImage method is:</P> <blockquote><A HREF="types/Image.html">Image</A> *WaveImage ( const <A HREF="types/Image.html">Image</A> *image, const double amplitude, const double wave_length, <A HREF="types/ExceptionInfo.html">ExceptionInfo</A> *exception ); </blockquote><P> <FONT SIZE=-1>A</FONT> description of each parameter follows:</P> <DL><DT><DD><DL> <dd><p></p><dt><STRONG>image:</STRONG><BR> <DD> The image. <P></P> <dd><p></p><dt><STRONG><A NAME="item_o_amplitude%2C_frequency%3A">amplitude, frequency:</A></STRONG><BR> <DD> Define the amplitude and wave_length of the sine wave. <P></P> <dd><p></p><dt><STRONG>exception:</STRONG><BR> <DD> Return any errors or warnings in this structure. </DL></DL> </BODY> </HTML>
