<?xml version="1.0" encoding="UTF-8"?>
<!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" xml:lang="en" lang="en" dir="ltr">
<head>
<style type="text/css" media="screen,projection"><!--
@import url("../../www/magick.css");
//--></style>
<meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
<title>ImageMagick: MagickCore, C API for ImageMagick: Image Methods</title>
<meta http-equiv="Content-Language" content="en-US"/>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
<meta name="Generator" content="PHP"/>
<meta name="Keywords" content="magickcore, c, api, for, imagemagick:, image, methods, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject"/>
<meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
<meta name="Rating" content="GENERAL"/>
<meta name="Robots" content="INDEX, FOLLOW"/>
<meta name="Generator" content="ImageMagick Studio LLC"/>
<meta name="Author" content="ImageMagick Studio LLC"/>
<meta name="Revisit-after" content="2 DAYS"/>
<meta name="Resource-type" content="document"/>
<meta name="Copyright" content="Copyright (c) 1999-2008 ImageMagick Studio LLC"/>
<meta name="Distribution" content="Global"/>
<link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
</head>
<body id="www-imagemagick-org">
<table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="ImageMagick">
<tbody>
<tr valign="top">
<td align="left"><a href="../../index.html"><img id="titlebar-west" src="../../images/script.png" alt="[ImageMagick]" width="350" height="60" border="0" vspace="28" name="titlebar-west"/></a></td>
<td align="left"><a href="https://secure.networkredux.com/affiliate/idevaffiliate.html?id=146" target="1951431914"><img id="titlebar-west" src="../../images/networkredux.png" alt="[sponsor]" border="0" vspace="45" name="titlebar-west"/></a></td>
<td width="99%"><br /> </td>
<td style="background-color: white" align="right"><a href="../../index.html"><img src="../../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
<td style="background-color: white" align="right"><a href="http://www.imagemagick.org/discourse-server/" target="971545676"><img id="titlebar-east" src="../../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
</tr>
</tbody>
</table>
<table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary="">
<tbody>
<tr valign="top" style="height: 100%;">
<td id="menu" width="1%" height="100%">
<p><a href="#main">Skip to page contents</a></p>
<font size="-1">
<span>[</span>
<a href="../../index.html">About ImageMagick</a>
<span>]</span><br /><span>[</span>
<a href="../../www/command-line-tools.html">Command-line Tools</a>
<a href="../../www/command-line-processing.html" class="sub">Processing</a>
<a href="../../www/command-line-options.html" class="sub">Options</a>
<a href="http://www.imagemagick.org/Usage/" target="1781202351" class="sub">Usage</a>
<a href="../../www/api.html">Program Interfaces</a>
<a href="../../www/magick-wand.html" class="sub">MagickWand</a>
<a href="../../www/magick-core.html" class="sub">MagickCore</a>
<a href="../../www/perl-magick.html" class="sub">PerlMagick</a>
<a href="../../Magick++/" target="683058862" class="sub">Magick++</a>
<a href="../../www/architecture.html">Architecture</a>
<span>]</span><br /><span>[</span>
<a href="../../www/install-source.html">Install from Source</a>
<a href="../../www/install-source.html#unix" class="sub">Unix</a>
<a href="../../www/install-source.html#windows" class="sub">Windows</a>
<a href="../../www/binary-releases.html">Binary Releases</a>
<a href="../../www/binary-releases.html#unix" class="sub">Unix</a>
<a href="../../www/binary-releases.html#macosx" class="sub">Mac OS X</a>
<a href="../../www/binary-releases.html#windows" class="sub">Windows</a>
<a href="../../www/resources.html">Resources</a>
<span>]</span><br /><span>[</span>
<a href="../../www/download.html">Download</a>
<span>]</span><br /><span>[</span>
<a href="../../www/sitemap.html">Site Map</a>
<a href="../../www/links.html" class="sub">Links</a>
<span>]</span><br /><span>[</span>
<a href="../../www/sponsors.html">Sponsors:</a>
<fieldset>
<a href="http://www.produkte24.com" class="sponsor" target="sponsor">Kataloge zum<br />Herunterladen</a><!-- 200910010000 -->
<br />
<a href="http://business-directory.com"><img src="../../images/business+directory.gif" alt="[Business + Directory]" width="105" height="60" border="0" name="business+directory"/></a> <!-- 200808010160 -->
<br />
<a href="http://analogik.com"><img src="../../images/analogik.png" alt="[Electronic Music]" width="105" height="60" border="0" name="analogik"/></a> <!-- 200804030160 -->
</fieldset>
<span>]</span>
</font>
</td>
<td id="main" valign="top">
<p class="navigation-index">[ <a href="#AcquireImageInfo">AcquireImageInfo</a> | <a href="#AllocateImage">AllocateImage</a> | <a href="#AllocateImageColormap">AllocateImageColormap</a> | <a href="#AllocateNextImage">AllocateNextImage</a> | <a href="#AppendImages">AppendImages</a> | <a href="#AverageImages">AverageImages</a> | <a href="#CatchImageException">CatchImageException</a> | <a href="#ClipImagePath">ClipImagePath</a> | <a href="#CloneImage">CloneImage</a> | <a href="#CloneImageInfo">CloneImageInfo</a> | <a href="#CombineImages">CombineImages</a> | <a href="#CycleColormap">CycleColormap</a> | <a href="#DestroyImage">DestroyImage</a> | <a href="#DestroyImageInfo">DestroyImageInfo</a> | <a href="#GetImageClipMask">GetImageClipMask</a> | <a href="#GetImageException">GetImageException</a> | <a href="#GetImageInfo">GetImageInfo</a> | <a href="#GetImageMask">GetImageMask</a> | <a href="#GetImageType">GetImageType</a> | <a href="#GetImageVirtualPixelMethod">GetImageVirtualPixelMethod</a> | <a href="#InterpretImageFilename">InterpretImageFilename</a> | <a href="#IsHighDynamicRangeImage">IsHighDynamicRangeImage</a> | <a href="#IsImageObject">IsImageObject</a> | <a href="#IsTaintImage">IsTaintImage</a> | <a href="#ModifyImage">ModifyImage</a> | <a href="#NewMagickImage">NewMagickImage</a> | <a href="#PlasmaImage">PlasmaImage</a> | <a href="#ReferenceImage">ReferenceImage</a> | <a href="#ResetImagePage">ResetImagePage</a> | <a href="#SeparateImageChannel">SeparateImageChannel</a> | <a href="#SeparateImages">SeparateImages</a> | <a href="#SetImageAlphaChannel">SetImageAlphaChannel</a> | <a href="#SetImageBackgroundColor">SetImageBackgroundColor</a> | <a href="#SetImageStorageClass">SetImageStorageClass</a> | <a href="#SetImageClipMask">SetImageClipMask</a> | <a href="#SetImageExtent">SetImageExtent</a> | <a href="#SetImageInfoBlob">SetImageInfoBlob</a> | <a href="#SetImageInfoFile">SetImageInfoFile</a> | <a href="#SetImageMask">SetImageMask</a> | <a href="#SetImageOpacity">SetImageOpacity</a> | <a href="#SetImageType">SetImageType</a> | <a href="#SetImageVirtualPixelMethod">SetImageVirtualPixelMethod</a> | <a href="#StripImage">StripImage</a> | <a href="#TextureImage">TextureImage</a> ]</p>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="AcquireImageInfo">AcquireImageInfo</a></h2>
</div>
<p>AcquireImageInfo() allocates the ImageInfo structure.</p></ol>
<p>The format of the AcquireImageInfo method is:</p>
<pre class="code">
ImageInfo *AcquireImageInfo(void)
</pre>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="AllocateImage">AllocateImage</a></h2>
</div>
<p>AllocateImage() returns a pointer to an image structure initialized to default values.</p></ol>
<p>The format of the AllocateImage method is:</p>
<pre class="code">
Image *AllocateImage(const ImageInfo *image_info)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>Many of the image default values are set from this structure. For example, filename, compression, depth, background color, and others.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="AllocateImageColormap">AllocateImageColormap</a></h2>
</div>
<p>AllocateImageColormap() allocates an image colormap and initializes it to a linear gray colorspace. If the image already has a colormap, it is replaced. AllocateImageColormap() returns MagickTrue if successful, otherwise MagickFalse if there is not enough memory.</p></ol>
<p>The format of the AllocateImageColormap method is:</p>
<pre class="code">
MagickBooleanType AllocateImageColormap(Image *image,
const unsigned long colors)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>colors</h5>
<ol><p>the number of colors in the image colormap.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="AllocateNextImage">AllocateNextImage</a></h2>
</div>
<p>AllocateNextImage() initializes the next image in a sequence to default values. The next member of image points to the newly allocated image. If there is a memory shortage, next is assigned NULL.</p></ol>
<p>The format of the AllocateNextImage method is:</p>
<pre class="code">
void AllocateNextImage(const ImageInfo *image_info,Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>Many of the image default values are set from this structure. For example, filename, compression, depth, background color, and others.</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="AppendImages">AppendImages</a></h2>
</div>
<p>AppendImages() takes all images from the current image pointer to the end of the image list and and appends them to each other top-to-bottom if the stack parameter is true, otherwise left-to-right.</p></ol>
<p>The format of the AppendImage method is:</p>
<pre class="code">
Image *AppendImages(const Image *image,const MagickBooleanType stack,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image sequence.</p></ol>
<h5>stack</h5>
<ol><p>A value other than 0 stacks the images top-to-bottom.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="AverageImages">AverageImages</a></h2>
</div>
<p>AverageImages() takes a set of images and averages them together. Each image in the set must have the same width and height. AverageImages() returns a single image with each corresponding pixel component of each image averaged. On failure, a NULL image is returned and exception describes the reason for the failure.</p></ol>
<p>The format of the AverageImages method is:</p>
<pre class="code">
Image *AverageImages(Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image sequence.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="CatchImageException">CatchImageException</a></h2>
</div>
<p>CatchImageException() returns if no exceptions are found in the image sequence, otherwise it determines the most severe exception and reports it as a warning or error depending on the severity.</p></ol>
<p>The format of the CatchImageException method is:</p>
<pre class="code">
ExceptionType CatchImageException(Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>An image sequence.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="ClipImagePath">ClipImagePath</a></h2>
</div>
<p>ClipImagePath() sets the image clip mask based any clipping path information if it exists.</p></ol>
<p>The format of the ClipImagePath method is:</p>
<pre class="code">
MagickBooleanType ClipImagePath(Image *image,const char *pathname,
const MagickBooleanType inside)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>pathname</h5>
<ol><p>name of clipping path resource. If name is preceded by #, use clipping path numbered by name.</p></ol>
<h5>inside</h5>
<ol><p>if non-zero, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="CloneImage">CloneImage</a></h2>
</div>
<p>CloneImage() copies an image and returns the copy as a new image object. If the specified columns and rows is 0, an exact copy of the image is returned, otherwise the pixel data is undefined and must be initialized with the SetImagePixels() and SyncImagePixels() methods. On failure, a NULL image is returned and exception describes the reason for the failure.</p></ol>
<p>The format of the CloneImage method is:</p>
<pre class="code">
Image *CloneImage(const Image *image,const unsigned long columns,
const unsigned long rows,const MagickBooleanType orphan,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>columns</h5>
<ol><p>the number of columns in the cloned image.</p></ol>
<h5>rows</h5>
<ol><p>the number of rows in the cloned image.</p></ol>
<h5>orphan</h5>
<ol><p>With a value other than 0, the cloned image is an orphan. An orphan is a stand-alone image that is not assocated with an image list. In effect, the next and previous members of the cloned image is set to NULL.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="CloneImageInfo">CloneImageInfo</a></h2>
</div>
<p>CloneImageInfo() makes a copy of the given image info structure. If NULL is specified, a new image info structure is created initialized to default values.</p></ol>
<p>The format of the CloneImageInfo method is:</p>
<pre class="code">
ImageInfo *CloneImageInfo(const ImageInfo *image_info)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>the image info.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="CombineImages">CombineImages</a></h2>
</div>
<p>CombineImages() combines one or more images into a single image. The grayscale value of the pixels of each image in the sequence is assigned in order to the specified channels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc.</p></ol>
<p>The format of the CombineImages method is:</p>
<pre class="code">
Image *CombineImages(const Image *image,const ChannelType channel,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="CycleColormap">CycleColormap</a></h2>
</div>
<p>CycleColormap() 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.</p></ol>
<p>The format of the CycleColormapImage method is:</p>
<pre class="code">
MagickBooleanType CycleColormapImage(Image *image,const long displace)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>displace</h5>
<ol><p>displace the colormap this amount.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="DestroyImage">DestroyImage</a></h2>
</div>
<p>DestroyImage() dereferences an image, deallocating memory associated with the image if the reference count becomes zero.</p></ol>
<p>The format of the DestroyImage method is:</p>
<pre class="code">
Image *DestroyImage(Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="DestroyImageInfo">DestroyImageInfo</a></h2>
</div>
<p>DestroyImageInfo() deallocates memory associated with an ImageInfo structure.</p></ol>
<p>The format of the DestroyImageInfo method is:</p>
<pre class="code">
ImageInfo *DestroyImageInfo(ImageInfo *image_info)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>the image info.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="GetImageClipMask">GetImageClipMask</a></h2>
</div>
<p>GetImageClipMask() returns the clip path associated with the image.</p></ol>
<p>The format of the GetImageClipMask method is:</p>
<pre class="code">
Image *GetImageClipMask(const Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="GetImageException">GetImageException</a></h2>
</div>
<p>GetImageException() traverses an image sequence and returns any error more severe than noted by the exception parameter.</p></ol>
<p>The format of the GetImageException method is:</p>
<pre class="code">
void GetImageException(Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>Specifies a pointer to a list of one or more images.</p></ol>
<h5>exception</h5>
<ol><p>return the highest severity exception.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="GetImageInfo">GetImageInfo</a></h2>
</div>
<p>GetImageInfo() initializes image_info to default values.</p></ol>
<p>The format of the GetImageInfo method is:</p>
<pre class="code">
void GetImageInfo(ImageInfo *image_info)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>the image info.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="GetImageMask">GetImageMask</a></h2>
</div>
<p>GetImageMask() returns the mask associated with the image.</p></ol>
<p>The format of the GetImageMask method is:</p>
<pre class="code">
Image *GetImageMask(const Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="GetImageType">GetImageType</a></h2>
</div>
<p>GetImageType() returns the potential type of image:</p></ol>
<p>Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte</p></ol>
<p>To ensure the image type matches its potential, use SetImageType():</p>
<pre class="text">
(void) SetImageType(image,GetImageType(image));
</pre>
<p>The format of the GetImageType method is:</p>
<pre class="code">
ImageType GetImageType(const Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="GetImageVirtualPixelMethod">GetImageVirtualPixelMethod</a></h2>
</div>
<p>GetImageVirtualPixelMethod() gets the "virtual pixels" method for the image. A virtual pixel is any pixel access that is outside the boundaries of the image cache.</p></ol>
<p>The format of the GetImageVirtualPixelMethod() method is:</p>
<pre class="code">
VirtualPixelMethod GetImageVirtualPixelMethod(const Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="InterpretImageFilename">InterpretImageFilename</a></h2>
</div>
<p>InterpretImageFilename() interprets embedded characters in an image filename. Only a single embedded sequence is replaced and the string length is returned.</p></ol>
<p>The format of the InterpretImageFilename method is:</p>
<pre class="code">
long InterpretImageFilename(char *string,const size_t length,
const char *format,int value)
</pre>
<p>A description of each parameter follows.</p></ol>
<h5>string</h5>
<ol><p>InterpretImageFilename() returns the formatted string in this character buffer.</p></ol>
<h5>length</h5>
<ol><p>the maximum length of the string.</p></ol>
<h5> format</h5>
<ol><p>A string describing the format to use to write the numeric argument. Only the first numeric format identifier is replaced.</p></ol>
<h5> value</h5>
<ol><p>Numeric value to substitute into format string.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="IsHighDynamicRangeImage">IsHighDynamicRangeImage</a></h2>
</div>
<p>IsHighDynamicRangeImage() returns MagickFalse if any pixel component is non-integer or exceeds the bounds of the quantum depth (e.g. for Q16 0..65535.</p></ol>
<p>The format of the IsHighDynamicRangeImage method is:</p>
<pre class="code">
MagickBooleanType IsHighDynamicRangeImage(const Image *image,
ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="IsImageObject">IsImageObject</a></h2>
</div>
<p>IsImageObject() returns MagickTrue if the image sequence contains a valid set of image objects.</p></ol>
<p>The format of the IsImageObject method is:</p>
<pre class="code">
MagickBooleanType IsImageObject(const Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="IsTaintImage">IsTaintImage</a></h2>
</div>
<p>IsTaintImage() returns MagickTrue any pixel in the image has been altered since it was first constituted.</p></ol>
<p>The format of the IsTaintImage method is:</p>
<pre class="code">
MagickBooleanType IsTaintImage(const Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="ModifyImage">ModifyImage</a></h2>
</div>
<p>ModifyImage() ensures that there is only a single reference to the image to be modified, updating the provided image pointer to point to a clone of the original image if necessary.</p></ol>
<p>The format of the ModifyImage method is:</p>
<pre class="code">
MagickBooleanType ModifyImage(Image *image,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="NewMagickImage">NewMagickImage</a></h2>
</div>
<p>NewMagickImage() creates a blank image canvas of the specified size and background color.</p></ol>
<p>The format of the NewMagickImage method is:</p>
<pre class="code">
Image *NewMagickImage(const ImageInfo *image_info,
const unsigned long width,const unsigned long height,
const MagickPixelPacket *background)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>width</h5>
<ol><p>the image width.</p></ol>
<h5>height</h5>
<ol><p>the image height.</p></ol>
<h5>background</h5>
<ol><p>the image color.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="PlasmaImage">PlasmaImage</a></h2>
</div>
<p>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></ol>
<p>The format of the PlasmaImage method is:</p>
<pre class="code">
MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
unsigned long attenuate,unsigned long depth)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>segment</h5>
<ol><p> Define the region to apply plasma fractals values.</p></ol>
<h5>attenuate</h5>
<ol><p>Define the plasma attenuation factor.</p></ol>
<h5>depth</h5>
<ol><p>Limit the plasma recursion depth.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="ReferenceImage">ReferenceImage</a></h2>
</div>
<p>ReferenceImage() increments the reference count associated with an image returning a pointer to the image.</p></ol>
<p>The format of the ReferenceImage method is:</p>
<pre class="code">
Image *ReferenceImage(Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="ResetImagePage">ResetImagePage</a></h2>
</div>
<p>ResetImagePage() resets the image page canvas and position.</p></ol>
<p>The format of the ResetImagePage method is:</p>
<pre class="code">
MagickBooleanType ResetImagePage(Image *image,const char *page)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>page</h5>
<ol><p>the relative page specification.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SeparateImageChannel">SeparateImageChannel</a></h2>
</div>
<p>SeparateImageChannel() separates a channel from the image and returns it as a grayscale image. A channel is a particular color component of each pixel in the image.</p></ol>
<p>The format of the SeparateImageChannel method is:</p>
<pre class="code">
MagickBooleanType SeparateImageChannel(Image *image,
const ChannelType channel)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>channel</h5>
<ol><p>Identify which channel to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, or BlackChannel.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SeparateImages">SeparateImages</a></h2>
</div>
<p>SeparateImages() returns a separate grayscale image for each channel specified.</p></ol>
<p>The format of the SeparateImages method is:</p>
<pre class="code">
MagickBooleanType SeparateImages(const Image *image,
const ChannelType channel,ExceptionInfo *exception)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>channel</h5>
<ol><p>Identify which channels to extract: RedChannel, GreenChannel, BlueChannel, OpacityChannel, CyanChannel, MagentaChannel, YellowChannel, or BlackChannel.</p></ol>
<h5>exception</h5>
<ol><p>Return any errors or warnings in this structure.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageAlphaChannel">SetImageAlphaChannel</a></h2>
</div>
<p>SetImageAlphaChannel() activates, deactivates, resets, or sets the alpha channel.</p></ol>
<p>The format of the SetImageAlphaChannel method is:</p>
<pre class="code">
MagickBooleanType SetImageAlphaChannel(Image *image,
const AlphaChannelType alpha_type)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>alpha_type</h5>
<ol><p>The alpha channel type: ActivateAlphaChannel, DeactivateAlphaChannel, ResetAlphaChannel, or SetAlphaChannel.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageBackgroundColor">SetImageBackgroundColor</a></h2>
</div>
<p>SetImageBackgroundColor() initializes the image pixels to the image background color. The background color is defined by the background_color member of the image structure.</p></ol>
<p>The format of the SetImage method is:</p>
<pre class="code">
MagickBooleanType SetImageBackgroundColor(Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageStorageClass">SetImageStorageClass</a></h2>
</div>
<p>SetImageStorageClass() sets the image class: DirectClass for true color images or PseudoClass for colormapped images.</p></ol>
<p>The format of the SetImageStorageClass method is:</p>
<pre class="code">
MagickBooleanType SetImageStorageClass(Image *image,
const ClassType storage_class)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>storage_class</h5>
<ol><p>The image class.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageClipMask">SetImageClipMask</a></h2>
</div>
<p>SetImageClipMask() associates a clip path with the image. The clip path must be the same dimensions as the image. Set any pixel component of the clip path to TransparentOpacity to prevent that corresponding image pixel component from being updated when SyncImagePixels() is applied.</p></ol>
<p>The format of the SetImageClipMask method is:</p>
<pre class="code">
MagickBooleanType SetImageClipMask(Image *image,const Image *clip_mask)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>clip_mask</h5>
<ol><p>the image clip path.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageExtent">SetImageExtent</a></h2>
</div>
<p>SetImageExtent() sets the image size (i.e. columns & rows).</p></ol>
<p>The format of the SetImageExtent method is:</p>
<pre class="code">
MagickBooleanType SetImageExtent(Image *image,
const unsigned long columns,const unsigned long rows)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>columns</h5>
<ol><p>The image width in pixels.</p></ol>
<h5>rows</h5>
<ol><p>The image height in pixels.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageInfoBlob">SetImageInfoBlob</a></h2>
</div>
<p>SetImageInfoBlob() sets the image info blob member.</p></ol>
<p>The format of the SetImageInfoBlob method is:</p>
<pre class="code">
void SetImageInfoBlob(ImageInfo *image_info,const void *blob,
const size_t length)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>the image info.</p></ol>
<h5>blob</h5>
<ol><p>the blob.</p></ol>
<h5>length</h5>
<ol><p>the blob length.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageInfoFile">SetImageInfoFile</a></h2>
</div>
<p>SetImageInfoFile() sets the image info file member.</p></ol>
<p>The format of the SetImageInfoFile method is:</p>
<pre class="code">
void SetImageInfoFile(ImageInfo *image_info,FILE *file)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image_info</h5>
<ol><p>the image info.</p></ol>
<h5>file</h5>
<ol><p>the file.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageMask">SetImageMask</a></h2>
</div>
<p>SetImageMask() associates a mask with the image. The mask must be the same dimensions as the image.</p></ol>
<p>The format of the SetImageMask method is:</p>
<pre class="code">
MagickBooleanType SetImageMask(Image *image,const Image *mask)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>mask</h5>
<ol><p>the image mask.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageOpacity">SetImageOpacity</a></h2>
</div>
<p>SetImageOpacity() sets the opacity levels of the image.</p></ol>
<p>The format of the SetImageOpacity method is:</p>
<pre class="code">
MagickBooleanType SetImageOpacity(Image *image,const Quantum opacity)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>opacity</h5>
<ol><p>the level of transparency: 0 is fully opaque and QuantumRange is fully transparent.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageType">SetImageType</a></h2>
</div>
<p>SetImageType() sets the type of image. Choose from these types:</p></ol>
<p>Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte OptimizeType</p></ol>
<p>The format of the SetImageType method is:</p>
<pre class="code">
MagickBooleanType SetImageType(Image *image,const ImageType image_type)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>image_type</h5>
<ol><p>Image type.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="SetImageVirtualPixelMethod">SetImageVirtualPixelMethod</a></h2>
</div>
<p>SetImageVirtualPixelMethod() sets the "virtual pixels" method for the image and returns the previous setting. A virtual pixel is any pixel access that is outside the boundaries of the image cache.</p></ol>
<p>The format of the SetImageVirtualPixelMethod() method is:</p>
<pre class="code">
VirtualPixelMethod SetImageVirtualPixelMethod(const Image *image,
const VirtualPixelMethod virtual_pixel_method)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>virtual_pixel_method</h5>
<ol><p>choose the type of virtual pixel.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="StripImage">StripImage</a></h2>
</div>
<p>StripImage() strips an image of all profiles and comments.</p></ol>
<p>The format of the StripImage method is:</p>
<pre class="code">
MagickBooleanType StripImage(Image *image)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<div style="margin: auto;">
<h2><a href="http://magick.imagemagick.org/viewvc/bin/cgi/viewvc.cgi/svn/ImageMagick/trunk/magick/image.c
?view=markup" target="source" name="TextureImage">TextureImage</a></h2>
</div>
<p>TextureImage() repeatedly tiles the texture image across and down the image canvas.</p></ol>
<p>The format of the TextureImage method is:</p>
<pre class="code">
MagickBooleanType TextureImage(Image *image,const Image *texture)
</pre>
<p>A description of each parameter follows:</p></ol>
<h5>image</h5>
<ol><p>the image.</p></ol>
<h5>texture</h5>
<ol><p>This image is the texture to layer on the background.</p></ol>
</td>
<td id="margin" width="1%" height="100%" valign="top" align="right"> </td>
</tr>
</tbody>
</table>
<div id="linkbar">
<a href="http://www.imagemagick.org/discourse-server/" target="157066138">Discourse Server</a> •
<a href="../../www/mailing-list.html">Mailing Lists</a> •
<a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi" target="1199422853">ImageMagick Studio</a>
</div>
<div id="footer">
<span id="footer-west">© 1999-2008 ImageMagick Studio LLC</span>
</div>
<div style="clear: both; margin: 0; width: 100%; "></div>
</body>
</html>
