[Bf-docboard-svn] bf-manual: [8480] trunk/blender_docs/manual: Geometry Nodes: Documentation for 10 curve nodes, other fixes
Hans Goudey
noreply at blender.org
Fri Oct 15 07:18:20 CEST 2021
Revision: 8480
https://developer.blender.org/rBM8480
Author: HooglyBoogly
Date: 2021-10-15 07:18:20 +0200 (Fri, 15 Oct 2021)
Log Message:
-----------
Geometry Nodes: Documentation for 10 curve nodes, other fixes
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/resample_curve.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_handle_type.rst
trunk/blender_docs/manual/modeling/geometry_nodes/input/normal.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-radius_node.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-tilt_node.png
trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_radius.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_tilt.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_handle_positions.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_spline_cyclic.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_spline_resolution.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/spline_length.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/spline_resolution.rst
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-radius_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-radius_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-radius_node.png 2021-10-15 03:59:41 UTC (rev 8479)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-radius_node.png 2021-10-15 05:18:20 UTC (rev 8480)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-radius_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-tilt_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-tilt_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-tilt_node.png 2021-10-15 03:59:41 UTC (rev 8479)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-tilt_node.png 2021-10-15 05:18:20 UTC (rev 8480)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_curve_set-curve-tilt_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst 2021-10-15 03:59:41 UTC (rev 8479)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst 2021-10-15 05:18:20 UTC (rev 8480)
@@ -13,7 +13,18 @@
reverse_curve.rst
subdivide_curve.rst
trim_curve.rst
+ sample_curve.rst
+ spline_length.rst
+ is_spline_cyclic.rst
+ spline_resolution.rst
+
+ set_curve_radius.rst
+ set_curve_tilt.rst
+ set_handle_positions.rst
+ set_spline_cyclic.rst
+ set_spline_resolution.rst
+
------------------------
.. toctree::
@@ -31,19 +42,10 @@
.. missing documentation
fillet_curve.rst
- sample_curve.rst
curve_handle_position.rst
curve_parameter.rst
curve_tangent.rst
curve_tilt.rst
- is_spline_cyclic.rst
- spline_length.rst
- spline_resolution.rst
-
- set_curve_radius.rst
- set_curve_tilt.rst
- set_handle_positions.rst
+
set_handle_type.rst
- set_spline_cyclic.rst
- set_spline_resolution.rst
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/curve/resample_curve.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/resample_curve.rst 2021-10-15 03:59:41 UTC (rev 8479)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/resample_curve.rst 2021-10-15 05:18:20 UTC (rev 8480)
@@ -11,7 +11,7 @@
The Resample Curve node.
The Resample Curve node creates a poly spline for each input spline.
-In the new poly splines the control points will have uniform spacing.
+In the new poly splines, the control points will have uniform spacing.
.. tip::
@@ -25,12 +25,18 @@
Standard geometry input.
Count
- Number of control points on the new splines.
+ The number of control points on the new splines.
Length
- Approximate length between the control points of the new splines.
+ The approximate length between the control points of the new splines.
+
+ .. tip::
+ A :doc:`</modeling/geometry_nodes/curve/trim_curve>` node can be used with a multiple of the
+ input length to make the distance between each sampled point exact, even when the length of the spline changes.
+
+
Properties
==========
Added: trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst 2021-10-15 05:18:20 UTC (rev 8480)
@@ -0,0 +1,61 @@
+.. index:: Geometry Nodes; Sample Curve
+.. _bpy.types.GeometryNodeSampleCurve:
+
+*****************
+Sample Curve Node
+*****************
+
+.. figure:: /images/modeling_geometry-nodes_curve_sample-curve_node.png
+ :align: right
+
+ Sample Curve Node
+
+The *Sample Curve* travels a certain distance along the curve input, specified by the length or factor
+inputs, and outputs data retrieved from that position on the curve. The sampled values are linearly
+interpolated from the values at the evalauted curve points at each side of the sampled point.
+
+.. note::
+
+ When the curve contains multiple splines, the sample position is found based on the total accumulated
+ length, including the lengths of all previous splines. The order of the splines is the same order as
+ determined shown in the :doc:`Spreadsheet Editor </editors/spreadsheet>`.
+
+Inputs
+======
+
+Curve
+ Standard geometry input with a curve component.
+
+Factor
+ The portion of the total length used to determine the sample position.
+
+Length
+ A length in distance units used to determine how far along the curve to travel before sampling.
+
+Properties
+==========
+
+Mode
+ How to find endpoint positions for the trimmed spline.
+ The option acts the same as it does in the :doc:`</modeling/geometry_nodes/curve/curve_tilt>`.
+
+ :Factor:
+ Find the endpoint positions using a factor of each spline's length.
+ The input values should be between 0 or 1.
+ :Length:
+ Find the endpoint positions using a length from the start of each spline.
+ The input values should be between 0 and the length of the splines.
+
+Outputs
+=======
+
+Position
+ The position at the sample along the spline.
+
+Tangent
+ The :doc:`curve tangent </modeling/geometry_nodes/curve/curve_tangent>` at the sample.
+ The value is normalized.
+
+Normal
+ The :doc:`curve normal </modeling/geometry_nodes/input/normal>` at the sample.
+ The value is normalized.
Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_radius.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_radius.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_radius.rst 2021-10-15 05:18:20 UTC (rev 8480)
@@ -0,0 +1,41 @@
+.. index:: Geometry Nodes; Set Curve Radius
+.. _bpy.types.GeometryNodeSetCurveRadius:
+
+*********************
+Set Curve Radius Node
+*********************
+
+.. figure:: /images/modeling_geometry-nodes_curve_set-curve-radius_node.png
+ :align: right
+
+ Set Curve Radius Node
+
+The *Set Curve Radius* controls the radius of the curve, used for operations like the size of the profile
+in the :doc:`Curve to Mesh </modeling/geometry_nodes/curve/curve_to_mesh>` node. The value is set for every
+control point, and is then interpolated to each evaluated point in between the control points.
+The input node for this data is the :doc:`</modeling/geometry_nodes/input/radius>`.
+
+
+Inputs
+======
+
+Geometry
+ Standard geometry input, containing a curve.
+
+Selection
+ Whether or not to change the value on each control point. True values mean the value will be changed,
+ false values mean the value will remain the same.
+
+Radius
+ The radius value for each control point.
+
+Properties
+==========
+
+This node has no properties.
+
+Outputs
+=======
+
+Geometry
+ Standard geometry input, containing a curve.
Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_radius.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_tilt.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_tilt.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_tilt.rst 2021-10-15 05:18:20 UTC (rev 8480)
@@ -0,0 +1,44 @@
+.. index:: Geometry Nodes; Set Curve Tilt
+.. _bpy.types.GeometryNodeSetCurveTilt:
+
+*******************
+Set Curve Tilt Node
+*******************
+
+.. figure:: /images/modeling_geometry-nodes_curve_set-curve-tilt_node.png
+ :align: right
+
+ Set Curve Tilt Node
+
+The *Set Curve Tilt* controls the tilt angle at each curve control point. That angle rotates normal vector
+which is generated at each point when evaluating the curve. The normal then can be retrieved with the
+:doc:`Normal Input Node </modeling/geometry_nodes/input/normal>`. The rotation is an :term:`Axis Angle`
+rotation, or the operation of the :doc:`</modeling/geometry_nodes/vector/vector_rotate>`, with the tangent
+vector as the axis, the raw evaluated normal as the original vector, and the tilt as the rotation angle.
+The input node for this data is the :doc:`</modeling/geometry_nodes/curve/curve_tilt>`.
+
+
+Inputs
+======
+
+Geometry
+ Standard geometry input, containing a curve.
+
+Selection
+ Whether or not to change the value on each control point. True values mean the value will be changed,
+ false values mean the value will remain the same.
+
+Tilt
+ The tilt angle for each control point.
+
+
+Properties
+==========
+
+This node has no properties.
+
+Outputs
+=======
+
+Geometry
+ Standard geometry input, containing a curve.
Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_curve_tilt.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/curve/set_handle_positions.rst
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list