Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 56225739f711bb40d0253894070bc246366baed7 / . / www / api / resize.html
blob: e19e03849617973c4fc32b0be1b1081b8f118d4a [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">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]130 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
131</div>
132<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]133 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
134</div>
135<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]136 <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]137</div>
138<div class="sponsor">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]139 <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
cristy1f9e1ed2009-11-18 04:09:38 +0000[diff] [blame]140</div>
141<div class="sponsor">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]142 <a title="Sponsor: Diamonds are a Girls Best Friend" href="http://www.schmuck.org">Diamonds are a Girls Best Friend</a><!-- 201101010600 Peterssen-->
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>
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
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]167<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>
168
169<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
170_8c.html" target="source" name="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
171<div class="doc-section">
172
173<p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p></ol>
174
175<p>The format of the AdaptiveResizeImage method is:</p>
176
177<pre class="code">
cristybc9539a2010-08-16 18:06:20 +0000[diff] [blame]178 Image *AdaptiveResizeImage(const Image *image,const size_t columns,
179 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]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>columns</h5>
188<ol><p>the number of columns in the resized image.</p></ol>
189
190<h5>rows</h5>
191<ol><p>the number of rows in the resized image.</p></ol>
192
193<h5>exception</h5>
194<ol><p>return any errors or warnings in this structure.</p></ol>
195
196 </div>
197<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
198_8c.html" target="source" name="MagnifyImage">MagnifyImage</a></h2>
199<div class="doc-section">
200
201<p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p></ol>
202
203<p>The format of the MagnifyImage method is:</p>
204
205<pre class="code">
206 Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
207</pre>
208
209<p>A description of each parameter follows:</p></ol>
210
211<h5>image</h5>
212<ol><p>the image.</p></ol>
213
214<h5>exception</h5>
215<ol><p>return any errors or warnings in this structure.</p></ol>
216
217 </div>
218<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
219_8c.html" target="source" name="MinifyImage">MinifyImage</a></h2>
220<div class="doc-section">
221
222<p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p></ol>
223
224<p>The format of the MinifyImage method is:</p>
225
226<pre class="code">
227 Image *MinifyImage(const Image *image,ExceptionInfo *exception)
228</pre>
229
230<p>A description of each parameter follows:</p></ol>
231
232<h5>image</h5>
233<ol><p>the image.</p></ol>
234
235<h5>exception</h5>
236<ol><p>return any errors or warnings in this structure.</p></ol>
237
238 </div>
239<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
240_8c.html" target="source" name="ResampleImage">ResampleImage</a></h2>
241<div class="doc-section">
242
243<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>
244
245<p>The format of the ResampleImage method is:</p>
246
247<pre class="code">
248 Image *ResampleImage(Image *image,const double x_resolution,
249 const double y_resolution,const FilterTypes filter,const double blur,
250 ExceptionInfo *exception)
251</pre>
252
253<p>A description of each parameter follows:</p></ol>
254
255<h5>image</h5>
256<ol><p>the image to be resized to fit the given resolution.</p></ol>
257
258<h5>x_resolution</h5>
259<ol><p>the new image x resolution.</p></ol>
260
261<h5>y_resolution</h5>
262<ol><p>the new image y resolution.</p></ol>
263
264<h5>filter</h5>
265<ol><p>Image filter to use.</p></ol>
266
267<h5>blur</h5>
268<ol><p>the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
269
270 </div>
271<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
272_8c.html" target="source" name="LiquidRescaleImage">LiquidRescaleImage</a></h2>
273<div class="doc-section">
274
275<p>LiquidRescaleImage() rescales image with seam carving.</p></ol>
276
277<p>The format of the LiquidRescaleImage method is:</p>
278
279<pre class="code">
280 Image *LiquidRescaleImage(const Image *image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]281 const size_t columns,const size_t rows,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]282 const double delta_x,const double rigidity,ExceptionInfo *exception)
283</pre>
284
285<p>A description of each parameter follows:</p></ol>
286
287<h5>image</h5>
288<ol><p>the image.</p></ol>
289
290<h5>columns</h5>
291<ol><p>the number of columns in the rescaled image.</p></ol>
292
293<h5>rows</h5>
294<ol><p>the number of rows in the rescaled image.</p></ol>
295
296<h5>delta_x</h5>
297<ol><p>maximum seam transversal step (0 means straight seams).</p></ol>
298
299<h5>rigidity</h5>
300<ol><p>introduce a bias for non-straight seams (typically 0).</p></ol>
301
302<h5>exception</h5>
303<ol><p>return any errors or warnings in this structure.</p></ol>
304
305 </div>
306<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
307_8c.html" target="source" name="ResizeImage">ResizeImage</a></h2>
308<div class="doc-section">
309
310<p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo() ).</p></ol>
311
312<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>
313
314<p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p></ol>
315
316<p>The format of the ResizeImage method is:</p>
317
318<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]319 Image *ResizeImage(Image *image,const size_t columns,
320 const size_t rows,const FilterTypes filter,const double blur,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]321 ExceptionInfo *exception)
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>columns</h5>
330<ol><p>the number of columns in the scaled image.</p></ol>
331
332<h5>rows</h5>
333<ol><p>the number of rows in the scaled image.</p></ol>
334
335<h5>filter</h5>
336<ol><p>Image filter to use.</p></ol>
337
338<h5>blur</h5>
cristybc9539a2010-08-16 18:06:20 +0000[diff] [blame]339<ol><p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p></ol>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]340
341<h5>exception</h5>
342<ol><p>return any errors or warnings in this structure.</p></ol>
343
344 </div>
345<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
346_8c.html" target="source" name="SampleImage">SampleImage</a></h2>
347<div class="doc-section">
348
349<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>
350
351<p>The format of the SampleImage method is:</p>
352
353<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]354 Image *SampleImage(const Image *image,const size_t columns,
355 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]356</pre>
357
358<p>A description of each parameter follows:</p></ol>
359
360<h5>image</h5>
361<ol><p>the image.</p></ol>
362
363<h5>columns</h5>
364<ol><p>the number of columns in the sampled image.</p></ol>
365
366<h5>rows</h5>
367<ol><p>the number of rows in the sampled image.</p></ol>
368
369<h5>exception</h5>
370<ol><p>return any errors or warnings in this structure.</p></ol>
371
372 </div>
373<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
374_8c.html" target="source" name="ScaleImage">ScaleImage</a></h2>
375<div class="doc-section">
376
377<p>ScaleImage() changes the size of an image to the given dimensions.</p></ol>
378
379<p>The format of the ScaleImage method is:</p>
380
381<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]382 Image *ScaleImage(const Image *image,const size_t columns,
383 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]384</pre>
385
386<p>A description of each parameter follows:</p></ol>
387
388<h5>image</h5>
389<ol><p>the image.</p></ol>
390
391<h5>columns</h5>
392<ol><p>the number of columns in the scaled image.</p></ol>
393
394<h5>rows</h5>
395<ol><p>the number of rows in the scaled image.</p></ol>
396
397<h5>exception</h5>
398<ol><p>return any errors or warnings in this structure.</p></ol>
399
400 </div>
401<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
402_8c.html" target="source" name="ThumbnailImage">ThumbnailImage</a></h2>
403<div class="doc-section">
404
405<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>
406
407<p>The format of the ThumbnailImage method is:</p>
408
409<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]410 Image *ThumbnailImage(const Image *image,const size_t columns,
411 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]412</pre>
413
414<p>A description of each parameter follows:</p></ol>
415
416<h5>image</h5>
417<ol><p>the image.</p></ol>
418
419<h5>columns</h5>
420<ol><p>the number of columns in the scaled image.</p></ol>
421
422<h5>rows</h5>
423<ol><p>the number of rows in the scaled image.</p></ol>
424
425<h5>exception</h5>
426<ol><p>return any errors or warnings in this structure.</p></ol>
427
428 </div>
429<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
430_8c.html" target="source" name="ZoomImage">ZoomImage</a></h2>
431<div class="doc-section">
432
433<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>
434
435<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>
436
437<p>The format of the ZoomImage method is:</p>
438
439<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]440 Image *ZoomImage(const Image *image,const size_t columns,
441 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]442</pre>
443
444<p>A description of each parameter follows:</p></ol>
445
446<h5>image</h5>
447<ol><p>the image.</p></ol>
448
449<h5>columns</h5>
450<ol><p>An integer that specifies the number of columns in the zoom image.</p></ol>
451
452<h5>rows</h5>
453<ol><p>An integer that specifies the number of rows in the scaled image.</p></ol>
454
455<h5>exception</h5>
456<ol><p>return any errors or warnings in this structure.</p></ol>
457
458 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]459
460</div>
461
462<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]463 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]464 <span id="linkbar-center">
465 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]466 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]467 </span>
468 <span id="linkbar-east">&nbsp;</span>
469 </div>
470 <div class="footer">
471 <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
472 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
473 </div>
474 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]475 <script type="text/javascript">
476 var _gaq = _gaq || [];
477 _gaq.push(['_setAccount', 'UA-17690367-1']);
478 _gaq.push(['_trackPageview']);
479
480 (function() {
481 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
482 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
483 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
484 })();
485 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]486</body>
487</html>