[Bf-docboard-svn] bf-manual: [6960] trunk/blender_docs/manual: Bevel Vertices (ToDo)
Aaron Carlisle
carlisle.b3d at gmail.com
Wed Aug 12 16:45:40 CEST 2020
Revision: 6960
https://developer.blender.org/rBM6960
Author: Blendify
Date: 2020-08-12 16:45:39 +0200 (Wed, 12 Aug 2020)
Log Message:
-----------
Bevel Vertices (ToDo)
Author: @Greenmansa
Differential Revision: https://developer.blender.org/D8321
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/meshes/editing/vertex/bevel_vertices.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_compare.png
trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customA.png
trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customB.png
trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_segments.png
Added: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_compare.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_compare.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_compare.png 2020-08-12 13:58:21 UTC (rev 6959)
+++ trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_compare.png 2020-08-12 14:45:39 UTC (rev 6960)
Property changes on: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_compare.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customA.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customA.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customA.png 2020-08-12 13:58:21 UTC (rev 6959)
+++ trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customA.png 2020-08-12 14:45:39 UTC (rev 6960)
Property changes on: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customA.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customB.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customB.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customB.png 2020-08-12 13:58:21 UTC (rev 6959)
+++ trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customB.png 2020-08-12 14:45:39 UTC (rev 6960)
Property changes on: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_customB.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_segments.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_segments.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_segments.png 2020-08-12 13:58:21 UTC (rev 6959)
+++ trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_segments.png 2020-08-12 14:45:39 UTC (rev 6960)
Property changes on: trunk/blender_docs/manual/images/modeling_meshes_editing_vertex_bevel-vertices_segments.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/meshes/editing/vertex/bevel_vertices.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/vertex/bevel_vertices.rst 2020-08-12 13:58:21 UTC (rev 6959)
+++ trunk/blender_docs/manual/modeling/meshes/editing/vertex/bevel_vertices.rst 2020-08-12 14:45:39 UTC (rev 6960)
@@ -1,6 +1,179 @@
+.. _bpy.ops.mesh.bevel.vertex:
**************
Bevel Vertices
**************
-Todo.
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Vertex --> Bevel Vertices`
+ :Hotkey: :kbd:`Shift-Ctrl-B`
+ :Menu: :menuselection:`Vertex --> Bevel Edges` (edge bevel)
+ :Hotkey: :kbd:`Ctrl-B` (edge bevel)
+
+The *Bevel Vertices* tool works only on selected vertices. In "vertex only" mode,
+the *Bevel Vertices* tool works on selected vertices but the option to switch to *Bevel Edges* is available.
+The *Bevel* tool itself rounds off edges or corners of a mesh at the point of the selected vertices.
+By doing so, more vertices are added in order to smooth out profiles with a specified number of *segments*
+(see the options below for details about the bevel algorithm).
+
+.. figure:: /images/modeling_meshes_editing_vertex_bevel-vertices_compare.png
+ :align: center
+
+ Cubes with and without bevel.
+
+
+.. note::
+
+ With the Vertex Only function active, some of the other options available will not work.
+ However, they will work with :doc:`Bevel Edges </modeling/meshes/editing/edge/bevel>`.
+
+
+Options
+=======
+
+Affect :kbd:`V`
+ Vertices
+ Only the areas near vertices are beveled, the edges remain unchanged.
+ Edges
+ Bevel the edges, creating intersections at vertices.
+
+Offset :kbd:`A`
+ You can change the bevel amount by moving the mouse towards and away from the object,
+ a bit like with transform tools.
+ The exact meaning of the value depends on the *Amount Type* option (see below).
+ As usual, the scaling can be controlled to a finer degree by holding :kbd:`Shift` to scale in 0.001 steps.
+ :kbd:`LMB` finalizes the operation, :kbd:`RMB` or :kbd:`Esc` aborts the action.
+
+Amount Type :kbd:`M`
+ Selects how the *Amount* value controls the size of the bevel. According to the selection, the amount is:
+
+ Offset
+ The relative distance from the new edge to the original.
+ Width
+ The distance between the two new edges formed by the bevel (or the edges on either side of the bevel if there is more than one segment.
+ Depth
+ The perpendicular distance from the original edge to the bevel face.
+ Percent
+ The percentage of the length of adjacent edges that the new edges slide along.
+ Absolute
+ The exact distance along edges adjacent to the beveled edge.
+ A difference from *Offset* is visible when the unbeveled edges
+ attached to beveled edges meet at an angle besides a right angle.
+
+ For vertex-only bevels, the Offset and Depth types measure from the original vertex,
+ and the Width type is measured from a new vertex to the center of the new face (as half the amount).
+
+Segments :kbd:`S`
+ The number of segments in the bevel can be defined by
+ scrolling the mouse :kbd:`Wheel` to increase or decrease this value.
+ The greater the number of segments, the smoother the bevel.
+ Or press :kbd:`S` to change the number with mouse movements, as well as numeric input.
+
+ Alternatively, you can manually enter a segment number value while using the tool,
+ or in the Mesh Tool options panel after using the tool.
+
+ .. figure:: /images/modeling_meshes_editing_vertex_bevel-vertices_segments.png
+ :width: 320px
+
+ Bevel with four segments.
+
+Shape :kbd:`P`
+ This is a number between 0 and 1 that controls the shape of the profile (side view of a beveled edge).
+ The default value, 0.5, gives a circular arc (if the faces meet at right angles).
+ Values less than that give a flatter profile, with 0.25 being exactly flat,
+ and values less than that giving a concave bevel. Values more than 0.5 give a more convex profile.
+ Similarly as *Segments* it can be set with mouse movements and numeric input after toggling :kbd:`P`.
+
+Material Index
+ The *Material* number specifies which material should be assigned to the new faces created by the *Bevel* tool.
+ With the default, -1, the material is inherited from the closest existing face ("closest" can be a bit ambiguous).
+ Otherwise, the number is the slot index of the material to use for all newly created faces.
+
+Harden Normals :kbd:`H`
+ When enabled, the per-vertex face normals of the bevel faces are adjusted to
+ match the surrounding faces, and the normals of the surrounding faces are not affected.
+ This will keep the surrounding faces flat (if they were before),
+ with the bevel faces shading smoothly into them. For this effect to work,
+ custom split normals need to be enabled, which requires Auto Smooth to be enabled
+ (see :doc:`Normals </modeling/meshes/editing/mesh/normals>`).
+ As a convenience, that option will be enabled for you if it is not already when you enable Harden Normals here.
+
+Clamp Overlap :kbd:`C`
+ Limits the width of each beveled edge so that vertices do not overlap with other geometry.
+
+Loop Slide
+ If there are un-beveled edges along with beveled edges into a vertex,
+ the bevel tries to slide along those edges when possible.
+ Turning the option off can lead to more even bevel widths.
+
+Face Strength Mode
+ Set *Face Strength* on the faces involved in the bevel, according to the specified mode.
+ This can be used in conjunction with
+ a :doc:`Weight Normals Modifier </modeling/modifiers/modify/weighted_normal>`
+ (with the *Face Influence* option checked).
+
+ None
+ Do not set face strength.
+ New
+ Set the face strength of new faces along edges to *Medium*,
+ and the face strength of new faces at vertices to *Weak*.
+ Affected
+ In addition to those set for the *New* case,
+ also set the faces adjacent to new faces to have strength *Strong*.
+ All
+ In addition to those set for the *Affected* option,
+ also set all the rest of the faces of the model to have strength *Strong*.
+
+Profile Type :kbd:`Z`
+ Superellipse
+ Creates a bevel with a uniform concave or convex curve.
+ Custom
+ .. figure:: /images/modeling_modifiers_generate_bevel_profile-widget.png
+ :align: right
+ :width: 300px
+
+ The custom profile widget.
+
+ This widget allows the creation of a user-defined profile with more complexity than
+ with the single profile parameter. The modal tool allows toggling the custom profile,
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list