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
7 changed files with 191 additions and 57 deletions
Showing only changes of commit 4a2a8d2bb8 - Show all commits

View File

@ -170,6 +170,25 @@ Deformation Target
Advanced Advanced
======== ========
.. _sculpt-tool-settings-brush-type:
Brush Type
Defines the basic behavior and the available settings. Through the settings of
a brush type, brushes can be created that produce vastly different effects.
The *Essentials* asset library contains brushes for each of the brush types. Their preview image
and description should give a good idea of the effect the brush produces, with the particular
combination of brush type and settings. Because of this, they are usually the more useful starting
point for custom brushes than the mere brush type is, which is why the brush type is part of the
*Advanced* brush settings.
types.
- :doc:`Sculpt </sculpt_paint/sculpting/brushes/brush_types>`
- :doc:`Vertex Paint </sculpt_paint/vertex_paint/brushes>`
- :doc:`Weight Paint </sculpt_paint/weight_paint/brushes>`
- :doc:`Texture Paint </sculpt_paint/texture_paint/brushes>`
Accumulate Accumulate
Causes stroke dabs to accumulate on top of each other. Causes stroke dabs to accumulate on top of each other.

View File

@ -1,10 +1,13 @@
********
Overview
********
There are a number of brushes for sculpt mode bundled in the *Essentials* asset library. ***********
This is an overview of all of them, categorized by their general functions. Brush Types
***********
See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
Available brush types are listed here, together with links to the *Essentials* library brushes
using them.
Add/Subtract Brushes Add/Subtract Brushes
==================== ====================
@ -13,33 +16,49 @@ Add/Subtract Brushes
:align: right :align: right
:width: 250 :width: 250
These brushes generally push vertices outwards and inwards. These brush types generally push vertices outwards and inwards.
Draw
Brushes: :doc:`draw`
:doc:`draw`
The standard brush for pushing vertices inwards and outwards from the surface direction. The standard brush for pushing vertices inwards and outwards from the surface direction.
:doc:`draw_sharp` Draw Sharp
Brushes: :doc:`draw_sharp`
Same as *Draw* but with a much sharper :doc:`Falloff </sculpt_paint/brush/falloff>`. Same as *Draw* but with a much sharper :doc:`Falloff </sculpt_paint/brush/falloff>`.
Useful for creating creases and sharp angles. Useful for creating creases and sharp angles.
:doc:`clay` Clay
Brushes: :doc:`clay`
Similar to the *Draw* brush but with a flattening effect and subtle smoothing. Similar to the *Draw* brush but with a flattening effect and subtle smoothing.
Useful for polishing and building volumes. Useful for polishing and building volumes.
:doc:`clay_strips` Clay Strips
Brushes: :doc:`clay_strips`
The same as the *Clay* brush, but more aggressive with a square falloff. The same as the *Clay* brush, but more aggressive with a square falloff.
A common standard for building rough volumes. A common standard for building rough volumes.
:doc:`layer` Layer
Brushes: :doc:`layer`
Draw with a fixed height. Useful for adding flat layers to a surface. Draw with a fixed height. Useful for adding flat layers to a surface.
:doc:`inflate` Inflate
Brushes: :doc:`inflate`
Moves the mesh in multiple direction. Useful for inflating or shrinking surfaces and volumes. Moves the mesh in multiple direction. Useful for inflating or shrinking surfaces and volumes.
:doc:`blob` Blob
Brushes: :doc:`blob`
Magnifies the mesh as you draw. Useful for an additional inflation effect on the stroke. Magnifies the mesh as you draw. Useful for an additional inflation effect on the stroke.
:doc:`crease` Crease
Brushes: :doc:`crease`
Same as *Blob* but with a pinching effect. Useful for creating and polishing sharp creases. Same as *Blob* but with a pinching effect. Useful for creating and polishing sharp creases.
@ -53,20 +72,30 @@ Contrast Brushes
Recognizable by their red icon and cursor. Recognizable by their red icon and cursor.
These brushes generally flatten or heighten the contrast of the surface. These brushes generally flatten or heighten the contrast of the surface.
:doc:`smooth` Smooth
Brushes: :doc:`smooth`
Smooths out irregularities in the surface and shrinks volumes by averaging the vertices positions. Smooths out irregularities in the surface and shrinks volumes by averaging the vertices positions.
An essential brush that is frequently used. An essential brush that is frequently used.
:doc:`flatten` Flatten
Brushes: :doc:`flatten`
Pushes vertices to an average height to create a flat plateau. Pushes vertices to an average height to create a flat plateau.
:doc:`fill` Fill
Brushes: :doc:`fill`
Pushes surfaces outwards. Useful for filling in holes and crevices. Pushes surfaces outwards. Useful for filling in holes and crevices.
:doc:`scrape` Scrape
Brushes: :doc:`scrape`
Pushes surfaces inwards. This is the most common brush for flattening meshes. Pushes surfaces inwards. This is the most common brush for flattening meshes.
:doc:`multiplane_scrape` Multi-plane Scrape
Brushes: :doc:`multiplane_scrape`
Scrapes the mesh with two angled planes at the same time, producing a sharp edge between them. Scrapes the mesh with two angled planes at the same time, producing a sharp edge between them.
@ -80,37 +109,57 @@ Transform Brushes
Recognizable by their yellow icon and cursor. Recognizable by their yellow icon and cursor.
These brushes generally move, pinch and magnify the mesh. These brushes generally move, pinch and magnify the mesh.
:doc:`pinch` Pinch
Brushes: :doc:`pinch`
Pulls vertices towards the center of the brush. Useful for polishing angles and creases. Pulls vertices towards the center of the brush. Useful for polishing angles and creases.
:doc:`grab` Grab
Brushes: :doc:`grab`
Moves vertices along with the mouse. An essential brush for building shapes and adjusting proportions. Moves vertices along with the mouse. An essential brush for building shapes and adjusting proportions.
:doc:`elastic_deform` Elastic Deform
Brushes: :doc:`elastic_deform`
Used to simulate realistic deformations such as grabbing or twisting of :term:`Elastic` objects. Used to simulate realistic deformations such as grabbing or twisting of :term:`Elastic` objects.
:doc:`snake_hook` Snake Hook
Brushes: :doc:`snake_hook`
Pulls vertices along with the stroke to create long, snake-like forms. Pulls vertices along with the stroke to create long, snake-like forms.
:doc:`thumb` Thumb
Brushes: :doc:`thumb`
Same as *Grab* but moves vertices along the surface direction. Useful for preserving specific surfaces. Same as *Grab* but moves vertices along the surface direction. Useful for preserving specific surfaces.
:doc:`pose` Pose
Brushes: :doc:`pose`
Simulating an armature-like deformations. Useful for quick posing and transformations. Simulating an armature-like deformations. Useful for quick posing and transformations.
:doc:`nudge` Nudge
Brushes: :doc:`nudge`
Similar as *Thumb* but dynamically picks up vertices like the *Snake Hook*. Similar as *Thumb* but dynamically picks up vertices like the *Snake Hook*.
Useful for nudging something along the mesh surface. Useful for nudging something along the mesh surface.
:doc:`twist` Rotate
Brushes: :doc:`twist`
Rotates vertices within the brush in the direction mouse. Rotates vertices within the brush in the direction mouse.
:doc:`slide_relax` Slide Relax
Brushes: :doc:`slide_relax`
Slides the topology of the mesh in the direction of the stroke Slides the topology of the mesh in the direction of the stroke
while preserving the geometrical shape of the mesh. while preserving the geometrical shape of the mesh.
Also useful for redistributing topology where it is needed. Also useful for redistributing topology where it is needed.
:doc:`boundary` Boundary
Brushes: :doc:`boundary`
Transform mesh boundaries specifically with various deformations. Transform mesh boundaries specifically with various deformations.
@ -124,22 +173,34 @@ Utility Brushes
No clear color assignment. No clear color assignment.
These brushes are general purpose brushes or specific. These brushes are general purpose brushes or specific.
:doc:`cloth` Cloth
Brushes: :doc:`cloth`
Simulates cloth to create folds and draping, which can be sculpted further. Simulates cloth to create folds and draping, which can be sculpted further.
:doc:`density` Simplify
Brushes: :doc:`density`
Cleans up geometry by collapsing short edges. Cleans up geometry by collapsing short edges.
:doc:`mask` Mask
Brushes: :doc:`mask`
Paints a selection on parts of the mesh to be unaffected by other brushes. Paints a selection on parts of the mesh to be unaffected by other brushes.
:doc:`draw_facesets` Draw Face Sets
Brushes: :doc:`draw_facesets`
Paint new or extend existing face sets. Paint new or extend existing face sets.
:doc:`multires_displacement_eraser` Multires Displacement Eraser
Brushes: :doc:`multires_displacement_eraser`
Remove displacement information on a Multiresolution modifier. Remove displacement information on a Multiresolution modifier.
:doc:`multires_displacement_smear` Multires Displacement Smear
Brushes: :doc:`multires_displacement_smear`
Smear displacement information on a Multiresolution modifier. Smear displacement information on a Multiresolution modifier.
@ -153,9 +214,13 @@ Painting Brushes
Recognizable by their green icon. Recognizable by their green icon.
These brushes are used for painting color attributes within sculpt mode. These brushes are used for painting color attributes within sculpt mode.
:doc:`paint` Paint
Brushes: :doc:`paint`
Paint on the vertices of your mesh via color attributes. Paint on the vertices of your mesh via color attributes.
:doc:`smear` Smear
Brushes: :doc:`smear`
Smears the vertex colors via color attributes. Smears the vertex colors via color attributes.

