From 10633f0b4991063bf877d0539c9d8cc2bcb23bbc Mon Sep 17 00:00:00 2001 From: Mikhail <99481254+DCFApixels@users.noreply.github.com> Date: Fri, 22 Nov 2024 13:46:44 +0800 Subject: [PATCH] Update README-RU.md --- README-RU.md | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) diff --git a/README-RU.md b/README-RU.md index b2085cb..8c91efe 100644 --- a/README-RU.md +++ b/README-RU.md @@ -35,7 +35,7 @@
-Реализация связи сущностей в виде графа. Связывающие ребра графа представлены в виде сущностей, что позволяет создавать отношения вида многие ко многим, а с помощью компонентной композиции можно настраивать вид этих отношений. +Реализация отношений сущностей в виде графа. Связывающие ребра графа представлены в виде сущностей, что позволяет создавать отношения вида многие ко многим, а с помощью компонентной композиции можно настраивать вид этих отношений. > [!WARNING] > Проект в стадии разработки. API может меняться. @@ -70,7 +70,7 @@ https://github.com/DCFApixels/DragonECS-Graphs.git
-# Инициализация +# Граф Для начала нужно создать граф реализованный классом `EntityGraph`. Графу требуется 2 мира: обычный мир и мир для сущностей-связей. Пример создания `EntityGraph`: ```c# // Обычный мир. @@ -88,7 +88,7 @@ _pipeline = EcsPipeline.New() // ... .Build() ``` -Можно использовать один мир для обычных сущностей и для сущностей связей. +Можно использовать один мир для обычных сущностей и для сущностей-связей. ```c# _world = new EcsDefaultWorld(); // Создание EntityGraph завязанный на одном мире. @@ -96,3 +96,33 @@ EntityGraph graph = _world.CreateGraph(); ``` # Сущность-связь + +Как и обычная сущность, но управляется и создается в `EntityGraph` и предназначена для данных об отношении двух сущностей. + +> Отношения имеют направление, поэтому чтобы разделять сущности, далее будет использованы понятия: начальная сущность(`Start Entity`) от нее исходит сущность-связъ(`Relation Entity`) к конечной сущности(`End Entity`). +``` +(Start Entity) ─── (Relation Entity) ──► (End Entity) +``` +Пример работы с связями: +```c# + // Получаем или создаем новую сущность-связь от сущности `startE` к `endE`. + // Сущность создается в мире _graph.GraphWorld и регистрируется в графе. + var relE = _graph.GetOrNewRelation(startE, endE); + + // Кроме создания и удаления, в остальном сущности-свящи - это обычные сущности. + ref var someCmp = ref _somePool.Add(relE); + + // Вернет true если была создана через EntityGraph.GetOrNewRelation(startE, endE) + // и false если через EcsWorld.NewEntity(). + bool isRelation = _graph.IsRelation(relE); + + // Взять сущность-связь для отношения в обратном направлении, от `endE` к `startE`. + _graph.GetOrNewInverseRelation(relE); + + // Удаляем сущность связь. + _graph.DelRelation(relE); +``` + +# Запрос + +