Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / f392ff70347e6f3546cadaeb8e8f9f35d93aab7c / . / www / api / resize.html
blob: 5f9f788d07813b15d272ba4ef3c71181cbc845e0 [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>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
7 <title>ImageMagick: MagickCore, C API for ImageMagick: Resize an Image</title/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]8 <meta http-equiv="Content-Language" content="en-US"/>
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
10 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]11 <meta name="Application-name" content="ImageMagick"/>
12 <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."/>
13 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]14 <meta name="Generator" content="PHP"/>
15 <meta name="Keywords" content="magickcore, c, api, for, imagemagick:, resize, an, image, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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"/>
cristy16af1cb2009-12-11 21:38:29 +0000[diff] [blame]22 <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]23 <meta name="Distribution" content="Global"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]24 <link rel="icon" href="../../images/wand.png" sizes="32x32"/>
25 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
26 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
27 <style type="text/css" media="all">
28 @import url("../../www/magick.css");
29 </style>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]30</head>
31
32<body id="www-imagemagick-org">
33<div class="titlebar">
34<a href="../../index.html">
35 <img src="../../images/script.png" alt="[ImageMagick]"
36 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
37<a href="http://www.networkredux.com">
38 <img src="../../images/networkredux.png" alt="[sponsor]"
39 style="margin: 45px auto; border: 0px; float: left;" /></a>
40<a href="http://www.imagemagick.org/discourse-server/">
41 <img src="../../images/logo.jpg" alt=""
42 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
43<a href="../../index.html">
44 <img src="../../images/sprite.jpg" alt=""
45 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
46</div>
47
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]48<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]49
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]50<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]51 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]52</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]53<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]54<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]55 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
56</div>
57<div class="sub">
58 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
59</div>
60<div class="sub">
61 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
62</div>
63<div class="sub">
64 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
65</div>
66<div class="sep"></div>
67<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]68 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</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: Processing" href="../../www/command-line-processing.html">Processing</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: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]75</div>
76<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]77 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]78</div>
79<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]80 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</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: MagickWand" href="../../www/magick-wand.html">MagickWand</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: MagickCore" href="../../www/magick-core.html">MagickCore</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: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]90</div>
91<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]92 <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]93</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]94<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]95<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]96 <a title="Install from Source" href="../../www/install-source.html">Install from Source</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: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100</div>
101<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]102 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103 </div>
104<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]105 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]106</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]107<div class="menu">
108 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
109</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]110<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]111 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]112</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]113<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]114<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]115 <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]116</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]117<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]118<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]119 <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]120</div>
121<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]122 <a title="Site Map: Links"href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]123</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]124<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]125<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]126 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]127
128<div class="sponsbox">
129<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]130 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
131</div>
132<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]133 <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
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: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]137</div>
138<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]139 <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
cristy2744bd92009-11-08 22:57:52 +0000[diff] [blame]140</div>
141<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]142 <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
cristyb4c03bb2009-09-27 13:55:46 +0000[diff] [blame]143</div>
144<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]145 <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
146</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]147<div class="sponsor">
cristy05f0f212010-08-14 23:32:38 +0000[diff] [blame]148 <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]149</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]150</div>
151</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]152</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]153
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]154<div class="eastbar">
155 <script type="text/javascript">
156 <!--
157 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]158 google_ad_slot = "0574824969";
159 google_ad_width = 160;
160 google_ad_height = 600;
161 //-->
162 </script>
163 <script type="text/javascript"
164 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
165 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]166</div>
167
168<div class="main">
169
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]170<p class="navigation-index">[<a href="#AdaptiveResizeImage">AdaptiveResizeImage</a> &bull; <a href="#MagnifyImage">MagnifyImage</a> &bull; <a href="#MinifyImage">MinifyImage</a> &bull; <a href="#ResampleImage">ResampleImage</a> &bull; <a href="#LiquidRescaleImage">LiquidRescaleImage</a> &bull; <a href="#ResizeImage">ResizeImage</a> &bull; <a href="#SampleImage">SampleImage</a> &bull; <a href="#ScaleImage">ScaleImage</a> &bull; <a href="#ThumbnailImage">ThumbnailImage</a> &bull; <a href="#ZoomImage">ZoomImage</a>]</p>
171
172<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
173_8c.html" target="source" name="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
174<div class="doc-section">
175
176<p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p></ol>
177
178<p>The format of the AdaptiveResizeImage method is:</p>
179
180<pre class="code">
181 Image *AdaptiveResizeImage(const Image *image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]182 const size_t columns,const size_t rows,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]183 ExceptionInfo *exception)
184</pre>
185
186<p>A description of each parameter follows:</p></ol>
187
188<h5>image</h5>
189<ol><p>the image.</p></ol>
190
191<h5>columns</h5>
192<ol><p>the number of columns in the resized image.</p></ol>
193
194<h5>rows</h5>
195<ol><p>the number of rows in the resized image.</p></ol>
196
197<h5>exception</h5>
198<ol><p>return any errors or warnings in this structure.</p></ol>
199
200 </div>
201<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
202_8c.html" target="source" name="MagnifyImage">MagnifyImage</a></h2>
203<div class="doc-section">
204
205<p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p></ol>
206
207<p>The format of the MagnifyImage method is:</p>
208
209<pre class="code">
210 Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
211</pre>
212
213<p>A description of each parameter follows:</p></ol>
214
215<h5>image</h5>
216<ol><p>the image.</p></ol>
217
218<h5>exception</h5>
219<ol><p>return any errors or warnings in this structure.</p></ol>
220
221 </div>
222<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
223_8c.html" target="source" name="MinifyImage">MinifyImage</a></h2>
224<div class="doc-section">
225
226<p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p></ol>
227
228<p>The format of the MinifyImage method is:</p>
229
230<pre class="code">
231 Image *MinifyImage(const Image *image,ExceptionInfo *exception)
232</pre>
233
234<p>A description of each parameter follows:</p></ol>
235
236<h5>image</h5>
237<ol><p>the image.</p></ol>
238
239<h5>exception</h5>
240<ol><p>return any errors or warnings in this structure.</p></ol>
241
242 </div>
243<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
244_8c.html" target="source" name="ResampleImage">ResampleImage</a></h2>
245<div class="doc-section">
246
247<p>ResampleImage() resize image in terms of its pixel size, so that when displayed at the given resolution it will be the same size in terms of real world units as the original image at the original resolution.</p></ol>
248
249<p>The format of the ResampleImage method is:</p>
250
251<pre class="code">
252 Image *ResampleImage(Image *image,const double x_resolution,
253 const double y_resolution,const FilterTypes filter,const double blur,
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 to be resized to fit the given resolution.</p></ol>
261
262<h5>x_resolution</h5>
263<ol><p>the new image x resolution.</p></ol>
264
265<h5>y_resolution</h5>
266<ol><p>the new image y resolution.</p></ol>
267
268<h5>filter</h5>
269<ol><p>Image filter to use.</p></ol>
270
271<h5>blur</h5>
272<ol><p>the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
273
274 </div>
275<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
276_8c.html" target="source" name="LiquidRescaleImage">LiquidRescaleImage</a></h2>
277<div class="doc-section">
278
279<p>LiquidRescaleImage() rescales image with seam carving.</p></ol>
280
281<p>The format of the LiquidRescaleImage method is:</p>
282
283<pre class="code">
284 Image *LiquidRescaleImage(const Image *image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]285 const size_t columns,const size_t rows,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]286 const double delta_x,const double rigidity,ExceptionInfo *exception)
287</pre>
288
289<p>A description of each parameter follows:</p></ol>
290
291<h5>image</h5>
292<ol><p>the image.</p></ol>
293
294<h5>columns</h5>
295<ol><p>the number of columns in the rescaled image.</p></ol>
296
297<h5>rows</h5>
298<ol><p>the number of rows in the rescaled image.</p></ol>
299
300<h5>delta_x</h5>
301<ol><p>maximum seam transversal step (0 means straight seams).</p></ol>
302
303<h5>rigidity</h5>
304<ol><p>introduce a bias for non-straight seams (typically 0).</p></ol>
305
306<h5>exception</h5>
307<ol><p>return any errors or warnings in this structure.</p></ol>
308
309 </div>
310<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
311_8c.html" target="source" name="ResizeImage">ResizeImage</a></h2>
312<div class="doc-section">
313
314<p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo() ).</p></ol>
315
316<p>If an undefined filter is given the filter defaults to Mitchell for a colormapped image, a image with a matte channel, or if the image is enlarged. Otherwise the filter defaults to a Lanczos.</p></ol>
317
318<p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p></ol>
319
320<p>The format of the ResizeImage method is:</p>
321
322<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]323 Image *ResizeImage(Image *image,const size_t columns,
324 const size_t rows,const FilterTypes filter,const double blur,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]325 ExceptionInfo *exception)
326</pre>
327
328<p>A description of each parameter follows:</p></ol>
329
330<h5>image</h5>
331<ol><p>the image.</p></ol>
332
333<h5>columns</h5>
334<ol><p>the number of columns in the scaled image.</p></ol>
335
336<h5>rows</h5>
337<ol><p>the number of rows in the scaled image.</p></ol>
338
339<h5>filter</h5>
340<ol><p>Image filter to use.</p></ol>
341
342<h5>blur</h5>
343<ol><p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p></ol>
344
345<h5>exception</h5>
346<ol><p>return any errors or warnings in this structure.</p></ol>
347
348 </div>
349<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
350_8c.html" target="source" name="SampleImage">SampleImage</a></h2>
351<div class="doc-section">
352
353<p>SampleImage() scales an image to the desired dimensions with pixel sampling. Unlike other scaling methods, this method does not introduce any additional color into the scaled image.</p></ol>
354
355<p>The format of the SampleImage method is:</p>
356
357<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]358 Image *SampleImage(const Image *image,const size_t columns,
359 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]360</pre>
361
362<p>A description of each parameter follows:</p></ol>
363
364<h5>image</h5>
365<ol><p>the image.</p></ol>
366
367<h5>columns</h5>
368<ol><p>the number of columns in the sampled image.</p></ol>
369
370<h5>rows</h5>
371<ol><p>the number of rows in the sampled image.</p></ol>
372
373<h5>exception</h5>
374<ol><p>return any errors or warnings in this structure.</p></ol>
375
376 </div>
377<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
378_8c.html" target="source" name="ScaleImage">ScaleImage</a></h2>
379<div class="doc-section">
380
381<p>ScaleImage() changes the size of an image to the given dimensions.</p></ol>
382
383<p>The format of the ScaleImage method is:</p>
384
385<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]386 Image *ScaleImage(const Image *image,const size_t columns,
387 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]388</pre>
389
390<p>A description of each parameter follows:</p></ol>
391
392<h5>image</h5>
393<ol><p>the image.</p></ol>
394
395<h5>columns</h5>
396<ol><p>the number of columns in the scaled image.</p></ol>
397
398<h5>rows</h5>
399<ol><p>the number of rows in the scaled image.</p></ol>
400
401<h5>exception</h5>
402<ol><p>return any errors or warnings in this structure.</p></ol>
403
404 </div>
405<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
406_8c.html" target="source" name="ThumbnailImage">ThumbnailImage</a></h2>
407<div class="doc-section">
408
409<p>ThumbnailImage() changes the size of an image to the given dimensions and removes any associated profiles. The goal is to produce small low cost thumbnail images suited for display on the Web.</p></ol>
410
411<p>The format of the ThumbnailImage method is:</p>
412
413<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]414 Image *ThumbnailImage(const Image *image,const size_t columns,
415 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]416</pre>
417
418<p>A description of each parameter follows:</p></ol>
419
420<h5>image</h5>
421<ol><p>the image.</p></ol>
422
423<h5>columns</h5>
424<ol><p>the number of columns in the scaled image.</p></ol>
425
426<h5>rows</h5>
427<ol><p>the number of rows in the scaled image.</p></ol>
428
429<h5>exception</h5>
430<ol><p>return any errors or warnings in this structure.</p></ol>
431
432 </div>
433<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
434_8c.html" target="source" name="ZoomImage">ZoomImage</a></h2>
435<div class="doc-section">
436
437<p>ZoomImage() creates a new image that is a scaled size of an existing one. It allocates the memory necessary for the new Image structure and returns a pointer to the new image. The Point filter gives fast pixel replication, Triangle is equivalent to bi-linear interpolation, and Mitchel giver slower, very high-quality results. See Graphic Gems III for details on this algorithm.</p></ol>
438
439<p>The filter member of the Image structure specifies which image filter to use. Blur specifies the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
440
441<p>The format of the ZoomImage method is:</p>
442
443<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]444 Image *ZoomImage(const Image *image,const size_t columns,
445 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]446</pre>
447
448<p>A description of each parameter follows:</p></ol>
449
450<h5>image</h5>
451<ol><p>the image.</p></ol>
452
453<h5>columns</h5>
454<ol><p>An integer that specifies the number of columns in the zoom image.</p></ol>
455
456<h5>rows</h5>
457<ol><p>An integer that specifies the number of rows in the scaled image.</p></ol>
458
459<h5>exception</h5>
460<ol><p>return any errors or warnings in this structure.</p></ol>
461
462 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]463
464</div>
465
466<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]467 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]468 <span id="linkbar-center">
469 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]470 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]471 </span>
472 <span id="linkbar-east">&nbsp;</span>
473 </div>
474 <div class="footer">
475 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
476 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
477 </div>
478 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]479 <script type="text/javascript">
480 var _gaq = _gaq || [];
481 _gaq.push(['_setAccount', 'UA-17690367-1']);
482 _gaq.push(['_trackPageview']);
483
484 (function() {
485 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
486 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
487 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
488 })();
489 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]490</body>
491</html>