[Bf-docboard-svn] bf-manual: [9665] trunk/blender_docs/manual/modeling/meshes: Modeling: Add extrude to cursor operator page

[Aaron Carlisle]

Revision: 9665
          https://developer.blender.org/rBM9665
Author:   Blendify
Date:     2022-11-03 03:22:27 +0100 (Thu, 03 Nov 2022)
Log Message:
-----------
Modeling: Add extrude to cursor operator page

For now this is a copy of the tool page until we have a defined way to document a tool vs its operator.

Fixes T102223

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/meshes/editing/vertex/index.rst
    trunk/blender_docs/manual/modeling/meshes/tools/extrude_cursor.rst

Added Paths:
-----------
    trunk/blender_docs/manual/modeling/meshes/editing/vertex/extrude_cursor.rst

Added: trunk/blender_docs/manual/modeling/meshes/editing/vertex/extrude_cursor.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/vertex/extrude_cursor.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/meshes/editing/vertex/extrude_cursor.rst	2022-11-03 02:22:27 UTC (rev 9665)
@@ -0,0 +1,63 @@
+.. _bpy.ops.mesh.dupli_extrude_cursor:
+
+************************
+Extrude to Cursor or Add
+************************
+
+.. reference::
+
+   :Mode:      Edit Mode
+   :Shortcut:  :kbd:`Ctrl-RMB`
+
+Interactively places new vertices with :kbd:`Ctrl-RMB` at the mouse cursor position.
+
+The most basic element, a vertex, can be added with a :kbd:`Ctrl-RMB` click
+when no other vertices are selected.
+Because the camera space (computer screen) is two-dimensional,
+Blender cannot determine all three vertex coordinates from a single mouse click,
+so the new vertex is placed at the depth of the 3D cursor.
+
+To create interconnected vertices, you can add a vertex and continuously make subsequent :kbd:`Ctrl-RMB`
+operations with the last vertex selected.
+This will link the last selected vertex with the vertex created at the mouse position with an edge
+(see Fig. :ref:`fig-mesh-basics-add-one`),
+and will continuously create and connect new vertices if you continue repeating this operation.
+
+.. _fig-mesh-basics-add-one:
+
+.. figure:: /images/modeling_meshes_tools_extrude-cursor_vertex.png
+
+   Adding vertices one by one.
+
+
+Creating Faces
+==============
+
+.. figure:: /images/modeling_meshes_tools_extrude-cursor_quad.png
+
+   Quad from an Edge with source automatically rotated.
+
+If you have two vertices selected and already connected with an edge, :kbd:`Ctrl-RMB` click
+will create a planar face, also known as a quad. Blender will follow your mouse cursor
+and will use the planar view from your viewport to create those quads.
+
+For :kbd:`Ctrl-RMB`, Blender will automatically rotate the last selected Edge (the source)
+for the subsequent operations if you have at least one face created, dividing the angles created between
+the newly created edge and the last two edges, creating a smooth angle between them. Blender will calculate
+this angle using the last positive and negative position of the last X and Y coordinates
+and the last connected unselected edge. If this angle exceeds a negative limit (following a quadrant rule)
+between the recently created edge and the last two, Blender will wrap the faces.
+But if you do not want Blender to rotate and smooth edges automatically when extruding from :kbd:`Ctrl-RMB`,
+you can also inhibit Blender from rotating sources using the shortcut :kbd:`Shift-Ctrl-RMB`.
+In this case, Blender will not rotate the source dividing the angle between those edges when creating a face.
+
+If you have three or more vertices selected, and :kbd:`Ctrl-RMB` click,
+you will also create planar faces, but along the vertices selected, following the direction of the cursor.
+This operation is similar to an extrude operation.
+
+.. tip::
+
+   When adding objects with :kbd:`Ctrl-RMB`, the extrusions of the selected elements,
+   being vertices, edges and faces with the :kbd:`Ctrl-RMB`, are viewport dependent.
+   This means, once you change your viewport, for example, from top to left, bottom or right,
+   the extrusion direction will also follow your viewport and align the extrusions with your planar view.


Property changes on: trunk/blender_docs/manual/modeling/meshes/editing/vertex/extrude_cursor.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/meshes/editing/vertex/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/vertex/index.rst	2022-11-03 02:16:04 UTC (rev 9664)
+++ trunk/blender_docs/manual/modeling/meshes/editing/vertex/index.rst	2022-11-03 02:22:27 UTC (rev 9665)
@@ -7,6 +7,7 @@
    :maxdepth: 2
 
    extrude_vertices.rst
+   extrude_cursor.rst
    bevel_vertices.rst
    make_face_edge.rst
    connect_vertex_path.rst

Modified: trunk/blender_docs/manual/modeling/meshes/tools/extrude_cursor.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/tools/extrude_cursor.rst	2022-11-03 02:16:04 UTC (rev 9664)
+++ trunk/blender_docs/manual/modeling/meshes/tools/extrude_cursor.rst	2022-11-03 02:22:27 UTC (rev 9665)
@@ -1,5 +1,4 @@
 .. _tool-mesh-extrude_cursor:
-.. _bpy.ops.mesh.dupli_extrude_cursor:
 
 *****************
 Extrude to Cursor
@@ -21,10 +20,10 @@
 To create interconnected vertices, you can add a vertex and continuously make subsequent :kbd:`Ctrl-RMB`
 operations with the last vertex selected.
 This will link the last selected vertex with the vertex created at the mouse position with an edge
-(see Fig. :ref:`fig-mesh-basics-add-one`),
+(see Fig. :ref:`fig-mesh-basics-add-one-tool`),
 and will continuously create and connect new vertices if you continue repeating this operation.
 
-.. _fig-mesh-basics-add-one:
+.. _fig-mesh-basics-add-one-tool:
 
 .. figure:: /images/modeling_meshes_tools_extrude-cursor_vertex.png