]> granicus.if.org Git - imagemagick/blobdiff - www/api/enhance.html
(no commit message)
[imagemagick] / www / api / enhance.html
index 08c80c40de0681471f8098ad8e0f25041b5027ec..4b154d759cc6353615204ecc7ce3a8c1b84cb392 100644 (file)
@@ -1,12 +1,13 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
-  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
-  <style type="text/css" media="screen,projection"><!--
-    @import url("../../www/magick.css");
-  --></style>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
+<head>\r
+  <meta http-equiv="Content-Type" value="application/xhtml+xml" />\r
+  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
+  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
+  <style type="text/css" media="screen,projection"><!--\r
+    @import url("../../www/magick.css");\r
+  --></style>\r
   <link rel="shortcut icon" href="../../images/wand.ico"  type="images/vnd.microsoft.icon"/>
   <title>ImageMagick: MagickCore, C API for ImageMagick: Enhance an Image</title>
   <meta http-equiv="Content-Language" content="en-US"/>
   <meta name="Author" content="ImageMagick Studio LLC"/>
   <meta name="Revisit-after" content="2 DAYS"/>
   <meta name="Resource-type" content="document"/>
-  <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
+  <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
   <meta name="Distribution" content="Global"/>
-</head>
-
-<body id="www-imagemagick-org">
-<div class="titlebar">
-<a href="../../index.html">
-  <img src="../../images/script.png" alt="[ImageMagick]"
-  style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
-<a href="http://www.networkredux.com">
-  <img src="../../images/networkredux.png" alt="[sponsor]"
-  style="margin: 45px auto; border: 0px; float: left;" /></a>
-<a href="http://www.imagemagick.org/discourse-server/">
-  <img src="../../images/logo.jpg" alt=""
-  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
-<a href="../../index.html">
-  <img src="../../images/sprite.jpg" alt=""
-  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
-</div>
-
-<div class="eastbar">
-
+</head>\r
+\r
+<body id="www-imagemagick-org">\r
+<div class="titlebar">\r
+<a href="../../index.html">\r
+  <img src="../../images/script.png" alt="[ImageMagick]"\r
+  style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>\r
+<a href="http://www.networkredux.com">\r
+  <img src="../../images/networkredux.png" alt="[sponsor]"\r
+  style="margin: 45px auto; border: 0px; float: left;" /></a>\r
+<a href="http://www.imagemagick.org/discourse-server/">\r
+  <img src="../../images/logo.jpg" alt=""\r
+  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
+<a href="../../index.html">\r
+  <img src="../../images/sprite.jpg" alt=""\r
+  style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
+</div>\r
+\r
+<div class="eastbar">\r
+\r
 <div class="menu">
   <a href="../../index.html">About ImageMagick</a>
 </div>
-<div class="sep"></div>
+<div class="sep"></div>\r
 <div class="menu">
   <a href="../../www/command-line-tools.html">Command-line Tools</a>
 </div>
@@ -77,7 +78,7 @@
 <div class="menu">
   <a href="../../www/architecture.html">Architecture</a>
 </div>
-<div class="sep"></div>
+<div class="sep"></div>\r
 <div  class="menu">
    <a href="../../www/install-source.html">Install from Source</a>
 </div>
 <div class="menu">
   <a href="../../www/resources.html">Resources</a>
 </div>
-<div class="sep"></div>
+<div class="sep"></div>\r
 <div class="menu">
   <a href="../../www/download.html">Download</a>
 </div>
-<div class="sep"></div>
+<div class="sep"></div>\r
 <div class="menu">
   <a href="../http://www.imagemagick.org/script/search.php">Search</a>
 </div>
-<div class="sep"></div>
+<div class="sep"></div>\r
 <div class="menu">
   <a href="../../www/sitemap.html">Site Map</a>
 </div>
 <div  class="sub">
     <a href="../../www/links.html">Links</a>
 </div>
-<div class="sep"></div>
+<div class="sep"></div>\r
 <div  class="menu">
   <a href="../../www/sponsors.html">Sponsors:</a>
 
 <div class="sponsbox">
 <div  class="sponsor">
-   <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
+   <a href="http://www.hygi.de">Reinigungsmittel</a><!-- 201002000400+ -->
 </div>
 <div  class="sponsor">
-  <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
+  <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
 </div>
 <div  class="sponsor">
