<?xml version="1.0" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>resize - Resize an image</title> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <link rev="made" href="mailto:bfriesen@freddy.simplesystems.org" /> </head> <body style="background-color: white"> <P><a name="__index__"></a></P> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#function_descriptions">FUNCTION DESCRIPTIONS</a></li> <ul> <li><a href="#magnifyimage">MagnifyImage</a></li> <li><a href="#minifyimage">MinifyImage</a></li> <li><a href="#resizeimage">ResizeImage</a></li> <li><a href="#sampleimage">SampleImage</a></li> <li><a href="#scaleimage">ScaleImage</a></li> <li><a href="#thumbnailimage">ThumbnailImage</a></li> </ul> </ul> <!-- INDEX END --> <hr /> <P> </P> <h1><a name="name">NAME</a></h1> <P>resize - Resize an image</P> <P> </P> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <P>Image * <strong>MagnifyImage</strong>( const Image *image, ExceptionInfo *exception );</P> <P>Image * <strong>MinifyImage</strong>( const Image *image, ExceptionInfo *exception );</P> <P>Image * <strong>ResizeImage</strong>( Image *image, const unsigned long columns, const unsigned long rows, const FilterTypes filter, const double blur, ExceptionInfo *exception );</P> <P>Image * <strong>SampleImage</strong>( const Image *image, const unsigned long columns, const unsigned long rows, ExceptionInfo *exception );</P> <P>Image * <strong>ScaleImage</strong>( const Image *image, const unsigned long columns, const unsigned long rows, ExceptionInfo *exception );</P> <P>Image * <strong>ThumbnailImage</strong>( const Image *image, const unsigned long columns, const unsigned long rows, ExceptionInfo *exception );</P> <P> </P> <hr /> <h1><a name="function_descriptions">FUNCTION DESCRIPTIONS</a></h1> <P> </P> <h2><a name="magnifyimage">MagnifyImage</a></h2> <blockquote>MagnifyImage() is a convenience method that scales an image proportionally to twice its size. </blockquote><P>The format of the MagnifyImage method is:</P> <blockquote><A HREF="types.html#Image">Image</A> *MagnifyImage ( const <A HREF="types.html#Image">Image</A> *image, <A HREF="types.html#ExceptionInfo">ExceptionInfo</A> *exception ); </blockquote><P>A description of each parameter follows:</P> <dl> <dt><strong><a name="item_o_image_3a">image:</a></strong> <DD> <P>The image.</P> </dd> </li> <dt><strong><a name="item_o_exception_3a">exception:</a></strong> <DD> <P>Return any errors or warnings in this structure.</P> </dd> </li> </dl> <P> </P> <h2><a name="minifyimage">MinifyImage</a></h2> <blockquote>MinifyImage() is a convenience method that scales an image proportionally to half its size. </blockquote><P>The format of the MinifyImage method is:</P> <blockquote><A HREF="types.html#Image">Image</A> *MinifyImage ( const <A HREF="types.html#Image">Image</A> *image, <A HREF="types.html#ExceptionInfo">ExceptionInfo</A> *exception ); </blockquote><P>A description of each parameter follows:</P> <dl> <dt><strong>image:</strong> <DD> <P>The image.</P> </dd> </li> <dt><strong>exception:</strong> <DD> <P>Return any errors or warnings in this structure.</P> </dd> </li> </dl> <P> </P> <h2><a name="resizeimage">ResizeImage</a></h2> <blockquote>ResizeImage() scales an image to the desired dimensions with one of these filters: </blockquote><pre> Bessel Blackman Box Catrom Cubic Gaussian Hanning Hermite Lanczos Mitchell Point Quandratic Sinc Triangle</pre> <P>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.</P> <blockquote>ResizeImage() was inspired by Paul Heckbert's zoom program. </blockquote><P>The format of the ResizeImage method is:</P> <blockquote><A HREF="types.html#Image">Image</A> *ResizeImage ( <A HREF="types.html#Image">Image</A> *image, const unsigned long columns, const unsigned long rows, const <A HREF="types.html#FilterTypes">FilterTypes</A> filter, const double blur, <A HREF="types.html#ExceptionInfo">ExceptionInfo</A> *exception ); </blockquote><P>A description of each parameter follows:</P> <dl> <dt><strong>image:</strong> <DD> <P>The image.</P> </dd> </li> <dt><strong><a name="item_o_columns_3a">columns:</a></strong> <DD> <P>The number of columns in the scaled image.</P> </dd> </li> <dt><strong><a name="item_o_rows_3a">rows:</a></strong> <DD> <P>The number of rows in the scaled image.</P> </dd> </li> <dt><strong><a name="item_o_filter_3a">filter:</a></strong> <DD> <P>Image filter to use.</P> </dd> </li> <dt><strong><a name="item_o_blur_3a">blur:</a></strong> <DD> <P>The blur factor where > 1 is blurry, < 1 is sharp.</P> </dd> </li> <dt><strong>exception:</strong> <DD> <P>Return any errors or warnings in this structure.</P> </dd> </li> </dl> <P> </P> <h2><a name="sampleimage">SampleImage</a></h2> <blockquote>SampleImage() 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. </blockquote><P>The format of the SampleImage method is:</P> <blockquote><A HREF="types.html#Image">Image</A> *SampleImage ( const <A HREF="types.html#Image">Image</A> *image, const unsigned long columns, const unsigned long rows, <A HREF="types.html#ExceptionInfo">ExceptionInfo</A> *exception ); </blockquote><P>A description of each parameter follows:</P> <dl> <dt><strong>image:</strong> <DD> <P>The image.</P> </dd> </li> <dt><strong>columns:</strong> <DD> <P>The number of columns in the sampled image.</P> </dd> </li> <dt><strong>rows:</strong> <DD> <P>The number of rows in the sampled image.</P> </dd> </li> <dt><strong>exception:</strong> <DD> <P>Return any errors or warnings in this structure.</P> </dd> </li> </dl> <P> </P> <h2><a name="scaleimage">ScaleImage</a></h2> <blockquote>ScaleImage() changes the size of an image to the given dimensions. </blockquote><P>The format of the ScaleImage method is:</P> <blockquote><A HREF="types.html#Image">Image</A> *ScaleImage ( const <A HREF="types.html#Image">Image</A> *image, const unsigned long columns, const unsigned long rows, <A HREF="types.html#ExceptionInfo">ExceptionInfo</A> *exception ); </blockquote><P>A description of each parameter follows:</P> <dl> <dt><strong>image:</strong> <DD> <P>The image.</P> </dd> </li> <dt><strong>columns:</strong> <DD> <P>The number of columns in the scaled image.</P> </dd> </li> <dt><strong>rows:</strong> <DD> <P>The number of rows in the scaled image.</P> </dd> </li> <dt><strong>exception:</strong> <DD> <P>Return any errors or warnings in this structure.</P> </dd> </li> </dl> <P> </P> <h2><a name="thumbnailimage">ThumbnailImage</a></h2> <blockquote>ThumbnailImage() changes the size of an image to the given dimensions. This method was designed by Bob Friesenhahn as a low cost thumbnail generator. </blockquote><P>The format of the ThumbnailImage method is:</P> <blockquote><A HREF="types.html#Image">Image</A> *ThumbnailImage ( const <A HREF="types.html#Image">Image</A> *image, const unsigned long columns, const unsigned long rows, <A HREF="types.html#ExceptionInfo">ExceptionInfo</A> *exception ); </blockquote><P>A description of each parameter follows:</P> <dl> <dt><strong>image:</strong> <DD> <P>The image.</P> </dd> </li> <dt><strong>columns:</strong> <DD> <P>The number of columns in the scaled image.</P> </dd> </li> <dt><strong>rows:</strong> <DD> <P>The number of rows in the scaled image.</P> </dd> </li> <dt><strong>exception:</strong> <DD> <P>Return any errors or warnings in this structure.</P> </dd> </dl> </body> </html>
