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