com.unity.splines@2.7.1

## [2.7.1] - 2024-10-17

### Added

- [STO-3204] Added a **Create Spline** button to enter spline creation when you do not have the Spline tool context activated.
- New `SplineExtrude` and `SplineMesh` option enables new extrusion profiles, including `Circle`, `Square`, `Road`, and `Spline`.
- Added a section in the documentation for the `Source Spline Container` in the `SplineExtrude` component.

### Bug Fixes

- [SPLB-292] Removed the dependency on the UGUI package.
- Removed the toggle to override the target spline in the `SplineExtrude` inspector.
- [SPLB-288] Fixed a bug where a prefab `SplineContainer` would unexpectedly restore splines deleted before entering and exiting playmode.
- [SPLB-284] Fixed a bug that prevented baking instances of multiple `SplineInstantiate` components when multi-selecting.
- [SPLB-277] Fixed a bug where instantiating a prefab with `SplineAnimate` component would throw messages in the console.
- [SPLB-279] Fixed a bug where closing a Spline would not update the auto-smooth knots at the extremities.

Author: Unity Technologies

CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.7.1] - 2024-10-17
+
+### Added
+
+- [STO-3204] Added a **Create Spline** button to enter spline creation when you do not have the Spline tool context activated.
+- New `SplineExtrude` and `SplineMesh` option enables new extrusion profiles, including `Circle`, `Square`, `Road`, and `Spline`.
+- Added a section in the documentation for the `Source Spline Container` in the `SplineExtrude` component.
+
+### Bug Fixes
+
+- [SPLB-292] Removed the dependency on the UGUI package.
+- Removed the toggle to override the target spline in the `SplineExtrude` inspector.
+- [SPLB-288] Fixed a bug where a prefab `SplineContainer` would unexpectedly restore splines deleted before entering and exiting playmode.
+- [SPLB-284] Fixed a bug that prevented baking instances of multiple `SplineInstantiate` components when multi-selecting.
+- [SPLB-277] Fixed a bug where instantiating a prefab with `SplineAnimate` component would throw messages in the console.
+- [SPLB-279] Fixed a bug where closing a Spline would not update the auto-smooth knots at the extremities.
+
 ## [2.6.1] - 2024-05-23
 
 ### Bug Fixes

Documentation~/TableOfContents.md

@@ -17,7 +17,7 @@
     * [Configure the movement of a GameObject](animate-movement.md)
     * [Spline Animate component reference](animate-component.md)  
 * [Extrude a mesh along a spline](extrude.md)
-    * [Create a tube-shaped mesh along a spline](extrude-mesh.md)
+    * [Create a 3D mesh along a spline](extrude-mesh.md)
     * [Spline Extrude component reference](extrude-component.md)
 * [Spline Element Inspector overlay reference](element-inspector.md)  
 * [Spline component reference](spline-component.md)

Documentation~/create-a-spline.md

