Differential D16335 Diff 57149 manual/sculpt_paint/texture_paint/tool_settings/brush_settings.rst

Changeset View

Standalone View

manual/sculpt_paint/texture_paint/tool_settings/brush_settings.rst


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

	.. figure:: /images/sculpt-paint_texture-paint_tool-settings_brush-settings_popover.png			.. figure:: /images/sculpt-paint_texture-paint_tool-settings_brush-settings_popover.png
	:align: right			:align: right

	Brush settings.			Brush settings.

	Blend			See more at :doc:`Brush Settings </sculpt_paint/brush/brush_settings>`
	Set the way the paint is applied over the underlying color. 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 table 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.

	Radius
	This option controls the radius of the brush, measured in pixels.
	:kbd:`F` allows you to change the brush size interactively by
	dragging the mouse and then :kbd:`LMB` (the texture of the brush should be visible inside the circle).
	Typing a number then enter while using :kbd:`F` allows you to enter the size numerically.

	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.

	Strength
	How powerful the brush is when applied.

	Size Pressure
	Brush Strength 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 Strength across all brushes.


	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.


	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.


	Advanced
	========

	Accumulate
	This will allow a stroke to accumulate on itself, just like an airbrush would do.
	Affect Alpha
	When this is disabled, it locks (prevents changes to) the alpha channel while painting (3D only).
	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.

	.. toctree::			.. toctree::
	:hidden:			:hidden:

	Texture </sculpt_paint/brush/texture.rst>			Texture </sculpt_paint/brush/texture.rst>
	Texture Mask </sculpt_paint/brush/texture_mask.rst>			Texture Mask </sculpt_paint/brush/texture_mask.rst>
	Stroke </sculpt_paint/brush/stroke.rst>			Stroke </sculpt_paint/brush/stroke.rst>
	Falloff </sculpt_paint/brush/falloff.rst>			Falloff </sculpt_paint/brush/falloff.rst>
	Cursor </sculpt_paint/brush/cursor.rst>			Cursor </sculpt_paint/brush/cursor.rst>


	Texture			Texture
	=======			=======

	See the global brush settings for :doc:`Texture </sculpt_paint/brush/texture>` settings.			See the global brush settings for :doc:`Texture </sculpt_paint/brush/texture>` settings.


	Texture Mask			Texture Mask
	============			============

	See the global brush settings for :ref:`Texture Mask <bpy.types.BrushTextureSlot.mask>` settings.			See the global brush settings for :doc:`Texture </sculpt_paint/brush/texture>` settings.


	Stroke			Stroke
	======			======

	See the global brush settings for :doc:`Stroke </sculpt_paint/brush/stroke>` settings.			See the global brush settings for :doc:`Stroke </sculpt_paint/brush/stroke>` settings.


	Show All 10 Lines