[Bf-docboard-svn] bf-manual: [9262] branches/blender-3.2-release/blender_docs/manual: Color Attributes: Add missing documentation related to sculpt mode
Aaron Carlisle
noreply at blender.org
Mon May 9 02:31:31 CEST 2022
Revision: 9262
https://developer.blender.org/rBM9262
Author: Blendify
Date: 2022-05-09 02:31:31 +0200 (Mon, 09 May 2022)
Log Message:
-----------
Color Attributes: Add missing documentation related to sculpt mode
See rBeae36be372a6
Author: @JulienKaspar
Differential Revision: https://developer.blender.org/D14888
Modified Paths:
--------------
branches/blender-3.2-release/blender_docs/manual/modeling/meshes/properties/object_data.rst
branches/blender-3.2-release/blender_docs/manual/modeling/meshes/retopology.rst
branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst
branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst
Added Paths:
-----------
branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/color_filter.rst
branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/mask_by_color.rst
branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/paint.rst
branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/smear.rst
Modified: branches/blender-3.2-release/blender_docs/manual/modeling/meshes/properties/object_data.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/modeling/meshes/properties/object_data.rst 2022-05-09 00:02:40 UTC (rev 9261)
+++ branches/blender-3.2-release/blender_docs/manual/modeling/meshes/properties/object_data.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -35,12 +35,17 @@
.. _bpy.ops.geometry.color_attribute_add:
.. _bpy.ops.geometry.color_attribute_remove:
.. _bpy.ops.geometry.color_attribute_render_set:
+.. _modeling-meshes-properties-object_data-color-attributes:
Color Attributes
================
Color data can be applied directly to an object's vertices rather than using a texture or a material.
-Colors can are painted onto vertices in :doc:`Vertex Paint </sculpt_paint/vertex_paint/index>` mode.
+There are two modes to paint color attributes in.
+Use :doc:`Vertex Paint </sculpt_paint/vertex_paint/index>` mode to paint per face corner
+by enabling the paint mask in the header.
+This is useful to achieve sharp edges in the color attribute on low-poly assets.
+Alternatively use Sculpt mode to paint on a much higher vertex count.
.. _bpy.types.FaceMaps:
Modified: branches/blender-3.2-release/blender_docs/manual/modeling/meshes/retopology.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/modeling/meshes/retopology.rst 2022-05-09 00:02:40 UTC (rev 9261)
+++ branches/blender-3.2-release/blender_docs/manual/modeling/meshes/retopology.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -79,6 +79,8 @@
Reprojects the :ref:`paint mask <sculpt-mask-menu>` onto the new mesh.
Face Sets
Reprojects :ref:`Face Sets <sculpting-editing-facesets>` onto the new mesh.
+ Color Attributes
+ Reprojects the :ref:`Color Attributes <modeling-meshes-properties-object_data-color-attributes>` onto the new mesh.
Voxel Remesh
Performs the remeshing operation to create a new manifold mesh based on the volume of the current mesh.
Modified: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst 2022-05-09 00:02:40 UTC (rev 9261)
+++ branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -55,6 +55,8 @@
Reprojects the :ref:`paint mask <sculpt-mask-menu>` onto the new mesh.
Face Sets
Reprojects :ref:`Face Sets <sculpting-editing-facesets>` onto the new mesh.
+ Color Attributes
+ Reprojects the :ref:`Color Attributes <modeling-meshes-properties-object_data-color-attributes>` onto the new mesh.
Voxel Remesh
Performs the remeshing operation to create a new manifold mesh based on the volume of the current mesh.
Modified: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst 2022-05-09 00:02:40 UTC (rev 9261)
+++ branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -92,6 +92,12 @@
:doc:`/sculpt_paint/sculpting/tools/multires_displacement_smear`
Deforms displacement information applied on a Multiresolution modifier.
+:doc:`/sculpt_paint/sculpting/tools/paint`
+ Paints on the active color attribute.
+
+:doc:`/sculpt_paint/sculpting/tools/smear`
+ Smears the colors of the active color attribute.
+
:doc:`/sculpt_paint/sculpting/tools/box_trim`
Creates a mask based on box select.
@@ -122,9 +128,15 @@
:doc:`/sculpt_paint/sculpting/tools/cloth_filter`
Applies a cloth simulation to all vertices in the mesh at the same time.
+:doc:`/sculpt_paint/sculpting/tools/color_filter`
+ Changes the active color attribute on all vertices in the mesh at the same time.
+
:doc:`/sculpt_paint/sculpting/tools/edit_face_set`
Modifies the face set under the cursor.
+:doc:`/sculpt_paint/sculpting/tools/mask_by_color`
+ Creates a mask from the color attribute. Click on any color on the mesh to create a new mask.
+
Move
Translation tool.
Added: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/color_filter.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/color_filter.rst (rev 0)
+++ branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/color_filter.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -0,0 +1,35 @@
+
+************
+Color Filter
+************
+
+.. reference::
+
+ :Mode: Sculpt Mode
+ :Tool: :menuselection:`Toolbar --> Color Filter`
+
+Changes the color attribute on all vertices in the mesh at the same time.
+To use this tool, click and drag away from the object to have a positive effect
+and click and drag towards the mesh to have a negative effect.
+
+
+Tool Settings
+=============
+
+Filter Type
+ :Fill: Fills in a single color.
+ :Hue: Shifts the Hue of each color.
+ :Saturation: Increases or decreases the saturation.
+ :Value: Increases or decreases the values.
+ :Brightness: Increases or decreases the brightness.
+ :Contrast: Increases or decreases the contrast.
+ :Smooth: Blurs or sharpens the colors.
+ :Red: Increases or decreases the red channel.
+ :Green: Increases or decreases the green channel.
+ :Blue: Increases or decreases the blue channel.
+
+Fill Color
+ Set a color that will be used for the fill filter type.
+
+Strength
+ The amount of effect the filter has on the color attribute.
Property changes on: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/color_filter.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/mask_by_color.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/mask_by_color.rst (rev 0)
+++ branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/mask_by_color.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -0,0 +1,25 @@
+
+*************
+Mask by Color
+*************
+
+.. reference::
+
+ :Mode: Sculpt Mode
+ :Tool: :menuselection:`Toolbar --> Mask by Color`
+
+Creates a mask from the color attribute. Click on any color on the mesh to create a new mask.
+
+
+Tool Settings
+=============
+
+Threshold
+ How much changes in color affect the mask generation. A smaller threshold includes fewer similar colors.
+ A larger threshold includes much more similar colors.
+Contiguous
+ Mask only contiguous color areas. Colors that don't touch the one that you click on will not be masked.
+Invert
+ Invert the generated mask.
+Preserve Previous Mask
+ Preserve previous mask and add or subtract the new one generated by the colors.
Property changes on: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/mask_by_color.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/paint.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/paint.rst (rev 0)
+++ branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/paint.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -0,0 +1,44 @@
+
+*****
+Paint
+*****
+
+.. reference::
+
+ :Mode: Sculpt Mode
+ :Tool: :menuselection:`Toolbar --> Paint`
+
+Paints on the active color attribute.
+
+Brush Settings
+=============
+
+Color
+ Choose a primary and secondary color for painting. 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.
+
+ Swap Colors (cycle icon)
+ Swaps the primary and secondary colors.
+
+ Use Unified Color
+ Use the same brush color across all brushes.
+
+Blend Mode
+ Set the way the paint is applied over the underlying color. See :term:`Color Blend Modes`.
+Flow
+ Amount of paint that is applied per stroke sample. Used to create an accumulation effect.
+Wet Mix
+ Amount of paint that is picked from the surface into the brush color.
+Wet Persistence
+ Amount of wet paint that stays in the brush after applying paint to the surface.
+Wet Paint Radius
+ Ratio between the brush radius and the radius that is going to be used to sample the color to blend in wet paint.
+Density
+ Amount of random elements that are going to be affected by this brush. Use this for a detailed airbrush effect.
+Tip Roundness
+ Roundness of the brush tip. The lower the value the more square the brush tip becomes.
+ A lower roundness also affects the hardness of the brush.
+Tip Scale X
+ Scale of the brush tip in the X axis.
Property changes on: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/paint.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/smear.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/smear.rst (rev 0)
+++ branches/blender-3.2-release/blender_docs/manual/sculpt_paint/sculpting/tools/smear.rst 2022-05-09 00:31:31 UTC (rev 9262)
@@ -0,0 +1,21 @@
+
+*****
+Smear
+*****
+
+.. reference::
+
+ :Mode: Sculpt Mode
+ :Tool: :menuselection:`Toolbar --> Smear`
+
+Paints on the active color attribute.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list