Brush Assets Project #104846

Merged
Julian Eisel merged 32 commits from JulianEisel/blender-manual:temp-brush-assets into main 2024-07-08 18:45:49 +02:00
31 changed files with 188 additions and 120 deletions
Showing only changes of commit 9d344b34f3 - Show all commits

View File

@ -270,5 +270,8 @@ RedirectMatch "^/manual/{lang}/{version}/sculpt_paint/curves_sculpting/tools/\
(index|add_curves|comb_curves|delete_curves|density_curves|grow_shrink_curves|\ (index|add_curves|comb_curves|delete_curves|density_curves|grow_shrink_curves|\
pinch_curves|puff_curves|selection_paint|slide_curves|smooth_curves|snake_hook_curves).html" \ pinch_curves|puff_curves|selection_paint|slide_curves|smooth_curves|snake_hook_curves).html" \
"^/manual/{lang}/{version}/sculpt_paint/curves_sculpting/brushes/$1.html" "^/manual/{lang}/{version}/sculpt_paint/curves_sculpting/brushes/$1.html"
# Grease pencil draw tools
RedirectMatch "^/manual/{lang}/{version}/grease_pencil/modes/draw/tools/(draw|erase|fill|tint).html" \
"^/manual/{lang}/{version}/sculpt_paint/curves_sculpting/brushes/$1.html"
# Texture paint tools converted to asset # Texture paint tools converted to asset
RedirectMatch "^/manual/{lang}/{version}/sculpt_paint/texture_paint/tools.html" "^/manual/{lang}/{version}/sculpt_paint/texture_paint/brushes.html" RedirectMatch "^/manual/{lang}/{version}/sculpt_paint/texture_paint/tools.html" "^/manual/{lang}/{version}/sculpt_paint/texture_paint/brushes.html"

View File

@ -58,7 +58,7 @@ to interactively preview how the material looks in the scene.
Grease Pencil materials are data-blocks that can be :doc:`assigned </render/materials/assignment>` Grease Pencil materials are data-blocks that can be :doc:`assigned </render/materials/assignment>`
to one or more objects, and different materials can be assigned to different strokes. to one or more objects, and different materials can be assigned to different strokes.
In Grease Pencil the :doc:`brush </grease_pencil/modes/draw/tools/index>` In Grease Pencil the :doc:`brush </grease_pencil/modes/draw/brushes/index>`
settings together with the material used will define the look and feel of the final strokes. settings together with the material used will define the look and feel of the final strokes.
Materials slots in the :ref:`List view <ui-list-view>` also have some extra controls Materials slots in the :ref:`List view <ui-list-view>` also have some extra controls

View File

@ -1,15 +1,14 @@
.. _tool-grease-pencil-draw-draw:
********* **********
Draw Tool Draw Brush
********* **********
.. reference:: .. reference::
:Mode: Draw Mode :Mode: Draw Mode
:Tool: :menuselection:`Toolbar --> Draw` :Brush: :menuselection:`Asset Shelf --> Draw`
The Draw tool allows you to draw free-hand strokes. The Draw brush allows you to draw free-hand strokes.
Brush Settings Brush Settings
@ -284,6 +283,6 @@ Switching to the Erase Tool
--------------------------- ---------------------------
:kbd:`Ctrl-LMB` changes temporally to the active Erase tool. :kbd:`Ctrl-LMB` changes temporally to the active Erase tool.
See :doc:`Erase Tool </grease_pencil/modes/draw/tools/erase>` for more information. See :doc:`Erase Tool </grease_pencil/modes/draw/brushes/erase>` for more information.
You can also use :kbd:`B` to delete all the points in the selected drawing area. You can also use :kbd:`B` to delete all the points in the selected drawing area.

View File

@ -1,15 +1,15 @@
.. _tool-grease-pencil-draw-erase: .. _tool-grease-pencil-draw-erase:
********** ***********
Erase Tool Erase Brush
********** ***********
.. reference:: .. reference::
:Mode: Draw Mode :Mode: Draw Mode
:Tool: :menuselection:`Toolbar --> Erase` :Brush: :menuselection:`Asset Shelf --> Erase`
The Erase tool erase already drawn strokes. The Erase brush erases already drawn strokes.
Brush Settings Brush Settings

