user: Describe Usage from the Blender manual or Python API, including usage steps and snippets.

assistant: ### Selecting a Brush and Material

In the Tool Settings select the brush, material and color type to use with the tool.
The Fill tool uses *Fill Brush* types.
See [Brush Settings](../brushes/draw.xhtml#grease-pencil-draw-common-options) for more information.

### Filling Areas

Click `LMB` in a closed stroke area. The tool will automatically calculate
the boundary and create a new closed stroke filled with the material selected.

|  |  |  |
| --- | --- | --- |
| ../../../../_images/grease-pencil_modes_draw_tools_fill_example-01.png   Original Drawing. | ../../../../_images/grease-pencil_modes_draw_tools_fill_example-02.png   Use the fill tool to leak materials on closed areas. | ../../../../_images/grease-pencil_modes_draw_tools_fill_example-03.png   Final filled drawing. |

### Fill Guides

If you have a large gap in an area that you want fill,
you can add fill guides manually, a temporary auxiliary lines for closing open shapes.
To create a fill guide stroke use `Alt`-`LMB` and draw a line to close the desired area.

|  |  |  |
| --- | --- | --- |
| ../../../../_images/grease-pencil_modes_draw_tools_fill_boundary-strokes-01.png   Original drawing. | ../../../../_images/grease-pencil_modes_draw_tools_fill_boundary-strokes-02.png   Add fill guide to close open areas (red lines). | ../../../../_images/grease-pencil_modes_draw_tools_fill_boundary-strokes-03.png   Use the Fill tool to leak material on the new closed area. |

When you are satisfied with the fill result you can delete the fill guide using
the *Clean Up* tool in the [Grease Pencil Menu](../../edit/grease_pencil_menu.xhtml) in Edit Mode.

### Automatic Gap Closure

A more automatic way to close gaps in an area that you want fill is using temporarily helper lines.
There are two method to use “Radius” or “Extend”

*Radius* use temporary auxiliary lines calculated from the radius of nearby open points to close open shapes.
Set the size more than zero to control the circle size over opened points
(the circle will disappear when the line close the gap).
Click over the area you want to be filled and change the length of the strokes using
`PageUp` `PageDown` or `Wheel`.
When you are satisfied with the length and you are sure the temporarily strokes cross each other,
click again to fill the area.

|  |  |  |
| --- | --- | --- |
| ../../../../_images/grease-pencil_modes_draw_tools_fill_extended-strokes-01.png   Original Drawing. | ../../../../_images/grease-pencil_modes_draw_tools_fill_radius-02.png   Use Radius mode to close open areas (Red circles and cyan lines). | ../../../../_images/grease-pencil_modes_draw_tools_fill_radius-03.png   Use Fill Tool to leak material on the new closed area. |

*Extend* use temporary auxiliary lines extending the actual strokes ends for closing open shapes.
Set the size more than zero to use the extended lines, click over the area you want to be filled
and change the length of the strokes using `PageUp`/`PageDown`, `Wheel` or a pen’s `MMB`.
When you are satisfied with the length and you are sure the temporarily strokes cross each other,
click again to fill the area.

|  |  |  |
| --- | --- | --- |
| ../../../../_images/grease-pencil_modes_draw_tools_fill_extended-strokes-01.png   Original Drawing. | ../../../../_images/grease-pencil_modes_draw_tools_fill_extended-strokes-02.png   Use Extend mode to close open areas (cyan lines). | ../../../../_images/grease-pencil_modes_draw_tools_fill_extended-strokes-03.png   Use Fill Tool to leak material on the new closed area. |