# Multithreading extension for Entity Component System framework Multithreading support for [ECS framework](https://github.com/Leopotam/ecs) - main goal of this extension. > Tested on unity 2019.1 (not dependent on Unity engine) and contains assembly definition for compiling to separate assembly file for performance reason. > Dependent on [ECS framework](https://github.com/Leopotam/ecs) - ECS framework should be imported first. # Installation ## As unity module This repository can be installed as unity module directly from git url. In this way new line should be added to `Packages/manifest.json`: ``` "com.leopotam.ecs-threads": "https://github.com/Leopotam/ecs-threads.git", ``` By default last released version will be used. If you need trunk / developing version then `develop` name of branch should be added after hash: ``` "com.leopotam.ecs-threads": "https://github.com/Leopotam/ecs-threads.git#develop", ``` ## As source If you can't / don't want to use unity modules, code can be downloaded as sources archive of required release from [Releases page](https://github.com/Leopotam/ecs-threads/raw/master/`https://github.com/Leopotam/ecs-threads/releases`). # Systems ## EcsMultiThreadSystem Multithreaded entities processing system, like "jobs" at unity engine, but not dependent on any engine. ```csharp struct ThreadComponent { public float A; public float B; public float C; public float D; public float E; public float F; public float G; public float H; public float I; public float J; public float Result; } [EcsInject] sealed class ThreadTestSystem : EcsMultiThreadSystem> { EcsWorld _world = null; EcsFilter _filter = null; ///

/// Returns filter for processing entities in it at background threads. ///

protected override EcsFilter GetFilter () { return _filter; } ///

/// Returns minimal amount of entities for splitting to threads instead processing in one. ///

protected override int GetMinJobSize () { return 1000; } ///

/// Returns background threads amount. Main thread will be used as additional worker (+1 thread). ///

protected override int GetThreadsCount () { return System.Environment.ProcessorCount - 1; } ///

/// Returns our worker callback. ///

protected override EcsMultiThreadWorker GetWorker () { return Worker; } ///

/// Our worker callback for processing entities. /// Important: better to use static methods as workers - you cant touch any instance data without additional sync. ///

static void Worker (EcsMultiThreadWorkerDesc workerDesc) { foreach (var idx in workerDesc) { ref var c = ref workerDesc.Filter.Get1(idx); c.Result = (float) System.Math.Sqrt (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Sin (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Cos (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Tan (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Log10 (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Sqrt (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Sin (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Cos (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Tan (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); c.Result = (float) System.Math.Log10 (c.A + c.B + c.C + c.D + c.E + c.F + c.G + c.H + c.I + c.J); } } } ``` # License The software released under the terms of the [MIT license](https://github.com/Leopotam/ecs-threads/blob/master/LICENSE.md). Enjoy. # Donate Its free opensource software, but you can buy me a coffee: