sc_entities_v1.get_transform

Catalogue snapshot — development preview

SDK 2.3.0 · game pack 0.6.0 · source e616ed69d8f9f77b0f4827881c86d91e4a7d1689 Published release: sdk-v2.3.0 (immutable approved assets; this development preview is not an approved release). Source-backed inventory is not a runtime or in-game verification claim.

The entity’s position (3 doubles) and rotation (x, y, z, w) in its zone’s local frame, and that zone’s id. Any out pointer may be NULL to skip it, not all of them. Outputs are zeroed on failure. SCO_NOT_FOUND: the entity isn’t streamed in, or isn’t in a zone. SCO_UNAVAILABLE: no “game.entities.transform”. Read-only: last_error(NULL, …). Implementation also FAILED for changed rotation slots or read fault; id 0 BAD_ARG.

Limitations / unestablished guarantees

• Internal allocation unspecified.
• Recursive reentrancy unspecified except unwatch in callback.
• Additional failures/output state unspecified unless described in the buffer contract.
• Game-service behavior not verified in a game session.

Signature

sco_result (*)(uint64_t, double *, double *, uint64_t *)

Service and availability

Service index

Property	Value
Symbol	sc_entities_v1.get_transform
Record ID	sc-entities-v1-get-transform
Service	game.entities
Table	sc_entities_v1
Version macro	SC_ENTITIES_VERSION_1_1
Packed table version	65537
Since / availability	size >= 32; 1.0
Complete member extent (x64 bytes)	32
Table size (x64 bytes)	96

Header source

Parameters and buffers

sco_result (*get_transform)(uint64_t entity_id, double out_pos[3], double out_rot_xyzw[4], uint64_t* out_zone_id);
The entity’s position (3 doubles) and rotation (x, y, z, w) in its zone’s local frame, and that zone’s id. Any out pointer may be NULL to skip it, not all of them. Outputs are zeroed on failure. SCO_NOT_FOUND: the entity isn’t streamed in, or isn’t in a zone. SCO_UNAVAILABLE: no “game.entities.transform”. Read-only: last_error(NULL, …). Implementation also FAILED for changed rotation slots or read fault; id 0 BAD_ARG.

Results and failures

Absent table: query_service NOT_FOUND; missing operation capability: UNAVAILABLE (alive: 0); invalid/released self: BAD_ARG. Additional failures/output state unspecified unless described in the buffer contract.

Absent capability

Absent table: query_service NOT_FOUND

Ownership

Caller buffers; no allocation crosses boundary. Host owns entity/watch tracking; IDs are session values. Internal allocation unspecified.

Thread affinity

Game thread only (WRONG_THREAD elsewhere, alive returns 0); last_error any thread. Recursive reentrancy unspecified except unwatch in callback.

Callback context

unspecified

Reentrancy

unspecified

Cleanup and cancellation

No in-flight cancellation entrypoint; owned entities removed and watches ended on ordinary unload/non-retained crash cleanup, except kept entities. Retained-provider faults skip owner resource-release hooks and require restart; backing resources remain retained, not safe for cached calls.

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_entities.h (*get_transform)
cpp	typed-wrapper	include/scosdk/game/entities.hpp return t_ && Covers(t_->size, offsetof(sc_entities_v1, get_transform)) && t_->get_transform ? t_->get_transform(id, pos, rot, &zoneId) : SCO_UNAVAILABLE;
csharp	typed-wrapper	sdk/csharp/Sco.Sdk/Game/Entities.cs r = _t->get_transform(id, p, q, &z);
lua	typed-wrapper	plugins/lua/sco_lua_game.c const sco_result r = GAME_MEMBER(e, sc_entities_v1, get_transform) ? e->get_transform(id, pos, rot, &zone) : SCO_UNAVAILABLE;

Examples

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

Tests

• tests/abi_game_entities.c
• tests/test_app.cpp
• tests/test_lua.cpp
• tests/test_language_routes.cpp
• sdk/csharp/Sco.Sdk.Tests/GameFakeHost.cs
• tests/test_language_routes.c
• tools/test.sh
• sdk/csharp/Sco.Sdk.Tests/GameLayout.cs

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