EPOK RUNTIME
Function template · 1 overload
Main-thread DMA only.
template<class H=Hardware> bool upload(const void* data,uint32_t address,uint32_t bytes,uint32_t budget=10000000)Main-thread DMA only.
| Parameter | Type | Meaning |
|---|---|---|
data | const void * | Value supplied for data. Keep referenced or pointed-to data valid for the complete call. |
address | uint32_t | Value supplied for address. Keep referenced or pointed-to data valid for the complete call. |
bytes | uint32_t | Value supplied for bytes. Keep referenced or pointed-to data valid for the complete call. |
budget | uint32_t | Value supplied for budget. Keep referenced or pointed-to data valid for the complete call. |
Returns: bool. Check the value before continuing when it represents success, availability or a resource handle.
#include "spu_transfer.hpp"
// Replace these template arguments with types or values accepted by the declaration:
// H
// Assume these named values have been initialized with valid data:
// const void * data
// uint32_t address
// uint32_t bytes
// uint32_t budget
epok::spu& object = /* obtain a valid instance */;
auto result = object.upload<H>(data, address, bytes, budget);Template dispatch is resolved at compile time and normally adds no runtime indirection. The boolean result makes success, availability or state explicit without exceptions. The API exposes the hardware service without hiding latency or bounded memory.
Every instantiated type must satisfy the header's compile-time requirements; extra instantiations can increase code size. Check the return value; `false` is part of normal control flow for many PSX resource operations. Treat device absence, busy state and I/O failure as expected outcomes; do not block the frame loop waiting for hardware. Pointer/reference arguments are borrowed unless the source contract says otherwise; keep them valid for the complete operation and never assume null is accepted.
Declared in runtime/spu_transfer.hpp:23
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