Changeset View
Changeset View
Standalone 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. | |||||