View File

@ -8,7 +8,7 @@ Brushes for *Sculpt Mode* bundled in the *Essentials* library.
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
overview.rst brush_types.rst
draw.rst draw.rst
draw_sharp.rst draw_sharp.rst
clay.rst clay.rst

View File

@ -11,6 +11,6 @@ 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
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 available
:doc:`overview </sculpt_paint/sculpting/brushes/overview>`) for a detailed list of all brushes and :doc:`Brush Types </sculpt_paint/sculpting/brushes/brush_types>`) for a detailed list of all
their options. brushes and their options.

View File

@ -3,12 +3,24 @@
Brushes Brushes
******* *******
Brushes for *Texture Paint* bundled in the *Essentials* library. Brush Types
===========
See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
Available brush types are listed here, together with brushes from the
*Essentials* asset library using them.
Draw
Brushes: Paint Texture
Paint Texture
The normal brush, draws a swath of color. The normal brush, draws a swath of color.
Blur Texture
Soften
Brushes: Blur Texture
Uses a "blur effect" to soften or sharpen the image. Uses a "blur effect" to soften or sharpen the image.
Direction Direction
@ -31,11 +43,15 @@ Blur Texture
:Gaussian: Gaussian will sample the pixels near the center of the brush most. :Gaussian: Gaussian will sample the pixels near the center of the brush most.
:Box: Box samples all surrounding pixels equally. :Box: Box samples all surrounding pixels equally.
Smear Texture Smear
Brushes: Smear Texture
When you click, takes the colors under the cursor, and blends them in the direction you move the mouse. When you click, takes the colors under the cursor, and blends them in the direction you move the mouse.
Similar to the "smudge" tool of *Gimp*. Similar to the "smudge" tool of *Gimp*.
Clone Texture Clone
Brushes: Clone Texture
Copies the colors from the specified image (or location of the same image) to the active image. Copies the colors from the specified image (or location of the same image) to the active image.
In 3D projective painting the clone cursor can be set with :kbd:`Ctrl-LMB`. In 3D projective painting the clone cursor can be set with :kbd:`Ctrl-LMB`.
@ -52,7 +68,9 @@ Clone Texture
Alpha (2D only) Alpha (2D only)
Opacity of the clone image display. Opacity of the clone image display.
Fill Texture Fill
Brushes: Fill Texture
It can be used to fill large areas of the image with the brush color. It can be used to fill large areas of the image with the brush color.
The tool fills adjacent pixels that have a color value similar to the pixel you clicked on. The tool fills adjacent pixels that have a color value similar to the pixel you clicked on.
@ -76,7 +94,9 @@ Fill Texture
regardless of whether the options are activated regardless of whether the options are activated
in the :doc:`External </sculpt_paint/texture_paint/tool_settings/options>` panel. in the :doc:`External </sculpt_paint/texture_paint/tool_settings/options>` panel.
Mask Texture Mask
Brushes: Mask Texture
This brush paints gray-scale values on the mask texture This brush paints gray-scale values on the mask texture
specified in the :doc:`Mask panel </sculpt_paint/texture_paint/tool_settings/mask>`. specified in the :doc:`Mask panel </sculpt_paint/texture_paint/tool_settings/mask>`.
Any masked surfaces will not be affected by other paint brushes, similar to Any masked surfaces will not be affected by other paint brushes, similar to

