.. _sculpt-paint-brush-display:
.. _bpy.types.Brush.cursor_overlay_alpha:
.. _bpy.types.Brush.use_cursor_overlay:
.. _bpy.types.Brush.texture_overlay_alpha:
.. _bpy.types.Brush.use_primary_overlay:

*******
Display
*******

.. admonition:: Reference
   :class: refbox

   :Mode:      All Paint Modes
   :Header:    :menuselection:`Tool Settings --> Display`
   :Panel:     :menuselection:`Sidebar --> Tool --> Display`

.. figure:: /images/sculpt-paint_brush_display_panel.png
   :align: right

   Brush appearance options.


Allows you to customize the display in the viewport of the *Curve* and *Texture*
that is applied to the brush.

Alpha
   You can change the amount of transparency used
   when showing the texture using the slider.
Stroke Overlay
   The brush icon allows you to turn off the viewport overlay during strokes.
View
   The eye icon is used as a toggle to show or hide the given brush texture.


.. _bpy.types.Paint.show_brush:
.. _bpy.types.Brush.cursor_color_add:

Show Brush
==========

Shows the brush shape in the viewport.

Color
   Set the color of the brush ring. Depending on the current mode there will
   be options to set a single Color or a Color for Adding/Subtracting.


.. _bpy.types.Brush.use_custom_icon:
.. _bpy.types.Brush.icon_filepath:

Custom Icon
===========

Allows definition of a custom brush icon.