View File

@ -1,15 +1,14 @@
.. _tool-grease-pencil-draw-fill:
********* **********
Fill Tool Fill Brush
********* **********
.. reference:: .. reference::
:Mode: Draw Mode :Mode: Draw Mode
:Tool: :menuselection:`Toolbar --> Fill` :Brush: :menuselection:`Asset Shelf --> Fill`
The Fill tool is used to automatically fill closed strokes areas. The Fill brush is used to automatically fill closed strokes areas.
Brush Settings Brush Settings
@ -248,4 +247,4 @@ Switch to Draw Tool
Use :kbd:`Ctrl-LMB` to change temporary to the active draw tool. Use :kbd:`Ctrl-LMB` to change temporary to the active draw tool.
For example to manually cover small areas difficult to reach for the Fill tool. For example to manually cover small areas difficult to reach for the Fill tool.
See :doc:`Draw Tool </grease_pencil/modes/draw/tools/draw>` for more information. See :doc:`Draw Tool </grease_pencil/modes/draw/brushes/draw>` for more information.

View File

@ -0,0 +1,13 @@
#########
Brushes
#########
.. toctree::
:maxdepth: 2
overview.rst
draw.rst
fill.rst
erase.rst
tint.rst

View File

@ -0,0 +1,19 @@
********
Overview
********
There are a number of brushes for draw mode bundled in the *Essentials* asset library. This is an
overview of all of them.
:doc:`Draw <draw>`
Draw free-hand strokes.
:doc:`Fill <fill>`
Automatic fill closed strokes areas.
:doc:`Erase <erase>`
Erase strokes.
:doc:`Tint <tint>`
Colorize stroke points.

View File

@ -1,15 +1,15 @@
.. _tool-grease-pencil-draw-tint: .. _tool-grease-pencil-draw-tint:
********* **********
Tint Tool Tint Brush
********* **********
.. reference:: .. reference::
:Mode: Draw Mode :Mode: Draw Mode
:Tool: :menuselection:`Toolbar --> Tint` :Brush: :menuselection:`Brush --> Tint`
The Tint tool allows you to paint onto strokes point mixing the material base color with a selected color. The Tint brush allows you to paint onto strokes point mixing the material base color with a selected color.
Brush Settings Brush Settings

View File

@ -7,6 +7,7 @@
:maxdepth: 2 :maxdepth: 2
introduction.rst introduction.rst
brushes/index.rst
tools.rst tools.rst
tools/index.rst tools/index.rst
tool_settings/index.rst tool_settings/index.rst

View File

@ -10,17 +10,8 @@ Drawing Tools
Cursor Cursor
Change the location of the 3D Cursor. Change the location of the 3D Cursor.
:ref:`Draw <tool-grease-pencil-draw-draw>` :doc:`Brush <grease_pencil/modes/draw/brushes/overview>`
Draw free-hand strokes. Tool to use for any of the drawing brushes.
:ref:`Fill <tool-grease-pencil-draw-fill>`
Automatic fill closed strokes areas.
:ref:`Erase <tool-grease-pencil-draw-erase>`
Erase strokes.
:ref:`Tint <tool-grease-pencil-draw-tint>`
Colorize stroke points.
:ref:`Cutter <tool-grease-pencil-draw-cutter>` :ref:`Cutter <tool-grease-pencil-draw-cutter>`
Cut strokes in between others. Cut strokes in between others.

View File

@ -17,7 +17,7 @@ Tool Settings
You can configure the brush main settings exposed on the Tool Settings for convenience. You can configure the brush main settings exposed on the Tool Settings for convenience.
For the draw brushes configuration and settings see: For the draw brushes configuration and settings see:
:doc:`Draw Brush </grease_pencil/modes/draw/tools/draw>`. :doc:`Draw Brush </grease_pencil/modes/draw/brushes/draw>`.
Subdivisions Subdivisions
The number of stroke points between each stroke edge. The number of stroke points between each stroke edge.

View File

