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

Changeset View

Standalone View

manual/sculpt_paint/brush/brush_settings.rst

This file was added.

Property	Old Value	New Value
svn:eol-style	null	native \ No newline at end of property

				**************
				Brush Settings
				**************

				Each mode and brush has unique brush settings.
				But there is also a lot of overlap or similar settings.
				This page explains general and mode specific settings that are used across various brushes in more detail.

				General
				========

				Radius
				This option controls the size of the brush, measured in pixels.
				:kbd:`F` allows you to change the brush size interactively by
				dragging the mouse from left to right and then :kbd:`LMB` to accept.
				Meanwhile the texture of the brush will be visible inside the circle.
				You can also enter the size numerically with the number keys.

				Size Pressure
				Brush size can be affected by enabling the pressure sensitivity icon,
				if you are using a :ref:`Graphics Tablet <hardware-tablet>`.
				Use Unified Radius
				Use the same brush Radius across all brushes.

				Radius Unit :guilabel:`Sculpt Mode`
				Controls how the brush Radius is measured.

				View
				The Radius is measured based on how the cursor appears on the monitor i.e. "screen space".
				Scene
				The Radius is measured based on real world units.
				This means that the brush radius stays consistent, independently from zooming in and out in the viewport.
				The unit type and scaling can be configured in the :ref:`Scene Units <bpy.types.UnitSettings>`.

				_`Strength`
				For painting brushes the Strength defines the maximum effect of each brush stroke.
				For example, higher values cause a Paint brush to give each stroke a higher opacity.
				The opacity is never stronger than the set Strength,
				no matter how often the same surface is painted during the same stroke.

				For sculpting brushes on the other hand the Strength relates to how strong each step of the stroke is,
				resulting in a slower/faster buildup towards the full brush effect during the stroke.

				.. Paint vs sculpting brush strength needs a visual example here.

				You can change the brush strength interactively by pressing :kbd:`Shift-F`
				and then moving the brush and then :kbd:`LMB`.
				You can also enter the strength numerically with the number keys.

				Strength Pressure
				Brush strength can be affected by enabling the pressure sensitivity icon,
				if a supported tablet is being used.
				Use Unified Strength
				Use the same brush Strength across all brushes.

				Blend
				Set the way the color or value is applied over the targeted Color Attribute, Vertex Group or Image Texture.
				See :term:`Color Blend Modes`.

				- Add Alpha: makes the image more opaque where painted.
				- Erase Alpha: makes the image transparent where painted,
				allowing background colors and lower-level textures to show through.
				As you "paint", the false checkerboard background will be revealed.
				Using a tablet pen's eraser end will toggle on this mode.

				.. tip::

				In order to see the effects of the Erase and Add Alpha mix modes in the Image Editor,
				you must enable the alpha channel display by clicking the Display Alpha or the Alpha-Only button.
				Transparent (no alpha) areas will then show a checkered background.

				Weight :guilabel:`Weight Paint`
				The weight value that is applied to the vertex group.

				Use :kbd:`Ctrl-LMB` to sample the weight value of clicked vertex.
				:kbd:`Shift-LMB` lets you select the group from which to sample from.

				Direction :kbd:`Ctrl` :guilabel:`Sculpt Mode`
				Brush direction toggle, Add raises geometry towards the brush,
				Subtract lowers geometry away from the brush. This setting can be toggled with :kbd:`Ctrl` while sculpting.

				.. _bpy.types.Brush.normal_radius_factor:

				Normal Radius :guilabel:`Sculpt Mode`
				Determines the ratio of how much the brush radius is used to sample the normal direction of the sculpt plane of the brush.
				For example, a smaller Normal Radius will lead to
				The ratio between the brush radius and the radius that is going to be used to sample
				the normal i.e. take the average of multiple normals. This influences the brush orientation;
				increasing this value causes the brush to follow a smooth version of the mesh,
				while a small value causes the brush to closely follow the contours of the mesh.

				.. _bpy.types.Brush.hardness:

				Hardness :guilabel:`Sculpt Mode`
				How close the brush falloff starts from the edge of the brush.

				.. _bpy.types.Brush.auto_smooth_factor:

				Autosmooth :guilabel:`Sculpt Mode`
				Sets the amount of smoothing to be applied to each stroke.

				.. _bpy.types.Brush.topology_rake_factor:

				Topology Rake :guilabel:`Sculpt Mode`
				The higher this setting is set, the more :doc:`Dyntopo </sculpt_paint/sculpting/tool_settings/dyntopo>`
				aligns mesh edges to the brush direction while tessellating the surface.
				This generates cleaner edge flow to help define sharp features.
				Topology Rake can have a severe performance impact so it works best on low-poly meshes.

				.. figure:: /images/sculpt-paint_sculpting_tool-settings_dyntopo_topology-rake.jpg

				Normal Weight :kbd:`Ctrl` :guilabel:`Sculpt Mode`
				Constrains brush movement along the surface normal.
				Especially useful with the Grab brush, can be temporarily enabled by holding :kbd:`Ctrl`.
				E.g. Grab brush can be used to push a depression (hole) into the mesh when Normal Weight is set.

				Applies to Grab and Snake Hook brushes.

				Plane Offset :guilabel:`Sculpt Mode`
				Offset for planar brushes (Clay, Fill, Flatten, Scrape),
				shifts the plane that is found by averaging the faces above or below.

				Plane Trim :guilabel:`Sculpt Mode`
				Ability to limit the distance that planar brushes act.
				If trim is enabled vertices that are further away from the offset plane than
				the trim distance are ignored during sculpting.


				.. _sculpt-tool-settings-brush-settings-advanced:

				Advanced
				========

				Accumulate
				Causes stroke dabs to accumulate on top of each other.

				Front Faces Only
				When enabled, the brush only affects vertices that are facing the viewer.

				Affect Alpha :guilabel:`2D Painting Only`
				When this is disabled, it prevents changes to the alpha channel while painting (Only in 3D Viewport).

				Anti-Aliasing :guilabel:`2D Painting Only`
				Toggles :term:`Anti-Aliasing` around the brush,
				this is useful if you are working with pixel art or low resolution textures.

				.. _bpy.types.Brush.use_automasking_topology:

				Auto-Masking :guilabel:`Sculpt Mode`
				The auto-masking toggles in the brush settings are the same as the sculpt mode auto-masking settings.
				The difference is that these toggles can be customized per brush to create specific brush behaviors.

				.. seealso:: Auto-Masking
				For more information on the Auto-Masking toggles, see :doc:`Auto-Masking </sculpt_paint/sculpting/controls>`.

				.. _bpy.types.Brush.sculpt_plane:

				Sculpt Plane :guilabel:`Sculpt Mode`
				Use this menu to set the plane in which the sculpting takes place.
				In other words, the primary direction that the vertices will move.

				:Area Plane:
				The movement takes place in the direction of average normal for all active vertices within the brush area.
				Essentially, this means that the direction is dependent on the surface beneath the brush.
				:View Plane:
				Sculpting in the plane of the current 3D Viewport.
				:X, Y, Z Plane:
				The movement takes place in the positive direction of one of the global axes.

				.. _bpy.types.Brush.use_original_normal:
				.. _bpy.types.Brush.use_original_plane:

				Original :guilabel:`Sculpt Mode`
				Normal
				When locked it keeps using the normal of the surface where stroke was initiated,
				instead of the surface normal currently under the cursor.
				Plane
				When locked keep using the plane origin of surface where stroke was initiated,
				instead of the surface plane currently under the cursor.

				Color Picker
				============

				Color
				-----

				The color of the brush. See :ref:`ui-color-picker`.

				Press :kbd:`S` on any part of the image to sample that color and set it as the brush color.
				Hold :kbd:`Ctrl` while painting to temporally paint with the secondary color.

				.. _bpy.ops.paint.brush_colors_flip:

				Swap Colors (cycle icon) :kbd:`X`
				Swaps the primary and secondary colors.

				Use Unified Color
				Use the same brush color across all brushes.

				.. note::

				Note that Vertex Paint works in sRGB :term:`space <Color Space>`, and
				the RGB representation of the same colors will be different between the paint
				tools and the materials that are in linear space.


				Gradient
				--------

				A gradient can be used as a color source.

				Gradient Colors
				The :ref:`ui-color-ramp-widget` to define the gradient colors.
				Mode
				Pressure
				Will choose a color from the color ramp according to the stylus pressure.
				Clamp
				Will alter the color along the stroke and as specified by Gradient Spacing option.
				With Clamp it uses the last color of the color ramp after the specified gradient.
				Repeat
				Similar to Clamp. After the last color it resets the color to the first color in the color ramp and
				repeats the pattern.


				Color Palette
				=============

				Color Palettes are a way of storing a brush's color so that it can be used at a later time.
				This is useful when working with several colors at once.

				Palette
				A :ref:`ui-data-block` to select a palette.

				New ``+``
				Adds the current brush's primary Color to the palette.
				Delete ``-``
				Removes the currently selected color from the palette.

				Move (up/down arrow icon)
				Moves the selected color up/down one position.

				Sort
				Sort Colors by Hue, Saturation, Value, Luminance.

				Color List
				Each color that belongs to the palette is presented in a list.
				Clicking on a color will change the brush's primary Color to that color.
				No newline at end of file