[Bf-docboard-svn] bf-manual: [9410] trunk/blender_docs/manual: Sculpt Curve: Add RNA references
Aaron Carlisle
noreply at blender.org
Wed Jul 13 22:51:45 CEST 2022
Revision: 9410
https://developer.blender.org/rBM9410
Author: Blendify
Date: 2022-07-13 22:51:45 +0200 (Wed, 13 Jul 2022)
Log Message:
-----------
Sculpt Curve: Add RNA references
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/curves/primitives.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/index.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/grow_shrink_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst
Modified: trunk/blender_docs/manual/modeling/curves/primitives.rst
===================================================================
--- trunk/blender_docs/manual/modeling/curves/primitives.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/modeling/curves/primitives.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -65,6 +65,8 @@
The curves can be edited via :doc:`sculpting </sculpt_paint/curves_sculpting/introduction>`.
.. note::
+
Hair curves currently have the following limitations:
- * No Edit Mode.
- * Not supported in Wireframe viewport shading.
+
+ * No Edit Mode.
+ * Not supported in Wireframe viewport shading.
Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/index.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/index.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/index.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -1,3 +1,5 @@
+.. _bpy.types.BrushCurvesSculptSettings:
+.. _bpy.ops.sculpt_curves:
####################
Curves Sculpting
Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -6,7 +6,8 @@
*Curves Sculpt Mode* allows working with curves using various brushes.
It is commonly used for hair grooming, but can be used with all kinds of curves.
-Some tools, such as the :doc:`Add Curves</sculpt_paint/curves_sculpting/tools/add_curves>`, require the Surface to be set already.
+Some tools, such as the :doc:`Add Curves </sculpt_paint/curves_sculpting/tools/add_curves>`,
+require the Surface to be set already.
.. note::
@@ -13,6 +14,8 @@
Curves Sculpt tools only use the original mesh of the surface object and don't take its modifiers into account.
+.. _bpy.types.Curves.surface:
+
Surface
=======
@@ -19,19 +22,27 @@
The curve surface is an optional mesh that is used to anchor the curves, and behave as a scalp for hair grooming.
When adding a new Curves object via the `Add Menu` the active object is automatically set as the surface.
-To set a new surface press :kbd:`Ctrl-P` and select *Object (Attach Curves to Surface)* in the *Set Parent To* pop-up menu.
-This option can be seen as part of the Curves settings in the Properties Editor.
+To set a new surface press :kbd:`Ctrl-P` and select *Object (Attach Curves to Surface)*
+in the *Set Parent To* pop-up menu. This option can be seen as part of the Curves settings in the Properties Editor.
.. figure:: /images/sculpt-paint_sculpting_curves-surface.png
-.. note::
+.. _bpy.types.Curves.surface_uv_map:
- If the UV from the surface changed, run :ref:`Snap to Nearest Surfaces<Snap to Nearest Surfaces>` to re-attach the curves.
+Surface UV Map
+ The name of the attribute on the surface mesh used to define the attachment of each curve.
+ .. note::
+ If the UV from the surface changed,
+ run :ref:`Snap to Nearest Surfaces <Snap to Nearest Surfaces>` to re-attach the curves.
+
+
Curves Menu
===========
+.. _bpy.ops.curves.snap_curves_to_surface:
+
Snap to Deformed Surfaces
Re-attach curves to a deformed surface using the existing attachment information.
This only works when the topology of the surface mesh has not changed.
@@ -42,14 +53,19 @@
Find the closest point on the surface for the root point of every curve and move the root there.
This needs to be run after the surface mesh topology changed
+.. _bpy.ops.curves.convert_to_particle_system:
+
Convert to Particle System
Add a new or update an existing hair particle system on the surface object.
- An operator used for backwards compatibility with the old :doc:`hair type particle system </physics/particles/hair/introduction>`.
+ An operator used for backwards compatibility with the old
+ :doc:`hair type particle system </physics/particles/hair/introduction>`.
Select Menu
===========
+.. _bpy.ops.sculpt_curves.select_all:
+
All
Select all control points.
@@ -59,12 +75,18 @@
Invert
Invert the selection.
+.. _bpy.ops.sculpt_curves.select_random:
+
Random
Randomizes existing selection or create new random selection.
+.. _bpy.ops.sculpt_curves.select_end:
+
Endpoints
Select end point of curves.
Only supported in the Control Point selection mode.
+.. _bpy.ops.sculpt_curves.select_grow:
+
Grow
Select curves which are close to curves that are selected already.
Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -13,25 +13,37 @@
Brush Settings
==============
+.. _bpy.types.BrushCurvesSculptSettings.add_amount:
+
Count
Number of curves added.
-Curve Length
- Length of newly added curves when not interpolated.
-
-Points Per Curve
- Number of Control Points for the new created curves when the shape is not interpolated.
-
.. note::
Interpolation allows to add hair which is already combed. The new hair is then created
following the previously created hair which are in the vicinity.
+.. _bpy.types.BrushCurvesSculptSettings.interpolate_length:
+
Interpolate Length
Use length of the curves in close proximity.
+.. _bpy.types.BrushCurvesSculptSettings.interpolate_shape:
+
Interpolate Shape
Use shape and the amount of control points of the curves in close proximity.
+.. _bpy.types.BrushCurvesSculptSettings.interpolate_point_count:
+
Interpolate Point Count
Use the amount of control points of the curves in close proximity.
+
+.. _bpy.types.BrushCurvesSculptSettings.curve_length:
+
+Curve Length
+ Length of newly added curves when not interpolated.
+
+.. _bpy.types.BrushCurvesSculptSettings.points_per_curve:
+
+Points per Curve
+ Number of Control Points for the new created curves when the shape is not interpolated.
Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -11,6 +11,8 @@
Brush Settings
==============
+.. _bpy.types.BrushCurvesSculptSettings.density_mode:
+
Density Mode
Determines whether the brush adds or removes curves.
@@ -21,6 +23,8 @@
:Remove:
Remove curves whose root points are too close.
+.. _bpy.types.BrushCurvesSculptSettings.minimum_distance:
+
Distance Min
Goal distance between the curve roots.
@@ -33,5 +37,7 @@
The density can be adjusted by moving the mouse cursor closer or farther from the paint cursor.
The *Distance Min* will be changed once the operator is confirmed.
+.. _bpy.types.BrushCurvesSculptSettings.density_add_attempts:
+
Count Max
The maximum amount of points that it tries to sample in the surface.
Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/grow_shrink_curves.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/grow_shrink_curves.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/grow_shrink_curves.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -13,8 +13,12 @@
Direction
Determines whether to grow or shrink the curves. It can be toggled holding :kbd:`Ctrl` while sculpting.
+.. _bpy.types.BrushCurvesSculptSettings.scale_uniform:
+
Scale Uniform
Grow or shrink curves by changing their size uniformly instead of using trimming or extrapolation.
+.. _bpy.types.BrushCurvesSculptSettings.minimum_length:
+
Minimum Length
Avoid shrinking curves shorter than this length.
Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst 2022-07-13 20:34:38 UTC (rev 9409)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst 2022-07-13 20:51:45 UTC (rev 9410)
@@ -8,4 +8,4 @@
.. note::
-The curves are not rotated to follow the surface normals.
+ The curves are not rotated to follow the surface normals.
More information about the Bf-docboard-svn
mailing list