View File

@ -3,18 +3,33 @@
Brushes Brushes
******* *******
Brushes for *Vertex Paint* mode bundled in the *Essentials* library.
Brush Types
===========
See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
Available brush types are listed here, together with brushes from the
*Essentials* asset library using them.
Paint Vertex Paint Vertex
Brushes: Paint Vertex
Paints a specified color over the object. Paints a specified color over the object.
Blur Vertex Blur
Brushes: Blur Vertex
Smooths out the colors of adjacent vertices. In this mode the 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. Value is ignored. The strength defines how much the colors are blurred.
Average Vertex Average
Brushes: Average Vertex
Smooths color by painting the average resulting color from all colors under the brush. Smooths color by painting the average resulting color from all colors under the brush.
Smear Vertex Smear
Brushes: Smear Vertex
Smudges colors by grabbing the colors under the brush and "dragging" them. Smudges colors by grabbing the colors under the brush and "dragging" them.
This can be imagined as a finger painting tool. This can be imagined as a finger painting tool.

View File

@ -3,9 +3,18 @@
Brushes Brushes
******* *******
Brushes for *Weight Paint* mode bundled in the *Essentials* library. Brush Types
===========
See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
Available brush types are listed here, together with brushes from the
*Essentials* asset library using them.
Draw
Brushes: Paint Weight
Paint Weight
Paints a specified weight over the object. Paints a specified weight over the object.
Blend Blend
@ -42,13 +51,19 @@ Paint Weight
Smooths out the weighting of adjacent vertices. In this mode the Weight Smooths out the weighting of adjacent vertices. In this mode the Weight
Value is ignored. The strength defines how much the smoothing is applied. Value is ignored. The strength defines how much the smoothing is applied.
Blur Weight Blur
Brushes: Blur Weight
Smooths out the weighting of adjacent vertices. In this mode the Weight Smooths out the weighting of adjacent vertices. In this mode the Weight
Value is ignored. The strength defines how much the smoothing is applied. Value is ignored. The strength defines how much the smoothing is applied.
Average Weight Average
Brushes: Average Weight
Smooths weights by painting the average resulting weight from all weights under the brush. Smooths weights by painting the average resulting weight from all weights under the brush.
Smear Weight Smear
Brushes: Smear Weight
Smudges weights by grabbing the weights under the brush and "dragging" them. Smudges weights by grabbing the weights under the brush and "dragging" them.
This can be imagined as a finger painting tool. This can be imagined as a finger painting tool.