← Back to branch summary

~ubuntu-branches/ubuntu/quantal/imagemagick/quantal

« back to all changes in this revision

Viewing changes to www/api/enhance.html

  • Committer: Bazaar Package Importer
  • Author(s): Muharem Hrnjadovic
  • Date: 2009-06-04 13:01:13 UTC
  • mfrom: (1.1.5 upstream) (6.1.1 sid)
  • Revision ID: james.westby@ubuntu.com-20090604130113-my9114jxmafpwew3
Tags: 7:6.5.1.0-1.1ubuntu1
* Merge from debian unstable, remaining changes:
  - (Build-)depend on libltdl7-dev instead of libltdl3-dev (the armel buildds
    currently have both available).
  - Don't build-dep on librsvg, it brings in excessive dependencies

Show diffs side-by-side

added added

removed removed

Lines of Context:
www/api/enhance.html
1
 
<?xml version="1.0" encoding="UTF-8"?>
2
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
 
2
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
4
<head>
5
5
  <style type="text/css" media="screen,projection"><!--
6
6
    @import url("../../www/magick.css");
7
 
  //--></style>
 
7
  --></style>
8
8
  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
9
9
  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
10
10
  <title>ImageMagick: MagickCore, C API for ImageMagick: Enhance an Image</title>
20
20
  <meta name="Author" content="ImageMagick Studio LLC"/>
21
21
  <meta name="Revisit-after" content="2 DAYS"/>
22
22
  <meta name="Resource-type" content="document"/>
23
 
  <meta name="Copyright" content="Copyright (c) 1999-2008 ImageMagick Studio LLC"/>
 
23
  <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
24
24
  <meta name="Distribution" content="Global"/>
25
25
  <link rel="shortcut icon" href="../../images/wand.ico"  type="images/vnd.microsoft.icon"/>
26
26
</head>
27
27
 
28
28
<body id="www-imagemagick-org">
29
 
  <table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="ImageMagick">
30
 
    <tbody>
31
 
      <tr valign="top">
32
 
        <td align="left"><a href="../../index.html"><img id="titlebar-west" src="../../images/script.png" alt="[ImageMagick]" width="350" height="60" vspace="28" name="titlebar-west"/></a></td>
33
 
        <td align="left"><a href="http://www.networkredux.com" target="1757636954"><img id="titlebar-west" src="../../images/networkredux.png" alt="[sponsor]" border="0" vspace="45" name="titlebar-west"/></a></td>
34
 
        <td width="99%"><br /> </td>
35
 
        <td style="background-color: white" align="right"><a href="../../index.html"><img src="../../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
36
 
        <td style="background-color: white" align="right"><a href="http://www.imagemagick.org/discourse-server/" target="505163959"><img id="titlebar-east" src="../../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east"/></a></td>
37
 
      </tr>
38
 
    </tbody>
39
 
  </table>
40
 
 
41
 
  <table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary="">
42
 
  <tbody>
43
 
 
44
 
    <tr valign="top" style="height: 100%;">
45
 
      <td id="menu" width="1%" height="100%">
46
 
      <p><a href="#main">Skip to page contents</a></p>
47
 
      <font size="-1">
