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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">\r
   4 <head>\r
   5   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
   6   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>\r
   7   <title>ImageMagick: MagickCore, C API for ImageMagick: Resize an Image</title/>
   8   <meta http-equiv="Content-Language" content="en-US"/>
   9   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  10   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  11   <meta name="Application-name" content="ImageMagick"/>
  12   <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
  13   <meta name="Application-url" content="http://www.imagemagick.org"/>
  14   <meta name="Generator" content="PHP"/>
  15   <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"/>
  16   <meta name="Rating" content="GENERAL"/>
  17   <meta name="Robots" content="INDEX, FOLLOW"/>
  18   <meta name="Generator" content="ImageMagick Studio LLC"/>
  19   <meta name="Author" content="ImageMagick Studio LLC"/>
  20   <meta name="Revisit-after" content="2 DAYS"/>
  21   <meta name="Resource-type" content="document"/>
  22   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  23   <meta name="Distribution" content="Global"/>
  24   <link rel="icon" href="../../images/wand.png"  sizes="32x32"/>
  25   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/x-icon"/>
  26   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
  27   <style type="text/css" media="all">\r
  28     @import url("../../www/magick.css");\r
  29   </style>\r
  30 </head>\r
  31 \r
  32 <body id="www-imagemagick-org">\r
  33 <div class="titlebar">\r
  34 <a href="../../index.html">\r
  35   <img src="../../images/script.png" alt="[ImageMagick]"\r
  36   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  37 <a href="http://www.networkredux.com">\r
  38   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  39   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  40 <a href="http://www.imagemagick.org/discourse-server/">\r
  41   <img src="../../images/logo.jpg" alt=""\r
  42   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  43 <a href="../../index.html">\r
  44   <img src="../../images/sprite.jpg" alt=""\r
  45   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  46 </div>\r
  47 \r
  48 <div class="westbar">\r
  49 \r
  50 <div class="menu">
  51   <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
  52 </div>
  53 <div class="sep"></div>\r
  54 <div class="menu">
  55   <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
  56 </div>
  57 <div class="sub">
  58     <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
  59 </div>
  60 <div class="sub">
  61     <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
  62 </div>
  63 <div class="sub">
  64     <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
  65 </div>
  66 <div class="sep"></div>\r
  67 <div class="menu">
  68   <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
  69 </div>
  70 <div class="sub">
  71     <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
  72 </div>
  73 <div class="sub">
  74     <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
  75 </div>
  76 <div class="sub">
  77     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
  78 </div>
  79 <div class="menu">
  80   <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
  81 </div>
  82 <div class="sub">
  83     <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
  84 </div>
  85 <div class="sub">
  86     <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
  87 </div>
  88 <div class="sub">
  89     <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
  90 </div>
  91 <div class="sub">
  92     <a title="Program Interface: Magick++" href="../../Magick++/">Magick++</a>
  93 </div>
  94 <div class="sep"></div>\r
  95 <div  class="menu">
  96    <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
  97 </div>
  98 <div class="sub">
  99     <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
 100 </div>
 101 <div class="sub">
 102     <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
 103  </div>
 104 <div class="menu">
 105   <a title="Resources" href="../../www/resources.html">Resources</a>
 106 </div>
 107 <div class="menu">
 108   <a title="Architecture" href="../../www/architecture.html">Architecture</a>
 109 </div>
 110 <div class="menu">
 111   <a title="Download" href="../../www/download.html">Download</a>
 112 </div>
 113 <div class="sep"></div>\r
 114 <div class="menu">
 115   <a title="Search" href="../http://www.imagemagick.org/script/search.php">Search</a>
 116 </div>
 117 <div class="sep"></div>\r
 118 <div class="menu">
 119   <a title="Site Map"href="../../www/sitemap.html">Site Map</a>
 120 </div>
 121 <div  class="sub">
 122     <a title="Site Map: Links"href="../../www/links.html">Links</a>
 123 </div>
 124 <div class="sep"></div>\r
 125 <div  class="menu">
 126   <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
 127
 128 <div class="sponsbox">
 129 <div  class="sponsor">
 130   <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
 131 </div>
 132 <div  class="sponsor">
 133   <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
 134 </div>
 135 <div  class="sponsor">
 136   <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
 137 </div>
 138 <div  class="sponsor">
 139   <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
 140 </div>
 141 <div  class="sponsor">
 142   <a title="Sponsor: Diamonds are a Girls Best Friend" href="http://www.schmuck.org">Diamonds are a Girls Best Friend</a><!-- 201101010600 Peterssen-->
 143 </div>
 144 <div  class="sponsor">
 145    <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 146 </div>
 147 <div  class="sponsor">
 148    <a title="Sponsor: Webdesign" href="http://www.renehornig.com/">Webdesign</a><!-- 20111001000240 -->
 149 </div>
 150 </div>
 151 </div>
 152 </div>\r
 153 \r
 154 <div class="eastbar">\r
 155   <script type="text/javascript">\r
 156   <!--\r
 157     google_ad_client = "pub-3129977114552745";\r
 158     google_ad_slot = "0574824969";\r
 159     google_ad_width = 160;\r
 160     google_ad_height = 600;\r
 161   //-->\r
 162   </script>\r
 163   <script type="text/javascript"\r
 164     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
 165   </script>\r
 166 </div>\r
 167 \r
 168 <div class="main">\r
 169 \r
 170 <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> &bull; <a href="#ZoomImage">ZoomImage</a>]</p>
 171
 172 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 173 _8c.html" target="source" name="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
 174 <div class="doc-section">
 175
 176 <p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p></ol>
 177
 178 <p>The format of the AdaptiveResizeImage method is:</p>
 179
 180 <pre class="code">
 181   Image *AdaptiveResizeImage(const Image *image,const size_t columns,
 182     const size_t rows,ExceptionInfo *exception)
 183 </pre>
 184
 185 <p>A description of each parameter follows:</p></ol>
 186
 187 <h5>image</h5>
 188 <ol><p>the image.</p></ol>
 189
 190 <h5>columns</h5>
 191 <ol><p>the number of columns in the resized image.</p></ol>
 192
 193 <h5>rows</h5>
 194 <ol><p>the number of rows in the resized image.</p></ol>
 195
 196 <h5>exception</h5>
 197 <ol><p>return any errors or warnings in this structure.</p></ol>
 198
 199  </div>
 200 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 201 _8c.html" target="source" name="MagnifyImage">MagnifyImage</a></h2>
 202 <div class="doc-section">
 203
 204 <p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p></ol>
 205
 206 <p>The format of the MagnifyImage method is:</p>
 207
 208 <pre class="code">
 209   Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
 210 </pre>
 211
 212 <p>A description of each parameter follows:</p></ol>
 213
 214 <h5>image</h5>
 215 <ol><p>the image.</p></ol>
 216
 217 <h5>exception</h5>
 218 <ol><p>return any errors or warnings in this structure.</p></ol>
 219
 220  </div>
 221 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 222 _8c.html" target="source" name="MinifyImage">MinifyImage</a></h2>
 223 <div class="doc-section">
 224
 225 <p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p></ol>
 226
 227 <p>The format of the MinifyImage method is:</p>
 228
 229 <pre class="code">
 230   Image *MinifyImage(const Image *image,ExceptionInfo *exception)
 231 </pre>
 232
 233 <p>A description of each parameter follows:</p></ol>
 234
 235 <h5>image</h5>
 236 <ol><p>the image.</p></ol>
 237
 238 <h5>exception</h5>
 239 <ol><p>return any errors or warnings in this structure.</p></ol>
 240
 241  </div>
 242 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 243 _8c.html" target="source" name="ResampleImage">ResampleImage</a></h2>
 244 <div class="doc-section">
 245
 246 <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></ol>
 247
 248 <p>The format of the ResampleImage method is:</p>
 249
 250 <pre class="code">
 251   Image *ResampleImage(Image *image,const double x_resolution,
 252     const double y_resolution,const FilterTypes filter,const double blur,
 253     ExceptionInfo *exception)
 254 </pre>
 255
 256 <p>A description of each parameter follows:</p></ol>
 257
 258 <h5>image</h5>
 259 <ol><p>the image to be resized to fit the given resolution.</p></ol>
 260
 261 <h5>x_resolution</h5>
 262 <ol><p>the new image x resolution.</p></ol>
 263
 264 <h5>y_resolution</h5>
 265 <ol><p>the new image y resolution.</p></ol>
 266
 267 <h5>filter</h5>
 268 <ol><p>Image filter to use.</p></ol>
 269
 270 <h5>blur</h5>
 271 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
 272
 273  </div>
 274 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 275 _8c.html" target="source" name="LiquidRescaleImage">LiquidRescaleImage</a></h2>
 276 <div class="doc-section">
 277
 278 <p>LiquidRescaleImage() rescales image with seam carving.</p></ol>
 279
 280 <p>The format of the LiquidRescaleImage method is:</p>
 281
 282 <pre class="code">
 283   Image *LiquidRescaleImage(const Image *image,
 284     const size_t columns,const size_t rows,
 285     const double delta_x,const double rigidity,ExceptionInfo *exception)
 286 </pre>
 287
 288 <p>A description of each parameter follows:</p></ol>
 289
 290 <h5>image</h5>
 291 <ol><p>the image.</p></ol>
 292
 293 <h5>columns</h5>
 294 <ol><p>the number of columns in the rescaled image.</p></ol>
 295
 296 <h5>rows</h5>
 297 <ol><p>the number of rows in the rescaled image.</p></ol>
 298
 299 <h5>delta_x</h5>
 300 <ol><p>maximum seam transversal step (0 means straight seams).</p></ol>
 301
 302 <h5>rigidity</h5>
 303 <ol><p>introduce a bias for non-straight seams (typically 0).</p></ol>
 304
 305 <h5>exception</h5>
 306 <ol><p>return any errors or warnings in this structure.</p></ol>
 307
 308  </div>
 309 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 310 _8c.html" target="source" name="ResizeImage">ResizeImage</a></h2>
 311 <div class="doc-section">
 312
 313 <p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo() ).</p></ol>
 314
 315 <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></ol>
 316
 317 <p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p></ol>
 318
 319 <p>The format of the ResizeImage method is:</p>
 320
 321 <pre class="code">
 322   Image *ResizeImage(Image *image,const size_t columns,
 323     const size_t rows,const FilterTypes filter,const double blur,
 324     ExceptionInfo *exception)
 325 </pre>
 326
 327 <p>A description of each parameter follows:</p></ol>
 328
 329 <h5>image</h5>
 330 <ol><p>the image.</p></ol>
 331
 332 <h5>columns</h5>
 333 <ol><p>the number of columns in the scaled image.</p></ol>
 334
 335 <h5>rows</h5>
 336 <ol><p>the number of rows in the scaled image.</p></ol>
 337
 338 <h5>filter</h5>
 339 <ol><p>Image filter to use.</p></ol>
 340
 341 <h5>blur</h5>
 342 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp.  Typically set this to 1.0.</p></ol>
 343
 344 <h5>exception</h5>
 345 <ol><p>return any errors or warnings in this structure.</p></ol>
 346
 347  </div>
 348 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 349 _8c.html" target="source" name="SampleImage">SampleImage</a></h2>
 350 <div class="doc-section">
 351
 352 <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></ol>
 353
 354 <p>The format of the SampleImage method is:</p>
 355
 356 <pre class="code">
 357   Image *SampleImage(const Image *image,const size_t columns,
 358     const size_t rows,ExceptionInfo *exception)
 359 </pre>
 360
 361 <p>A description of each parameter follows:</p></ol>
 362
 363 <h5>image</h5>
 364 <ol><p>the image.</p></ol>
 365
 366 <h5>columns</h5>
 367 <ol><p>the number of columns in the sampled image.</p></ol>
 368
 369 <h5>rows</h5>
 370 <ol><p>the number of rows in the sampled image.</p></ol>
 371
 372 <h5>exception</h5>
 373 <ol><p>return any errors or warnings in this structure.</p></ol>
 374
 375  </div>
 376 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 377 _8c.html" target="source" name="ScaleImage">ScaleImage</a></h2>
 378 <div class="doc-section">
 379
 380 <p>ScaleImage() changes the size of an image to the given dimensions.</p></ol>
 381
 382 <p>The format of the ScaleImage method is:</p>
 383
 384 <pre class="code">
 385   Image *ScaleImage(const Image *image,const size_t columns,
 386     const size_t rows,ExceptionInfo *exception)
 387 </pre>
 388
 389 <p>A description of each parameter follows:</p></ol>
 390
 391 <h5>image</h5>
 392 <ol><p>the image.</p></ol>
 393
 394 <h5>columns</h5>
 395 <ol><p>the number of columns in the scaled image.</p></ol>
 396
 397 <h5>rows</h5>
 398 <ol><p>the number of rows in the scaled image.</p></ol>
 399
 400 <h5>exception</h5>
 401 <ol><p>return any errors or warnings in this structure.</p></ol>
 402
 403  </div>
 404 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 405 _8c.html" target="source" name="ThumbnailImage">ThumbnailImage</a></h2>
 406 <div class="doc-section">
 407
 408 <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></ol>
 409
 410 <p>The format of the ThumbnailImage method is:</p>
 411
 412 <pre class="code">
 413   Image *ThumbnailImage(const Image *image,const size_t columns,
 414     const size_t rows,ExceptionInfo *exception)
 415 </pre>
 416
 417 <p>A description of each parameter follows:</p></ol>
 418
 419 <h5>image</h5>
 420 <ol><p>the image.</p></ol>
 421
 422 <h5>columns</h5>
 423 <ol><p>the number of columns in the scaled image.</p></ol>
 424
 425 <h5>rows</h5>
 426 <ol><p>the number of rows in the scaled image.</p></ol>
 427
 428 <h5>exception</h5>
 429 <ol><p>return any errors or warnings in this structure.</p></ol>
 430
 431  </div>
 432 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 433 _8c.html" target="source" name="ZoomImage">ZoomImage</a></h2>
 434 <div class="doc-section">
 435
 436 <p>ZoomImage() creates a new image that is a scaled size of an existing one. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.  The Point filter gives fast pixel replication, Triangle is equivalent to bi-linear interpolation, and Mitchel giver slower, very high-quality results.  See Graphic Gems III for details on this algorithm.</p></ol>
 437
 438 <p>The filter member of the Image structure specifies which image filter to use. Blur specifies the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
 439
 440 <p>The format of the ZoomImage method is:</p>
 441
 442 <pre class="code">
 443   Image *ZoomImage(const Image *image,const size_t columns,
 444     const size_t rows,ExceptionInfo *exception)
 445 </pre>
 446
 447 <p>A description of each parameter follows:</p></ol>
 448
 449 <h5>image</h5>
 450 <ol><p>the image.</p></ol>
 451
 452 <h5>columns</h5>
 453 <ol><p>An integer that specifies the number of columns in the zoom image.</p></ol>
 454
 455 <h5>rows</h5>
 456 <ol><p>An integer that specifies the number of rows in the scaled image.</p></ol>
 457
 458 <h5>exception</h5>
 459 <ol><p>return any errors or warnings in this structure.</p></ol>
 460
 461  </div>
 462 \r
 463 </div>\r
 464 \r
 465 <div id="linkbar">\r
 466     <span id="linkbar-west">&nbsp;</span>\r
 467     <span id="linkbar-center">\r
 468       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 469       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 470     </span>\r
 471     <span id="linkbar-east">&nbsp;</span>\r
 472   </div>\r
 473   <div class="footer">\r
 474     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
 475     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 476   </div>\r
 477   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 478   <script type="text/javascript">\r
 479     var _gaq = _gaq || [];\r
 480     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 481     _gaq.push(['_trackPageview']);\r
 482 \r
 483     (function() {\r
 484       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 485       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 486       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 487     })();\r
 488   </script>\r
 489 </body>\r
 490 </html>\r