[Bf-docboard-svn] bf-manual: [9387] trunk/blender_docs/manual/physics/forces/force_fields/types/curve_guide.rst: UI: Layout tweaks to Curve Guide force field min/max distance
Aaron Carlisle
noreply at blender.org
Tue Jun 28 01:51:08 CEST 2022
Revision: 9387
https://developer.blender.org/rBM9387
Author: Blendify
Date: 2022-06-28 01:51:08 +0200 (Tue, 28 Jun 2022)
Log Message:
-----------
UI: Layout tweaks to Curve Guide force field min/max distance
rB36e330bd9cc1d5864d3420031aa7c0ba5ef5d27f
Modified Paths:
--------------
trunk/blender_docs/manual/physics/forces/force_fields/types/curve_guide.rst
Modified: trunk/blender_docs/manual/physics/forces/force_fields/types/curve_guide.rst
===================================================================
--- trunk/blender_docs/manual/physics/forces/force_fields/types/curve_guide.rst 2022-06-27 17:29:48 UTC (rev 9386)
+++ trunk/blender_docs/manual/physics/forces/force_fields/types/curve_guide.rst 2022-06-27 23:51:08 UTC (rev 9387)
@@ -30,6 +30,9 @@
their fields add up to each other (the way you may have learned it in your physics course).
But you can limit their influence radius by changing the *Minimum Distance* (see below).
+A particle follows a *Curve Guide* during its lifetime,
+the velocity depends on its lifetime and the length of the path.
+
.. note::
The Curve Guide does not affect :doc:`soft bodies </physics/soft_body/index>`.
@@ -43,47 +46,54 @@
UI for a Curve Guide force field.
-Minimum Distance
- The distance from the curve, up to where the force field is effective with full strength.
- If you have a falloff of 0, this parameter will have no effect,
- because the field is effective with full strength up to *Max Distance* (or the infinity).
- *Min Distance* is shown with a circle at the endpoints of the curve in the 3D Viewport.
+.. _bpy.types.FieldSettings.guide_free:
Free
Fraction of particle life time, that is not used for the curve.
-Falloff
+.. _bpy.types.FieldSettings.falloff_power:
+
+Falloff Power
This setting governs the strength of the guide between *Min Distance* and *Max Distance*.
A falloff of 1 means a linear progression.
+.. _bpy.types.FieldSettings.use_guide_path_add:
-Path
-----
+Additive
+ If you use *Additive*, the speed of the particles is also evaluated depending on the falloff.
-A particle follows a *Curve Guide* during its lifetime,
-the velocity depends on its lifetime and the length of the path.
+.. _bpy.types.FieldSettings.use_guide_path_weight:
-Additive
- If you use *Additive*, the speed of the particles is also evaluated depending on the falloff.
Weights
Use Curve weights to influence the particle influence along the curve.
-Maximum Distance / Use Max
- The maximum influence radius. Shown by an additional circle around the curve object.
+.. _bpy.types.FieldSettings.guide_clump_amount:
-Clumping
---------
+Clumping Amount
+ The particles come together at the end of the curve (1) or they drift apart (-1).
-The other settings govern the form of the force field along the curve.
+.. _bpy.types.FieldSettings.guide_clump_shape:
-Clumping Amount
- The particles come together at the end of the curve (1) or they drift apart (-1).
Shape
Defines the form in which the particles come together.
+0.99: the particles meet at the end of the curve.
0: linear progression along the curve. -0.99: the particles meet at the beginning of the curve.
+.. _bpy.types.FieldSettings.guide_minimum:
+Min Distance
+ The distance from the curve, up to where the force field is effective with full strength.
+ If you have a falloff of 0, this parameter will have no effect,
+ because the field is effective with full strength up to *Max Distance* (or the infinity).
+ *Min Distance* is shown with a circle at the endpoints of the curve in the 3D Viewport.
+
+.. _bpy.types.FieldSettings.use_max_distance:
+.. _bpy.types.FieldSettings.distance_max:
+
+Max Distance
+ The maximum influence radius. Shown by an additional circle around the curve object.
+
+
Kink
----
@@ -91,6 +101,8 @@
This feature is broken in the current version, see T46776.
+.. _bpy.types.FieldSettings.guide_kink_type:
+
Type
Changes the shape that the particles can take.
@@ -102,24 +114,35 @@
:Rotation: Todo.
:Wave: A two-dimensional, standing wave.
-It is not so easy to describe the resulting shapes, so have a look at the example below.
+ It is not so easy to describe the resulting shapes, so have a look at the example below.
-.. figure:: /images/physics_forces_force-fields_types_curve-guide_kink.jpg
- :width: 400px
+ .. figure:: /images/physics_forces_force-fields_types_curve-guide_kink.jpg
+ :width: 400px
- Kink options of a curve guide. From left to right: Radial, Wave, Braid, Roll.
- `Animation <https://vimeo.com/1866538>`__.
+ Kink options of a curve guide. From left to right: Radial, Wave, Braid, Roll.
+ `Animation <https://vimeo.com/1866538>`__.
+.. _bpy.types.FieldSettings.guide_kink_axis:
+
Axis
Which axis to use for the offset.
+
+.. _bpy.types.FieldSettings.guide_kink_frequency:
+
Frequency
The frequency of the offset.
-Amplitude
- The Amplitude of the offset.
+
+.. _bpy.types.FieldSettings.guide_kink_shape:
+
Shape
Adjust the offset to the beginning/end.
+.. _bpy.types.FieldSettings.guide_kink_amplitude:
+Amplitude
+ The Amplitude of the offset.
+
+
Examples
========
More information about the Bf-docboard-svn
mailing list