-  <a href="http://www.print24.de/">Druckerei</a><!-- 200911010480 -->
+  <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201004010120 Buchhorn -->
 </div>
 <div  class="sponsor">
-  <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
+  <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
 </div>
 <div  class="sponsor">
-  <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201001010120 Buchhorn -->
+  <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 </div>
+<div  class="sponsor">
+   <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
 </div>
+<div  class="sponsor">
+   <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
 </div>
-
-
+<div  class="sponsor">
+  <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
 </div>
-
-<div class="main">
-
-<p class="navigation-index">[<a href="#AutoGammaImage">AutoGammaImage</a> &bull; <a href="#AutoLevelImage">AutoLevelImage</a> &bull; <a href="#ColorDecisionListImage">ColorDecisionListImage</a> &bull; <a href="#ClutImage">ClutImage</a> &bull; <a href="#ContrastImage">ContrastImage</a> &bull; <a href="#The ContrastStretchImage">The ContrastStretchImage</a> &bull; <a href="#EnhanceImage">EnhanceImage</a> &bull; <a href="#EqualizeImage">EqualizeImage</a> &bull; <a href="#GammaImage">GammaImage</a> &bull; <a href="#HaldClutImage">HaldClutImage</a> &bull; <a href="#LevelImage">LevelImage</a> &bull; <a href="#LevelImageChannel">LevelImageChannel</a> &bull; <a href="#LevelizeImageChannel">LevelizeImageChannel</a> &bull; <a href="#LevelImageColor">LevelImageColor</a> &bull; <a href="#The LinearStretchImage">The LinearStretchImage</a> &bull; <a href="#ModulateImage">ModulateImage</a> &bull; <a href="#NegateImage">NegateImage</a> &bull; <a href="#The NormalizeImage">The NormalizeImage</a> &bull; <a href="#SigmoidalContrastImage">SigmoidalContrastImage</a>]</p>
+</div>
+</div>
+\r
+\r
+</div>\r
+\r
+<div class="main">\r
+\r
+<p class="navigation-index">[<a href="#AutoGammaImage">AutoGammaImage</a> &bull; <a href="#AutoLevelImage">AutoLevelImage</a> &bull; <a href="#ColorDecisionListImage">ColorDecisionListImage</a> &bull; <a href="#ClutImage">ClutImage</a> &bull; <a href="#ContrastImage">ContrastImage</a> &bull; <a href="#The ContrastStretchImage">The ContrastStretchImage</a> &bull; <a href="#EnhanceImage">EnhanceImage</a> &bull; <a href="#EqualizeImage">EqualizeImage</a> &bull; <a href="#GammaImage">GammaImage</a> &bull; <a href="#HaldClutImage">HaldClutImage</a> &bull; <a href="#LevelImage">LevelImage</a> &bull; <a href="#LevelizeImage">LevelizeImage</a> &bull; <a href="#LevelizeImageChannel">LevelizeImageChannel</a> &bull; <a href="#LevelImageColor">LevelImageColor</a> &bull; <a href="#The LinearStretchImage">The LinearStretchImage</a> &bull; <a href="#ModulateImage">ModulateImage</a> &bull; <a href="#NegateImage">NegateImage</a> &bull; <a href="#The NormalizeImage">The NormalizeImage</a> &bull; <a href="#SigmoidalContrastImage">SigmoidalContrastImage</a>]</p>
 
 <h2><a href="http://www.imagemagick.org/api/MagickCore/enhance
 _8c.html" target="source" name="AutoGammaImage">AutoGammaImage</a></h2>
@@ -153,7 +163,7 @@ _8c.html" target="source" name="AutoGammaImage">AutoGammaImage</a></h2>
 
 <p>AutoGammaImage() extract the 'mean' from the image and adjust the image to try make set its gamma appropriatally.</p></ol>
 
-<p>The format of the LevelImage method is:</p>
+<p>The format of the AutoGammaImage method is:</p>
 
 <pre class="code">
   MagickBooleanType AutoGammaImage(Image *image)
@@ -444,18 +454,21 @@ _8c.html" target="source" name="LevelImage">LevelImage</a></h2>
 
  </div>
 <h2><a href="http://www.imagemagick.org/api/MagickCore/enhance
-_8c.html" target="source" name="LevelImageChannel">LevelImageChannel</a></h2>
+_8c.html" target="source" name="LevelizeImage">LevelizeImage</a></h2>
 <div class="doc-section">
 
