Why use it
The API exposes the hardware service without hiding latency or bounded memory.
EPOK RUNTIME
epok::music_prepare
Function · 1 overload
Function
Performs `music prepare` as part of XA music streaming and playback state.
Declaration
Declaration
inline void music_prepare(bool require_data = false)Performs `music prepare` as part of XA music streaming and playback state.
| Parameter | Type | Meaning |
|---|---|---|
require_data | bool | Value supplied for require_data. Keep referenced or pointed-to data valid for the complete call. |
Returns: Nothing (void).
Example
C++ example
#include "music.hpp"
// Assume these named values have been initialized with valid data:
// bool require_data
epok::music_prepare(require_data);Trade-offs and warnings
Treat device absence, busy state and I/O failure as expected outcomes; do not block the frame loop waiting for hardware.
Declared in runtime/music.hpp:143
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