[Bf-docboard-svn] bf-manual: [7729] trunk/blender_docs/manual: GPencil: Add curve editing documentation
Falk David
noreply at blender.org
Mon Feb 8 16:31:16 CET 2021
Revision: 7729
https://developer.blender.org/rBM7729
Author: filedescriptor
Date: 2021-02-08 16:31:16 +0100 (Mon, 08 Feb 2021)
Log Message:
-----------
GPencil: Add curve editing documentation
Modified Paths:
--------------
trunk/blender_docs/manual/editors/3dview/display/overlays.rst
trunk/blender_docs/manual/grease_pencil/modes/edit/index.rst
trunk/blender_docs/manual/grease_pencil/properties/strokes.rst
Added Paths:
-----------
trunk/blender_docs/manual/grease_pencil/modes/edit/curve_editing.rst
trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_off.png
trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_on.png
trunk/blender_docs/manual/images/grease-pencil_curve_editing_panel.png
Modified: trunk/blender_docs/manual/editors/3dview/display/overlays.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/display/overlays.rst 2021-02-08 04:01:28 UTC (rev 7728)
+++ trunk/blender_docs/manual/editors/3dview/display/overlays.rst 2021-02-08 15:31:16 UTC (rev 7729)
@@ -351,3 +351,5 @@
Opacity for edit vertices (points).
Vertex Paint Opacity
The opacity of the overlay.
+Handles
+ Curve handle display option. See :doc:`Curve Editing </grease_pencil/modes/edit/curve_editing>` for more information.
\ No newline at end of file
Added: trunk/blender_docs/manual/grease_pencil/modes/edit/curve_editing.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/edit/curve_editing.rst (rev 0)
+++ trunk/blender_docs/manual/grease_pencil/modes/edit/curve_editing.rst 2021-02-08 15:31:16 UTC (rev 7729)
@@ -0,0 +1,112 @@
+.. _bpy.types.GreasePencil.use_curve_edit:
+
+
+*************
+Curve Editing
+*************
+
+Curve Editing allows you to edit grease pencil strokes using bézier curves.
+
+
+Usage
+=====
+
+#. Select the desired strokes to edit as curves.
+#. Activate curve editing in the 3D Viewport's header with the toggle button (bézier curve icon).
+#. Once activated you can:
+
+ - Edit the curves with the curve handles.
+ - Select strokes to automatically convert them to curves.
+
+.. note::
+ Selecting :doc:`points in between </grease_pencil/selecting>` is disabled while in curve edit mode.
+
+Curve Editing Popover
+=====================
+
+.. figure:: /images/grease-pencil_curve_editing_panel.png
+
+ Curve Editing popover.
+
+
+.. _bpy.types.GreasePencil.edit_curve_resolution:
+
+Curve Resolution
+ Number of points generated along each curve segment (between two handles) if Apdaptive Resolution is turned off.
+
+.. _bpy.types.GreasePencil.curve_edit_threshold:
+
+Threshold
+ Threshold used for curve fitting. Maximum distance the fitted curve can deviate from the target stroke.
+ A threshold of 0.0 will generate a curve point for every stroke point. Higher thresholds will result in higher
+ approximations of the target stroke but also smoother curve.
+
+.. _bpy.types.GreasePencil.curve_edit_corner_angle:
+
+Corner Angle
+ Any detected corner with an angle above the specified amount will create a sharp (non-aligned) handle.
+
+.. _bpy.types.GreasePencil.use_adaptive_curve_resolution:
+
+Adaptive Resolution
+ When activated, the Curve Resolution is no longer constant for all curve segments but calculated dynamically.
+ The length of each segment is approximated, then multiplied by the Curve Resolution and rounded down.
+ This will be the number of points to generate for that segment.
+ Adaptive resolution will distribute the points more evenly accross all the strokes.
+ The Curve Resolution parameter will change the point density.
+
+.. list-table:: Adaptive Resolution.
+
+ * - .. figure:: /images/grease-pencil_curve_editing_adaptive_resolution_off.png
+ :width: 320px
+
+ Off.
+
+ - .. figure:: /images/grease-pencil_curve_editing_adaptive_resolution_on.png
+ :width: 320px
+
+ On.
+
+Handle Display
+==============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Edit Mode
+ :Panel: :menuselection:`3D Viewport --> Viewport Overlays --> Edit Grease Pencil`
+
+When Curve Editing is active, curves have special :doc:`overlays </editors/3dview/display/overlays>`
+to control how curves are displayed in the 3D Viewport.
+
+Handles
+ - None
+ No handles are displayed. Just the control points.
+ - Selected
+ Only handles for selected control points are displayed.
+ - All
+ All the handles are displayed.
+
+Curve Data
+==========
+
+Once a stroke has been converted to a curve, the data will be saved to the file.
+When Curve Editing is turned off and the curve is changed, for example using :doc:`Sculpt Mode </grease_pencil/modes/sculpting/introduction>`,
+then the curve will be refitted once Curve Editing is activated again.
+
+
+Operators
+=========
+
+Curve editing is currently more limited than stroke editing.
+Every edit mode operation for strokes and stroke points work for curves as well except for the following:
+
+ - Duplicate
+ - Copy & Paste
+ - Snap to Cursor & Cursor to selected
+ - Flip
+ - Simplify & Simplify Fixed
+ - Trim
+ - Separate
+ - Split
+ - Interpolate
Property changes on: trunk/blender_docs/manual/grease_pencil/modes/edit/curve_editing.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/grease_pencil/modes/edit/index.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/edit/index.rst 2021-02-08 04:01:28 UTC (rev 7728)
+++ trunk/blender_docs/manual/grease_pencil/modes/edit/index.rst 2021-02-08 15:31:16 UTC (rev 7729)
@@ -8,6 +8,7 @@
introduction.rst
tools.rst
+ curve_editing.rst
grease_pencil_menu.rst
stroke_menu.rst
point_menu.rst
Modified: trunk/blender_docs/manual/grease_pencil/properties/strokes.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/properties/strokes.rst 2021-02-08 04:01:28 UTC (rev 7728)
+++ trunk/blender_docs/manual/grease_pencil/properties/strokes.rst 2021-02-08 15:31:16 UTC (rev 7729)
@@ -48,3 +48,6 @@
Thickness Scale
Sets a thickness scale factor for all strokes.
+
+Curve Resolution
+ See :doc:`Curve Editing </grease_pencil/modes/edit/curve_editing>` for more information.
\ No newline at end of file
Added: trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_off.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_off.png
===================================================================
--- trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_off.png 2021-02-08 04:01:28 UTC (rev 7728)
+++ trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_off.png 2021-02-08 15:31:16 UTC (rev 7729)
Property changes on: trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_off.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_on.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_on.png
===================================================================
--- trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_on.png 2021-02-08 04:01:28 UTC (rev 7728)
+++ trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_on.png 2021-02-08 15:31:16 UTC (rev 7729)
Property changes on: trunk/blender_docs/manual/images/grease-pencil_curve_editing_adaptive_resolution_on.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/grease-pencil_curve_editing_panel.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/grease-pencil_curve_editing_panel.png
===================================================================
--- trunk/blender_docs/manual/images/grease-pencil_curve_editing_panel.png 2021-02-08 04:01:28 UTC (rev 7728)
+++ trunk/blender_docs/manual/images/grease-pencil_curve_editing_panel.png 2021-02-08 15:31:16 UTC (rev 7729)
Property changes on: trunk/blender_docs/manual/images/grease-pencil_curve_editing_panel.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
More information about the Bf-docboard-svn
mailing list