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">\r
   4 <head>\r
   5   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
   6   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
   7   <style type="text/css" media="screen,projection"><!--\r
   8     @import url("../../www/magick.css");\r
   9   --></style>\r
  10   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  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="Generator" content="PHP"/>
  16   <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"/>
  17   <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."/>
  18   <meta name="Rating" content="GENERAL"/>
  19   <meta name="Robots" content="INDEX, FOLLOW"/>
  20   <meta name="Generator" content="ImageMagick Studio LLC"/>
  21   <meta name="Author" content="ImageMagick Studio LLC"/>
  22   <meta name="Revisit-after" content="2 DAYS"/>
  23   <meta name="Resource-type" content="document"/>
  24   <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
  25   <meta name="Distribution" content="Global"/>
  26 </head>\r
  27 \r
  28 <body id="www-imagemagick-org">\r
  29 <div class="titlebar">\r
  30 <a href="../../index.html">\r
  31   <img src="../../images/script.png" alt="[ImageMagick]"\r
  32   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
  33 <a href="http://www.networkredux.com">\r
  34   <img src="../../images/networkredux.png" alt="[sponsor]"\r
  35   style="margin: 45px auto; border: 0px; float: left;" /></a>\r
  36 <a href="http://www.imagemagick.org/discourse-server/">\r
  37   <img src="../../images/logo.jpg" alt=""\r
  38   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  39 <a href="../../index.html">\r
  40   <img src="../../images/sprite.jpg" alt=""\r
  41   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  42 </div>\r
  43 \r
  44 <div class="eastbar">\r
  45 \r
  46 <div class="menu">
  47   <a href="../../index.html">About ImageMagick</a>
  48 </div>
  49 <div class="sep"></div>\r
  50 <div class="menu">
  51   <a href="../../www/command-line-tools.html">Command-line Tools</a>
  52 </div>
  53 <div class="sub">
  54     <a href="../../www/command-line-processing.html">Processing</a>
  55 </div>
  56 <div class="sub">
  57     <a href="../../www/command-line-options.html">Options</a>
  58 </div>
  59 <div class="sub">
  60     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  61 </div>
  62 <div class="menu">
  63   <a href="../../www/api.html">Program Interfaces</a>
  64 </div>
  65 <div class="sub">
  66     <a href="../../www/magick-wand.html">MagickWand</a>
  67 </div>
  68 <div class="sub">
  69     <a href="../../www/magick-core.html">MagickCore</a>
  70 </div>
  71 <div class="sub">
  72     <a href="../../www/perl-magick.html">PerlMagick</a>
  73 </div>
  74 <div class="sub">
  75     <a href="../../Magick++/">Magick++</a>
  76 </div>
  77 <div class="menu">
  78   <a href="../../www/architecture.html">Architecture</a>
  79 </div>
  80 <div class="sep"></div>\r
  81 <div  class="menu">
  82    <a href="../../www/install-source.html">Install from Source</a>
  83 </div>
  84 <div class="sub">
  85     <a href="../../www/install-source.html#unix">Unix</a>
  86 </div>
  87 <div class="sub">
  88     <a href="../../www/install-source.html#windows">Windows</a>
  89  </div>
  90 <div class="menu">
  91   <a href="../../www/binary-releases.html">Binary Releases</a>
  92 </div>
  93 <div class="sub">
  94     <a href="../../www/binary-releases.html#unix">Unix</a>
  95 </div>
  96 <div class="sub">
  97     <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
  98 </div>
  99 <div class="sub">
 100     <a href="../../www/binary-releases.html#windows">Windows</a>
 101 </div>
 102 <div class="menu">
 103   <a href="../../www/resources.html">Resources</a>
 104 </div>
 105 <div class="sep"></div>\r
 106 <div class="menu">
 107   <a href="../../www/download.html">Download</a>
 108 </div>
 109 <div class="sep"></div>\r
 110 <div class="menu">
 111   <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 112 </div>
 113 <div class="sep"></div>\r
 114 <div class="menu">
 115   <a href="../../www/sitemap.html">Site Map</a>
 116 </div>
 117 <div  class="sub">
 118     <a href="../../www/links.html">Links</a>
 119 </div>
 120 <div class="sep"></div>\r
 121 <div  class="menu">
 122   <a href="../../www/sponsors.html">Sponsors:</a>
 123
 124 <div class="sponsbox">
 125 <div  class="sponsor">
 126    <a href="http://www.buerodruck.de/stempel-service/index.html">Stempel bestellen</a><!-- 200910000035+ -->
 127 </div>
 128 <div  class="sponsor">
 129    <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 130 </div>
 131 <div  class="sponsor">
 132    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 133 </div>
 134 <div  class="sponsor">
 135   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 136 </div>
 137 <div  class="sponsor">
 138   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 142 </div>
 143 <div  class="sponsor">
 144   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
 145 </div>
 146 </div>
 147 </div>
 148 \r
 149 \r
 150 </div>\r
 151 \r
 152 <div class="main">\r
 153 \r
 154 <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>
 155
 156 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 157 _8c.html" target="source" name="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
 158 <div class="doc-section">
 159
 160 <p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p></ol>
 161
 162 <p>The format of the AdaptiveResizeImage method is:</p>
 163
 164 <pre class="code">
 165   Image *AdaptiveResizeImage(const Image *image,
 166     const unsigned long columns,const unsigned long rows,
 167     ExceptionInfo *exception)
 168 </pre>
 169
 170 <p>A description of each parameter follows:</p></ol>
 171
 172 <h5>image</h5>
 173 <ol><p>the image.</p></ol>
 174
 175 <h5>columns</h5>
 176 <ol><p>the number of columns in the resized image.</p></ol>
 177
 178 <h5>rows</h5>
 179 <ol><p>the number of rows in the resized image.</p></ol>
 180
 181 <h5>exception</h5>
 182 <ol><p>return any errors or warnings in this structure.</p></ol>
 183
 184  </div>
 185 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 186 _8c.html" target="source" name="MagnifyImage">MagnifyImage</a></h2>
 187 <div class="doc-section">
 188
 189 <p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p></ol>
 190
 191 <p>The format of the MagnifyImage method is:</p>
 192
 193 <pre class="code">
 194   Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
 195 </pre>
 196
 197 <p>A description of each parameter follows:</p></ol>
 198
 199 <h5>image</h5>
 200 <ol><p>the image.</p></ol>
 201
 202 <h5>exception</h5>
 203 <ol><p>return any errors or warnings in this structure.</p></ol>
 204
 205  </div>
 206 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 207 _8c.html" target="source" name="MinifyImage">MinifyImage</a></h2>
 208 <div class="doc-section">
 209
 210 <p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p></ol>
 211
 212 <p>The format of the MinifyImage method is:</p>
 213
 214 <pre class="code">
 215   Image *MinifyImage(const Image *image,ExceptionInfo *exception)
 216 </pre>
 217
 218 <p>A description of each parameter follows:</p></ol>
 219
 220 <h5>image</h5>
 221 <ol><p>the image.</p></ol>
 222
 223 <h5>exception</h5>
 224 <ol><p>return any errors or warnings in this structure.</p></ol>
 225
 226  </div>
 227 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 228 _8c.html" target="source" name="ResampleImage">ResampleImage</a></h2>
 229 <div class="doc-section">
 230
 231 <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>
 232
 233 <p>The format of the ResampleImage method is:</p>
 234
 235 <pre class="code">
 236   Image *ResampleImage(Image *image,const double x_resolution,
 237     const double y_resolution,const FilterTypes filter,const double blur,
 238     ExceptionInfo *exception)
 239 </pre>
 240
 241 <p>A description of each parameter follows:</p></ol>
 242
 243 <h5>image</h5>
 244 <ol><p>the image to be resized to fit the given resolution.</p></ol>
 245
 246 <h5>x_resolution</h5>
 247 <ol><p>the new image x resolution.</p></ol>
 248
 249 <h5>y_resolution</h5>
 250 <ol><p>the new image y resolution.</p></ol>
 251
 252 <h5>filter</h5>
 253 <ol><p>Image filter to use.</p></ol>
 254
 255 <h5>blur</h5>
 256 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
 257
 258  </div>
 259 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 260 _8c.html" target="source" name="LiquidRescaleImage">LiquidRescaleImage</a></h2>
 261 <div class="doc-section">
 262
 263 <p>LiquidRescaleImage() rescales image with seam carving.</p></ol>
 264
 265 <p>The format of the LiquidRescaleImage method is:</p>
 266
 267 <pre class="code">
 268   Image *LiquidRescaleImage(const Image *image,
 269     const unsigned long columns,const unsigned long rows,
 270     const double delta_x,const double rigidity,ExceptionInfo *exception)
 271 </pre>
 272
 273 <p>A description of each parameter follows:</p></ol>
 274
 275 <h5>image</h5>
 276 <ol><p>the image.</p></ol>
 277
 278 <h5>columns</h5>
 279 <ol><p>the number of columns in the rescaled image.</p></ol>
 280
 281 <h5>rows</h5>
 282 <ol><p>the number of rows in the rescaled image.</p></ol>
 283
 284 <h5>delta_x</h5>
 285 <ol><p>maximum seam transversal step (0 means straight seams).</p></ol>
 286
 287 <h5>rigidity</h5>
 288 <ol><p>introduce a bias for non-straight seams (typically 0).</p></ol>
 289
 290 <h5>exception</h5>
 291 <ol><p>return any errors or warnings in this structure.</p></ol>
 292
 293  </div>
 294 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 295 _8c.html" target="source" name="ResizeImage">ResizeImage</a></h2>
 296 <div class="doc-section">
 297
 298 <p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo() ).</p></ol>
 299
 300 <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>
 301
 302 <p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p></ol>
 303
 304 <p>The format of the ResizeImage method is:</p>
 305
 306 <pre class="code">
 307   Image *ResizeImage(Image *image,const unsigned long columns,
 308     const unsigned long rows,const FilterTypes filter,const double blur,
 309     ExceptionInfo *exception)
 310 </pre>
 311
 312 <p>A description of each parameter follows:</p></ol>
 313
 314 <h5>image</h5>
 315 <ol><p>the image.</p></ol>
 316
 317 <h5>columns</h5>
 318 <ol><p>the number of columns in the scaled image.</p></ol>
 319
 320 <h5>rows</h5>
 321 <ol><p>the number of rows in the scaled image.</p></ol>
 322
 323 <h5>filter</h5>
 324 <ol><p>Image filter to use.</p></ol>
 325
 326 <h5>blur</h5>
 327 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p></ol>
 328
 329 <h5>exception</h5>
 330 <ol><p>return any errors or warnings in this structure.</p></ol>
 331
 332  </div>
 333 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 334 _8c.html" target="source" name="SampleImage">SampleImage</a></h2>
 335 <div class="doc-section">
 336
 337 <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>
 338
 339 <p>The format of the SampleImage method is:</p>
 340
 341 <pre class="code">
 342   Image *SampleImage(const Image *image,const unsigned long columns,
 343     const unsigned long rows,ExceptionInfo *exception)
 344 </pre>
 345
 346 <p>A description of each parameter follows:</p></ol>
 347
 348 <h5>image</h5>
 349 <ol><p>the image.</p></ol>
 350
 351 <h5>columns</h5>
 352 <ol><p>the number of columns in the sampled image.</p></ol>
 353
 354 <h5>rows</h5>
 355 <ol><p>the number of rows in the sampled image.</p></ol>
 356
 357 <h5>exception</h5>
 358 <ol><p>return any errors or warnings in this structure.</p></ol>
 359
 360  </div>
 361 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 362 _8c.html" target="source" name="ScaleImage">ScaleImage</a></h2>
 363 <div class="doc-section">
 364
 365 <p>ScaleImage() changes the size of an image to the given dimensions.</p></ol>
 366
 367 <p>The format of the ScaleImage method is:</p>
 368
 369 <pre class="code">
 370   Image *ScaleImage(const Image *image,const unsigned long columns,
 371     const unsigned long rows,ExceptionInfo *exception)
 372 </pre>
 373
 374 <p>A description of each parameter follows:</p></ol>
 375
 376 <h5>image</h5>
 377 <ol><p>the image.</p></ol>
 378
 379 <h5>columns</h5>
 380 <ol><p>the number of columns in the scaled image.</p></ol>
 381
 382 <h5>rows</h5>
 383 <ol><p>the number of rows in the scaled image.</p></ol>
 384
 385 <h5>exception</h5>
 386 <ol><p>return any errors or warnings in this structure.</p></ol>
 387
 388  </div>
 389 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 390 _8c.html" target="source" name="ThumbnailImage">ThumbnailImage</a></h2>
 391 <div class="doc-section">
 392
 393 <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>
 394
 395 <p>The format of the ThumbnailImage method is:</p>
 396
 397 <pre class="code">
 398   Image *ThumbnailImage(const Image *image,const unsigned long columns,
 399     const unsigned long rows,ExceptionInfo *exception)
 400 </pre>
 401
 402 <p>A description of each parameter follows:</p></ol>
 403
 404 <h5>image</h5>
 405 <ol><p>the image.</p></ol>
 406
 407 <h5>columns</h5>
 408 <ol><p>the number of columns in the scaled image.</p></ol>
 409
 410 <h5>rows</h5>
 411 <ol><p>the number of rows in the scaled image.</p></ol>
 412
 413 <h5>exception</h5>
 414 <ol><p>return any errors or warnings in this structure.</p></ol>
 415
 416  </div>
 417 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 418 _8c.html" target="source" name="ZoomImage">ZoomImage</a></h2>
 419 <div class="doc-section">
 420
 421 <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>
 422
 423 <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>
 424
 425 <p>The format of the ZoomImage method is:</p>
 426
 427 <pre class="code">
 428   Image *ZoomImage(const Image *image,const unsigned long columns,
 429     const unsigned long rows,ExceptionInfo *exception)
 430 </pre>
 431
 432 <p>A description of each parameter follows:</p></ol>
 433
 434 <h5>image</h5>
 435 <ol><p>the image.</p></ol>
 436
 437 <h5>columns</h5>
 438 <ol><p>An integer that specifies the number of columns in the zoom image.</p></ol>
 439
 440 <h5>rows</h5>
 441 <ol><p>An integer that specifies the number of rows in the scaled image.</p></ol>
 442
 443 <h5>exception</h5>
 444 <ol><p>return any errors or warnings in this structure.</p></ol>
 445
 446  </div>
 447 \r
 448 </div>\r
 449 \r
 450 <div id="linkbar">\r
 451  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 452     <span id="linkbar-center">\r
 453       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 454       <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;\r
 455     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 456     </span>\r
 457     <span id="linkbar-east">&nbsp;</span>\r
 458   </div>\r
 459   <div class="footer">\r
 460     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>\r
 461     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 462   </div>\r
 463   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 464 </body>\r
 465 </html>\r