48
 
      <span>[</span>
49
 
      <a href="../../index.html">About ImageMagick</a>
50
 
  <span>]</span><br /><span>[</span>
51
 
      <a href="../../www/command-line-tools.html">Command-line Tools</a>
52
 
      <a href="../../www/command-line-processing.html" class="sub">Processing</a>
53
 
      <a href="../../www/command-line-options.html" class="sub">Options</a>
54
 
      <a href="http://www.imagemagick.org/Usage/" target="1788928848" class="sub">Usage</a>
 
29
<div class="titlebar">
 
30
<a href="../../index.html">
 
31
  <img src="../../images/script.png" alt="[ImageMagick]"
 
32
  style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
 
33
<a href="http://www.networkredux.com">
 
34
  <img src="../../images/networkredux.png" alt="[sponsor]"
 
35
  style="margin: 45px auto; border: 0px; float: left;" /></a>
 
36
<a href="http://www.imagemagick.org/discourse-server/">
 
37
  <img src="../../images/logo.jpg" alt=""
 
38
  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
 
39
<a href="../../index.html">
 
40
  <img src="../../images/sprite.jpg" alt=""
 
41
  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
 
42
</div>
 
43
 
 
44
<div class="eastbar">
 
45
 
 
46
<div class="menu">
 
47
  <a href="../../index.html">About ImageMagick</a>
 
48
</div>
 
49
<div class="sep"></div>
 
50
 <div  class="menu">
 
51
        <a href="../../www/command-line-tools.html">Command-line Tools</a>
 
52
 </div>
 
53
 <div  class="sub">
 
54
      <a href="../../www/command-line-processing.html">Processing</a>
 
55
 </div>
 
56
 <div  class="sub">
 
57
      <a href="../../www/command-line-options.html">Options</a>
 
58
 </div>
 
59
 <div  class="sub">
 
60
      <a href="http://www.imagemagick.org/Usage/">Usage</a>
 
61
 </div>
 
62
 <div  class="menu">
55
63
      <a href="../../www/api.html">Program Interfaces</a>
56
 
      <a href="../../www/magick-wand.html" class="sub">MagickWand</a>
57
 
      <a href="../../www/magick-core.html" class="sub">MagickCore</a>
58
 
      <a href="../../www/perl-magick.html" class="sub">PerlMagick</a>
59
 
      <a href="../../Magick++/" target="741432567" class="sub">Magick++</a>
60
 
      <a href="../../www/architecture.html">Architecture</a>
61
 
  <span>]</span><br /><span>[</span>
 
64
 </div>
 
65
 <div  class="sub">
 
66
      <a href="../../www/magick-wand.html">MagickWand</a>
 
67
 </div>
 
68
 <div  class="sub">
 
69
      <a href="../../www/magick-core.html">MagickCore</a>
 
70
 </div>
 
71
 <div  class="sub">
 
72
      <a href="../../www/perl-magick.html">PerlMagick</a>
 
73
 </div>
 
74
 <div  class="sub">
 
75
      <a href="../../Magick++/">Magick++</a>
 
76
 </div>
 
77
<div class="menu">
 
78
  <a href="../../www/architecture.html">Architecture</a>
 
79
</div>
 
80
<div class="sep"></div>
 
81
 <div  class="menu">
62
82
      <a href="../../www/install-source.html">Install from Source</a>
63
 
      <a href="../../www/install-source.html#unix" class="sub">Unix</a>
64
 
      <a href="../../www/install-source.html#windows" class="sub">Windows</a>
 
83
 </div>
 
84
 <div  class="sub">
 
85
      <a href="../../www/install-source.html#unix">Unix</a>
 
86
 </div>
 
87
 <div  class="sub">
 
88
      <a href="../../www/install-source.html#windows">Windows</a>
 
89
 </div>
 
90
<div class="menu">
65
91
      <a href="../../www/binary-releases.html">Binary Releases</a>
66
 
      <a href="../../www/binary-releases.html#unix" class="sub">Unix</a>
67
 
      <a href="../../www/binary-releases.html#macosx" class="sub">Mac OS X</a>
68
 
      <a href="../../www/binary-releases.html#windows" class="sub">Windows</a>
 
92
</div>
 
93
<div class="sub">
 
94
      <a href="../../www/binary-releases.html#unix">Unix</a>
 
95
</div>
 
96
<div class="sub">
 
97
      <a href="../../www/binary-releases.html#macosx">Mac OS X</a>
 
98
</div>
 
99
<div class="sub">
 
100
      <a href="../../www/binary-releases.html#windows">Windows</a>
 
101
</div>
 
102
<div class="menu">
69
103
      <a href="../../www/resources.html">Resources</a>
70
 
  <span>]</span><br /><span>[</span>
 
104
</div>
 
105
<div class="sep"></div>
 
106
<div class="menu">
71
107
      <a href="../../www/download.html">Download</a>
72
 
  <span>]</span><br /><span>[</span>
73
 
      <a href="../../www/sitemap.html">Site Map</a>
74
 
                        <a href="../../www/links.html" class="sub">Links</a>
75
 
  <span>]</span><br /><span>[</span>
76
 
      <a href="../../www/sponsors.html">Sponsors:</a>
77
 
      <fieldset>
78
 
  <a href="http://merchantwarehouse.com" class="sponsor" target="sponsor">Credit Card<br />Processing</a><!-- 200811010250 -->
79
 
      <br />
80
 
      <a href="http://meta-preisvergleich.de" class="sponsor" target="sponsor">Preisvergleich</a><!-- 200901010120 -->
81
 
      <br />
82
 
      <a href="http://www.checkcost.co.uk" class="sponsor" target="sponsor">Compare</a><!-- 200902010720 -->
83
 
      <br />
84
 
      <a href="http://www.ecostsoftware.com" class="sponsor" target="sponsor">Software</a><!-- 200902010720 -->
85
 
      <br />
86
 
      <a href="http://www.callerbase.com" class="sponsor" target="sponsor">Phone Number<br />Search</a><!-- 200812010040 -->
87
 
      <br />
88
 
      <a href="http://www.online-kredit-index.de" class="sponsor" target="sponsor">Kredit</a><!-- 200903010120 -->
89
 
      <br />
90
 
      <a href="http://www.posters555.com" class="sponsor" target="sponsor">Poster</a><!-- 200903010800 -->
91
 
      <br />
92
 
      <a href="http://www.iceposter.com" class="sponsor" target="sponsor">Posters</a><!-- 200812010200 -->
93
 
      <br />
94
 
      <a href="http://www.imade-art.de"><img src="../../images/imade_art2.jpg" alt="[Kunst bei imade-art]" width="116" height="28" border="0" name="Kunst bei imade-art"/></a> <!-- 200811010160 -->
95
 
      </fieldset>
96
 
      <span>]</span>
