From 6527ccf98fed7400b4381d090397a7ace87d4eb9 Mon Sep 17 00:00:00 2001 From: Mikhail <99481254+DCFApixels@users.noreply.github.com> Date: Wed, 7 Aug 2024 11:28:05 +0800 Subject: [PATCH] update readme --- README-ZH.md | 44 ++++++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/README-ZH.md b/README-ZH.md index b369f40..2dcbfbf 100644 --- a/README-ZH.md +++ b/README-ZH.md @@ -65,7 +65,7 @@ DragonECS 是一个[实体组件系统](https://www.imooc.com/article/331544)框 - [方面](#方面) - [查询](#查询) - [集合](#集合) - - [根本](#根本) + - [ECS入口](#ECS入口) - [Debug](#debug) - [元属性](#元属性) - [EcsDebug](#ecsdebug) @@ -308,12 +308,12 @@ EcsPipeline pipeline = EcsPipeline.New() Для добавления нового процесса создайте интерфейс наследованный от `IEcsProcess` и создайте раннер для него. Раннер это класс реализующий интерфейс запускаемого процесса и наследуемый от `EcsRunner`. Пример: ``` c# -//Интерфейс. +// 流程接口。 interface IDoSomethingProcess : IEcsProcess { void Do(); } -//Реализация раннера. Пример реализации можно так же посмотреть в встроенных процессах +// 启动器实现. 也可以在内置的流程中参考实现示例。 sealed class DoSomethingProcessRunner : EcsRunner, IDoSomethingProcess { public void Do() @@ -323,25 +323,25 @@ sealed class DoSomethingProcessRunner : EcsRunner, IDoSomet } //... -//Добавление раннера при создании пайплайна. +// 添加启动器到管线 _pipeline = EcsPipeline.New() //... .AddRunner() //... .BuildAndInit(); -//Запуск раннера если раннер был добавлен. +// 如果启动器已经添加，运行它。 _pipeline.GetRunner.Do() -//Или если раннер не был добавлен(Вызов GetRunnerInstance так же добавит раннер в пайплайн). +// 如果启动器尚未添加，使用 GetRunnerInstance 将其添加并运行 _pipeline.GetRunnerInstance.Do() ``` -> Раннеры имеют ряд требований к реализации: -> * Наследоваться от `EcsRunner` можно только напрямую; -> * Раннер может содержать только один интерфейс(за исключением `IEcsProcess`); -> * Наследуемый класс `EcsRunner,` должен так же реализовать интерфейс `T`; +> 启动器的实现有一些要求： +> * 必须直接继承自 `EcsRunner`； +> * 启动器只能包含一个接口（除了 `IEcsProcess` 接口）； +> * 继承的 `EcsRunner,` 类必须实现接口 `T`； -> Не рекомендуется в цикле вызывать `GetRunner`, иначе кешируйте полученный раннер. +不建议在循环中频繁调用 `GetRunner` 方法，建议缓存获取的启动器实例。 ## 世界 @@ -438,7 +438,7 @@ class Aspect : EcsAspect
结合方面 -В аспекты можно добавлять другие аспекты, тем самым комбинируя их. Ограничения так же будут скомбинированы. +可以把一个方面加入另一个方面，从而组合它们。限制也会被组合 ``` c# using DCFApixels.DragonECS; ... @@ -450,22 +450,22 @@ class Aspect : EcsAspect protected override void Init(Builder b) { - // комбинирует с SomeAspect1. + // 与 SomeAspect1 进行组合。 otherAspect1 = b.Combine(1); - // хотя для OtherAspect1 метод Combine был вызван раньше, сначала будет скомбинирован с OtherAspect2, так как по умолчанию order = 0. + // 即使对 OtherAspect1 调用 Combine 方法更早，Aspect 会首先与 OtherAspect2 进行组合，因为默认情况下 order = 0。 otherAspect2 = b.Combine(); - // если в OtherAspect1 или в OtherAspect2 было ограничение b.Exclude() тут оно будет заменено на b.Include(). + // 如果 OtherAspect1 或 OtherAspect2 中有 b.Exclude() 的限制条件，这里将被替换为 b.Include()。 poses = b.Include(); } } ``` -Если будут конфликтующие ограничения у комбинируемых аспектов, то новые ограничения будут заменять добавленные ранее. Ограничения корневого аспекта всегда заменяют ограничения из добавленных аспектов. Визуальный пример комбинации ограничений: +如果组合的方面存在冲突的限制条件，则新的限制条件将替换先前添加的限制条件。根方面的限制条件始终会替换添加的方面中的限制条件。限制条件组合的视觉示例： | | cmp1 | cmp2 | cmp3 | cmp4 | cmp5 | разрешение конфликтных ограничений| | :--- | :--- | :--- | :--- | :--- | :--- |:--- | | OtherAspect2 | :heavy_check_mark: | :x: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | | -| OtherAspect1 | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :x: | :heavy_minus_sign: | Для `cmp2` будет выбрано :heavy_check_mark: | -| Aspect | :x: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | Для `cmp1` будет выбрано :x: | -| Итоговые ограничения | :x: | :heavy_check_mark: | :heavy_minus_sign: | :x: | :heavy_check_mark: | | +| OtherAspect1 | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :x: | :heavy_minus_sign: | 对于 `cmp2` 将选择 :heavy_check_mark: | +| Aspect | :x: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | 对于 `cmp1` 将选择 :x: | +| 最终的限制 | :x: | :heavy_check_mark: | :heavy_minus_sign: | :x: | :heavy_check_mark: | |
@@ -570,9 +570,9 @@ groupA.Inverse(); EcsGroup newGroup = EcsGroup.Inverse(groupA); ``` -## 根本 +## ECS入口 这是一个用户定义的类，作为 ECS 的入口点。其主要目的是初始化和启动每个 Update 引擎上的系统，并在使用结束后释放资源。 -### Пример для Unity +### Unity示例 ``` c# using DCFApixels.DragonECS; using UnityEngine; @@ -618,7 +618,7 @@ public class EcsRoot : MonoBehaviour } } ``` -### Общий пример +### 公用示例 ``` c# using DCFApixels.DragonECS; public class EcsRoot