| Cristy | 594d277 | 2015-11-15 10:47:42 -0500 | [diff] [blame] | 1 |  | 
 | 2 |  | 
 | 3 |  | 
 | 4 |  | 
| cristy | 29dc865 | 2015-05-12 16:26:21 +0000 | [diff] [blame] | 5 | <!DOCTYPE html> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 6 | <html lang="en"> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 7 | <head> | 
| Cristy | 594d277 | 2015-11-15 10:47:42 -0500 | [diff] [blame] | 8 |   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> | 
| cristy | 29f2c97 | 2015-07-28 13:37:46 +0000 | [diff] [blame] | 9 |     <title>ImageMagick: MagickCore, C API for ImageMagick: Transform an Image</title> | 
| Cristy | 594d277 | 2015-11-15 10:47:42 -0500 | [diff] [blame] | 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="magickcore, c, api, for, imagemagick:, transform, an, image, 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"/> | 
| Cristy | ce4a355 | 2015-12-14 13:53:35 -0500 | [diff] [blame] | 22 |   <meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC"/> | 
| Cristy | 594d277 | 2015-11-15 10:47:42 -0500 | [diff] [blame] | 23 |   <meta name="distribution" content="Global"/> | 
 | 24 |   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/> | 
 | 25 |   <link rel="icon" href="../images/wand.png"/> | 
 | 26 |   <link rel="shortcut icon" href="../images/wand.ico"/> | 
 | 27 |   <link rel="stylesheet" href="../css/magick.html"/> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 28 | </head> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 29 | <body> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 30 | <div class="main"> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 31 | <div class="magick-masthead"> | 
 | 32 |   <div class="container"> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 33 |     <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle" | 
| Cristy | 594d277 | 2015-11-15 10:47:42 -0500 | [diff] [blame] | 34 |          style="display:block" | 
 | 35 |          data-ad-client="ca-pub-3129977114552745" | 
 | 36 |          data-ad-slot="6345125851" | 
 | 37 |          data-ad-format="auto"></ins> | 
| cristy | 29f2c97 | 2015-07-28 13:37:46 +0000 | [diff] [blame] | 38 |     <script> | 
| Cristy | 542697a | 2015-10-12 20:10:32 -0400 | [diff] [blame] | 39 |       (adsbygoogle = window.adsbygoogle || []).push({}); | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 40 |     </script> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 41 |     <nav class="magick-nav"> | 
| cristy | 2f563d4 | 2015-05-06 23:36:51 +0000 | [diff] [blame] | 42 |       <a class="magick-nav-item " href="../index.html">Home</a> | 
| cristy | ea2793e | 2015-05-31 16:52:26 +0000 | [diff] [blame] | 43 |       <a class="magick-nav-item " href="../binary-releases.html">Download</a> | 
| cristy | 3818536 | 2015-05-07 20:09:56 +0000 | [diff] [blame] | 44 |       <a class="magick-nav-item " href="../command-line-tools.html">Tools</a> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 45 |       <a class="magick-nav-item " href="../command-line-processing.html">Command-line</a> | 
| cristy | ea2793e | 2015-05-31 16:52:26 +0000 | [diff] [blame] | 46 |       <a class="magick-nav-item " href="../resources.html">Resources</a> | 
 | 47 |       <a class="magick-nav-item " href="api.html">Develop</a> | 
| cristy | 5b8fe76 | 2015-06-09 16:24:03 +0000 | [diff] [blame] | 48 |       <a class="magick-nav-item " href="http://nextgen.imagemagick.org/script/search.php">Search</a> | 
| Cristy | e09ed31 | 2016-03-06 08:07:39 -0500 | [diff] [blame] | 49 |       <a class="magick-nav-item pull-right" href="https://www.imagemagick.org/discourse-server/">Community</a> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 50 |     </nav> | 
 | 51 |   </div> | 
 | 52 | </div> | 
 | 53 | <div class="container"> | 
