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