Misaki
f988c34b3d
Introduces a new Ghost.Shader.Concept project implementing a modern, data-oriented material and shader system with: - Global/local keyword bitsets (fast O(1) ops, 64 bytes) - Multi-pass shader program and per-pass render state overrides - Thread-safe, 16-byte aligned material property blocks - Material pooling to reduce GC pressure - Batch renderer for efficient PSO grouping and async variant warmup - Full demo (Program.cs) and extensive documentation (ARCHITECTURE.md, README.md, PROJECT_SUMMARY.md) - Minor integration: new enums, doc updates, and keyword handling in existing code No breaking changes to the existing engine; all new code is isolated. This serves as a reference implementation for high-performance, extensible material/shader architectures.
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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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 space(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;
|
|
}
|
|
|
|
} |