<?xml version="1.0"?>
<page id="Gimp.Image.merge_down"
      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.Image" group="method" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>Gimp.Layer</api:type>
      </api:returns>
      <api:name>gimp_image_merge_down</api:name>
      <api:arg>
        <api:type>Gimp.Image</api:type>
        <api:name>self</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gimp.Layer</api:type>
        <api:name>merge_layer</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gimp.MergeType</api:type>
        <api:name>merge_type</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.Image.merge_down</title>
  <synopsis><code mime="text/x-python">
@accepts(Gimp.Image, Gimp.Layer, Gimp.MergeType)
@returns(Gimp.Layer)
def merge_down(self, merge_layer, merge_type):
    # Python wrapper for gimp_image_merge_down()
  </code></synopsis>
  <p>Merge the layer passed and the first visible layer below.</p>  <p>This procedure combines the passed layer and the first visible layer
below it using the specified merge type. A merge type of
EXPAND_AS_NECESSARY expands the final layer to encompass the areas
of the visible layers. A merge type of CLIP_TO_IMAGE clips the final
layer to the extents of the image. A merge type of
CLIP_TO_BOTTOM_LAYER clips the final layer to the size of the
bottommost layer.</p>

<terms>
<item>
<title><code>self</code></title>
  <p>The image.</p>
</item>
<item>
<title><code>merge_layer</code></title>
  <p>The layer to merge down from.</p>
</item>
<item>
<title><code>merge_type</code></title>
  <p>The type of merge.</p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
