com.unity.polyspatial.extensions@2.3.1

## [2.3.1] - 2025-05-12

Author: Unity Technologies

.signature

@@ -1 +1 @@
-{"timestamp":1741197268,"signature":"XeAwCnJneCAN5NAEciZ1/BkXGD0ARmkaaLk2WE69rBDSepHVxZfo9Zj3wWEAj44ZPbDSAs0GwEPU5iQvmmy27KfxfgKCS3RaXZbXEM335V5Z9gxdL2lEgNCZASBKGkG25Fe+aEB45x3JqIZ/ygp9oJKvu8WpXJkXmOgbfd+pV/1+dpV73qBzMmbIdqBDHrD/0x557ab0Qfufbn0+r+lB0cS437LlCmNxQHwEO7MqO+VtP+S9fxymkpKOJX2MI02NO5YctE9/01/V8QW4K4iMOXx8r6YkoDZZ6AVq7xRUWbxDAEGSwhMVbjDoQQ4yf+6CPsXCQnC5gV+UhGpPSVCjuWbGZNm9rDKxCcp9Z7NDSXHJ6ZIjsGS/p9aQXPgXhagTDJuYH+APl9H914MQc5oIrUKdNjpIKu9GKydRK6kD7KfZMvyT0Pb0IAwsLTk1hoqpNh1hPIrLPQwE77VBIaqwlQjYpCYACe6NGspzgNPEphhMWlvV8q1NznIxYYCEf6Ke","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}
+{"timestamp":1747094220,"signature":"g7xcgMZ6RCFtg3ypkgfgTl8ACd4bMV++TPJT+w6Co8Trmsj/PMcCVx9nn0II0X1StE9/ugI4q5mnUvzY6z+Be7dHnhjddFvogzk1gwxmK9th+SjFY894Si0omibTzGFTTIFyOIhMS0SoQY02H9fVNaSvUtKtvfOrwHFqcCjxLkggUSrORXjHOGjNB63eQhXcG62JaKM5RHss1q/aKI5P2b2xCy4EfLNQwmrlVCfOu9Aew3O/Fz/3RwKi0gy4SKkDYje7xOZBNepc1uO7SuCHkdxIuO6Zq8wvAIAlHOjBpRJFyJd4kIKzyOknT9Yaxf7YxL5TrWWQTmfKJ7uJ74Fg6oGkjEVflUZPwYhhST9fLQxIUgxliFSpglbK4m6KC6h4mnjoFeiRPAeVftuxV+n7+emijxv97SnkE73w0EtcgivhPUSWDPN3UzecX8JSAMC2y0sk29qEB7u6AyOOwJ1G8gkUYOoNOgiA5z9xY+SV0QZ/1OVCNRN3w6xOMESSnnlU","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}

CHANGELOG.md

@@ -7,9 +7,9 @@ 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.2.4] - 2025-03-05
+## [2.3.1] - 2025-05-12
 
-## [2.2.2] - 2025-02-21
+## [2.2.4] - 2025-03-05
 
 ### Fixed
 - Fix compile errors on tvOS.

Editor/DummyEditor.cs

@@ -10,12 +10,13 @@
 
 using Unity.PolySpatial.Extensions;
 
+// This file was present for the first release, even though we are not using it, we can't remove it without breaking API now.
 #if POLYSPATIAL_INTERNAL
 
 namespace PolySpatial.Extensions.Editor
 {
     /// Dummy editor class to make sure editor assembly works
-    public class DummyEditorWindow : EditorWindow
+    internal class DummyEditorWindow : EditorWindow
     {
         bool runRecursively = true;
         bool excludeLeaves = false;
@@ -25,7 +26,7 @@ public class DummyEditorWindow : EditorWindow
         private Vector2 scrollPosition;
 
         [MenuItem("Window/PolySpatial/Dummy Editor")]
-        public static void ShowWindow()
+        internal static void ShowWindow()
         {
             EditorWindow.GetWindow(typeof(DummyEditorWindow), false, "Dummy Editor");
         }
@@ -120,4 +121,4 @@ private void SortSiblings(GameObject[] gos)
     }
 }
 
-#endif
+#endif

Runtime/Entities/PolySpatialEntitiesSystem.cs

@@ -49,7 +49,7 @@ public PolySpatialAssetID GetMeshID(MaterialMeshInfo materialMeshInfo)
     }
     internal static class PolySpatialEntitiesUtils
     {
-        public static PolySpatialInstanceID IdFor(Entity entity) => PolySpatialInstanceID.For((long)entity.Index << 32 | (long)entity.Version);
+        public static long IdFor(Entity entity) => (long)entity.Index << 32 | (long)entity.Version;
     }
 
     internal partial struct PolySpatialEntitiesSystem : ISystem
