feat(render): #85 engine sprite-render system + deprecate bare draw_sprite
The engine already auto-ticks SpriteAnim/Motion; it now auto-DRAWS too. Declare a Sprite component (id/offx/offy/scale/flip/tint/hidden, shipped from ludic.core) on an entity with a Position and esys_sprite draws it each Render frame — no hand-written Render handler, no hand animation (adds the SpriteAnim frame when present). Registered on the engine-system registry (Render) and spliced only when the game declares Sprite, so a game that never declares it compiles byte-identically; opt out by omitting Sprite or `disable system esys_sprite`. Deprecates the bare draw_sprite/draw_sprite_scaled globals in favour of Screen.sprite/Screen.sprite_scaled: a direct bare call emits a one-time compile-time deprecation note (the bare form still lowers, since Screen.sprite uses it); migrates the chronorift demo to the namespaced calls (golden render byte-identical). Example sprite_render (pixel-readback: engine draws the sprite, respects hidden). Full suite 109/0, goldens byte-identical, fixpoint holds. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
d9287d6b1d
commit
57b8747c31
11 changed files with 18366 additions and 18002 deletions
32
examples/library/sprite_render.ludic
Normal file
32
examples/library/sprite_render.ludic
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# sprite_render.ludic — the engine-owned sprite-render system (#85). Declare a
|
||||
# Sprite component (from ludic.core) on an entity with a Position and the engine
|
||||
# draws it each Render frame — no hand-written Render handler querying positions
|
||||
# and calling draw_sprite per entity. A `hidden` sprite is skipped. Verified by
|
||||
# pixel readback after one frame.
|
||||
#
|
||||
# Driven headless by one stdin key ('q' quits after the frame renders).
|
||||
# printf 'q' | LUDIC_MODULES=packages bin/ludic examples/library/sprite_render.ludic -> 1 0
|
||||
program SpriteRender {
|
||||
import "ludic.core/components.ludic"
|
||||
|
||||
var HERO: int = 0
|
||||
|
||||
@OnStart handler Boot {
|
||||
HERO = png_load("assets/kenney/tiny-dungeon/Tiles/tile_0096.png")
|
||||
spawn Shown { Position { x: 40, y: 40 }, Sprite { id: HERO } }
|
||||
spawn Hidden { Position { x: 100, y: 40 }, Sprite { id: HERO, hidden: 1 } }
|
||||
}
|
||||
|
||||
# An empty Render handler: the engine sprite system draws the Sprite entities.
|
||||
handler Draw phase Render { }
|
||||
|
||||
@OnQuit handler Report {
|
||||
var drew = 0
|
||||
for yy in 40 .. 56 { for xx in 40 .. 56 { if Screen.pixel(xx, yy) != 0 { drew = 1 } } }
|
||||
print(drew) # 1 — the engine drew the shown sprite
|
||||
|
||||
var hid = 0
|
||||
for yy in 40 .. 56 { for xx in 100 .. 116 { if Screen.pixel(xx, yy) != 0 { hid = 1 } } }
|
||||
print(hid) # 0 — the hidden sprite was skipped
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue