sc_game_spatial_v1.pose_to_zone

Convert finite position (metres) and nonzero quaternion x/y/z/w between complete readable rigid zone frames, normalizing rotation; world frame is 0. Position conversion stops at the common ancestor. Outputs may alias corresponding inputs; output arrays must not overlap. Null/nonfinite input or norm below 1e-12 refuses. Outputs unchanged on 0.

Signature

int (*)(uint64_t, uint64_t, const double *, const double *, double *, double *)

Service and availability

Service index

Property	Value
Symbol	`sc_game_spatial_v1.pose_to_zone`
Record ID	`sc-game-spatial-v1-pose-to-zone`
Service	game.spatial
Table	sc_game_spatial_v1
Version macro	SC_GAME_SPATIAL_VERSION
Packed table version	65536
Since / availability	`size >= 16`; 1.0
Complete member extent (x64 bytes)	16
Table size (x64 bytes)	40

Header source

Parameters and buffers

int (*pose_to_zone)(uint64_t from, uint64_t to, const double pos[3], const double rot_xyzw[4], double out_pos[3], double out_rot_xyzw[4]);
Convert finite position (metres) and nonzero quaternion x/y/z/w between complete readable rigid zone frames, normalizing rotation; world frame is 0. Position conversion stops at the common ancestor. Outputs may alias corresponding inputs; output arrays must not overlap. Null/nonfinite input or norm below 1e-12 refuses. Outputs unchanged on 0.

Results and failures

1 success; 0 invalid input, wrong thread, missing readiness, unreadable/unstreamed/incomplete ancestry, expired epoch, ambiguous name or quota refusal. All outputs unchanged on 0.

Absent capability

Absent table: query_service NOT_FOUND. Missing game readiness: 0.

Ownership

Caller-owned copied records/buffers; opaque session IDs and epoch tokens, never pointers. Fixed 256-record storage; bounded temporary trees may allocate. No retained caller inputs or allocation transfer.

Thread affinity

Game thread only; non-reentrant; no callbacks.

Callback context

No callbacks.

Reentrancy

Recursive calls unsupported.

Cleanup and cancellation

Synchronous read; no cancellation. Stop clears observations and expires epochs. Table lives until plugins unload; no calls after shutdown admission.

Language mappings

Status labels are copied verbatim from the catalogue: direct is native access; typed-wrapper is wrapper-backed; restricted is a subset/adaptation; unsupported means no supported route is established. No status implies universal safety.

Language	Catalogue status	Source evidence / wrapper tokens
c	direct	include/sc_game_spatial.h `(*pose_to_zone)`
cpp	direct	include/sc_game_spatial.h `(*pose_to_zone)`
csharp	unsupported	include/sc_game_spatial.h `C# and Lua unsupported`
lua	unsupported	include/sc_game_spatial.h `C# and Lua unsupported`

Examples

None identified in the catalogue; this is not proof none can exist.

Tests

ABI pins prove layout, not semantic behavior or a live game session.