DragonECS-ClassicThreads/README-RU.md
2023-06-12 15:00:56 +08:00

4.0 KiB
Raw Blame History

Version License

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

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

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

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

Оглавление

Установка

Зависимости

Убедитесь что в проекте установлен фреймворк DragonECS.

  • Unity-модуль

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

https://github.com/DCFApixels/DragonECS-AutoInjections.git
  • В виде исходников

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

Версионирование

В DragonECS применяется следующая семантика версионирования: Открыть

Параллельная итерация группы

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

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

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