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
feat(render): visible 2D shadows via ShadowCaster2D component (T3)
yhhd042d0e260fe
diff --git a/desktop/public/scenes/mat-lit-shadow.esscene b/desktop/public/scenes/mat-lit-shadow.esscenenew file mode 100644index 000000000..6922cdb27--- /dev/null+++ b/desktop/public/scenes/mat-lit-shadow.esscene@@ -0,0 +1,65 @@+{+ "version": "1.0",+ "name": "Main",+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 10 } } },+ { "type": "Camera", "data": { "projectionType": 1, "orthoSize": 300, "isActive": true, "priority": 0 } }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Lit",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },+ {+ "type": "Sprite",+ "data": {+ "size": { "x": 400, "y": 400 },+ "color": { "r": 1, "g": 1, "b": 1, "a": 1 },+ "material": "/scenes/mat-lit/lit.esmaterial"+ }+ }+ ],+ "visible": true+ },+ {+ "id": 2,+ "name": "GreenPointLight",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": -150, "y": 0, "z": 0 } } },+ {+ "type": "Light2D",+ "data": {+ "type": 0,+ "color": { "r": 0, "g": 1, "b": 0, "a": 1 },+ "intensity": 1,+ "radius": 800+ }+ }+ ],+ "visible": true+ },+ {+ "id": 3,+ "name": "Wall",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },+ { "type": "ShadowCaster2D", "data": { "size": { "x": 40, "y": 400 }, "enabled": true } }+ ],+ "visible": true+ }+ ]+}diff --git a/desktop/public/scenes/mat-lit-shadow.textures.json b/desktop/public/scenes/mat-lit-shadow.textures.jsonnew file mode 100644index 000000000..0967ef424--- /dev/null+++ b/desktop/public/scenes/mat-lit-shadow.textures.json@@ -0,0 +1 @@+{}diff --git a/sdk/src/component.generated.ts b/sdk/src/component.generated.tsindex bdb792c19..c5c3aafc9 100644--- a/sdk/src/component.generated.ts+++ b/sdk/src/component.generated.ts@@ -13,7 +13,7 @@ import type { FieldMeta } from './component';* getAbiLayoutHash(); BuiltinBridge.connect() compares them and refuses to* run on mismatch, because mismatched offsets read the wrong heap bytes.*/-export const ABI_LAYOUT_HASH = '2896a68ab5ef40b7';+export const ABI_LAYOUT_HASH = '7ac6cfeb8c0c1963';export interface AssetFieldMeta {field: string;@@ -345,6 +345,19 @@ export const COMPONENT_META: Record<string, ComponentMetaEntry> = {colorFields: [],animatableFields: [],},+ ShadowCaster2D: {+ defaults: {+ size: { x: 32, y: 32 },+ enabled: true,+ },+ assetFields: [],+ entityFields: [],+ colorFields: [],+ animatableFields: ['size.x', 'size.y'],+ fields: {+ size: { min: 0, tooltip: "Occluder box size in world units (centered on the entity)." },+ },+ },ShapeRenderer: {defaults: {shapeType: 0,diff --git a/sdk/src/component.ts b/sdk/src/component.tsindex 967596f39..96efdd617 100644--- a/sdk/src/component.ts+++ b/sdk/src/component.ts@@ -553,6 +553,11 @@ export interface Light2DData {enabled: boolean;}+export interface ShadowCaster2DData {+ size: Vec2;+ enabled: boolean;+}+export interface ShapeRendererData {shapeType: number;color: Color;@@ -687,6 +692,10 @@ export const Light2D = defineBuiltin<Light2DData>('Light2D',{ fields: { type: { enum: enumOptions(Light2DType) } } });+export const ShadowCaster2D = defineBuiltin<ShadowCaster2DData>('ShadowCaster2D',+ metaDefaults<ShadowCaster2DData>('ShadowCaster2D')+);+export const Camera = defineBuiltin<CameraData>('Camera',metaDefaults<CameraData>('Camera', {projectionType: ProjectionType.Orthographic,diff --git a/sdk/src/core-runtime.ts b/sdk/src/core-runtime.tsindex 73b7fc50c..6b68f2b1e 100644--- a/sdk/src/core-runtime.ts+++ b/sdk/src/core-runtime.ts@@ -88,6 +88,7 @@ export {ShapeType,Light2D,Light2DType,+ ShadowCaster2D,Camera,Canvas,Velocity,@@ -107,6 +108,7 @@ export {type SpriteData,type ShapeRendererData,type Light2DData,+ type ShadowCaster2DData,type CameraData,type CanvasData,type VelocityData,diff --git a/sdk/src/ecs/ptrAccessors.generated.ts b/sdk/src/ecs/ptrAccessors.generated.tsindex b1f661c63..b20ba2aa0 100644--- a/sdk/src/ecs/ptrAccessors.generated.ts+++ b/sdk/src/ecs/ptrAccessors.generated.ts@@ -745,6 +745,34 @@ export function createSegmentColliderData(): SegmentColliderPtrData {};}+export interface ShadowCaster2DPtrData {+ size: Vec2;+ enabled: boolean;+}++export function fillShadowCaster2D(+ f32: Float32Array, u32: Uint32Array, u8: Uint8Array,+ ptr: number, out: ShadowCaster2DPtrData,+): void {+ const size_ = out.size; size_.x = f32[ptr >> 2]; size_.y = f32[(ptr >> 2) + 1];+ out.enabled = u8[ptr + 8] !== 0;+}++export function writeShadowCaster2D(+ f32: Float32Array, u32: Uint32Array, u8: Uint8Array,+ ptr: number, data: ShadowCaster2DPtrData,+): void {+ f32[ptr >> 2] = data.size.x; f32[(ptr >> 2) + 1] = data.size.y;+ u8[ptr + 8] = data.enabled ? 1 : 0;+}++export function createShadowCaster2DData(): ShadowCaster2DPtrData {+ return {+ size: { x: 0, y: 0 },+ enabled: false,+ };+}+export interface ShapeRendererPtrData {shapeType: number;color: Color;@@ -1240,6 +1268,7 @@ export const PTR_ACCESSORS: Record<string, PtrAccessor<any>> = {ParticleEmitter: { fill: fillParticleEmitter, write: writeParticleEmitter, create: createParticleEmitterData },RigidBody: { fill: fillRigidBody, write: writeRigidBody, create: createRigidBodyData },SegmentCollider: { fill: fillSegmentCollider, write: writeSegmentCollider, create: createSegmentColliderData },+ ShadowCaster2D: { fill: fillShadowCaster2D, write: writeShadowCaster2D, create: createShadowCaster2DData },ShapeRenderer: { fill: fillShapeRenderer, write: writeShapeRenderer, create: createShapeRendererData },SpineAnimation: { fill: fillSpineAnimation, write: writeSpineAnimation, create: createSpineAnimationData },Sprite: { fill: fillSprite, write: writeSprite, create: createSpriteData },diff --git a/sdk/src/ptrLayouts.generated.ts b/sdk/src/ptrLayouts.generated.tsindex f2cd5b5bf..d6a46bb35 100644--- a/sdk/src/ptrLayouts.generated.ts+++ b/sdk/src/ptrLayouts.generated.ts@@ -202,6 +202,13 @@ export const PTR_LAYOUTS: Record<string, PtrLayout> = {{ name: 'maskBits', type: 'u32', offset: 36 },],},+ ShadowCaster2D: {+ ptrFn: 'getShadowCaster2DPtr',+ fields: [+ { name: 'size', type: 'vec2', offset: 0 },+ { name: 'enabled', type: 'bool', offset: 8 },+ ],+ },ShapeRenderer: {ptrFn: 'getShapeRendererPtr',fields: [diff --git a/sdk/src/wasm.generated.ts b/sdk/src/wasm.generated.tsindex 892e4407c..cb07af144 100644--- a/sdk/src/wasm.generated.ts+++ b/sdk/src/wasm.generated.ts@@ -316,6 +316,11 @@ export interface SegmentCollider {maskBits: number;}+export interface ShadowCaster2D {+ size: Vec2;+ enabled: boolean;+}+export interface ShapeRenderer {shapeType: number;color: Vec4;@@ -509,6 +514,10 @@ export interface Registry {getSegmentCollider(entity: Entity): SegmentCollider;addSegmentCollider(entity: Entity, component: SegmentCollider): void;removeSegmentCollider(entity: Entity): void;+ hasShadowCaster2D(entity: Entity): boolean;+ getShadowCaster2D(entity: Entity): ShadowCaster2D;+ addShadowCaster2D(entity: Entity, component: ShadowCaster2D): void;+ removeShadowCaster2D(entity: Entity): void;hasShapeRenderer(entity: Entity): boolean;getShapeRenderer(entity: Entity): ShapeRenderer;addShapeRenderer(entity: Entity, component: ShapeRenderer): void;@@ -585,6 +594,7 @@ export interface ESEngineModule {ParticleEmitter: new () => ParticleEmitter;RigidBody: new () => RigidBody;SegmentCollider: new () => SegmentCollider;+ ShadowCaster2D: new () => ShadowCaster2D;ShapeRenderer: new () => ShapeRenderer;SpineAnimation: new () => SpineAnimation;Sprite: new () => Sprite;diff --git a/sdk/tests/__snapshots__/component-fieldmeta-golden.test.ts.snap b/sdk/tests/__snapshots__/component-fieldmeta-golden.test.ts.snapindex 54175129c..2cde7f0ce 100644--- a/sdk/tests/__snapshots__/component-fieldmeta-golden.test.ts.snap+++ b/sdk/tests/__snapshots__/component-fieldmeta-golden.test.ts.snap@@ -392,6 +392,12 @@ exports[`builtin FieldMeta (RC9-1 equivalence gate) > matches the golden snapsho"category": "Texture",},},+ "ShadowCaster2D": {+ "size": {+ "min": 0,+ "tooltip": "Occluder box size in world units (centered on the entity).",+ },+ },"ShapeRenderer": {"cornerRadius": {"min": 0,diff --git a/src/esengine/bindings/EditorAPI.generated.cpp b/src/esengine/bindings/EditorAPI.generated.cppindex c2096187c..28dcf194c 100644--- a/src/esengine/bindings/EditorAPI.generated.cpp+++ b/src/esengine/bindings/EditorAPI.generated.cpp@@ -2,10 +2,10 @@* @file EditorAPI.generated.cpp* @brief Auto-generated editor API with string-dispatched component access* @details Generated by EHT - DO NOT EDIT- * @schema_hash d7fda004452fec53+ * @schema_hash 15f44ddaf4bd00ac*/-#define ES_EDITOR_API_SCHEMA_HASH "d7fda004452fec53"+#define ES_EDITOR_API_SCHEMA_HASH "15f44ddaf4bd00ac"#include <emscripten/bind.h>#include <string>@@ -21,6 +21,7 @@#include "../ecs/components/Light2D.hpp"#include "../ecs/components/ParticleEmitter.hpp"#include "../ecs/components/RigidBody.hpp"+#include "../ecs/components/ShadowCaster2D.hpp"#include "../ecs/components/ShapeRenderer.hpp"#include "../ecs/components/SpineAnimation.hpp"#include "../ecs/components/Sprite.hpp"@@ -66,6 +67,7 @@ std::vector<std::string> editor_getComponentNames() {"ParticleEmitter","RigidBody","SegmentCollider",+ "ShadowCaster2D","ShapeRenderer","SpineAnimation","Sprite",@@ -286,6 +288,12 @@ std::string editor_getComponentSchema(const std::string& name) {{"key":"categoryBits","type":"int","group":"SegmentCollider"},{"key":"maskBits","type":"int","group":"SegmentCollider"}])JSON";+ } else if (name == "ShadowCaster2D") {+ return R"JSON([+ {"key":"size.x","type":"float","group":"ShadowCaster2D"},+ {"key":"size.y","type":"float","group":"ShadowCaster2D"},+ {"key":"enabled","type":"bool","group":"ShadowCaster2D"}+ ])JSON";} else if (name == "ShapeRenderer") {return R"JSON([{"key":"shapeType","type":"int","group":"ShapeRenderer"},@@ -519,6 +527,9 @@ bool editor_addComponent(Registry& reg, u32 e, const std::string& name) {} else if (name == "SegmentCollider") {if (!reg.has<esengine::ecs::SegmentCollider>(entity)) reg.emplace<esengine::ecs::SegmentCollider>(entity);return true;+ } else if (name == "ShadowCaster2D") {+ if (!reg.has<esengine::ecs::ShadowCaster2D>(entity)) reg.emplace<esengine::ecs::ShadowCaster2D>(entity);+ return true;} else if (name == "ShapeRenderer") {if (!reg.has<esengine::ecs::ShapeRenderer>(entity)) reg.emplace<esengine::ecs::ShapeRenderer>(entity);return true;@@ -590,6 +601,8 @@ bool editor_removeComponent(Registry& reg, u32 e, const std::string& name) {if (reg.has<esengine::ecs::RigidBody>(entity)) { reg.remove<esengine::ecs::RigidBody>(entity); return true; }} else if (name == "SegmentCollider") {if (reg.has<esengine::ecs::SegmentCollider>(entity)) { reg.remove<esengine::ecs::SegmentCollider>(entity); return true; }+ } else if (name == "ShadowCaster2D") {+ if (reg.has<esengine::ecs::ShadowCaster2D>(entity)) { reg.remove<esengine::ecs::ShadowCaster2D>(entity); return true; }} else if (name == "ShapeRenderer") {if (reg.has<esengine::ecs::ShapeRenderer>(entity)) { reg.remove<esengine::ecs::ShapeRenderer>(entity); return true; }} else if (name == "SpineAnimation") {@@ -635,6 +648,7 @@ bool editor_hasComponent(Registry& reg, u32 e, const std::string& name) {if (name == "ParticleEmitter") return reg.has<esengine::ecs::ParticleEmitter>(entity);if (name == "RigidBody") return reg.has<esengine::ecs::RigidBody>(entity);if (name == "SegmentCollider") return reg.has<esengine::ecs::SegmentCollider>(entity);+ if (name == "ShadowCaster2D") return reg.has<esengine::ecs::ShadowCaster2D>(entity);if (name == "ShapeRenderer") return reg.has<esengine::ecs::ShapeRenderer>(entity);if (name == "SpineAnimation") return reg.has<esengine::ecs::SpineAnimation>(entity);if (name == "Sprite") return reg.has<esengine::ecs::Sprite>(entity);@@ -670,6 +684,7 @@ std::vector<std::string> editor_getComponents(Registry& reg, u32 e) {if (reg.has<esengine::ecs::ParticleEmitter>(entity)) result.push_back("ParticleEmitter");if (reg.has<esengine::ecs::RigidBody>(entity)) result.push_back("RigidBody");if (reg.has<esengine::ecs::SegmentCollider>(entity)) result.push_back("SegmentCollider");+ if (reg.has<esengine::ecs::ShadowCaster2D>(entity)) result.push_back("ShadowCaster2D");if (reg.has<esengine::ecs::ShapeRenderer>(entity)) result.push_back("ShapeRenderer");if (reg.has<esengine::ecs::SpineAnimation>(entity)) result.push_back("SpineAnimation");if (reg.has<esengine::ecs::Sprite>(entity)) result.push_back("Sprite");@@ -845,6 +860,13 @@ bool editor_setFloat(Registry& reg, u32 e, const std::string& comp, const std::selse if (field == "restitution") { c.restitution = value; }else { return false; }return true;+ } else if (comp == "ShadowCaster2D") {+ if (!reg.has<esengine::ecs::ShadowCaster2D>(entity)) return false;+ auto& c = reg.get<esengine::ecs::ShadowCaster2D>(entity);+ if (field == "size.x") { c.size.x = value; }+ else if (field == "size.y") { c.size.y = value; }+ else { return false; }+ return true;} else if (comp == "ShapeRenderer") {if (!reg.has<esengine::ecs::ShapeRenderer>(entity)) return false;auto& c = reg.get<esengine::ecs::ShapeRenderer>(entity);@@ -1147,6 +1169,11 @@ f32 editor_getFloat(Registry& reg, u32 e, const std::string& comp, const std::stelse if (field == "density") { return c.density; }else if (field == "friction") { return c.friction; }else if (field == "restitution") { return c.restitution; }+ } else if (comp == "ShadowCaster2D") {+ if (!reg.has<esengine::ecs::ShadowCaster2D>(entity)) return 0.0f;+ const auto& c = reg.get<esengine::ecs::ShadowCaster2D>(entity);+ if (field == "size.x") { return c.size.x; }+ else if (field == "size.y") { return c.size.y; }} else if (comp == "ShapeRenderer") {if (!reg.has<esengine::ecs::ShapeRenderer>(entity)) return 0.0f;const auto& c = reg.get<esengine::ecs::ShapeRenderer>(entity);@@ -1647,6 +1674,12 @@ bool editor_setBool(Registry& reg, u32 e, const std::string& comp, const std::stelse if (field == "enabled") { c.enabled = value; }else { return false; }return true;+ } else if (comp == "ShadowCaster2D") {+ if (!reg.has<esengine::ecs::ShadowCaster2D>(entity)) return false;+ auto& c = reg.get<esengine::ecs::ShadowCaster2D>(entity);+ if (field == "enabled") { c.enabled = value; }+ else { return false; }+ return true;} else if (comp == "ShapeRenderer") {if (!reg.has<esengine::ecs::ShapeRenderer>(entity)) return false;auto& c = reg.get<esengine::ecs::ShapeRenderer>(entity);@@ -1758,6 +1791,10 @@ bool editor_getBool(Registry& reg, u32 e, const std::string& comp, const std::stconst auto& c = reg.get<esengine::ecs::SegmentCollider>(entity);if (field == "isSensor") { return c.isSensor; }else if (field == "enabled") { return c.enabled; }+ } else if (comp == "ShadowCaster2D") {+ if (!reg.has<esengine::ecs::ShadowCaster2D>(entity)) return false;+ const auto& c = reg.get<esengine::ecs::ShadowCaster2D>(entity);+ if (field == "enabled") { return c.enabled; }} else if (comp == "ShapeRenderer") {if (!reg.has<esengine::ecs::ShapeRenderer>(entity)) return false;const auto& c = reg.get<esengine::ecs::ShapeRenderer>(entity);diff --git a/src/esengine/bindings/WebBindings.generated.cpp b/src/esengine/bindings/WebBindings.generated.cppindex f86220eed..298d27c95 100644--- a/src/esengine/bindings/WebBindings.generated.cpp+++ b/src/esengine/bindings/WebBindings.generated.cpp@@ -21,6 +21,7 @@#include "../ecs/components/Light2D.hpp"#include "../ecs/components/ParticleEmitter.hpp"#include "../ecs/components/RigidBody.hpp"+#include "../ecs/components/ShadowCaster2D.hpp"#include "../ecs/components/ShapeRenderer.hpp"#include "../ecs/components/SpineAnimation.hpp"#include "../ecs/components/Sprite.hpp"@@ -967,6 +968,10 @@ EMSCRIPTEN_BINDINGS(esengine_components) {.field("categoryBits", &esengine::ecs::SegmentCollider::categoryBits).field("maskBits", &esengine::ecs::SegmentCollider::maskBits);+ value_object<esengine::ecs::ShadowCaster2D>("ShadowCaster2D")+ .field("size", &esengine::ecs::ShadowCaster2D::size)+ .field("enabled", &esengine::ecs::ShadowCaster2D::enabled);+value_object<esengine::ecs::ShapeRenderer>("ShapeRenderer").field("shapeType", &esengine::ecs::ShapeRenderer::shapeType).field("color", &esengine::ecs::ShapeRenderer::color)@@ -1391,6 +1396,27 @@ EMSCRIPTEN_BINDINGS(esengine_registry) {r.remove<esengine::ecs::SegmentCollider>(entity);}))+ // ShadowCaster2D+ .function("hasShadowCaster2D", optional_override([](Registry& r, u32 e) {+ return r.has<esengine::ecs::ShadowCaster2D>(static_cast<Entity>(e));+ }))+ .function("getShadowCaster2D", optional_override([](Registry& r, u32 e) -> esengine::ecs::ShadowCaster2D& {+ auto entity = static_cast<Entity>(e);+ static esengine::ecs::ShadowCaster2D s_dummy{};+ if (!r.valid(entity) || !r.has<esengine::ecs::ShadowCaster2D>(entity)) return s_dummy;+ return r.get<esengine::ecs::ShadowCaster2D>(entity);+ }), allow_raw_pointers())+ .function("addShadowCaster2D", optional_override([](Registry& r, u32 e, const esengine::ecs::ShadowCaster2D& c) {+ auto entity = static_cast<Entity>(e);+ if (!r.valid(entity)) return;+ r.emplaceOrReplace<esengine::ecs::ShadowCaster2D>(entity, c);+ }))+ .function("removeShadowCaster2D", optional_override([](Registry& r, u32 e) {+ auto entity = static_cast<Entity>(e);+ if (!r.valid(entity) || !r.has<esengine::ecs::ShadowCaster2D>(entity)) return;+ r.remove<esengine::ecs::ShadowCaster2D>(entity);+ }))+// ShapeRenderer.function("hasShapeRenderer", optional_override([](Registry& r, u32 e) {return r.has<esengine::ecs::ShapeRenderer>(static_cast<Entity>(e));@@ -1669,6 +1695,7 @@ emscripten::val esengineGetBuiltinComponentNames() {arr.set(i++, val(std::string("ParticleEmitter")));arr.set(i++, val(std::string("RigidBody")));arr.set(i++, val(std::string("SegmentCollider")));+ arr.set(i++, val(std::string("ShadowCaster2D")));arr.set(i++, val(std::string("ShapeRenderer")));arr.set(i++, val(std::string("SpineAnimation")));arr.set(i++, val(std::string("Sprite")));@@ -1819,6 +1846,8 @@ static_assert(offsetof(esengine::ecs::SegmentCollider, isSensor) == 28, "ABI offstatic_assert(offsetof(esengine::ecs::SegmentCollider, enabled) == 29, "ABI offset drift: esengine::ecs::SegmentCollider.enabled (EHT expected 29)");static_assert(offsetof(esengine::ecs::SegmentCollider, categoryBits) == 32, "ABI offset drift: esengine::ecs::SegmentCollider.categoryBits (EHT expected 32)");static_assert(offsetof(esengine::ecs::SegmentCollider, maskBits) == 36, "ABI offset drift: esengine::ecs::SegmentCollider.maskBits (EHT expected 36)");+static_assert(offsetof(esengine::ecs::ShadowCaster2D, size) == 0, "ABI offset drift: esengine::ecs::ShadowCaster2D.size (EHT expected 0)");+static_assert(offsetof(esengine::ecs::ShadowCaster2D, enabled) == 8, "ABI offset drift: esengine::ecs::ShadowCaster2D.enabled (EHT expected 8)");static_assert(offsetof(esengine::ecs::ShapeRenderer, shapeType) == 0, "ABI offset drift: esengine::ecs::ShapeRenderer.shapeType (EHT expected 0)");static_assert(offsetof(esengine::ecs::ShapeRenderer, color) == 4, "ABI offset drift: esengine::ecs::ShapeRenderer.color (EHT expected 4)");static_assert(offsetof(esengine::ecs::ShapeRenderer, size) == 20, "ABI offset drift: esengine::ecs::ShapeRenderer.size (EHT expected 20)");@@ -1894,7 +1923,7 @@ static_assert(offsetof(esengine::ecs::Velocity, angular) == 12, "ABI offset drif// ABI Hash -- runtime handshake against the SDK bundle// =============================================================================-static const char* kEsAbiLayoutHash = "2896a68ab5ef40b7";+static const char* kEsAbiLayoutHash = "7ac6cfeb8c0c1963";std::string esengineGetAbiLayoutHash() {return std::string(kEsAbiLayoutHash);diff --git a/src/esengine/ecs/components/ShadowCaster2D.hpp b/src/esengine/ecs/components/ShadowCaster2D.hppnew file mode 100644index 000000000..a589b3c8a--- /dev/null+++ b/src/esengine/ecs/components/ShadowCaster2D.hpp@@ -0,0 +1,36 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file ShadowCaster2D.hpp+ * @brief Marks an entity as a 2D shadow occluder for the Lit2D lighting path.+ * @details The render collect path turns each enabled caster into a world-space AABB (centered+ * on the entity's Transform, `size` wide/tall) and feeds it to LightStore as an occluder.+ * A point/spot light is then blocked at any fragment whose segment to the light crosses+ * the box (see ShaderParser's injected es_shadowFactor2D). Carries no geometry of its own.+ *+ * @copyright Copyright (c) 2026 ESEngine Team+ * Licensed under the Apache License, Version 2.0.+ */+#pragma once++#include "../../core/Types.hpp"+#include "../../core/Reflection.hpp"+#include "../../math/Math.hpp"++namespace esengine::ecs {++/**+ * @brief A 2D shadow occluder. The box is centered on the entity's world position.+ */+ES_COMPONENT()+struct ShadowCaster2D {+ /** @brief Occluder box size in world units (full width/height; centered on the Transform). */+ ES_PROPERTY(animatable, min=0, tooltip="Occluder box size in world units (centered on the entity).")+ glm::vec2 size{32.0f, 32.0f};++ /** @brief Disabled casters are skipped during collection. */+ ES_PROPERTY()+ bool enabled{true};+};++} // namespace esengine::ecsdiff --git a/src/esengine/renderer/RenderFrame.cpp b/src/esengine/renderer/RenderFrame.cppindex 46c9c70ea..3336dfba8 100644--- a/src/esengine/renderer/RenderFrame.cpp+++ b/src/esengine/renderer/RenderFrame.cpp@@ -6,6 +6,7 @@#include "LightStore.hpp"#include "../ecs/components/Transform.hpp"#include "../ecs/components/Light2D.hpp"+#include "../ecs/components/ShadowCaster2D.hpp"#include "../resource/ShaderParser.hpp"#include "../core/Log.hpp"@@ -455,6 +456,21 @@ void RenderFrame::collectLights(ecs::Registry& registry) {collected.resize(MAX_LIGHTS_2D);}for (const auto& gpu : collected) lights.addLight(gpu);++ // Shadow occluders: each enabled ShadowCaster2D becomes a world-space AABB (centered on its+ // Transform, `size` wide/tall). The injected es_shadowFactor2D blocks point/spot light at any+ // fragment whose segment to the light crosses a box. Past the cap are silently dropped.+ auto occluders = registry.view<ecs::Transform, ecs::ShadowCaster2D>();+ for (auto entity : occluders) {+ const auto& caster = occluders.get<ecs::ShadowCaster2D>(entity);+ if (!caster.enabled) continue;+ auto& transform = occluders.get<ecs::Transform>(entity);+ transform.ensureDecomposed();+ const glm::vec3 p = transform.worldPosition;+ const f32 hx = caster.size.x * 0.5f;+ const f32 hy = caster.size.y * 0.5f;+ lights.addOccluder(glm::vec4(p.x - hx, p.y - hy, p.x + hx, p.y + hy));+ }}void RenderFrame::collectAll(ecs::Registry& registry, u32 skipFlags) {