Why use it
The boolean result makes success, availability or state explicit without exceptions.
EPOK RUNTIME
epok::request_scene
Function · 4 overloads
Function
Requests scene as part of the epok module.
Declaration 1 of 4
Declaration
bool request_scene(const char* name)Requests scene as part of the epok module.
| Parameter | Type | Meaning |
|---|---|---|
name | const char * | Value supplied for name. 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 "epok.hpp"
// Assume these named values have been initialized with valid data:
// const char * name
auto result = epok::request_scene(name);Trade-offs and warnings
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/epok.hpp:195
Declaration 2 of 4
Declaration
bool request_scene(const char* name,const TransitionOptions& options)Requests scene as part of the epok module.
| Parameter | Type | Meaning |
|---|---|---|
name | const char * | Value supplied for name. Keep referenced or pointed-to data valid for the complete call. |
options | const TransitionOptions & | Value supplied for options. 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 "epok.hpp"
// Assume these named values have been initialized with valid data:
// const char * name
// const TransitionOptions & options
auto result = epok::request_scene(name, options);Why use it
The boolean result makes success, availability or state explicit without exceptions.
Trade-offs and warnings
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/epok.hpp:197
Declaration 3 of 4
Declaration
bool request_scene(size_t index)Requests scene as part of the epok module.
| Parameter | Type | Meaning |
|---|---|---|
index | size_t | Value supplied for index. 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 "epok.hpp"
// Assume these named values have been initialized with valid data:
// size_t index
auto result = epok::request_scene(index);Why use it
The boolean result makes success, availability or state explicit without exceptions.
Trade-offs and warnings
Check the return value; `false` is part of normal control flow for many PSX resource operations.
Declared in runtime/epok.hpp:194
Declaration 4 of 4
Declaration
bool request_scene(size_t index,const TransitionOptions& options)Requests scene as part of the epok module.
| Parameter | Type | Meaning |
|---|---|---|
index | size_t | Value supplied for index. Keep referenced or pointed-to data valid for the complete call. |
options | const TransitionOptions & | Value supplied for options. 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 "epok.hpp"
// Assume these named values have been initialized with valid data:
// size_t index
// const TransitionOptions & options
auto result = epok::request_scene(index, options);Why use it
The boolean result makes success, availability or state explicit without exceptions.
Trade-offs and warnings
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/epok.hpp:196
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