Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 851dbceb0a51cbcd3ed512f074e9f2d797b7cbc1 / . / www / api / transform.html
blob: f3652965d1ebc9fea3c887eb277abd2bf286040e [file] [log] [blame]
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
cristy2c839602010-04-03 02:32:08 +0000[diff] [blame]3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]4<head>
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]5 <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
7 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]8 <style type="text/css" media="all">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]9 @import url("../../www/magick.css");
cristy3de29cc2010-04-15 02:34:44 +0000[diff] [blame]10 </style>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]11 <link rel="shortcut icon" href="../../images/wand.ico" type="images/vnd.microsoft.icon"/>
12 <title>ImageMagick: MagickCore, C API for ImageMagick: Transform an Image</title>
13 <meta http-equiv="Content-Language" content="en-US"/>
14 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
15 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
16 <meta name="Generator" content="PHP"/>
17 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, transform, an, image, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
18 <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves. ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems. The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
19 <meta name="Rating" content="GENERAL"/>
20 <meta name="Robots" content="INDEX, FOLLOW"/>
21 <meta name="Generator" content="ImageMagick Studio LLC"/>
22 <meta name="Author" content="ImageMagick Studio LLC"/>
23 <meta name="Revisit-after" content="2 DAYS"/>
24 <meta name="Resource-type" content="document"/>
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]25 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]26 <meta name="Distribution" content="Global"/>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]27</head>
28
29<body id="www-imagemagick-org">
30<div class="titlebar">
31<a href="../../index.html">
32 <img src="../../images/script.png" alt="[ImageMagick]"
33 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
34<a href="http://www.networkredux.com">
35 <img src="../../images/networkredux.png" alt="[sponsor]"
36 style="margin: 45px auto; border: 0px; float: left;" /></a>
37<a href="http://www.imagemagick.org/discourse-server/">
38 <img src="../../images/logo.jpg" alt=""
39 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
40<a href="../../index.html">
41 <img src="../../images/sprite.jpg" alt=""
42 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
43</div>
44
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]45<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]46
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]47<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]48 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]49</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]50<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]51<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]52 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
53</div>
54<div class="sub">
55 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
56</div>
57<div class="sub">
58 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
59</div>
60<div class="sub">
61 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
62</div>
63<div class="sep"></div>
64<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]65 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66</div>
67<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]68 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]69</div>
70<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]71 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]72</div>
73<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]74 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]75</div>
76<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]77 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]78</div>
79<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]80 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]81</div>
82<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]83 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]84</div>
85<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]86 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]87</div>
88<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]89 <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]90</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]91<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]92<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]93 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]94</div>
95<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]96 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]97</div>
98<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]99 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100 </div>
101<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]102 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]104<div class="menu">
105 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
106</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]107<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]108 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]112 <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]113</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]114<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]115<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]116 <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]117</div>
118<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]119 <a title="Site Map: Links"href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]121<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]123 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124
125<div class="sponsbox">
126<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame^]127 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
128</div>
129<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]130 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
cristy0391e8d2010-04-10 01:36:10 +0000[diff] [blame]131</div>
132<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]133 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristy8f900122010-03-05 15:26:31 +0000[diff] [blame]134</div>
135<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]136 <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristyc1c61662009-09-30 14:04:37 +0000[diff] [blame]137</div>
138<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]139 <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
cristy916e1922009-10-01 12:52:47 +0000[diff] [blame]140</div>
141<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]142 <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]143</div>
144<div class="sponsor">
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]145 <a title="Sponsor: Free Catalogs" href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 20120801000600 -->
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]146</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
148</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]149</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]150
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]151<div class="eastbar">
152 <script type="text/javascript">
153 <!--
154 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]155 google_ad_slot = "0574824969";
156 google_ad_width = 160;
157 google_ad_height = 600;
158 //-->
159 </script>
160 <script type="text/javascript"
161 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
162 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]163</div>
164
165<div class="main">
166
cristyf1196bb2010-02-13 21:18:03 +0000[diff] [blame]167<p class="navigation-index">[<a href="#ChopImage">ChopImage</a> &bull; <a href="#CropImage">CropImage</a> &bull; <a href="#ExcerptImage">ExcerptImage</a> &bull; <a href="#ExtentImage">ExtentImage</a> &bull; <a href="#FlipImage">FlipImage</a> &bull; <a href="#FlopImage">FlopImage</a> &bull; <a href="#RollImage">RollImage</a> &bull; <a href="#ShaveImage">ShaveImage</a> &bull; <a href="#SpliceImage">SpliceImage</a> &bull; <a href="#TransformImage">TransformImage</a> &bull; <a href="#TransformImages">TransformImages</a> &bull; <a href="#TransposeImage">TransposeImage</a> &bull; <a href="#TransverseImage">TransverseImage</a> &bull; <a href="#TrimImage">TrimImage</a>]</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]168
169<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
cristyf1196bb2010-02-13 21:18:03 +0000[diff] [blame]170_8c.html" target="source" name="ChopImage">ChopImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]171<div class="doc-section">
172
cristyf1196bb2010-02-13 21:18:03 +0000[diff] [blame]173<p>ChopImage() removes a region of an image and collapses the image to occupy the removed portion.</p></ol>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]174
175<p>The format of the ChopImage method is:</p>
176
177<pre class="code">
178 Image *ChopImage(const Image *image,const RectangleInfo *chop_info)
179 ExceptionInfo *exception)
180</pre>
181
182<p>A description of each parameter follows:</p></ol>
183
184<h5>image</h5>
185<ol><p>the image.</p></ol>
186
187<h5>chop_info</h5>
188<ol><p>Define the region of the image to chop.</p></ol>
189
190<h5>exception</h5>
191<ol><p>return any errors or warnings in this structure.</p></ol>
192
193 </div>
194<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
195_8c.html" target="source" name="CropImage">CropImage</a></h2>
196<div class="doc-section">
197
198<p>CropImage() extracts a region of the image starting at the offset defined by geometry.</p></ol>
199
200<p>The format of the CropImage method is:</p>
201
202<pre class="code">
203 Image *CropImage(const Image *image,const RectangleInfo *geometry,
204 ExceptionInfo *exception)
205</pre>
206
207<p>A description of each parameter follows:</p></ol>
208
209<h5>image</h5>
210<ol><p>the image.</p></ol>
211
212<h5>geometry</h5>
213<ol><p>Define the region of the image to crop with members x, y, width, and height.</p></ol>
214
215<h5>exception</h5>
216<ol><p>return any errors or warnings in this structure.</p></ol>
217
218 </div>
219<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
220_8c.html" target="source" name="ExcerptImage">ExcerptImage</a></h2>
221<div class="doc-section">
222
223<p>ExcerptImage() returns a excerpt of the image as defined by the geometry.</p></ol>
224
225<p>The format of the ExcerptImage method is:</p>
226
227<pre class="code">
228 Image *ExcerptImage(const Image *image,const RectangleInfo *geometry,
229 ExceptionInfo *exception)
230</pre>
231
232<p>A description of each parameter follows:</p></ol>
233
234<h5>image</h5>
235<ol><p>the image.</p></ol>
236
237<h5>geometry</h5>
238<ol><p>Define the region of the image to extend with members x, y, width, and height.</p></ol>
239
240<h5>exception</h5>
241<ol><p>return any errors or warnings in this structure.</p></ol>
242
243 </div>
244<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
245_8c.html" target="source" name="ExtentImage">ExtentImage</a></h2>
246<div class="doc-section">
247
248<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></ol>
249
250<p>The format of the ExtentImage method is:</p>
251
252<pre class="code">
253 Image *ExtentImage(const Image *image,const RectangleInfo *geometry,
254 ExceptionInfo *exception)
255</pre>
256
257<p>A description of each parameter follows:</p></ol>
258
259<h5>image</h5>
260<ol><p>the image.</p></ol>
261
262<h5>geometry</h5>
263<ol><p>Define the region of the image to extend with members x, y, width, and height.</p></ol>
264
265<h5>exception</h5>
266<ol><p>return any errors or warnings in this structure.</p></ol>
267
268 </div>
269<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
270_8c.html" target="source" name="FlipImage">FlipImage</a></h2>
271<div class="doc-section">
272
273<p>FlipImage() creates a vertical mirror image by reflecting the pixels around the central x-axis.</p></ol>
274
275<p>The format of the FlipImage method is:</p>
276
277<pre class="code">
278 Image *FlipImage(const Image *image,ExceptionInfo *exception)
279</pre>
280
281<p>A description of each parameter follows:</p></ol>
282
283<h5>image</h5>
284<ol><p>the image.</p></ol>
285
286<h5>exception</h5>
287<ol><p>return any errors or warnings in this structure.</p></ol>
288
289 </div>
290<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
291_8c.html" target="source" name="FlopImage">FlopImage</a></h2>
292<div class="doc-section">
293
294<p>FlopImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis.</p></ol>
295
296<p>The format of the FlopImage method is:</p>
297
298<pre class="code">
299 Image *FlopImage(const Image *image,ExceptionInfo *exception)
300</pre>
301
302<p>A description of each parameter follows:</p></ol>
303
304<h5>image</h5>
305<ol><p>the image.</p></ol>
306
307<h5>exception</h5>
308<ol><p>return any errors or warnings in this structure.</p></ol>
309
310 </div>
311<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
312_8c.html" target="source" name="RollImage">RollImage</a></h2>
313<div class="doc-section">
314
315<p>RollImage() offsets an image as defined by x_offset and y_offset.</p></ol>
316
317<p>The format of the RollImage method is:</p>
318
319<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]320 Image *RollImage(const Image *image,const ssize_t x_offset,
321 const ssize_t y_offset,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]322</pre>
323
324<p>A description of each parameter follows:</p></ol>
325
326<h5>image</h5>
327<ol><p>the image.</p></ol>
328
329<h5>x_offset</h5>
330<ol><p>the number of columns to roll in the horizontal direction.</p></ol>
331
332<h5>y_offset</h5>
333<ol><p>the number of rows to roll in the vertical direction.</p></ol>
334
335<h5>exception</h5>
336<ol><p>return any errors or warnings in this structure.</p></ol>
337
338 </div>
339<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
340_8c.html" target="source" name="ShaveImage">ShaveImage</a></h2>
341<div class="doc-section">
342
343<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></ol>
344
345<p>The format of the ShaveImage method is:</p>
346
347<pre class="code">
348 Image *ShaveImage(const Image *image,const RectangleInfo *shave_info,
349 ExceptionInfo *exception)
350</pre>
351
352<p>A description of each parameter follows:</p></ol>
353
354<h5>shave_image</h5>
355<ol><p>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.</p></ol>
356
357<h5>image</h5>
358<ol><p>the image.</p></ol>
359
360<h5>shave_info</h5>
361<ol><p>Specifies a pointer to a RectangleInfo which defines the region of the image to crop.</p></ol>
362
363<h5>exception</h5>
364<ol><p>return any errors or warnings in this structure.</p></ol>
365
366 </div>
367<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
368_8c.html" target="source" name="SpliceImage">SpliceImage</a></h2>
369<div class="doc-section">
370
371<p>SpliceImage() splices a solid color into the image as defined by the geometry.</p></ol>
372
373<p>The format of the SpliceImage method is:</p>
374
375<pre class="code">
376 Image *SpliceImage(const Image *image,const RectangleInfo *geometry,
377 ExceptionInfo *exception)
378</pre>
379
380<p>A description of each parameter follows:</p></ol>
381
382<h5>image</h5>
383<ol><p>the image.</p></ol>
384
385<h5>geometry</h5>
386<ol><p>Define the region of the image to splice with members x, y, width, and height.</p></ol>
387
388<h5>exception</h5>
389<ol><p>return any errors or warnings in this structure.</p></ol>
390
391 </div>
392<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
393_8c.html" target="source" name="TransformImage">TransformImage</a></h2>
394<div class="doc-section">
395
396<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 returned.</p></ol>
397
398<p>The format of the TransformImage method is:</p>
399
400<pre class="code">
401 MagickBooleanType TransformImage(Image **image,const char *crop_geometry,
402 const char *image_geometry)
403</pre>
404
405<p>A description of each parameter follows:</p></ol>
406
407<h5>image</h5>
408<ol><p>the image The transformed image is returned as this parameter.</p></ol>
409
410<h5>crop_geometry</h5>
411<ol><p>A crop geometry string. This geometry defines a subregion of the image to crop.</p></ol>
412
413<h5>image_geometry</h5>
414<ol><p>An image geometry string. This geometry defines the final size of the image.</p></ol>
415
416 </div>
417<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
418_8c.html" target="source" name="TransformImages">TransformImages</a></h2>
419<div class="doc-section">
420
421<p>TransformImages() calls TransformImage() on each image of a sequence.</p></ol>
422
423<p>The format of the TransformImage method is:</p>
424
425<pre class="code">
426 MagickBooleanType TransformImages(Image **image,
427 const char *crop_geometry,const char *image_geometry)
428</pre>
429
430<p>A description of each parameter follows:</p></ol>
431
432<h5>image</h5>
433<ol><p>the image The transformed image is returned as this parameter.</p></ol>
434
435<h5>crop_geometry</h5>
436<ol><p>A crop geometry string. This geometry defines a subregion of the image to crop.</p></ol>
437
438<h5>image_geometry</h5>
439<ol><p>An image geometry string. This geometry defines the final size of the image.</p></ol>
440
441 </div>
442<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
443_8c.html" target="source" name="TransposeImage">TransposeImage</a></h2>
444<div class="doc-section">
445
446<p>TransposeImage() creates a horizontal mirror image by reflecting the pixels around the central y-axis while rotating them by 90 degrees.</p></ol>
447
448<p>The format of the TransposeImage method is:</p>
449
450<pre class="code">
451 Image *TransposeImage(const Image *image,ExceptionInfo *exception)
452</pre>
453
454<p>A description of each parameter follows:</p></ol>
455
456<h5>image</h5>
457<ol><p>the image.</p></ol>
458
459<h5>exception</h5>
460<ol><p>return any errors or warnings in this structure.</p></ol>
461
462 </div>
463<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
464_8c.html" target="source" name="TransverseImage">TransverseImage</a></h2>
465<div class="doc-section">
466
467<p>TransverseImage() creates a vertical mirror image by reflecting the pixels around the central x-axis while rotating them by 270 degrees.</p></ol>
468
469<p>The format of the TransverseImage method is:</p>
470
471<pre class="code">
472 Image *TransverseImage(const Image *image,ExceptionInfo *exception)
473</pre>
474
475<p>A description of each parameter follows:</p></ol>
476
477<h5>image</h5>
478<ol><p>the image.</p></ol>
479
480<h5>exception</h5>
481<ol><p>return any errors or warnings in this structure.</p></ol>
482
483 </div>
484<h2><a href="http://www.imagemagick.org/api/MagickCore/transform
485_8c.html" target="source" name="TrimImage">TrimImage</a></h2>
486<div class="doc-section">
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></ol>
489
490<p>The format of the TrimImage method is:</p>
491
492<pre class="code">
493 Image *TrimImage(const Image *image,ExceptionInfo *exception)
494</pre>
495
496<p>A description of each parameter follows:</p></ol>
497
498<h5>image</h5>
499<ol><p>the image.</p></ol>
500
501<h5>exception</h5>
502<ol><p>return any errors or warnings in this structure.</p></ol>
503
504 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]505
506</div>
507
508<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]509 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]510 <span id="linkbar-center">
511 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]512 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]513 </span>
514 <span id="linkbar-east">&nbsp;</span>
515 </div>
516 <div class="footer">
517 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
518 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
519 </div>
520 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]521 <script type="text/javascript">
522 var _gaq = _gaq || [];
523 _gaq.push(['_setAccount', 'UA-17690367-1']);
524 _gaq.push(['_trackPageview']);
525
526 (function() {
527 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
528 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
529 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
530 })();
531 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]532</body>
533</html>