Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 44cbd482f15fae6544c7382473a346af1c0b868f / . / www / api / resize.html
blob: 557bc027d98ac49b652b59f16107222b93f2686f [file] [log] [blame]
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="-//W3C//DTD XHTML 1.1//EN" xml:lang="en" xsi:schemaLocation="http://www.w3.org/1999/xhtml http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]3<head>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]4 <meta http-equiv="content-type" content="text/html; charset=UTF-8"></meta>
5 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"></meta>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]6 <title>ImageMagick: MagickCore, C API for ImageMagick: Resize an Image</title>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]7 <meta http-equiv="content-language" content="en-US"></meta>
8 <meta http-equiv="content-type" content="text/html; charset=utf-8"></meta>
9 <meta http-equiv="reply-to" content="magick-users@imagemagick.org"></meta>
10 <meta name="application-name" content="ImageMagick"></meta>
11 <meta name="description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition, resize, rotate, shear, distort or transform images automagically."></meta>
12 <meta name="application-url" content="http://www.imagemagick.org"></meta>
13 <meta name="generator" content="PHP"></meta>
14 <meta name="keywords" content="magickcore, c, api, for, imagemagick:, resize, an, image, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"></meta>
15 <meta name="rating" content="GENERAL"></meta>
16 <meta name="robots" content="INDEX, FOLLOW"></meta>
17 <meta name="generator" content="ImageMagick Studio LLC"></meta>
18 <meta name="author" content="ImageMagick Studio LLC"></meta>
19 <meta name="revisit-after" content="2 DAYS"></meta>
20 <meta name="resource-type" content="document"></meta>
21 <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"></meta>
22 <meta name="distribution" content="Global"></meta>
23 <link rel="icon" href="../../images/wand.png"></link>
24 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"></link>
25 <link rel="canonical" href="../../index.html"></link>
26 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"></link>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]27
28 <!-- Add jQuery library -->
29 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7/jquery.min.js"></script>
30
31 <!-- Add mousewheel plugin (this is optional) -->
32 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
33
34 <!-- Add fancyBox -->
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]35 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.0.6" type="text/css" media="screen"></link>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]36 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.0.6"></script>
37
38 <!-- Optionally add helpers - button, thumbnail and/or media -->
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]39 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.2" type="text/css" media="screen"></link>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]40 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.2"></script>
41 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.0"></script>
42
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]43 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=2.0.6" type="text/css" media="screen"></link>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]44 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=2.0.6"></script>
45
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]46 <script type="text/javascript">
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]47 $(document).ready(function() {
48 $(".fancybox").fancybox();
49 });
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]50 </script>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]51
52 <!-- ImageMagick style -->
53 <style type="text/css" media="all">
54 @import url("../../www/magick.css");
55 </style>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]56</head>
57
58<body id="www-imagemagick-org">
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]59
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]60
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]61
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]62<div class="titlebar">
63<div style="margin: 17px auto; float: left;">
64 <script type="text/javascript">
65 <!--
66 google_ad_client = "pub-3129977114552745";
67 google_ad_slot = "5439289906";
68 google_ad_width = 728;
69 google_ad_height = 90;
70 //-->
71 </script>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]72
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]73</div>
cristy417eeb12013-07-28 18:48:22 +0000[diff] [blame]74<a href="../../discourse-server">
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]75 <img src="../../images/logo.jpg" alt="ImageMagick Logo" style="width: 123px; height: 118px; border: 0px; float: right;"></img></a>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]76<a href="../../index.html">
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]77 <img src="../../images/sprite.jpg" alt="ImageMagick Sprite" style="width: 114px; height: 118px; border: 0px; float: right;"></img></a>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]78</div>
79
80<div class="westbar">
81
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]82<div class="menu">
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]83 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]84</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]85<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]86 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]87</div>
88<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]89 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]90</div>
91<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]92 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]93</div>
94<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]95 <a title="Binary Release: iOS" href="../../www/binary-releases.html#iOS">iOS</a>
cristyda16f162011-02-19 23:52:17 +0000[diff] [blame]96</div>
97<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]98 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]99</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]100<div class="sep"></div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]101<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]102 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
104<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]105 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]106</div>
107<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]108 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
110<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]111 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]112</div>
113<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]114 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]115</div>
116<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]117 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]118</div>
119<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]120 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]121</div>
122<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]123 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124</div>
125<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]126 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]127</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]128<div class="sep"></div>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]129<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]130 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]131</div>
132<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]133 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134</div>
135<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]136 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]137 </div>
138<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]139 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]140</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]141<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]142 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]143</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]144<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]145 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]146</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]147<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]148<div class="menu">
cristy3dfa2192013-02-24 22:46:05 +0000[diff] [blame]149 <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]150</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]151<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]152<div class="menu">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]153 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]154</div>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]155<div class="sub">
cristyd8833bf2013-02-24 22:14:53 +0000[diff] [blame]156 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]157</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]158<div class="sep"></div>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]159<div class="menu">
160 <a title="Support ImageMagick Development" href="../../www/support.html">Support ImageMagick Development</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]161</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]162</div>
163
164<div class="eastbar">
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]165
cristy417eeb12013-07-28 18:48:22 +0000[diff] [blame]166 <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="../../index.html"></a></div>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]167 <noscript>
168 <a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]169 <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0"></img></a>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]170 </noscript>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]171
172
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]173</div>
174
175<div class="main">
176
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]177<h1>Module resize Methods</h1>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]178<p class="navigation-index">[<a href="resize.html#AdaptiveResizeImage">AdaptiveResizeImage</a> • <a href="resize.html#InterpolativeResizeImage">InterpolativeResizeImage</a> • <a href="resize.html#LiquidRescaleImage">LiquidRescaleImage</a> • <a href="resize.html#MagnifyImage">MagnifyImage</a> • <a href="resize.html#MinifyImage">MinifyImage</a> • <a href="resize.html#ResampleImage">ResampleImage</a> • <a href="resize.html#ResizeImage">ResizeImage</a> • <a href="resize.html#SampleImage">SampleImage</a> • <a href="resize.html#ScaleImage">ScaleImage</a> • <a href="resize.html#ThumbnailImage">ThumbnailImage</a>]</p>
cristy6f77f692011-02-15 15:31:39 +0000[diff] [blame]179
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]180<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
181<div class="doc-section">
182
183<p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p>
184
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]185<p>This is shortcut function for a fast interpolative resize using mesh interpolation. It works well for small resizes of less than +/- 50 of the original image size. For larger resizing on images a full filtered and slower resize function should be used instead.</p>
186
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]187<p>The format of the AdaptiveResizeImage method is:</p>
188
189<pre class="code">
190 Image *AdaptiveResizeImage(const Image *image,const size_t columns,
191 const size_t rows,ExceptionInfo *exception)
192</pre>
193
194<p>A description of each parameter follows:</p>
195
196<h5>image</h5>
197<p>the image.</p>
198
199<h5>columns</h5>
200<p>the number of columns in the resized image.</p>
201
202<h5>rows</h5>
203<p>the number of rows in the resized image.</p>
204
205<h5>exception</h5>
206<p>return any errors or warnings in this structure.</p>
207
208 </div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]209<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="InterpolativeResizeImage">InterpolativeResizeImage</a></h2>
210<div class="doc-section">
211
212<p>InterpolativeResizeImage() resizes an image using the specified interpolation method.</p>
213
214<p>The format of the InterpolativeResizeImage method is:</p>
215
216<pre class="code">
217 Image *InterpolativeResizeImage(const Image *image,const size_t columns,
218 const size_t rows,const InterpolatePixelMethod method,
219 ExceptionInfo *exception)
220</pre>
221
222<p>A description of each parameter follows:</p>
223
224<h5>image</h5>
225<p>the image.</p>
226
227<h5>columns</h5>
228<p>the number of columns in the resized image.</p>
229
230<h5>rows</h5>
231<p>the number of rows in the resized image.</p>
232
233<h5>method</h5>
234<p>the pixel interpolation method.</p>
235
236<h5>exception</h5>
237<p>return any errors or warnings in this structure.</p>
238
239 </div>
240<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="LiquidRescaleImage">LiquidRescaleImage</a></h2>
241<div class="doc-section">
242
243<p>LiquidRescaleImage() rescales image with seam carving.</p>
244
245<p>The format of the LiquidRescaleImage method is:</p>
246
247<pre class="code">
248 Image *LiquidRescaleImage(const Image *image,
249 const size_t columns,const size_t rows,
250 const double delta_x,const double rigidity,ExceptionInfo *exception)
251</pre>
252
253<p>A description of each parameter follows:</p>
254
255<h5>image</h5>
256<p>the image.</p>
257
258<h5>columns</h5>
259<p>the number of columns in the rescaled image.</p>
260
261<h5>rows</h5>
262<p>the number of rows in the rescaled image.</p>
263
264<h5>delta_x</h5>
265<p>maximum seam transversal step (0 means straight seams).</p>
266
267<h5>rigidity</h5>
268<p>introduce a bias for non-straight seams (typically 0).</p>
269
270<h5>exception</h5>
271<p>return any errors or warnings in this structure.</p>
272
273 </div>
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]274<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MagnifyImage">MagnifyImage</a></h2>
275<div class="doc-section">
276
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]277<p>MagnifyImage() doubles the size of the image with a pixel art scaling algorithm.</p>
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]278
279<p>The format of the MagnifyImage method is:</p>
280
281<pre class="code">
282 Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
283</pre>
284
285<p>A description of each parameter follows:</p>
286
287<h5>image</h5>
288<p>the image.</p>
289
290<h5>exception</h5>
291<p>return any errors or warnings in this structure.</p>
292
293 </div>
294<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MinifyImage">MinifyImage</a></h2>
295<div class="doc-section">
296
297<p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p>
298
299<p>The format of the MinifyImage method is:</p>
300
301<pre class="code">
302 Image *MinifyImage(const Image *image,ExceptionInfo *exception)
303</pre>
304
305<p>A description of each parameter follows:</p>
306
307<h5>image</h5>
308<p>the image.</p>
309
310<h5>exception</h5>
311<p>return any errors or warnings in this structure.</p>
312
313 </div>
314<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResampleImage">ResampleImage</a></h2>
315<div class="doc-section">
316
317<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>
318
319<p>The format of the ResampleImage method is:</p>
320
321<pre class="code">
322 Image *ResampleImage(Image *image,const double x_resolution,
323 const double y_resolution,const FilterTypes filter,const double blur,
324 ExceptionInfo *exception)
325</pre>
326
327<p>A description of each parameter follows:</p>
328
329<h5>image</h5>
330<p>the image to be resized to fit the given resolution.</p>
331
332<h5>x_resolution</h5>
333<p>the new image x resolution.</p>
334
335<h5>y_resolution</h5>
336<p>the new image y resolution.</p>
337
338<h5>filter</h5>
339<p>Image filter to use.</p>
340
341<h5>blur</h5>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]342<p>the blur factor where &gt; 1 is blurry, &lt; 1 is sharp.</p>
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]343
344 </div>
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]345<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResizeImage">ResizeImage</a></h2>
346<div class="doc-section">
347
348<p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo()).</p>
349
350<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>
351
352<p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p>
353
354<p>The format of the ResizeImage method is:</p>
355
356<pre class="code">
357 Image *ResizeImage(Image *image,const size_t columns,
358 const size_t rows,const FilterTypes filter,const double blur,
359 ExceptionInfo *exception)
360</pre>
361
362<p>A description of each parameter follows:</p>
363
364<h5>image</h5>
365<p>the image.</p>
366
367<h5>columns</h5>
368<p>the number of columns in the scaled image.</p>
369
370<h5>rows</h5>
371<p>the number of rows in the scaled image.</p>
372
373<h5>filter</h5>
374<p>Image filter to use.</p>
375
376<h5>blur</h5>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]377<p>the blur factor where &gt; 1 is blurry, &lt; 1 is sharp. Typically set this to 1.0.</p>
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]378
379<h5>exception</h5>
380<p>return any errors or warnings in this structure.</p>
381
382 </div>
383<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="SampleImage">SampleImage</a></h2>
384<div class="doc-section">
385
386<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>
387
388<p>The format of the SampleImage method is:</p>
389
390<pre class="code">
391 Image *SampleImage(const Image *image,const size_t columns,
392 const size_t rows,ExceptionInfo *exception)
393</pre>
394
395<p>A description of each parameter follows:</p>
396
397<h5>image</h5>
398<p>the image.</p>
399
400<h5>columns</h5>
401<p>the number of columns in the sampled image.</p>
402
403<h5>rows</h5>
404<p>the number of rows in the sampled image.</p>
405
406<h5>exception</h5>
407<p>return any errors or warnings in this structure.</p>
408
409 </div>
410<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ScaleImage">ScaleImage</a></h2>
411<div class="doc-section">
412
413<p>ScaleImage() changes the size of an image to the given dimensions.</p>
414
415<p>The format of the ScaleImage method is:</p>
416
417<pre class="code">
418 Image *ScaleImage(const Image *image,const size_t columns,
419 const size_t rows,ExceptionInfo *exception)
420</pre>
421
422<p>A description of each parameter follows:</p>
423
424<h5>image</h5>
425<p>the image.</p>
426
427<h5>columns</h5>
428<p>the number of columns in the scaled image.</p>
429
430<h5>rows</h5>
431<p>the number of rows in the scaled image.</p>
432
433<h5>exception</h5>
434<p>return any errors or warnings in this structure.</p>
435
436 </div>
437<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ThumbnailImage">ThumbnailImage</a></h2>
438<div class="doc-section">
439
440<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>
441
442<p>The format of the ThumbnailImage method is:</p>
443
444<pre class="code">
445 Image *ThumbnailImage(const Image *image,const size_t columns,
446 const size_t rows,ExceptionInfo *exception)
447</pre>
448
449<p>A description of each parameter follows:</p>
450
451<h5>image</h5>
452<p>the image.</p>
453
454<h5>columns</h5>
455<p>the number of columns in the scaled image.</p>
456
457<h5>rows</h5>
458<p>the number of rows in the scaled image.</p>
459
460<h5>exception</h5>
461<p>return any errors or warnings in this structure.</p>
462
463 </div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]464
465</div>
466
467<div id="linkbar">
cristyac1b4322013-07-28 13:58:06 +0000[diff] [blame]468 <span id="linkbar-west"> </span>
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]469
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]470 <span id="linkbar-center">
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]471 <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
472 <a href="../../discourse-server">Discourse Server</a> •
473 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
cristy8ee7f242013-06-20 16:08:44 +0000[diff] [blame]474 <a href="http://jqmagick.imagemagick.org/">JqMagick</a>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]475 </span>
cristyac1b4322013-07-28 13:58:06 +0000[diff] [blame]476 <span id="linkbar-east"> </span>
cristy44cbd482013-08-04 20:53:36 +0000[diff] [blame^]477</div>
478<div class="footer">
479 <span id="footer-west">© 1999-2013 ImageMagick Studio LLC</span>
480 <span id="footer-east"> <a href="../../www/contact.html">Contact the Wizards</a></span>
481</div>
482<div style="clear: both; margin: 0; width: 100%; "></div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]483</body>
484</html>