1 2 3 4 5<!DOCTYPE html> 6<html lang="en"> 7<head> 8 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> 9 <title>ImageMagick: Magick++, C++ API for ImageMagick: Image Class</title> 10 <meta http-equiv="content-type" content="text/html; charset=utf-8"/> 11 <meta name="application-name" content="ImageMagick"/> 12 <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/> 13 <meta name="application-url" content="http://www.imagemagick.org"/> 14 <meta name="generator" content="PHP"/> 15 <meta name="keywords" content="magick++, c++, api, for, imagemagick:, image, class, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/> 16 <meta name="rating" content="GENERAL"/> 17 <meta name="robots" content="INDEX, FOLLOW"/> 18 <meta name="generator" content="ImageMagick Studio LLC"/> 19 <meta name="author" content="ImageMagick Studio LLC"/> 20 <meta name="revisit-after" content="2 DAYS"/> 21 <meta name="resource-type" content="document"/> 22 <meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC"/> 23 <meta name="distribution" content="Global"/> 24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/> 25 <link rel="icon" href="/image/wand.png"/> 26 <link rel="shortcut icon" href="/image/wand.ico"/> 27 <link rel="stylesheet" href="/css/magick.php"/> 28</head> 29<body> 30<div class="main"> 31<div class="magick-masthead"> 32 <div class="container"> 33 <script async="async" src="http://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle" 34 style="display:block" 35 data-ad-client="ca-pub-3129977114552745" 36 data-ad-slot="6345125851" 37 data-ad-format="auto"></ins> 38 <script> 39 (adsbygoogle = window.adsbygoogle || []).push({}); 40 </script> 41 <nav class="magick-nav"> 42 <a class="magick-nav-item " href="/index.php">Home</a> 43 <a class="magick-nav-item " href="/script/binary-releases.php">Download</a> 44 <a class="magick-nav-item " href="/script/command-line-tools.php">Tools</a> 45 <a class="magick-nav-item " href="/script/command-line-processing.php">Command-line</a> 46 <a class="magick-nav-item " href="/script/resources.php">Resources</a> 47 <a class="magick-nav-item " href="/script/api.php">Develop</a> 48 <a class="magick-nav-item " href="/script/search.php">Search</a> 49 <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a> 50 </nav> 51 </div> 52</div> 53<div class="container"> 54<h1> Magick::Image Class</h1> 55<p class="navigation-index">[<a href="Image.php#BLOBs">BLOBs</a> • <a href="Image.php#Constructors">Constructors</a> • <a href="Image.php#Image%20Manipulation%20Methods">Image Manipulation Methods</a> • <a href="Image.php#Image%20Attributes">Image Attributes</a> • <a href="Image.php#Raw%20Image%20Pixel%20Access">Low-Level Image Pixel Access</a>]</p> 56<div class="doc-section"> 57<p>Image is the primary object in Magick++ and represents 58a single image frame (see <a href="http://www.imagemagick.org/Magick++/ImageDesign.html">design</a> ). The 59<a href="http://www.imagemagick.org/Magick++/STL.html">STL interface</a> <b>must</b> be used to operate on 60image sequences or images (e.g. of format GIF, TIFF, MIFF, Postscript, 61& MNG) which are comprised of multiple image frames. Individual 62frames of a multi-frame image may be requested by adding array-style 63notation to the end of the file name (e.g. "animation.gif[3]" retrieves 64the fourth frame of a GIF animation. Various image manipulation 65operations may be applied to the image. Attributes may be set on the 66image to influence the operation of the manipulation operations. The <a 67 href="http://www.imagemagick.org/Magick++/Pixels.html"> Pixels</a> class provides low-level access to 68image 69pixels. As a convenience, including <tt><font color="#663366"><Magick++.h></font></tt> 70is sufficient in order to use the complete Magick++ API. The Magick++ 71API is enclosed within the <i>Magick</i> namespace so you must either 72add the prefix "<tt> Magick::</tt> " to each class/enumeration name or 73add 74the statement "<tt> using namespace Magick;</tt>" after including the <tt>Magick++.h</tt> 75header.</p> 76<p>The preferred way to allocate Image objects is via automatic 77allocation (on the stack). There is no concern that allocating Image 78objects on the stack will excessively enlarge the stack since Magick++ 79allocates all large data objects (such as the actual image data) from 80the heap. Use of automatic allocation is preferred over explicit 81allocation (via <i>new</i>) since it is much less error prone and 82allows use of C++ scoping rules to avoid memory leaks. Use of automatic 83allocation allows Magick++ objects to be assigned and copied just like 84the C++ intrinsic data types (e.g. '<i>int</i> '), leading to clear and 85easy to read code. Use of automatic allocation leads to naturally 86exception-safe code since if an exception is thrown, the object is 87automagically deallocated once the stack unwinds past the scope of the 88allocation (not the case for objects allocated via <i>new</i> ). </p> 89<p>Image is very easy to use. For example, here is a the source to a 90program which reads an image, crops it, and writes it to a new file 91(the 92exception handling is optional but strongly recommended): </p> 93<pre class="code"> 94#include <Magick++.h> 95#include <iostream> 96using namespace std; 97using namespace Magick; 98int main(int argc,char **argv) 99{ 100 InitializeMagick(*argv); 101 102 // Construct the image object. Separating image construction from the 103 // the read operation ensures that a failure to read the image file 104 // doesn't render the image object useless. 105 Image image; 106 try { 107 // Read a file into image object 108 image.read( "girl.gif" ); 109 110 // Crop the image to specified size (width, height, xOffset, yOffset) 111 image.crop( Geometry(100,100, 100, 100) ); 112 113 // Write the image to a file 114 image.write( "x.gif" ); 115 } 116 catch( Exception &error_ ) 117 { 118 cout << "Caught exception: " << error_.what() << endl; 119 return 1; 120 } 121 return 0; 122} 123</pre> 124The following is the source to a program which illustrates the use of 125Magick++'s efficient reference-counted assignment and copy-constructor 126operations which minimize use of memory and eliminate unnecessary copy 127operations (allowing Image objects to be efficiently assigned, and 128copied into containers). The program accomplishes the 129following: 130<ol> 131 <li> Read master image.</li> 132 <li> Assign master image to second image.</li> 133 <li> Resize second image to the size 640x480.</li> 134 <li> Assign master image to a third image.</li> 135 <li> Resize third image to the size 800x600.</li> 136 <li> Write the second image to a file.</li> 137 <li> Write the third image to a file.</li> 138</ol> 139<pre class="code"> 140#include <Magick++.h> 141#include <iostream> 142using namespace std; 143using namespace Magick; 144int main(int argc,char **argv) 145{ 146 InitializeMagick(*argv); 147 148 Image master("horse.jpg"); 149 Image second = master; 150 second.resize("640x480"); 151 Image third = master; 152 third.resize("800x600"); 153 second.write("horse640x480.jpg"); 154 third.write("horse800x600.jpg"); 155 return 0; 156} 157</pre> 158During the entire operation, a maximum of three images exist in memory 159and the image data is never copied. 160<p>The following is the source for another simple program which creates 161a 100 by 100 pixel white image with a red pixel in the center and 162writes it to a file: </p> 163<pre class="code"> 164#include <Magick++.h> 165using namespace std; 166using namespace Magick; 167int main(int argc,char **argv) 168{ 169 InitializeMagick(*argv); 170 Image image( "100x100", "white" ); 171 image.pixelColor( 49, 49, "red" ); 172 image.write( "red_pixel.png" ); 173 return 0; 174} 175</pre> 176If you wanted to change the color image to grayscale, you could add the 177lines: 178<pre class="code"> 179image.quantizeColorSpace( GRAYColorspace ); 180image.quantizeColors( 256 ); 181image.quantize( ); 182</pre> 183</p> 184<p>or, more simply: </p> 185<pre class="code"> 186 image.type( GrayscaleType ); 187</pre> 188<p>prior to writing the image. </p> 189</div> 190<h2> <a name="BLOBs"></a> BLOBs</h2> 191<div class="doc-section"> 192While encoded images (e.g. JPEG) are most often written-to and 193read-from a disk file, encoded images may also reside in memory. 194Encoded 195images in memory are known as BLOBs (Binary Large OBjects) and may be 196represented using the <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> class. The encoded 197image may be initially placed in memory by reading it directly from a 198file, reading the image from a database, memory-mapped from a disk 199file, or could be written to memory by Magick++. Once the encoded image 200has been placed within a Blob, it may be read into a Magick++ Image via 201a <a href="Image.php#constructor_blob">constructor</a> or <a href="Image.php#read">read()</a> 202. Likewise, a Magick++ image may be written to a Blob via <a 203 href="Image.php#write"> write()</a> . 204<p>An example of using Image to write to a Blob follows: <br> 205 </p> 206<pre class="code"> 207#include <Magick++.h> 208using namespace std; 209using namespace Magick; 210int main(int argc,char **argv) 211{ 212 InitializeMagick(*argv); 213 214 // Read GIF file from disk 215 Image image( "giraffe.gif" ); 216 // Write to BLOB in JPEG format 217 Blob blob; 218 image.magick( "JPEG" ) // Set JPEG output format 219 image.write( &blob ); 220 221 [ Use BLOB data (in JPEG format) here ] 222 223 return 0; 224} 225</pre> 226<p><br> 227likewise, to read an image from a Blob, you could use one of the 228following examples: </p> 229<p>[ <font color="#000000">Entry condition for the following examples 230is that <i>data</i> is pointer to encoded image data and <i>length</i> 231represents the size of the data</font> ] </p> 232<pre class="code"> 233Blob blob( data, length ); 234Image image( blob ); 235</pre> 236or 237<pre class="code"> 238Blob blob( data, length ); 239Image image; 240image.read( blob); 241</pre> 242some images do not contain their size or format so the size and format must be specified in advance: 243<pre class="code"> 244Blob blob( data, length ); 245Image image; 246image.size( "640x480") 247image.magick( "RGBA" ); 248image.read( blob); 249</pre> 250</div> 251<h2> <a name="Constructors"></a> Constructors</h2> 252<div class="doc-section"> 253Image may be constructed in a number of ways. It may be constructed 254from a file, a URL, or an encoded image (e.g. JPEG) contained in an 255in-memory <a href="http://www.imagemagick.org/Magick++/Blob.html"> BLOB</a> . The available Image 256constructors are shown in the following table: <br> 257 <br> 258 259<ul><table bgcolor="#ffffff" border="1" width="100%"> 260 <caption><b>Image Constructors</b></caption> <tbody> 261 <tr> 262 <td> 263 <center><b>Signature</b></center> 264 </td> 265 <td> 266 <center><b>Description</b></center> 267 </td> 268 </tr> 269 <tr> 270 <td><font size="-1">const std::string &imageSpec_</font></td> 271 <td><font size="-1">Construct Image by reading from file or URL 272specified by <i>imageSpec_</i>. Use array notation (e.g. filename[9]) 273to select a specific scene from a multi-frame image.</font></td> 274 </tr> 275 <tr> 276 <td><font size="-1">const Geometry &size_, const <a 277 href="http://www.imagemagick.org/Magick++/Color.html"> Color</a> &color_</font></td> 278 <td><font size="-1">Construct a blank image canvas of specified 279size and color</font></td> 280 </tr> 281 <tr> 282 <td><a name="constructor_blob"></a> <font size="-1">const <a 283 href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> &blob_</font></td> 284 <td rowspan="5"><font size="-1">Construct Image by reading from 285encoded image data contained in an in-memory <a href="http://www.imagemagick.org/Magick++/Blob.html">BLOB</a> 286. Depending on the constructor arguments, the Blob <a href="Image.php#size">size</a> 287, <a href="Image.php#depth">depth</a> , <a href="Image.php#magick">magick</a> (format) 288may 289also be specified. Some image formats require that size be specified. 290The default ImageMagick uses for depth depends on the compiled-in 291Quantum size (8 or 16). If ImageMagick's Quantum size does not 292match that of the image, the depth may need to be specified. 293ImageMagick can usually automagically detect the image's format. 294When a format can't be automagically detected, the format (<a 295 href="Image.php#magick">magick</a> ) must be specified.</font></td> 296 </tr> 297 <tr> 298 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 299&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size_</font></td> 300 </tr> 301 <tr> 302 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 303&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size, 304size_t depth</font></td> 305 </tr> 306 <tr> 307 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 308&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size, 309size_t depth_, const string &magick_</font></td> 310 </tr> 311 <tr> 312 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 313&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size, 314const 315string &magick_</font></td> 316 </tr> 317 <tr> 318 <td><font size="-1">const size_t width_, </font> <br> 319 <font size="-1">const size_t height_,</font> <br> 320 <font size="-1">std::string map_,</font> <br> 321 <font size="-1">const <a href="http://www.imagemagick.org/Magick++/Enumerations.html#StorageType"> 322StorageType</a> type_,</font> <br> 323 <font size="-1">const void *pixels_</font></td> 324 <td><font size="-1">Construct a new Image based on an array of 325image pixels. The pixel data must be in scanline order top-to-bottom. 326The data can be character, short int, integer, float, or double. Float 327and double require the pixels to be normalized [0..1]. The other types 328are [0..MaxRGB]. For example, to create a 640x480 image from 329unsigned red-green-blue character data, use</font> 330 <p><font size="-1"> Image image( 640, 480, "RGB", 3310, pixels );</font> </p> 332 <p><font size="-1">The parameters are as follows:</font> <br> 333 334 <table border="0" width="100%"> 335 <tbody> 336 <tr> 337 <td><font size="-1">width_</font></td> 338 <td><font size="-1">Width in pixels of the image.</font></td> 339 </tr> 340 <tr> 341 <td><font size="-1">height_</font></td> 342 <td><font size="-1">Height in pixels of the image.</font></td> 343 </tr> 344 <tr> 345 <td><font size="-1">map_</font></td> 346 <td><font size="-1">This character string can be any 347combination or order of R = red, G = green, B = blue, A = alpha, C = 348cyan, Y = yellow M = magenta, and K = black. The ordering reflects the 349order of the pixels in the supplied pixel array.</font></td> 350 </tr> 351 <tr> 352 <td><font size="-1">type_</font></td> 353 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#StorageType">Pixel 354storage type</a> (CharPixel, ShortPixel, IntegerPixel, FloatPixel, or 355DoublePixel)</font></td> 356 </tr> 357 <tr> 358 <td><font size="-1">pixels_</font></td> 359 <td><font size="-1">This array of values contain the pixel 360components as defined by the map_ and type_ parameters. The length of 361the arrays must equal the area specified by the width_ and height_ 362values and type_ parameters.</font></td> 363 </tr> 364 </tbody> 365 </table> 366 </p> 367 </td> 368 </tr> 369 </tbody> 370</table></ul> 371</div> 372<h2> <a name="Image Manipulation Methods"></a> Image Manipulation Methods</h2> 373<div class="doc-section"> 374<i>Image</i> supports access to all the single-image (versus 375image-list) manipulation operations provided by the ImageMagick 376library. If you 377must process a multi-image file (such as an animation), the <a 378 href="http://www.imagemagick.org/Magick++/STL.html"> STL interface</a> , which provides a multi-image 379abstraction on top of <i>Image</i>, must be used. 380<p>Image manipulation methods are very easy to use. For example: </p> 381<pre class="code"> 382Image image; 383image.read("myImage.tiff"); 384image.addNoise(GaussianNoise); 385image.write("myImage.tiff"); 386</pre> 387adds gaussian noise to the image file "myImage.tiff". 388<p>The operations supported by Image are shown in the following table: <br> 389 390<ul><table nosave="" border="1"> 391 <caption><b>Image Image Manipulation Methods</b></caption> <tbody> 392 <tr align="center"> 393 <td><b>Method</b></td> 394 <td><b>Signature(s)</b></td> 395 <td><b>Description</b></td> 396 </tr> 397 <tr> 398 <td style="text-align: center;" valign="middle"> 399 <div align="center"><a name="adaptiveThreshold"></a> <font 400 size="-1">adaptiveThreshold<br> 401 </font></div> 402 </td> 403 <td valign="middle"><font size="-1">size_t width, size_t 404height, size_t offset = 0<br> 405 </font></td> 406 <td valign="top"><font size="-1">Apply adaptive thresholding to 407the image. Adaptive thresholding is useful if the ideal threshold level 408is not known in advance, or if the illumination gradient is not 409constant 410across the image. Adaptive thresholding works by evaluating the mean 411(average) of a pixel region (size specified by <i>width</i> and <i>height</i>) 412and using the mean as the thresholding value. In order to remove 413residual noise from the background, the threshold may be adjusted by 414subtracting a constant <i>offset</i> (default zero) from the mean to 415compute the threshold.</font><br> 416 </td> 417 </tr> 418 <tr> 419 <td style="text-align: center;"> 420 <center><a name="addNoise"></a> <font size="-1">addNoise</font></center> 421 </td> 422 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#NoiseType">NoiseType</a> 423noiseType_</font></td> 424 <td><font size="-1">Add noise to image with specified noise type.</font></td> 425 </tr> 426 <tr> 427 <td style="vertical-align: middle; text-align: center;"><small><a 428 name="addNoiseChannel"></a>addNoiseChannel<br> 429 </small></td> 430 <td style="vertical-align: middle;"><small>const ChannelType 431channel_, const NoiseType noiseType_<br> 432 </small></td> 433 <td style="vertical-align: middle;"><small>Add noise to an image 434channel with the specified noise type.</small><font size="-1"> The <span 435 style="font-style: italic;">channel_</span> parameter specifies the 436channel to add noise to. The </font><small>noiseType_ parameter 437specifies the type of noise.<br> 438 </small></td> 439 </tr> 440 <tr> 441 <td style="vertical-align: middle; text-align: center;"><small><a 442 name="affineTransform"></a>affineTransform<br> 443 </small></td> 444 <td style="vertical-align: middle;"><small>const DrawableAffine 445&affine<br> 446 </small></td> 447 <td style="vertical-align: middle;"><small>Transform image by 448specified affine (or free transform) matrix.<br> 449 </small></td> 450 </tr> 451 <tr> 452 <td style="text-align: center;" rowspan="4"> 453 <center><a name="annotate"></a> <font size="-1">annotate</font></center> 454 </td> 455 <td><font size="-1">const std::string &text_, const <a 456 href="http://www.imagemagick.org/Magick++/Geometry.html"> Geometry</a> &location_</font></td> 457 <td><font size="-1">Annotate using specified text, and placement 458location</font></td> 459 </tr> 460 <tr> 461 <td><font size="-1">string text_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 462&boundingArea_, <a href="http://www.imagemagick.org/Magick++/Enumerations.html#GravityType">GravityType</a> 463gravity_</font></td> 464 <td><font size="-1">Annotate using specified text, bounding area, 465and placement gravity. If <i>boundingArea_</i> is invalid, then 466bounding area is entire image.</font></td> 467 </tr> 468 <tr> 469 <td><font size="-1">const std::string &text_, const <a 470 href="http://www.imagemagick.org/Magick++/Geometry.html"> Geometry</a> &boundingArea_, <a 471 href="http://www.imagemagick.org/Magick++/Enumerations.html#GravityType">GravityType</a> gravity_, double 472degrees_, </font></td> 473 <td><font size="-1">Annotate with text using specified text, 474bounding area, placement gravity, and rotation. If <i>boundingArea_</i> 475is invalid, then bounding area is entire image.</font></td> 476 </tr> 477 <tr> 478 <td><font size="-1">const std::string &text_, <a 479 href="http://www.imagemagick.org/Magick++/Enumerations.html#GravityType"> GravityType</a> gravity_</font></td> 480 <td><font size="-1">Annotate with text (bounding area is entire 481image) and placement gravity.</font></td> 482 </tr> 483 <tr> 484 <td style="text-align: center;"> 485 <center><a name="blur"></a> <font size="-1">blur</font></center> 486 </td> 487 <td><font size="-1">const double radius_ = 1, const double sigma_ 488= 0.5</font></td> 489 <td><font size="-1">Blur image. The <i>radius_ </i>parameter 490specifies the radius of the Gaussian, in pixels, not counting the 491center 492pixel. The <i>sigma_</i> parameter specifies the standard 493deviation of the Laplacian, in pixels.</font></td> 494 </tr> 495 <tr> 496 <td style="vertical-align: middle; text-align: center;"><small><a 497 name="blurChannel"></a>blurChannel<br> 498 </small></td> 499 <td style="vertical-align: middle;"><small>const ChannelType 500channel_, const double radius_ = 0.0, const double sigma_ = 1.0<br> 501 </small></td> 502 <td style="vertical-align: middle;"><font size="-1">Blur an image 503channel. The <span style="font-style: italic;">channel_</span> 504parameter specifies the channel to blur. The <i>radius_ </i>parameter 505specifies the radius of the Gaussian, in pixels, not counting the 506center 507pixel. The <i>sigma_</i> parameter specifies the standard 508deviation of the Laplacian, in pixels.</font></td> 509 </tr> 510 <tr> 511 <td style="text-align: center;"> 512 <center><a name="border"></a> <font size="-1">border</font></center> 513 </td> 514 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 515&geometry_ = "6x6+0+0"</font></td> 516 <td><font size="-1">Border image (add border to image). The 517color of the border is specified by the <i>borderColor</i> attribute.</font></td> 518 </tr> 519 <tr> 520 <td style="text-align: center;"> 521 <center><a name="cdl"></a> <font size="-1">cdl</font></center> 522 </td> 523 <td><font size="-1">const std::string &cdl_</font></td> 524 <td><font size="-1">color correct with a color decision list. See <a href="http://en.wikipedia.org/wiki/ASC_CDL">http://en.wikipedia.org/wiki/ASC_CDL</a> for details.</font></td> 525 </tr> 526 <tr> 527 <td style="text-align: center;"> 528 <center><a name="channel"></a> <font size="-1">channel</font></center> 529 </td> 530 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ChannelType">ChannelType</a> 531layer_</font></td> 532 <td><font size="-1">Extract channel from image. Use this option 533to extract a particular channel from the image. <i>MatteChannel</i> 534 for example, is useful for extracting the opacity values 535from an image.</font></td> 536 </tr> 537 <tr> 538 <td style="text-align: center;"> 539 <center><a name="charcoal"></a> <font size="-1">charcoal</font></center> 540 </td> 541 <td><font size="-1">const double radius_ = 1, const double sigma_ 542= 0.5</font></td> 543 <td><font size="-1">Charcoal effect image (looks like charcoal 544sketch). The <i>radius_</i> parameter specifies the radius of the 545Gaussian, in pixels, not counting the center pixel. The <i>sigma_</i> 546parameter specifies the standard deviation of the Laplacian, in pixels.</font></td> 547 </tr> 548 <tr> 549 <td style="text-align: center;"> 550 <center><a name="chop"></a> <font size="-1">chop</font></center> 551 </td> 552 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 553&geometry_</font></td> 554 <td><font size="-1">Chop image (remove vertical or horizontal 555subregion of image)</font></td> 556 </tr> 557 <tr> 558 <td style="text-align: center;"> 559 <center><a name="colorize"></a> <font size="-1">colorize</font></center> 560 </td> 561 <td><font size="-1">const unsigned int opacityRed_, const 562unsigned int opacityGreen_, const unsigned int opacityBlue_, const 563Color &penColor_</font></td> 564 <td><font size="-1">Colorize image with pen color, using 565specified percent opacity for red, green, and blue quantums.</font></td> 566 </tr> 567 <tr> 568 <td style="text-align: center;"> 569 <center><a name="colorMatrix"></a> <font size="-1">colorMatrix</font></center> 570 </td> 571 <td><font size="-1">const size_t order_, const double *color_matrix_</font></td> 572 <td><font size="-1">apply color correction to the image.</font></td> 573 </tr> 574 <tr> 575 <td style="text-align: center;"> 576 <center><a name="comment"></a> <font size="-1">comment</font></center> 577 </td> 578 <td><font size="-1">const std::string &comment_</font></td> 579 <td><font size="-1">Comment image (add comment string to 580image). By default, each image is commented with its file name. 581Use this method to assign a specific comment to the 582image. Optionally you can include the image filename, type, 583width, height, or other image attributes by embedding <a 584 href="http://www.imagemagick.org/Magick++/FormatCharacters.html">special format characters.</a> </font></td> 585 </tr> 586 <tr> 587 <td style="text-align: center;" valign="middle"><font size="-1"><a 588 name="compare"></a> compare<br> 589 </font></td> 590 <td valign="middle"><font size="-1">const Image &reference_<br> 591 </font></td> 592 <td valign="top"><font size="-1">Compare current image with 593another image. Sets <a href="Image.php#meanErrorPerPixel">meanErrorPerPixel</a> 594, <a href="Image.php#normalizedMaxError">normalizedMaxError</a> , and <a 595 href="Image.php#normalizedMeanError">normalizedMeanError</a> in the current 596image. False is returned if the images are identical. An ErrorOption 597exception is thrown if the reference image columns, rows, colorspace, 598or 599matte differ from the current image.</font><br> 600 </td> 601 </tr> 602 <tr> 603 <td style="text-align: center;" rowspan="3"> 604 <center><a name="composite"></a> <font size="-1">composite</font></center> 605 </td> 606 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Image.html">Image</a> 607&compositeImage_, ssize_t xOffset_, ssize_t yOffset_, <a 608 href="http://www.imagemagick.org/Magick++/Enumerations.html#CompositeOperator"> CompositeOperator</a> 609compose_ = <i>InCompositeOp</i></font></td> 610 <td><font size="-1">Compose an image onto the current image at 611offset specified by <i>xOffset_</i>, <i>yOffset_ </i>using the 612composition algorithm specified by <i>compose_</i>. </font></td> 613 </tr> 614 <tr> 615 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Image.html">Image</a> 616&compositeImage_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 617&offset_, <a href="http://www.imagemagick.org/Magick++/Enumerations.html#CompositeOperator">CompositeOperator</a> 618compose_ = <i>InCompositeOp</i></font></td> 619 <td><font size="-1">Compose an image onto the current image at 620offset specified by <i>offset_</i> using the composition algorithm 621specified by <i>compose_</i> . </font></td> 622 </tr> 623 <tr> 624 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Image.html">Image</a> 625&compositeImage_, <a href="http://www.imagemagick.org/Magick++/Enumerations.html#GravityType">GravityType</a> 626gravity_, <a href="http://www.imagemagick.org/Magick++/Enumerations.html#CompositeOperator">CompositeOperator</a> 627compose_ = <i>InCompositeOp</i></font></td> 628 <td><font size="-1">Compose an image onto the current image with 629placement specified by <i>gravity_ </i>using the composition 630algorithm 631specified by <i>compose_</i>. </font></td> 632 </tr> 633 <tr> 634 <td style="text-align: center;"> 635 <center><a name="contrast"></a> <font size="-1">contrast</font></center> 636 </td> 637 <td><font size="-1">size_t sharpen_</font></td> 638 <td><font size="-1">Contrast image (enhance intensity differences 639in image)</font></td> 640 </tr> 641 <tr> 642 <td style="text-align: center;"> 643 <center><a name="convolve"></a> <font size="-1">convolve</font></center> 644 </td> 645 <td><font size="-1">size_t order_, const double *kernel_</font></td> 646 <td><font size="-1">Convolve image. Applies a user-specified 647convolution to the image. The <i>order_</i> parameter represents the 648number of columns and rows in the filter kernel, and <i>kernel_</i> 649is a two-dimensional array of doubles representing the convolution 650kernel to apply.</font></td> 651 </tr> 652 <tr> 653 <td style="text-align: center;"> 654 <center><a name="crop"></a> <font size="-1">crop</font></center> 655 </td> 656 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 657&geometry_</font></td> 658 <td><font size="-1">Crop image (subregion of original image)</font></td> 659 </tr> 660 <tr> 661 <td style="text-align: center;"> 662 <center><a name="cycleColormap"></a> <font size="-1">cycleColormap</font></center> 663 </td> 664 <td><font size="-1">int amount_</font></td> 665 <td><font size="-1">Cycle image colormap</font></td> 666 </tr> 667 <tr> 668 <td style="text-align: center;"> 669 <center><a name="despeckle"></a> <font size="-1">despeckle</font></center> 670 </td> 671 <td><font size="-1">void</font></td> 672 <td><font size="-1">Despeckle image (reduce speckle noise)</font></td> 673 </tr> 674 <tr> 675 <td style="text-align: center;"> 676 <center><a name="display"></a> <font size="-1">display</font></center> 677 </td> 678 <td><font size="-1">void</font></td> 679 <td><font size="-1">Display image on screen.</font> <br> 680 <font size="-1"><b><font color="#ff0000">Caution: </font></b> if 681an image format is is not compatible with the display visual (e.g. 682JPEG on a colormapped display) then the original image will be 683altered. Use a copy of the original if this is a problem.</font></td> 684 </tr> 685 <tr> 686 <td> 687 <center><a name="distort"></a> <font size="-1">distort</font></center> 688 </td> 689 <td><font size="-1">const DistortImageMethod method, const size_t number_arguments, const double *arguments, const bool bestfit = false </font></td> 690 <td><font size="-1">Distort image. Applies a user-specified 691distortion to the image.</font></td> 692 </tr> 693 <tr> 694 <td style="text-align: center;" rowspan="2"> 695 <center><a name="draw"></a> <font size="-1">draw</font></center> 696 </td> 697 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Drawable.html">Drawable</a> 698&drawable_</font></td> 699 <td><font size="-1">Draw shape or text on image.</font></td> 700 </tr> 701 <tr> 702 <td><font size="-1">const std::list<<a href="http://www.imagemagick.org/Magick++/Drawable.html">Drawable</a> 703> &drawable_</font></td> 704 <td><font size="-1">Draw shapes or text on image using a set of 705Drawable objects contained in an STL list. Use of this method improves 706drawing performance and allows batching draw objects together in a 707list for repeated use.</font></td> 708 </tr> 709 <tr> 710 <td style="text-align: center;"> 711 <center><a name="edge"></a> <font size="-1">edge</font></center> 712 </td> 713 <td><font size="-1">size_t radius_ = 0.0</font></td> 714 <td><font size="-1">Edge image (hilight edges in image). 715The radius is the radius of the pixel neighborhood.. Specify a radius 716of zero for automatic radius selection.</font></td> 717 </tr> 718 <tr> 719 <td style="text-align: center;"> 720 <center><a name="emboss"></a> <font size="-1">emboss</font></center> 721 </td> 722 <td><font size="-1">const double radius_ = 1, const double sigma_ 723= 0.5</font></td> 724 <td><font size="-1">Emboss image (hilight edges with 3D effect). 725The <i> radius_</i> parameter specifies the radius of the Gaussian, in 726pixels, not counting the center pixel. The <i>sigma_</i> 727parameter specifies the standard deviation of the Laplacian, in pixels.</font></td> 728 </tr> 729 <tr> 730 <td style="text-align: center;"> 731 <center><a name="enhance"></a> <font size="-1">enhance</font></center> 732 </td> 733 <td><font size="-1">void</font></td> 734 <td><font size="-1">Enhance image (minimize noise)</font></td> 735 </tr> 736 <tr> 737 <td style="text-align: center;"> 738 <center><a name="equalize"></a> <font size="-1">equalize</font></center> 739 </td> 740 <td><font size="-1">void</font></td> 741 <td><font size="-1">Equalize image (histogram equalization)</font></td> 742 </tr> 743 <tr> 744 <td style="text-align: center;"> 745 <center><a name="erase"></a> <font size="-1">erase</font></center> 746 </td> 747 <td><font size="-1">void</font></td> 748 <td><font size="-1">Set all image pixels to the current 749background color.</font></td> 750 </tr> 751 <tr> 752 <td style="text-align: center;" rowspan="4"> 753 <center><a name="extent"></a> <font size="-1">extent</font></td> 754 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html"> Geometry</a> &geometry_</font></td> 755 <td rowspan="2"><font size="-1">extends the image as defined by the geometry, gravity, and image background color.</font></td> 756 </tr> 757 <tr> 758 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 759&geometry_, const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &backgroundColor_</font></td> 760 </tr> 761 <tr> 762 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html"> Geometry</a> &geometry_, const <a href="http://nextgen.imagemagick.org/api/Enumerations.html#GravityType">GravityType</a> 763&gravity_</font></td> 764 <td rowspan="2"><font size="-1">extends the image as defined by the geometry, gravity, and image background color.</font></td> 765 </tr> 766 <tr> 767 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 768&geometry_, const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &backgroundColor_, 769const <a href="http://www.imagemagick.org/Magick++/Enumerations.html#GravityType">GravityType</a> &gravity_</font></td> 770 </tr> 771 <tr> 772 <td style="text-align: center;"> 773 <center><a name="flip"></a> <font size="-1">flip</font></center> 774 </td> 775 <td><font size="-1">void</font></td> 776 <td><font size="-1">Flip image (reflect each scanline in the 777vertical direction)</font></td> 778 </tr> 779 <tr> 780 <td style="text-align: center;" rowspan="4"> 781 <center><a name="floodFillColor"></a> <font size="-1">floodFill-</font> 782 <br> 783 <font size="-1">Color</font></center> 784 </td> 785 <td><font size="-1">ssize_t x_, ssize_t y_, const <a 786 href="http://www.imagemagick.org/Magick++/Color.html"> Color</a> &fillColor_</font></td> 787 <td rowspan="2"><font size="-1">Flood-fill color across pixels 788that match the color of the target pixel and are neighbors of the 789target pixel. Uses current fuzz setting when determining color match.</font></td> 790 </tr> 791 <tr> 792 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 793&point_, const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &fillColor_</font></td> 794 </tr> 795 <tr> 796 <td><font size="-1">ssize_t x_, ssize_t y_, const <a 797 href="http://www.imagemagick.org/Magick++/Color.html"> Color</a> &fillColor_, const <a 798 href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 799&borderColor_</font></td> 800 <td rowspan="2"><font size="-1">Flood-fill color across pixels 801starting at target-pixel and stopping at pixels matching specified 802border color. Uses current fuzz setting when determining color match.</font></td> 803 </tr> 804 <tr> 805 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 806&point_, const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &fillColor_, 807const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &borderColor_</font></td> 808 </tr> 809 <tr> 810 <td style="text-align: center;"><a name="floodFillOpacity"></a> <font 811 size="-1">floodFillOpacity</font></td> 812 <td><font size="-1">const long x_, const long y_, const unsigned int 813opacity_, const PaintMethod method_</font></td> 814 <td><font size="-1">Floodfill pixels matching color (within fuzz 815factor) of target pixel(x,y) with replacement opacity value using 816method.</font></td> 817 </tr> 818 <tr> 819 <td style="text-align: center;" rowspan="4"> 820 <center><a name="floodFillTexture"></a> <font size="-1">floodFill-</font> 821 <br> 822 <font size="-1">Texture</font></center> 823 </td> 824 <td><font size="-1">ssize_t x_, ssize_t y_, const 825Image &texture_</font></td> 826 <td rowspan="2"><font size="-1">Flood-fill texture across pixels 827that match the color of the target pixel and are neighbors of the 828target pixel. Uses current fuzz setting when determining color match.</font></td> 829 </tr> 830 <tr> 831 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 832&point_, const Image &texture_</font></td> 833 </tr> 834 <tr> 835 <td><font size="-1">ssize_t x_, ssize_t y_, const Image 836&texture_, const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &borderColor_</font></td> 837 <td rowspan="2"><font size="-1">Flood-fill texture across pixels 838starting at target-pixel and stopping at pixels matching specified 839border color. Uses current fuzz setting when determining color match.</font></td> 840 </tr> 841 <tr> 842 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 843&point_, const Image &texture_, const <a href="http://www.imagemagick.org/Magick++/Color.html"> 844Color</a> 845&borderColor_</font></td> 846 </tr> 847 <tr> 848 <td style="text-align: center;"> 849 <center><a name="flop"></a> <font size="-1">flop</font></center> 850 </td> 851 <td><font size="-1">void </font></td> 852 <td><font size="-1">Flop image (reflect each scanline in the 853horizontal direction)</font></td> 854 </tr> 855 <tr> 856 <td style="text-align: center;" rowspan="2"> 857 <center><a name="frame"></a> <font size="-1">frame</font></center> 858 </td> 859 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 860&geometry_ = "25x25+6+6"</font></td> 861 <td rowspan="2"><font size="-1">Add decorative frame around image</font></td> 862 </tr> 863 <tr> 864 <td><font size="-1">size_t width_, size_t height_, 865ssize_t x_, ssize_t y_, ssize_t innerBevel_ = 0, ssize_t outerBevel_ = 0</font></td> 866 </tr> 867 <tr> 868 <td> 869 <center><a name="fx"></a> <font size="-1">fx</font></center> 870 </td> 871 <td><font size="-1">const std::string expression, const Magick::ChannelType channel</font></td> 872 <td><font size="-1">Fx image. Applies a mathematical 873expression to the image.</font></td> 874 </tr> 875 <tr> 876 <td style="text-align: center;" rowspan="2"> 877 <center><a name="gamma"></a> <font size="-1">gamma</font></center> 878 </td> 879 <td><font size="-1">double gamma_</font></td> 880 <td><font size="-1">Gamma correct image (uniform red, green, and 881blue correction).</font></td> 882 </tr> 883 <tr> 884 <td><font size="-1">double gammaRed_, double gammaGreen_, double 885gammaBlue_</font></td> 886 <td><font size="-1">Gamma correct red, green, and blue channels 887of image.</font></td> 888 </tr> 889 <tr> 890 <td style="text-align: center;"> 891 <center><a name="gaussianBlur"></a> <font size="-1">gaussianBlur</font></center> 892 </td> 893 <td><font size="-1">const double width_, const double sigma_</font></td> 894 <td><font size="-1">Gaussian blur image. The number of neighbor 895pixels to be included in the convolution mask is specified by 896'width_'. For example, a width of one gives a (standard) 3x3 897convolution mask. The standard deviation of the gaussian bell curve is 898specified by 'sigma_'.</font></td> 899 </tr> 900 <tr> 901 <td style="vertical-align: middle; text-align: center;"><small><a 902 name="gaussianBlurChannel"></a>gaussianBlurChannel<br> 903 </small></td> 904 <td style="vertical-align: middle;"><small>const ChannelType 905channel_, const double radius_ = 0.0, const double sigma_ = 1.0<br> 906 </small></td> 907 <td style="vertical-align: middle;"><font size="-1">Gaussian blur 908an image channel. </font><font size="-1">The <span 909 style="font-style: italic;">channel_</span> parameter specifies the 910channel to blur. </font><font size="-1">The number of neighbor 911pixels to be included in the convolution mask is specified by 912'width_'. For example, a width of one gives a (standard) 3x3 913convolution mask. The standard deviation of the gaussian bell curve is 914specified by 'sigma_'.</font></td> 915 </tr> 916 <tr> 917 <td style="text-align: center;" valign="middle"><font size="-1"><a 918 name="haldClut"></a> haldClut<br> 919 </font></td> 920 <td valign="middle"><font size="-1">const Image &reference_<br> 921 </font></td> 922 <td valign="top"><font size="-1">apply a Hald color lookup table to the image.</font><br> 923 </td> 924 </tr> 925 <tr> 926 <td style="text-align: center;"> 927 <center><a name="implode"></a> <font size="-1">implode</font></center> 928 </td> 929 <td><font size="-1">const double factor_</font></td> 930 <td><font size="-1">Implode image (special effect)</font></td> 931 </tr> 932 <tr> 933 <td style="text-align: center;"> 934 <center><a name="inverseFourierTransform"></a> <font size="-1">inverseFourierTransform</font></center> 935 </td> 936 <td><font size="-1">const Image &phaseImage_, const bool magnitude_</font></td> 937 <td><font size="-1">implements the inverse discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.</font></td> 938 </tr> 939 <tr> 940 <td style="text-align: center;"> 941 <center><a name="label"></a> <font size="-1">label</font></center> 942 </td> 943 <td><font size="-1">const string &label_</font></td> 944 <td><font size="-1">Assign a label to an image. Use this option 945to assign a specific label to the image. Optionally 946you can include the image filename, type, width, height, or scene 947number in the label by embedding <a href="http://www.imagemagick.org/Magick++/FormatCharacters.html"> 948special format characters.</a> If the first character of string is @, 949the 950image label is read from a file titled by the remaining characters in 951the string. When converting to Postscript, use this option to 952specify a header string to print above the image.</font></td> 953 </tr> 954 <tr> 955 <td style="vertical-align: top; text-align: center;"><small><a 956 name="level"></a>level<br> 957 </small></td> 958 <td style="vertical-align: top;"><small>const double black_point, 959const double white_point, const double mid_point=1.0<br> 960 </small></td> 961 <td style="vertical-align: top;"><small>Level image. Adjust the 962levels of the image by scaling the colors falling between specified 963white and black points to the full available quantum range. The 964parameters provided represent the black, mid (gamma), and white 965points. The black point specifies the darkest color in the image. 966Colors darker than the black point are set to zero. Mid point (gamma) 967specifies a gamma correction to apply to the image. White point 968specifies the lightest color in the image. Colors brighter than 969the white point are set to the maximum quantum value. The black and 970white point have the valid range 0 to MaxRGB while mid (gamma) has a 971useful range of 0 to ten.<br> 972 </small></td> 973 </tr> 974 <tr> 975 <td style="vertical-align: middle; text-align: center;"><small><a 976 name="levelChannel"></a>levelChannel<br> 977 </small></td> 978 <td style="vertical-align: middle;"><small>const ChannelType 979channel, const double black_point, const double white_point, const 980double mid_point=1.0<br> 981 </small></td> 982 <td style="vertical-align: middle;"><small>Level image channel. 983Adjust the levels of the image channel by scaling the values falling 984between specified white and black points to the full available quantum 985range. The parameters provided represent the black, mid (gamma), and 986white points. The black point specifies the darkest color in the image. 987Colors darker than the black point are set to zero. Mid point (gamma) 988specifies a gamma correction to apply to the image. White point 989specifies the lightest color in the image. Colors brighter than the 990white point are set to the maximum quantum value. The black and white 991point have the valid range 0 to MaxRGB while mid (gamma) has a useful 992range of 0 to ten.<br> 993 </small></td> 994 </tr> 995 <tr> 996 <td style="text-align: center;"> 997 <center><a name="magnify"></a> <font size="-1">magnify</font></center> 998 </td> 999 <td><font size="-1">void</font></td> 1000 <td><font size="-1">Magnify image by integral size</font></td> 1001 </tr> 1002 <tr> 1003 <td style="text-align: center;"> 1004 <center><a name="map"></a> <font size="-1">map</font></center> 1005 </td> 1006 <td><font size="-1">const Image &mapImage_ , bool dither_ = 1007false</font></td> 1008 <td><font size="-1">Remap image colors with closest color from 1009reference image. Set dither_ to <i>true</i> in to apply 1010Floyd/Steinberg 1011error diffusion to the image. By default, color reduction chooses an 1012optimal set of colors that best represent the original 1013image. Alternatively, you can choose a 1014particular set of colors from an image file 1015with this option.</font></td> 1016 </tr> 1017 <tr> 1018 <td style="text-align: center;"> 1019 <center><a name="matteFloodfill"></a> <font size="-1">matteFloodfill</font></center> 1020 </td> 1021 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 1022&target_, const unsigned int opacity_, const ssize_t x_, const 1023ssize_t 1024y_, <a href="http://www.imagemagick.org/Magick++/Enumerations.html#PaintMethod">PaintMethod</a> method_</font></td> 1025 <td><font size="-1">Floodfill designated area with a replacement 1026opacity value.</font></td> 1027 </tr> 1028 <tr> 1029 <td style="text-align: center;"><a name="medianFilter"></a> <font 1030 size="-1">medianFilter</font></td> 1031 <td><font size="-1">const double radius_ = 0.0</font></td> 1032 <td><font size="-1">Filter image by replacing each pixel 1033component with the median color in a circular neighborhood</font></td> 1034 </tr> 1035 <tr> 1036 <td style="text-align: center;"> 1037 <center><a name="mergeLayers"></a> <font size="-1">mergeLayers</font></center> 1038 </td> 1039 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#LayerMethod">LayerMethod</a> 1040noiseType_</font></td> 1041 <td><font size="-1">handle multiple images forming a set of image layers or animation frames.</font></td> 1042 </tr> 1043 <tr> 1044 <td style="text-align: center;"> 1045 <center><a name="minify"></a> <font size="-1">minify</font></center> 1046 </td> 1047 <td><font size="-1">void</font></td> 1048 <td><font size="-1">Reduce image by integral size</font></td> 1049 </tr> 1050 <tr> 1051 <td style="text-align: center;"><a name="modifyImage"></a> <font 1052 size="-1">modifyImage</font></td> 1053 <td><font size="-1">void</font></td> 1054 <td><font size="-1">Prepare to update image. Ensures that there 1055is only one reference to the underlying image so that the underlying 1056image may be safely modified without effecting previous generations of 1057the image. Copies the underlying image to a new image if necessary.</font></td> 1058 </tr> 1059 <tr> 1060 <td style="text-align: center;"> 1061 <center><a name="modulate"></a> <font size="-1">modulate</font></center> 1062 </td> 1063 <td><font size="-1">double brightness_, double saturation_, 1064double hue_</font></td> 1065 <td><font size="-1">Modulate percent hue, saturation, and 1066brightness of an image. Modulation of saturation and brightness is as a 1067ratio of the current value (1.0 for no change). Modulation of hue is an 1068absolute rotation of -180 degrees to +180 degrees from the current 1069position corresponding to an argument range of 0 to 2.0 (1.0 for no 1070change).</font></td> 1071 </tr> 1072 <tr> 1073 <td style="vertical-align: middle; text-align: center;"><small><a 1074 name="motionBlur"></a>motionBlur<br> 1075 </small></td> 1076 <td style="vertical-align: middle;"><small>const double radius_, 1077const double sigma_, const double angle_<br> 1078 </small></td> 1079 <td style="vertical-align: middle;"><small>Motion blur image with 1080specified blur factor. The radius_ parameter specifies the radius of 1081the Gaussian, in pixels, not counting the center pixel. The 1082sigma_ parameter specifies the standard deviation of the Laplacian, in 1083pixels. The angle_ parameter specifies the angle the object appears to 1084be coming from (zero degrees is from the right).<br> 1085 </small></td> 1086 </tr> 1087 <tr> 1088 <td style="text-align: center;"> 1089 <center><a name="negate"></a> <font size="-1">negate</font></center> 1090 </td> 1091 <td><font size="-1">bool grayscale_ = false</font></td> 1092 <td><font size="-1">Negate colors in image. Replace every 1093pixel with its complementary color (white becomes black, yellow becomes 1094blue, etc.). Set grayscale to only negate grayscale values in 1095image.</font></td> 1096 </tr> 1097 <tr> 1098 <td style="text-align: center;"> 1099 <center><a name="normalize"></a> <font size="-1">normalize</font></center> 1100 </td> 1101 <td><font size="-1">void</font></td> 1102 <td><font size="-1">Normalize image (increase contrast by 1103normalizing the pixel values to span the full range of color values).</font></td> 1104 </tr> 1105 <tr> 1106 <td style="text-align: center;"> 1107 <center><a name="oilPaint"></a> <font size="-1">oilPaint</font></center> 1108 </td> 1109 <td><font size="-1">size_t radius_ = 3</font></td> 1110 <td><font size="-1">Oilpaint image (image looks like oil painting)</font></td> 1111 </tr> 1112 <tr> 1113 <td style="text-align: center;"> 1114 <center><a name="opacity"></a> <font size="-1">opacity</font></center> 1115 </td> 1116 <td><font size="-1">unsigned int opacity_</font></td> 1117 <td><font size="-1">Set or attenuate the opacity channel in the 1118image. If the image pixels are opaque then they are set to the 1119specified 1120opacity value, otherwise they are blended with the supplied opacity 1121value. The value of opacity_ ranges from 0 (completely opaque) to 1122 <i>MaxRGB</i> 1123. The defines <i>OpaqueOpacity</i> and <i>TransparentOpacity</i> are 1124available to specify completely opaque or completely transparent, 1125respectively.</font></td> 1126 </tr> 1127 <tr> 1128 <td style="text-align: center;"> 1129 <center><a name="opaque"></a> <font size="-1">opaque</font></center> 1130 </td> 1131 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 1132&opaqueColor_, const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> &penColor_</font></td> 1133 <td><font size="-1">Change color of pixels matching opaqueColor_ 1134to specified penColor_.</font></td> 1135 </tr> 1136 <tr nosave=""> 1137 <td style="text-align: center;" rowspan="2" nosave=""> 1138 <center><a name="ping"></a> <font size="-1">ping</font></center> 1139 </td> 1140 <td><font size="-1">const std::string &imageSpec_</font></td> 1141 <td rowspan="2" nosave=""><font size="-1">Ping is similar to read 1142except only enough of the image is read to determine the image columns, 1143rows, and filesize. The <a href="Image.php#columns">columns</a> </font>, 1144 <font size="-1"><a href="Image.php#rows">rows</a> , and <a 1145 href="Image.php#fileSize">fileSize</a> 1146attributes are valid after invoking ping. The image data is not 1147valid after calling ping.</font></td> 1148 </tr> 1149 <tr> 1150 <td><font size="-1">const Blob &blob_</font></td> 1151 </tr> 1152 <tr> 1153 <td style="vertical-align: middle; text-align: center;"><small><a 1154 name="process"></a>process<br> 1155 </small></td> 1156 <td style="vertical-align: middle;"><small>std::string name_, 1157const ssize_t argc_, char **argv_<br> 1158 </small></td> 1159 <td style="vertical-align: middle;"><small>Execute the named 1160process module, passing any arguments via an argument vector, with 1161argc_ 1162specifying the number of arguments in the vector, and argv_ passing the 1163address of an array of null-terminated C strings which constitute the 1164argument vector. An exception is thrown if the requested process module 1165does not exist, fails to load, or fails during execution.</small><br> 1166 </td> 1167 </tr> 1168 <tr> 1169 <td style="text-align: center;"> 1170 <center><a name="quantize"></a> <font size="-1">quantize</font></center> 1171 </td> 1172 <td><font size="-1">bool measureError_ = false</font></td> 1173 <td><font size="-1">Quantize image (reduce number of colors). Set 1174measureError_ to true in order to calculate error attributes.</font></td> 1175 </tr> 1176 <tr> 1177 <td style="text-align: center;"> 1178 <center><a name="raise"></a> <font size="-1">raise</font></center> 1179 </td> 1180 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1181&geometry_ = "6x6+0+0", bool raisedFlag_ = false</font></td> 1182 <td><font size="-1">Raise image (lighten or darken the edges of 1183an image to give a 3-D raised or lowered effect)</font></td> 1184 </tr> 1185 <tr> 1186 <td style="text-align: center;" rowspan="8"> 1187 <center><a name="read"></a> <font size="-1">read</font></center> 1188 </td> 1189 <td><font size="-1">const string &imageSpec_</font></td> 1190 <td><font size="-1">Read image into current object</font></td> 1191 </tr> 1192 <tr> 1193 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1194&size_, const std::string &imageSpec_</font></td> 1195 <td><font size="-1">Read image of specified size into current 1196object. This form is useful for images that do not specify their size 1197or to specify a size hint for decoding an image. For example, when 1198reading a Photo CD, JBIG, or JPEG image, a size request causes the 1199library to return an image which is the next resolution greater or 1200equal to the specified size. This may result in memory and time savings.</font></td> 1201 </tr> 1202 <tr> 1203 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> &blob_</font></td> 1204 <td rowspan="5"><font size="-1">Read encoded image of specified 1205size from an in-memory <a href="http://www.imagemagick.org/Magick++/Blob.html">BLOB</a> into current 1206object. Depending on the method arguments, the Blob size, depth, and 1207format may also be specified. Some image formats require that size be 1208specified. The default ImageMagick uses for depth depends on its 1209Quantum size (8 or 16). If ImageMagick's Quantum size does not 1210match that of the image, the depth may need to be specified. 1211ImageMagick can usually automagically detect the image's format. 1212When 1213a format can't be automagically detected, the format must be specified.</font></td> 1214 </tr> 1215 <tr> 1216 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 1217&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size_</font></td> 1218 </tr> 1219 <tr> 1220 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 1221&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size_, 1222size_t depth_</font></td> 1223 </tr> 1224 <tr> 1225 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 1226&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size_, 1227size_t depth_, const string &magick_ </font></td> 1228 </tr> 1229 <tr> 1230 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 1231&blob_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> &size_, 1232const 1233string &magick_</font></td> 1234 </tr> 1235 <tr> 1236 <td><font size="-1">const size_t width_, const size_t 1237height_, std::string map_, const StorageType type_, const void *pixels_</font></td> 1238 <td><font size="-1">Read image based on an array of image pixels. 1239The pixel data must be in scanline order top-to-bottom. The data can be 1240character, short int, integer, float, or double. Float and double 1241require the pixels to be normalized [0..1]. The other types are 1242[0..MaxRGB]. For example, to create a 640x480 image from 1243unsigned red-green-blue character data, use</font> 1244 <p><font size="-1"> image.read( 640, 480, "RGB", CharPixel, 1245pixels );</font> </p> 1246 <p><font size="-1">The parameters are as follows:</font> <br> 1247 1248 <table border="0" width="100%"> 1249 <tbody> 1250 <tr> 1251 <td><font size="-1">width_</font></td> 1252 <td><font size="-1">Width in pixels of the image.</font></td> 1253 </tr> 1254 <tr> 1255 <td><font size="-1">height_</font></td> 1256 <td><font size="-1">Height in pixels of the image.</font></td> 1257 </tr> 1258 <tr> 1259 <td><font size="-1">map_</font></td> 1260 <td><font size="-1">This character string can be any 1261combination or order of R = red, G = green, B = blue, A = alpha, C = 1262cyan, Y = yellow M = magenta, and K = black. The ordering reflects the 1263order of the pixels in the supplied pixel array.</font></td> 1264 </tr> 1265 <tr> 1266 <td><font size="-1">type_</font></td> 1267 <td><font size="-1">Pixel storage type (CharPixel, 1268ShortPixel, IntegerPixel, FloatPixel, or DoublePixel)</font></td> 1269 </tr> 1270 <tr> 1271 <td><font size="-1">pixels_</font></td> 1272 <td><font size="-1">This array of values contain the pixel 1273components as defined by the map_ and type_ parameters. The length of 1274the arrays must equal the area specified by the width_ and height_ 1275values and type_ parameters.</font></td> 1276 </tr> 1277 </tbody> 1278 </table> 1279 </p> 1280 </td> 1281 </tr> 1282 <tr> 1283 <td style="text-align: center;"> 1284 <center><a name="reduceNoise"></a> <font size="-1">reduceNoise</font></center> 1285 </td> 1286 <td><font size="-1">const double order_</font></td> 1287 <td><font size="-1">reduce noise in image using a noise peak elimination filter.</font></td> 1288 </tr> 1289 <tr> 1290 <td style="vertical-align: middle; text-align: center;"><small><a 1291 name="randomThreshold"></a>randomThreshold<br> 1292 </small></td> 1293 <td style="vertical-align: middle;"><small>const Geometry 1294&thresholds_<br> 1295 </small></td> 1296 <td style="vertical-align: middle;"><small>Random threshold the 1297image. Changes the value of individual pixels based on the intensity of 1298each pixel compared to a random threshold. The result is a 1299low-contrast, two color image. The thresholds_ argument is a 1300geometry containing LOWxHIGH thresholds. If the string contains 13012x2, 3x3, or 4x4, then an ordered dither of order 2, 3, or 4 will be 1302performed instead. This is a very fast alternative to 'quantize' based 1303dithering.<br> 1304 </small></td> 1305 </tr> 1306 <tr> 1307 <td style="vertical-align: middle; text-align: center;"><small><a 1308 name="randomThresholdChannel"></a>randomThresholdChannel<br> 1309 </small></td> 1310 <td style="vertical-align: middle;"><small>const Geometry 1311&thresholds_, const ChannelType channel_<br> 1312 </small></td> 1313 <td style="vertical-align: middle;"><small>Random threshold an 1314image channel. Similar to <a href="Image.php#randomThreshold">randomThreshold</a>() 1315but restricted to the specified channel.<br> 1316 </small></td> 1317 </tr> 1318 <tr> 1319 <td style="text-align: center;"> 1320 <center><a name="roll"></a> <font size="-1">roll</font></center> 1321 </td> 1322 <td><font size="-1">int columns_, ssize_t rows_</font></td> 1323 <td><font size="-1">Roll image (rolls image vertically and 1324horizontally) by specified number of columns and rows)</font></td> 1325 </tr> 1326 <tr> 1327 <td style="text-align: center;"> 1328 <center><a name="rotate"></a> <font size="-1">rotate</font></center> 1329 </td> 1330 <td><font size="-1">double degrees_</font></td> 1331 <td><font size="-1">Rotate image counter-clockwise by specified 1332number of degrees.</font></td> 1333 </tr> 1334 <tr> 1335 <td style="text-align: center;"> 1336 <center><a name="sample"></a> <font size="-1">sample</font></center> 1337 </td> 1338 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1339&geometry_ </font></td> 1340 <td><font size="-1">Resize image by using pixel sampling algorithm</font></td> 1341 </tr> 1342 <tr> 1343 <td style="text-align: center;"> 1344 <center><a name="scale"></a> <font size="-1">scale</font></center> 1345 </td> 1346 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1347&geometry_</font></td> 1348 <td><font size="-1">Resize image by using simple ratio algorithm</font></td> 1349 </tr> 1350 <tr> 1351 <td style="text-align: center;"> 1352 <center><a name="segment"></a> <font size="-1">segment</font></center> 1353 </td> 1354 <td><font size="-1">double clusterThreshold_ = 1.0,</font> <br> 1355 <font size="-1">double smoothingThreshold_ = 1.5</font></td> 1356 <td><font size="-1">Segment (coalesce similar image components) 1357by analyzing the histograms of the color components and identifying 1358units that are homogeneous with the fuzzy c-means technique. Also uses <i>quantizeColorSpace</i> 1359and <i>verbose</i> image attributes. Specify <i> clusterThreshold_</i> 1360, 1361as the number of pixels each cluster must 1362exceed 1363the cluster threshold to be considered valid. <i>SmoothingThreshold_</i> 1364eliminates noise in the second derivative of the histogram. As 1365the 1366value is increased, you can expect a smoother 1367second derivative. The default is 1.5.</font></td> 1368 </tr> 1369 <tr> 1370 <td style="text-align: center;"> 1371 <center><a name="shade"></a> <font size="-1">shade</font></center> 1372 </td> 1373 <td><font size="-1">double azimuth_ = 30, double elevation_ = 30,</font> 1374 <br> 1375 <font size="-1">bool colorShading_ = false</font></td> 1376 <td><font size="-1">Shade image using distant light source. 1377Specify <i> azimuth_</i> and <i>elevation_</i> as the 1378position of the light source. By default, the shading 1379results as a grayscale image.. Set c<i>olorShading_</i> to <i>true</i> 1380to 1381shade the red, green, and blue components of the image.</font></td> 1382 </tr> 1383 <tr> 1384 <td style="text-align: center;"> 1385 <center><a name="shadow"></a> <font size="-1">shadow</font></center> 1386 </td> 1387 <td><font size="-1">const double percent_opacity = 80, const double sigma_ 1388= 0.5, const ssize_t x_ = 0, const ssize_t y_ = 0</font></td> 1389 <td><font size="-1">simulate an image shadow</font></td> 1390 </tr> 1391 <tr> 1392 <td style="text-align: center;"> 1393 <center><a name="sharpen"></a> <font size="-1">sharpen</font></center> 1394 </td> 1395 <td><font size="-1">const double radius_ = 1, const double sigma_ 1396= 0.5</font></td> 1397 <td><font size="-1">Sharpen pixels in image. The <i>radius_</i> 1398parameter specifies the radius of the Gaussian, in pixels, not counting 1399the center pixel. The <i>sigma_</i> parameter specifies the 1400standard deviation of the Laplacian, in pixels.</font></td> 1401 </tr> 1402 <tr> 1403 <td style="vertical-align: middle; text-align: center;"><small><a 1404 name="sharpenChannel"></a>sharpenChannel<br> 1405 </small></td> 1406 <td style="vertical-align: middle;"><small>const ChannelType 1407channel_, const double radius_ = 0.0, const double sigma_ = 1.0<br> 1408 </small></td> 1409 <td style="vertical-align: middle;"><font size="-1">Sharpen pixel 1410quantums in an image channel The <span 1411 style="font-style: italic;">channel_</span> parameter specifies the 1412channel to sharpen.. The <i>radius_</i> 1413parameter specifies the radius of the Gaussian, in pixels, not counting 1414the center pixel. The <i>sigma_</i> parameter specifies the 1415standard deviation of the Laplacian, in pixels.</font></td> 1416 </tr> 1417 <tr> 1418 <td style="text-align: center;"> 1419 <center><a name="shave"></a> <font size="-1">shave</font></center> 1420 </td> 1421 <td><font size="-1">const Geometry &geometry_</font></td> 1422 <td><font size="-1">Shave pixels from image edges.</font></td> 1423 </tr> 1424 <tr> 1425 <td style="text-align: center;"> 1426 <center><a name="shear"></a> <font size="-1">shear</font></center> 1427 </td> 1428 <td><font size="-1">double xShearAngle_, double yShearAngle_</font></td> 1429 <td><font size="-1">Shear image (create parallelogram by sliding 1430image by X or Y axis). Shearing slides one edge of an image along 1431the X or Y axis, creating a 1432parallelogram. An X direction shear slides an edge along the X 1433axis, while a Y direction shear slides 1434an edge along the Y axis. The amount of the shear is controlled 1435by a shear angle. For X direction shears, x 1436degrees is measured relative to the Y axis, and similarly, for Y 1437direction shears y degrees is measured relative to the X 1438axis. Empty triangles left over from shearing the image are 1439filled with the color defined as <i>borderColor</i>. </font></td> 1440 </tr> 1441 <tr> 1442 <td style="text-align: center;"> 1443 <center><a name="solarize"></a> <font size="-1">solarize</font></center> 1444 </td> 1445 <td><font size="-1">double factor_ = 50.0</font></td> 1446 <td><font size="-1">Solarize image (similar to effect seen when 1447exposing a photographic film to light during the development process)</font></td> 1448 </tr> 1449 <tr> 1450 <td style="text-align: center;"> 1451 <center><a name="splice"></a> <font size="-1">splice</font></center> 1452 </td> 1453 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1454&geometry_</font></td> 1455 <td><font size="-1">splice the background color into the image</font></td> 1456 </tr> 1457 <tr> 1458 <td style="text-align: center;"> 1459 <center><a name="spread"></a> <font size="-1">spread</font></center> 1460 </td> 1461 <td><font size="-1">size_t amount_ = 3</font></td> 1462 <td><font size="-1">Spread pixels randomly within image by 1463specified amount</font></td> 1464 </tr> 1465 <tr> 1466 <td style="text-align: center;"> 1467 <center><a name="stegano"></a> <font size="-1">stegano</font></center> 1468 </td> 1469 <td><font size="-1">const Image &watermark_</font></td> 1470 <td><font size="-1">Add a digital watermark to the image (based 1471on second image)</font></td> 1472 </tr> 1473 <tr> 1474 <td> 1475 <center><a name="sparseColor"></a> <font size="-1">sparseColor</font></center> 1476 </td> 1477 <td><font size="-1">const ChannelType channel, const SparseColorMethod method, const size_t number_arguments, const double *arguments </font></td> 1478 <td><font size="-1">Sparse color image, given a set of coordinates, interpolates the colors found at those coordinates, across the whole image, using various methods.</font></td> 1479 </tr> 1480 <tr> 1481 <td style="text-align: center;"> 1482 <center><a name="statistics"></a> <font size="-1">statistics</font></center> 1483 </td> 1484 <td><font size="-1">ImageStatistics *statistics</font></td> 1485 <td><font size="-1">Obtain image statistics. Statistics are normalized to the range of 0.0 to 1.0 and are output to the specified ImageStatistics structure. The structure includes members maximum, minimum, mean, standard_deviation, and variance for each of these channels: red, green, blue, and opacity (e.g. statistics->red.maximum).</font></td> 1486 </tr> 1487 <tr> 1488 <td style="text-align: center;"> 1489 <center><a name="stereo"></a> <font size="-1">stereo</font></center> 1490 </td> 1491 <td><font size="-1">const Image &rightImage_</font></td> 1492 <td><font size="-1">Create an image which appears in stereo when 1493viewed with red-blue glasses (Red image on left, blue on right)</font></td> 1494 </tr> 1495 <tr> 1496 <td style="text-align: center;"> 1497 <center><a name="swirl"></a> <font size="-1">swirl</font></center> 1498 </td> 1499 <td><font size="-1">double degrees_</font></td> 1500 <td><font size="-1">Swirl image (image pixels are rotated by 1501degrees)</font></td> 1502 </tr> 1503 <tr> 1504 <td style="text-align: center;"> 1505 <center><a name="texture"></a> <font size="-1">texture</font></center> 1506 </td> 1507 <td><font size="-1">const Image &texture_</font></td> 1508 <td><font size="-1">Layer a texture on pixels matching image 1509background color.</font></td> 1510 </tr> 1511 <tr> 1512 <td style="text-align: center;"> 1513 <center><a name="threshold"></a> <font size="-1">threshold</font></center> 1514 </td> 1515 <td><font size="-1">double threshold_</font></td> 1516 <td><font size="-1">Threshold image</font></td> 1517 </tr> 1518 <tr> 1519 <td style="text-align: center;" rowspan="2"> 1520 <center><a name="transform"></a> <font size="-1">transform</font></center> 1521 </td> 1522 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1523&imageGeometry_</font></td> 1524 <td rowspan="2"><font size="-1">Transform image based on image 1525and crop geometries. Crop geometry is optional.</font></td> 1526 </tr> 1527 <tr> 1528 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1529&imageGeometry_, const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1530&cropGeometry_ </font></td> 1531 </tr> 1532 <tr> 1533 <td style="text-align: center;"> 1534 <center><a name="transparent"></a> <font size="-1">transparent</font></center> 1535 </td> 1536 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 1537&color_</font></td> 1538 <td><font size="-1">Add matte image to image, setting pixels 1539matching color to transparent.</font></td> 1540 </tr> 1541 <tr> 1542 <td style="text-align: center;"> 1543 <center><a name="trim"></a> <font size="-1">trim</font></center> 1544 </td> 1545 <td><font size="-1">void</font></td> 1546 <td><font size="-1">Trim edges that are the background color from 1547the image.</font></td> 1548 </tr> 1549 <tr> 1550 <td style="text-align: center;"> 1551 <center><a name="unsharpmask"></a> <font size="-1">unsharpmask</font></center> 1552 </td> 1553 <td><font size="-1">double radius_, double sigma_, double 1554amount_, double threshold_</font></td> 1555 <td><font size="-1">Sharpen the image using the unsharp mask 1556algorithm. The <i>radius</i>_ 1557parameter specifies the radius of the Gaussian, in pixels, not 1558counting the center pixel. The <i>sigma</i>_ parameter specifies the 1559standard deviation of the Gaussian, in pixels. The <i>amount</i>_ 1560parameter specifies the percentage of the difference between the 1561original and the blur image that is added back into the original. The <i>threshold</i>_ 1562parameter specifies the threshold in pixels needed to apply the 1563difference amount.</font></td> 1564 </tr> 1565 <tr> 1566 <td style="vertical-align: middle; text-align: center;"><small><a 1567 name="unsharpmaskChannel"></a>unsharpmaskChannel<br> 1568 </small></td> 1569 <td style="vertical-align: middle;"><small>const ChannelType 1570channel_, const double radius_, const double sigma_, const double 1571amount_, const double threshold_<br> 1572 </small></td> 1573 <td style="vertical-align: middle;"><small>Sharpen an image 1574channel using the unsharp mask algorithm. The <span 1575 style="font-style: italic;">channel_</span> parameter specifies the 1576channel to sharpen. </small><font size="-1">The <i>radius</i>_ 1577parameter specifies the radius of the Gaussian, in pixels, not 1578counting the center pixel. The <i>sigma</i>_ parameter specifies the 1579standard deviation of the Gaussian, in pixels. The <i>amount</i>_ 1580parameter specifies the percentage of the difference between the 1581original and the blur image that is added back into the original. The <i>threshold</i>_ 1582parameter specifies the threshold in pixels needed to apply the 1583difference amount.</font></td> 1584 </tr> 1585 <tr> 1586 <td style="text-align: center;"> 1587 <center><a name="wave"></a> <font size="-1">wave</font></center> 1588 </td> 1589 <td><font size="-1">double amplitude_ = 25.0, double wavelength_ 1590= 150.0</font></td> 1591 <td><font size="-1">Alter an image along a sine wave.</font></td> 1592 </tr> 1593 <tr> 1594 <td style="text-align: center;" rowspan="5"> 1595 <center><a name="write"></a> <font size="-1">write</font></center> 1596 </td> 1597 <td><font size="-1">const string &imageSpec_</font></td> 1598 <td><font size="-1">Write image to a file using filename i<i>mageSpec_</i> 1599.</font> <br> 1600 <font size="-1"><b><font color="#ff0000">Caution: </font></b> if 1601an image format is selected which is capable of supporting fewer 1602colors than the original image or quantization has been requested, the 1603original image will be quantized to fewer colors. Use a copy of the 1604original if this is a problem.</font></td> 1605 </tr> 1606 <tr> 1607 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> *blob_</font></td> 1608 <td rowspan="3"><font size="-1">Write image to a in-memory <a 1609 href="http://www.imagemagick.org/Magick++/Blob.html"> BLOB</a> stored in <i>blob_</i>. The <i>magick</i>_ 1610parameter specifies the image format to write (defaults to <a 1611 href="Image.php#magick">magick</a> ). The depth_ parameter species the image 1612depth (defaults to <a href="Image.php#depth"> depth</a> ).</font> <br> 1613 <font size="-1"><b><font color="#ff0000">Caution: </font></b> if 1614an image format is selected which is capable of supporting fewer 1615colors than the original image or quantization has been requested, the 1616original image will be quantized to fewer colors. Use a copy of the 1617original if this is a problem.</font></td> 1618 </tr> 1619 <tr> 1620 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> *blob_, 1621std::string &magick_</font></td> 1622 </tr> 1623 <tr> 1624 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> *blob_, 1625std::string &magick_, size_t depth_</font></td> 1626 </tr> 1627 <tr> 1628 <td><font size="-1">const ssize_t x_, const ssize_t y_, const size_t 1629columns_, const size_t rows_, const std::string &map_, 1630const StorageType type_, void *pixels_</font></td> 1631 <td><font size="-1">Write pixel data into a buffer you supply. 1632The data is saved either as char, short int, integer, float or double 1633format in the order specified by the type_ parameter. For example, we 1634want to extract scanline 1 of a 640x480 image as character data in 1635red-green-blue order:</font> 1636 <p><font size="-1"> image.write(0,0,640,1,"RGB",0,pixels);</font> 1637 </p> 1638 <p><font size="-1">The parameters are as follows:</font> <br> 1639 1640 <table border="0" width="100%"> 1641 <tbody> 1642 <tr> 1643 <td><font size="-1">x_</font></td> 1644 <td><font size="-1">Horizontal ordinate of left-most 1645coordinate of region to extract.</font></td> 1646 </tr> 1647 <tr> 1648 <td><font size="-1">y_</font></td> 1649 <td><font size="-1">Vertical ordinate of top-most 1650coordinate of region to extract.</font></td> 1651 </tr> 1652 <tr> 1653 <td><font size="-1">columns_</font></td> 1654 <td><font size="-1">Width in pixels of the region to 1655extract.</font></td> 1656 </tr> 1657 <tr> 1658 <td><font size="-1">rows_</font></td> 1659 <td><font size="-1">Height in pixels of the region to 1660extract.</font></td> 1661 </tr> 1662 <tr> 1663 <td><font size="-1">map_</font></td> 1664 <td><font size="-1">This character string can be any 1665combination or order of R = red, G = green, B = blue, A = alpha, C = 1666cyan, Y = yellow, M = magenta, and K = black. The ordering reflects 1667the order of the pixels in the supplied pixel array.</font></td> 1668 </tr> 1669 <tr> 1670 <td><font size="-1">type_</font></td> 1671 <td><font size="-1">Pixel storage type (CharPixel, 1672ShortPixel, IntegerPixel, FloatPixel, or DoublePixel)</font></td> 1673 </tr> 1674 <tr> 1675 <td><font size="-1">pixels_</font></td> 1676 <td><font size="-1">This array of values contain the pixel 1677components as defined by the map_ and type_ parameters. The length of 1678the arrays must equal the area specified by the width_ and height_ 1679values and type_ parameters.</font></td> 1680 </tr> 1681 </tbody> 1682 </table> 1683 </p> 1684 </td> 1685 </tr> 1686 <tr> 1687 <td style="text-align: center;"> 1688 <center><a name="resize"></a> <font size="-1">resize</font></center> 1689 </td> 1690 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 1691&geometry_</font></td> 1692 <td><font size="-1">Resize image to specified size.</font></td> 1693 </tr> 1694 </tbody> 1695</table></ul> 1696</p> 1697</div> 1698<h2> <a name="Image Attributes"></a> Image Attributes</h2> 1699<div class="doc-section"> 1700Image attributes are set and obtained via methods in Image. Except for 1701methods which accept pointer arguments (e.g. c<tt>hromaBluePrimary)</tt> 1702all methods return attributes by value. 1703<p>Image attributes are easily used. For example, to set the resolution 1704of the TIFF file "file.tiff" to 150 dots-per-inch (DPI) in both the 1705horizontal and vertical directions, you can use the following example 1706code: </p> 1707<pre class="code"> 1708string filename("file.tiff"); 1709Image image; 1710image.read(filename); 1711image.resolutionUnits(PixelsPerInchResolution); 1712image.density(Geometry(150,150)); // could also use image.density("150x150") 1713image.write(filename) 1714</pre> 1715The supported image attributes and the method arguments required to 1716obtain them are shown in the following table: <br> 1717 1718<ul><table border="1"> 1719 <caption>Image Attributes</caption> <tbody> 1720 <tr> 1721 <td> 1722 <center><b>Function</b></center> 1723 </td> 1724 <td> 1725 <center><b>Type</b></center> 1726 </td> 1727 <td> 1728 <center><b>Get Signature</b></center> 1729 </td> 1730 <td> 1731 <center><b>Set Signature</b></center> 1732 </td> 1733 <td> 1734 <center><b>Description</b></center> 1735 </td> 1736 </tr> 1737 <tr> 1738 <td> 1739 <center><a name="adjoin"></a> <font size="-1">adjoin</font></center> 1740 </td> 1741 <td><font size="-1">bool</font></td> 1742 <td><font size="-1">void</font></td> 1743 <td><font size="-1">bool flag_</font></td> 1744 <td><font size="-1">Join images into a single multi-image file.</font></td> 1745 </tr> 1746 <tr> 1747 <td> 1748 <center><a name="antiAlias"></a> <font size="-1">antiAlias</font></center> 1749 </td> 1750 <td><font size="-1">bool</font></td> 1751 <td><font size="-1">void</font></td> 1752 <td><font size="-1">bool flag_</font></td> 1753 <td><font size="-1">Control antialiasing of rendered Postscript 1754and Postscript or TrueType fonts. Enabled by default.</font></td> 1755 </tr> 1756 <tr> 1757 <td> 1758 <center><a name="animationDelay"></a> <font size="-1">animation-</font> 1759 <br> 1760 <font size="-1">Delay</font></center> 1761 </td> 1762 <td><font size="-1">size_t (0 to 65535)</font></td> 1763 <td><font size="-1">void</font></td> 1764 <td><font size="-1">size_t delay_</font></td> 1765 <td><font size="-1">Time in 1/100ths of a second (0 to 65535) 1766which must expire before displaying the next image in an animated 1767sequence. This option is useful for regulating the animation of a 1768sequence of GIF images within Netscape.</font></td> 1769 </tr> 1770 <tr> 1771 <td> 1772 <center><a name="animationIterations"></a> <font size="-1">animation-</font> 1773 <br> 1774 <font size="-1">Iterations</font></center> 1775 </td> 1776 <td><font size="-1">size_t</font></td> 1777 <td><font size="-1">void</font></td> 1778 <td><font size="-1">size_t iterations_</font></td> 1779 <td><font size="-1">Number of iterations to loop an animation 1780(e.g. Netscape loop extension) for.</font></td> 1781 </tr> 1782 <tr> 1783 <td style="vertical-align: middle; text-align: center;"><small><a 1784 name="attribute"></a>attribute<br> 1785 </small></td> 1786 <td style="vertical-align: middle;"><small>string<br> 1787 </small></td> 1788 <td style="vertical-align: top;" valign="top"><small>const 1789std::string name_<br> 1790 </small></td> 1791 <td style="vertical-align: top;" valign="top"><small>const 1792std::string name_, const std::string value_</small></td> 1793 <td style="vertical-align: middle;"><small>An arbitrary named 1794image attribute. Any number of named attributes may be attached to the 1795image. For example, the image comment is a named image attribute with 1796the name "comment". EXIF tags are attached to the image as named 1797attributes. Use the syntax "EXIF:<tag>" to request an EXIF tag 1798similar to "EXIF:DateTime".</small><br> 1799 </td> 1800 </tr> 1801 <tr> 1802 <td> 1803 <center><a name="backgroundColor"></a> <font size="-1">background-</font> 1804 <br> 1805 <font size="-1">Color</font></center> 1806 </td> 1807 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> </font></td> 1808 <td><font size="-1">void</font></td> 1809 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 1810&color_</font></td> 1811 <td><font size="-1">Image background color</font></td> 1812 </tr> 1813 <tr> 1814 <td> 1815 <center><a name="backgroundTexture"></a> <font size="-1">background-</font> 1816 <br> 1817 <font size="-1">Texture</font></center> 1818 </td> 1819 <td><font size="-1">string</font></td> 1820 <td><font size="-1">void</font></td> 1821 <td><font size="-1">const string &texture_</font></td> 1822 <td><font size="-1">Image file name to use as the background 1823texture. Does not modify image pixels.</font></td> 1824 </tr> 1825 <tr> 1826 <td> 1827 <center><a name="baseColumns"></a> <font size="-1">baseColumns</font></center> 1828 </td> 1829 <td><font size="-1">size_t</font></td> 1830 <td><font size="-1">void</font></td> 1831 <td bgcolor="#666666"><font size="-1"> </font></td> 1832 <td><font size="-1">Base image width (before transformations)</font></td> 1833 </tr> 1834 <tr> 1835 <td> 1836 <center><a name="baseFilename"></a> <font size="-1">baseFilename</font></center> 1837 </td> 1838 <td><font size="-1">string</font></td> 1839 <td><font size="-1">void</font></td> 1840 <td bgcolor="#666666"><font size="-1"> </font></td> 1841 <td><font size="-1">Base image filename (before transformations)</font></td> 1842 </tr> 1843 <tr> 1844 <td> 1845 <center><a name="baseRows"></a> <font size="-1">baseRows</font></center> 1846 </td> 1847 <td><font size="-1">size_t</font></td> 1848 <td><font size="-1">void</font></td> 1849 <td bgcolor="#666666"><font size="-1"> </font></td> 1850 <td><font size="-1">Base image height (before transformations)</font></td> 1851 </tr> 1852 <tr> 1853 <td> 1854 <center><a name="borderColor"></a> <font size="-1">borderColor</font></center> 1855 </td> 1856 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> </font></td> 1857 <td><font size="-1">void</font></td> 1858 <td><font size="-1"> const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 1859&color_</font></td> 1860 <td><font size="-1">Image border color</font></td> 1861 </tr> 1862 <tr> 1863 <td><a name="boundingBox"></a> <font size="-1">boundingBox</font></td> 1864 <td><font size="-1">Geometry</font></td> 1865 <td><font size="-1">void</font></td> 1866 <td bgcolor="#666666"><font size="-1"> </font></td> 1867 <td><font size="-1">Return smallest bounding box enclosing 1868non-border pixels. The current fuzz value is used when discriminating 1869between pixels. This is the crop bounding box used by 1870crop(Geometry(0,0)).</font></td> 1871 </tr> 1872 <tr> 1873 <td> 1874 <center><a name="boxColor"></a> <font size="-1">boxColor</font></center> 1875 </td> 1876 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> </font></td> 1877 <td><font size="-1">void</font></td> 1878 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 1879&boxColor_</font></td> 1880 <td><font size="-1">Base color that annotation text is rendered 1881on.</font></td> 1882 </tr> 1883 <tr> 1884 <td><a name="cacheThreshold"></a> <font size="-1">cacheThreshold</font></td> 1885 <td><font size="-1">size_t</font></td> 1886 <td bgcolor="#666666"><font size="-1"> </font></td> 1887 <td><font size="-1">const size_t</font></td> 1888 <td><font size="-1">Pixel cache threshold in megabytes. Once this 1889threshold is exceeded, all subsequent pixels cache operations are 1890to/from disk. This is a static method and the attribute it sets is 1891shared by all Image objects.</font></td> 1892 </tr> 1893 <tr> 1894 <td style="vertical-align: middle;" valign="middle"><small><a 1895 name="channelDepth"></a>channelDepth<br> 1896 </small></td> 1897 <td style="vertical-align: middle;" valign="middle"><small>size_t 1898<br> 1899 </small></td> 1900 <td style="vertical-align: middle;" valign="middle"><small>const 1901ChannelType channel_<br> 1902 </small></td> 1903 <td style="vertical-align: middle;"><small>const ChannelType 1904channel_, const size_t depth_<br> 1905 </small></td> 1906 <td style="vertical-align: middle;"><small>Channel modulus depth. 1907The channel modulus depth represents the minimum number of bits 1908required 1909to support the channel without loss. Setting the channel's modulus 1910depth 1911modifies the channel (i.e. discards resolution) if the requested 1912modulus 1913depth is less than the current modulus depth, otherwise the channel is 1914not altered. There is no attribute associated with the modulus depth so 1915the current modulus depth is obtained by inspecting the pixels. As a 1916result, the depth returned may be less than the most recently set 1917channel depth. Subsequent image processing may result in increasing the 1918channel depth.<br> 1919 </small></td> 1920 </tr> 1921 <tr> 1922 <td> 1923 <center><a name="chromaBluePrimary"></a> <font size="-1">chroma-</font> 1924 <br> 1925 <font size="-1">BluePrimary</font></center> 1926 </td> 1927 <td><font size="-1">double x & y</font></td> 1928 <td><font size="-1">double *x_, double *y_</font></td> 1929 <td><font size="-1">double x_, double y_</font></td> 1930 <td><font size="-1">Chromaticity blue primary point (e.g. x=0.15, 1931y=0.06)</font></td> 1932 </tr> 1933 <tr> 1934 <td> 1935 <center><a name="chromaGreenPrimary"></a> <font size="-1">chroma-</font> 1936 <br> 1937 <font size="-1">GreenPrimary</font></center> 1938 </td> 1939 <td><font size="-1">double x & y</font></td> 1940 <td><font size="-1">double *x_, double *y_</font></td> 1941 <td><font size="-1">double x_, double y_</font></td> 1942 <td><font size="-1">Chromaticity green primary point (e.g. x=0.3, 1943y=0.6)</font></td> 1944 </tr> 1945 <tr> 1946 <td> 1947 <center><a name="chromaRedPrimary"></a> <font size="-1">chroma-</font> 1948 <br> 1949 <font size="-1">RedPrimary</font></center> 1950 </td> 1951 <td><font size="-1">double x & y</font></td> 1952 <td><font size="-1">double *x_, double *y_</font></td> 1953 <td><font size="-1">double x_, double y_</font></td> 1954 <td><font size="-1">Chromaticity red primary point (e.g. x=0.64, 1955y=0.33)</font></td> 1956 </tr> 1957 <tr> 1958 <td> 1959 <center><a name="chromaWhitePoint"></a> <font size="-1">chroma-</font> 1960 <br> 1961 <font size="-1">WhitePoint</font></center> 1962 </td> 1963 <td><font size="-1">double x & y</font></td> 1964 <td><font size="-1">double*x_, double *y_</font></td> 1965 <td><font size="-1">double x_, double y_</font></td> 1966 <td><font size="-1">Chromaticity white point (e.g. x=0.3127, 1967y=0.329)</font></td> 1968 </tr> 1969 <tr> 1970 <td> 1971 <center><a name="classType"></a> <font size="-1">classType</font></center> 1972 </td> 1973 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ClassType">ClassType</a> 1974 </font></td> 1975 <td><font size="-1">void</font></td> 1976 <td><font size="-1"> <a href="http://www.imagemagick.org/Magick++/Enumerations.html#ClassType">ClassType</a> 1977class_</font></td> 1978 <td><font size="-1">Image storage class. Note that 1979conversion from a DirectClass image to a PseudoClass image may result 1980in a loss of color due to the limited size of the palette (256 or 198165535 colors).</font></td> 1982 </tr> 1983 <tr> 1984 <td> 1985 <center><a name="clipMask"></a> <font size="-1">clipMask</font></center> 1986 </td> 1987 <td><font size="-1">Image</font></td> 1988 <td><font size="-1">void</font></td> 1989 <td><font size="-1">const Image &clipMask_</font></td> 1990 <td><font size="-1">Associate a clip mask image with the current 1991image. The clip mask image must have the same dimensions as the current 1992image or an exception is thrown. Clipping occurs wherever pixels are 1993transparent in the clip mask image. Clipping Pass an invalid image to 1994unset an existing clip mask.</font></td> 1995 </tr> 1996 <tr> 1997 <td> 1998 <center><a name="colorFuzz"></a> <font size="-1">colorFuzz</font></center> 1999 </td> 2000 <td><font size="-1">double</font></td> 2001 <td><font size="-1">void</font></td> 2002 <td><font size="-1">double fuzz_</font></td> 2003 <td><font size="-1">Colors within this distance are considered 2004equal. A number of algorithms search for a target color. By 2005default the color must be exact. Use this option to match colors that 2006are close to the target color in RGB space.</font></td> 2007 </tr> 2008 <tr> 2009 <td> 2010 <center><a name="colorMap"></a> <font size="-1">colorMap</font></center> 2011 </td> 2012 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> </font></td> 2013 <td><font size="-1">size_t index_</font></td> 2014 <td><font size="-1">size_t index_, const <a 2015 href="http://www.imagemagick.org/Magick++/Color.html"> Color</a> &color_</font></td> 2016 <td><font size="-1">Color at colormap index.</font></td> 2017 </tr> 2018 <tr> 2019 <td valign="middle"> 2020 <div align="center"><a name="colorMapSize"></a> <font size="-1">colorMapSize<br> 2021 </font></div> 2022 </td> 2023 <td valign="middle"><font size="-1">size_t<br> 2024 </font></td> 2025 <td valign="middle"><font size="-1">void<br> 2026 </font></td> 2027 <td valign="middle"><font size="-1">size_t entries_<br> 2028 </font></td> 2029 <td valign="middle"><font size="-1">Number of entries in the 2030colormap. Setting the colormap size may extend or truncate the 2031colormap. 2032The maximum number of supported entries is specified by the <i>MaxColormapSize</i>constant, 2033and is dependent on the value of QuantumDepth when ImageMagick is 2034compiled. An exception is thrown if more entries are requested than may 2035be supported. Care should be taken when truncating the colormap to 2036ensure that the image colormap indexes reference valid colormap entries.</font><br> 2037 </td> 2038 </tr> 2039 <tr> 2040 <td> 2041 <center><a name="colorSpace"></a> <font size="-1">colorSpace</font></center> 2042 </td> 2043 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a> 2044colorSpace_</font></td> 2045 <td><font size="-1">void</font></td> 2046 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a> 2047colorSpace_</font></td> 2048 <td><font size="-1">The colorspace (e.g. CMYK) used to represent 2049the image pixel colors. Image pixels are always stored as RGB(A) except 2050for the case of CMY(K).</font></td> 2051 </tr> 2052 <tr> 2053 <td> 2054 <center><a name="columns"></a> <font size="-1">columns</font></center> 2055 </td> 2056 <td><font size="-1">size_t</font></td> 2057 <td><font size="-1">void</font></td> 2058 <td bgcolor="#666666"><font size="-1"> </font></td> 2059 <td><font size="-1">Image width</font></td> 2060 </tr> 2061 <tr> 2062 <td> 2063 <center><a name="comment"></a> <font size="-1">comment</font></center> 2064 </td> 2065 <td><font size="-1">string</font></td> 2066 <td><font size="-1">void</font></td> 2067 <td bgcolor="#666666"><font size="-1"> </font></td> 2068 <td><font size="-1">Image comment</font></td> 2069 </tr> 2070 <tr> 2071 <td> 2072 <center><a name="compose"></a> <font size="-1">compose</font></center> 2073 </td> 2074 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#CompositeOperator">CompositeOperator</a> 2075 </font></td> 2076 <td><small><font size="-1"><small>void</small></font></small></td> 2077 <td><small><font size="-1"><small><a 2078 href="http://www.imagemagick.org/Magick++/Enumerations.html#CompositeOperator">CompositeOperator</a> 2079compose_</small></font></small></td> 2080 <td><font size="-1">Composition operator to be used when 2081composition is implicitly used (such as for image flattening).</font></td> 2082 </tr> 2083 <tr> 2084 <td> 2085 <center><a name="compressType"></a> <font size="-1">compress-</font> 2086 <br> 2087 <font size="-1">Type</font></center> 2088 </td> 2089 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#CompressionType">CompressionType</a> 2090 </font></td> 2091 <td><small><font size="-1"><small>void</small></font></small></td> 2092 <td><small><font size="-1"><small><a 2093 href="http://www.imagemagick.org/Magick++/Enumerations.html#CompressionType">CompressionType</a> 2094compressType_</small></font></small></td> 2095 <td><font size="-1">Image compresion type. The default is the 2096compression type of the specified image file.</font></td> 2097 </tr> 2098 <tr> 2099 <td> 2100 <center><a name="debug"></a> <font size="-1">debug</font></center> 2101 </td> 2102 <td><font size="-1">bool</font></td> 2103 <td><small><font size="-1"><small>void</small></font></small></td> 2104 <td><small><font size="-1"><small>bool flag_</small></font></small></td> 2105 <td><font size="-1">Enable printing of internal debug messages 2106from ImageMagick as it executes.</font></td> 2107 </tr> 2108 <tr> 2109 <td style="text-align: center; vertical-align: middle;"><small><a 2110 name="defineValue"></a>defineValue<br> 2111 </small></td> 2112 <td style="vertical-align: middle; text-align: left;"><small>string<br> 2113 </small></td> 2114 <td style="vertical-align: middle;"><small>const std::string 2115&magick_, const std::string &key_<br> 2116 </small></td> 2117 <td style="vertical-align: middle;"><small>const std::string 2118&magick_, const std::string &key_, const std::string 2119&value_<br> 2120 </small></td> 2121 <td style="vertical-align: top;"><small>Set or obtain a 2122definition string to applied when encoding or decoding the specified 2123format. The meanings of the definitions are format specific. The format 2124is designated by the <span style="font-style: italic;">magick_</span> 2125argument, the format-specific key is designated by <span 2126 style="font-style: italic;">key_</span>, and the associated value is 2127specified by <span style="font-style: italic;">value_</span>. See the 2128defineSet() method if the key must be removed entirely.</small><br> 2129 </td> 2130 </tr> 2131 <tr> 2132 <td style="text-align: center; vertical-align: middle;"><small><a 2133 name="defineSet"></a>defineSet<br> 2134 </small></td> 2135 <td style="vertical-align: middle; text-align: left;"><small>bool<br> 2136 </small></td> 2137 <td style="vertical-align: middle;"><small>const std::string 2138&magick_, const std::string &key_<br> 2139 </small></td> 2140 <td style="vertical-align: middle;"><small>const std::string 2141&magick_, const std::string &key_, bool flag_<br> 2142 </small></td> 2143 <td style="vertical-align: middle;"><small>Set or obtain a 2144definition flag to applied when encoding or decoding the specified 2145format.</small><small>. Similar to the defineValue() method except that 2146passing the <span style="font-style: italic;">flag_</span> value 2147'true' 2148creates a value-less define with that format and key. Passing the <span 2149 style="font-style: italic;">f</span><span style="font-style: italic;">lag_</span> 2150value 'false' removes any existing matching definition. The method 2151returns 'true' if a matching key exists, and 'false' if no matching key 2152exists.<br> 2153 </small></td> 2154 </tr> 2155 <tr> 2156 <td> 2157 <center><a name="density"></a> <font size="-1">density</font></center> 2158 </td> 2159 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 2160(default 72x72)</font></td> 2161 <td><font size="-1">void</font></td> 2162 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 2163&density_</font></td> 2164 <td><font size="-1">Vertical and horizontal resolution in pixels 2165of the image. This option specifies an image density when decoding a 2166Postscript or Portable Document page. Often used with <i>psPageSize</i>.</font></td> 2167 </tr> 2168 <tr> 2169 <td> 2170 <center><a name="depth"></a> <font size="-1">depth</font></center> 2171 </td> 2172 <td><font size="-1"> size_t (8-32)</font></td> 2173 <td><font size="-1">void</font></td> 2174 <td><font size="-1">size_t depth_</font></td> 2175 <td><font size="-1">Image depth. Used to specify the bit depth 2176when reading or writing raw images or when the output format 2177supports multiple depths. Defaults to the quantum depth that 2178ImageMagick is compiled with.</font></td> 2179 </tr> 2180 <tr> 2181 <td> 2182 <center><a name="endian"></a> <font size="-1">endian</font></center> 2183 </td> 2184 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#EndianType">EndianType</a> 2185 </font></td> 2186 <td><font size="-1">void</font></td> 2187 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#EndianType">EndianType</a> 2188endian_</font></td> 2189 <td><font size="-1">Specify (or obtain) endian option for formats 2190which support it.</font></td> 2191 </tr> 2192 <tr> 2193 <td> 2194 <center><a name="directory"></a> <font size="-1">directory</font></center> 2195 </td> 2196 <td><font size="-1">string</font></td> 2197 <td><font size="-1">void</font></td> 2198 <td><font size="-1"> </font></td> 2199 <td><font size="-1">Tile names from within an image montage</font></td> 2200 </tr> 2201 <tr> 2202 <td> 2203 <center><a name="file"></a> <font size="-1">file</font></center> 2204 </td> 2205 <td><font size="-1">FILE *</font></td> 2206 <td><font size="-1">FILE *</font></td> 2207 <td><font size="-1">FILE *file_</font></td> 2208 <td><font size="-1">Image file descriptor.</font></td> 2209 </tr> 2210 <tr> 2211 <td> 2212 <center><a name="fileName"></a> <font size="-1">fileName</font></center> 2213 </td> 2214 <td><font size="-1">string</font></td> 2215 <td><font size="-1">void</font></td> 2216 <td><font size="-1">const string &fileName_</font></td> 2217 <td><font size="-1">Image file name.</font></td> 2218 </tr> 2219 <tr> 2220 <td> 2221 <center><a name="fileSize"></a> <font size="-1">fileSize</font></center> 2222 </td> 2223 <td><font size="-1">off_t</font></td> 2224 <td><font size="-1">void</font></td> 2225 <td bgcolor="#666666"><font size="-1"> </font></td> 2226 <td><font size="-1">Number of bytes of the image on disk</font></td> 2227 </tr> 2228 <tr> 2229 <td> 2230 <center><a name="fillColor"></a> <font size="-1">fillColor</font></center> 2231 </td> 2232 <td><font size="-1">Color</font></td> 2233 <td><font size="-1">void</font></td> 2234 <td><font size="-1">const Color &fillColor_</font></td> 2235 <td><font size="-1">Color to use when filling drawn objects</font></td> 2236 </tr> 2237 <tr> 2238 <td> 2239 <center><a name="fillPattern"></a> <font size="-1">fillPattern</font></center> 2240 </td> 2241 <td><font size="-1">Image</font></td> 2242 <td><font size="-1">void</font></td> 2243 <td><font size="-1">const Image &fillPattern_</font></td> 2244 <td><font size="-1">Pattern image to use when filling drawn 2245objects.</font></td> 2246 </tr> 2247 <tr> 2248 <td> 2249 <center><a name="fillRule"></a> <font size="-1">fillRule</font></center> 2250 </td> 2251 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#FillRule">FillRule</a> 2252 </font></td> 2253 <td><font size="-1">void</font></td> 2254 <td><font size="-1">const Magick::FillRule &fillRule_</font></td> 2255 <td><font size="-1">Rule to use when filling drawn objects.</font></td> 2256 </tr> 2257 <tr> 2258 <td> 2259 <center><a name="filterType"></a> <font size="-1">filterType</font></center> 2260 </td> 2261 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#FilterTypes">FilterTypes</a> 2262 </font></td> 2263 <td><font size="-1">void</font></td> 2264 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#FilterTypes">FilterTypes</a> 2265filterType_</font></td> 2266 <td><font size="-1">Filter to use when resizing image. The 2267reduction filter employed has a significant effect on the time required 2268to resize an image and the resulting quality. The default filter is <i>Lanczos</i> 2269which has been shown to produce high quality results when reducing most 2270images.</font></td> 2271 </tr> 2272 <tr> 2273 <td> 2274 <center><a name="font"></a> <font size="-1">font</font></center> 2275 </td> 2276 <td><font size="-1">string</font></td> 2277 <td><font size="-1">void</font></td> 2278 <td><font size="-1">const string &font_</font></td> 2279 <td><font size="-1">Text rendering font. If the font is a fully 2280qualified X server font name, the font is obtained from an X 2281server. To use a TrueType font, precede the TrueType filename with an 2282@. Otherwise, specify a Postscript font name (e.g. 2283"helvetica").</font></td> 2284 </tr> 2285 <tr> 2286 <td> 2287 <center><a name="fontPointsize"></a> <font size="-1">fontPointsize</font></center> 2288 </td> 2289 <td><font size="-1">size_t</font></td> 2290 <td><font size="-1">void</font></td> 2291 <td><font size="-1">size_t pointSize_</font></td> 2292 <td><font size="-1">Text rendering font point size</font></td> 2293 </tr> 2294 <tr> 2295 <td> 2296 <center><a name="fontTypeMetrics"></a> <font size="-1">fontTypeMetrics</font></center> 2297 </td> 2298 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/TypeMetric.html">TypeMetric</a> </font></td> 2299 <td><font size="-1">const std::string &text_, <a 2300 href="http://www.imagemagick.org/Magick++/TypeMetric.html"> TypeMetric</a> *metrics</font></td> 2301 <td bgcolor="#666666"><font size="-1"> </font></td> 2302 <td><font size="-1">Update metrics with font type metrics using 2303specified <i>text</i>, and current <a href="Image.php#font">font</a> and <a 2304 href="Image.php#fontPointsize">fontPointSize</a> settings.</font></td> 2305 </tr> 2306 <tr> 2307 <td> 2308 <center><a name="format"></a> <font size="-1">format</font></center> 2309 </td> 2310 <td><font size="-1">string</font></td> 2311 <td><font size="-1">void</font></td> 2312 <td bgcolor="#666666"><font size="-1"> </font></td> 2313 <td><font size="-1">Long form image format description.</font></td> 2314 </tr> 2315 <tr> 2316 <td> 2317 <center><a name="gamma"></a> <font size="-1">gamma</font></center> 2318 </td> 2319 <td><font size="-1">double (typical range 0.8 to 2.3)</font></td> 2320 <td><font size="-1">void</font></td> 2321 <td bgcolor="#666666"><font size="-1"> </font></td> 2322 <td><font size="-1">Gamma level of the image. The same color 2323image displayed on two different workstations may 2324look different due to differences in the display monitor. 2325Use gamma correction to adjust for this 2326color difference.</font></td> 2327 </tr> 2328 <tr> 2329 <td> 2330 <center><a name="geometry"></a> <font size="-1">geometry</font></center> 2331 </td> 2332 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> </font></td> 2333 <td><font size="-1">void</font></td> 2334 <td bgcolor="#666666"><font size="-1"> </font></td> 2335 <td><font size="-1">Preferred size of the image when encoding.</font></td> 2336 </tr> 2337 <tr> 2338 <td> 2339 <center><a name="gifDisposeMethod"></a> <font size="-1">gifDispose-</font> 2340 <br> 2341 <font size="-1">Method</font></center> 2342 </td> 2343 <td><font size="-1">size_t</font> <br> 2344 <font size="-1">{ 0 = Disposal not specified,</font> <br> 2345 <font size="-1">1 = Do not dispose of graphic,</font> <br> 2346 <font size="-1">3 = Overwrite graphic with background color,</font> 2347 <br> 2348 <font size="-1">4 = Overwrite graphic with previous graphic. }</font></td> 2349 <td><font size="-1">void</font></td> 2350 <td><font size="-1">size_t disposeMethod_</font></td> 2351 <td><font size="-1">GIF disposal method. This option is used to 2352control how successive frames are rendered (how the preceding frame is 2353disposed of) when creating a GIF animation.</font></td> 2354 </tr> 2355 <tr> 2356 <td> 2357 <center><a name="iccColorProfile"></a> <font size="-1">iccColorProfile</font></center> 2358 </td> 2359 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> </font></td> 2360 <td><font size="-1">void</font></td> 2361 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> 2362&colorProfile_</font></td> 2363 <td><font size="-1">ICC color profile. Supplied via a <a 2364 href="http://www.imagemagick.org/Magick++/Blob.html"> Blob</a> since Magick++/ and ImageMagick do not 2365currently support formating this data structure directly. 2366Specifications are available from the <a href="http://www.color.org/"> 2367International Color Consortium</a> for the format of ICC color profiles.</font></td> 2368 </tr> 2369 <tr> 2370 <td> 2371 <center><a name="interlaceType"></a> <font size="-1">interlace-</font> 2372 <br> 2373 <font size="-1">Type</font></center> 2374 </td> 2375 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#InterlaceType">InterlaceType</a> 2376 </font></td> 2377 <td><font size="-1">void</font></td> 2378 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#InterlaceType">InterlaceType</a> 2379interlace_</font></td> 2380 <td><font size="-1">The type of interlacing scheme (default <i>NoInterlace</i> 2381). This option is used to specify the type of interlacing 2382scheme for raw image formats such as RGB or YUV. <i>NoInterlace</i> 2383means do not interlace, <i>LineInterlace</i> uses scanline 2384interlacing, and <i>PlaneInterlace</i> uses plane interlacing. <i> 2385PartitionInterlace</i> is like <i>PlaneInterlace</i> except the 2386different planes are saved to individual files (e.g. 2387image.R, image.G, and image.B). Use <i>LineInterlace</i> or <i> 2388PlaneInterlace</i> to create an interlaced GIF or progressive JPEG 2389image.</font></td> 2390 </tr> 2391 <tr> 2392 <td> 2393 <center><a name="iptcProfile"></a> <font size="-1">iptcProfile</font></center> 2394 </td> 2395 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> </font></td> 2396 <td><font size="-1">void</font></td> 2397 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a> & 2398iptcProfile_</font></td> 2399 <td><font size="-1">IPTC profile. Supplied via a <a 2400 href="http://www.imagemagick.org/Magick++/Blob.html"> Blob</a> since Magick++ and ImageMagick do not 2401currently support formating this data structure directly. 2402Specifications are available from the <a href="http://www.iptc.org/"> 2403International Press Telecommunications Council</a> for IPTC profiles.</font></td> 2404 </tr> 2405 <tr> 2406 <td> 2407 <center><a name="label"></a> <font size="-1">label</font></center> 2408 </td> 2409 <td><font size="-1">string</font></td> 2410 <td><font size="-1">void</font></td> 2411 <td><font size="-1">const string &label_</font></td> 2412 <td><font size="-1">Image label</font></td> 2413 </tr> 2414 <tr> 2415 <td> 2416 <center><a name="magick"></a> <font size="-1">magick</font></center> 2417 </td> 2418 <td><font size="-1">string</font></td> 2419 <td><font size="-1">void</font></td> 2420 <td><font size="-1"> const string &magick_</font></td> 2421 <td><font size="-1">Get image format (e.g. "GIF")</font></td> 2422 </tr> 2423 <tr> 2424 <td> 2425 <center><a name="matte"></a> <font size="-1">matte</font></center> 2426 </td> 2427 <td><font size="-1">bool</font></td> 2428 <td><font size="-1">void</font></td> 2429 <td><font size="-1">bool matteFlag_</font></td> 2430 <td><font size="-1">True if the image has transparency. If set 2431True, store matte channel if the image has one otherwise create 2432an opaque one.</font></td> 2433 </tr> 2434 <tr> 2435 <td> 2436 <center><a name="matteColor"></a> <font size="-1">matteColor</font></center> 2437 </td> 2438 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> </font></td> 2439 <td><font size="-1">void</font></td> 2440 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> 2441&matteColor_</font></td> 2442 <td><font size="-1">Image matte (frame) color</font></td> 2443 </tr> 2444 <tr> 2445 <td> 2446 <center><a name="meanErrorPerPixel"></a> <font size="-1">meanError-</font> 2447 <br> 2448 <font size="-1">PerPixel</font></center> 2449 </td> 2450 <td><font size="-1">double</font></td> 2451 <td><font size="-1">void</font></td> 2452 <td bgcolor="#666666"><font size="-1"> </font></td> 2453 <td><font size="-1">The mean error per pixel computed when an 2454image is color reduced. This parameter is only valid if verbose is set 2455to true and the image has just been quantized.</font></td> 2456 </tr> 2457 <tr> 2458 <td style="text-align: center; vertical-align: middle;"><font 2459 size="-1"><a name="modulusDepth"></a>modulusDepth<br> 2460 </font></td> 2461 <td style="text-align: left; vertical-align: middle;"><small>size_t 2462<br> 2463 </small></td> 2464 <td style="text-align: left; vertical-align: middle;"><small><font 2465 size="-1"><small>void<br> 2466 </small></font></small></td> 2467 <td style="text-align: left; vertical-align: middle;"><small>size_t 2468depth_<br> 2469 </small></td> 2470 <td style="text-align: left; vertical-align: middle;"><small>Image 2471modulus depth (minimum number of bits required to support 2472red/green/blue components without loss of accuracy). The pixel modulus 2473depth may be decreased by supplying a value which is less than the 2474current value, updating the pixels (reducing accuracy) to the new 2475depth. 2476The pixel modulus depth can not be increased over the current value 2477using this method.<br> 2478 </small></td> 2479 </tr> 2480 <tr> 2481 <td> 2482 <center><a name="monochrome"></a> <font size="-1">monochrome</font></center> 2483 </td> 2484 <td><font size="-1">bool</font></td> 2485 <td><font size="-1">void</font></td> 2486 <td><font size="-1">bool flag_</font></td> 2487 <td><font size="-1">Transform the image to black and white</font></td> 2488 </tr> 2489 <tr> 2490 <td> 2491 <center><a name="montageGeometry"></a> <font size="-1">montage-</font> 2492 <br> 2493 <font size="-1">Geometry</font></center> 2494 </td> 2495 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> </font></td> 2496 <td><font size="-1">void</font></td> 2497 <td bgcolor="#666666"><font size="-1"> </font></td> 2498 <td><font size="-1">Tile size and offset within an image montage. 2499Only valid for montage images.</font></td> 2500 </tr> 2501 <tr> 2502 <td> 2503 <center><a name="normalizedMaxError"></a> <font size="-1">normalized-</font> 2504 <br> 2505 <font size="-1">MaxError</font></center> 2506 </td> 2507 <td><font size="-1">double</font></td> 2508 <td><font size="-1">void</font></td> 2509 <td bgcolor="#666666"><font size="-1"> </font></td> 2510 <td><font size="-1">The normalized max error per pixel computed 2511when an image is color reduced. This parameter is only valid if verbose 2512is set to true and the image has just been quantized.</font></td> 2513 </tr> 2514 <tr> 2515 <td> 2516 <center><a name="normalizedMeanError"></a> <font size="-1">normalized-</font> 2517 <br> 2518 <font size="-1">MeanError</font></center> 2519 </td> 2520 <td><font size="-1">double</font></td> 2521 <td><font size="-1">void</font></td> 2522 <td bgcolor="#666666"><font size="-1"> </font></td> 2523 <td><font size="-1">The normalized mean error per pixel computed 2524when an image is color reduced. This parameter is only valid if verbose 2525is set to true and the image has just been quantized.</font></td> 2526 </tr> 2527 <tr> 2528 <td style="text-align: center; vertical-align: middle;"><small><a 2529 name="orientation"></a>orientation<br> 2530 </small></td> 2531 <td style="vertical-align: middle;"><small><a 2532 href="http://www.imagemagick.org/Magick++/Enumerations.html#OrientationType">OrientationType</a></small></td> 2533 <td style="vertical-align: top;"><small>void</small><br> 2534 </td> 2535 <td style="vertical-align: middle;"><small><a 2536 href="http://www.imagemagick.org/Magick++/Enumerations.html#OrientationType">OrientationType</a> 2537orientation_</small></td> 2538 <td style="vertical-align: top;"><small>Image orientation. 2539 Supported by some file formats such as DPX and TIFF. Useful for 2540turning the right way up.<br> 2541 </small></td> 2542 </tr> 2543 <tr> 2544 <td> 2545 <center><a name="packets"></a> <font size="-1">packets</font></center> 2546 </td> 2547 <td><font size="-1">size_t</font></td> 2548 <td><font size="-1">void</font></td> 2549 <td bgcolor="#666666"><font size="-1"> </font></td> 2550 <td><font size="-1">The number of runlength-encoded packets in</font> 2551 <br> 2552 <font size="-1">the image</font></td> 2553 </tr> 2554 <tr> 2555 <td> 2556 <center><a name="packetSize"></a> <font size="-1">packetSize</font></center> 2557 </td> 2558 <td><font size="-1">size_t</font></td> 2559 <td><font size="-1">void</font></td> 2560 <td bgcolor="#666666"><font size="-1"> </font></td> 2561 <td><font size="-1">The number of bytes in each pixel packet</font></td> 2562 </tr> 2563 <tr> 2564 <td> 2565 <center><a name="page"></a> <font size="-1">page</font></center> 2566 </td> 2567 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Geometry.html#PostscriptPageSize">Geometry</a> 2568 </font></td> 2569 <td><font size="-1">void</font></td> 2570 <td><font size="-1">const <a 2571 href="http://www.imagemagick.org/Magick++/Geometry.html#PostscriptPageSize"> Geometry</a> &pageSize_</font></td> 2572 <td><font size="-1">Preferred size and location of an image 2573canvas.</font> 2574 <p><font size="-1">Use this option to specify the dimensions 2575and position of the Postscript page in dots per inch or a TEXT page in 2576pixels. This option is typically used in concert with <i><a 2577 href="Image.php#density"> density</a> </i>.</font> </p> 2578 <p><font size="-1">Page may also be used to position a GIF 2579image (such as for a scene in an animation)</font></p> 2580 </td> 2581 </tr> 2582 <tr> 2583 <td> 2584 <center><a name="pixelColor"></a> <font size="-1">pixelColor</font></center> 2585 </td> 2586 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> </font></td> 2587 <td><font size="-1">ssize_t x_, ssize_t y_</font></td> 2588 <td><font size="-1">ssize_t x_, ssize_t y_, const <a 2589 href="http://www.imagemagick.org/Magick++/Color.html"> Color</a> &color_</font></td> 2590 <td><font size="-1">Get/set pixel color at location x & y.</font></td> 2591 </tr> 2592 <tr> 2593 <td valign="top"> 2594 <div align="center"><a name="profile"></a> <small>profile</small><br> 2595 </div> 2596 </td> 2597 <td valign="top"><a href="http://www.imagemagick.org/Magick++/Blob.html"><small> Blob</small><small><br> 2598 </small></a> </td> 2599 <td valign="top"><small>const std::string name_</small><small><br> 2600 </small></td> 2601 <td valign="top"><small>const std::string name_, const Blob 2602&colorProfile_</small><small><br> 2603 </small></td> 2604 <td valign="top"><small>Get/set/remove </small><small> a named 2605profile</small><small>. Valid names include </small><small>"*", 2606"8BIM", "ICM", "IPTC", or a user/format-defined profile name. </small><br> 2607 </td> 2608 </tr> 2609 <tr> 2610 <td> 2611 <center><a name="quality"></a> <font size="-1">quality</font></center> 2612 </td> 2613 <td><font size="-1">size_t (0 to 100)</font></td> 2614 <td><font size="-1">void</font></td> 2615 <td><font size="-1">size_t quality_</font></td> 2616 <td><font size="-1">JPEG/MIFF/PNG compression level (default 75).</font></td> 2617 </tr> 2618 <tr> 2619 <td> 2620 <center><a name="quantizeColors"></a> <font size="-1">quantize-</font> 2621 <br> 2622 <font size="-1">Colors</font></center> 2623 </td> 2624 <td><font size="-1">size_t</font></td> 2625 <td><font size="-1">void</font></td> 2626 <td><font size="-1">size_t colors_</font></td> 2627 <td><font size="-1">Preferred number of colors in the image. The 2628actual number of colors in the image may be less than your request, but 2629never more. Images with less unique colors than specified with this 2630option will have any duplicate or unused colors removed.</font></td> 2631 </tr> 2632 <tr> 2633 <td> 2634 <center><a name="quantizeColorSpace"></a> <font size="-1">quantize-</font> 2635 <br> 2636 <font size="-1">ColorSpace</font></center> 2637 </td> 2638 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a> 2639 </font></td> 2640 <td><font size="-1">void</font></td> 2641 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ColorspaceType">ColorspaceType</a> 2642colorSpace_</font></td> 2643 <td><font size="-1">Colorspace to quantize colors in (default 2644RGB). Empirical evidence suggests that distances in color spaces such 2645as YUV or YIQ correspond to perceptual color differences more closely 2646than do distances in RGB space. These color spaces may give better 2647results when color reducing an image.</font></td> 2648 </tr> 2649 <tr> 2650 <td> 2651 <center><a name="quantizeDither"></a> <font size="-1">quantize-</font> 2652 <br> 2653 <font size="-1">Dither</font></center> 2654 </td> 2655 <td><font size="-1">bool</font></td> 2656 <td><font size="-1">void</font></td> 2657 <td><font size="-1">bool flag_</font></td> 2658 <td><font size="-1">Apply Floyd/Steinberg error diffusion to the 2659image. The basic strategy of dithering is to trade 2660intensity 2661resolution for spatial resolution by 2662averaging the intensities of several 2663neighboring pixels. Images which suffer from 2664severe contouring when reducing colors can be 2665improved with this option. The quantizeColors or monochrome option must 2666be set for this option to take effect.</font></td> 2667 </tr> 2668 <tr> 2669 <td> 2670 <center><a name="quantizeTreeDepth"></a> <font size="-1">quantize-</font> 2671 <br> 2672 <font size="-1">TreeDepth</font></center> 2673 </td> 2674 <td><font size="-1">size_t </font></td> 2675 <td><font size="-1">void</font></td> 2676 <td><font size="-1">size_t treeDepth_</font></td> 2677 <td><font size="-1">Depth of the quantization color 2678classification tree. Values of 0 or 1 allow selection of the optimal 2679tree depth for the color reduction algorithm. Values between 2 and 8 2680may be used to manually adjust the tree depth.</font></td> 2681 </tr> 2682 <tr> 2683 <td> 2684 <center><a name="renderingIntent"></a> <font size="-1">rendering-</font> 2685 <br> 2686 <font size="-1">Intent</font></center> 2687 </td> 2688 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#RenderingIntent">RenderingIntent</a> 2689 </font></td> 2690 <td><font size="-1">void</font></td> 2691 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#RenderingIntent">RenderingIntent</a> 2692render_</font></td> 2693 <td><font size="-1">The type of rendering intent</font></td> 2694 </tr> 2695 <tr> 2696 <td> 2697 <center><a name="resolutionUnits"></a> <font size="-1">resolution-</font> 2698 <br> 2699 <font size="-1">Units</font></center> 2700 </td> 2701 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ResolutionType">ResolutionType</a> 2702 </font></td> 2703 <td><font size="-1">void</font></td> 2704 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ResolutionType">ResolutionType</a> 2705units_</font></td> 2706 <td><font size="-1">Units of image resolution</font></td> 2707 </tr> 2708 <tr> 2709 <td> 2710 <center><a name="rows"></a> <font size="-1">rows</font></center> 2711 </td> 2712 <td><font size="-1">size_t</font></td> 2713 <td><font size="-1">void</font></td> 2714 <td bgcolor="#666666"><font size="-1"> </font></td> 2715 <td><font size="-1">The number of pixel rows in the image</font></td> 2716 </tr> 2717 <tr> 2718 <td> 2719 <center><a name="scene"></a> <font size="-1">scene</font></center> 2720 </td> 2721 <td><font size="-1">size_t</font></td> 2722 <td><font size="-1">void</font></td> 2723 <td><font size="-1">size_t scene_</font></td> 2724 <td><font size="-1">Image scene number</font></td> 2725 </tr> 2726 <tr> 2727 <td> 2728 <center><a name="signature"></a> <font size="-1">signature</font></center> 2729 </td> 2730 <td><font size="-1">string</font></td> 2731 <td><font size="-1">bool force_ = false</font></td> 2732 <td bgcolor="#666666"><font size="-1"> </font></td> 2733 <td><font size="-1">Image MD5 signature. Set force_ to 'true' to 2734force re-computation of signature.</font></td> 2735 </tr> 2736 <tr> 2737 <td> 2738 <center><a name="size"></a> <font size="-1">size</font></center> 2739 </td> 2740 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> </font></td> 2741 <td><font size="-1">void</font></td> 2742 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a> 2743&geometry_</font></td> 2744 <td><font size="-1">Width and height of a raw image (an image 2745which does not support width and height information). Size may 2746also be used to affect the image size read from a multi-resolution 2747format (e.g. Photo CD, JBIG, or JPEG.</font></td> 2748 </tr> 2749 <tr> 2750 <td style="text-align: center;"> 2751 <center><a name="strip"></a> <font size="-1">strip</font></center> 2752 </td> 2753 <td><font size="-1">void</font></td> 2754 <td><font size="-1">strips an image of all profiles and comments.</font></td> 2755 </tr> 2756 <tr> 2757 <td> 2758 <center><a name="strokeAntiAlias"></a> <font size="-1">strokeAntiAlias</font></center> 2759 </td> 2760 <td><font size="-1">bool</font></td> 2761 <td><font size="-1">void</font></td> 2762 <td><font size="-1">bool flag_</font></td> 2763 <td><font size="-1">Enable or disable anti-aliasing when drawing 2764object outlines.</font></td> 2765 </tr> 2766 <tr> 2767 <td> 2768 <center><a name="strokeColor"></a> <font size="-1">strokeColor</font></center> 2769 </td> 2770 <td><font size="-1">Color</font></td> 2771 <td><font size="-1">void</font></td> 2772 <td><font size="-1">const Color &strokeColor_</font></td> 2773 <td><font size="-1">Color to use when drawing object outlines</font></td> 2774 </tr> 2775 <tr> 2776 <td> 2777 <center><a name="strokeDashOffset"></a> <font size="-1">strokeDashOffset</font></center> 2778 </td> 2779 <td><font size="-1">size_t</font></td> 2780 <td><font size="-1">void</font></td> 2781 <td><font size="-1">double strokeDashOffset_</font></td> 2782 <td><font size="-1">While drawing using a dash pattern, specify 2783distance into the dash pattern to start the dash (default 0).</font></td> 2784 </tr> 2785 <tr> 2786 <td> 2787 <center><a name="strokeDashArray"></a> <font size="-1">strokeDashArray</font></center> 2788 </td> 2789 <td><font size="-1">const double*</font></td> 2790 <td><font size="-1">void</font></td> 2791 <td><font size="-1">const double* strokeDashArray_</font></td> 2792 <td><font size="-1">Specify the pattern of dashes and gaps used 2793to stroke paths. The strokeDashArray represents a zero-terminated 2794array of numbers that specify the lengths (in pixels) of alternating 2795dashes and gaps in user units. If an odd number of values is provided, 2796then the list of values is repeated to yield an even number of 2797values. A typical strokeDashArray_ array might contain the 2798members 5 3 2 0, where the zero value indicates the end of the pattern 2799array.</font></td> 2800 </tr> 2801 <tr> 2802 <td> 2803 <center><a name="strokeLineCap"></a> <font size="-1">strokeLineCap</font></center> 2804 </td> 2805 <td><font size="-1">LineCap</font></td> 2806 <td><font size="-1">void</font></td> 2807 <td><font size="-1">LineCap lineCap_</font></td> 2808 <td><font size="-1">Specify the shape to be used at the corners 2809of paths (or other vector shapes) when they are stroked. Values of 2810LineJoin are UndefinedJoin, MiterJoin, RoundJoin, and BevelJoin.</font></td> 2811 </tr> 2812 <tr> 2813 <td> 2814 <center><a name="strokeLineJoin"></a> <font size="-1">strokeLineJoin</font></center> 2815 </td> 2816 <td><font size="-1">LineJoin</font></td> 2817 <td><font size="-1">void</font></td> 2818 <td><font size="-1">LineJoin lineJoin_</font></td> 2819 <td><font size="-1">Specify the shape to be used at the corners 2820of paths (or other vector shapes) when they are stroked. Values of 2821LineJoin are UndefinedJoin, MiterJoin, RoundJoin, and BevelJoin.</font></td> 2822 </tr> 2823 <tr> 2824 <td> 2825 <center><a name="strokeMiterLimit"></a> <font size="-1">strokeMiterLimit</font></center> 2826 </td> 2827 <td><font size="-1">size_t</font></td> 2828 <td><font size="-1">void</font></td> 2829 <td><font size="-1">size_t miterLimit_</font></td> 2830 <td><font size="-1">Specify miter limit. When two line segments 2831meet at a sharp angle and miter joins have been specified for 2832'lineJoin', it is possible for the miter to extend far beyond the 2833thickness of the line stroking the path. The miterLimit' imposes a 2834limit on the ratio of the miter length to the 'lineWidth'. The default 2835value of this parameter is 4.</font></td> 2836 </tr> 2837 <tr> 2838 <td> 2839 <center><a name="strokeWidth"></a> <font size="-1">strokeWidth</font></center> 2840 </td> 2841 <td><font size="-1">double</font></td> 2842 <td><font size="-1">void</font></td> 2843 <td><font size="-1">double strokeWidth_</font></td> 2844 <td><font size="-1">Stroke width for use when drawing vector 2845objects (default one)</font></td> 2846 </tr> 2847 <tr> 2848 <td> 2849 <center><a name="strokePattern"></a> <font size="-1">strokePattern</font></center> 2850 </td> 2851 <td><font size="-1">Image</font></td> 2852 <td><font size="-1">void</font></td> 2853 <td><font size="-1">const Image &strokePattern_</font></td> 2854 <td><font size="-1">Pattern image to use while drawing object 2855stroke (outlines).</font></td> 2856 </tr> 2857 <tr> 2858 <td> 2859 <center><a name="subImage"></a> <font size="-1">subImage</font></center> 2860 </td> 2861 <td><font size="-1">size_t</font></td> 2862 <td><font size="-1">void</font></td> 2863 <td><font size="-1">size_t subImage_</font></td> 2864 <td><font size="-1">Subimage of an image sequence</font></td> 2865 </tr> 2866 <tr> 2867 <td> 2868 <center><a name="subRange"></a> <font size="-1">subRange</font></center> 2869 </td> 2870 <td><font size="-1">size_t</font></td> 2871 <td><font size="-1">void</font></td> 2872 <td><font size="-1">size_t subRange_</font></td> 2873 <td><font size="-1">Number of images relative to the base image</font></td> 2874 </tr> 2875 <tr> 2876 <td valign="middle"> 2877 <div align="center"><a name="textEncoding"></a> <small>textEncoding</small><br> 2878 </div> 2879 </td> 2880 <td valign="middle"><small>string</small><small><br> 2881 </small></td> 2882 <td valign="middle"><small>void</small><small><br> 2883 </small></td> 2884 <td valign="middle"><small>const std::string &encoding_</small><small><br> 2885 </small></td> 2886 <td valign="top"><small>Specify the code set to use for text 2887annotations. The only character encoding which may be specified at 2888this time is "UTF-8" for representing </small><small><a 2889 href="http://www.unicode.org/"> Unicode </a> </small><small>as a 2890sequence of bytes. Specify an empty string to use the default ASCII 2891encoding. Successful text annotation using Unicode may require fonts 2892designed to support Unicode.</small><br> 2893 </td> 2894 </tr> 2895 <tr> 2896 <td> 2897 <center><a name="tileName"></a> <font size="-1">tileName</font></center> 2898 </td> 2899 <td><font size="-1">string</font></td> 2900 <td><font size="-1">void</font></td> 2901 <td><font size="-1">const string &tileName_</font></td> 2902 <td><font size="-1">Tile name</font></td> 2903 </tr> 2904 <tr> 2905 <td> 2906 <center><a name="totalColors"></a> <font size="-1">totalColors</font></center> 2907 </td> 2908 <td><font size="-1">size_t</font></td> 2909 <td><font size="-1">void</font></td> 2910 <td bgcolor="#666666"><font size="-1"> </font></td> 2911 <td><font size="-1">Number of colors in the image</font></td> 2912 </tr> 2913 <tr> 2914 <td> 2915 <center><a name="type"></a> <font size="-1">type</font></center> 2916 </td> 2917 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#ImageType">ImageType</a> 2918 </font></td> 2919 <td><font size="-1">void</font></td> 2920 <td bgcolor="#ffffff"><font size="-1"><a 2921 href="http://www.imagemagick.org/Magick++/Enumerations.html#ImageType"> ImageType</a> </font></td> 2922 <td><font size="-1">Image type.</font></td> 2923 </tr> 2924 <tr> 2925 <td> 2926 <center><a name="verbose"></a> <font size="-1">verbose</font></center> 2927 </td> 2928 <td><font size="-1">bool</font></td> 2929 <td><font size="-1">void</font></td> 2930 <td><font size="-1">bool verboseFlag_</font></td> 2931 <td><font size="-1">Print detailed information about the image</font></td> 2932 </tr> 2933 <tr> 2934 <td> 2935 <center><a name="view"></a> <font size="-1">view</font></center> 2936 </td> 2937 <td><font size="-1">string</font></td> 2938 <td><font size="-1">void</font></td> 2939 <td><font size="-1">const string &view_</font></td> 2940 <td><font size="-1">FlashPix viewing parameters.</font></td> 2941 </tr> 2942 <tr> 2943 <td> 2944 <center><a name="virtualPixelMethod"></a> <font size="-1">virtualPixelMethod</font></center> 2945 </td> 2946 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#VirtualPixelMethod">VirtualPixelMethod</a> 2947 </font></td> 2948 <td><small><font size="-1"><small>void</small></font></small></td> 2949 <td><small><font size="-1"><small><a 2950 href="http://www.imagemagick.org/Magick++/Enumerations.html#VirtualPixelMethod">VirtualPixelMethod</a> 2951virtualPixelMethod_</small></font></small></td> 2952 <td><font size="-1">Image virtual pixel method.</font></td> 2953 </tr> 2954 <tr> 2955 <td> 2956 <center><a name="x11Display"></a> <font size="-1">x11Display</font></center> 2957 </td> 2958 <td><font size="-1">string (e.g. "hostname:0.0")</font></td> 2959 <td><font size="-1">void</font></td> 2960 <td><font size="-1">const string &display_</font></td> 2961 <td><font size="-1">X11 display to display to, obtain fonts from, 2962or to capture image from</font></td> 2963 </tr> 2964 <tr> 2965 <td> 2966 <center><a name="xResolution"></a> <font size="-1">xResolution</font></center> 2967 </td> 2968 <td><font size="-1">double</font></td> 2969 <td><font size="-1">void</font></td> 2970 <td bgcolor="#666666"><font size="-1"> </font></td> 2971 <td><font size="-1">x resolution of the image</font></td> 2972 </tr> 2973 <tr> 2974 <td> 2975 <center><a name="yResolution"></a> <font size="-1">yResolution</font></center> 2976 </td> 2977 <td><font size="-1">double</font></td> 2978 <td><font size="-1">void</font></td> 2979 <td bgcolor="#666666"><font size="-1"> </font></td> 2980 <td><font size="-1">y resolution of the image</font></td> 2981 </tr> 2982 </tbody> 2983</table></ul> 2984</div> 2985<h2> <a name="Raw Image Pixel Access"></a> Low-Level Image Pixel Access</h2> 2986<div class="doc-section"> 2987Image pixels (of type <i><a href="http://www.imagemagick.org/Magick++/PixelPacket.html">PixelPacket</a> </i>) 2988may be accessed directly via the <i>Image Pixel Cache</i> . The 2989image pixel cache is a rectangular window into the actual image pixels 2990(which may be in memory, memory-mapped from a disk file, or entirely on 2991disk). Two interfaces exist to access the <i>Image Pixel Cache.</i> 2992The 2993interface described here (part of the <i>Image</i> class) supports 2994only 2995one view at a time. See the <i><a href="http://www.imagemagick.org/Magick++/Pixels.html">Pixels</a> </i> 2996class for a more abstract interface which supports simultaneous pixel 2997views (up to the number of rows). As an analogy, the interface 2998described 2999here relates to the <i><a href="http://www.imagemagick.org/Magick++/Pixels.html">Pixels</a> </i> class as 3000stdio's gets() relates to fgets(). The <i><a href="http://www.imagemagick.org/Magick++/Pixels.html"> Pixels</a> 3001</i>class provides the more general form of the interface. 3002<p>Obtain existing image pixels via <i>getPixels()</i>. Create a new 3003pixel region using <i>setPixels().</i></p> 3004<p>In order to ensure that only the current generation of the image is 3005modified, the Image's <a href="Image.php#modifyImage">modifyImage()</a> method 3006should be invoked to reduce the reference count on the underlying image 3007to one. If this is not done, then it is possible for a previous 3008generation of the image to be modified due to the use of reference 3009counting when copying or constructing an Image.<br> 3010</p> 3011<p>Depending on the capabilities of the operating system, and the 3012relationship of the window to the image, the pixel cache may be a copy 3013of the pixels in the selected window, or it may be the actual image 3014pixels. In any case calling <i>syncPixels()</i> insures that the base 3015image is updated with the contents of the modified pixel cache. The 3016method <i> readPixels()</i> supports copying foreign pixel data 3017formats 3018into the pixel cache according to the <i>QuantumTypes</i>. The method <i>writePixels()</i> 3019supports copying the pixels in the cache to a foreign pixel 3020representation according to the format specified by <i>QuantumTypes</i>.</p> 3021<p>The pixel region is effectively a small image in which the pixels 3022may be accessed, addressed, and updated, as shown in the following 3023example: 3024<pre class="code"> 3025<p><img class="icon" src="http://nextgen.imagemagick.org/api/Cache.png" name="Graphic1" width="254" border="0"></p> 3026Image image("cow.png"); 3027// Ensure that there are no other references to this image. 3028image.modifyImage(); 3029// Set the image type to TrueColor DirectClass representation. 3030image.type(TrueColorType); 3031// Request pixel region with size 60x40, and top origin at 20x30 3032ssize_t columns = 60; 3033PixelPacket *pixel_cache = image.getPixels(20,30,columns,40); 3034// Set pixel at column 5, and row 10 in the pixel cache to red. 3035ssize_t column = 5; 3036ssize_t row = 10; 3037PixelPacket *pixel = pixel_cache+row*columns+column; 3038*pixel = Color("red"); 3039// Save changes to underlying image . 3040image.syncPixels(); 3041 // Save updated image to file. 3042image.write("horse.png"); 3043</pre> 3044</p> 3045<p>The image cache supports the following methods: <br> 3046 3047<ul><table border="1" width="100%"> 3048 <caption>Image Cache Methods</caption> <tbody> 3049 <tr> 3050 <td> 3051 <center><b>Method</b></center> 3052 </td> 3053 <td> 3054 <center><b>Returns</b></center> 3055 </td> 3056 <td> 3057 <center><b>Signature</b></center> 3058 </td> 3059 <td> 3060 <center><b>Description</b></center> 3061 </td> 3062 </tr> 3063 <tr> 3064 <td> 3065 <center><a name="getConstPixels"></a> <font size="-1">getConstPixels</font></center> 3066 </td> 3067 <td><font size="-1">const <a href="http://www.imagemagick.org/Magick++/PixelPacket.html">PixelPacket</a> 3068*</font></td> 3069 <td><font size="-1">const ssize_t x_, const ssize_t y_, const size_t 3070columns_, const size_t rows_</font></td> 3071 <td><font size="-1">Transfers pixels from the image to the pixel 3072cache as defined by the specified rectangular region. </font><font 3073 size="-1">The returned pointer remains valid until the next getPixel, 3074getConstPixels, or setPixels call and should never be deallocated by 3075the 3076user.</font></td> 3077 </tr> 3078 <tr> 3079 <td> 3080 <center><a name="getConstIndexes"></a> <font size="-1">getConstIndexes</font></center> 3081 </td> 3082 <td><font size="-1">const IndexPacket*</font></td> 3083 <td><font size="-1">void</font></td> 3084 <td><font size="-1">Returns a pointer to the Image pixel indexes 3085corresponding to a previous </font><font size="-1">getPixel, 3086getConstPixels, or setPixels call. </font><font size="-1">The 3087returned pointer remains valid until the next getPixel, getConstPixels, 3088or setPixels call and should never be deallocated by the user.</font><font 3089 size="-1"> Only valid for PseudoClass images or CMYKA images. The 3090pixel indexes represent an array of type IndexPacket, with each entry 3091corresponding to an x,y pixel position. For PseudoClass images, the 3092entry's value is the offset into the colormap (see <a href="Image.php#colorMap">colorMap</a> 3093) for that pixel. For CMYKA images, the indexes are used to contain the 3094alpha channel.</font></td> 3095 </tr> 3096 <tr> 3097 <td> 3098 <center><a name="getIndexes"></a> <font size="-1">getIndexes</font></center> 3099 </td> 3100 <td><font size="-1">IndexPacket*</font></td> 3101 <td><font size="-1">void</font></td> 3102 <td><font size="-1">Returns a pointer to the Image pixel indexes 3103corresponding to the pixel region requested by the last <a 3104 href="Image.php#getConstPixels">getConstPixels</a> , <a href="Image.php#getPixels">getPixels</a> 3105, or <a href="Image.php#setPixels">setPixels</a> call. </font><font 3106 size="-1">The 3107returned pointer remains valid until the next getPixel, getConstPixels, 3108or setPixels call and should never be deallocated by the user.</font><font 3109 size="-1"> </font><font size="-1">Only valid for PseudoClass images 3110or 3111CMYKA images. The pixel indexes represent an array of type 3112IndexPacket, with each entry corresponding to a pixel x,y position. For 3113PseudoClass images, the entry's value is the offset into the colormap 3114(see <a href="Image.php#colorMap">colorMap</a> ) for that pixel. For 3115CMYKA 3116images, the indexes are used to contain the alpha channel.</font></td> 3117 </tr> 3118 <tr> 3119 <td> 3120 <center><a name="getPixels"></a> <font size="-1">getPixels</font></center> 3121 </td> 3122 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/PixelPacket.html">PixelPacket</a> *</font></td> 3123 <td><font size="-1">const ssize_t x_, const ssize_t y_, const size_t 3124columns_, const size_t rows_</font></td> 3125 <td><font size="-1">Transfers pixels from the image to the pixel 3126cache as defined by the specified rectangular region. Modified pixels 3127may be subsequently transferred back to the image via syncPixels. </font><font 3128 size="-1">The returned pointer remains valid until the next getPixel, 3129getConstPixels, or setPixels call and should never be deallocated by 3130the 3131user.</font><font size="-1"></font></td> 3132 </tr> 3133 <tr> 3134 <td> 3135 <center><a name="setPixels"></a> <font size="-1">setPixels</font></center> 3136 </td> 3137 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/PixelPacket.html">PixelPacket</a> *</font></td> 3138 <td><font size="-1">const ssize_t x_, const ssize_t y_, const size_t 3139columns_, const size_t rows_</font></td> 3140 <td><font size="-1">Allocates a pixel cache region to store image 3141pixels as defined by the region rectangle. This area is 3142subsequently transferred from the pixel cache to the image via 3143syncPixels. </font><font size="-1">The returned pointer remains 3144valid until the next getPixel, getConstPixels, or setPixels call and 3145should never be deallocated by the user.</font></td> 3146 </tr> 3147 <tr> 3148 <td> 3149 <center><a name="syncPixels"></a> <font size="-1">syncPixels</font></center> 3150 </td> 3151 <td><font size="-1">void</font></td> 3152 <td><font size="-1">void</font></td> 3153 <td><font size="-1">Transfers the image cache pixels to the image.</font></td> 3154 </tr> 3155 <tr> 3156 <td> 3157 <center><a name="readPixels"></a> <font size="-1">readPixels</font></center> 3158 </td> 3159 <td><font size="-1">void</font></td> 3160 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#QuantumTypes">QuantumTypes</a> 3161quantum_, unsigned char *source_,</font></td> 3162 <td><font size="-1">Transfers one or more pixel components from a 3163buffer or file into the image pixel cache of an image. ReadPixels is 3164typically used to support image decoders. The region transferred 3165corresponds to the region set by a preceding setPixels call.</font></td> 3166 </tr> 3167 <tr> 3168 <td> 3169 <center><a name="writePixels"></a> <font size="-1">writePixels</font></center> 3170 </td> 3171 <td><font size="-1">void</font></td> 3172 <td><font size="-1"><a href="http://www.imagemagick.org/Magick++/Enumerations.html#QuantumTypes">QuantumTypes</a> 3173quantum_, unsigned char *destination_</font></td> 3174 <td><font size="-1">Transfers one or more pixel components from 3175the image pixel cache to a buffer or file. WritePixels is typically 3176used to support image encoders. The region transferred corresponds to 3177the region set by a preceding getPixels or getConstPixels call.</font></td> 3178 </tr> 3179 </tbody> 3180</table></ul> 3181</p> 3182</div> 3183</div> 3184 <footer class="magick-footer"> 3185 <p><a href="/script/support.php">Donate</a> • 3186 <a href="/script/sitemap.php">Sitemap</a> • 3187 <a href="/script/links.php">Related</a> • 3188 <a href="/script/architecture.php">Architecture</a> 3189</p> 3190 <p><a href="Image.php#">Back to top</a> • 3191 <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> • 3192 <a href="/script/contact.php">Contact Us</a></p> 3193 <p><small>© 1999-2016 ImageMagick Studio LLC</small></p> 3194 </footer> 3195</div><!-- /.container --> 3196 3197 <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script> 3198 <script src="http://nextgen.imagemagick.org/js/magick.php"></script> 3199</div> 3200</body> 3201</html> 3202