97
 
      </font>
98
 
      </td>
99
 
 
100
 
      <td id="main" valign="top">
 
108
</div>
 
109
<div class="sep"></div>
 
110
<div class="menu">
 
111
      <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 
112
</div><div class="sep"></div>
 
113
<div class="menu">
 
114
    <a href="../../www/sitemap.html">Site Map</a>
 
115
</div>
 
116
<div  class="sub">
 
117
        <a href="../../www/links.html">Links</a>
 
118
</div>
 
119
<div class="sep"></div>
 
120
<div  class="menu">
 
121
       <a href="../../www/sponsors.html">Sponsors:</a>
 
122
 
 
123
<div class="sponsbox">
 
124
<div  class="sponsor">
 
125
  <a href="http://www.finanzvergleich.de">Versicherungen</a><!-- 200908070325 -->
 
126
</div>
 
127
<div  class="sponsor">
 
128
      <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 
129
</div>
 
130
<div  class="sponsor">
 
131
      <a href="http://www.online-kredit-index.de">Kredit</a><!-- 200908010120 -->
 
132
</div>
 
133
 
 
134
</div>
 
135
 
 
136
</div>
 
137
 
 
138
 
 
139
</div>
 
140
 
 
141
<div class="main">
 
142
 
101
143
<p class="navigation-index">[ <a href="#ClutImage">ClutImage</a> | <a href="#ContrastImage">ContrastImage</a> | <a href="#The ContrastStretchImage">The ContrastStretchImage</a> | <a href="#EnhanceImage">EnhanceImage</a> | <a href="#EqualizeImage">EqualizeImage</a> | <a href="#GammaImage">GammaImage</a> | <a href="#LevelImage">LevelImage</a> | <a href="#LevelImageChannel">LevelImageChannel</a> | <a href="#LevelizeImageChannel">LevelizeImageChannel</a> | <a href="#LevelImageColor">LevelImageColor</a> | <a href="#The LinearStretchImage">The LinearStretchImage</a> | <a href="#ModulateImage">ModulateImage</a> | <a href="#NegateImage">NegateImage</a> | <a href="#The NormalizeImage">The NormalizeImage</a> | <a href="#SigmoidalContrastImage">SigmoidalContrastImage</a> ]</p>
102
144
 
