EPOK RUNTIME

epok::streaming_warmup_scene

Function template · 1 overload

Function template

A bounded small-scene startup policy.

Belongs to: epok
Header: streaming.hpp
Overloads: 1

Declaration

template

Declaration

template <class ActorData, class Active> inline bool streaming_warmup_scene(const ActorData *objects, size_t count, Active &&active, psyqo::GPU &gpu)

A bounded small-scene startup policy.

Parameter	Type	Meaning
`objects`	`const ActorData *`	Value supplied for objects. Keep referenced or pointed-to data valid for the complete call.
`count`	`size_t`	Value supplied for count. Keep referenced or pointed-to data valid for the complete call.
`active`	`Active &&`	Value supplied for active. Keep referenced or pointed-to data valid for the complete call.
`gpu`	`psyqo::GPU &`	Value supplied for gpu. 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.

Example

C++ example

#include "streaming.hpp"

// Replace these template arguments with types or values accepted by the declaration:
// ActorData, Active

// Assume these named values have been initialized with valid data:
// const ActorData * objects
// size_t count
// Active && active
// psyqo::GPU & gpu

auto result = epok::streaming_warmup_scene<ActorData, Active>(objects, count, active, gpu);

Why use it

Template dispatch is resolved at compile time and normally adds no runtime indirection. The boolean result makes success, availability or state explicit without exceptions.

Trade-offs and warnings

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. 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/streaming.hpp:261

Related members

aabb_may_touchPerforms `aabb may touch` as part of bounded AABB collision queries and movement.Function template aabb_overlapPerforms `aabb overlap` as part of bounded AABB collision queries and movement.Function template aabb2d_containsPerforms `aabb2d contains` as part of the world2d module.Function aabb2d_overlapPerforms `aabb2d overlap` as part of the world2d module.Function aabb2d_touchPerforms `aabb2d touch` as part of the world2d module.Function aabb2d_translatedPerforms `aabb2d translated` as part of the world2d module.Function activate_texture_bankPerforms `activate texture bank` as part of the epok module.Function active_cameraPerforms `active camera` as part of the epok module.Function actor_for_slotPerforms `actor for slot` as part of the actor tables module.Function allocate_actor_dataPerforms `allocate actor data` as part of the epok module.Function attach_componentSpatial attachment between components of the same domain.Function audio_initializePerforms `audio initialize` as part of SPU sound playback and voice ownership.Function