Merge branch 'main' of https://github.com/DCFApixels/DragonECS-Graphs

src/Builtin/EcsGraphWorld.cs

@@ -1,7 +1,6 @@
-using DCFApixels.DragonECS;
+using System.Diagnostics;
-using System.Diagnostics;
 
-namespace DCFApixels.Assets.Plugins.DragonECS_Graphs.src.Builtin
+namespace DCFApixels.DragonECS
 {
     /// <summary> EcsWrold for store regular game entities. </summary>
     [MetaColor(MetaColor.DragonRose)]

src/EntityGraph.cs

@@ -236,10 +236,10 @@ namespace DCFApixels.DragonECS
             #region Callbacks
             public void OnReleaseDelEntityBuffer(ReadOnlySpan<int> delEntities)
             {
-                EcsSubGraph subGraph;
+                SubGraphMap subGraph;
                 EcsWorld graphWorld = _graph._graphWorld;
 
-                subGraph = graphWorld.JoinToSubGraph(EcsSubGraphMode.All);
+                subGraph = graphWorld.Join(JoinMode.All);
                 foreach (var sourceE in delEntities)
                 {
                     var relEs = subGraph.GetRelations(sourceE);

src/EntityGraphExtensions.cs

@@ -71,6 +71,15 @@ namespace DCFApixels.DragonECS
             Throw.UndefinedException();
             return null;
         }
+        public static EcsWorld GetGraphWorld(this EcsWorld self)
+        {
+            if (self.TryGetGraph(out EntityGraph graph))
+            {
+                return graph.GraphWorld;
+            }
+            Throw.UndefinedException();
+            return null;
+        }
 
         public static bool IsGraphWorld(this EcsWorld self)
         {

src/Executors/GraphQueries.cs

@@ -6,56 +6,56 @@ namespace DCFApixels.DragonECS
     public static class GraphQueriesExtensions
     {
         #region JoinToGraph Empty
-        public static EcsSubGraph JoinToSubGraph(this EcsWorld entities, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap Join(this EcsWorld entities, JoinMode mode = JoinMode.Start)
         {
-            entities.GetQueryCache(out JoinToSubGraphExecutor executor, out EmptyAspect _);
+            entities.GetQueryCache(out JoinExecutor executor, out EmptyAspect _);
             return executor.Execute(mode);
         }
         #endregion
 
         #region JoinToGraph Mask
-        public static EcsSubGraph JoinToSubGraph<TCollection>(this TCollection entities, IComponentMask mask, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap Join<TCollection>(this TCollection entities, IComponentMask mask, JoinMode mode = JoinMode.Start)
             where TCollection : IEntityStorage
         {
             if (ReferenceEquals(entities, entities.World))
             {
-                var executor = entities.World.GetExecutorForMask<JoinToSubGraphExecutor>(mask);
+                var executor = entities.World.GetExecutorForMask<JoinExecutor>(mask);
                 return executor.Execute();
             }
-            return entities.ToSpan().JoinToSubGraph(mask, mode);
+            return entities.ToSpan().JoinSubGraph(mask, mode);
         }
-        public static EcsSubGraph JoinToSubGraph(this EcsReadonlyGroup group, IComponentMask mask, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap Join(this EcsReadonlyGroup group, IComponentMask mask, JoinMode mode = JoinMode.Start)
         {
-            return group.ToSpan().JoinToSubGraph(mask, mode);
+            return group.ToSpan().JoinSubGraph(mask, mode);
         }
-        public static EcsSubGraph JoinToSubGraph(this EcsSpan span, IComponentMask mask, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap JoinSubGraph(this EcsSpan span, IComponentMask mask, JoinMode mode = JoinMode.Start)
         {
-            var executor = span.World.GetExecutorForMask<JoinToSubGraphExecutor>(mask);
+            var executor = span.World.GetExecutorForMask<JoinExecutor>(mask);
             return executor.ExecuteFor(span, mode);
         }
         #endregion
 
         #region JoinToGraph
-        public static EcsSubGraph JoinToSubGraph<TCollection, TAspect>(this TCollection entities, out TAspect aspect, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap Join<TCollection, TAspect>(this TCollection entities, out TAspect aspect, JoinMode mode = JoinMode.Start)
             where TAspect : EcsAspect, new()
             where TCollection : IEntityStorage
         {
             if (ReferenceEquals(entities, entities.World))
             {
-                entities.World.GetQueryCache(out JoinToSubGraphExecutor executor, out aspect);
+                entities.World.GetQueryCache(out JoinExecutor executor, out aspect);
                 return executor.Execute();
             }
-            return entities.ToSpan().JoinToSubGraph(out aspect, mode);
+            return entities.ToSpan().Join(out aspect, mode);
         }
-        public static EcsSubGraph JoinToSubGraph<TAspect>(this EcsReadonlyGroup group, out TAspect aspect, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap JoinSubGraph<TAspect>(this EcsReadonlyGroup group, out TAspect aspect, JoinMode mode = JoinMode.Start)
             where TAspect : EcsAspect, new()
         {
-            return group.ToSpan().JoinToSubGraph(out aspect, mode);
+            return group.ToSpan().Join(out aspect, mode);
         }
-        public static EcsSubGraph JoinToSubGraph<TAspect>(this EcsSpan span, out TAspect aspect, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public static SubGraphMap Join<TAspect>(this EcsSpan span, out TAspect aspect, JoinMode mode = JoinMode.Start)
             where TAspect : EcsAspect, new()
         {
-            span.World.GetQueryCache(out JoinToSubGraphExecutor executor, out aspect);
+            span.World.GetQueryCache(out JoinExecutor executor, out aspect);
             return executor.ExecuteFor(span, mode);
         }
         #endregion

src/Executors/JoinToSubGraphExecutor.cs

@@ -3,12 +3,13 @@ using DCFApixels.DragonECS.Graphs.Internal;
 using DCFApixels.DragonECS.UncheckedCore;
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Runtime.CompilerServices;
 using LinkedList = DCFApixels.DragonECS.Graphs.Internal.OnlyAppendHeadLinkedList;
 
 namespace DCFApixels.DragonECS.Graphs.Internal
 {
-    internal sealed class JoinToSubGraphExecutor : MaskQueryExecutor, IEcsWorldEventListener
+    internal sealed class JoinExecutor : MaskQueryExecutor, IEcsWorldEventListener
     {
         private EntityGraph _graph;
         private EcsMaskIterator _iterator;
@@ -62,6 +63,11 @@ namespace DCFApixels.DragonECS.Graphs.Internal
         #region OnInitialize/OnDestroy
         protected override void OnInitialize()
         {
+            if (World.IsGraphWorld() == false)
+            {
+                Throw.Exception("The JounSubGraph query can only be used for EntityGraph.GraphWorld or a collection of that world.");
+            }
+
             _versionsChecker = new WorldStateVersionsChecker(Mask);
             _linkedList = new OnlyAppendHeadLinkedList(World.Capacity);
             _linkedListSourceHeads = new LinkedListHead[World.Capacity];
@@ -81,7 +87,7 @@ namespace DCFApixels.DragonECS.Graphs.Internal
 
         #region Execute
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        private EcsSubGraph Execute_Internal(EcsSubGraphMode mode)
+        private SubGraphMap Execute_Internal(JoinMode mode)
         {
             //_executeMarker.Begin();
 
@@ -121,14 +127,14 @@ namespace DCFApixels.DragonECS.Graphs.Internal
             _linkedList.Clear();
 
             //Заполнение массивов
-            if ((mode & EcsSubGraphMode.StartToEnd) != 0)
+            if ((mode & JoinMode.Start) != 0)
             {
                 for (int i = 0; i < _filteredAllEntitiesCount; i++)
                 {
                     AddStart(_filteredAllEntities[i]);
                 }
             }
-            if ((mode & EcsSubGraphMode.EndToStart) != 0)
+            if ((mode & JoinMode.End) != 0)
             {
                 for (int i = 0; i < _filteredAllEntitiesCount; i++)
                 {
@@ -140,10 +146,10 @@ namespace DCFApixels.DragonECS.Graphs.Internal
             _version++;
 
             //_executeMarker.End();
-            return new EcsSubGraph(this);
+            return new SubGraphMap(this);
         }
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        private EcsSubGraph ExecuteFor_Internal(EcsSpan span, EcsSubGraphMode mode)
+        private SubGraphMap ExecuteFor_Internal(EcsSpan span, JoinMode mode)
         {
             //_executeMarker.Begin();
 #if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_ASSERT_CHEKS
@@ -184,14 +190,14 @@ namespace DCFApixels.DragonECS.Graphs.Internal
             _linkedList.Clear();
 
             //Заполнение массивов
-            if ((mode & EcsSubGraphMode.StartToEnd) != 0)
+            if ((mode & JoinMode.Start) != 0)
             {
                 for (int i = 0; i < _filteredEntitiesCount; i++)
                 {
                     AddStart(_filteredEntities[i]);
                 }
             }
-            if ((mode & EcsSubGraphMode.EndToStart) != 0)
+            if ((mode & JoinMode.End) != 0)
             {
                 for (int i = 0; i < _filteredEntitiesCount; i++)
                 {
@@ -201,14 +207,14 @@ namespace DCFApixels.DragonECS.Graphs.Internal
 
 
             //_executeMarker.End();
-            return new EcsSubGraph(this);
+            return new SubGraphMap(this);
         }
 
-        public EcsSubGraph Execute(EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public SubGraphMap Execute(JoinMode mode = JoinMode.Start)
         {
             return Execute_Internal(mode);
         }
-        public EcsSubGraph ExecuteFor(EcsSpan span, EcsSubGraphMode mode = EcsSubGraphMode.StartToEnd)
+        public SubGraphMap ExecuteFor(EcsSpan span, JoinMode mode = JoinMode.Start)
         {
             return ExecuteFor_Internal(span, mode);
         }
@@ -246,10 +252,10 @@ namespace DCFApixels.DragonECS.Graphs.Internal
 
         #region Internal result methods
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        internal EcsSubGraphSpan GetRelations_Internal(int sourceEntityID)
+        internal SubGraphMap.NodeInfo GetRelations_Internal(int sourceEntityID)
         {
             LinkedListHead basket = _linkedListSourceHeads[sourceEntityID];
-            return new EcsSubGraphSpan(_linkedList._nodes, basket.head, basket.count);
+            return new SubGraphMap.NodeInfo(_linkedList._nodes, basket.head, basket.count);
         }
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
         internal int GetRelation_Internal(int sourceEntityID)
@@ -291,7 +297,7 @@ namespace DCFApixels.DragonECS.Graphs.Internal
         #endregion
 
         #region GetEntites
-        internal EcsSpan GetSourceEntities()
+        internal EcsSpan GetNodeEntities()
         {
             return UncheckedCoreUtility.CreateSpan(WorldID, _sourceEntities, _sourceEntitiesCount);
         }
@@ -305,56 +311,72 @@ namespace DCFApixels.DragonECS.Graphs.Internal
 
 namespace DCFApixels.DragonECS
 {
-    public enum EcsSubGraphMode : byte
+    public enum JoinMode : byte
     {
         NONE = 0,
-        StartToEnd = 1 << 0,
+        Start = 1 << 0,
-        EndToStart = 1 << 1,
+        End = 1 << 1,
-        All = StartToEnd | EndToStart,
+        All = Start | End,
     }
 
-    #region EcsSubGraphSpan/EcsSubGraph
+    #region SubGraphMap
-    public readonly ref struct EcsSubGraph
+    public readonly ref struct SubGraphMap
     {
-        private readonly JoinToSubGraphExecutor _executer;
+        private readonly JoinExecutor _executer;
         public EntityGraph Graph
         {
             get { return _executer.Graph; }
         }
-        internal EcsSubGraph(JoinToSubGraphExecutor executer)
+        internal SubGraphMap(JoinExecutor executer)
         {
             _executer = executer;
         }
-        public EcsSpan GetSourceEntities()
+
+        public EcsSpan WhereNodes<TAspect>(out TAspect a)
+            where TAspect : EcsAspect, new()
         {
-            return _executer.GetSourceEntities();
+            return _executer.GetNodeEntities().Where(out a);
         }
-        public EcsSpan GetAllRelEntities()
+        public EcsSpan WhereNodes<TAspect>(IComponentMask mask)
+        {
+            return _executer.GetNodeEntities().Where(mask);
+        }
+        public EcsSpan WhereNodes<TAspect>(out TAspect a, Comparison<int> comparison)
+            where TAspect : EcsAspect, new()
+        {
+            return _executer.GetNodeEntities().Where(out a, comparison);
+        }
+        public EcsSpan WhereNodes<TAspect>(IComponentMask mask, Comparison<int> comparison)
+        {
+            return _executer.GetNodeEntities().Where(mask, comparison);
+        }
+
+        public EcsSpan GetNodes()
+        {
+            return _executer.GetNodeEntities();
+        }
+        public EcsSpan GetAllRelations()
         {
             return _executer.GetRelEntities();
         }
-        public EcsSubGraphSpan GetRelations(int startEntityID)
+
+        public NodeInfo GetRelations(int nodeEntityID)
         {
-            return _executer.GetRelations_Internal(startEntityID);
+            return _executer.GetRelations_Internal(nodeEntityID);
-        }
-        public int GetRelation(int startEntityID)
-        {
-            return _executer.GetRelation_Internal(startEntityID);
-        }
-        public int GetRelationsCount(int startEntityID)
-        {
-            return _executer.GetRelationsCount_Internal(startEntityID);
-        }
         }
 
-    public readonly ref struct EcsSubGraphSpan
+        public int GetRelation(int nodeEntityID)
         {
-        public static EcsSubGraphSpan Empty
+            return _executer.GetRelation_Internal(nodeEntityID);
+        }
+        public int GetRelationsCount(int nodeEntityID)
         {
-            [MethodImpl(MethodImplOptions.AggressiveInlining)]
+            return _executer.GetRelationsCount_Internal(nodeEntityID);
-            get { return new EcsSubGraphSpan(null, 0, 0); }
         }
 
+        [DebuggerTypeProxy(typeof(DebuggerProxy))]
+        public readonly ref struct NodeInfo
+        {
             private readonly LinkedList.Node[] _nodes;
             private readonly LinkedList.NodeIndex _startNodeIndex;
             private readonly int _count;
@@ -363,20 +385,8 @@ namespace DCFApixels.DragonECS
                 [MethodImpl(MethodImplOptions.AggressiveInlining)]
                 get { return _count; }
             }
-        private IEnumerable<int> E
-        {
-            get
-            {
-                List<int> result = new List<int>();
-                foreach (var item in this)
-                {
-                    result.Add(item);
-                }
-                return result;
-            }
-        }
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
-        internal EcsSubGraphSpan(LinkedList.Node[] nodes, LinkedList.NodeIndex startNodeIndex, int count)
+            internal NodeInfo(LinkedList.Node[] nodes, LinkedList.NodeIndex startNodeIndex, int count)
             {
                 _nodes = nodes;
                 _startNodeIndex = startNodeIndex;
@@ -415,6 +425,31 @@ namespace DCFApixels.DragonECS
                     //return _count-- > 0;
                 }
             }
+            private class DebuggerProxy
+            {
+                private readonly LinkedList.Node[] _nodes;
+                private readonly LinkedList.NodeIndex _startNodeIndex;
+                private readonly int _count;
+                private IEnumerable<int> Entities
+                {
+                    get
+                    {
+                        List<int> result = new List<int>();
+                        foreach (var item in new NodeInfo(_nodes, _startNodeIndex, _count))
+                        {
+                            result.Add(item);
+                        }
+                        return result;
+                    }
+                }
+                public DebuggerProxy(NodeInfo node)
+                {
+                    _nodes = node._nodes;
+                    _startNodeIndex = node._startNodeIndex;
+                    _count = node._count;
+                }
+            }
+        }
     }
     #endregion
 }