Misaki
856fa4f07d
Introduce per-component versioning in chunks and world for efficient change detection. - Add version arrays to chunks and global version to world. - Update queries and ForEach to mark written components as changed. - Extend QueryBuilder with WithAllRW/WithPresentRW for write access. - Expose change tracking API in ChunkView. - Improve thread safety and debug code. - Update tests and examples to demonstrate new features.
380 lines
14 KiB
C#
380 lines
14 KiB
C#
|
|
using System.Runtime.CompilerServices;
|
|
|
|
namespace Ghost.Entities;
|
|
|
|
public ref partial struct QueryBuilder
|
|
{
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'All' filter of the query.
|
|
/// Targets entities that have all of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAll<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_all.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'All' filter of the query and requires read-write access.
|
|
/// Targets entities that have all of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAllRW<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_all.Add(ComponentTypeID<T0>.value);
|
|
_rw.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Any' filter of the query.
|
|
/// Targets entities that have at least one of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAny<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_any.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Absent' filter of the query.
|
|
/// Targets entities that do not have any of the specified component types.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAbsent<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_absent.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'None' filter of the query.
|
|
/// Targets entities that do not have any of the specified component types, or those component(s) are disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithNone<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_none.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Disabled' filter of the query.
|
|
/// Targets entities that have all of the specified component types and those component(s) are disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithDisabled<T0>()
|
|
where T0 : unmanaged, IEnableableComponent
|
|
{
|
|
_disabled.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Present' filter of the query.
|
|
/// Targets entities that have all of the specified component types, regardless of whether those component(s) are enabled or disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithPresent<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_present.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Present' filter of the query and requires read-write access.
|
|
/// Targets entities that have all of the specified component types, regardless of whether those component(s) are enabled or disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithPresentRW<T0>()
|
|
where T0 : unmanaged, IComponent
|
|
{
|
|
_present.Add(ComponentTypeID<T0>.value);
|
|
_rw.Add(ComponentTypeID<T0>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'All' filter of the query.
|
|
/// Targets entities that have all of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAll<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_all.Add(ComponentTypeID<T0>.value);
|
|
_all.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'All' filter of the query and requires read-write access.
|
|
/// Targets entities that have all of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAllRW<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_all.Add(ComponentTypeID<T0>.value);
|
|
_rw.Add(ComponentTypeID<T0>.value);
|
|
_all.Add(ComponentTypeID<T1>.value);
|
|
_rw.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Any' filter of the query.
|
|
/// Targets entities that have at least one of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAny<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_any.Add(ComponentTypeID<T0>.value);
|
|
_any.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Absent' filter of the query.
|
|
/// Targets entities that do not have any of the specified component types.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAbsent<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_absent.Add(ComponentTypeID<T0>.value);
|
|
_absent.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'None' filter of the query.
|
|
/// Targets entities that do not have any of the specified component types, or those component(s) are disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithNone<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_none.Add(ComponentTypeID<T0>.value);
|
|
_none.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Disabled' filter of the query.
|
|
/// Targets entities that have all of the specified component types and those component(s) are disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithDisabled<T0, T1>()
|
|
where T0 : unmanaged, IEnableableComponent
|
|
where T1 : unmanaged, IEnableableComponent
|
|
{
|
|
_disabled.Add(ComponentTypeID<T0>.value);
|
|
_disabled.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Present' filter of the query.
|
|
/// Targets entities that have all of the specified component types, regardless of whether those component(s) are enabled or disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithPresent<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_present.Add(ComponentTypeID<T0>.value);
|
|
_present.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Present' filter of the query and requires read-write access.
|
|
/// Targets entities that have all of the specified component types, regardless of whether those component(s) are enabled or disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithPresentRW<T0, T1>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
{
|
|
_present.Add(ComponentTypeID<T0>.value);
|
|
_rw.Add(ComponentTypeID<T0>.value);
|
|
_present.Add(ComponentTypeID<T1>.value);
|
|
_rw.Add(ComponentTypeID<T1>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'All' filter of the query.
|
|
/// Targets entities that have all of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAll<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_all.Add(ComponentTypeID<T0>.value);
|
|
_all.Add(ComponentTypeID<T1>.value);
|
|
_all.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'All' filter of the query and requires read-write access.
|
|
/// Targets entities that have all of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAllRW<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_all.Add(ComponentTypeID<T0>.value);
|
|
_rw.Add(ComponentTypeID<T0>.value);
|
|
_all.Add(ComponentTypeID<T1>.value);
|
|
_rw.Add(ComponentTypeID<T1>.value);
|
|
_all.Add(ComponentTypeID<T2>.value);
|
|
_rw.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Any' filter of the query.
|
|
/// Targets entities that have at least one of the specified component types and those component(s) must be enabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAny<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_any.Add(ComponentTypeID<T0>.value);
|
|
_any.Add(ComponentTypeID<T1>.value);
|
|
_any.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Absent' filter of the query.
|
|
/// Targets entities that do not have any of the specified component types.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithAbsent<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_absent.Add(ComponentTypeID<T0>.value);
|
|
_absent.Add(ComponentTypeID<T1>.value);
|
|
_absent.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'None' filter of the query.
|
|
/// Targets entities that do not have any of the specified component types, or those component(s) are disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithNone<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_none.Add(ComponentTypeID<T0>.value);
|
|
_none.Add(ComponentTypeID<T1>.value);
|
|
_none.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Disabled' filter of the query.
|
|
/// Targets entities that have all of the specified component types and those component(s) are disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithDisabled<T0, T1, T2>()
|
|
where T0 : unmanaged, IEnableableComponent
|
|
where T1 : unmanaged, IEnableableComponent
|
|
where T2 : unmanaged, IEnableableComponent
|
|
{
|
|
_disabled.Add(ComponentTypeID<T0>.value);
|
|
_disabled.Add(ComponentTypeID<T1>.value);
|
|
_disabled.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Present' filter of the query.
|
|
/// Targets entities that have all of the specified component types, regardless of whether those component(s) are enabled or disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithPresent<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_present.Add(ComponentTypeID<T0>.value);
|
|
_present.Add(ComponentTypeID<T1>.value);
|
|
_present.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds the specified component type(s) to the 'Present' filter of the query and requires read-write access.
|
|
/// Targets entities that have all of the specified component types, regardless of whether those component(s) are enabled or disabled.
|
|
/// </summary>
|
|
[MethodImpl(MethodImplOptions.AggressiveInlining)]
|
|
public QueryBuilder WithPresentRW<T0, T1, T2>()
|
|
where T0 : unmanaged, IComponent
|
|
where T1 : unmanaged, IComponent
|
|
where T2 : unmanaged, IComponent
|
|
{
|
|
_present.Add(ComponentTypeID<T0>.value);
|
|
_rw.Add(ComponentTypeID<T0>.value);
|
|
_present.Add(ComponentTypeID<T1>.value);
|
|
_rw.Add(ComponentTypeID<T1>.value);
|
|
_present.Add(ComponentTypeID<T2>.value);
|
|
_rw.Add(ComponentTypeID<T2>.value);
|
|
|
|
return this;
|
|
}
|
|
|
|
} |