blob: c18737d2c7dfecfdb4a6daf06b6d969d847d3f90 [file] [log] [blame]
cristydcca3fa2010-12-29 21:50:07 +00001<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
cristy2bd2a982011-02-15 00:52:58 +00003<html version="-//W3C//DTD XHTML 1.1//EN"
4 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
5 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
6 xsi:schemaLocation="http://www.w3.org/1999/xhtml
7 http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
cristy3eaa0ef2010-03-06 20:35:26 +00008<head>
cristy3c98a4f2010-08-13 20:09:41 +00009 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
cristy1efc1ab2011-08-01 14:47:02 +000010 <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
cristyffb69ed2010-12-25 00:06:48 +000011 <title>ImageMagick: MagickCore, C API for ImageMagick: Resize an Image</title>
cristy3ed852e2009-09-05 21:47:34 +000012 <meta http-equiv="Content-Language" content="en-US"/>
13 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
14 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +000015 <meta name="Application-name" content="ImageMagick"/>
cristye6e84152011-06-06 14:16:49 +000016 <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition resize, rotate, shear, distort and transform images automagically."/>
cristy3c98a4f2010-08-13 20:09:41 +000017 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +000018 <meta name="Generator" content="PHP"/>
cristyeed6cb62012-01-28 19:38:34 +000019 <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"/>
cristy3ed852e2009-09-05 21:47:34 +000020 <meta name="Rating" content="GENERAL"/>
21 <meta name="Robots" content="INDEX, FOLLOW"/>
22 <meta name="Generator" content="ImageMagick Studio LLC"/>
23 <meta name="Author" content="ImageMagick Studio LLC"/>
24 <meta name="Revisit-after" content="2 DAYS"/>
25 <meta name="Resource-type" content="document"/>
cristy1454be72011-12-19 01:52:48 +000026 <meta name="Copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +000027 <meta name="Distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +000028 <link rel="icon" href="../../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +000029 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
cristy29c5c992011-06-25 13:58:49 +000030 <link rel="canonical" href="http://www.imagemagick.org" />
cristy3c98a4f2010-08-13 20:09:41 +000031 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristyeed6cb62012-01-28 19:38:34 +000032 <!-- Add jQuery library -->
33 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7/jquery.min.js"></script>
34
35 <!-- Optionaly include easing and/or mousewheel plugins -->
36 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.easing-1.3.pack.js"></script>
37 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.mousewheel-3.0.6.pack.js"></script>
38
39 <!-- Add fancyBox -->
40 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/jquery.fancybox.css?v=2.0.3" type="text/css" media="screen" />
41 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.3"></script>
42
43 <!-- Optionaly include button and/or thumbnail helpers -->
44 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.css?v=2.0.3" type="text/css" media="screen" />
45 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.3"></script>
46
47 <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.3" type="text/css" media="screen" />
48 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.3"></script>
49 <script type="text/javascript">
50 $(document).ready(function() {
51 $(".fancybox").fancybox();
52 });
53 </script>
54 <!-- ImageMagick style -->
cristy7a40ba82011-01-08 20:31:18 +000055 <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
cristy3c98a4f2010-08-13 20:09:41 +000056 <style type="text/css" media="all">
57 @import url("../../www/magick.css");
58 </style>
cristy3eaa0ef2010-03-06 20:35:26 +000059</head>
60
61<body id="www-imagemagick-org">
62<div class="titlebar">
cristyb52981c2011-03-19 17:09:31 +000063<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>
72 <script type="text/javascript"
73 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
74 </script>
75</div>
cristy3eaa0ef2010-03-06 20:35:26 +000076<a href="http://www.imagemagick.org/discourse-server/">
cristyaf8d6652011-02-04 21:57:45 +000077 <img src="../../images/logo.jpg"
78 alt="ImageMagick Logo"
cristy178edaf2011-01-23 03:42:39 +000079 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +000080<a href="../../index.html">
cristyaf8d6652011-02-04 21:57:45 +000081 <img src="../../images/sprite.jpg"
82 alt="ImageMagick Sprite"
cristy3eaa0ef2010-03-06 20:35:26 +000083 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
84</div>
85
cristyce69bb02010-07-27 19:49:46 +000086<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +000087
cristy3ed852e2009-09-05 21:47:34 +000088<div class="menu">
cristy83a272e2010-05-07 20:40:35 +000089 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +000090</div>
cristy3ed852e2009-09-05 21:47:34 +000091<div class="menu">
cristybb503372010-05-27 20:51:26 +000092 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
93</div>
94<div class="sub">
95 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
96</div>
97<div class="sub">
98 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
99</div>
100<div class="sub">
cristye6e84152011-06-06 14:16:49 +0000101 <a title="Binary Release: iOS" href="../../www/binary-releases.html#iOS">iOS</a>
cristyda16f162011-02-19 23:52:17 +0000102</div>
103<div class="sub">
cristybb503372010-05-27 20:51:26 +0000104 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
105</div>
106<div class="sep"></div>
107<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000108 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000109</div>
110<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000111 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000112</div>
113<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000114 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000115</div>
116<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000117 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000118</div>
119<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000120 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000121</div>
122<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000123 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000124</div>
125<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000126 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000127</div>
128<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000129 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000130</div>
131<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000132 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000133</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000134<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000135<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000136 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000137</div>
138<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000139 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000140</div>
141<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000142 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000143 </div>
144<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000145 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000146</div>
cristybb503372010-05-27 20:51:26 +0000147<div class="menu">
148 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
149</div>
cristy3ed852e2009-09-05 21:47:34 +0000150<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000151 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000152</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000153<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000154<div class="menu">
cristy52923442011-01-15 22:54:31 +0000155 <a title="Search" href="../../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000156</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000157<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000158<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000159 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000160</div>
161<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000162 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000163</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000164<div class="sep"></div>
cristyeed6cb62012-01-28 19:38:34 +0000165<div class="menu">
cristy10549a12011-05-15 19:04:46 +0000166 <a rel="follow" title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000167
cristyeed6cb62012-01-28 19:38:34 +0000168 <a href="http://www.networkredux.com"> <img src="../../images/networkredux.png" width="140" height="31" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
169 <a href="http://www.dinodirect.com/ipads-tablets/"> <img src="../../images/dino-direct.jpg" width="140" height="90" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a><!-- 201204010120 mickey@163... -->
cristy3ed852e2009-09-05 21:47:34 +0000170<div class="sponsbox">
cristyeed6cb62012-01-28 19:38:34 +0000171<div class="sponsor">
172 <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201204010120 mickey@163... -->
cristy81492d62011-06-07 16:41:42 +0000173</div>
cristyeed6cb62012-01-28 19:38:34 +0000174<div class="sponsor">
cristyaf894d72011-08-06 23:03:10 +0000175 <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
cristy1efc1ab2011-08-01 14:47:02 +0000176</div>
cristyeed6cb62012-01-28 19:38:34 +0000177<div class="sponsor">
178 <a rel="follow" title="Sponsor: Autos Part" href="http://www.pkwteile.de/autoteile">Autos Part</a><!-- 201203010270 info@pkwte... -->
cristy84134182011-06-15 22:59:00 +0000179</div>
cristyeed6cb62012-01-28 19:38:34 +0000180<div class="sponsor">
181 <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
cristy81492d62011-06-07 16:41:42 +0000182</div>
cristyeed6cb62012-01-28 19:38:34 +0000183<div class="sponsor">
184 <a rel="follow" title="Sponsor: Tenant Check" href="http://www.rentmethod.com/">Tenant Check</a><!-- 201203010090 chris@rentm... -->
cristyba1758d2011-06-03 01:29:12 +0000185</div>
cristyeed6cb62012-01-28 19:38:34 +0000186<div class="sponsor">
187 <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201204010090 barsh@inter... -->
cristyaf894d72011-08-06 23:03:10 +0000188</div>
cristyeed6cb62012-01-28 19:38:34 +0000189<div class="sponsor">
190 <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
191</div>
192<div class="sponsor">
193 <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201301010090s jen@seo lowprofilelinks -->
194</div>
195<div class="sponsor">
196 <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
197</div>
198<div class="sponsor">
199 <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
200</div>
201<div class="sponsor">
202 <a rel="follow" title="Sponsor: Stock Photography" href="http://www.fotosearch.com/">Stock Photography</a><!-- 2012040100250 ... -->
203</div>
204<div class="sponsor">
205 <a rel="follow" title="Sponsor: Autoteile" href="http://www.q11-shop.de">Autoteile</a><!-- 201205010540 suvalj -->
206</div>
207<div class="sponsor">
208 <a rel="follow" title="Sponsor: Royalty Free Stock Images" href="http://www.canstockphoto.com/">Royalty Free Stock Images</a><!-- 2012050100360 support@can -->
209</div>
210<div class="sponsor">
cristyba1758d2011-06-03 01:29:12 +0000211 <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
212</div>
cristyeed6cb62012-01-28 19:38:34 +0000213<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000214 <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
cristy4c54bbb2011-03-17 13:53:13 +0000215</div>
cristyeed6cb62012-01-28 19:38:34 +0000216<div class="sponsor">
217 <a rel="follow" title="Sponsor: Turbolader Online kaufen" href="http://www.autoteile-carparts.de">Turbolader Online kaufen</a><!-- 2012050100150 t.temurbas...-->
cristy4bf6e232011-05-21 01:43:33 +0000218</div>
cristyeed6cb62012-01-28 19:38:34 +0000219<div class="sponsor">
220 <a rel="follow" title="Sponsor: Schlüsseldienst Berlin BSD" href="http://www.schluesseldienst-berlin.de">Schlüsseldienst Berlin BSD</a><!-- 2012050100025 info@schlues-->
cristyec6b4752011-01-08 03:16:23 +0000221</div>
cristy3ed852e2009-09-05 21:47:34 +0000222</div>
223</div>
cristyce69bb02010-07-27 19:49:46 +0000224</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000225
cristyce69bb02010-07-27 19:49:46 +0000226<div class="eastbar">
cristy29c5c992011-06-25 13:58:49 +0000227 <div class="g-plusone" data-size="standard" data-count="false"></div>
cristyeed6cb62012-01-28 19:38:34 +0000228 <script type="text/javascript">
229 window.___gcfg = {
230 lang: 'en-US'
231 };
232
233 (function() {
234 var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;
235 po.src = 'https://apis.google.com/js/plusone.js';
236 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);
237 })();
238 </script>
cristy29c5c992011-06-25 13:58:49 +0000239</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000240
241<div class="main">
242
cristy20398432011-08-11 01:31:50 +0000243<h1>Module resize Methods</h1>
244<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>]</p>
cristy6f77f692011-02-15 15:31:39 +0000245
cristy20398432011-08-11 01:31:50 +0000246<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
247<div class="doc-section">
248
249<p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p>
250
251<p>The format of the AdaptiveResizeImage method is:</p>
252
253<pre class="code">
254 Image *AdaptiveResizeImage(const Image *image,const size_t columns,
255 const size_t rows,ExceptionInfo *exception)
256</pre>
257
258<p>A description of each parameter follows:</p>
259
260<h5>image</h5>
261<p>the image.</p>
262
263<h5>columns</h5>
264<p>the number of columns in the resized image.</p>
265
266<h5>rows</h5>
267<p>the number of rows in the resized image.</p>
268
269<h5>exception</h5>
270<p>return any errors or warnings in this structure.</p>
271
272 </div>
273<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MagnifyImage">MagnifyImage</a></h2>
274<div class="doc-section">
275
276<p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p>
277
278<p>The format of the MagnifyImage method is:</p>
279
280<pre class="code">
281 Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
282</pre>
283
284<p>A description of each parameter follows:</p>
285
286<h5>image</h5>
287<p>the image.</p>
288
289<h5>exception</h5>
290<p>return any errors or warnings in this structure.</p>
291
292 </div>
293<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MinifyImage">MinifyImage</a></h2>
294<div class="doc-section">
295
296<p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p>
297
298<p>The format of the MinifyImage method is:</p>
299
300<pre class="code">
301 Image *MinifyImage(const Image *image,ExceptionInfo *exception)
302</pre>
303
304<p>A description of each parameter follows:</p>
305
306<h5>image</h5>
307<p>the image.</p>
308
309<h5>exception</h5>
310<p>return any errors or warnings in this structure.</p>
311
312 </div>
313<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResampleImage">ResampleImage</a></h2>
314<div class="doc-section">
315
316<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>
317
318<p>The format of the ResampleImage method is:</p>
319
320<pre class="code">
321 Image *ResampleImage(Image *image,const double x_resolution,
322 const double y_resolution,const FilterTypes filter,const double blur,
323 ExceptionInfo *exception)
324</pre>
325
326<p>A description of each parameter follows:</p>
327
328<h5>image</h5>
329<p>the image to be resized to fit the given resolution.</p>
330
331<h5>x_resolution</h5>
332<p>the new image x resolution.</p>
333
334<h5>y_resolution</h5>
335<p>the new image y resolution.</p>
336
337<h5>filter</h5>
338<p>Image filter to use.</p>
339
340<h5>blur</h5>
341<p>the blur factor where > 1 is blurry, < 1 is sharp.</p>
342
343 </div>
344<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="LiquidRescaleImage">LiquidRescaleImage</a></h2>
345<div class="doc-section">
346
347<p>LiquidRescaleImage() rescales image with seam carving.</p>
348
349<p>The format of the LiquidRescaleImage method is:</p>
350
351<pre class="code">
352 Image *LiquidRescaleImage(const Image *image,
353 const size_t columns,const size_t rows,
354 const double delta_x,const double rigidity,ExceptionInfo *exception)
355</pre>
356
357<p>A description of each parameter follows:</p>
358
359<h5>image</h5>
360<p>the image.</p>
361
362<h5>columns</h5>
363<p>the number of columns in the rescaled image.</p>
364
365<h5>rows</h5>
366<p>the number of rows in the rescaled image.</p>
367
368<h5>delta_x</h5>
369<p>maximum seam transversal step (0 means straight seams).</p>
370
371<h5>rigidity</h5>
372<p>introduce a bias for non-straight seams (typically 0).</p>
373
374<h5>exception</h5>
375<p>return any errors or warnings in this structure.</p>
376
377 </div>
378<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResizeImage">ResizeImage</a></h2>
379<div class="doc-section">
380
381<p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo()).</p>
382
383<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>
384
385<p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p>
386
387<p>The format of the ResizeImage method is:</p>
388
389<pre class="code">
390 Image *ResizeImage(Image *image,const size_t columns,
391 const size_t rows,const FilterTypes filter,const double blur,
392 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 scaled image.</p>
402
403<h5>rows</h5>
404<p>the number of rows in the scaled image.</p>
405
406<h5>filter</h5>
407<p>Image filter to use.</p>
408
409<h5>blur</h5>
410<p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p>
411
412<h5>exception</h5>
413<p>return any errors or warnings in this structure.</p>
414
415 </div>
416<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="SampleImage">SampleImage</a></h2>
417<div class="doc-section">
418
419<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>
420
421<p>The format of the SampleImage method is:</p>
422
423<pre class="code">
424 Image *SampleImage(const Image *image,const size_t columns,
425 const size_t rows,ExceptionInfo *exception)
426</pre>
427
428<p>A description of each parameter follows:</p>
429
430<h5>image</h5>
431<p>the image.</p>
432
433<h5>columns</h5>
434<p>the number of columns in the sampled image.</p>
435
436<h5>rows</h5>
437<p>the number of rows in the sampled image.</p>
438
439<h5>exception</h5>
440<p>return any errors or warnings in this structure.</p>
441
442 </div>
443<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ScaleImage">ScaleImage</a></h2>
444<div class="doc-section">
445
446<p>ScaleImage() changes the size of an image to the given dimensions.</p>
447
448<p>The format of the ScaleImage method is:</p>
449
450<pre class="code">
451 Image *ScaleImage(const Image *image,const size_t columns,
452 const size_t rows,ExceptionInfo *exception)
453</pre>
454
455<p>A description of each parameter follows:</p>
456
457<h5>image</h5>
458<p>the image.</p>
459
460<h5>columns</h5>
461<p>the number of columns in the scaled image.</p>
462
463<h5>rows</h5>
464<p>the number of rows in the scaled image.</p>
465
466<h5>exception</h5>
467<p>return any errors or warnings in this structure.</p>
468
469 </div>
470<h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ThumbnailImage">ThumbnailImage</a></h2>
471<div class="doc-section">
472
473<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>
474
475<p>The format of the ThumbnailImage method is:</p>
476
477<pre class="code">
478 Image *ThumbnailImage(const Image *image,const size_t columns,
479 const size_t rows,ExceptionInfo *exception)
480</pre>
481
482<p>A description of each parameter follows:</p>
483
484<h5>image</h5>
485<p>the image.</p>
486
487<h5>columns</h5>
488<p>the number of columns in the scaled image.</p>
489
490<h5>rows</h5>
491<p>the number of rows in the scaled image.</p>
492
493<h5>exception</h5>
494<p>return any errors or warnings in this structure.</p>
495
496 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000497
498</div>
499
500<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000501 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000502 <span id="linkbar-center">
503 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000504 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000505 </span>
506 <span id="linkbar-east">&nbsp;</span>
507 </div>
508 <div class="footer">
cristyeed6cb62012-01-28 19:38:34 +0000509 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000510 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
511 </div>
512 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000513 <script type="text/javascript">
514 var _gaq = _gaq || [];
515 _gaq.push(['_setAccount', 'UA-17690367-1']);
516 _gaq.push(['_trackPageview']);
517
518 (function() {
519 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
520 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
521 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
522 })();
523 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000524</body>
525</html>