| cristy | 4e638cd | 2015-05-07 16:47:40 +0000 | [diff] [blame] | 54 | <div class="magick-header"> | 
| Cristy | 776113a | 2016-04-29 12:01:19 -0400 | [diff] [blame] | 55 | <p class="text-center"><a href="transform.html#AutoOrientImage">AutoOrientImage</a> • <a href="transform.html#ChopImage">ChopImage</a> • <a href="transform.html#CropImage">CropImage</a> • <a href="transform.html#CropImageToTiles">CropImageToTiles</a> • <a href="transform.html#ExcerptImage">ExcerptImage</a> • <a href="transform.html#ExtentImage">ExtentImage</a> • <a href="transform.html#FlipImage">FlipImage</a> • <a href="transform.html#FlopImage">FlopImage</a> • <a href="transform.html#RollImage">RollImage</a> • <a href="transform.html#ShaveImage">ShaveImage</a> • <a href="transform.html#SpliceImage">SpliceImage</a> • <a href="transform.html#TransformImage">TransformImage</a> • <a href="transform.html#TransposeImage">TransposeImage</a> • <a href="transform.html#TransverseImage">TransverseImage</a> • <a href="transform.html#TrimImage">TrimImage</a></p> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 56 |  | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 57 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="AutoOrientImage">AutoOrientImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 58 |  | 
 | 59 | <p>AutoOrientImage() adjusts an image so that its orientation is suitable for viewing (i.e. top-left orientation).</p> | 
 | 60 |  | 
 | 61 | <p>The format of the AutoOrientImage method is:</p> | 
 | 62 |  | 
 | 63 | <pre class="text"> | 
 | 64 | Image *AutoOrientImage(const Image *image, | 
 | 65 |   const OrientationType orientation,ExceptionInfo *exception) | 
 | 66 | </pre> | 
 | 67 |  | 
 | 68 | <p>A description of each parameter follows:</p> | 
 | 69 |  | 
 | 70 | <dd> | 
 | 71 | </dd> | 
 | 72 |  | 
 | 73 | <dd> </dd> | 
 | 74 | <dl class="dl-horizontal"> | 
 | 75 | <dt>image</dt> | 
 | 76 | <dd>The image. </dd> | 
 | 77 |  | 
 | 78 | <dd> </dd> | 
 | 79 | <dt>orientation</dt> | 
 | 80 | <dd>Current image orientation. </dd> | 
 | 81 |  | 
 | 82 | <dd> </dd> | 
 | 83 | <dt>exception</dt> | 
 | 84 | <dd>Return any errors or warnings in this structure. </dd> | 
 | 85 |  | 
 | 86 | <dd>  </dd> | 
 | 87 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 88 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="ChopImage">ChopImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 89 |  | 
 | 90 | <p>ChopImage() removes a region of an image and collapses the image to occupy the removed portion.</p> | 
 | 91 |  | 
 | 92 | <p>The format of the ChopImage method is:</p> | 
 | 93 |  | 
 | 94 | <pre class="text"> | 
 | 95 | Image *ChopImage(const Image *image,const RectangleInfo *chop_info) | 
 | 96 |   ExceptionInfo *exception) | 
 | 97 | </pre> | 
 | 98 |  | 
 | 99 | <p>A description of each parameter follows:</p> | 
 | 100 |  | 
 | 101 | <dd> | 
 | 102 | </dd> | 
 | 103 |  | 
 | 104 | <dd> </dd> | 
 | 105 | <dl class="dl-horizontal"> | 
 | 106 | <dt>image</dt> | 
 | 107 | <dd>the image. </dd> | 
 | 108 |  | 
 | 109 | <dd> </dd> | 
 | 110 | <dt>chop_info</dt> | 
 | 111 | <dd>Define the region of the image to chop. </dd> | 
 | 112 |  | 
 | 113 | <dd> </dd> | 
 | 114 | <dt>exception</dt> | 
 | 115 | <dd>return any errors or warnings in this structure. </dd> | 
 | 116 |  | 
 | 117 | <dd>  </dd> | 
 | 118 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 119 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="CropImage">CropImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 120 |  | 
 | 121 | <p>CropImage() extracts a region of the image starting at the offset defined by geometry.  Region must be fully defined, and no special handling of geometry flags is performed.</p> | 
 | 122 |  | 
 | 123 | <p>The format of the CropImage method is:</p> | 
 | 124 |  | 
 | 125 | <pre class="text"> | 
 | 126 | Image *CropImage(const Image *image,const RectangleInfo *geometry, | 
 | 127 |   ExceptionInfo *exception) | 
 | 128 | </pre> | 
 | 129 |  | 
 | 130 | <p>A description of each parameter follows:</p> | 
 | 131 |  | 
 | 132 | <dd> | 
 | 133 | </dd> | 
 | 134 |  | 
 | 135 | <dd> </dd> | 
 | 136 | <dl class="dl-horizontal"> | 
 | 137 | <dt>image</dt> | 
 | 138 | <dd>the image. </dd> | 
 | 139 |  | 
 | 140 | <dd> </dd> | 
 | 141 | <dt>geometry</dt> | 
 | 142 | <dd>Define the region of the image to crop with members x, y, width, and height. </dd> | 
 | 143 |  | 
 | 144 | <dd> </dd> | 
 | 145 | <dt>exception</dt> | 
 | 146 | <dd>return any errors or warnings in this structure. </dd> | 
 | 147 |  | 
 | 148 | <dd>  </dd> | 
 | 149 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 150 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="CropImageToTiles">CropImageToTiles</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 151 |  | 
 | 152 | <p>CropImageToTiles() crops a single image, into a possible list of tiles. This may include a single sub-region of the image.  This basically applies all the normal geometry flags for Crop.</p> | 
 | 153 |  | 
 | 154 | <p>Image *CropImageToTiles(const Image *image, const RectangleInfo *crop_geometry, ExceptionInfo *exception)</p> | 
 | 155 |  | 
 | 156 | <p>A description of each parameter follows:</p> | 
 | 157 |  | 
 | 158 | <dd> | 
 | 159 | </dd> | 
 | 160 |  | 
 | 161 | <dd> </dd> | 
 | 162 | <dl class="dl-horizontal"> | 
 | 163 | <dt>image</dt> | 
 | 164 | <dd>the image The transformed image is returned as this parameter. </dd> | 
 | 165 |  | 
 | 166 | <dd> </dd> | 
 | 167 | <dt>crop_geometry</dt> | 
 | 168 | <dd>A crop geometry string. </dd> | 
 | 169 |  | 
 | 170 | <dd> </dd> | 
 | 171 | <dt>exception</dt> | 
 | 172 | <dd>return any errors or warnings in this structure. </dd> | 
 | 173 |  | 
 | 174 | <dd>  </dd> | 
 | 175 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 176 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="ExcerptImage">ExcerptImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 177 |  | 
 | 178 | <p>ExcerptImage() returns a excerpt of the image as defined by the geometry.</p> | 
 | 179 |  | 
 | 180 | <p>The format of the ExcerptImage method is:</p> | 
 | 181 |  | 
 | 182 | <pre class="text"> | 
 | 183 | Image *ExcerptImage(const Image *image,const RectangleInfo *geometry, | 
 | 184 |   ExceptionInfo *exception) | 
 | 185 | </pre> | 
 | 186 |  | 
 | 187 | <p>A description of each parameter follows:</p> | 
 | 188 |  | 
 | 189 | <dd> | 
 | 190 | </dd> | 
 | 191 |  | 
 | 192 | <dd> </dd> | 
 | 193 | <dl class="dl-horizontal"> | 
 | 194 | <dt>image</dt> | 
 | 195 | <dd>the image. </dd> | 
 | 196 |  | 
 | 197 | <dd> </dd> | 
 | 198 | <dt>geometry</dt> | 
 | 199 | <dd>Define the region of the image to extend with members x, y, width, and height. </dd> | 
 | 200 |  | 
 | 201 | <dd> </dd> | 
 | 202 | <dt>exception</dt> | 
 | 203 | <dd>return any errors or warnings in this structure. </dd> | 
 | 204 |  | 
 | 205 | <dd>  </dd> | 
 | 206 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 207 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="ExtentImage">ExtentImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 208 |  | 
 | 209 | <p>ExtentImage() extends the image as defined by the geometry, gravity, and image background color.  Set the (x,y) offset of the geometry to move the original image relative to the extended image.</p> | 
 | 210 |  | 
 | 211 | <p>The format of the ExtentImage method is:</p> | 
 | 212 |  | 
 | 213 | <pre class="text"> | 
 | 214 | Image *ExtentImage(const Image *image,const RectangleInfo *geometry, | 
 | 215 |   ExceptionInfo *exception) | 
 | 216 | </pre> | 
 | 217 |  | 
 | 218 | <p>A description of each parameter follows:</p> | 
 | 219 |  | 
 | 220 | <dd> | 
 | 221 | </dd> | 
 | 222 |  | 
 | 223 | <dd> </dd> | 
 | 224 | <dl class="dl-horizontal"> | 
 | 225 | <dt>image</dt> | 
 | 226 | <dd>the image. </dd> | 
 | 227 |  | 
 | 228 | <dd> </dd> | 
 | 229 | <dt>geometry</dt> | 
 | 230 | <dd>Define the region of the image to extend with members x, y, width, and height. </dd> | 
 | 231 |  | 
 | 232 | <dd> </dd> | 
 | 233 | <dt>exception</dt> | 
 | 234 | <dd>return any errors or warnings in this structure. </dd> | 
 | 235 |  | 
 | 236 | <dd>  </dd> | 
 | 237 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 238 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="FlipImage">FlipImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 239 |  | 
 | 240 | <p>FlipImage() creates a vertical mirror image by reflecting the pixels around the central x-axis.</p> | 
 | 241 |  | 
 | 242 | <p>The format of the FlipImage method is:</p> | 
 | 243 |  | 
 | 244 | <pre class="text"> | 
 | 245 | Image *FlipImage(const Image *image,ExceptionInfo *exception) | 
 | 246 | </pre> | 
 | 247 |  | 
 | 248 | <p>A description of each parameter follows:</p> | 
 | 249 |  | 
 | 250 | <dd> | 
 | 251 | </dd> | 
 | 252 |  | 
 | 253 | <dd> </dd> | 
 | 254 | <dl class="dl-horizontal"> | 
 | 255 | <dt>image</dt> | 
 | 256 | <dd>the image. </dd> | 
 | 257 |  | 
 | 258 | <dd> </dd> | 
 | 259 | <dt>exception</dt> | 
 | 260 | <dd>return any errors or warnings in this structure. </dd> | 
 | 261 |  | 
 | 262 | <dd>  </dd> | 
 | 263 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 264 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="FlopImage">FlopImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 265 |  | 
 | 266 | <p>FlopImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis.</p> | 
 | 267 |  | 
 | 268 | <p>The format of the FlopImage method is:</p> | 
 | 269 |  | 
 | 270 | <pre class="text"> | 
 | 271 | Image *FlopImage(const Image *image,ExceptionInfo *exception) | 
 | 272 | </pre> | 
 | 273 |  | 
 | 274 | <p>A description of each parameter follows:</p> | 
 | 275 |  | 
 | 276 | <dd> | 
 | 277 | </dd> | 
 | 278 |  | 
 | 279 | <dd> </dd> | 
 | 280 | <dl class="dl-horizontal"> | 
 | 281 | <dt>image</dt> | 
 | 282 | <dd>the image. </dd> | 
 | 283 |  | 
 | 284 | <dd> </dd> | 
 | 285 | <dt>exception</dt> | 
 | 286 | <dd>return any errors or warnings in this structure. </dd> | 
 | 287 |  | 
 | 288 | <dd>  </dd> | 
 | 289 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 290 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="RollImage">RollImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 291 |  | 
 | 292 | <p>RollImage() offsets an image as defined by x_offset and y_offset.</p> | 
 | 293 |  | 
 | 294 | <p>The format of the RollImage method is:</p> | 
 | 295 |  | 
 | 296 | <pre class="text"> | 
 | 297 | Image *RollImage(const Image *image,const ssize_t x_offset, | 
 | 298 |   const ssize_t y_offset,ExceptionInfo *exception) | 
 | 299 | </pre> | 
 | 300 |  | 
 | 301 | <p>A description of each parameter follows:</p> | 
 | 302 |  | 
 | 303 | <dd> | 
 | 304 | </dd> | 
 | 305 |  | 
 | 306 | <dd> </dd> | 
 | 307 | <dl class="dl-horizontal"> | 
 | 308 | <dt>image</dt> | 
 | 309 | <dd>the image. </dd> | 
 | 310 |  | 
 | 311 | <dd> </dd> | 
 | 312 | <dt>x_offset</dt> | 
 | 313 | <dd>the number of columns to roll in the horizontal direction. </dd> | 
 | 314 |  | 
 | 315 | <dd> </dd> | 
 | 316 | <dt>y_offset</dt> | 
 | 317 | <dd>the number of rows to roll in the vertical direction. </dd> | 
 | 318 |  | 
 | 319 | <dd> </dd> | 
 | 320 | <dt>exception</dt> | 
 | 321 | <dd>return any errors or warnings in this structure. </dd> | 
 | 322 |  | 
 | 323 | <dd>  </dd> | 
 | 324 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 325 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="ShaveImage">ShaveImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 326 |  | 
 | 327 | <p>ShaveImage() shaves pixels from the image edges.  It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p> | 
 | 328 |  | 
 | 329 | <p>The format of the ShaveImage method is:</p> | 
 | 330 |  | 
 | 331 | <pre class="text"> | 
 | 332 | Image *ShaveImage(const Image *image,const RectangleInfo *shave_info, | 
 | 333 |   ExceptionInfo *exception) | 
 | 334 | </pre> | 
 | 335 |  | 
 | 336 | <p>A description of each parameter follows:</p> | 
 | 337 |  | 
 | 338 | <dd> | 
 | 339 | </dd> | 
 | 340 |  | 
 | 341 | <dd> </dd> | 
 | 342 | <dl class="dl-horizontal"> | 
 | 343 | <dt>shave_image</dt> | 
 | 344 | <dd>Method ShaveImage returns a pointer to the shaved image.  A null image is returned if there is a memory shortage or if the image width or height is zero. </dd> | 
 | 345 |  | 
 | 346 | <dd> </dd> | 
 | 347 | <dt>image</dt> | 
 | 348 | <dd>the image. </dd> | 
 | 349 |  | 
 | 350 | <dd> </dd> | 
 | 351 | <dt>shave_info</dt> | 
 | 352 | <dd>Specifies a pointer to a RectangleInfo which defines the region of the image to crop. </dd> | 
 | 353 |  | 
 | 354 | <dd> </dd> | 
 | 355 | <dt>exception</dt> | 
 | 356 | <dd>return any errors or warnings in this structure. </dd> | 
 | 357 |  | 
 | 358 | <dd>  </dd> | 
 | 359 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 360 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="SpliceImage">SpliceImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 361 |  | 
 | 362 | <p>SpliceImage() splices a solid color into the image as defined by the geometry.</p> | 
 | 363 |  | 
 | 364 | <p>The format of the SpliceImage method is:</p> | 
 | 365 |  | 
 | 366 | <pre class="text"> | 
 | 367 | Image *SpliceImage(const Image *image,const RectangleInfo *geometry, | 
 | 368 |   ExceptionInfo *exception) | 
 | 369 | </pre> | 
 | 370 |  | 
 | 371 | <p>A description of each parameter follows:</p> | 
 | 372 |  | 
 | 373 | <dd> | 
 | 374 | </dd> | 
 | 375 |  | 
 | 376 | <dd> </dd> | 
 | 377 | <dl class="dl-horizontal"> | 
 | 378 | <dt>image</dt> | 
 | 379 | <dd>the image. </dd> | 
 | 380 |  | 
 | 381 | <dd> </dd> | 
 | 382 | <dt>geometry</dt> | 
 | 383 | <dd>Define the region of the image to splice with members x, y, width, and height. </dd> | 
 | 384 |  | 
 | 385 | <dd> </dd> | 
 | 386 | <dt>exception</dt> | 
 | 387 | <dd>return any errors or warnings in this structure. </dd> | 
 | 388 |  | 
 | 389 | <dd>  </dd> | 
 | 390 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 391 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="TransformImage">TransformImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 392 |  | 
 | 393 | <p>TransformImage() is a convenience method that behaves like ResizeImage() or CropImage() but accepts scaling and/or cropping information as a region geometry specification.  If the operation fails, the original image handle is left as is.</p> | 
 | 394 |  | 
 | 395 | <p>This should only be used for single images.</p> | 
 | 396 |  | 
 | 397 | <p>This function destroys what it assumes to be a single image list. If the input image is part of a larger list, all other images in that list will be simply 'lost', not destroyed.</p> | 
 | 398 |  | 
 | 399 | <p>Also if the crop generates a list of images only the first image is resized. And finally if the crop succeeds and the resize failed, you will get a cropped image, as well as a 'false' or 'failed' report.</p> | 
 | 400 |  | 
 | 401 | <p>This function and should probably be deprecated in favor of direct calls to CropImageToTiles() or ResizeImage(), as appropriate.</p> | 
 | 402 |  | 
 | 403 | <p>The format of the TransformImage method is:</p> | 
 | 404 |  | 
 | 405 | <pre class="text"> | 
 | 406 | MagickBooleanType TransformImage(Image **image,const char *crop_geometry, | 
 | 407 |   const char *image_geometry,ExceptionInfo *exception) | 
 | 408 | </pre> | 
 | 409 |  | 
 | 410 | <p>A description of each parameter follows:</p> | 
 | 411 |  | 
 | 412 | <dd> | 
 | 413 | </dd> | 
 | 414 |  | 
 | 415 | <dd> </dd> | 
 | 416 | <dl class="dl-horizontal"> | 
 | 417 | <dt>image</dt> | 
 | 418 | <dd>the image The transformed image is returned as this parameter. </dd> | 
 | 419 |  | 
 | 420 | <dd> </dd> | 
 | 421 | <dt>crop_geometry</dt> | 
 | 422 | <dd>A crop geometry string.  This geometry defines a subregion of the image to crop. </dd> | 
 | 423 |  | 
 | 424 | <dd> </dd> | 
 | 425 | <dt>image_geometry</dt> | 
 | 426 | <dd>An image geometry string.  This geometry defines the final size of the image. </dd> | 
 | 427 |  | 
 | 428 | <dd> </dd> | 
 | 429 | <dt>exception</dt> | 
 | 430 | <dd>return any errors or warnings in this structure. </dd> | 
 | 431 |  | 
 | 432 | <dd>  </dd> | 
 | 433 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 434 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="TransposeImage">TransposeImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 435 |  | 
 | 436 | <p>TransposeImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis while rotating them by 90 degrees.</p> | 
 | 437 |  | 
 | 438 | <p>The format of the TransposeImage method is:</p> | 
 | 439 |  | 
 | 440 | <pre class="text"> | 
 | 441 | Image *TransposeImage(const Image *image,ExceptionInfo *exception) | 
 | 442 | </pre> | 
 | 443 |  | 
 | 444 | <p>A description of each parameter follows:</p> | 
 | 445 |  | 
 | 446 | <dd> | 
 | 447 | </dd> | 
 | 448 |  | 
 | 449 | <dd> </dd> | 
 | 450 | <dl class="dl-horizontal"> | 
 | 451 | <dt>image</dt> | 
 | 452 | <dd>the image. </dd> | 
 | 453 |  | 
 | 454 | <dd> </dd> | 
 | 455 | <dt>exception</dt> | 
 | 456 | <dd>return any errors or warnings in this structure. </dd> | 
 | 457 |  | 
 | 458 | <dd>  </dd> | 
 | 459 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 460 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="TransverseImage">TransverseImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 461 |  | 
 | 462 | <p>TransverseImage() creates a vertical mirror image by reflecting the pixels around the central x-axis while rotating them by 270 degrees.</p> | 
 | 463 |  | 
 | 464 | <p>The format of the TransverseImage method is:</p> | 
 | 465 |  | 
 | 466 | <pre class="text"> | 
 | 467 | Image *TransverseImage(const Image *image,ExceptionInfo *exception) | 
 | 468 | </pre> | 
 | 469 |  | 
 | 470 | <p>A description of each parameter follows:</p> | 
 | 471 |  | 
 | 472 | <dd> | 
 | 473 | </dd> | 
 | 474 |  | 
 | 475 | <dd> </dd> | 
 | 476 | <dl class="dl-horizontal"> | 
 | 477 | <dt>image</dt> | 
 | 478 | <dd>the image. </dd> | 
 | 479 |  | 
 | 480 | <dd> </dd> | 
 | 481 | <dt>exception</dt> | 
 | 482 | <dd>return any errors or warnings in this structure. </dd> | 
 | 483 |  | 
 | 484 | <dd>  </dd> | 
 | 485 | </dl> | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 486 | <h2><a href="http://www.imagemagick.org/api/MagickCore/transform_8c.html" id="TrimImage">TrimImage</a></h2> | 
