Skip to content

Commit 0e8b0dd

Browse files
author
Unity Technologies
committed
com.unity.splines@2.5.2
## [2.5.2] - 2023-12-22 ### Added - [SPLB-222] Added safety checks to spline changed events. ### Changed - [SPLB-233] Removed transform handles while dragging a knot using direct manipulation. - [SPLB-234] Removed unnecessary spline metadata which was saved on disk. ### Bug Fixes - [SPLB-230] Fixed a bug where modifying the tangent mode on the last knot would change the spline shape unpredictably. - [SPLB-225] Fixed a bug where closing a Spline with the `Draw Splines Tool` had inconsistent behaviour. - [SPLB-236] Fixed a bug where the spline instantiate inspector was throwing an exception when the selection contained objects without that component. - [SPLB-235] Fixed a bug where hovering a knot was create highlights when dragging tangents. - [SPLB-234] Fixed a bug where it was impossible to add a knot on the latest added knot. - [SPLB-214] Fixed an exception that would when adding a spline via the inspector if no other spline exists. - [SPLB-226] Fixed broken preview when adding knots to a closed spline
1 parent 97b28e4 commit 0e8b0dd

22 files changed

+150
-96
lines changed

CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,27 @@ All notable changes to this package will be documented in this file.
55
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
66
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
77

8+
## [2.5.2] - 2023-12-22
9+
10+
### Added
11+
12+
- [SPLB-222] Added safety checks to spline changed events.
13+
14+
### Changed
15+
16+
- [SPLB-233] Removed transform handles while dragging a knot using direct manipulation.
17+
- [SPLB-234] Removed unnecessary spline metadata which was saved on disk.
18+
19+
### Bug Fixes
20+
21+
- [SPLB-230] Fixed a bug where modifying the tangent mode on the last knot would change the spline shape unpredictably.
22+
- [SPLB-225] Fixed a bug where closing a Spline with the `Draw Splines Tool` had inconsistent behaviour.
23+
- [SPLB-236] Fixed a bug where the spline instantiate inspector was throwing an exception when the selection contained objects without that component.
24+
- [SPLB-235] Fixed a bug where hovering a knot was create highlights when dragging tangents.
25+
- [SPLB-234] Fixed a bug where it was impossible to add a knot on the latest added knot.
26+
- [SPLB-214] Fixed an exception that would when adding a spline via the inspector if no other spline exists.
27+
- [SPLB-226] Fixed broken preview when adding knots to a closed spline
28+
829
## [2.5.1] - 2023-10-17
930

1031
### Bug Fixes