@ -17,7 +17,7 @@ Tool Settings
You can configure the brush main settings exposed on the Tool Settings for convenience. You can configure the brush main settings exposed on the Tool Settings for convenience.
For the draw brushes configuration and settings see: For the draw brushes configuration and settings see:
:doc:`Draw Brush </grease_pencil/modes/draw/tools/draw>`. :doc:`Draw Brush </grease_pencil/modes/draw/brushes/draw>`.
Subdivisions Subdivisions
The number of stroke points between each stroke edge. The number of stroke points between each stroke edge.

View File

@ -0,0 +1,17 @@
*****
Brush
*****
.. reference::
:Mode: Draw Mode
:Tool: :menuselection:`Toolbar --> Brush`
Tool to use for any of the Grease Pencil *Draw* mode brushes. Activating a brush from an asset
shelf or brush selector will also activate this tool for convenience.
See :doc:`brushes </grease_pencil/modes/draw/brushes/index>` (or the
:doc:`overview </sculpt_paint/sculpting/brushes/overview>`) for a detailed list of all brushes and
their options.

View File

@ -17,7 +17,7 @@ Tool Settings
You can configure the brush main settings exposed on the Tool Settings for convenience. You can configure the brush main settings exposed on the Tool Settings for convenience.
For the draw brushes configuration and settings see: For the draw brushes configuration and settings see:
:doc:`Draw Brush </grease_pencil/modes/draw/tools/draw>`. :doc:`Draw Brush </grease_pencil/modes/draw/brushes/draw>`.
Subdivisions Subdivisions
The number of stroke points between each stroke edge. The number of stroke points between each stroke edge.

View File

@ -17,7 +17,7 @@ Tool Settings
You can configure the brush main settings exposed on the Tool Settings for convenience. You can configure the brush main settings exposed on the Tool Settings for convenience.
For the draw brushes configuration and settings see: For the draw brushes configuration and settings see:
:doc:`Draw Brush </grease_pencil/modes/draw/tools/draw>`. :doc:`Draw Brush </grease_pencil/modes/draw/brushes/draw>`.
Subdivisions Subdivisions
The number of stroke points between each stroke edge. The number of stroke points between each stroke edge.

View File

@ -7,10 +7,7 @@
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2
draw.rst brush.rst
fill.rst
erase.rst
tint.rst
cutter.rst cutter.rst
eyedropper.rst eyedropper.rst
line.rst line.rst

View File

@ -17,7 +17,7 @@ Tool Settings
You can configure the brush main settings exposed on the Tool Settings for convenience. You can configure the brush main settings exposed on the Tool Settings for convenience.
For the draw brushes configuration and settings see: For the draw brushes configuration and settings see:
:doc:`Draw Brush </grease_pencil/modes/draw/tools/draw>`. :doc:`Draw Brush </grease_pencil/modes/draw/brushes/draw>`.
Subdivisions Subdivisions
The number of stroke points between each stroke edge. The number of stroke points between each stroke edge.

View File

@ -17,7 +17,7 @@ Tool Settings
You can configure the brush main settings exposed on the Tool Settings for convenience. You can configure the brush main settings exposed on the Tool Settings for convenience.
For the draw brushes configuration and settings see: For the draw brushes configuration and settings see:
:doc:`Draw Brush </grease_pencil/modes/draw/tools/draw>`. :doc:`Draw Brush </grease_pencil/modes/draw/brushes/draw>`.
Subdivisions Subdivisions
The number of stroke points between each stroke edge. The number of stroke points between each stroke edge.

View File

@ -217,7 +217,7 @@ Boundary Strokes
:Menu: :menuselection:`Grease Pencil --> Clean Up --> Boundary Strokes` :Menu: :menuselection:`Grease Pencil --> Clean Up --> Boundary Strokes`
Removes boundary strokes used by the *Fill* tool. Removes boundary strokes used by the *Fill* tool.
See :doc:`Fill tool </grease_pencil/modes/draw/tools/fill>` for more information. See :doc:`Fill tool </grease_pencil/modes/draw/brushes/fill>` for more information.
Mode Mode
Active Frame Only Active Frame Only

View File

