Why use it
The API maps closely to PSX GPU work, giving predictable ordering and low overhead.
EPOK RUNTIME
epok::draw_key_2d
Function · 1 overload
Function
---- draw order ---------------------------------------------------------------------- A single monotonically comparable key so the renderer never needs a multi-field comparator: layer (int8, coarse) above draw_order (int16) above the creation index (uint16, the tie breaker that makes the order stable and reproducible across frames).
Declaration
Declaration
inline uint64_t draw_key_2d(int8_t layer, int16_t draw_order, uint16_t creation)---- draw order ---------------------------------------------------------------------- A single monotonically comparable key so the renderer never needs a multi-field comparator: layer (int8, coarse) above draw_order (int16) above the creation index (uint16, the tie breaker that makes the order stable and reproducible across frames).
| Parameter | Type | Meaning |
|---|---|---|
layer | int8_t | Value supplied for layer. Keep referenced or pointed-to data valid for the complete call. |
draw_order | int16_t | Value supplied for draw_order. Keep referenced or pointed-to data valid for the complete call. |
creation | uint16_t | Value supplied for creation. Keep referenced or pointed-to data valid for the complete call. |
Returns: uint64_t. Check the value before continuing when it represents success, availability or a resource handle.
Example
C++ example
#include "world2d.hpp"
// Assume these named values have been initialized with valid data:
// int8_t layer
// int16_t draw_order
// uint16_t creation
auto result = epok::draw_key_2d(layer, draw_order, creation);Trade-offs and warnings
Respect packet lifetime, ordering-table direction and per-frame GPU/VRAM budgets; submission is not a desktop immediate-mode draw call.
Declared in runtime/world2d.hpp:262
Related members
aabb_may_touchPerforms `aabb may touch` as part of bounded AABB collision queries and movement.Function templateaabb_overlapPerforms `aabb overlap` as part of bounded AABB collision queries and movement.Function templateaabb2d_containsPerforms `aabb2d contains` as part of the world2d module.Functionaabb2d_overlapPerforms `aabb2d overlap` as part of the world2d module.Functionaabb2d_touchPerforms `aabb2d touch` as part of the world2d module.Functionaabb2d_translatedPerforms `aabb2d translated` as part of the world2d module.Functionactivate_texture_bankPerforms `activate texture bank` as part of the epok module.Functionactive_cameraPerforms `active camera` as part of the epok module.Functionactor_for_slotPerforms `actor for slot` as part of the actor tables module.Functionallocate_actor_dataPerforms `allocate actor data` as part of the epok module.Functionattach_componentSpatial attachment between components of the same domain.Functionaudio_initializePerforms `audio initialize` as part of SPU sound playback and voice ownership.Function