EPOK RUNTIME

epok::dispatch_trigger

Function · 1 overload

Function

Collision is owned by the spatial services, not by the Level: they resolve the legacy slot to its actor and call this, which fans the event out to the owner's components in registration order.

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

Declaration

inline size_t dispatch_trigger(Level& level, ObjectId actor, DataHandle other, TriggerPhase phase)

Collision is owned by the spatial services, not by the Level: they resolve the legacy slot to its actor and call this, which fans the event out to the owner's components in registration order.

Parameter	Type	Meaning
`level`	`Level &`	Value supplied for level. Keep referenced or pointed-to data valid for the complete call.
`actor`	`ObjectId`	Value supplied for actor. Keep referenced or pointed-to data valid for the complete call.
`other`	`DataHandle`	Value supplied for other. Keep referenced or pointed-to data valid for the complete call.
`phase`	`TriggerPhase`	Value supplied for phase. Keep referenced or pointed-to data valid for the complete call.

Returns: size_t. Check the value before continuing when it represents success, availability or a resource handle.

Example

C++ example

#include "object_model.hpp"

// Assume these named values have been initialized with valid data:
// Level & level
// ObjectId actor
// DataHandle other
// TriggerPhase phase

auto result = epok::dispatch_trigger(level, actor, other, phase);

Why use it

It provides direct, allocation-conscious access to the object model module. No exception-based error path is implied by the signature.

Trade-offs and warnings

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/object_model.hpp:1238

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