@ -0,0 +1,46 @@
*****************
Sculpting Brushes
*****************
Brushes for Grease Pencil *Sculpt* mode bundled in the *Essentials* library.
See :doc:`Brush </grease_pencil/modes/sculpting/tool_settings/brush>` for more information.
.. figure:: /images/grease-pencil_modes_sculpting_tools_brushes.png
:align: right
Smooth Stroke
Eliminates irregularities in the area of the drawing
within the brush's influence by smoothing the positions of the points.
Thickness Stroke
Increase or decrease the points thickness in the area of the drawing
within the brush's influence.
Strength Stroke
Increase or decrease the points transparency (alpha) in the area of the drawing
within the brush's influence.
Randomize Stroke
Add noise to the strokes in the area of the drawing
within the brush's influence by moving points location in a random way.
Grab Stroke
Used to drag a group of points around. Unlike the other brushes,
Grab does not modify different points as the brush is dragged across the model.
Instead, Grab selects a group of points on mouse-down, and pulls them to follow the mouse.
The effect is similar to moving a group of points in Edit Mode with Proportional Editing enabled.
Pull Stroke
Moves points in the direction of the brush stroke.
Twist Stroke
Twist the points in counter-clockwise (CCW) or Clockwise (CW) rotation.
Pinch Stroke
Pulls points towards the center of the brush.
The inverse setting is Inflate, in which points are pushed away from the center of the brush.
Clone Stroke
Adds copies of the strokes in the clipboard in the center of the brush.
You have to copy the selected strokes you want into the clipboard with :kbd:`Ctrl-C` before using the tool.

View File

@ -7,5 +7,6 @@
:maxdepth: 2 :maxdepth: 2
introduction.rst introduction.rst
brushes.rst
tools.rst tools.rst
tool_settings/brush.rst tool_settings/brush.rst

View File

@ -4,48 +4,8 @@
Sculpting Tools Sculpting Tools
*************** ***************
For Grease Pencil sculpt modes each brush type is exposed as a tool, Brush
the brush can be changed in the Tool Settings. Tool to use for any of the sculpting :doc:`brushes <brushes>`.
See :doc:`Brush </grease_pencil/modes/sculpting/tool_settings/brush>` for more information.
.. figure:: /images/grease-pencil_modes_sculpting_tools_brushes.png
:align: right
Smooth
Eliminates irregularities in the area of the drawing
within the brush's influence by smoothing the positions of the points.
Thickness
Increase or decrease the points thickness in the area of the drawing
within the brush's influence.
Strength
Increase or decrease the points transparency (alpha) in the area of the drawing
within the brush's influence.
Randomize
Add noise to the strokes in the area of the drawing
within the brush's influence by moving points location in a random way.
Grab
Used to drag a group of points around. Unlike the other brushes,
Grab does not modify different points as the brush is dragged across the model.
Instead, Grab selects a group of points on mouse-down, and pulls them to follow the mouse.
The effect is similar to moving a group of points in Edit Mode with Proportional Editing enabled.
Push
Moves points in the direction of the brush stroke.
Twist
Twist the points in counter-clockwise (CCW) or Clockwise (CW) rotation.
Pinch/Inflate
Pulls points towards the center of the brush.
The inverse setting is Inflate, in which points are pushed away from the center of the brush.
Clone
Adds copies of the strokes in the clipboard in the center of the brush.
You have to copy the selected strokes you want into the clipboard with :kbd:`Ctrl-C` before using the tool.
:ref:`Annotate <tool-annotate-freehand>` :ref:`Annotate <tool-annotate-freehand>`
Draw free-hand annotation. Draw free-hand annotation.

View File

@ -0,0 +1,23 @@
********************
Vertex Paint Brushes
********************
Brushes for Grease Pencil *Vertex Paint* mode bundled in the *Essentials* library.
Paint Point Color
Paints a specified color over the object.
Blur Point Color
Smooths out the colors of adjacent vertices. In this mode the Color
Value is ignored. The strength defines how much the colors are blurred.
Average Point Color
Smooths color by painting the average resulting color from all colors under the brush.
Smear Point Color
Smudges colors by grabbing the colors under the brush and "dragging" them.
This can be imagined as a finger painting tool.
Replace Point Color
Change the color only to the stroke points that already have a color applied.

View File