| cristy | cecc949 | 2015-06-09 16:53:50 +0000 | [diff] [blame] | 487 |  | 
 | 488 | <p>TrimImage() trims pixels from the image edges.  It allocates the memory necessary for the new Image structure and returns a pointer to the new image.</p> | 
 | 489 |  | 
 | 490 | <p>The format of the TrimImage method is:</p> | 
 | 491 |  | 
 | 492 | <pre class="text"> | 
 | 493 | Image *TrimImage(const Image *image,ExceptionInfo *exception) | 
 | 494 | </pre> | 
 | 495 |  | 
 | 496 | <p>A description of each parameter follows:</p> | 
 | 497 |  | 
 | 498 | <dd> | 
 | 499 | </dd> | 
 | 500 |  | 
 | 501 | <dd> </dd> | 
 | 502 | <dl class="dl-horizontal"> | 
 | 503 | <dt>image</dt> | 
 | 504 | <dd>the image. </dd> | 
 | 505 |  | 
 | 506 | <dd> </dd> | 
 | 507 | <dt>exception</dt> | 
 | 508 | <dd>return any errors or warnings in this structure. </dd> | 
 | 509 |  | 
 | 510 | <dd>  </dd> | 
 | 511 | </dl> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 512 | </div> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 513 |   <footer class="magick-footer"> | 
