<?xml version="1.0"?>
<page id="Gimp.Drawable.color_balance"
      type="topic"
      style="method"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="Gimp.Drawable" group="method" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>bool</api:type>
      </api:returns>
      <api:name>gimp_drawable_color_balance</api:name>
      <api:arg>
        <api:type>Gimp.Drawable</api:type>
        <api:name>self</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gimp.TransferMode</api:type>
        <api:name>transfer_mode</api:name>
      </api:arg>
      <api:arg>
        <api:type>bool</api:type>
        <api:name>preserve_lum</api:name>
      </api:arg>
      <api:arg>
        <api:type>float</api:type>
        <api:name>cyan_red</api:name>
      </api:arg>
      <api:arg>
        <api:type>float</api:type>
        <api:name>magenta_green</api:name>
      </api:arg>
      <api:arg>
        <api:type>float</api:type>
        <api:name>yellow_blue</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.Drawable.color_balance</title>
  <synopsis><code mime="text/x-python">
@accepts(Gimp.Drawable, Gimp.TransferMode, bool, float, float, float)
@returns(bool)
def color_balance(self, transfer_mode, preserve_lum, cyan_red, magenta_green, yellow_blue):
    # Python wrapper for gimp_drawable_color_balance()
  </code></synopsis>
  <p>Modify the color balance of the specified drawable.</p>  <p>Modify the color balance of the specified drawable. There are three
axis which can be modified: cyan-red, magenta-green, and
yellow-blue. Negative values increase the amount of the former,
positive values increase the amount of the latter. Color balance can
be controlled with the 'transfer_mode' setting, which allows
shadows, mid-tones, and highlights in an image to be affected
differently. The 'preserve-lum' parameter, if TRUE, ensures that the
luminosity of each pixel remains fixed.</p>
  <p>Since 2.10</p>
<terms>
<item>
<title><code>self</code></title>
  <p>The drawable.</p>
</item>
<item>
<title><code>transfer_mode</code></title>
  <p>Transfer mode.</p>
</item>
<item>
<title><code>preserve_lum</code></title>
  <p>Preserve luminosity values at each pixel.</p>
</item>
<item>
<title><code>cyan_red</code></title>
  <p>Cyan-Red color balance.</p>
</item>
<item>
<title><code>magenta_green</code></title>
  <p>Magenta-Green color balance.</p>
</item>
<item>
<title><code>yellow_blue</code></title>
  <p>Yellow-Blue color balance.</p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
