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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" \r
   2   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   3 <html version="-//W3C//DTD XHTML 1.1//EN"\r
   4       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"\r
   5       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\r
   6       xsi:schemaLocation="http://www.w3.org/1999/xhtml\r
   7                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">\r
   8 <head>\r
   9   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
  10   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>\r
  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."/>
  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, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  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-2011 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="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
  31   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />\r
  32   <style type="text/css" media="all">\r
  33     @import url("../../www/magick.css");\r
  34   </style>\r
  35   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>\r
  36   <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>\r
  37   <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />\r
  38   <script type="text/javascript">\r
  39     $(document).ready(function() {\r
  40       $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({\r
  41         'transitionIn'  : 'elastic',\r
  42         'transitionOut' : 'elastic',\r
  43         'overlayShow'   : false,\r
  44         'opacity'       : true\r
  45       });\r
  46     });\r
  47   </script>\r
  48 </head>\r
  49 \r
  50 <body id="www-imagemagick-org">\r
  51 <div class="titlebar">\r
  52 <div style="margin: 17px auto; float: left;">\r
  53   <script type="text/javascript">\r
  54   <!--\r
  55     google_ad_client = "pub-3129977114552745";\r
  56     google_ad_slot = "5439289906";\r
  57     google_ad_width = 728;\r
  58     google_ad_height = 90;\r
  59   //-->\r
  60   </script>\r
  61   <script type="text/javascript"\r
  62     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
  63   </script>\r
  64 </div>\r
  65 <a href="http://www.imagemagick.org/discourse-server/">\r
  66   <img src="../../images/logo.jpg"\r
  67   alt="ImageMagick Logo"\r
  68   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>\r
  69 <a href="../../index.html">\r
  70   <img src="../../images/sprite.jpg"\r
  71   alt="ImageMagick Sprite"\r
  72   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  73 </div>\r
  74 \r
  75 <div class="westbar">\r
  76 \r
  77 <div class="menu">
  78   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  79 </div>
  80 <div class="sep"></div>\r
  81 <div class="menu">
  82   <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
  83 </div>
  84 <div class="sub">
  85     <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
  86 </div>
  87 <div class="sub">
  88     <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
  89 </div>
  90 <div class="sub">
  91     <a title="Binary Release: iPhone" href="../../www/binary-releases.html#iPhone">iPhone</a>
  92 </div>
  93 <div class="sub">
  94     <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
  95 </div>
  96 <div class="sep"></div>\r
  97 <div class="menu">
  98   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  99 </div>
 100 <div class="sub">
 101     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
 102 </div>
 103 <div class="sub">
 104     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
 105 </div>
 106 <div class="sub">
 107     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 108 </div>
 109 <div class="menu">
 110   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
 111 </div>
 112 <div class="sub">
 113     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
 114 </div>
 115 <div class="sub">
 116     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
 117 </div>
 118 <div class="sub">
 119     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
 120 </div>
 121 <div class="sub">
 122     <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
 123 </div>
 124 <div class="sep"></div>\r
 125 <div  class="menu">
 126    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
 127 </div>
 128 <div class="sub">
 129     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
 130 </div>
 131 <div class="sub">
 132     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 133  </div>
 134 <div class="menu">
 135   <a title="Resources" href="../../www/resources.html">Resources</a>
 136 </div>
 137 <div class="menu">
 138   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 139 </div>
 140 <div class="menu">
 141   <a title="Download" href="../../www/download.html">Download</a>
 142 </div>
 143 <div class="sep"></div>\r
 144 <div class="menu">
 145   <a title="Search" href="../../www/search.html">Search</a>
 146 </div>
 147 <div class="sep"></div>\r
 148 <div class="menu">
 149   <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
 150 </div>
 151 <div  class="sub">
 152   <a title="Site Map: Links" href="../../www/links.html">Links</a>
 153 </div>
 154 <div class="sep"></div>\r
 155 <div  class="menu">
 156   <a rel="follow" title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 157
 158 <a href="http://www.networkredux.com">
 159   <img src="../../images/networkredux.png" alt="[sponsor]"
 160   style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
 161 <div class="sponsbox">
 162 <div  class="sponsor">
 163   <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
 164 </div>
 165 <div  class="sponsor">
 166   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 167 </div>
 168 <div  class="sponsor">
 169   <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
 170 </div>
 171 <div  class="sponsor">
 172   <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
 173 </div>
 174 <div  class="sponsor">
 175   <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
 176 </div>
 177 <div  class="sponsor">
 178   <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 179 </div>
 180 <div  class="sponsor">
 181   <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingmasters.com">Web Hosting Reviews</a><!-- 201107011500 affliatelabel -->
 182 </div>
 183 <div  class="sponsor">
 184   <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
 185 </div>
 186 <div  class="sponsor">
 187   <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
 188 </div>
 189 <div  class="sponsor">
 190    <a rel="follow" title="Sponsor: Autoteile Online Shop" href="http://www.autoteile-carparts.de">Autoteile Online Shop</a><!-- 2011080100030 autoteile-Carparts-->
 191 </div>
 192 </div>
 193 </div>
 194 </div>\r
 195 \r
 196 <div class="eastbar">\r
 197 \r
 198 </div>\r
 199 \r
 200 <div class="main">\r
 201 \r
 202 <h1>Module resize Methods</h1>
 203 <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>
 204
 205 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
 206 <div class="doc-section">
 207
 208 <p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p>
 209
 210 <p>The format of the AdaptiveResizeImage method is:</p>
 211
 212 <pre class="code">
 213   Image *AdaptiveResizeImage(const Image *image,const size_t columns,
 214     const size_t rows,ExceptionInfo *exception)
 215 </pre>
 216
 217 <p>A description of each parameter follows:</p>
 218
 219 <h5>image</h5>
 220 <p>the image.</p>
 221
 222 <h5>columns</h5>
 223 <p>the number of columns in the resized image.</p>
 224
 225 <h5>rows</h5>
 226 <p>the number of rows in the resized image.</p>
 227
 228 <h5>exception</h5>
 229 <p>return any errors or warnings in this structure.</p>
 230
 231  </div>
 232 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MagnifyImage">MagnifyImage</a></h2>
 233 <div class="doc-section">
 234
 235 <p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p>
 236
 237 <p>The format of the MagnifyImage method is:</p>
 238
 239 <pre class="code">
 240   Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
 241 </pre>
 242
 243 <p>A description of each parameter follows:</p>
 244
 245 <h5>image</h5>
 246 <p>the image.</p>
 247
 248 <h5>exception</h5>
 249 <p>return any errors or warnings in this structure.</p>
 250
 251  </div>
 252 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="MinifyImage">MinifyImage</a></h2>
 253 <div class="doc-section">
 254
 255 <p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p>
 256
 257 <p>The format of the MinifyImage method is:</p>
 258
 259 <pre class="code">
 260   Image *MinifyImage(const Image *image,ExceptionInfo *exception)
 261 </pre>
 262
 263 <p>A description of each parameter follows:</p>
 264
 265 <h5>image</h5>
 266 <p>the image.</p>
 267
 268 <h5>exception</h5>
 269 <p>return any errors or warnings in this structure.</p>
 270
 271  </div>
 272 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResampleImage">ResampleImage</a></h2>
 273 <div class="doc-section">
 274
 275 <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>
 276
 277 <p>The format of the ResampleImage method is:</p>
 278
 279 <pre class="code">
 280   Image *ResampleImage(Image *image,const double x_resolution,
 281     const double y_resolution,const FilterTypes filter,const double blur,
 282     ExceptionInfo *exception)
 283 </pre>
 284
 285 <p>A description of each parameter follows:</p>
 286
 287 <h5>image</h5>
 288 <p>the image to be resized to fit the given resolution.</p>
 289
 290 <h5>x_resolution</h5>
 291 <p>the new image x resolution.</p>
 292
 293 <h5>y_resolution</h5>
 294 <p>the new image y resolution.</p>
 295
 296 <h5>filter</h5>
 297 <p>Image filter to use.</p>
 298
 299 <h5>blur</h5>
 300 <p>the blur factor where > 1 is blurry, < 1 is sharp.</p>
 301
 302  </div>
 303 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="LiquidRescaleImage">LiquidRescaleImage</a></h2>
 304 <div class="doc-section">
 305
 306 <p>LiquidRescaleImage() rescales image with seam carving.</p>
 307
 308 <p>The format of the LiquidRescaleImage method is:</p>
 309
 310 <pre class="code">
 311   Image *LiquidRescaleImage(const Image *image,
 312     const size_t columns,const size_t rows,
 313     const double delta_x,const double rigidity,ExceptionInfo *exception)
 314 </pre>
 315
 316 <p>A description of each parameter follows:</p>
 317
 318 <h5>image</h5>
 319 <p>the image.</p>
 320
 321 <h5>columns</h5>
 322 <p>the number of columns in the rescaled image.</p>
 323
 324 <h5>rows</h5>
 325 <p>the number of rows in the rescaled image.</p>
 326
 327 <h5>delta_x</h5>
 328 <p>maximum seam transversal step (0 means straight seams).</p>
 329
 330 <h5>rigidity</h5>
 331 <p>introduce a bias for non-straight seams (typically 0).</p>
 332
 333 <h5>exception</h5>
 334 <p>return any errors or warnings in this structure.</p>
 335
 336  </div>
 337 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ResizeImage">ResizeImage</a></h2>
 338 <div class="doc-section">
 339
 340 <p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo()).</p>
 341
 342 <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>
 343
 344 <p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p>
 345
 346 <p>The format of the ResizeImage method is:</p>
 347
 348 <pre class="code">
 349   Image *ResizeImage(Image *image,const size_t columns,
 350     const size_t rows,const FilterTypes filter,const double blur,
 351     ExceptionInfo *exception)
 352 </pre>
 353
 354 <p>A description of each parameter follows:</p>
 355
 356 <h5>image</h5>
 357 <p>the image.</p>
 358
 359 <h5>columns</h5>
 360 <p>the number of columns in the scaled image.</p>
 361
 362 <h5>rows</h5>
 363 <p>the number of rows in the scaled image.</p>
 364
 365 <h5>filter</h5>
 366 <p>Image filter to use.</p>
 367
 368 <h5>blur</h5>
 369 <p>the blur factor where > 1 is blurry, < 1 is sharp.  Typically set this to 1.0.</p>
 370
 371 <h5>exception</h5>
 372 <p>return any errors or warnings in this structure.</p>
 373
 374  </div>
 375 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="SampleImage">SampleImage</a></h2>
 376 <div class="doc-section">
 377
 378 <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>
 379
 380 <p>The format of the SampleImage method is:</p>
 381
 382 <pre class="code">
 383   Image *SampleImage(const Image *image,const size_t columns,
 384     const size_t rows,ExceptionInfo *exception)
 385 </pre>
 386
 387 <p>A description of each parameter follows:</p>
 388
 389 <h5>image</h5>
 390 <p>the image.</p>
 391
 392 <h5>columns</h5>
 393 <p>the number of columns in the sampled image.</p>
 394
 395 <h5>rows</h5>
 396 <p>the number of rows in the sampled image.</p>
 397
 398 <h5>exception</h5>
 399 <p>return any errors or warnings in this structure.</p>
 400
 401  </div>
 402 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ScaleImage">ScaleImage</a></h2>
 403 <div class="doc-section">
 404
 405 <p>ScaleImage() changes the size of an image to the given dimensions.</p>
 406
 407 <p>The format of the ScaleImage method is:</p>
 408
 409 <pre class="code">
 410   Image *ScaleImage(const Image *image,const size_t columns,
 411     const size_t rows,ExceptionInfo *exception)
 412 </pre>
 413
 414 <p>A description of each parameter follows:</p>
 415
 416 <h5>image</h5>
 417 <p>the image.</p>
 418
 419 <h5>columns</h5>
 420 <p>the number of columns in the scaled image.</p>
 421
 422 <h5>rows</h5>
 423 <p>the number of rows in the scaled image.</p>
 424
 425 <h5>exception</h5>
 426 <p>return any errors or warnings in this structure.</p>
 427
 428  </div>
 429 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize_8c.html" id="ThumbnailImage">ThumbnailImage</a></h2>
 430 <div class="doc-section">
 431
 432 <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>
 433
 434 <p>The format of the ThumbnailImage method is:</p>
 435
 436 <pre class="code">
 437   Image *ThumbnailImage(const Image *image,const size_t columns,
 438     const size_t rows,ExceptionInfo *exception)
 439 </pre>
 440
 441 <p>A description of each parameter follows:</p>
 442
 443 <h5>image</h5>
 444 <p>the image.</p>
 445
 446 <h5>columns</h5>
 447 <p>the number of columns in the scaled image.</p>
 448
 449 <h5>rows</h5>
 450 <p>the number of rows in the scaled image.</p>
 451
 452 <h5>exception</h5>
 453 <p>return any errors or warnings in this structure.</p>
 454
 455  </div>
 456 \r
 457 </div>\r
 458 \r
 459 <div id="linkbar">\r
 460     <span id="linkbar-west">&nbsp;</span>\r
 461     <span id="linkbar-center">\r
 462       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 463       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 464     </span>\r
 465     <span id="linkbar-east">&nbsp;</span>\r
 466   </div>\r
 467   <div class="footer">\r
 468     <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>\r
 469     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 470   </div>\r
 471   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 472   <script type="text/javascript">\r
 473     var _gaq = _gaq || [];\r
 474     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 475     _gaq.push(['_trackPageview']);\r
 476 \r
 477     (function() {\r
 478       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 479       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 480       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 481     })();\r
 482   </script>\r
 483 </body>\r
 484 </html>\r