[Bf-docboard-svn] bf-manual: [8461] trunk/blender_docs/manual/modeling/meshes: Cleanup: Mesh Geometry Data
Aaron Carlisle
noreply at blender.org
Thu Oct 7 04:34:28 CEST 2021
Revision: 8461
https://developer.blender.org/rBM8461
Author: Blendify
Date: 2021-10-07 04:34:27 +0200 (Thu, 07 Oct 2021)
Log Message:
-----------
Cleanup: Mesh Geometry Data
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/meshes/editing/edge/edge_data.rst
trunk/blender_docs/manual/modeling/meshes/editing/mesh/transform/basic.rst
trunk/blender_docs/manual/modeling/meshes/properties/custom_data.rst
trunk/blender_docs/manual/modeling/meshes/properties/object_data.rst
Modified: trunk/blender_docs/manual/modeling/meshes/editing/edge/edge_data.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/edge/edge_data.rst 2021-10-06 15:02:19 UTC (rev 8460)
+++ trunk/blender_docs/manual/modeling/meshes/editing/edge/edge_data.rst 2021-10-07 02:34:27 UTC (rev 8461)
@@ -3,10 +3,8 @@
Edge Data
*********
-Edges can have several different attributes that affect how certain other tools affect the mesh.
+Edges can have several different properties that affect how certain other tools affect the mesh.
-
-.. _modeling-edges-crease-subdivision:
.. _bpy.ops.transform.edge_crease:
Edge Crease
@@ -16,20 +14,15 @@
:Mode: Edit Mode
:Menu: :menuselection:`Edge --> Edge Crease`
- :menuselection:`Sidebar region --> Transform --> Edge Crease`
:Shortcut: :kbd:`Shift-E`
-This edge property, a value between (0.0 to 1.0), is used by
-the :doc:`Subdivision Surface Modifier </modeling/modifiers/generate/subdivision_surface>`
-to control the sharpness of the edges in the subdivided mesh.
-This operator enters an interactive mode (a bit like transform tools),
-where by moving the mouse (or typing a value with the keyboard) you can set the (average)
-crease value of selected edges.
+This operator interactively sets the :ref:`Edge Crease` amount
+by moving the mouse (or typing a value with the keyboard).
+Selecting more than one edge will adjust the mean (average) crease value.
A negative value will subtract from the actual crease value, if present.
To clear the crease edge property, enter a value of -1.
-.. _modeling-edges-bevel-weight:
.. _bpy.ops.transform.edge_bevelweight:
Edge Bevel Weight
@@ -39,7 +32,6 @@
:Mode: Edit Mode
:Menu: :menuselection:`Edge --> Edge Bevel Weight`
- :menuselection:`Sidebar region --> Transform --> Edge Bevel Weight`
This edge property, a value between (0.0 to 1.0),
is used by the :doc:`Bevel Modifier </modeling/modifiers/generate/bevel>`
@@ -51,11 +43,9 @@
.. seealso::
- Vertices also have a bevel weight which can be edited.
+ :ref:`Vertex Bevel Weight <modeling-vertex-bevel-weight>`
- .. TODO2.8 there are no docs for this yet.
-
.. _bpy.ops.mesh.mark_seam:
Mark Seam & Clear Seam
@@ -66,9 +56,9 @@
:Mode: Edit Mode
:Menu: :menuselection:`Edge --> Mark Seam/Clear Seam`
+These operators set or unset this mark for selected edges.
Seams are a way to create separations, "islands", in UV maps.
See the :ref:`UV Mapping section <editors-uv-index>` for more details.
-These operators set or unset this mark for selected edges.
.. _bpy.ops.mesh.mark_sharp:
Modified: trunk/blender_docs/manual/modeling/meshes/editing/mesh/transform/basic.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/mesh/transform/basic.rst 2021-10-06 15:02:19 UTC (rev 8460)
+++ trunk/blender_docs/manual/modeling/meshes/editing/mesh/transform/basic.rst 2021-10-07 02:34:27 UTC (rev 8461)
@@ -53,11 +53,12 @@
Vertex Data
-----------
+.. _modeling-vertex-bevel-weight:
+
Bevel Weight
This vertex property, a value between (0.0 to 1.0),
is used by the :doc:`Bevel Modifier </modeling/modifiers/generate/bevel>`
- to control the bevel intensity of the vertices,
- when the Only Vertices option is active.
+ to control the bevel intensity of the vertices, when the *Only Vertices* option is active.
Edge Data
@@ -65,7 +66,19 @@
When an edge is selected, the following options are available. More buttons appear:
+.. _modeling-edges-bevel-weight:
+
Bevel Weight
- See :ref:`Edge bevel weight <modeling-edges-bevel-weight>`.
+ This edge property, a value between (0.0 to 1.0),
+ is used by the :doc:`Bevel Modifier </modeling/modifiers/generate/bevel>`
+ to control the bevel intensity of the edges.
+
+ This property can also be set using the :ref:`bpy.ops.transform.edge_bevelweight` operator.
+
+.. todo move to attribute page
+.. _modeling-edges-crease-subdivision:
+
Crease
- The :ref:`crease <modeling-edges-crease-subdivision>` value of the edge.
+ This edge property, a value between (0.0 to 1.0), is used by
+ the :doc:`Subdivision Surface Modifier </modeling/modifiers/generate/subdivision_surface>`
+ to control the sharpness of the edges in the subdivided mesh.
Modified: trunk/blender_docs/manual/modeling/meshes/properties/custom_data.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/properties/custom_data.rst 2021-10-06 15:02:19 UTC (rev 8460)
+++ trunk/blender_docs/manual/modeling/meshes/properties/custom_data.rst 2021-10-07 02:34:27 UTC (rev 8461)
@@ -1,52 +1,44 @@
-.. _bpy.types.Mesh.*customdata:
-.. _bpy.ops.mesh.customdata:
-.. _modeling_meshes_properties_custom-data:
-***********
-Custom Data
-***********
+*************
+Geometry Data
+*************
-Sculpt Mask
-===========
+.. _bpy.ops.mesh.customdata_mask_clear:
Clear Sculpt-Mask Data
Removes the sculpting mask data layer. See :ref:`sculpt_mask_clear-data` for more information.
+.. _bpy.ops.mesh.customdata_skin_clear:
+.. _bpy.ops.mesh.customdata_skin_add:
-Skin Data
-=========
-
Add/Clear Skin Data
Used to manage the skin data layer which is used by the :doc:`/modeling/modifiers/generate/skin`.
This operator can be needed in case a Skin modifier is created but no skin data exist.
-Custom Split Normals
-====================
+.. _bpy.ops.mesh.customdata_custom_splitnormals_clear:
+.. _bpy.ops.mesh.customdata_custom_splitnormals_add:
-Add Custom Split Normals Data
+Add/Clear Custom Split Normals Data
Adds a :ref:`custom split normals <modeling_meshes_normals_custom>` data layer, if none exists yet.
-Vertex Data
-===========
+.. _bpy.types.Mesh.use_customdata_vertex_bevel:
-Bevel Weight
-------------
+Store
+ Vertex Bevel Weight
+ Save the :ref:`Vertex Bevel Weight <modeling-vertex-bevel-weight>` with the mesh data.
+
+ .. _bpy.types.Mesh.use_customdata_edge_bevel:
-Todo.
+ Edge Bevel Weight
+ Save the :ref:`Edge Bevel Weight <modeling-edges-bevel-weight>` with the mesh data.
+ .. _bpy.types.Mesh.use_customdata_edge_crease:
-Edge Data
-=========
+ Edge Crease
+ Save the :ref:`Edge Bevel Weight <modeling-edges-bevel-weight>` with the mesh data..
-Bevel Weight
-------------
+ .. warning::
-Todo.
-
-
-Edge Crease
------------
-
-Todo.
+ Disabling any of these properties will result in the data loss of these values.
Modified: trunk/blender_docs/manual/modeling/meshes/properties/object_data.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/properties/object_data.rst 2021-10-06 15:02:19 UTC (rev 8460)
+++ trunk/blender_docs/manual/modeling/meshes/properties/object_data.rst 2021-10-07 02:34:27 UTC (rev 8461)
@@ -58,7 +58,7 @@
==========
An attribute is data stored per mesh element. Every attribute has a data type, domain and name.
-This panel only lists generic attributes which excludes all the built-in attributes like ``position`` and
+This panel only lists custom attributes which excludes all the built-in attributes like ``position`` and
other attributes like vertex groups.
See :doc:`Attributes Reference </modeling/geometry_nodes/attributes_reference>` for more information.
More information about the Bf-docboard-svn
mailing list