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.html#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.html) 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. |