@ -7,6 +7,7 @@
:maxdepth: 2 :maxdepth: 2
introduction.rst introduction.rst
brushes.rst
tools.rst tools.rst
tool_settings/brush.rst tool_settings/brush.rst
editing.rst editing.rst

View File

@ -6,22 +6,8 @@ Vertex Paint Tools
.. figure:: /images/grease-pencil_modes_vertex-paint_tools_brushes.png .. figure:: /images/grease-pencil_modes_vertex-paint_tools_brushes.png
:align: right :align: right
Draw Brush
Paints a specified color over the object. Tool to use for any of the vertex paint :doc:`brushes <brushes>`.
Blur
Smooths out the colors of adjacent vertices. In this mode the Color
Value is ignored. The strength defines how much the colors are blurred.
Average
Smooths color by painting the average resulting color from all colors under the brush.
Smear
Smudges colors by grabbing the colors under the brush and "dragging" them.
This can be imagined as a finger painting tool.
Replace
Change the color only to the stroke points that already have a color applied.
:ref:`Annotate <tool-annotate-freehand>` :ref:`Annotate <tool-annotate-freehand>`
Draw free-hand annotation. Draw free-hand annotation.

View File

@ -0,0 +1,20 @@
********************
Weight Paint Brushes
********************
Brushes for Grease Pencil *Weight Paint* mode bundled in the *Essentials* library.
Paint Point Weight
Paints a specified weight over the strokes.
Blur Point Weight
Smooths out the weighting of adjacent points. In this mode the Weight
Value is ignored. The strength defines how much the smoothing is applied.
Average Point Weight
Smooths weights by painting the average resulting weight from all weights under the brush.
Smear Point Weight
Smudges weights by grabbing the weights under the brush and "dragging" them.
This can be imagined as a finger painting tool.

View File

@ -7,6 +7,7 @@
:maxdepth: 2 :maxdepth: 2
introduction.rst introduction.rst
brushes.rst
tools.rst tools.rst
tool_settings/index.rst tool_settings/index.rst
weights_menu.rst weights_menu.rst

View File

@ -11,19 +11,8 @@ See :doc:`Brush </grease_pencil/modes/weight_paint/tool_settings/brush>` for mor
.. figure:: /images/grease-pencil_modes_weight-paint_tools_brushes.png .. figure:: /images/grease-pencil_modes_weight-paint_tools_brushes.png
:align: right :align: right
Draw Brush
Paints a specified weight over the strokes. Tool to use for any of the weight paint :doc:`brushes <brushes>`.
Blur
Smooths out the weighting of adjacent points. In this mode the Weight
Value is ignored. The strength defines how much the smoothing is applied.
Average
Smooths weights by painting the average resulting weight from all weights under the brush.
Smear
Smudges weights by grabbing the weights under the brush and "dragging" them.
This can be imagined as a finger painting tool.
:ref:`Annotate <tool-annotate-freehand>` :ref:`Annotate <tool-annotate-freehand>`
Draw free-hand annotation. Draw free-hand annotation.

View File

@ -9,7 +9,7 @@ Brush
Tool to use for any of the *Sculpt* mode brushes. Activating a brush from an asset shelf or brush Tool to use for any of the *Sculpt* mode brushes. Activating a brush from an asset shelf or brush
asset selector will also activate this tool for convenience. selector will also activate this tool for convenience.
See :doc:`brushes </sculpt_paint/sculpting/brushes/index>` (or the See :doc:`brushes </sculpt_paint/sculpting/brushes/index>` (or the
:doc:`overview </sculpt_paint/sculpting/brushes/overview>`) for a detailed list of all brushes and :doc:`overview </sculpt_paint/sculpting/brushes/overview>`) for a detailed list of all brushes and

View File

@ -3,7 +3,7 @@
Brushes Brushes
******* *******
Brushes for *Vertex Paint* bundled in the *Essentials* library. Brushes for *Vertex Paint* mode bundled in the *Essentials* library.
Paint Vertex Paint Vertex
Paints a specified color over the object. Paints a specified color over the object.

View File

@ -3,6 +3,8 @@
Brushes Brushes
******* *******
Brushes for *Weight Paint* mode bundled in the *Essentials* library.
Paint Weight Paint Weight
Paints a specified weight over the object. Paints a specified weight over the object.