[Bf-docboard-svn] bf-manual: [9345] branches/blender-3.2-release/blender_docs/manual: Curves: Curve Pen
Aaron Carlisle
noreply at blender.org
Wed Jun 8 02:30:27 CEST 2022
Revision: 9345
https://developer.blender.org/rBM9345
Author: Blendify
Date: 2022-06-08 02:30:26 +0200 (Wed, 08 Jun 2022)
Log Message:
-----------
Curves: Curve Pen
Author: @dilithjay
rB336082acba51b3a237338e2cc316b04320c05ad4
Modified Paths:
--------------
branches/blender-3.2-release/blender_docs/manual/glossary/index.rst
branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/index.rst
branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/toolbar.rst
Added Paths:
-----------
branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-properties.jpg
branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-tool-settings.jpg
branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/pen.rst
Modified: branches/blender-3.2-release/blender_docs/manual/glossary/index.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/glossary/index.rst 2022-06-06 19:54:44 UTC (rev 9344)
+++ branches/blender-3.2-release/blender_docs/manual/glossary/index.rst 2022-06-08 00:30:26 UTC (rev 9345)
@@ -249,6 +249,9 @@
A type of object defined in terms of a line interpolated between Control Vertices.
Available types of curves include :term:`Bézier`, :term:`NURBS` and Poly.
+ Curve Segment
+ The part of a curve connecting two adjacent control points.
+
Cyclic
Often referring to an object being circular. This term is often associated with :term:`Curve`.
Added: branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-properties.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-properties.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-properties.jpg 2022-06-06 19:54:44 UTC (rev 9344)
+++ branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-properties.jpg 2022-06-08 00:30:26 UTC (rev 9345)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-properties.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-tool-settings.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-tool-settings.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-tool-settings.jpg 2022-06-06 19:54:44 UTC (rev 9344)
+++ branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-tool-settings.jpg 2022-06-08 00:30:26 UTC (rev 9345)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/modeling_curves_tools_pen_curve-tool-settings.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/index.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/index.rst 2022-06-06 19:54:44 UTC (rev 9344)
+++ branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/index.rst 2022-06-08 00:30:26 UTC (rev 9345)
@@ -16,3 +16,4 @@
:maxdepth: 1
draw.rst
+ pen.rst
Added: branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/pen.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/pen.rst (rev 0)
+++ branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/pen.rst 2022-06-08 00:30:26 UTC (rev 9345)
@@ -0,0 +1,92 @@
+.. _bpy.ops.curve.pen:
+
+*********
+Curve Pen
+*********
+
+.. reference::
+
+ :Mode: Edit Mode
+ :Tool: :menuselection:`Toolbar --> Curve Pen`
+
+The Curve Pen tool allows you to construct and edit curves rapidly.
+
+
+Usage
+=====
+
+.. figure:: /images/modeling_curves_tools_pen_curve-properties.jpg
+ :align: right
+
+ Curve Pen Preferences
+
+The following preferences can be configured from:
+:menuselection:`Preferences --> Keymap --> 3D View --> Curve --> 3D View Tool: Edit Curve, Curve Pen`.
+
+Extrude Point
+ :kbd:`LMB` click to add a new point connected to an existing point.
+
+Extrude Handle Type
+ The :ref:`handle type <curve-bezier-handle-type>` of the extruded points.
+ Can be either *Vector* or *Auto*.
+ However, the handle type switches to *Align* when handles are moved (See *Move Point*).
+
+Delete Point
+ :kbd:`Ctrl-LMB` click on an existing point to delete it.
+
+Insert Point
+ :kbd:`Ctrl-LMB` click on a :term:`Curve Segment` to insert a new control point between the two
+ adjacent control points. :kbd:`Ctrl-LMB` click and drag to control the handles of the inserted points.
+
+Move Segment
+ :kbd:`LMB` drag on a segment in between two control points to adjust the handles, changing the shape of the
+ curve without affecting the location of any control points.
+
+Select Point
+ :kbd:`LMB` click to select a single point or handle at a time.
+
+Move point
+ :kbd:`LMB` drag to move existing points or handles. With an endpoint of a spline selected,
+ click and drag on empty space to *Extrude Point* and move the handle at the same time.
+
+Close Spline
+ Make the spline :term:`Cyclic` by clicking the endpoints consecutively.
+
+Close Spline Method
+ The condition for *Close Spline* to activate.
+
+ :None: Turn off the Close Spline functionality.
+ :On Press:
+ Close the spline on mouse down. With this option, you may click and drag to adjust the handles of the endpoint.
+ :On Click:
+ Activate on mouse release. With this option, the *Close Spline* functionality will not be
+ triggered on click and drag.
+
+Toggle Vector
+ :kbd:`Double-LMB` click on a handle to switch handle between *Vector* and *Auto* handle types.
+ Can be used to easily switch between sharp corners and smooth curves.
+
+Cycle Handle Type
+ :kbd:`Double-LMB` click on the control point to cycle through all handle types.
+
+
+Hotkeys
+=======
+
+Free-Align Toggle
+ Hold :kbd:`Left-Shift` while dragging a handle to switch between ``Free`` and ``Align`` handle types.
+ Can be used to create sharp corners along the curve.
+
+Move Adjacent Handle
+ Hold :kbd:`Left-Ctrl` while dragging a handle to move the closer handle of the adjacent control point.
+ Can be helpful to make adjustments to newly created curve segments.
+
+Move Entire
+ Hold :kbd:`Spacebar` while dragging a handle to move the entire point.
+
+Link Handles
+ Press :kbd:`Right-Ctrl` while dragging a handle to mirror its movement on the opposite handle of the same point.
+
+Lock Handle Angle
+ Hold :kbd:`Left-Alt` while dragging a handle to limit the movement of the handle to its current direction,
+ so only its length can be adjusted.
Property changes on: branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/pen.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/toolbar.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/toolbar.rst 2022-06-06 19:54:44 UTC (rev 9344)
+++ branches/blender-3.2-release/blender_docs/manual/modeling/curves/tools/toolbar.rst 2022-06-08 00:30:26 UTC (rev 9345)
@@ -50,6 +50,9 @@
:ref:`Draw <bpy.ops.curve.draw>`
Free-hand drawing of new curves.
+:ref:`Curve Pen <bpy.ops.curve.pen>`
+ Construct and edit splines.
+
:ref:`Extrude <modeling-curves-extrude>`
Extrude the curve by adding new control points.
More information about the Bf-docboard-svn
mailing list