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