From bbcd2812e4ab0fc3ca1210792afe0065c209020f Mon Sep 17 00:00:00 2001 From: Nathan Vegdahl Date: Thu, 28 Sep 2023 14:45:10 +0200 Subject: [PATCH 1/2] Animation: Add documentation for new B-Bone option "Vertex Mapping" --- .../armatures/bones/properties/bendy_bones.rst | 15 +++++++++++++++ ...tures_bones_properties_bendy-bones_options.png | 4 ++-- ...ones_properties_bendy-bones_vertex-mapping.png | 3 +++ 3 files changed, 20 insertions(+), 2 deletions(-) create mode 100644 manual/images/animation_armatures_bones_properties_bendy-bones_vertex-mapping.png diff --git a/manual/animation/armatures/bones/properties/bendy_bones.rst b/manual/animation/armatures/bones/properties/bendy_bones.rst index f567e6558..c15ba202f 100644 --- a/manual/animation/armatures/bones/properties/bendy_bones.rst +++ b/manual/animation/armatures/bones/properties/bendy_bones.rst @@ -116,6 +116,21 @@ Segments Display Size X, Z Controls the visible thickness of the bone segments when the armature is rendered in the *B-Bones* mode. +.. _bpy.types.EditBone.bbone_mapping_mode: + +Vertex Mapping + Controls how vertices are weighted to B-Bone segments when computing deformations: + + :Straight: + A fast mapping that works well for B-Bones with a straight or gently curved rest pose. + :Curved: + A slower mapping that improves deformations for B-Bones with a strongly curved rest pose. + + .. figure:: /images/animation_armatures_bones_properties_bendy-bones_vertex-mapping.png + :width: 300px + + Straight vs Curved vertex mapping on a B-Bone with a strongly curved end. + .. _bpy.types.EditBone.bbone_curveinx: .. _bpy.types.EditBone.bbone_curveinz: diff --git a/manual/images/animation_armatures_bones_properties_bendy-bones_options.png b/manual/images/animation_armatures_bones_properties_bendy-bones_options.png index ba4a9ea1f..cb00c61d3 100644 --- a/manual/images/animation_armatures_bones_properties_bendy-bones_options.png +++ b/manual/images/animation_armatures_bones_properties_bendy-bones_options.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:99d21f955dd5f14dd261a073ec804b1cf8900d92d3976a0c5f1e896fd64acd4f -size 9638 +oid sha256:b12ca668de2037b6519a9026d54db067a97342d0ea6ddd763f81399444c66d02 +size 7989 diff --git a/manual/images/animation_armatures_bones_properties_bendy-bones_vertex-mapping.png b/manual/images/animation_armatures_bones_properties_bendy-bones_vertex-mapping.png new file mode 100644 index 000000000..b7e3e670b --- /dev/null +++ b/manual/images/animation_armatures_bones_properties_bendy-bones_vertex-mapping.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c34b0a39ced93b6fcf7108453758013c1cf6b5538bc4894f28cabeb89072d938 +size 26887 -- 2.30.2 From e4cca885bd210c7f60a8b2246ec069a268ebdd22 Mon Sep 17 00:00:00 2001 From: Nathan Vegdahl Date: Thu, 28 Sep 2023 16:10:45 +0200 Subject: [PATCH 2/2] Slightly clearer descriptions --- .../animation/armatures/bones/properties/bendy_bones.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/manual/animation/armatures/bones/properties/bendy_bones.rst b/manual/animation/armatures/bones/properties/bendy_bones.rst index c15ba202f..d14b1d187 100644 --- a/manual/animation/armatures/bones/properties/bendy_bones.rst +++ b/manual/animation/armatures/bones/properties/bendy_bones.rst @@ -119,17 +119,18 @@ Display Size X, Z .. _bpy.types.EditBone.bbone_mapping_mode: Vertex Mapping - Controls how vertices are weighted to B-Bone segments when computing deformations: + Controls how vertices are weighted to the individual segments of a B-Bone for deformations: :Straight: A fast mapping that works well for B-Bones with a straight or gently curved rest pose. :Curved: - A slower mapping that improves deformations for B-Bones with a strongly curved rest pose. + A slower mapping that improves deformations for B-Bones with a strongly curved rest pose. This should + be used selectively when needed. .. figure:: /images/animation_armatures_bones_properties_bendy-bones_vertex-mapping.png :width: 300px - Straight vs Curved vertex mapping on a B-Bone with a strongly curved end. + Straight vs Curved vertex mapping on a B-Bone with a strongly curved rest pose. .. _bpy.types.EditBone.bbone_curveinx: .. _bpy.types.EditBone.bbone_curveinz: -- 2.30.2