Coplt.Arches 0.2.0

Coplt.Arches

Archetype is a dynamic structure
This library includes dynamic archetype emit and access method emit
This is not ECS, but you can use it to implement an archetype based ECS

Todo

• Callback access generation

Example

struct Foo
{
    public int a;
    public int b;
}

struct Tag;


ArcheTypeMeta arch = ArcheTypes.EmitArcheType(
[
    typeof(int), 
    typeof(float), 
    typeof(object), // You can use any type, including managed types
    typeof(Foo), 
    typeof(Vector128<float>),
    // All 1 byte size empty structures are considered tags 
    // And do not actually occupy space
    typeof(Tag), 
    typeof(bool), 
    typeof(byte),
], new ArcheTypeOptions());

// ArcheTypeOptions can be used to separate managed and unmanaged types, 
// which will result in the output of two ArcheTypeUnitMeta

ArcheTypeUnitMeta atu = arch.Units[0];
AArcheType at = atu.ArcheType;

// AArcheType contains some dynamically generated utility methods, 
// such as create chunk instance、 generating access bindings

object chunk = at.Create();


record struct Acc
{
    public int a;
    public RwRef<Vector128<float>> v;
    public RoRef<Foo> foo;
}

// Automatically generate access bindings
// The access structure can be on the heap, which means it can be passed in linq

at.UnsafeAccess(chunk, 3, out Acc acc);
Console.WriteLine(acc);


ref struct RefAcc
{
    public int v;
    public ref int a;
    public Span<int> b;
    public ReadOnlySpan<int> c;
    public RoRef<int> d;
    public RwRef<int> e;
}
ArcheAccess ref_acc = at.DynamicAccess(typeof(Acc));
RefAcc r = default;
ref_acc(chunk, 0, 3, &r);
r.a++;

// Access structures also support ref structures
// Span, ReadOnlySpan will only have a length of 1