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.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 127 </div>
 128 <div  class="sponsor">
 129    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 130 </div>
 131 <div  class="sponsor">
 132   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 133 </div>
 134 <div  class="sponsor">
 135   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 136 </div>
 137 <div  class="sponsor">
 138   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 139 </div>
 140 <div  class="sponsor">
 141   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
 142 </div>
 143 </div>
 144 </div>
 145 \r
 146 \r
 147 </div>\r
 148 \r
 149 <div class="main">\r
 150 \r
 151 <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>
 152
 153 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 154 _8c.html" target="source" name="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
 155 <div class="doc-section">
 156
 157 <p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p></ol>
 158
 159 <p>The format of the AdaptiveResizeImage method is:</p>
 160
 161 <pre class="code">
 162   Image *AdaptiveResizeImage(const Image *image,
 163     const unsigned long columns,const unsigned long rows,
 164     ExceptionInfo *exception)
 165 </pre>
 166
 167 <p>A description of each parameter follows:</p></ol>
 168
 169 <h5>image</h5>
 170 <ol><p>the image.</p></ol>
 171
 172 <h5>columns</h5>
 173 <ol><p>the number of columns in the resized image.</p></ol>
 174
 175 <h5>rows</h5>
 176 <ol><p>the number of rows in the resized image.</p></ol>
 177
 178 <h5>exception</h5>
 179 <ol><p>return any errors or warnings in this structure.</p></ol>
 180
 181  </div>
 182 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 183 _8c.html" target="source" name="MagnifyImage">MagnifyImage</a></h2>
 184 <div class="doc-section">
 185
 186 <p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p></ol>
 187
 188 <p>The format of the MagnifyImage method is:</p>
 189
 190 <pre class="code">
 191   Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
 192 </pre>
 193
 194 <p>A description of each parameter follows:</p></ol>
 195
 196 <h5>image</h5>
 197 <ol><p>the image.</p></ol>
 198
 199 <h5>exception</h5>
 200 <ol><p>return any errors or warnings in this structure.</p></ol>
 201
 202  </div>
 203 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 204 _8c.html" target="source" name="MinifyImage">MinifyImage</a></h2>
 205 <div class="doc-section">
 206
 207 <p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p></ol>
 208
 209 <p>The format of the MinifyImage method is:</p>
 210
 211 <pre class="code">
 212   Image *MinifyImage(const Image *image,ExceptionInfo *exception)
 213 </pre>
 214
 215 <p>A description of each parameter follows:</p></ol>
 216
 217 <h5>image</h5>
 218 <ol><p>the image.</p></ol>
 219
 220 <h5>exception</h5>
 221 <ol><p>return any errors or warnings in this structure.</p></ol>
 222
 223  </div>
 224 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 225 _8c.html" target="source" name="ResampleImage">ResampleImage</a></h2>
 226 <div class="doc-section">
 227
 228 <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>
 229
 230 <p>The format of the ResampleImage method is:</p>
 231
 232 <pre class="code">
 233   Image *ResampleImage(Image *image,const double x_resolution,
 234     const double y_resolution,const FilterTypes filter,const double blur,
 235     ExceptionInfo *exception)
 236 </pre>
 237
 238 <p>A description of each parameter follows:</p></ol>
 239
 240 <h5>image</h5>
 241 <ol><p>the image to be resized to fit the given resolution.</p></ol>
 242
 243 <h5>x_resolution</h5>
 244 <ol><p>the new image x resolution.</p></ol>
 245
 246 <h5>y_resolution</h5>
 247 <ol><p>the new image y resolution.</p></ol>
 248
 249 <h5>filter</h5>
 250 <ol><p>Image filter to use.</p></ol>
 251
 252 <h5>blur</h5>
 253 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
 254
 255  </div>
 256 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 257 _8c.html" target="source" name="LiquidRescaleImage">LiquidRescaleImage</a></h2>
 258 <div class="doc-section">
 259
 260 <p>LiquidRescaleImage() rescales image with seam carving.</p></ol>
 261
 262 <p>The format of the LiquidRescaleImage method is:</p>
 263
 264 <pre class="code">
 265   Image *LiquidRescaleImage(const Image *image,
 266     const unsigned long columns,const unsigned long rows,
 267     const double delta_x,const double rigidity,ExceptionInfo *exception)
 268 </pre>
 269
 270 <p>A description of each parameter follows:</p></ol>
 271
 272 <h5>image</h5>
 273 <ol><p>the image.</p></ol>
 274
 275 <h5>columns</h5>
 276 <ol><p>the number of columns in the rescaled image.</p></ol>
 277
 278 <h5>rows</h5>
 279 <ol><p>the number of rows in the rescaled image.</p></ol>
 280
 281 <h5>delta_x</h5>
 282 <ol><p>maximum seam transversal step (0 means straight seams).</p></ol>
 283
 284 <h5>rigidity</h5>
 285 <ol><p>introduce a bias for non-straight seams (typically 0).</p></ol>
 286
 287 <h5>exception</h5>
 288 <ol><p>return any errors or warnings in this structure.</p></ol>
 289
 290  </div>
 291 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 292 _8c.html" target="source" name="ResizeImage">ResizeImage</a></h2>
 293 <div class="doc-section">
 294
 295 <p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo() ).</p></ol>
 296
 297 <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>
 298
 299 <p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p></ol>
 300
 301 <p>The format of the ResizeImage method is:</p>
 302
 303 <pre class="code">
 304   Image *ResizeImage(Image *image,const unsigned long columns,
 305     const unsigned long rows,const FilterTypes filter,const double blur,
 306     ExceptionInfo *exception)
 307 </pre>
 308
 309 <p>A description of each parameter follows:</p></ol>
 310
 311 <h5>image</h5>
 312 <ol><p>the image.</p></ol>
 313
 314 <h5>columns</h5>
 315 <ol><p>the number of columns in the scaled image.</p></ol>
 316
 317 <h5>rows</h5>
 318 <ol><p>the number of rows in the scaled image.</p></ol>
 319
 320 <h5>filter</h5>
 321 <ol><p>Image filter to use.</p></ol>
 322
 323 <h5>blur</h5>
 324 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p></ol>
 325
 326 <h5>exception</h5>
 327 <ol><p>return any errors or warnings in this structure.</p></ol>
 328
 329  </div>
 330 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 331 _8c.html" target="source" name="SampleImage">SampleImage</a></h2>
 332 <div class="doc-section">
 333
 334 <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>
 335
 336 <p>The format of the SampleImage method is:</p>
 337
 338 <pre class="code">
 339   Image *SampleImage(const Image *image,const unsigned long columns,
 340     const unsigned long rows,ExceptionInfo *exception)
 341 </pre>
 342
 343 <p>A description of each parameter follows:</p></ol>
 344
 345 <h5>image</h5>
 346 <ol><p>the image.</p></ol>
 347
 348 <h5>columns</h5>
 349 <ol><p>the number of columns in the sampled image.</p></ol>
 350
 351 <h5>rows</h5>
 352 <ol><p>the number of rows in the sampled image.</p></ol>
 353
 354 <h5>exception</h5>
 355 <ol><p>return any errors or warnings in this structure.</p></ol>
 356
 357  </div>
 358 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 359 _8c.html" target="source" name="ScaleImage">ScaleImage</a></h2>
 360 <div class="doc-section">
 361
 362 <p>ScaleImage() changes the size of an image to the given dimensions.</p></ol>
 363
 364 <p>The format of the ScaleImage method is:</p>
 365
 366 <pre class="code">
 367   Image *ScaleImage(const Image *image,const unsigned long columns,
 368     const unsigned long rows,ExceptionInfo *exception)
 369 </pre>
 370
 371 <p>A description of each parameter follows:</p></ol>
 372
 373 <h5>image</h5>
 374 <ol><p>the image.</p></ol>
 375
 376 <h5>columns</h5>
 377 <ol><p>the number of columns in the scaled image.</p></ol>
 378
 379 <h5>rows</h5>
 380 <ol><p>the number of rows in the scaled image.</p></ol>
 381
 382 <h5>exception</h5>
 383 <ol><p>return any errors or warnings in this structure.</p></ol>
 384
 385  </div>
 386 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 387 _8c.html" target="source" name="ThumbnailImage">ThumbnailImage</a></h2>
 388 <div class="doc-section">
 389
 390 <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>
 391
 392 <p>The format of the ThumbnailImage method is:</p>
 393
 394 <pre class="code">
 395   Image *ThumbnailImage(const Image *image,const unsigned long columns,
 396     const unsigned long rows,ExceptionInfo *exception)
 397 </pre>
 398
 399 <p>A description of each parameter follows:</p></ol>
 400
 401 <h5>image</h5>
 402 <ol><p>the image.</p></ol>
 403
 404 <h5>columns</h5>
 405 <ol><p>the number of columns in the scaled image.</p></ol>
 406
 407 <h5>rows</h5>
 408 <ol><p>the number of rows in the scaled image.</p></ol>
 409
 410 <h5>exception</h5>
 411 <ol><p>return any errors or warnings in this structure.</p></ol>
 412
 413  </div>
 414 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 415 _8c.html" target="source" name="ZoomImage">ZoomImage</a></h2>
 416 <div class="doc-section">
 417
 418 <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>
 419
 420 <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>
 421
 422 <p>The format of the ZoomImage method is:</p>
 423
 424 <pre class="code">
 425   Image *ZoomImage(const Image *image,const unsigned long columns,
 426     const unsigned long rows,ExceptionInfo *exception)
 427 </pre>
 428
 429 <p>A description of each parameter follows:</p></ol>
 430
 431 <h5>image</h5>
 432 <ol><p>the image.</p></ol>
 433
 434 <h5>columns</h5>
 435 <ol><p>An integer that specifies the number of columns in the zoom image.</p></ol>
 436
 437 <h5>rows</h5>
 438 <ol><p>An integer that specifies the number of rows in the scaled image.</p></ol>
 439
 440 <h5>exception</h5>
 441 <ol><p>return any errors or warnings in this structure.</p></ol>
 442
 443  </div>
 444 \r
 445 </div>\r
 446 \r
 447 <div id="linkbar">\r
 448  <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
 449     <span id="linkbar-center">\r
 450       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 451       <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;\r
 452     <a href="http://studio.webbyland.com/ImageMagick/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-2009 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