Differences

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

--- tools:s-tk:layout-tool [2019/07/30 15:15] – [Planar] lightwolf
+++ tools:s-tk:layout-tool [2019/10/02 09:29] (current) – lightwolf
@@ Line 1: / Line 1: @@
-====== Spline Edit ======
+====== Spline Edit (Layout Tool) - Basic Use ======
 This Layout Tool is the heart of the Spline Toolkit. It allows you to edit splines that are attached to [[primitive]].
@@ Line 65: / Line 65: @@
   * **Length Only** Only the distance of the control point to the knot is changed, the direction remains.
   * **Angle Only** Only the direction of the control point to the knot is changed, the distance remains.
+{{ :tools:s-tk:pasted:20190808-152243.png}}
 ==== Numerical ====
-{{ :tools:s-tk:pasted:20190730-143005.png}}
 === Knot Position ===
@@ Line 79: / Line 80: @@
 The position of the current out control point which may be edited as well.
-=== Twist ===
+=== Up Vector ===
-The twist angle for the current knot.
+The Up Vector is used to align items along the spline.
-=== Reset Twist ===
+While the direction of the spline is defined by the spline itself, an item could be banked any way around it.
+The up vector defines the direction that is considered to be upwards at a specific knot. This value is interpolated from one knot to the next as an item moves along a spline.
+==== Settings ====
-Sets the twist back to 0°
-==== Display ====
-{{ :tools:s-tk:pasted:20190730-143226.png}}
 === Axis Handles ===
@@ Line 96: / Line 98: @@
 Toggles the display of the planar handles for knots and control points.
+{{ :tools:s-tk:pasted:20190808-152321.png}}
+=== Up Vector Handle ===
-=== Twist Handles ===
+Toggles the display of the up vector handle for knots.
-Toggles the display of the twist handles for knots.
 === Numerical Position ===
@@ Line 109: / Line 111: @@
 Toggles the display of the viewport menu.
-=== Open Spline Prefs...===
+=== Consolidate Undos ===
-Open the [[prefs]]
+This changes how the undo system works. By default, actions are consolidated.
+Basically, multiple edits of the same type to the same item are stored as one undo step.
+For example, if you move a specific knot multiple times in a row, say to tweak it, then all of the moves will be consolidated to a single un^do step if this option is enabled.
+If this option is disabled then every single small move of that knot will be a separate undo step.
+=== Open Spline Prefs...===
+Open the [[prefs]]
@@ Line 144: / Line 146: @@
 Selecting and dragging them restricts the movement to that plane only.
-==== Twist ====
+==== Up Vector ====
-The twist handle is a small circle and a dashed line to the selected knot.
+The up vector handle is a small circle and a dashed line to the selected knot, rendered in green.
-Selecting it and moving the mouse to the left/right will change the twist value for the knot. Then Angle is displayed numerically as well.
+It can be selected and moved in all three dimensions. Since there's no axis or planar handles (yet), that may require changing the viewing angle to get into the desired position.
+===== Known Issues =====
+  * Switching the tool from one viewport to another can be glitchy at times. We tried to keep it safe so it requires a click on the new viewport to make the handles active again.