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