-<p>LevelImageChannel() applies the normal LevelImage() operation to just the Specific channels specified, spreading out the values between the black and white points over the entire range of values.  Gamma correction is also applied after the values has been mapped.</p></ol>
+<p>LevelizeImage() applies the normal level operation to the image, spreading out the values between the black and white points over the entire range of values.  Gamma correction is also applied after the values has been mapped.</p></ol>
 
 <p>It is typically used to improve image contrast, or to provide a controlled linear threshold for the image. If the black and white points are set to the minimum and maximum values found in the image, the image can be normalized.  or by swapping black and white values, negate the image.</p></ol>
 
-<p>The format of the LevelizeImageChannel method is:</p>
+<p>The format of the LevelizeImage method is:</p>
 
 <pre class="code">
-  MagickBooleanType LevelImageChannel(Image *image,
-    const ChannelType channel,black_point,white_point,gamma)
+  MagickBooleanType LevelizeImage(Image *image,const double black_point,
+    const double white_point,const double gamma)
+  MagickBooleanType LevelizeImageChannel(Image *image,
+    const ChannelType channel,const double black_point,
+    const double white_point,const double gamma)
 </pre>
 
 <p>A description of each parameter follows:</p></ol>
@@ -515,16 +528,19 @@ _8c.html" target="source" name="LevelizeImageChannel">LevelizeImageChannel</a></
 _8c.html" target="source" name="LevelImageColor">LevelImageColor</a></h2>
 <div class="doc-section">
 
-<p>LevelImageColor() will map the given color to "black" and "white" values, limearly spreading out the colors, and level values on a channel by channel bases, as per LevelImage().  The given colors allows you to specify different level ranges for each of the color channels seperatally.</p></ol>
+<p>LevelImageColor() maps the given color to "black" and "white" values, linearly spreading out the colors, and level values on a channel by channel bases, as per LevelImage().  The given colors allows you to specify different level ranges for each of the color channels seperatally.</p></ol>
 
 <p>If the boolean 'invert' is set true the image values will modifyed in the reverse direction. That is any existing "black" and "white" colors in the image will become the color values given, with all other values compressed appropriatally.  This effectivally maps a greyscale gradient into the given color gradient.</p></ol>
 
-<p>The format of the LevelImageColors method is:</p>
+<p>The format of the LevelColorsImageChannel method is:</p>
 
 <pre class="code">
-    MagickBooleanType LevelImageColors(Image *image,const ChannelType channel,
-      const MagickPixelPacket *black_color,const MagickPixelPacket *white_color,
-      const MagickBooleanType invert)
+      MagickBooleanType LevelColorsImage(Image *image,
+  const MagickPixelPacket *black_color,
+  const MagickPixelPacket *white_color,const MagickBooleanType invert)
+      MagickBooleanType LevelColorsImageChannel(Image *image,
+  const ChannelType channel,const MagickPixelPacket *black_color,
+  const MagickPixelPacket *white_color,const MagickBooleanType invert)
 </pre>
 
 <p>A description of each parameter follows:</p></ol>
@@ -675,22 +691,22 @@ _8c.html" target="source" name="SigmoidalContrastImage">SigmoidalContrastImage</
 <ol><p>control the "toe" of the contast curve.</p></ol>
 
  </div>
-
-</div>
-
-<div id="linkbar">
- <!--    <span id="linkbar-west">&nbsp;</span>  -->
-    <span id="linkbar-center">
-      <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
-      <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;
-    <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
-    </span>
-    <span id="linkbar-east">&nbsp;</span>
-  </div>
-  <div class="footer">
-    <span id="footer-west">&copy; 1999-2009 ImageMagick Studio LLC</span>
-    <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
-  </div>
-  <div style="clear: both; margin: 0; width: 100%; "></div>
-</body>
-</html>
+\r
+</div>\r
+\r
+<div id="linkbar">\r
+ <!--    <span id="linkbar-west">&nbsp;</span>  -->\r
+    <span id="linkbar-center">\r
+      <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
+      <a href="../../www/mailing-list.html">Mailing Lists</a> &bull;\r
+    <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
+    </span>\r
+    <span id="linkbar-east">&nbsp;</span>\r
+  </div>\r
+  <div class="footer">\r
+    <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>\r
+    <span id="footer-east"> <a href="../http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
+  </div>\r
+  <div style="clear: both; margin: 0; width: 100%; "></div>\r
+</body>\r
+</html>\r