Differential D16335 Diff 57327 manual/sculpt_paint/brush/brush.rst

Changeset View

Standalone View

manual/sculpt_paint/brush/brush.rst

	.. _bpy.types.Brush:			.. _bpy.types.Brush:
	.. _bpy.ops.brush:			.. _bpy.ops.brush:
	.. _bpy.types.UnifiedPaintSettings:			.. _bpy.types.UnifiedPaintSettings:

	*******			*******
	Brushes			Brushes
	*******			*******

	.. reference::			.. reference::

	:Mode: Sculpt Mode			:Mode: Sculpt Mode
	:Panel: :menuselection:`Sidebar --> Tools --> Brushes`			:Panel: :menuselection:`Sidebar --> Tools --> Brushes`

	For painting/sculpting modes each brush type is exposed as a tool,			For painting/sculpting modes each brush type is exposed as a tool in the toolbar.
	the brush can be changed from the tool setting.			The brush on the other hand is a saved preset of all the brush settings, including a name and thumbnail.

				All these settings can be found and changed here in the tool setting (brush, texture, stroke, falloff & cursor).

	.. figure:: /images/sculpt-paint_brush_brush_data-block-menu.png			.. figure:: /images/sculpt-paint_brush_brush_data-block-menu.png
	:align: right			:align: right

	Brush data-block menu.			Brush panel in the tool settings.

	Brushes			Brushes
	The :ref:`ui-data-block` to select a preset brush type or a custom brush.			Clicking on the brush thumbnail will open the :ref:`ui-data-block` to select a brush.
	They are a combination of a "tool", along with stroke, texture, and options.

	Add Brush			Add Brush (Duplicate icon)
	When you add a brush, the new brush is a clone of the current one.			When you add a brush, the new brush is a duplicate of the current one.
				Fake User (Shield icon)
				Enabling this button will ensure that the brush will not be deleted,
				even if it is not used by any tool.
				Unlink Data-Block (Cross icon)
				Unassign the brush from the active tool.
				Hold :kbd:`Shift` to remove the brush from all users,
				so it will be deleted upon reloading the file or purging orphan data.

	Brush Specials			Brush Specials (Arrow button)
	Enabled Modes			Enabled Modes
	Todo.			Enable the brush to be used in different (even multiple) modes.
				For example, the brushes in Weight Paint and Vertex Paint mode are shared.
	Tool Selection			Tool Selection
	Todo.			Transfer the brush preset to be used by a different brush type.
	Reset Brush			Reset Brush
	Todo.			Reset all brush settings to the default values of the current brush type.

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

	Custom Icon			Custom Icon
	Allows definition of a custom brush icon.			Define a custom brush thumbnail from an image file.

	.. note::

	In order to save a custom brush in a blend-user, enable Fake User.