< Summary

Information
Class: Gravitas.PhysicsPartition2D
Assembly: Gravitas
File(s): /home/runner/work/Gravitas/Gravitas/src/Gravitas/Partitions/2D/PhysicsPartition2D.cs
Line coverage
100%
Covered lines: 161
Uncovered lines: 0
Coverable lines: 161
Total lines: 354
Line coverage: 100%
Branch coverage
100%
Covered branches: 114
Total branches: 114
Branch coverage: 100%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
.ctor()100%11100%
get_IsAllocated()100%11100%
get_DynamicObjectCount()100%22100%
get_KinematicObjectCount()100%22100%
get_StaticObjectCount()100%22100%
get_IsEmpty()100%44100%
get_EmptySinceFrame()100%11100%
get_RetainedIndex()100%11100%
get_AwakeDynamicObjectCount()100%22100%
get_Owner()100%11100%
OnAddToVoxel(...)100%11100%
Distribute(...)100%1818100%
CopyAllColliderIds(...)100%11100%
CopyStaticStyleColliderIds(...)100%11100%
CopyIds(...)100%44100%
AddDynamicObject(...)100%66100%
AddStaticObject(...)100%44100%
AddKinematicObject(...)100%44100%
RemoveDynamicObject(...)100%1010100%
RemoveStaticObject(...)100%66100%
RemoveKinematicObject(...)100%66100%
ContainsAwakeDynamicObject(...)100%22100%
SetDynamicObjectAwake(...)100%1010100%
IsDynamicObjectAwake(...)100%44100%
OnRemoveFromVoxel(...)100%11100%
SetOwner(...)100%22100%
IsOwnedBy(...)100%11100%
SetRetainedIndex(...)100%11100%
ClearRetainedIndex()100%11100%
ResetRetainedMembership()100%1010100%
ResetForPool()100%1010100%
MarkOccupied()100%22100%
MarkEmptyIfUnoccupied()100%22100%
MarkEmpty(...)100%22100%
SetParentIndex(...)100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_RetainedIndex()100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_EmptyIndex()100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.set_EmptyIndex(...)100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_IsEmpty()100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_EmptySinceFrame()100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.IsOwnedBy(...)100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.SetRetainedIndex(...)100%11100%
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.ClearRetainedIndex()100%11100%

File(s)

/home/runner/work/Gravitas/Gravitas/src/Gravitas/Partitions/2D/PhysicsPartition2D.cs

