A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
perf: optimize ECS view iteration, sort, and render pipeline
esenginef0d2e9b0dc22
diff --git a/src/esengine/ecs/Registry.hpp b/src/esengine/ecs/Registry.hppindex 144cd17bf..28679c848 100644--- a/src/esengine/ecs/Registry.hpp+++ b/src/esengine/ecs/Registry.hpp@@ -484,21 +484,32 @@ public:usize n = entities.size();if (n <= 1) return;- std::vector<usize> indices(n);- for (usize i = 0; i < n; ++i) indices[i] = i;+ std::vector<usize> perm(n);+ for (usize i = 0; i < n; ++i) perm[i] = i;- std::sort(indices.begin(), indices.end(), [&](usize a, usize b) {+ std::sort(perm.begin(), perm.end(), [&](usize a, usize b) {return compare(components[a], components[b]);});- std::vector<Entity> sortedEntities(n);- std::vector<T> sortedComponents(n);for (usize i = 0; i < n; ++i) {- sortedEntities[i] = std::move(entities[indices[i]]);- sortedComponents[i] = std::move(components[indices[i]]);+ if (perm[i] == i) continue;++ usize j = i;+ Entity tmpEntity = std::move(entities[i]);+ T tmpComponent = std::move(components[i]);++ while (perm[j] != i) {+ usize src = perm[j];+ entities[j] = std::move(entities[src]);+ components[j] = std::move(components[src]);+ perm[j] = j;+ j = src;+ }++ entities[j] = std::move(tmpEntity);+ components[j] = std::move(tmpComponent);+ perm[j] = j;}- entities = std::move(sortedEntities);- components = std::move(sortedComponents);pool->rebuildSparse();}@@ -606,7 +617,7 @@ private:// Data Members// =========================================================================- std::vector<bool> entityValid_;+ std::vector<u8> entityValid_;std::vector<u32> generations_;std::vector<u64> component_masks_;std::queue<Entity> recycled_;diff --git a/src/esengine/ecs/SparseSet.hpp b/src/esengine/ecs/SparseSet.hppindex ee49735ab..e8fd10690 100644--- a/src/esengine/ecs/SparseSet.hpp+++ b/src/esengine/ecs/SparseSet.hpp@@ -196,6 +196,18 @@ public:return components_[(*pages_[pageIndex])[offset]];}+ T& getUnchecked(Entity entity) {+ const auto pageIndex = entity / SPARSE_PAGE_SIZE;+ const auto offset = entity % SPARSE_PAGE_SIZE;+ return components_[(*pages_[pageIndex])[offset]];+ }++ const T& getUnchecked(Entity entity) const {+ const auto pageIndex = entity / SPARSE_PAGE_SIZE;+ const auto offset = entity % SPARSE_PAGE_SIZE;+ return components_[(*pages_[pageIndex])[offset]];+ }+/*** @brief Tries to get a component (returns nullptr if not found)* @param entity The entitydiff --git a/src/esengine/ecs/View.hpp b/src/esengine/ecs/View.hppindex 4ba2740f7..c184f1354 100644--- a/src/esengine/ecs/View.hpp+++ b/src/esengine/ecs/View.hpp@@ -266,34 +266,21 @@ public:// Functional Iteration// =========================================================================- /**- * @brief Executes a function for each matching entity- * @tparam Func Callback type- * @param func The callback to invoke- *- * @details The callback can have one of these signatures:- * - `void(Entity, Component&...)` - entity and all components- * - `void(Component&...)` - components only- * - `void(Entity)` - entity only- *- * @code- * // With entity and components- * view.each([](Entity e, Position& p, Velocity& v) { ... });- *- * // Components only- * view.each([](Position& p, Velocity& v) { ... });- *- * // Entity only- * view.each([](Entity e) { ... });- * @endcode- */template<typename Func>void each(Func&& func) {- for (auto entity : *this) {+ if (!smallest_) return;++ const auto& entities = smallest_->entities();+ const usize n = entities.size();++ for (usize i = 0; i < n; ++i) {+ Entity entity = entities[i];+ if (!allHaveExceptSmallest(entity)) continue;+if constexpr (std::is_invocable_v<Func, Entity, Components&...>) {- func(entity, get<Components>(entity)...);+ func(entity, getFromPool<Components>(entity, i)...);} else if constexpr (std::is_invocable_v<Func, Components&...>) {- func(get<Components>(entity)...);+ func(getFromPool<Components>(entity, i)...);} else {func(entity);}@@ -301,6 +288,25 @@ public:}private:+ template<typename T>+ T& getFromPool(Entity entity, usize smallestDenseIndex) {+ auto* pool = std::get<SparseSet<T>*>(pools_);+ if (static_cast<SparseSetBase*>(pool) == smallest_) {+ return pool->components()[smallestDenseIndex];+ }+ return pool->getUnchecked(entity);+ }++ bool allHaveExceptSmallest(Entity entity) const {+ return allHaveExceptSmallestImpl(entity, std::index_sequence_for<Components...>{});+ }++ template<usize... Is>+ bool allHaveExceptSmallestImpl(Entity entity, std::index_sequence<Is...>) const {+ return ((static_cast<SparseSetBase*>(std::get<Is>(pools_)) == smallest_ ||+ std::get<Is>(pools_)->contains(entity)) && ...);+ }+/*** @brief Finds the smallest component pool*diff --git a/src/esengine/renderer/RenderFrame.cpp b/src/esengine/renderer/RenderFrame.cppindex 576593733..48a5afc35 100644--- a/src/esengine/renderer/RenderFrame.cpp+++ b/src/esengine/renderer/RenderFrame.cpp@@ -117,7 +117,6 @@ void RenderFrame::init(u32 width, u32 height) {post_process_->init(width, height);items_.reserve(1024);- sorted_indices_.reserve(1024);sprite_data_.reserve(512);text_data_.reserve(64);ext_data_.reserve(32);@@ -345,7 +344,6 @@ void RenderFrame::shutdown() {#endifitems_.clear();- sorted_indices_.clear();sprite_data_.clear();text_data_.clear();ext_data_.clear();@@ -373,7 +371,6 @@ void RenderFrame::begin(const glm::mat4& view_projection, RenderTargetManager::Hin_frame_ = true;items_.clear();- sorted_indices_.clear();sprite_data_.clear();text_data_.clear();ext_data_.clear();@@ -805,14 +802,10 @@ void RenderFrame::submitExternalTriangles(void RenderFrame::sortAndBucket() {u32 n = static_cast<u32>(items_.size());- sorted_indices_.resize(n);- for (u32 i = 0; i < n; ++i) {- sorted_indices_[i] = i;- }- std::sort(sorted_indices_.begin(), sorted_indices_.end(),- [this](u32 a, u32 b) {- return items_[a].cached_sort_key_ < items_[b].cached_sort_key_;+ std::sort(items_.begin(), items_.end(),+ [](const RenderItemBase& a, const RenderItemBase& b) {+ return a.cached_sort_key_ < b.cached_sort_key_;});for (auto& sb : stage_boundaries_) {@@ -824,11 +817,11 @@ void RenderFrame::sortAndBucket() {u32 i = 0;while (i < n) {- auto stage = items_[sorted_indices_[i]].stage;+ auto stage = items_[i].stage;u32 stageIdx = static_cast<u32>(stage);if (stageIdx < STAGE_COUNT) {stage_boundaries_[stageIdx].begin = i;- while (i < n && items_[sorted_indices_[i]].stage == stage) {+ while (i < n && items_[i].stage == stage) {++i;}stage_boundaries_[stageIdx].end = i;@@ -846,7 +839,7 @@ void RenderFrame::executeStage(RenderStage stage) {if (sb.begin >= sb.end) return;u32 batchStart = sb.begin;- RenderType currentType = items_[sorted_indices_[batchStart]].type;+ RenderType currentType = items_[batchStart].type;auto flushBatch = [&](u32 begin, u32 end) {switch (currentType) {@@ -876,10 +869,10 @@ void RenderFrame::executeStage(RenderStage stage) {};for (u32 i = sb.begin; i < sb.end; ++i) {- if (items_[sorted_indices_[i]].type != currentType) {+ if (items_[i].type != currentType) {flushBatch(batchStart, i);batchStart = i;- currentType = items_[sorted_indices_[i]].type;+ currentType = items_[i].type;}}@@ -897,7 +890,7 @@ void RenderFrame::renderSprites(u32 begin, u32 end) {i32 curStencilRef = -1;for (u32 i = begin; i < end; ++i) {- const auto& base = items_[sorted_indices_[i]];+ const auto& base = items_[i];const auto& sd = sprite_data_[base.data_index];if (base.scissor_enabled != curScissorOn ||@@ -1067,7 +1060,7 @@ void RenderFrame::renderSpine(u32 begin, u32 end) {static ::spine::SkeletonClipping clipper;for (u32 idx = begin; idx < end; ++idx) {- const auto& base = items_[sorted_indices_[idx]];+ const auto& base = items_[idx];const auto& sd = spine_data_[base.data_index];auto* skeleton = static_cast<::spine::Skeleton*>(sd.skeleton);if (!skeleton) continue;@@ -1328,7 +1321,7 @@ void RenderFrame::renderExternalMeshes(u32 begin, u32 end) {i32 locTexture = shader->getUniformLocation("u_texture");for (u32 idx = begin; idx < end; ++idx) {- const auto& base = items_[sorted_indices_[idx]];+ const auto& base = items_[idx];const auto& ed = ext_data_[base.data_index];if (!ed.ext_vertices || !ed.ext_indices ||ed.ext_vertex_count <= 0 || ed.ext_index_count <= 0) {@@ -1381,7 +1374,7 @@ void RenderFrame::renderExternalMeshes(u32 begin, u32 end) {void RenderFrame::renderMeshes(u32 begin, u32 end) {for (u32 i = begin; i < end; ++i) {- const auto& base = items_[sorted_indices_[i]];+ const auto& base = items_[i];const auto& sd = sprite_data_[base.data_index];if (!sd.geometry || !sd.shader) continue;@@ -1451,7 +1444,7 @@ void RenderFrame::renderText(u32 begin, u32 end) {i32 curStencilRef = -1;for (u32 i = begin; i < end; ++i) {- const auto& base = items_[sorted_indices_[i]];+ const auto& base = items_[i];const auto& td = text_data_[base.data_index];if (base.scissor_enabled != curScissorOn ||@@ -1826,7 +1819,7 @@ void RenderFrame::renderParticles(u32 begin, u32 end) {ScissorRect curScissorRect{};u32 batchStart = begin;- const auto& firstBase = items_[sorted_indices_[begin]];+ const auto& firstBase = items_[begin];const auto& firstPd = particle_data_[firstBase.data_index];u32 batchTexture = firstBase.texture_id;BlendMode batchBlend = firstBase.blend_mode;@@ -1840,7 +1833,7 @@ void RenderFrame::renderParticles(u32 begin, u32 end) {particle_instances_.reserve(count);for (u32 i = bStart; i < bEnd; ++i) {- const auto& base = items_[sorted_indices_[i]];+ const auto& base = items_[i];const auto& pd = particle_data_[base.data_index];ParticleInstanceData inst;@@ -1914,7 +1907,7 @@ void RenderFrame::renderParticles(u32 begin, u32 end) {};for (u32 i = begin; i < end; ++i) {- const auto& base = items_[sorted_indices_[i]];+ const auto& base = items_[i];const auto& pd = particle_data_[base.data_index];bool scissorChanged = base.scissor_enabled != curScissorOn ||@@ -1955,7 +1948,7 @@ void RenderFrame::renderParticles(u32 begin, u32 end) {batcher_->beginBatch();for (u32 i = begin; i < end; ++i) {- const auto& base = items_[sorted_indices_[i]];+ const auto& base = items_[i];const auto& pd = particle_data_[base.data_index];glm::vec2 position(base.world_position);diff --git a/src/esengine/renderer/RenderFrame.hpp b/src/esengine/renderer/RenderFrame.hppindex d2658b367..12d41e32f 100644--- a/src/esengine/renderer/RenderFrame.hpp+++ b/src/esengine/renderer/RenderFrame.hpp@@ -130,7 +130,6 @@ private:RenderTargetManager target_manager_;std::vector<RenderItemBase> items_;- std::vector<u32> sorted_indices_;std::vector<SpriteData> sprite_data_;std::vector<TextData> text_data_;