<?xml version="1.0"?>
<page id="Gimp.smudge"
      type="topic"
      style="function"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="index" group="function" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>bool</api:type>
      </api:returns>
      <api:name>gimp_smudge</api:name>
      <api:arg>
        <api:type>Gimp.Drawable</api:type>
        <api:name>drawable</api:name>
      </api:arg>
      <api:arg>
        <api:type>float</api:type>
        <api:name>pressure</api:name>
      </api:arg>
      <api:arg>
        <api:type>gsize</api:type>
        <api:name>num_strokes</api:name>
      </api:arg>
      <api:arg>
        <api:type>[float]</api:type>
        <api:name>strokes</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.smudge</title>
  <synopsis><code mime="text/x-python">
@accepts(Gimp.Drawable, float, gsize, [float])
@returns(bool)
def smudge(drawable, pressure, num_strokes, strokes):
    # Python wrapper for gimp_smudge()
  </code></synopsis>
  <p>Smudge image with varying pressure.</p>  <p>This tool simulates a smudge using the current brush. High pressure
results in a greater smudge of paint while low pressure results in a
lesser smudge.</p>

<terms>
<item>
<title><code>drawable</code></title>
  <p>The affected drawable.</p>
</item>
<item>
<title><code>pressure</code></title>
  <p>The pressure of the smudge strokes.</p>
</item>
<item>
<title><code>num_strokes</code></title>
  <p>Number of stroke control points (count each coordinate as 2 points).</p>
</item>
<item>
<title><code>strokes</code></title>
  <p>Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.</p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