@@ -71,11 +71,11 @@ internal partial struct PolySpatialEntitiesSystem : ISystem
 
         private NativeList<PolySpatialInstanceID> m_removedEntityIds;
 
-        private NativeList<PolySpatialInstanceID> m_idBuffer;
+        private NativePolySpatialInstanceIDList m_idBuffer;
         private NativeList<Vector3> m_positionBuffer;
         private NativeList<Quaternion> m_rotationBuffer;
         private NativeList<Vector3> m_scaleBuffer;
-        private NativeList<PolySpatialInstanceID> m_parentBuffer;
+        private NativeList<long> m_parentBuffer;
         private ChangeListStructWritable<PolySpatialGameObjectData> m_entityChanges;
 
         private TrackerInstanceIdMap<Entity, EntityTrackingData<PolySpatialMeshMaterialTrackingData>> m_materialMeshTrackerMap;
@@ -154,13 +154,13 @@ public void OnCreate(ref SystemState systemState)
 
             m_newEntityData = new NewEntityData(Allocator.Persistent);
 
-            m_removedEntityIds = new NativeList<PolySpatialInstanceID>(Allocator.Persistent);
+            m_removedEntityIds = new(Allocator.Persistent);
 
-            m_idBuffer = new NativeList<PolySpatialInstanceID>(Allocator.Persistent);
+            m_idBuffer = new(Allocator.Persistent);
             m_positionBuffer = new NativeList<Vector3>(Allocator.Persistent);
             m_rotationBuffer = new NativeList<Quaternion>(Allocator.Persistent);
             m_scaleBuffer = new NativeList<Vector3>(Allocator.Persistent);
-            m_parentBuffer = new NativeList<PolySpatialInstanceID>(Allocator.Persistent);
+            m_parentBuffer = new(Allocator.Persistent);
             m_entityChanges = new ChangeListStructWritable<PolySpatialGameObjectData>(Allocator.Persistent);
 
             m_materialMeshTrackerMap = new TrackerInstanceIdMap<Entity, EntityTrackingData<PolySpatialMeshMaterialTrackingData>>();
@@ -222,11 +222,11 @@ public void OnUpdate(ref SystemState systemState)
 
             systemState.Dependency = new HandleTransformUpdatesJob()
             {
-                IdBuffer = m_idBuffer.AsArray(),
+                IdBuffer = m_idBuffer,
                 PositionBuffer = m_positionBuffer.AsArray(),
                 RotationBuffer = m_rotationBuffer.AsArray(),
                 ScaleBuffer = m_scaleBuffer.AsArray(),
-                ParentBuffer = m_parentBuffer.AsArray()
+                ParentBuffer = m_parentBuffer.AsArray(),
             }.ScheduleParallel(m_updatedTransformsQuery, systemState.Dependency);
 
             systemState.Dependency = new HandleNewMaterialMeshInfosJob()
