Skip to content

Latest commit

 

History

History
74 lines (61 loc) · 4.33 KB

README-RU.md

File metadata and controls

74 lines (61 loc) · 4.33 KB
Raw

Version License Discord QQ

Классические C# Threads для DragonECS

Languages: Русский English(WIP)

Поддержка обработки сущностей в нескольких потоках, на основе классической реализации потоков в C#.

Warning

Проект в стадии разработки. API может меняться.

Оглавление


Установка

Семантика версионирования - Открыть

Окружение

Обязательные требования:

  • Зависимость: DragonECS
  • Минимальная версия C# 7.3;

Опционально:

  • Поддержка NativeAOT
  • Игровые движки с C#: Unity, Godot, MonoGame и т.д.

Протестированно:

  • Unity: Минимальная версия 2020.1.0;

Установка для Unity

  • Unity-модуль

Поддерживается установка в виде Unity-модуля в при помощи добавления git-URL в PackageManager или ручного добавления в Packages/manifest.json:

https://github.com/DCFApixels/DragonECS-ClassicThreads.git

  • В виде иходников

Фреймворк так же может быть добавлен в проект в виде исходников.


Параллельная итерация

EcsThreadHandler _handler;
public void Run(EcsPipeline pipeline)
{
    //Получение Аспекта и сцщностей для итерации.
    var group = _world.Where(out Aspect a);
    void Handler(ReadOnlySpan<int> entities)
    {
        foreach (var e in entities)
        {
            //Вычисления в отедльном потоке.
            a.poses.Get(e).position += a.velocities.Read(e).value * _time.DeltaTime;
        }
    }
    // Запускает параллельную итерацию по сущностям, 
    // сущности будут разбита на части с минимальным размером 1000.
    group.IterateParallel(_handler ??= Handler, 1000);
}

NOTICE: Чем меньше минимальный размер части группы при делении, тем больше потоков может быть задействовано, в некоторых ситуациях слишком много потоков может негативно повлиять на производительность.

NOTICE: Внутри обработчика запрещено создавать/удалять сущности, запрещено добавлять/удалять компоненты на сущности. Допускается только модификация данных внутри компонентов.