<?xml version="1.0"?>
<page id="Gimp.pencil"
      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>Boolean</api:type>
      </api:returns>
      <api:name>gimp_pencil</api:name>
      <api:arg>
        <api:type>Gimp.Drawable</api:type>
        <api:name>drawable</api:name>
      </api:arg>
      <api:arg>
        <api:type>Array(Number(gdouble))</api:type>
        <api:name>strokes</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.pencil</title>
  <synopsis><code mime="text/x-gjs">
function pencil(drawable: <link xref="Gimp.Drawable">Gimp.Drawable</link>, strokes: Array(Number(gdouble))): Boolean {
    // Gjs wrapper for gimp_pencil()
}
  </code></synopsis>
  <p>Paint in the current brush without sub-pixel sampling.</p>  <p>This tool is the standard pencil. It draws linearly interpolated
lines through the specified stroke coordinates. It operates on the
specified drawable in the foreground color with the active brush.
The brush mask is treated as though it contains only black and white
values. Any value below half is treated as black; any above half, as
white.</p>

<terms>
<item>
<title><code>drawable</code></title>
  <p>The affected drawable.</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>
  <p>TRUE on success.</p>
</item>
</terms>

</page>
