Differences

This shows you the differences between two versions of the page.

--- tools:wheel [2020/10/19 15:02] – lightwolf
+++ tools:wheel [2021/06/02 10:21] (current) – [Rotation (Input) / Rotation Vector (output)] lightwolf
@@ Line 1: / Line 1: @@
 ====== Wheel Rotation ======
-{{ :tools:pasted:20201019-150245.png}}
+{{ :tools:pasted:20210208-133136.png}}
 This node computes the rotation of a wheel if travelling along a distance. The distance is based on the movement of an item.
@@ Line 27: / Line 27: @@
 Toggle which axis positions are used to compute the travelled distance.
+==== Align ====
+This aligns the wheel to the rotation of travel. The wheel may travel backwards as well. If that happens, the alignment will not flip (it also shouldn't either).
+Travelling backwards is detected by the motion changing by more than 90° from one frame to the next.
+<WRAP center round tip >
+If Align is active, the plugin will assume a default orientation for the wheel.
+The forward direction is -Z, it will rotate around the pitch and the alignment modifies the heading.
+</WRAP>
+==== Look-Ahead (s) ====
+How far the plugin will look ahead to compute the alignment.
 ==== Samples per Frame ====
 If the movement has intricate turns, increasing the number of samples will increase the accuracy of the computed distance - but will also slow down evaluating it.
+==== First Frame / Override ====
+==== Last Frame / Override ====
+This controls allow you to limit the frames where the plugin is active.
+Multiple plugins can be daisy chained via the Rotation input and using Add as a Channel Replacement option to allow for multiple slices in time where the plugins are active.
+A similar effect can be achieved by animating the Rotation Multiplier.
 ==== Rotation Multiplier ====
@@ Line 39: / Line 60: @@
 This determines the rotation channel the wheel rotation will be copied to if the **Rotation Vector** output is used.
+==== Channel Replacement ====
+If a Rotation vector is connected to the input, this control defines how the **Rotation Channel** will modify the respective rotation channel on the input vector.
+This allows for the daisy chaining of multiple wheel nodes.
+==== Cache ====
+If this option is enabled, the plugin will use a cache for the wheel rotation which can massively speed up scenes with multiple wheels or long scenes.
+The Alignment is not cached.
+==== Update Cache ====
+Updates the cache. This is required if any of the items that influence the current wheel have been edited.
+<WRAP center round important >
+Due to technical limitations, the cache can not be updated automatically if any of the items that influence the current wheel have been changed.
+We have provided the [[tools:wheel_generic|]] plugin to make this process easier.
+</WRAP>
+==== Save Cache ====
+Saves the cache with the node settings, effectively baking it.
+If save is off, the cache will be re-created when the node is loading (i.e. when a scene is loaded).
 ===== Node Connections =====
@@ Line 60: / Line 110: @@
 ----
 [[https://www.patreon.com/dbw|{{  ::become_a_patron_button.png?nolink|}}]]
-This plugin is our Plugin of the Month for October 2020, made possible by the finest patrons on [[https://www.patreon.com/dbw|Patreon]].
+This plugin is our Plugin of the Month for October 2020 and December 2020, made possible by the finest patrons on [[https://www.patreon.com/dbw|Patreon]].
+**Sponsored by Mikael "Cageman" Burman.**