@@ -2,16 +2,28 @@
 
 Splines are paths made up of control points called knots. Segments connect knots to other knots. You can place knots onto the surface of objects or [align them to the grid](https://docs.unity3d.com/Manual/GridSnapping.html). Knots can include tangents which control the curvature of the segment at that knot.
 
+## Create a new spline
+
 To create a spline:
 
 > [!NOTE]
 > Before you add a knot to a spline, the spline's default location is 0, 0, 0. After you create the spline's first knot, the spline takes that knot's location. 
 
 1. Do one of the following: 
+    * In the **Scene** view, from the **Tools** overlay, select **Create Spline**.
     * Go to **GameObject** > **Spline** > **Draw Splines Tool**.
     * In the [Hierarchy window](xref:Hierarchy), right-click and select **Spline** > **Draw Splines Tool**.
 1. Click in the [Scene view](xref:UsingTheSceneView) to create knots for the spline's path to follow. If you want to add a curve to the knot's segment, click and drag to create a knot with tangents.
 
     > [!TIP]
     > When you use the Draw Splines Tool, if you click on the surface of a GameObject, the knot snaps to that surface. Otherwise, the knot snaps to the grid.
-1. To exit the **Draw Splines Tool**, select a tool in the Tools overlay or press Escape.
+1. To exit the **Draw Splines Tool**, select a tool in the **Tools** overlay or press Escape.
+
+## Add to an existing spline container
+
+To add a spline to a GameObject's existing spline container:
+
+1. In the **Scene** view, select your spline GameObject.
+1. From the **Tools** overlay, select the **Spline** context.
+1. From the **Tools** overlay, select **Create Spline**.
+1. Create a new spline. It's added to the existing spline container as a new spline. You can attach it to a knot in the existing spline, or leave it disconnected. 

Documentation~/extrude-component.md

@@ -1,29 +1,58 @@
 # Spline Extrude component reference
 
-Extrude a mesh along a spline to create shapes such as wires, ropes, noodles, and tubes.  
+Use the Spline Extrude component to customize the geometry of the mesh you extrude on a spline. 
 
-The Spline Extrude component requires a GameObject to have a Mesh Filter and Mesh Renderer component. When you add a Spline Extrude component to a GameObject, a Mesh Filter and Mesh Renderer component are added to that GameObject. 
+**Note:** If you add Spline Extrude to a GameObject that already has a mesh, that mesh is replaced with a new one. 
 
-If you add Spline Extrude to a GameObject that already has a mesh, then Spline Extrude removes that mesh from the GameObject and creates a new mesh for the GameObject to use. 
+## Source Spline Container
+
+Select a GameObject that has an attached Spline component you want to extrude a mesh on.
+
+You can use a Spline as a source for the extruded mesh of one or more GameObjects. Edits you make to the source Spline then update those GameObjects. For example, if you want to create a street with a sidewalk, you can create a Spline for the street, and then use the street Spline as a source for a sidewalk GameObject. Any changes you make to the street layout update the sidewalk to match.
+
+## Shape Extrude
+
+| **Property** | | **Description** |
+| --- | --- | --- |
+| **Type** > **Circle**| | Create a shape with a round cross-section. |
+| | **Circle Settings** > **Sides**| Increase to create a smoother surface. The minimum value is `2`. |
+| **Type** > **Square** | | Create a shape with a square cross-section. |
+| **Type** >  **Road** | | Create a shape with a flat cross-section and a slight lip. |
+| **Type** > **Spline Profile** | | Use a different spline as a template for the current spline. |
+| | **Spline Profile Settings** > **Template** |  Select the spline container you want to use as a template. | 
+| | **Spline Profile Settings** > **Spline Index** | If the template container has more than one spline, select the spline you want.| 
+| | **Spline Profile Settings** > **Side Count** | Increase to create a smoother surface. The minimum value is `2`. | 
+| | **Spline Profile Settings** > **Axis** | Which of the template spline axes to follow when drawing this spline. | 
+
+
+## Geometry
+
+| **Property** | **Description** |
+| --- | --- |
+| **Auto Refresh Generation** | Allow the mesh to update at runtime if the spline changes. |
+| **Frequency** | How many times a second to refresh the mesh. |
+| **Radius** | Width of the extrusion, measured from the spline path. |
+| **Segments Per Unit** | Increase the value to create smoother curves. |
+| **Cap Ends** | Fill the ends of an open-ended mesh. |
+| **Flip Normals** | Reveal the inside of the 3D shape. |
+
+## Advanced
+
+| **Property** | **Description** |
+| --- | --- |
+| **Range** | To extrude only some of the spline, define a range. `0` is the first spline point, and `100` is the last one. |
+| **Percentage** | Another way to control the **Range**. |
+| **Update Colliders** | If the spline has a collider, update the collider to match the 3D shape as you change the extrusion properties. |
 
-Use the Spline Extrude component to customize the geometry of the mesh you extrude on the spline. 
- 
 
-| **Property**          | **Description**           |
-| :-------------------- | :------------------------ |
-| **Spline** | Select a GameObject that has an attached Spline component you want to extrude a mesh on. |
-| **Create Mesh Asset** | Create a new mesh asset to attach to this GameObject. </br> This property is visible only if you haven't selected a mesh for the GameObject the Spline Extrude is attached to. | 
-| **Radius**   |  Set the radius of the extruded mesh.   |
-| **Profile Edges**  | Set the number of sides that the radius of the mesh has. The minimum value is 3. | 
-| **Segments Per Unit**  | Set how many edge loops make up the length of one unit of the mesh. |
-| **Cap Ends** | Enable to fill each end of the mesh. If the spline the mesh is extruded on is closed, then this setting has no effect.   |
-| **Range** | Select the section of the spline to extrude the mesh on.    |
-| **Percentage** | Set a percentage of the spline to extrude the mesh on.   |
-| **Auto-Regen Geometry** | Enable to regenerate the extruded mesh when the target spline is modified at runtime or in the Editor. If you don't want the Spline Extrude component to regenerate the extruded mesh at runtime when the target spline is modified, disable **Auto-Regen Geometry**. |
-| **Rebuild Frequency**  | Set the maximum number of times per second that mesh regenerates. This property is visible only when you enable the **Auto-Regen Geometry** method.|
-| **Update Colliders** | Enable to automatically update any attached collider components when the mesh extrudes.   |
+## Mesh Filter and Mesh Renderer components
+
+When you add the Spline Extrude component to a GameObject, the Unity Editor adds two more components that all 3D GameObject need:
+
+* [Mesh Renderer Component](https://docs.unity3d.com/Manual/class-MeshRenderer.html) 
+* [Mesh Filter Component](https://docs.unity3d.com/Manual/class-MeshFilter.html)
 
 ## Additional resources
 
-* [Create a tube-shaped mesh along a spline](extrude-mesh.md)
+* [Create a 3D mesh along a spline](extrude-mesh.md)
 * [Use components](xref:UsingComponents)

Documentation~/extrude-mesh.md

@@ -1,26 +1,13 @@
-# Create a tube-shaped mesh along a spline
+# Create a 3D mesh along a spline
 
 Use the [Spline Extrude](extrude-component.md) component to extrude a mesh along a spline to create shapes such as tubes, wires, ropes, and noodles.  
 
-To create a tube-shaped mesh along a spline:
+To create a 3D mesh along a spline:
 
-1. Do one of the following to create a spline: 
-    * Go to **GameObject** > **Spline** > **Draw Splines Tool**.
-    * In the [Hierarchy window](xref:Hierarchy), right-click and select **Spline** > **Draw Splines Tool**.
-1. Draw a shape for the spline:
-    * Click in the [Scene view](xref:UsingTheSceneView) to create knots for the spline's path to follow.
-    * To add a curve to a knot's segment, click and drag to create a knot with tangents.
-    * To exit the **Draw Splines Tool**, select a tool in the Tools overlay or press Escape.  
+1. [Create a spline](create-a-spline.md).
+1. Add the **Spline Extrude** component to the spline GameObject. This component controls the properties of the extruded mesh. To customize the properties, refer to the [Spline Extrude component reference](extrude-component.md).
+1. Adding a **Spline Extrude** component automatically adds a **Mesh Filter** and **Mesh Renderer** component to the GameObject. These components are necessary for all 3D GameObjects. Refer to [Mesh Renderer Component](https://docs.unity3d.com/Manual/class-MeshRenderer.html) and [Mesh Filter Component](https://docs.unity3d.com/Manual/class-MeshFilter.html) for more information.
 
-    > [!TIP]
-    > You can quickly manipulate the position of knots and tangents. In the [Tools overlay](xref:overlays), set the tool context to **Spline** and make sure that **Draw Splines Tool** is disabled. Select and drag a knot or tangent to move it.
-
-1. Add the **Spline Extrude** component to the GameObject that has the spline you created attached to it. 
-1. In the **Spline Extrude** component, do the following to configure the extruded mesh:
-    * Enter a value for the **Radius** property to set the thickness of the extruded mesh. A higher value creates a thicker mesh and lower value creates a thinner mesh. 
-    * Enter a value for the **Profile Edges** property to select how many sides the radius of the mesh has. 
-    * Enter a value for the **Segments Per Unit** property. If your spline has lot of curves, enter a high value to make the extruded mesh look smoother.  
-    * If your spline isn't closed and you want to fill in the ends of your extruded mesh, enable **Cap Ends**. 
 
 ## Additional resources
 

Documentation~/extrude.md

@@ -1,10 +1,10 @@
 # Extrude a mesh along a spline
 
-Extrude a mesh along a spline to create shapes such as tubes, wires, ropes, and noodles.  
+Extrude a mesh along a spline to create shapes such as tubes, wires, and roads.
 
 To refer to a sample scene that demonstrates how the Spline Extrude component can extrude a mesh along a spline, [import the **Extrude Spline and Nearest Point** sample scene](index.md#import-splines-samples). 
 
 | **Topic**             | **Description**         |
 | :-------------------- | :----------------------- |
-| **[Create a tube-shaped mesh along a spline](extrude-mesh.md)**    | Use the Spline Extrude component to extrude a mesh along a spline. |
+| **[Create a 3D mesh along a spline](extrude-mesh.md)**    | Use the Spline Extrude component to extrude a mesh along a spline. |
 | **[Spline Extrude component reference](extrude-component.md)**  | Understand the properties of the Spline Extrude component.  |

Editor/Components/SplineComponentEditor.cs

@@ -5,7 +5,7 @@
 class SplineComponentEditor : Editor
 {
     static GUIStyle s_FoldoutStyle;
-    
+
     internal static readonly string k_Helpbox = L10n.Tr("Instantiated Objects need a SplineContainer target to be created.");
 
     protected bool Foldout(bool foldout, GUIContent content)