.. _tool_fill:

########################
     Fill Tool
########################

|Tool_fill_icon.png| \ **ALT-F**\ 

The ``Fill Tool`` allows you to change the color of some of the geometry
type layers very quickly. It uses the default ``foreground color`` to be
applied to the color of the layer you click on.

.. _tool_fill  Usage:

Usage
-----

To use this tool simply click on the ``Fill Tool`` button and after that
click onto a non transparent part of a visible layer.

The ``Fill Tool`` acts the same that if you right click the color
parameter of any of the Layers that have it and select
``Apply Default Color`` from the context menu.

If the layer accepts the ``Fill Tool`` message it would change its color
to the current ``foreground color``. If the layer doesn't accept the
message from the ``Fill Tool`` it complains and shows a message error.

Those are the layers that currently are affected by the Fill Tool:

-  |Region_Layer|
-  |Outline_Layer|
-  |Circle_Layer|
-  |Rectangle_Layer|
-  |Polygon_Layer|
-  |Star_Layer|
-  |Checkerboard_Layer|

The rest of visual layers doesn't accept the ``Fill Tool`` usage over
them because they use a gradient to fill the visual area (like the
Gradient Layers, the |Plant_Layer| and others) or simply
it is not possible determine if you're clicking over the layer or over a
transparent area although it has a single color definition for the
visual area (|Text_Layer| for example).

.. _tool_fill  Options:

Options
-------

-  None

.. raw:: mediawiki

   {{FillToolOptions}}

.. |Tool_fill_icon.png| image:: fill_dat/Tool_fill_icon.png
   :width: 64px


.. |Region_Layer| replace:: :ref:`Region Layer <layer_region>`
.. |Outline_Layer| replace:: :ref:`Outline Layer <layer_outline>`
.. |Circle_Layer| replace:: :ref:`Circle Layer <layer_circle>`
.. |Rectangle_Layer| replace:: :ref:`Rectangle Layer <layer_rectangle>`
.. |Polygon_Layer| replace:: :ref:`Polygon Layer <layer_polygon>`
.. |Star_Layer| replace:: :ref:`Star Layer <layer_star>`
.. |Checkerboard_Layer| replace:: :ref:`Checkerboard Layer <layer_checkerboard>`
.. |Plant_Layer| replace:: :ref:`Plant Layer <layer_plant>`
.. |Text_Layer| replace:: :ref:`Text Layer <layer_text>`