From 8fa27157b76dbe3df71462547d8a098c9e5d7c6d Mon Sep 17 00:00:00 2001
From: Mikhail <99481254+DCFApixels@users.noreply.github.com>
Date: Mon, 12 Jun 2023 13:35:54 +0800
Subject: [PATCH 1/2] even split
---
src/ThreadRunner.cs | 16 +++++++++++-----
1 file changed, 11 insertions(+), 5 deletions(-)
diff --git a/src/ThreadRunner.cs b/src/ThreadRunner.cs
index 126a5ea..56dce0e 100644
--- a/src/ThreadRunner.cs
+++ b/src/ThreadRunner.cs
@@ -76,14 +76,20 @@ namespace DCFApixels.DragonECS
if (threadsCount > 1)
{
- int spanSize = entitiesCount / (threadsCount - 1);
- for (int i = 0; i < threadsCount; i++)
+ int remainder = entitiesCount % threadsCount;
+ int quotient = entitiesCount / threadsCount;
+ for (int i = 0, start = 0; i < threadsCount; i++)
{
ref var thread = ref _threads[i];
- thread.start = i * spanSize;
- thread.size = spanSize;
+ thread.start = start;
+ thread.size = quotient;
+ if (remainder > 0)
+ {
+ thread.size++;
+ remainder--;
+ }
+ start += thread.size;
}
- _threads[threadsCount - 1].size = entities.Count % (threadsCount - 1);
}
else
{
From b3a18acd890b2b704503d2d93473d48aadd74e34 Mon Sep 17 00:00:00 2001
From: Mikhail <99481254+DCFApixels@users.noreply.github.com>
Date: Mon, 12 Jun 2023 14:36:51 +0800
Subject: [PATCH 2/2] Update README-RU.md
---
README-RU.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++--
1 file changed, 55 insertions(+), 2 deletions(-)
diff --git a/README-RU.md b/README-RU.md
index f6a67bf..d701306 100644
--- a/README-RU.md
+++ b/README-RU.md
@@ -1,2 +1,55 @@
-# DragonECS-Threads
-
+
+
+
+
+
+
+# Классические C# Threads для [DragonECS](https://github.com/DCFApixels/DragonECS)
+
+| Languages: | [Русский](https://github.com/DCFApixels/DragonECS-ClassicThreads/blob/main/README-RU.md) | [English(WIP)](https://github.com/DCFApixels/DragonECS-ClassicThreads) |
+| :--- | :--- | :--- |
+
+Поддержка обработки сущностей в нескольких потоках, на основе классической реализации потоков в C#.
+> **ВАЖНО!** Проект в стадии разработки. API может меняться.
+# Оглавление
+* [Установка](#Установка)
+ * [Зависимости](#Зависимости)
+ * [Unity-модуль](#Unity-модуль)
+ * [В виде исходников](#В-виде-иходников)
+
+# Установка
+### Зависимости
+Убедитесь что в проекте установлен фреймворк [DragonECS](https://github.com/DCFApixels/DragonECS).
+* ### Unity-модуль
+Поддерживается установка в виде Unity-модуля в при помощи добавления git-URL [в PackageManager](https://docs.unity3d.com/2023.2/Documentation/Manual/upm-ui-giturl.html) или ручного добавления в `Packages/manifest.json`:
+```
+https://github.com/DCFApixels/DragonECS-AutoInjections.git
+```
+* ### В виде исходников
+Фреймворк так же может быть добавлен в проект в виде исходников.
+
+### Версионирование
+В DragonECS применяется следующая семантика версионирования: [Открыть](https://gist.github.com/DCFApixels/e53281d4628b19fe5278f3e77a7da9e8#%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D0%BE%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
+
+# Параллельная итерация группы
+``` csharp
+EcsThreadHandler _handler;
+public void Run(EcsPipeline pipeline)
+{
+ //Получение субъекта и группы для итерации.
+ var group = _world.Where(out Subject s);
+ void Handler(ReadOnlySpan 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:** Внутри обработчика запрещено изменять состояние мира: нельзя создавать/удалять сущности, нельзя добавлять/удалять компоненты на сущности. Допускается только модификация данных внутри существующих компонентов.