103
145
<div style="margin: auto;">
105
147
_8c.html" target="source" name="ClutImage">ClutImage</a></h2>
106
148
</div>
107
149
 
108
 
<p>ClutImage() replaces colors in the image from a color lookup table.</p></ol>
 
150
<p>ClutImage() replaces each color value in the given image, by using it as an index to lookup a replacement color value in a Color Look UP Table in the form of an image.  The values are extracted along a diagonal of the CLUT image so either a horizontal or vertial gradient image can be used.</p></ol>
 
151
 
 
152
<p>Typically this is used to either re-color a gray-scale image according to a color gradient in the CLUT image, or to perform a freeform histogram (level) adjustment according to the (typically gray-scale) gradient in the CLUT image.</p></ol>
 
153
 
 
154
<p>When the 'channel' mask includes the matte/alpha transparency channel but one image has no such channel it is assumed that that image is a simple gray-scale image that will effect the alpha channel values, either for gray-scale coloring (with transparent or semi-transparent colors), or a histogram adjustment of existing alpha channel values.   If both images have matte channels, direct and normal indexing is applied, which is rarely used.</p></ol>
109
155
 
110
156
<p>The format of the ClutImage method is:</p>
111
157
 
118
164
<p>A description of each parameter follows:</p></ol>
119
165
 
120
166
<h5>image</h5>
121
 
<ol><p>the image.</p></ol>
122
 
 
123
 
<h5>channel</h5>
124
 
<ol><p>the channel.</p></ol>
 
167
<ol><p>the image, which is replaced by indexed CLUT values</p></ol>
125
168
 
126
169
<h5>clut_image</h5>
127
 
<ol><p>the color lookup.</p></ol>
 
170
<ol><p>the color lookup table image for replacement color values.</p></ol>
 
171
 
 
172
<h5>channel</h5>
 
173
<ol><p>the channel.</p></ol>
128
174
 
129
175
<div style="margin: auto;">
130
176
  <h2><a href="http://www.imagemagick.org/api/MagickCore/enhance
201
247
<ol><p>the image.</p></ol>
202
248
 
203
249
<h5>exception</h5>
204
 
<ol><p>Return any errors or warnings in this structure.</p></ol>
 
250
<ol><p>return any errors or warnings in this structure.</p></ol>
205
251
 
206
252
<div style="margin: auto;">
207
253
  <h2><a href="http://www.imagemagick.org/api/MagickCore/enhance
516
562
<h5>midpoint</h5>
517
563
<ol><p>control the "toe" of the contast curve.</p></ol>
518
564
 
519
 
      </td>
520
 
      <td id="margin" width="1%" height="100%" valign="top" align="right">&nbsp;</td>
521
 
    </tr>
522
 
  </tbody>
523
 
  </table>
524
 
  <div id="linkbar">
525
 
    <span id="linkbar-west">
526
 
      <font size="-1">
527
 
      </font>
528
 
    </span>
 
565
 
 
566
</div>
 
567
 
 
568
<div id="linkbar">
 
569
 <!--    <span id="linkbar-west">&nbsp;</span>  -->
529
570
    <span id="linkbar-center">
530
 
      <a href="http://www.imagemagick.org/discourse-server/" target="736958025">Discourse Server</a> &bull;
 
571
      <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
531
572
      <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;
532
 
      <a href="http://cafe.imagemagick.org" target="1528480030">Cafe</a> &bull;
533
 
    <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi" target="2110126025">Studio</a>
534
 
    </span>
535
 
    <span id="linkbar-east">
536
 
      <font size="-1">
537
 
      </font>
538
 
    </span>
 
573
      <a href="http://cafe.imagemagick.org">Cafe</a> &bull;
 
574
    <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
 
575
    </span>
 
576
    <span id="linkbar-east">&nbsp;</span>
539
577
  </div>
540
 
  <div id="footer">
541
 
    <span id="footer-west">&copy; 1999-2008 ImageMagick Studio LLC</span>
 
578
  <div class="footer">
 
579
    <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>
 
580
    <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
542
581
  </div>
543
582
  <div style="clear: both; margin: 0; width: 100%; "></div>
544
583
</body>