Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 7363fdec3d60ce2a051a6d363a95d0634002e6e7 / . / www / api / resize.html
blob: d88b85e253f33d855f63b0cb281431e657659489 [file] [log] [blame]
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" dir="ltr">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]4<head>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
6 <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U="/>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]7 <title>ImageMagick: MagickCore, C API for ImageMagick: Resize an Image</title>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]8 <meta http-equiv="Content-Language" content="en-US"/>
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
10 <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]11 <meta name="Application-name" content="ImageMagick"/>
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]12 <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition resize, rotate, shear, distort and transform images."/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]13 <meta name="Application-url" content="http://www.imagemagick.org"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]14 <meta name="Generator" content="PHP"/>
15 <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"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]16 <meta name="Rating" content="GENERAL"/>
17 <meta name="Robots" content="INDEX, FOLLOW"/>
18 <meta name="Generator" content="ImageMagick Studio LLC"/>
19 <meta name="Author" content="ImageMagick Studio LLC"/>
20 <meta name="Revisit-after" content="2 DAYS"/>
21 <meta name="Resource-type" content="document"/>
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]22 <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]23 <meta name="Distribution" content="Global"/>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]24 <link rel="icon" href="../../images/wand.png"/>
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]25 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
26 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]27 <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
cristy3c98a4f2010-08-13 20:09:41 +0000[diff] [blame]28 <style type="text/css" media="all">
29 @import url("../../www/magick.css");
30 </style>
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]31 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
cristy361f4662010-12-31 23:02:52 +0000[diff] [blame]32 <script type="text/javascript" src="../fancybox/jquery.fancybox-1.3.4.pack.js"></script>
33 <link rel="stylesheet" type="text/css" href="../fancybox/jquery.fancybox-1.3.4.css" media="screen" />
34 <script type="text/javascript">
35 $(document).ready(function() {
36 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
37 'transitionIn' : 'elastic',
38 'transitionOut' : 'elastic',
39 'overlayShow' : false,
40 'opacity' : true
41 });
42 });
43 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]44</head>
45
46<body id="www-imagemagick-org">
47<div class="titlebar">
48<a href="../../index.html">
49 <img src="../../images/script.png" alt="[ImageMagick]"
50 style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
51<a href="http://www.networkredux.com">
52 <img src="../../images/networkredux.png" alt="[sponsor]"
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]53 style="margin-top: 42px; border: 0px; float: left;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]54<a href="http://www.imagemagick.org/discourse-server/">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]55 <img src="../../images/logo.jpg"
56 alt="ImageMagick Logo"
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]57 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]58<a href="../../index.html">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]59 <img src="../../images/sprite.jpg"
60 alt="ImageMagick Sprite"
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]61 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
62</div>
63
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]64<div class="westbar">
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]65
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]66<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]67 <a title="About ImageMagick" href="../../index.html">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]68</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]69<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]70<div class="menu">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]71 <a title="Binary Releases" href="../../www/binary-releases.html">Binary Releases</a>
72</div>
73<div class="sub">
74 <a title="Binary Release: Unix" href="../../www/binary-releases.html#unix">Unix</a>
75</div>
76<div class="sub">
77 <a title="Binary Release: MacOS X" href="../../www/binary-releases.html#macosx">Mac OS X</a>
78</div>
79<div class="sub">
80 <a title="Binary Release: Windows" href="../../www/binary-releases.html#windows">Windows</a>
81</div>
82<div class="sep"></div>
83<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]84 <a title="Command-line Tools" href="../../www/command-line-tools.html">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]85</div>
86<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]87 <a title="Command-line Tools: Processing" href="../../www/command-line-processing.html">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]88</div>
89<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]90 <a title="Command-line Tools: Options" href="../../www/command-line-options.html">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]91</div>
92<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]93 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]94</div>
95<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]96 <a title="Program Interfaces" href="../../www/api.html">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]97</div>
98<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]99 <a title="Program Interface: MagickWand" href="../../www/magick-wand.html">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100</div>
101<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]102 <a title="Program Interface: MagickCore" href="../../www/magick-core.html">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
104<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]105 <a title="Program Interface: PerlMagick" href="../../www/perl-magick.html">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]106</div>
107<div class="sub">
cristydcca3fa2010-12-29 21:50:07 +0000[diff] [blame]108 <a title="Program Interface: Magick++" href="../../www/magick++.html">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]110<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]111<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]112 <a title="Install from Source" href="../../www/install-source.html">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]113</div>
114<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]115 <a title="Install from Source: Unix" href="../../www/install-source.html#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]116</div>
117<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]118 <a title="Install from Source: Windows" href="../../www/install-source.html#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]119 </div>
120<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]121 <a title="Resources" href="../../www/resources.html">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]122</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]123<div class="menu">
124 <a title="Architecture" href="../../www/architecture.html">Architecture</a>
125</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]126<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]127 <a title="Download" href="../../www/download.html">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]128</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]129<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]130<div class="menu">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]131 <a title="Search" href="../../www/search.html">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]132</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]133<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134<div class="menu">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]135 <a title="Site Map" href="../../www/sitemap.html">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]136</div>
137<div class="sub">
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]138 <a title="Site Map: Links" href="../../www/links.html">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]139</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]140<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141<div class="menu">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]142 <a title="Sponsors" href="../../www/sponsors.html">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]143
144<div class="sponsbox">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]145<div class="sponsor">
cristyaf8d6652011-02-04 21:57:45 +0000[diff] [blame]146 <a title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
147</div>
148<div class="sponsor">
149 <a title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
150</div>
151<div class="sponsor">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]152 <a title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201106010240 -->
153</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]154<div class="sponsor">
cristy52923442011-01-15 22:54:31 +0000[diff] [blame]155 <a title="Sponsor: Web Hosting" href="http://www.bodhost.com/hosting.shtml">Web Hosting</a><!-- 201104010090 -->
cristy7d52cd62010-10-01 17:26:59 +0000[diff] [blame]156</div>
157<div class="sponsor">
cristyc5baf4f2010-08-31 15:05:33 +0000[diff] [blame]158 <a title="Sponsor: Image Converter" href="http://www.batchphoto.com">Image Converter</a><!-- 201103010900 Bits Coffee-->
159</div>
160<div class="sponsor">
cristy851dbce2010-08-06 21:40:00 +0000[diff] [blame]161 <a title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
162</div>
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]163<div class="sponsor">
cristy178edaf2011-01-23 03:42:39 +0000[diff] [blame]164 <a title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
165</div>
166<div class="sponsor">
cristy2d67ddd2011-02-13 15:38:23 +0000[diff] [blame]167 <a title="Sponsor: Fernsehdienst Berlin" href="http://www.atlas-multimedia.de">Fernsehdienst Berlin</a><!-- 2011050100025 atlas.multimedia-->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]168</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]169</div>
170</div>
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]171</div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]172
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]173<div class="eastbar">
174 <script type="text/javascript">
175 <!--
176 google_ad_client = "pub-3129977114552745";
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]177 google_ad_slot = "0574824969";
178 google_ad_width = 160;
179 google_ad_height = 600;
180 //-->
181 </script>
182 <script type="text/javascript"
183 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
184 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]185</div>
186
187<div class="main">
188
cristy307ba182010-12-25 01:00:34 +0000[diff] [blame]189<h1>Module resize
190 Methods</h1>
cristy73fd1cd2010-09-12 19:14:25 +0000[diff] [blame]191<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>]</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]192
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]193<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]194_8c.html" id="AdaptiveResizeImage">AdaptiveResizeImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]195<div class="doc-section">
196
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]197<p>AdaptiveResizeImage() adaptively resize image with pixel resampling.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]198
199<p>The format of the AdaptiveResizeImage method is:</p>
200
201<pre class="code">
cristybc9539a2010-08-16 18:06:20 +0000[diff] [blame]202 Image *AdaptiveResizeImage(const Image *image,const size_t columns,
203 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]204</pre>
205
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]206<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]207
208<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]209<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]210
211<h5>columns</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]212<p>the number of columns in the resized image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]213
214<h5>rows</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]215<p>the number of rows in the resized image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]216
217<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]218<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]219
220 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]221<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]222_8c.html" id="MagnifyImage">MagnifyImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]223<div class="doc-section">
224
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]225<p>MagnifyImage() is a convenience method that scales an image proportionally to twice its size.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]226
227<p>The format of the MagnifyImage method is:</p>
228
229<pre class="code">
230 Image *MagnifyImage(const Image *image,ExceptionInfo *exception)
231</pre>
232
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]233<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]234
235<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]236<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]237
238<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]239<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]240
241 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]242<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]243_8c.html" id="MinifyImage">MinifyImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]244<div class="doc-section">
245
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]246<p>MinifyImage() is a convenience method that scales an image proportionally to half its size.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]247
248<p>The format of the MinifyImage method is:</p>
249
250<pre class="code">
251 Image *MinifyImage(const Image *image,ExceptionInfo *exception)
252</pre>
253
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]254<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]255
256<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]257<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]258
259<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]260<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]261
262 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]263<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]264_8c.html" id="ResampleImage">ResampleImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]265<div class="doc-section">
266
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]267<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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]268
269<p>The format of the ResampleImage method is:</p>
270
271<pre class="code">
272 Image *ResampleImage(Image *image,const double x_resolution,
273 const double y_resolution,const FilterTypes filter,const double blur,
274 ExceptionInfo *exception)
275</pre>
276
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]277<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]278
279<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]280<p>the image to be resized to fit the given resolution.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]281
282<h5>x_resolution</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]283<p>the new image x resolution.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]284
285<h5>y_resolution</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]286<p>the new image y resolution.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]287
288<h5>filter</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]289<p>Image filter to use.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]290
291<h5>blur</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]292<p>the blur factor where > 1 is blurry, < 1 is sharp.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]293
294 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]295<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]296_8c.html" id="LiquidRescaleImage">LiquidRescaleImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]297<div class="doc-section">
298
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]299<p>LiquidRescaleImage() rescales image with seam carving.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]300
301<p>The format of the LiquidRescaleImage method is:</p>
302
303<pre class="code">
304 Image *LiquidRescaleImage(const Image *image,
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]305 const size_t columns,const size_t rows,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]306 const double delta_x,const double rigidity,ExceptionInfo *exception)
307</pre>
308
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]309<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]310
311<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]312<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]313
314<h5>columns</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]315<p>the number of columns in the rescaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]316
317<h5>rows</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]318<p>the number of rows in the rescaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]319
320<h5>delta_x</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]321<p>maximum seam transversal step (0 means straight seams).</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]322
323<h5>rigidity</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]324<p>introduce a bias for non-straight seams (typically 0).</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]325
326<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]327<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]328
329 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]330<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]331_8c.html" id="ResizeImage">ResizeImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]332<div class="doc-section">
333
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]334<p>ResizeImage() scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo()).</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]335
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]336<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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]337
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]338<p>ResizeImage() was inspired by Paul Heckbert's "zoom" program.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]339
340<p>The format of the ResizeImage method is:</p>
341
342<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]343 Image *ResizeImage(Image *image,const size_t columns,
344 const size_t rows,const FilterTypes filter,const double blur,
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]345 ExceptionInfo *exception)
346</pre>
347
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]348<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]349
350<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]351<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]352
353<h5>columns</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]354<p>the number of columns in the scaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]355
356<h5>rows</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]357<p>the number of rows in the scaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]358
359<h5>filter</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]360<p>Image filter to use.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]361
362<h5>blur</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]363<p>the blur factor where > 1 is blurry, < 1 is sharp. Typically set this to 1.0.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]364
365<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]366<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]367
368 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]369<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]370_8c.html" id="SampleImage">SampleImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]371<div class="doc-section">
372
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]373<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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]374
375<p>The format of the SampleImage method is:</p>
376
377<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]378 Image *SampleImage(const Image *image,const size_t columns,
379 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]380</pre>
381
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]382<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]383
384<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]385<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]386
387<h5>columns</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]388<p>the number of columns in the sampled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]389
390<h5>rows</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]391<p>the number of rows in the sampled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]392
393<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]394<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]395
396 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]397<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]398_8c.html" id="ScaleImage">ScaleImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]399<div class="doc-section">
400
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]401<p>ScaleImage() changes the size of an image to the given dimensions.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]402
403<p>The format of the ScaleImage method is:</p>
404
405<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]406 Image *ScaleImage(const Image *image,const size_t columns,
407 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]408</pre>
409
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]410<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]411
412<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]413<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]414
415<h5>columns</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]416<p>the number of columns in the scaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]417
418<h5>rows</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]419<p>the number of rows in the scaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]420
421<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]422<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]423
424 </div>
cristy70b59b62011-02-07 19:09:57 +0000[diff] [blame]425<h2><a href="http://www.imagemagick.org/api/MagickCore/resize
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]426_8c.html" id="ThumbnailImage">ThumbnailImage</a></h2>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]427<div class="doc-section">
428
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]429<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>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]430
431<p>The format of the ThumbnailImage method is:</p>
432
433<pre class="code">
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]434 Image *ThumbnailImage(const Image *image,const size_t columns,
435 const size_t rows,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]436</pre>
437
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]438<p>A description of each parameter follows:</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]439
440<h5>image</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]441<p>the image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]442
443<h5>columns</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]444<p>the number of columns in the scaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]445
446<h5>rows</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]447<p>the number of rows in the scaled image.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]448
449<h5>exception</h5>
cristy7a40ba82011-01-08 20:31:18 +0000[diff] [blame]450<p>return any errors or warnings in this structure.</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]451
452 </div>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]453
454</div>
455
456<div id="linkbar">
cristyce69bb02010-07-27 19:49:46 +0000[diff] [blame]457 <span id="linkbar-west">&nbsp;</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]458 <span id="linkbar-center">
459 <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]460 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]461 </span>
462 <span id="linkbar-east">&nbsp;</span>
463 </div>
464 <div class="footer">
cristy4103d562010-12-10 01:38:54 +0000[diff] [blame]465 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]466 <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
467 </div>
468 <div style="clear: both; margin: 0; width: 100%; "></div>
cristya8902942010-07-30 00:49:52 +0000[diff] [blame]469 <script type="text/javascript">
470 var _gaq = _gaq || [];
471 _gaq.push(['_setAccount', 'UA-17690367-1']);
472 _gaq.push(['_trackPageview']);
473
474 (function() {
475 var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
476 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
477 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
478 })();
479 </script>
cristy3eaa0ef2010-03-06 20:35:26 +0000[diff] [blame]480</body>
481</html>