#LineLine coverage
 1//=======================================================================
 2// PhysicsPartition2D.cs
 3//=======================================================================
 4// MIT License, Copyright (c) 2026-present David Oravsky (mrdav30)
 5// See LICENSE file in the project root for full license information.
 6//=======================================================================
 7
 8using System.Runtime.CompilerServices;
 9using Gravitas.Colliders;
 10using GridForge.Grids;
 11using GridForge.Spatial;
 12using SwiftCollections;
 13
 14namespace Gravitas;
 15
 16/// <summary>
 17/// Stores the pure 2D collider IDs assigned to one GridForge voxel.
 18/// </summary>
 19public sealed class PhysicsPartition2D : IVoxelPartition, IRetainedPhysicsPartition<GravitasCollision2DService>
 20{
 21    private GravitasCollision2DService? _owner;
 11726922    private long _emptySinceFrame = -1;
 11726923    private int _retainedIndex = -1;
 24
 25    /// <summary>Creates an inactive 2D physics partition.</summary>
 11726926    public PhysicsPartition2D()
 27    {
 11726928        ActivationId = -1;
 11726929    }
 30
 31    /// <summary>Gets or sets the world voxel occupied by this partition.</summary>
 32    public WorldVoxelIndex WorldIndex { get; set; }
 33
 34    /// <summary>Gets or sets whether this partition is attached to a voxel.</summary>
 35    public bool IsPartitioned { get; set; }
 36
 37    /// <summary>Stores context-local dynamic collider IDs.</summary>
 38    internal SwiftHashSet<int>? ContainedDynamicObjects;
 39
 40    /// <summary>Stores the awake subset of the dynamic collider IDs.</summary>
 41    internal SwiftHashSet<int>? ContainedAwakeDynamicObjects;
 42
 43    /// <summary>Stores context-local kinematic collider IDs.</summary>
 44    internal SwiftHashSet<int>? ContainedKinematicObjects;
 45
 46    /// <summary>Stores context-local static collider IDs.</summary>
 47    internal SwiftHashSet<int>? ContainedStaticObjects;
 48
 49    /// <summary>Gets the active-partition slot, or <c>-1</c> when inactive.</summary>
 50    public int ActivationId { get; private set; }
 51
 52    /// <summary>Gets whether this partition has an active-partition slot.</summary>
 24059653    public bool IsAllocated => ActivationId != -1;
 54
 55    /// <summary>Gets the number of dynamic collider IDs, including sleeping bodies.</summary>
 201355656    public int DynamicObjectCount => ContainedDynamicObjects?.Count ?? 0;
 57
 58    /// <summary>Gets the number of kinematic collider IDs.</summary>
 146254959    public int KinematicObjectCount => ContainedKinematicObjects?.Count ?? 0;
 60
 61    /// <summary>Gets the number of static collider IDs.</summary>
 142739362    public int StaticObjectCount => ContainedStaticObjects?.Count ?? 0;
 63
 201350164    internal bool IsEmpty => DynamicObjectCount == 0 && KinematicObjectCount == 0 && StaticObjectCount == 0;
 65
 18581966    internal long EmptySinceFrame => _emptySinceFrame;
 67
 54156768    internal int RetainedIndex => _retainedIndex;
 69
 70    internal int EmptyIndex { get; set; } = -1;
 71
 72    /// <summary>Gets the number of awake dynamic IDs in this partition.</summary>
 12473    public int AwakeDynamicObjectCount => ContainedAwakeDynamicObjects?.Count ?? 0;
 74
 75    /// <summary>Gets the collision service that owns this partition.</summary>
 76    public GravitasCollision2DService Owner
 77    {
 78        get
 79        {
 50863780            ChronicleGuard.ThrowIfTrue(
 50863781                _owner == null,
 50863782                nameof(PhysicsPartition2D),
 50863783                "PhysicsPartition2D is missing its owner collision service.");
 50863584            return _owner!;
 85        }
 86    }
 87
 88    /// <summary>Attaches this partition to a voxel.</summary>
 89    public void OnAddToVoxel(Voxel voxel)
 90    {
 12384991        ChronicleGuard.ThrowIfTrue(
 12384992            _owner == null,
 12384993            nameof(PhysicsPartition2D),
 12384994            "PhysicsPartition2D is missing its owner collision service.");
 12384995        WorldIndex = voxel.WorldIndex;
 12384996        IsPartitioned = true;
 12384997    }
 98
 99    internal void Distribute(
 100        SwiftList<int> dynamicIds,
 101        SwiftList<int> staticIds)
 102    {
 91731103        int dynamicCount = ContainedDynamicObjects?.Count ?? 0;
 91731104        int awakeDynamicCount = ContainedAwakeDynamicObjects?.Count ?? 0;
 91731105        if (ContainedDynamicObjects == null || dynamicCount == 0 || ContainedAwakeDynamicObjects == null || awakeDynamic
 8333106            return;
 107
 83398108        dynamicIds.FastClear();
 83398109        CopyIds(ContainedDynamicObjects, dynamicIds);
 83398110        dynamicIds.SortInPlace();
 83398111        CopyStaticStyleColliderIds(staticIds);
 112
 340208113        for (int j = 0; j < dynamicIds.Count; j++)
 114        {
 86706115            int id1 = dynamicIds[j];
 181330116            for (int k = j + 1; k < dynamicIds.Count; k++)
 3959117                Owner.Context.Physics2D.ProcessPartitionCandidate(id1, dynamicIds[k], WorldIndex);
 118
 218876119            for (int k = 0; k < staticIds.Count; k++)
 22732120                Owner.Context.Physics2D.ProcessPartitionCandidate(id1, staticIds[k], WorldIndex);
 121        }
 83398122    }
 123
 124    /// <summary>Clears and fills caller-owned storage with all collider IDs in ascending order.</summary>
 125    public void CopyAllColliderIds(SwiftList<int> destination)
 126    {
 7127        ChronicleGuard.ThrowIfNull(destination, nameof(destination));
 6128        destination.FastClear();
 6129        CopyIds(ContainedDynamicObjects, destination);
 6130        CopyIds(ContainedKinematicObjects, destination);
 6131        CopyIds(ContainedStaticObjects, destination);
 6132        destination.SortInPlace();
 6133    }
 134
 135    internal void CopyStaticStyleColliderIds(SwiftList<int> destination)
 136    {
 83400137        destination.FastClear();
 83400138        CopyIds(ContainedKinematicObjects, destination);
 83400139        CopyIds(ContainedStaticObjects, destination);
 83400140        destination.SortInPlace();
 83400141    }
 142
 143    private static void CopyIds(SwiftHashSet<int>? source, SwiftList<int> destination)
 144    {
 250216145        if (source == null)
 147291146            return;
 147
 420384148        foreach (int id in source)
 107267149            destination.Add(id);
 102925150    }
 151
 152    /// <summary>Adds a dynamic collider ID to this partition.</summary>
 153    public void AddDynamicObject(int item)
 154    {
 120907155        ChronicleGuard.ThrowIfNegative(item, nameof(item));
 120906156        ContainedDynamicObjects ??= new();
 120906157        if (!ContainedDynamicObjects.Add(item))
 63929158            return;
 159
 56977160        MarkOccupied();
 56977161        SetDynamicObjectAwake(item, IsDynamicObjectAwake(item));
 162
 56977163        if (ContainedDynamicObjects.Count == 1)
 53329164            ActivationId = Owner.ActivatePartition(this);
 56977165    }
 166
 167    /// <summary>Adds a static collider ID to this partition.</summary>
 168    public void AddStaticObject(int item)
 169    {
 79153170        ChronicleGuard.ThrowIfNegative(item, nameof(item));
 79152171        ContainedStaticObjects ??= new();
 79152172        if (ContainedStaticObjects.Add(item))
 78678173            MarkOccupied();
 79152174    }
 175
 176    /// <summary>Adds a kinematic collider ID to this partition.</summary>
 177    public void AddKinematicObject(int item)
 178    {
 11651179        ChronicleGuard.ThrowIfNegative(item, nameof(item));
 11650180        ContainedKinematicObjects ??= new();
 11650181        if (ContainedKinematicObjects.Add(item))
 10522182            MarkOccupied();
 11650183    }
 184
 185    /// <summary>Removes a dynamic collider ID from this partition.</summary>
 186    public void RemoveDynamicObject(int item)
 187    {
 10521188        if (ContainedDynamicObjects?.Remove(item) != true)
 189        {
 4190            GravitasLogger.DebugChannel.Info($"2D dynamic item not removed - {item}");
 4191            return;
 192        }
 193
 10517194        ContainedAwakeDynamicObjects?.Remove(item);
 195
 10517196        if (ContainedDynamicObjects.Count > 0)
 1732197            return;
 198
 8785199        Owner.DeactivatePartition(ActivationId);
 8785200        ActivationId = -1;
 8785201        MarkEmptyIfUnoccupied();
 8785202    }
 203
 204    /// <summary>Removes a static collider ID from this partition.</summary>
 205    public void RemoveStaticObject(int item)
 206    {
 4727207        if (ContainedStaticObjects?.Remove(item) != true)
 208        {
 5209            GravitasLogger.DebugChannel.Info($"2D static item not removed - {item}");
 5210            return;
 211        }
 212
 4722213        MarkEmptyIfUnoccupied();
 4722214    }
 215
 216    /// <summary>Removes a kinematic collider ID from this partition.</summary>
 217    public void RemoveKinematicObject(int item)
 218    {
 6906219        if (ContainedKinematicObjects?.Remove(item) != true)
 220        {
 5221            GravitasLogger.DebugChannel.Info($"2D kinematic item not removed - {item}");
 5222            return;
 223        }
 224
 6901225        MarkEmptyIfUnoccupied();
 6901226    }
 227
 228    /// <summary>Returns whether a dynamic collider ID is marked awake.</summary>
 16229    public bool ContainsAwakeDynamicObject(int item) => ContainedAwakeDynamicObjects?.Contains(item) == true;
 230
 231    /// <summary>Updates the awake state for a dynamic collider in this partition.</summary>
 232    public void SetDynamicObjectAwake(int item, bool awake)
 233    {
 196689234        if (ContainedDynamicObjects?.Contains(item) != true)
 2235            return;
 236
 196687237        if (awake)
 238        {
 188712239            ContainedAwakeDynamicObjects ??= new();
 188712240            ContainedAwakeDynamicObjects.Add(item);
 188712241            return;
 242        }
 243
 7975244        ContainedAwakeDynamicObjects?.Remove(item);
 7357245    }
 246
 247    private bool IsDynamicObjectAwake(int item)
 248    {
 56977249        if (!Owner.Context.Physics2D.TryGetColliderById(item, out LSCollider2D? collider))
 291250            return true;
 251
 56686252        SolidBody2D? body = collider!.Body;
 56686253        return body == null || body.IsAwakeForCollision;
 254    }
 255
 256    /// <summary>Releases this partition when it is removed from a voxel.</summary>
 257    public void OnRemoveFromVoxel(Voxel voxel)
 258    {
 123849259        Owner.ReleasePartition(this);
 123849260    }
 261
 262    internal void SetOwner(GravitasCollision2DService owner)
 263    {
 123869264        ChronicleGuard.ThrowIfNull(owner, nameof(owner));
 123869265        ChronicleGuard.ThrowIfArgument(
 123869266            _owner != null && !ReferenceEquals(_owner, owner),
 123869267            nameof(owner),
 123869268            "PhysicsPartition2D is already owned by a different collision service.");
 269
 123868270        _owner = owner;
 123868271    }
 272
 1749191273    internal bool IsOwnedBy(GravitasCollision2DService owner) => ReferenceEquals(_owner, owner);
 274
 275    [MethodImpl(MethodImplOptions.AggressiveInlining)]
 276    internal void SetRetainedIndex(int index)
 277    {
 197825278        ChronicleGuard.ThrowIfNegative(index, nameof(index));
 197825279        _retainedIndex = index;
 197825280    }
 281
 282    [MethodImpl(MethodImplOptions.AggressiveInlining)]
 123855283    internal void ClearRetainedIndex() => _retainedIndex = -1;
 284
 285    internal void ResetRetainedMembership()
 286    {
 6287        ContainedDynamicObjects?.Clear();
 6288        ContainedAwakeDynamicObjects?.Clear();
 6289        ContainedKinematicObjects?.Clear();
 6290        ContainedStaticObjects?.Clear();
 6291        ActivationId = -1;
 6292        MarkEmpty(_owner?.Context.FrameCount ?? 0);
 6293    }
 294
 295    internal void ResetForPool()
 296    {
 123858297        ContainedDynamicObjects?.Clear();
 123858298        ContainedAwakeDynamicObjects?.Clear();
 123858299        ContainedKinematicObjects?.Clear();
 123858300        ContainedStaticObjects?.Clear();
 301
 123858302        if (ActivationId != -1)
 44540303            Owner.DeactivatePartition(ActivationId);
 304
 123858305        _owner = null;
 123858306        ActivationId = -1;
 123858307        IsPartitioned = false;
 123858308        _emptySinceFrame = -1;
 123858309        _retainedIndex = -1;
 123858310        EmptyIndex = -1;
 123858311    }
 312
 313    [MethodImpl(MethodImplOptions.AggressiveInlining)]
 314    private void MarkOccupied()
 315    {
 146177316        _emptySinceFrame = -1;
 146177317        _owner?.RefreshRetainedPartitionEligibility(this);
 146174318    }
 319
 320    [MethodImpl(MethodImplOptions.AggressiveInlining)]
 321    private void MarkEmptyIfUnoccupied()
 322    {
 20408323        if (IsEmpty)
 17279324            MarkEmpty(Owner.Context.FrameCount);
 20408325    }
 326
 327    [MethodImpl(MethodImplOptions.AggressiveInlining)]
 328    private void MarkEmpty(long frame)
 329    {
 17285330        _emptySinceFrame = frame;
 17285331        _owner?.RefreshRetainedPartitionEligibility(this);
 17282332    }
 333
 334    /// <summary>Updates the world voxel index used by this partition.</summary>
 123849335    public void SetParentIndex(WorldVoxelIndex parentIndex) => WorldIndex = parentIndex;
 336
 541566337    int IRetainedPhysicsPartition<GravitasCollision2DService>.RetainedIndex => RetainedIndex;
 338
 339    int IRetainedPhysicsPartition<GravitasCollision2DService>.EmptyIndex
 340    {
 411169341        get => EmptyIndex;
 423335342        set => EmptyIndex = value;
 343    }
 344
 1746401345    bool IRetainedPhysicsPartition<GravitasCollision2DService>.IsEmpty => IsEmpty;
 346
 185810347    long IRetainedPhysicsPartition<GravitasCollision2DService>.EmptySinceFrame => EmptySinceFrame;
 348
 1749191349    bool IRetainedPhysicsPartition<GravitasCollision2DService>.IsOwnedBy(GravitasCollision2DService owner) => IsOwnedBy(
 350
 197825351    void IRetainedPhysicsPartition<GravitasCollision2DService>.SetRetainedIndex(int index) => SetRetainedIndex(index);
 352
 123855353    void IRetainedPhysicsPartition<GravitasCollision2DService>.ClearRetainedIndex() => ClearRetainedIndex();
 354}

Methods/Properties

.ctor()
get_IsAllocated()
get_DynamicObjectCount()
get_KinematicObjectCount()
get_StaticObjectCount()
get_IsEmpty()
get_EmptySinceFrame()
get_RetainedIndex()
get_AwakeDynamicObjectCount()
get_Owner()
OnAddToVoxel(GridForge.Grids.Voxel)
Distribute(SwiftCollections.SwiftList`1<System.Int32>,SwiftCollections.SwiftList`1<System.Int32>)
CopyAllColliderIds(SwiftCollections.SwiftList`1<System.Int32>)
CopyStaticStyleColliderIds(SwiftCollections.SwiftList`1<System.Int32>)
CopyIds(SwiftCollections.SwiftHashSet`1<System.Int32>,SwiftCollections.SwiftList`1<System.Int32>)
AddDynamicObject(System.Int32)
AddStaticObject(System.Int32)
AddKinematicObject(System.Int32)
RemoveDynamicObject(System.Int32)
RemoveStaticObject(System.Int32)
RemoveKinematicObject(System.Int32)
ContainsAwakeDynamicObject(System.Int32)
SetDynamicObjectAwake(System.Int32,System.Boolean)
IsDynamicObjectAwake(System.Int32)
OnRemoveFromVoxel(GridForge.Grids.Voxel)
SetOwner(Gravitas.GravitasCollision2DService)
IsOwnedBy(Gravitas.GravitasCollision2DService)
SetRetainedIndex(System.Int32)
ClearRetainedIndex()
ResetRetainedMembership()
ResetForPool()
MarkOccupied()
MarkEmptyIfUnoccupied()
MarkEmpty(System.Int64)
SetParentIndex(GridForge.Spatial.WorldVoxelIndex)
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_RetainedIndex()
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_EmptyIndex()
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.set_EmptyIndex(System.Int32)
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_IsEmpty()
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.get_EmptySinceFrame()
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.IsOwnedBy(Gravitas.GravitasCollision2DService)
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.SetRetainedIndex(System.Int32)
Gravitas.IRetainedPhysicsPartition<Gravitas.GravitasCollision2DService>.ClearRetainedIndex()