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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   2     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   4 <head>
   5   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
   6   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
   7   <style type="text/css" media="screen,projection"><!--
   8     @import url("../../www/magick.css");
   9   --></style>
  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>
  27
  28 <body id="www-imagemagick-org">
  29 <div class="titlebar">
  30 <a href="../../index.html">
  31   <img src="../../images/script.png" alt="[ImageMagick]"
  32   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
  33 <a href="http://www.networkredux.com">
  34   <img src="../../images/networkredux.png" alt="[sponsor]"
  35   style="margin: 45px auto; border: 0px; float: left;" /></a>
  36 <a href="http://www.imagemagick.org/discourse-server/">
  37   <img src="../../images/logo.jpg" alt=""
  38   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  39 <a href="../../index.html">
  40   <img src="../../images/sprite.jpg" alt=""
  41   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  42 </div>
  43
  44 <div class="eastbar">
  45
  46 <div class="menu">
  47   <a href="../../index.html">About ImageMagick</a>
  48 </div>
  49 <div class="sep"></div>
  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>
  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>
 106 <div class="menu">
 107   <a href="../../www/download.html">Download</a>
 108 </div>
 109 <div class="sep"></div>
 110 <div class="menu">
 111   <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 112 </div>
 113 <div class="sep"></div>
 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>
 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.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 127 </div>
 128 <div  class="sponsor">
 129   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
 130 </div>
 131 <div  class="sponsor">
 132   <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
 133 </div>
 134 <div  class="sponsor">
 135   <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 136 </div>
 137 <div  class="sponsor">
 138   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201001010120 Buchhorn -->
 139 </div>
 140 </div>
 141 </div>
 142
 143
 144 </div>
 145
 146 <div class="main">
 147
 148 <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>
 149
 150 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 151 _8c.html" target="source" name="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
 152 <div class="doc-section">
 153
 154 <p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p></ol>
 155
 156 <p>The format of the AdaptiveResizeImage method is:</p>
 157
 158 <pre class="code">
 159   Image *AdaptiveResizeImage(const Image *image,
 160     const unsigned long columns,const unsigned long rows,
 161     ExceptionInfo *exception)
 162 </pre>
 163
 164 <p>A description of each parameter follows:</p></ol>
 165
 166 <h5>image</h5>
 167 <ol><p>the image.</p></ol>
 168
 169 <h5>columns</h5>
 170 <ol><p>the number of columns in the resized image.</p></ol>
 171
 172 <h5>rows</h5>
 173 <ol><p>the number of rows in the resized image.</p></ol>
 174
 175 <h5>exception</h5>
 176 <ol><p>return any errors or warnings in this structure.</p></ol>
 177
 178  </div>
 179 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 180 _8c.html" target="source" name="MagnifyImage">MagnifyImage</a></h2>
 181 <div class="doc-section">
 182
 183 <p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p></ol>
 184
 185 <p>The format of the MagnifyImage method is:</p>
 186
 187 <pre class="code">
 188   Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
 189 </pre>
 190
 191 <p>A description of each parameter follows:</p></ol>
 192
 193 <h5>image</h5>
 194 <ol><p>the 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="MinifyImage">MinifyImage</a></h2>
 202 <div class="doc-section">
 203
 204 <p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p></ol>
 205
 206 <p>The format of the MinifyImage method is:</p>
 207
 208 <pre class="code">
 209   Image *MinifyImage(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="ResampleImage">ResampleImage</a></h2>
 223 <div class="doc-section">
 224
 225 <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>
 226
 227 <p>The format of the ResampleImage method is:</p>
 228
 229 <pre class="code">
 230   Image *ResampleImage(Image *image,const double x_resolution,
 231     const double y_resolution,const FilterTypes filter,const double blur,
 232     ExceptionInfo *exception)
 233 </pre>
 234
 235 <p>A description of each parameter follows:</p></ol>
 236
 237 <h5>image</h5>
 238 <ol><p>the image to be resized to fit the given resolution.</p></ol>
 239
 240 <h5>x_resolution</h5>
 241 <ol><p>the new image x resolution.</p></ol>
 242
 243 <h5>y_resolution</h5>
 244 <ol><p>the new image y resolution.</p></ol>
 245
 246 <h5>filter</h5>
 247 <ol><p>Image filter to use.</p></ol>
 248
 249 <h5>blur</h5>
 250 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp.</p></ol>
 251
 252  </div>
 253 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 254 _8c.html" target="source" name="LiquidRescaleImage">LiquidRescaleImage</a></h2>
 255 <div class="doc-section">
 256
 257 <p>LiquidRescaleImage() rescales image with seam carving.</p></ol>
 258
 259 <p>The format of the LiquidRescaleImage method is:</p>
 260
 261 <pre class="code">
 262   Image *LiquidRescaleImage(const Image *image,
 263     const unsigned long columns,const unsigned long rows,
 264     const double delta_x,const double rigidity,ExceptionInfo *exception)
 265 </pre>
 266
 267 <p>A description of each parameter follows:</p></ol>
 268
 269 <h5>image</h5>
 270 <ol><p>the image.</p></ol>
 271
 272 <h5>columns</h5>
 273 <ol><p>the number of columns in the rescaled image.</p></ol>
 274
 275 <h5>rows</h5>
 276 <ol><p>the number of rows in the rescaled image.</p></ol>
 277
 278 <h5>delta_x</h5>
 279 <ol><p>maximum seam transversal step (0 means straight seams).</p></ol>
 280
 281 <h5>rigidity</h5>
 282 <ol><p>introduce a bias for non-straight seams (typically 0).</p></ol>
 283
 284 <h5>exception</h5>
 285 <ol><p>return any errors or warnings in this structure.</p></ol>
 286
 287  </div>
 288 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 289 _8c.html" target="source" name="ResizeImage">ResizeImage</a></h2>
 290 <div class="doc-section">
 291
 292 <p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo() ).</p></ol>
 293
 294 <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>
 295
 296 <p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p></ol>
 297
 298 <p>The format of the ResizeImage method is:</p>
 299
 300 <pre class="code">
 301   Image *ResizeImage(Image *image,const unsigned long columns,
 302     const unsigned long rows,const FilterTypes filter,const double blur,
 303     ExceptionInfo *exception)
 304 </pre>
 305
 306 <p>A description of each parameter follows:</p></ol>
 307
 308 <h5>image</h5>
 309 <ol><p>the image.</p></ol>
 310
 311 <h5>columns</h5>
 312 <ol><p>the number of columns in the scaled image.</p></ol>
 313
 314 <h5>rows</h5>
 315 <ol><p>the number of rows in the scaled image.</p></ol>
 316
 317 <h5>filter</h5>
 318 <ol><p>Image filter to use.</p></ol>
 319
 320 <h5>blur</h5>
 321 <ol><p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p></ol>
 322
 323 <h5>exception</h5>
 324 <ol><p>return any errors or warnings in this structure.</p></ol>
 325
 326  </div>
 327 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 328 _8c.html" target="source" name="SampleImage">SampleImage</a></h2>
 329 <div class="doc-section">
 330
 331 <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>
 332
 333 <p>The format of the SampleImage method is:</p>
 334
 335 <pre class="code">
 336   Image *SampleImage(const Image *image,const unsigned long columns,
 337     const unsigned long rows,ExceptionInfo *exception)
 338 </pre>
 339
 340 <p>A description of each parameter follows:</p></ol>
 341
 342 <h5>image</h5>
 343 <ol><p>the image.</p></ol>
 344
 345 <h5>columns</h5>
 346 <ol><p>the number of columns in the sampled image.</p></ol>
 347
 348 <h5>rows</h5>
 349 <ol><p>the number of rows in the sampled image.</p></ol>
 350
 351 <h5>exception</h5>
 352 <ol><p>return any errors or warnings in this structure.</p></ol>
 353
 354  </div>
 355 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 356 _8c.html" target="source" name="ScaleImage">ScaleImage</a></h2>
 357 <div class="doc-section">
 358
 359 <p>ScaleImage() changes the size of an image to the given dimensions.</p></ol>
 360
 361 <p>The format of the ScaleImage method is:</p>
 362
 363 <pre class="code">
 364   Image *ScaleImage(const Image *image,const unsigned long columns,
 365     const unsigned long rows,ExceptionInfo *exception)
 366 </pre>
 367
 368 <p>A description of each parameter follows:</p></ol>
 369
 370 <h5>image</h5>
 371 <ol><p>the image.</p></ol>
 372
 373 <h5>columns</h5>
 374 <ol><p>the number of columns in the scaled image.</p></ol>
 375
 376 <h5>rows</h5>
 377 <ol><p>the number of rows in the scaled image.</p></ol>
 378
 379 <h5>exception</h5>
 380 <ol><p>return any errors or warnings in this structure.</p></ol>
 381
 382  </div>
 383 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 384 _8c.html" target="source" name="ThumbnailImage">ThumbnailImage</a></h2>
 385 <div class="doc-section">
 386
 387 <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>
 388
 389 <p>The format of the ThumbnailImage method is:</p>
 390
 391 <pre class="code">
 392   Image *ThumbnailImage(const Image *image,const unsigned long columns,
 393     const unsigned long rows,ExceptionInfo *exception)
 394 </pre>
 395
 396 <p>A description of each parameter follows:</p></ol>
 397
 398 <h5>image</h5>
 399 <ol><p>the image.</p></ol>
 400
 401 <h5>columns</h5>
 402 <ol><p>the number of columns in the scaled image.</p></ol>
 403
 404 <h5>rows</h5>
 405 <ol><p>the number of rows in the scaled image.</p></ol>
 406
 407 <h5>exception</h5>
 408 <ol><p>return any errors or warnings in this structure.</p></ol>
 409
 410  </div>
 411 <h2><a href="http://www.imagemagick.org/api/MagickCore/resize
 412 _8c.html" target="source" name="ZoomImage">ZoomImage</a></h2>
 413 <div class="doc-section">
 414
 415 <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>
 416
 417 <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>
 418
 419 <p>The format of the ZoomImage method is:</p>
 420
 421 <pre class="code">
 422   Image *ZoomImage(const Image *image,const unsigned long columns,
 423     const unsigned long rows,ExceptionInfo *exception)
 424 </pre>
 425
 426 <p>A description of each parameter follows:</p></ol>
 427
 428 <h5>image</h5>
 429 <ol><p>the image.</p></ol>
 430
 431 <h5>columns</h5>
 432 <ol><p>An integer that specifies the number of columns in the zoom image.</p></ol>
 433
 434 <h5>rows</h5>
 435 <ol><p>An integer that specifies the number of rows in the scaled image.</p></ol>
 436
 437 <h5>exception</h5>
 438 <ol><p>return any errors or warnings in this structure.</p></ol>
 439
 440  </div>
 441
 442 </div>
 443
 444 <div id="linkbar">
 445  <!--    <span id="linkbar-west">&nbsp;</span>  -->
 446     <span id="linkbar-center">
 447       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
 448       <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;
 449     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
 450     </span>
 451     <span id="linkbar-east">&nbsp;</span>
 452   </div>
 453   <div class="footer">
 454     <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>
 455     <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
 456   </div>
 457   <div style="clear: both; margin: 0; width: 100%; "></div>
 458 </body>
 459 </html>