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