@@ -275,7 +275,7 @@ public void OnUpdate(ref SystemState systemState)
                 if (!m_newEntityData.ids.IsEmpty)
                 {
                     sim.AddEntitiesWithTransforms(
-                        m_newEntityData.ids.AsArray(),
+                        m_newEntityData.ids.AsPolySpatialInstanceIDSpan(),
                         m_newEntityData.parentIds.AsArray(),
                         m_newEntityData.positions.AsArray(),
                         m_newEntityData.rotations.AsArray(),
@@ -290,8 +290,8 @@ public void OnUpdate(ref SystemState systemState)
 
                 if (!m_idBuffer.IsEmpty)
                 {
-                    sim.OnTransformsChanged(m_idBuffer.AsArray(), m_positionBuffer.AsArray(), m_rotationBuffer.AsArray(), m_scaleBuffer.AsArray());
-                    sim.OnHierarchyChanged(m_idBuffer.AsArray(), m_parentBuffer.AsArray());
+                    sim.OnTransformsChanged(m_idBuffer.AsPolySpatialInstanceIDSpan(), m_positionBuffer.AsArray(), m_rotationBuffer.AsArray(), m_scaleBuffer.AsArray());
+                    sim.OnHierarchyChanged(m_idBuffer.AsPolySpatialInstanceIDSpan(), m_parentBuffer.AsArray());
                 }
 
                 if (!m_materialMeshChanges.IsEmpty)
@@ -495,16 +495,16 @@ private void Execute(Entity e, LocalToWorld ltw)
                 Assert.IsFalse(EntityTrackerMap.IsIgnored(e));
 
                 var trackingData = new EntityTrackingData<PolySpatialGameObjectData>();
-                trackingData.Initialize(PolySpatialEntitiesUtils.IdFor(e), e);
+                trackingData.Initialize(PolySpatialInstanceID.For(PolySpatialEntitiesUtils.IdFor(e)), e);
                 trackingData.customData = new PolySpatialGameObjectData
                 {
                     active = true,
                     layer = 0,
                 };
 
 
-                NewEntityData.ids.Add(trackingData.InstanceId);
-                NewEntityData.parentIds.Add(PolySpatialInstanceID.None);
+                NewEntityData.ids.Add(trackingData.InstanceId.id);
+                NewEntityData.parentIds.Add(PolySpatialInstanceID.None.id);
                 NewEntityData.positions.Add(ltw.Position);
                 NewEntityData.rotations.Add(ltw.Rotation);
                 NewEntityData.scales.Add(ltw.Value.Scale());
@@ -541,11 +541,11 @@ private void Execute(Entity e)
 
         private partial struct HandleTransformUpdatesJob : IJobEntity
         {
-            public NativeArray<PolySpatialInstanceID> IdBuffer;
+            public NativePolySpatialInstanceIDList IdBuffer;
             public NativeArray<Vector3> PositionBuffer;
             public NativeArray<Quaternion> RotationBuffer;
             public NativeArray<Vector3> ScaleBuffer;
-            public NativeArray<PolySpatialInstanceID> ParentBuffer;
+            public NativeArray<long> ParentBuffer;
             private void Execute([EntityIndexInQuery] int entityIndex, in Entity e, [ReadOnly] in LocalToWorld ltw)
             {
                 var id = PolySpatialEntitiesUtils.IdFor(e);
@@ -554,7 +554,7 @@ private void Execute([EntityIndexInQuery] int entityIndex, in Entity e, [ReadOnl
                 PositionBuffer[entityIndex] = mat.Translation();
                 RotationBuffer[entityIndex] = mat.Rotation();
                 ScaleBuffer[entityIndex] = mat.Scale();
-                ParentBuffer[entityIndex] = PolySpatialInstanceID.None;
+                ParentBuffer[entityIndex] = PolySpatialInstanceID.None.id;
             }
         }
 
@@ -588,7 +588,7 @@ public unsafe void Execute(in ArchetypeChunk chunk, int unfilteredChunkIndex, bo
                     ECB.AddComponent<TrackedMaterialMeshInfo>(e);
                     Assert.IsFalse(TrackerMap.IsIgnored(e));
                     if(!TrackerMap.TryGetValueOrDefault(e, out var trackingData))
-                        trackingData.Initialize(PolySpatialEntitiesUtils.IdFor(e), e);
+                        trackingData.Initialize(PolySpatialInstanceID.For(PolySpatialEntitiesUtils.IdFor(e)), e);
                     var mmi = mmis[i];
                     trackingData.customData.meshId = polyRenderMeshArray.GetMeshID(mmi);
 
@@ -603,7 +603,7 @@ public unsafe void Execute(in ArchetypeChunk chunk, int unfilteredChunkIndex, bo
                     {
                         meshId = trackingData.customData.meshId,
                         renderingLayerMask = 1,
-                        materialIds = PolySpatialUtils.GetNativeArrayForBuffer<PolySpatialAssetID>(
+                        materialIds = PolySpatialUtils.GetTempNativeArrayForBuffer<PolySpatialAssetID>(
                             UnsafeUtility.AddressOf(ref trackingData.customData.materials.materialIds.ElementAt(0)),
                             trackingData.customData.materials.materialIds.Length)
                     });
@@ -664,8 +664,8 @@ private struct NewEntityData
         {
             public NewEntityData(Allocator allocator)
             {
-                ids = new NativeList<PolySpatialInstanceID>(allocator);
-                parentIds = new NativeList<PolySpatialInstanceID>(allocator);
+                ids = new(allocator);
+                parentIds = new(allocator);
                 positions = new NativeList<Vector3>(allocator);
                 rotations = new NativeList<Quaternion>(allocator);
                 scales = new NativeList<Vector3>(allocator);
@@ -692,8 +692,8 @@ public void Clear()
                 data.Clear();
             }
 
-            public NativeList<PolySpatialInstanceID> ids;
-            public NativeList<PolySpatialInstanceID> parentIds;
+            public NativePolySpatialInstanceIDList ids;
+            public NativeList<long> parentIds;
             public NativeList<Vector3> positions;
             public NativeList<Quaternion> rotations;
             public NativeList<Vector3> scales;

Tests/Runtime/EntitiesTests.cs

@@ -133,7 +133,7 @@ public IEnumerator SpawnAndDestroyEntities()
             for (var i = 0; i < entityCount; i++)
             {
                 Debug.Log(spawnedEntities[i].Version);
-                Assert.IsTrue(PolySpatialEntitiesUtils.IdFor(spawnedEntities[i]) != PolySpatialInstanceID.None);
+                Assert.IsTrue(PolySpatialEntitiesUtils.IdFor(spawnedEntities[i]) != PolySpatialInstanceID.None.id);
             }
 
             var destroyJob = new DestroyEntitiesJob
@@ -165,4 +165,3 @@ public IEnumerator SpawnAndDestroyEntities()
         }
     }
 }
-

Tests/Runtime/Unity.PolySpatial.Extensions.Runtime.Tests.asmdef

@@ -12,7 +12,8 @@
         "Unity.Collections",
         "Unity.Polyspatial.Entities",
         "Unity.PolySpatial.Core",
-        "Unity.Burst"
+        "Unity.Burst",
+        "Unity.PolySpatial.FunctionalTests.Runtime.Tests"
     ],
     "includePlatforms": [],
     "excludePlatforms": [],

Tests/Runtime/UtilsTests.cs

@@ -1,4 +1,5 @@
 using NUnit.Framework;
+using Unity.PolySpatial.Internals;
 using UnityEngine;
 
 namespace Unity.PolySpatial.Extensions.RuntimeTests
@@ -25,5 +26,17 @@ public void Utils_LexicalCompare(string a, string b, int expected)
         {
             Assert.AreEqual(expected, Utils.LexicalCompare(a, b));
         }
+
+        /// <summary>
+        /// Will ignore if the test is for generic tracker, and the generic tracker is not enabled, and vice versa.
+        /// </summary>
+        public static void AssertIgnore_CheckGenericTrackerEnabled(bool IsGenericTrackerTest)
+        {
+            if (IsGenericTrackerTest && !PolySpatialUnityTracker.GenericTrackerEnabled)
+                Assert.Ignore("Generic tracker test ignored because generic tracking is not enabled.");
+
+            if (!IsGenericTrackerTest && PolySpatialUnityTracker.GenericTrackerEnabled)
+                Assert.Ignore("Non-generic tracker test ignored because generic tracking is enabled.");
+        }
     }
 }

Tests/Runtime/ValidationTests.cs

@@ -8,6 +8,11 @@ namespace Unity.PolySpatial.Extensions.RuntimeTests
     [TestFixture]
     class ValidationTests
     {
+        /// <summary>
+        /// Override and return true if tests rely on GenericTracker to be enabled
+        /// </summary>
+        protected virtual bool IsGenericTrackerTest => false;
+
         [TestCase("Shader Graphs/FlatStereoscropicProjected")]
         [TestCase("Shader Graphs/DepthReprojection")]
         [TestCase("Shader Graphs/FlatStereoscropicStatic")]
@@ -31,12 +36,14 @@ public void PolySpatialStereoFramebufferCamera_Shaders(string shaderName)
         [SetUp]
         public void Setup()
         {
+            UtilsTests.AssertIgnore_CheckGenericTrackerEnabled(IsGenericTrackerTest);
             CreateStereoCamera();
         }
 
         [TearDown]
         public void TearDown()
         {
+            UtilsTests.AssertIgnore_CheckGenericTrackerEnabled(IsGenericTrackerTest);
             if (m_StereoCameraGO != null)
                 GameObject.DestroyImmediate(m_StereoCameraGO);
         }

package.json

@@ -1 +1 @@
-{"name":"com.unity.polyspatial.extensions","displayName":"PolySpatial Extensions","version":"2.2.4","unity":"6000.0","unityRelease":"22f1","description":"The PolySpatial Extensions package offers a range of additional features that may prove useful to some users enhancing the overall functionality of the PolySpatial package.\nUnity PolySpatial and visionOS support is only available to Unity Pro, Unity Enterprise, and Unity Industry users. Learn more about these plans at unity.com/pricing.","dependencies":{"com.unity.polyspatial":"2.2.4","com.unity.entities":"1.2.4","com.unity.entities.graphics":"1.2.4","com.unity.polyspatial.xr":"2.2.4","com.unity.xr.management":"4.5.0","com.unity.render-pipelines.universal":"17.0.3","com.unity.inputsystem":"1.10.0"},"samples":[{"displayName":"Stereo Render Target Samples","description":"A set of samples showcasing stereo render targets with PolySpatial.","path":"Samples~/StereoRenderer"}],"repository":{"revision":"de9c8af9ae66ad98a786499ecf64083e376562b5","type":"git","url":"https://github.cds.internal.unity3d.com/unity/polyspatial.git"},"documentationUrl":"https://docs.unity3d.com/Packages/com.unity.polyspatial.extensions@2.2/manual/index.html"}
+{"name":"com.unity.polyspatial.extensions","displayName":"PolySpatial Extensions","version":"2.3.1","unity":"6000.0","unityRelease":"22f1","description":"The PolySpatial Extensions package offers a range of additional features that may prove useful to some users enhancing the overall functionality of the PolySpatial package.\nUnity PolySpatial and visionOS support is only available to Unity Pro, Unity Enterprise, and Unity Industry users. Learn more about these plans at unity.com/pricing.","dependencies":{"com.unity.polyspatial":"2.3.1","com.unity.entities":"1.2.4","com.unity.entities.graphics":"1.2.4","com.unity.polyspatial.xr":"2.3.1","com.unity.xr.management":"4.5.0","com.unity.render-pipelines.universal":"17.0.3","com.unity.inputsystem":"1.10.0"},"samples":[{"displayName":"Stereo Render Target Samples","description":"A set of samples showcasing stereo render targets with PolySpatial.","path":"Samples~/StereoRenderer"}],"repository":{"revision":"35637bcda17b346ee6e16363f2c503714a7c6df0","type":"git","url":"https://github.cds.internal.unity3d.com/unity/polyspatial.git"},"documentationUrl":"https://docs.unity3d.com/Packages/com.unity.polyspatial.extensions@2.3/manual/index.html"}