Documentation~/TableOfContents.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
11
* [About Splines](index.md)
2-
* [What's new](whats-new.md)
3-
* [Splines upgrade guide](upgrade-guide.md)
2+
* [Splines upgrade guide](upgrade-guide.md)
43
* [Create a spline](create-a-spline.md)
54
* [Manipulate splines](manipulate-splines.md)
65
* [Reverse the flow of a spline](reverse-spline-flow.md)
76
* [Join splines](join-knots.md)
87
* [Knots](knots.md)
98
* [Link and unlink knots](link-unlink-knots.md)
10-
* [Split Knots](split-knots.md)
9+
* [Split knots](split-knots.md)
1110
* [Tangents](tangents.md)
1211
* [Tangent modes](tangent-modes.md)
1312
* [Select a tangent mode](select-tangent-mode.md)

Documentation~/element-inspector.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,7 @@ To access the Element Inspector overlay, select knots or tangents on splines in
1616
| **Out**| Set the magnitude and direction of the knot's **Out** tangent. The **Out** tangent defines the curvature of the segment that exits the knot. </br> </br> This property is visible only when you select knots. |
1717
| **Magnitude** | Set the magnitude of a tangent. </br> </br> A tangent's magnitude determines how much that tangent affects the curvature of its respective segment. A high magnitude value increases a tangent's influence on a segment's curvature and a low value decreases it. </br> </br> This property is visible only when you select tangents. |
1818
| **Direction** | Set the direction that a tangent points to from its knot. </br> </br> This property is visible only when you select tangents. |
19-
| **Link** | Set knots to the same position and link them. |
20-
| **Unlink** | Unlink knots. |
21-
| **Split** | Divide a knot with two segments into two knots. |
22-
| **Join** | Connect the ends of two splines to each other. |
23-
| **Reverse Spline Flow** | Reverse the direction of a spline. |
19+
2420

2521

2622
## Additional resources
@@ -29,4 +25,4 @@ To access the Element Inspector overlay, select knots or tangents on splines in
2925
- [**Link and unlink knots**](link-unlink-knots.md)
3026
- [**Split knots**](split-knots.md)
3127
- [**Join knots**](join-knots.md)
32-
<!-- [**Set Spline Flow**](spline-flow.md) -->
28+
- [**Reverse the flow of a spline**](reverse-spline-flow.md)

Documentation~/join-knots.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ When you join two knots, the new, joined knot takes the position of the active k
77
If you join the knots of two splines that flow in different directions, the new spline takes the direction of the active knot.
88

99
To join two splines:
10-
1. [!include[select-spline](.\snippets\select-spline.md)]
11-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
10+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
11+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
1212
1. Select two knots that are from different splines and have only one segment each.
13-
1. In the Element Inspector overlay, select **Join**.
13+
1. In the Scene view, right-click to open the context menu.
14+
1. In the Scene view context menu, and select **Join Knots**.

Documentation~/link-unlink-knots.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,42 +7,44 @@ Use linked knots to create a spline with branched paths. For example, you can cr
77
- A river with tributaries
88
- A diverging sets of mountain paths.
99

10-
You can link knots in the Element Inspector overlay or with the **Draw Splines Tool** in the [Scene view](xref:UsingTheSceneView). Use the Element Inspector overlay to unlink knots.
10+
You can link knots in the Scene view context menu or with the **Draw Splines Tool** in the [Scene view](xref:UsingTheSceneView). Use the Scene view context menu to unlink knots.
1111

1212
> [!NOTE]
1313
> You can link more than two knots to each other. If you link knots that are already linked to other knots, all the knots link to each other.
1414
1515
## Link knots with the Draw Splines Tool
1616

1717
To create a linked knot with the **Draw Splines Tool**:
18-
1. [!include[select-spline](.\snippets\select-spline.md)]
19-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
18+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
19+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
2020
1. In the Tools overlay, select the **Draw Splines Tool**.
2121
1. Select a knot that has two segments to create a knot that links to it.
2222
The new knot is the first knot of a new spline.
2323

2424
> [!NOTE]
2525
> If you use the **Draw Splines Tool** to create a knot on a linked knot, then that new knot is added to the existing link.
2626
27-
## Link knots in the Element Inspector
27+
## Link knots in the Scene view context menu
2828

29-
To link knots in the Element Inspector:
29+
To link knots in the Scene view context menu:
3030

31-
1. [!include[select-spline](.\snippets\select-spline.md)]
32-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
31+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
32+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
3333
1. Select at least two knots.
34-
1. In the Element Inspector overlay, select **Link**.
34+
1. In the Scene view, right-click to open the context menu.
35+
1. In the Scene view context menu, select **Link Knots**.
3536

3637
## Unlink knots
3738

3839
To unlink knots:
3940

40-
1. [!include[select-spline](.\snippets\select-spline.md)]
41-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
41+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
42+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
4243
1. Select a linked knot.
43-
1. In the Element Inspect overlay, select **Unlink**.
44+
1. In the Scene view, right-click to open the context menu.
45+
1. In the Scene view context menu, select **Unlink Knots**.
4446

4547

46-
<!-- ## Additional resources
47-
- Links to related content
48-
- Can be doc links or other Unity-owned resources -->
48+
## Additional resources
49+
50+
* [Knots](knots.md)

Documentation~/manipulate-splines.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@ Activate the **Spline** tool context to use the Move, Rotate, and Scale tools on
1010

1111
To select the knots or tangents of a spline in the Scene view:
1212

13-
1. [!include[select-spline](.\snippets\select-spline.md)]
14-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
13+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
14+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
1515
1. In the Scene view, select a knot or tangent.
1616
1. To select multiple knots and tangents, do one of the following:
1717
* Click and drag to draw a box over multiple knots and tangents.

Documentation~/reverse-spline-flow.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,11 @@ If you reverse the flow of a spline, you create a spline that mirrors the origin
1111

1212
To reverse the flow of a spline:
1313

14-
1. [!include[select-spline](.\snippets\select-spline.md)]
15-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
14+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
15+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
1616
1. Select a knot on the spline.
17-
1. In the Element Inspector overlay, select **Reverse Spline Flow**.
17+
1. In the Scene view, right-click to open the context menu.
18+
1. In the Scene view context menu, select **Reverse Spline Flow**.
1819

1920

2021
## Additional resources

Documentation~/select-default-tangent.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ You can select a [tangent mode](tangent-modes.md) for the **Draw Splines Tool**
55
In each tangent mode, you can click and drag to create a knot in the **[Mirrored Bezier mode](tangent-modes.md#mirrored-bezier-mode)**.
66

77
Select a default [tangent mode](tangent-modes.md) for the **Draw Splines Tool**:
8-
1. [!include[select-spline](.\snippets\select-spline.md)]
9-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
8+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
9+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
1010
1. In the Tools overlay, select the **Draw Splines Tool**.
1111
1. In the Tools Settings overlay, select **[Auto](tangent-modes.md#auto-tangent-mode)** or **[Linear](tangent-modes.md#linear-tangent-mode)** from the dropdown menu.

Documentation~/select-tangent-mode.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
You can select a [tangent mode](tangent-modes.md) for a knot. The tangent mode determines the curve between selected knots or all the knots on a selected spline.
44

55
To select a tangent mode:
6-
1. [!include[select-spline](.\snippets\select-spline.md)]
7-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
6+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
7+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
88
1. Select the knots or tangents that you want to select a tangent mode for.
99
1. In the **Element Inspector** overlay, select a [tangent mode](tangent-modes.md).

Documentation~/split-knots.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ You can only split a knot that has two segments. Split knots each have one segme
99
1010

1111
To split a knot:
12-
1. [!include[select-spline](.\snippets\select-spline.md)]
13-
1. [!include[set-spline-context](.\snippets\set-spline-context.md)]
12+
1. [!include[select-spline](.\\snippets\\select-spline.md)]
13+
1. [!include[set-spline-context](.\\snippets\\set-spline-context.md)]
1414
1. Select a knot with two segments.
15-
1. In the Element Inspector overlay, select **Split**.
15+
1. In the Scene view, right-click to open the context menu.
16+
1. In the Scene view context menu, select **Split Knot**.

0 commit comments

Comments
 (0)