granicus.if.org Git - imagemagick/blob - www/api/resize.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3 <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">
   8 <head>
   9   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
  10   <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
  11   <title>ImageMagick: MagickCore, C API for ImageMagick: Resize an Image</title>
  12   <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"/>
  15   <meta name="application-name" content="ImageMagick"/>
  16   <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."/>
  17   <meta name="application-url" content="http://www.imagemagick.org"/>
  18   <meta name="generator" content="PHP"/>
  19   <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"/>
  20   <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"/>
  26   <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
  27   <meta name="distribution" content="Global"/>
  28   <link rel="icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.png"/>
  29   <link rel="shortcut icon" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/wand.ico"  type="images/x-icon"/>
  30   <link rel="canonical" href="http://www.imagemagick.org" />
  31   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
  32   <!-- 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.4" type="text/css" media="screen" />
  41   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.4"></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.4" type="text/css" media="screen" />
  45   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.4"></script>
  46
  47   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.4" type="text/css" media="screen" />
  48   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.4"></script>
  49   <script type="text/javascript">
  50         $(document).ready(function() {
  51                 $(".fancybox").fancybox();
  52         });
  53   </script>
  54   <!-- ImageMagick style -->
  55   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
  56   <style type="text/css" media="all">
  57     @import url("../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick.css");
  58   </style>
  59 </head>
  60
  61 <body id="www-imagemagick-org">
  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>
  72   <script type="text/javascript"
  73     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
  74   </script>
  75 </div>
  76 <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">
  77   <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/logo.jpg"
  78   alt="ImageMagick Logo"
  79   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
  80 <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">
  81   <img src="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../images/sprite.jpg"
  82   alt="ImageMagick Sprite"
  83   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  84 </div>
  85
  86 <div class="westbar">
  87
  88 <div class="menu">
  89   <a title="About ImageMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../index.html">About ImageMagick</a>
  90 </div>
  91 <div class="menu">
  92   <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">
 101     <a title="Binary Release: iOS" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#iOS">iOS</a>
 102 </div>
 103 <div class="sub">
 104     <a title="Binary Release: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/binary-releases.html#windows">Windows</a>
 105 </div>
 106 <div class="sep"></div>
 107 <div class="menu">
 108   <a title="Command-line Tools" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-tools.html">Command-line Tools</a>
 109 </div>
 110 <div class="sub">
 111     <a title="Command-line Tools: Processing" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-processing.html">Processing</a>
 112 </div>
 113 <div class="sub">
 114     <a title="Command-line Tools: Options" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/command-line-options.html">Options</a>
 115 </div>
 116 <div class="sub">
 117     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 118 </div>
 119 <div class="menu">
 120   <a title="Program Interfaces" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/api.html">Program Interfaces</a>
 121 </div>
 122 <div class="sub">
 123     <a title="Program Interface: MagickWand" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-wand.html">MagickWand</a>
 124 </div>
 125 <div class="sub">
 126     <a title="Program Interface: MagickCore" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick-core.html">MagickCore</a>
 127 </div>
 128 <div class="sub">
 129     <a title="Program Interface: PerlMagick" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/perl-magick.html">PerlMagick</a>
 130 </div>
 131 <div class="sub">
 132     <a title="Program Interface: Magick++" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/magick++.html">Magick++</a>
 133 </div>
 134 <div class="sep"></div>
 135 <div  class="menu">
 136    <a title="Install from Source" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html">Install from Source</a>
 137 </div>
 138 <div class="sub">
 139     <a title="Install from Source: Unix" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#unix">Unix</a>
 140 </div>
 141 <div class="sub">
 142     <a title="Install from Source: Windows" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/install-source.html#windows">Windows</a>
 143  </div>
 144 <div class="menu">
 145   <a title="Resources" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/resources.html">Resources</a>
 146 </div>
 147 <div class="menu">
 148   <a title="Architecture" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/architecture.html">Architecture</a>
 149 </div>
 150 <div class="menu">
 151   <a title="Download" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/download.html">Download</a>
 152 </div>
 153 <div class="sep"></div>
 154 <div class="menu">
 155   <a title="Search" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/search.html">Search</a>
 156 </div>
 157 <div class="sep"></div>
 158 <div class="menu">
 159   <a title="Site Map" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sitemap.html">Site Map</a>
 160 </div>
 161 <div  class="sub">
 162   <a title="Site Map: Links" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/links.html">Links</a>
 163 </div>
 164 <div class="sep"></div>
 165 <div class="menu">
 166   <a rel="follow" title="Sponsors" href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../www/sponsors.html">Sponsors:</a>
 167
 168   <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><!-- 201208010120 mickey@163... -->
 170 <div class="sponsbox">
 171 <div class="sponsor">
 172   <a rel="follow" title="Sponsor: The Fastest &amp; Easiest Way to Find Images" href="http://www.graphicsfactory.com">The Fastest &amp; Easiest Way to Find Images</a><!-- 201210010270 graphicsfac... -->
 173 </div>
 174 <div class="sponsor">
 175   <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201209010090 barsh@inter... -->
 176 </div>
 177 <div class="sponsor">
 178   <a rel="follow" title="Werbebanner Werbeplane" href="http://www.allesbanner.de">Werbebanner Werbeplane</a><!-- 201212010450 info@druck... -->
 179 </div>
 180 <div class="sponsor">
 181   <a rel="follow" title="Entertainment News &amp; Photos" href="http://www.zimbio.com">Entertainment News &amp; Photos</a><!-- 201211010540 bd@zimb... -->
 182 </div>
 183 <div class="sponsor">
 184   <a rel="follow" title="Sponsor: LED24" href="http://led24.de/">LED24</a><!-- 201207010270 info@led24... -->
 185 </div>
 186 <div class="sponsor">
 187   <a rel="follow" title="Sponsor: Best Website Hosting" href="http://www.top-cheap-web-hosting.com">Best Website Hosting</a><!-- 201304010090 eunge.liu-->
 188 </div>
 189 <div class="sponsor">
 190   <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201208010120 mickey@163... -->
 191 </div>
 192 <div class="sponsor">
 193   <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
 194 </div>
 195 <div class="sponsor">
 196    <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
 197 </div>
 198 <div class="sponsor">
 199    <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
 200 </div>
 201 <div class="sponsor">
 202   <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
 203 </div>
 204 <div class="sponsor">
 205   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 206 </div>
 207 <div  class="sponsor">
 208    <a rel="follow" title="Sponsor: Kaffeemaschinen reparatur" href="http://www.kaffeemaschinen-reparatur.de">Kaffeemaschinen reparatur</a><!-- 2012080100030 Temurbas atlas-multimedia-->
 209 </div>
 210 <div class="sponsor">
 211    <a rel="follow" title="Sponsor: Waschmaschinen Reparatur Berlin" href="http://www.waschmaschinen-reparaturen-berlin.de">Waschmaschinen Reparatur Berlin</a><!-- 2012070100030 Temurbas@autoteile-->
 212 </div>
 213 </div>
 214 </div>
 215 </div>
 216
 217 <div class="eastbar">
 218   <div class="g-plusone" id="gplusone"></div>
 219   <script type="text/javascript">
 220     window.___gcfg = {
 221       lang: 'en-US'
 222     };
 223
 224     (function() {
 225       var po = document.createElement('script');
 226       po.type = 'text/javascript'; po.async = true;
 227       po.src = 'https://apis.google.com/js/plusone.js';
 228       var script = document.getElementsByTagName('script')[0];
 229       script.parentNode.insertBefore(po, script);
 230     })();
 231     var gplusone = document.getElementById("gplusone");
 232     gplusone.setAttribute("data-size","medium");
 233     gplusone.setAttribute("data-count","false");
 234   </script>
 235 </div>
 236
 237 <div class="main">
 238
 239 <h1>Module resize Methods</h1>
 240 <p class="navigation-index">[<a href="resize.html#AdaptiveResizeImage">AdaptiveResizeImage</a> &bull; <a href="resize.html#MagnifyImage">MagnifyImage</a> &bull; <a href="resize.html#MinifyImage">MinifyImage</a> &bull; <a href="resize.html#ResampleImage">ResampleImage</a> &bull; <a href="resize.html#LiquidRescaleImage">LiquidRescaleImage</a> &bull; <a href="resize.html#ResizeImage">ResizeImage</a> &bull; <a href="resize.html#SampleImage">SampleImage</a> &bull; <a href="resize.html#ScaleImage">ScaleImage</a> &bull; <a href="resize.html#ThumbnailImage">ThumbnailImage</a>]</p>
 241
 242 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
 243 <div class="doc-section">
 244
 245 <p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p>
 246
 247 <p>The format of the AdaptiveResizeImage method is:</p>
 248
 249 <pre class="code">
 250   Image *AdaptiveResizeImage(const Image *image,const size_t columns,
 251     const size_t rows,ExceptionInfo *exception)
 252 </pre>
 253
 254 <p>A description of each parameter follows:</p>
 255
 256 <h5>image</h5>
 257 <p>the image.</p>
 258
 259 <h5>columns</h5>
 260 <p>the number of columns in the resized image.</p>
 261
 262 <h5>rows</h5>
 263 <p>the number of rows in the resized image.</p>
 264
 265 <h5>exception</h5>
 266 <p>return any errors or warnings in this structure.</p>
 267
 268  </div>
 269 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MagnifyImage">MagnifyImage</a></h2>
 270 <div class="doc-section">
 271
 272 <p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p>
 273
 274 <p>The format of the MagnifyImage method is:</p>
 275
 276 <pre class="code">
 277   Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
 278 </pre>
 279
 280 <p>A description of each parameter follows:</p>
 281
 282 <h5>image</h5>
 283 <p>the image.</p>
 284
 285 <h5>exception</h5>
 286 <p>return any errors or warnings in this structure.</p>
 287
 288  </div>
 289 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MinifyImage">MinifyImage</a></h2>
 290 <div class="doc-section">
 291
 292 <p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p>
 293
 294 <p>The format of the MinifyImage method is:</p>
 295
 296 <pre class="code">
 297   Image *MinifyImage(const Image *image,ExceptionInfo *exception)
 298 </pre>
 299
 300 <p>A description of each parameter follows:</p>
 301
 302 <h5>image</h5>
 303 <p>the image.</p>
 304
 305 <h5>exception</h5>
 306 <p>return any errors or warnings in this structure.</p>
 307
 308  </div>
 309 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResampleImage">ResampleImage</a></h2>
 310 <div class="doc-section">
 311
 312 <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>
 313
 314 <p>The format of the ResampleImage method is:</p>
 315
 316 <pre class="code">
 317   Image *ResampleImage(Image *image,const double x_resolution,
 318     const double y_resolution,const FilterTypes filter,const double blur,
 319     ExceptionInfo *exception)
 320 </pre>
 321
 322 <p>A description of each parameter follows:</p>
 323
 324 <h5>image</h5>
 325 <p>the image to be resized to fit the given resolution.</p>
 326
 327 <h5>x_resolution</h5>
 328 <p>the new image x resolution.</p>
 329
 330 <h5>y_resolution</h5>
 331 <p>the new image y resolution.</p>
 332
 333 <h5>filter</h5>
 334 <p>Image filter to use.</p>
 335
 336 <h5>blur</h5>
 337 <p>the blur factor where > 1 is blurry, < 1 is sharp.</p>
 338
 339  </div>
 340 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="LiquidRescaleImage">LiquidRescaleImage</a></h2>
 341 <div class="doc-section">
 342
 343 <p>LiquidRescaleImage() rescales image with seam carving.</p>
 344
 345 <p>The format of the LiquidRescaleImage method is:</p>
 346
 347 <pre class="code">
 348   Image *LiquidRescaleImage(const Image *image,
 349     const size_t columns,const size_t rows,
 350     const double delta_x,const double rigidity,ExceptionInfo *exception)
 351 </pre>
 352
 353 <p>A description of each parameter follows:</p>
 354
 355 <h5>image</h5>
 356 <p>the image.</p>
 357
 358 <h5>columns</h5>
 359 <p>the number of columns in the rescaled image.</p>
 360
 361 <h5>rows</h5>
 362 <p>the number of rows in the rescaled image.</p>
 363
 364 <h5>delta_x</h5>
 365 <p>maximum seam transversal step (0 means straight seams).</p>
 366
 367 <h5>rigidity</h5>
 368 <p>introduce a bias for non-straight seams (typically 0).</p>
 369
 370 <h5>exception</h5>
 371 <p>return any errors or warnings in this structure.</p>
 372
 373  </div>
 374 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResizeImage">ResizeImage</a></h2>
 375 <div class="doc-section">
 376
 377 <p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo()).</p>
 378
 379 <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>
 380
 381 <p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p>
 382
 383 <p>The format of the ResizeImage method is:</p>
 384
 385 <pre class="code">
 386   Image *ResizeImage(Image *image,const size_t columns,
 387     const size_t rows,const FilterTypes filter,const double blur,
 388     ExceptionInfo *exception)
 389 </pre>
 390
 391 <p>A description of each parameter follows:</p>
 392
 393 <h5>image</h5>
 394 <p>the image.</p>
 395
 396 <h5>columns</h5>
 397 <p>the number of columns in the scaled image.</p>
 398
 399 <h5>rows</h5>
 400 <p>the number of rows in the scaled image.</p>
 401
 402 <h5>filter</h5>
 403 <p>Image filter to use.</p>
 404
 405 <h5>blur</h5>
 406 <p>the blur factor where > 1 is blurry, < 1 is sharp.  Typically set this to 1.0.</p>
 407
 408 <h5>exception</h5>
 409 <p>return any errors or warnings in this structure.</p>
 410
 411  </div>
 412 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="SampleImage">SampleImage</a></h2>
 413 <div class="doc-section">
 414
 415 <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>
 416
 417 <p>The format of the SampleImage method is:</p>
 418
 419 <pre class="code">
 420   Image *SampleImage(const Image *image,const size_t columns,
 421     const size_t rows,ExceptionInfo *exception)
 422 </pre>
 423
 424 <p>A description of each parameter follows:</p>
 425
 426 <h5>image</h5>
 427 <p>the image.</p>
 428
 429 <h5>columns</h5>
 430 <p>the number of columns in the sampled image.</p>
 431
 432 <h5>rows</h5>
 433 <p>the number of rows in the sampled image.</p>
 434
 435 <h5>exception</h5>
 436 <p>return any errors or warnings in this structure.</p>
 437
 438  </div>
 439 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ScaleImage">ScaleImage</a></h2>
 440 <div class="doc-section">
 441
 442 <p>ScaleImage() changes the size of an image to the given dimensions.</p>
 443
 444 <p>The format of the ScaleImage method is:</p>
 445
 446 <pre class="code">
 447   Image *ScaleImage(const Image *image,const size_t columns,
 448     const size_t rows,ExceptionInfo *exception)
 449 </pre>
 450
 451 <p>A description of each parameter follows:</p>
 452
 453 <h5>image</h5>
 454 <p>the image.</p>
 455
 456 <h5>columns</h5>
 457 <p>the number of columns in the scaled image.</p>
 458
 459 <h5>rows</h5>
 460 <p>the number of rows in the scaled image.</p>
 461
 462 <h5>exception</h5>
 463 <p>return any errors or warnings in this structure.</p>
 464
 465  </div>
 466 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ThumbnailImage">ThumbnailImage</a></h2>
 467 <div class="doc-section">
 468
 469 <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>
 470
 471 <p>The format of the ThumbnailImage method is:</p>
 472
 473 <pre class="code">
 474   Image *ThumbnailImage(const Image *image,const size_t columns,
 475     const size_t rows,ExceptionInfo *exception)
 476 </pre>
 477
 478 <p>A description of each parameter follows:</p>
 479
 480 <h5>image</h5>
 481 <p>the image.</p>
 482
 483 <h5>columns</h5>
 484 <p>the number of columns in the scaled image.</p>
 485
 486 <h5>rows</h5>
 487 <p>the number of rows in the scaled image.</p>
 488
 489 <h5>exception</h5>
 490 <p>return any errors or warnings in this structure.</p>
 491
 492  </div>
 493
 494 </div>
 495
 496 <div id="linkbar">
 497     <span id="linkbar-west">&nbsp;</span>
 498     <span id="linkbar-center">
 499       <a href="../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../../discourse-server">Discourse Server</a> &bull;
 500       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
 501     </span>
 502     <span id="linkbar-east">&nbsp;</span>
 503   </div>
 504   <div class="footer">
 505     <span id="footer-west">&copy; 1999-2012 ImageMagick Studio LLC</span>
 506     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
 507   </div>
 508   <div style="clear: both; margin: 0; width: 100%; "></div>
 509   <script type="text/javascript">
 510     var _gaq = _gaq || [];
 511     _gaq.push(['_setAccount', 'UA-17690367-1']);
 512     _gaq.push(['_trackPageview']);
 513
 514     (function() {
 515       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 516       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 517       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 518     })();
 519   </script>
 520 </body>
 521 </html>