| cristy | 29f2c97 | 2015-07-28 13:37:46 +0000 | [diff] [blame] | 514 |     <p><a href="../support.html">Donate</a> • | 
 | 515 |      <a href="../sitemap.html">Sitemap</a> • | 
| cristy | 3818536 | 2015-05-07 20:09:56 +0000 | [diff] [blame] | 516 |     <a href="../links.html">Related</a> • | 
| cristy | 29f2c97 | 2015-07-28 13:37:46 +0000 | [diff] [blame] | 517 |     <a href="../architecture.html">Architecture</a> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 518 | </p> | 
 | 519 |     <p><a href="transform.html#">Back to top</a> • | 
| cristy | ea2793e | 2015-05-31 16:52:26 +0000 | [diff] [blame] | 520 |     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> • | 
| cristy | 5b8fe76 | 2015-06-09 16:24:03 +0000 | [diff] [blame] | 521 |     <a href="http://nextgen.imagemagick.org/script/contact.php">Contact Us</a></p> | 
| Cristy | 600583b | 2016-01-02 14:00:46 -0500 | [diff] [blame] | 522 |         <p><small>©  1999-2016 ImageMagick Studio LLC</small></p> | 
| cristy | 44443b9 | 2015-05-05 00:06:07 +0000 | [diff] [blame] | 523 |   </footer> | 
 | 524 | </div><!-- /.container --> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 525 |  | 
| Cristy | e93be68 | 2015-11-26 09:07:51 -0500 | [diff] [blame] | 526 |   <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script> | 
| cristy | 29f2c97 | 2015-07-28 13:37:46 +0000 | [diff] [blame] | 527 |   <script src="http://nextgen.imagemagick.org/js/magick.html"></script> | 
| cristy | 44cbd48 | 2013-08-04 20:53:36 +0000 | [diff] [blame] | 528 | </div> | 
| cristy | 06f63f2 | 2012-10-31 00:50:07 +0000 | [diff] [blame] | 529 | </body> | 
| cristy | 5a367e4 | 2015-05-05 12:39:18 +0000 | [diff] [blame] | 530 | </html> |