Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / 6ad765e3f7a12d4b1b71a745a120c51549d81125 / . / www / api / paint.html
blob: 4ca97c20c67ab8d7dfd70c1b6a459a541dc9195c [file] [log] [blame]
cristy06f63f22012-10-31 00: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 version="-//W3C//DTD XHTML 1.1//EN"
4 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
5 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
6 xsi:schemaLocation="http://www.w3.org/1999/xhtml
7 http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
8<head>
9 <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
10 <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>
cristyffb69ed2010-12-25 00:06:48 +0000[diff] [blame]11 <title>ImageMagick: MagickCore, C API for ImageMagick: Paint on an Image</title>
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]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="application-name" content="ImageMagick"/>
16 <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 automagically."/>
17 <meta name="application-url" content="http://www.imagemagick.org"/>
18 <meta name="generator" content="PHP"/>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]19 <meta name="keywords" content="magickcore, c, api, for, imagemagick:, paint, on, an, image, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Image, Processing, Automagically"/>
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]20 <meta name="rating" content="GENERAL"/>
21 <meta name="robots" content="INDEX, FOLLOW"/>
22 <meta name="generator" content="ImageMagick Studio LLC"/>
23 <meta name="author" content="ImageMagick Studio LLC"/>
24 <meta name="revisit-after" content="2 DAYS"/>
25 <meta name="resource-type" content="document"/>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]26 <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
cristy751980d2012-06-03 23:18:35 +0000[diff] [blame]27 <meta name="distribution" content="Global"/>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]28 <link rel="icon" href="../../images/wand.png"/>
29 <link rel="shortcut icon" href="../../images/wand.ico" type="images/x-icon"/>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]30 <link rel="canonical" href="http://www.imagemagick.org" />
31 <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]32 <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]33 <link rel="stylesheet" type="text/css" href="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.css" media="screen" />
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]34 <style type="text/css" media="all">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]35 @import url("../../style/magick.php");
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]36 </style>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]37 <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
38 <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
39 <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.pack.js"></script>
40 <script type="text/javascript">
41 $(document).ready(function() {
42 $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({
43 'transitionIn' : 'elastic',
44 'transitionOut' : 'elastic',
45 'overlayShow' : false,
46 'opacity' : true
47 });
48 });
49 </script>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]50</head>
51
52<body id="www-imagemagick-org">
53<div class="titlebar">
54<div style="margin: 17px auto; float: left;">
55 <script type="text/javascript">
56 <!--
57 google_ad_client = "pub-3129977114552745";
58 google_ad_slot = "5439289906";
59 google_ad_width = 728;
60 google_ad_height = 90;
61 //-->
62 </script>
63 <script type="text/javascript"
64 src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
65 </script>
66</div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]67<a href="../../discourse-server">
68 <img src="../../images/logo.jpg"
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]69 alt="ImageMagick Logo"
70 style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]71<a href="http://www.imagemagick.org/ImageMagick-7.0.0/index.php">
72 <img src="../../images/sprite.jpg"
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]73 alt="ImageMagick Sprite"
74 style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
75</div>
76
77<div class="westbar">
78
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]79<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]80 <a title="About ImageMagick" href="http://www.imagemagick.org/ImageMagick-7.0.0/index.php">About ImageMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]81</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]82<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]83 <a title="Binary Releases" href="../../script/binary-releases.php">Binary Releases</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]84</div>
85<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]86 <a title="Binary Release: Unix" href="../../script/binary-releases.php#unix">Unix</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]87</div>
88<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]89 <a title="Binary Release: MacOS X" href="../../script/binary-releases.php#macosx">Mac OS X</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]90</div>
91<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]92 <a title="Binary Release: iOS" href="../../script/binary-releases.php#iOS">iOS</a>
cristyda16f162011-02-19 23:52:17 +0000[diff] [blame]93</div>
94<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]95 <a title="Binary Release: Windows" href="../../script/binary-releases.php#windows">Windows</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]96</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]97<div class="sep"></div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]98<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]99 <a title="Command-line Tools" href="../../script/command-line-tools.php">Command-line Tools</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]100</div>
101<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]102 <a title="Command-line Tools: Processing" href="../../script/command-line-processing.php">Processing</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]103</div>
104<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]105 <a title="Command-line Tools: Options" href="../../script/command-line-options.php">Options</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]106</div>
107<div class="sub">
cristy83a272e2010-05-07 20:40:35 +0000[diff] [blame]108 <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]109</div>
110<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]111 <a title="Program Interfaces" href="../../script/api.php">Program Interfaces</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]112</div>
113<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]114 <a title="Program Interface: MagickWand" href="../../script/magick-wand.php">MagickWand</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]115</div>
116<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]117 <a title="Program Interface: MagickCore" href="../../script/magick-core.php">MagickCore</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]118</div>
119<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]120 <a title="Program Interface: PerlMagick" href="../../script/perl-magick.php">PerlMagick</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]121</div>
122<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]123 <a title="Program Interface: Magick++" href="../../script/magick++.php">Magick++</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]124</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]125<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]126<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]127 <a title="Install from Source" href="../../script/install-source.php">Install from Source</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]128</div>
129<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]130 <a title="Install from Source: Unix" href="../../script/install-source.php#unix">Unix</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]131</div>
132<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]133 <a title="Install from Source: Windows" href="../../script/install-source.php#windows">Windows</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]134 </div>
135<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]136 <a title="Resources" href="../../script/resources.php">Resources</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]137</div>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]138<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]139 <a title="Architecture" href="../../script/architecture.php">Architecture</a>
cristybb503372010-05-27 20:51:26 +0000[diff] [blame]140</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]141<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]142 <a title="Download" href="../../script/download.php">Download</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]143</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]144<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]145<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]146 <a title="Search" href="../../script/search.php">Search</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]147</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]148<div class="sep"></div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]149<div class="menu">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]150 <a title="Site Map" href="../../script/sitemap.php">Site Map</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]151</div>
152<div class="sub">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]153 <a title="Site Map: Links" href="../../script/links.php">Links</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]154</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]155<div class="sep"></div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]156<div class="menu">
157 <a rel="follow" title="Sponsors" href="../../script/sponsors.php">Sponsors:</a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]158
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]159<a href="http://www.networkredux.com">
160 <img src="../../images/networkredux.png" width="140" height="31" alt="[sponsor]"
161 style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]162<div class="sponsbox">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]163<div class="sponsor">
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]164 <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
165</div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]166<div class="sponsor">
167 <a rel="follow" title="Sponsor: Stock Photography" href="http://www.fotosearch.com/">Stock Photography</a><!-- 2012040100250 ... -->
168</div>
169<div class="sponsor">
170 <a rel="follow" title="Sponsor: Best Local Services" href="http://www.openchime.com">Best Local Services</a><!-- 2012010100150 joey@openc... -->
171</div>
172<div class="sponsor">
cristyeed6cb62012-01-28 19:38:34 +0000[diff] [blame]173 <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
174</div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]175<div class="sponsor">
176 <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201201010090 barsh@inter... -->
177</div>
178<div class="sponsor">
179 <a rel="follow" title="Sponsor: Autoteile" href="http://www.q11-shop.de">Autoteile</a><!-- 201205010540 suvalj -->
180</div>
181<div class="sponsor">
182 <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
183</div>
184<div class="sponsor">
185 <a rel="follow" title="Sponsor: Web Hosting Deals" href="http://www.webhostingdeals.org">Web Hosting Deals</a><!-- 201111010270 chee.hoa darin -->
186</div>
187<div class="sponsor">
188 <a rel="follow" title="Sponsor: Autos part" href="http://www.pkwteile.de/autoteile">Autos part</a><!-- 201112010090s jr@pkwte... -->
189</div>
190<div class="sponsor">
191 <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
192</div>
193<div class="sponsor">
cristy10549a12011-05-15 19:04:46 +0000[diff] [blame]194 <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
cristy4c54bbb2011-03-17 13:53:13 +0000[diff] [blame]195</div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]196<div class="sponsor">
197 <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
cristy4bf6e232011-05-21 01:43:33 +0000[diff] [blame]198</div>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]199<div class="sponsor">
200 <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingreviewz.com">Web Hosting Reviews</a><!-- 2012040100030 Soft Tec-->
201</div>
202<div class="sponsor">
203 <a rel="follow" title="Sponsor: Got Stripes?" href="http://www.stripeslawncare.org">Got Stripes?</a><!-- 2012010100150 brooks@stripes...-->
cristyec6b4752011-01-08 03:16:23 +0000[diff] [blame]204</div>
cristyb15553d2010-07-03 22:53:14 +0000[diff] [blame]205</div>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]206</div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]207</div>
208
209<div class="eastbar">
210 <div class="g-plusone" id="gplusone"></div>
211 <script type="text/javascript">
212 window.___gcfg = {
213 lang: 'en-US'
214 };
215
216 (function() {
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]217 var po = document.createElement('offline-script');
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]218 po.type = 'text/javascript'; po.async = true;
219 po.src = 'https://apis.google.com/js/plusone.js';
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]220 var script = document.getElementsByTagName('offline-script')[0];
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]221 script.parentNode.insertBefore(po, script);
222 })();
223 var gplusone = document.getElementById("gplusone");
224 gplusone.setAttribute("data-size","medium");
225 gplusone.setAttribute("data-count","false");
226 </script>
227</div>
228
229<div class="main">
230
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]231<h1>Module paint Methods</h1>
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]232<p class="navigation-index">[<a href="paint.php#FloodfillPaintImage">FloodfillPaintImage</a> &bull; <a href="paint.php#OilPaintImage">OilPaintImage</a> &bull; <a href="paint.php#OpaquePaintImage">OpaquePaintImage</a> &bull; <a href="paint.php#TransparentPaintImage">TransparentPaintImage</a> &bull; <a href="paint.php#TransparentPaintImageChroma">TransparentPaintImageChroma</a>]</p>
cristy3ed852e2009-09-05 21:47:34 +0000[diff] [blame]233
cristy20398432011-08-11 01:31:50 +0000[diff] [blame]234<h2><a href="http://www.imagemagick.org/api/MagickCore/paint_8c.html" id="FloodfillPaintImage">FloodfillPaintImage</a></h2>
235<div class="doc-section">
236
237<p>FloodfillPaintImage() changes the color value of any pixel that matches target and is an immediate neighbor. If the method FillToBorderMethod is specified, the color value is changed for any neighbor pixel that does not match the bordercolor member of image.</p>
238
239<p>By default target must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. The fuzz member of image defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color for the purposes of the floodfill.</p>
240
241<p>The format of the FloodfillPaintImage method is:</p>
242
243<pre class="code">
244 MagickBooleanType FloodfillPaintImage(Image *image,
245 const ChannelType channel,const DrawInfo *draw_info,
246 const MagickPixelPacket target,const ssize_t x_offset,
247 const ssize_t y_offset,const MagickBooleanType invert)
248</pre>
249
250<p>A description of each parameter follows:</p>
251
252<h5>image</h5>
253<p>the image.</p>
254
255<h5>channel</h5>
256<p>the channel(s).</p>
257
258<h5>draw_info</h5>
259<p>the draw info.</p>
260
261<h5>target</h5>
262<p>the RGB value of the target color.</p>
263
264<h5>x_offset,y_offset</h5>
265<p>the starting location of the operation.</p>
266
267<h5>invert</h5>
268<p>paint any pixel that does not match the target color.</p>
269
270 </div>
271<h2><a href="http://www.imagemagick.org/api/MagickCore/paint_8c.html" id="OilPaintImage">OilPaintImage</a></h2>
272<div class="doc-section">
273
274<p>OilPaintImage() applies a special effect filter that simulates an oil painting. Each pixel is replaced by the most frequent color occurring in a circular region defined by radius.</p>
275
276<p>The format of the OilPaintImage method is:</p>
277
278<pre class="code">
279 Image *OilPaintImage(const Image *image,const double radius,
280 ExceptionInfo *exception)
281</pre>
282
283<p>A description of each parameter follows:</p>
284
285<h5>image</h5>
286<p>the image.</p>
287
288<h5>radius</h5>
289<p>the radius of the circular neighborhood.</p>
290
291<h5>exception</h5>
292<p>return any errors or warnings in this structure.</p>
293
294 </div>
295<h2><a href="http://www.imagemagick.org/api/MagickCore/paint_8c.html" id="OpaquePaintImage">OpaquePaintImage</a></h2>
296<div class="doc-section">
297
298<p>OpaquePaintImage() changes any pixel that matches color with the color defined by fill.</p>
299
300<p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p>
301
302<p>The format of the OpaquePaintImage method is:</p>
303
304<pre class="code">
305 MagickBooleanType OpaquePaintImage(Image *image,
306 const PixelPacket *target,const PixelPacket *fill,
307 const MagickBooleanType invert)
308 MagickBooleanType OpaquePaintImageChannel(Image *image,
309 const ChannelType channel,const PixelPacket *target,
310 const PixelPacket *fill,const MagickBooleanType invert)
311</pre>
312
313<p>A description of each parameter follows:</p>
314
315<h5>image</h5>
316<p>the image.</p>
317
318<h5>channel</h5>
319<p>the channel(s).</p>
320
321<h5>target</h5>
322<p>the RGB value of the target color.</p>
323
324<h5>fill</h5>
325<p>the replacement color.</p>
326
327<h5>invert</h5>
328<p>paint any pixel that does not match the target color.</p>
329
330 </div>
331<h2><a href="http://www.imagemagick.org/api/MagickCore/paint_8c.html" id="TransparentPaintImage">TransparentPaintImage</a></h2>
332<div class="doc-section">
333
334<p>TransparentPaintImage() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p>
335
336<p>By default color must match a particular pixel color exactly. However, in many cases two colors may differ by a small amount. Fuzz defines how much tolerance is acceptable to consider two colors as the same. For example, set fuzz to 10 and the color red at intensities of 100 and 102 respectively are now interpreted as the same color.</p>
337
338<p>The format of the TransparentPaintImage method is:</p>
339
340<pre class="code">
341 MagickBooleanType TransparentPaintImage(Image *image,
342 const MagickPixelPacket *target,const Quantum opacity,
343 const MagickBooleanType invert)
344</pre>
345
346<p>A description of each parameter follows:</p>
347
348<h5>image</h5>
349<p>the image.</p>
350
351<h5>target</h5>
352<p>the target color.</p>
353
354<h5>opacity</h5>
355<p>the replacement opacity value.</p>
356
357<h5>invert</h5>
358<p>paint any pixel that does not match the target color.</p>
359
360 </div>
361<h2><a href="http://www.imagemagick.org/api/MagickCore/paint_8c.html" id="TransparentPaintImageChroma">TransparentPaintImageChroma</a></h2>
362<div class="doc-section">
363
364<p>TransparentPaintImageChroma() changes the opacity value associated with any pixel that matches color to the value defined by opacity.</p>
365
366<p>As there is one fuzz value for the all the channels, the TransparentPaintImage() API is not suitable for the operations like chroma, where the tolerance for similarity of two color component (RGB) can be different, Thus we define this method take two target pixels (one low and one hight) and all the pixels of an image which are lying between these two pixels are made transparent.</p>
367
368<p>The format of the TransparentPaintImage method is:</p>
369
370<pre class="code">
371 MagickBooleanType TransparentPaintImage(Image *image,
372 const MagickPixelPacket *low,const MagickPixelPacket *hight,
373 const Quantum opacity,const MagickBooleanType invert)
374</pre>
375
376<p>A description of each parameter follows:</p>
377
378<h5>image</h5>
379<p>the image.</p>
380
381<h5>low</h5>
382<p>the low target color.</p>
383
384<h5>high</h5>
385<p>the high target color.</p>
386
387<h5>opacity</h5>
388<p>the replacement opacity value.</p>
389
390<h5>invert</h5>
391<p>paint any pixel that does not match the target color.</p>
392
393 </div>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]394
395</div>
396
397<div id="linkbar">
398 <span id="linkbar-west">&nbsp;</span>
399 <span id="linkbar-center">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]400 <a href="../../discourse-server">Discourse Server</a> &bull;
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]401 <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
402 </span>
403 <span id="linkbar-east">&nbsp;</span>
404 </div>
405 <div class="footer">
cristy72da67d2013-02-24 21:40:48 +0000[diff] [blame]406 <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>
407 <span id="footer-east"> <a href="../../script/contact.php">Contact the Wizards</a></span>
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]408 </div>
409 <div style="clear: both; margin: 0; width: 100%; "></div>
410 <script type="text/javascript">
411 var _gaq = _gaq || [];
412 _gaq.push(['_setAccount', 'UA-17690367-1']);
413 _gaq.push(['_trackPageview']);
414
415 (function() {
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]416 var ga = document.createElement('offline-script'); ga.type = 'text/javascript'; ga.async = true;
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]417 ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
cristy18b955e2013-02-24 21:06:33 +0000[diff] [blame]418 var s = document.getElementsByTagName('offline-script')[0]; s.parentNode.insertBefore(ga, s);
cristy06f63f22012-10-31 00:50:07 +0000[diff] [blame]419 })();
420 </script>
421</body>
422</html>