sc_world_control_v1.camera_acquire

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.

Exclusive owner-scoped camera lease; output token zero on failure. Same owner reacquire returns same token; foreign owner FAILED. Provider captures all camera/input/mode state before mutation; acquire failure atomic. UNAVAILABLE without complete verified offline adapter and cleanup hook. Capability game.world.free_camera remains OFF.

Limitations / unestablished guarantees

• Synthetic provider verification only; Windows engine integration/gameplay not verified.
• Production adapter deliberately absent; mutation/read-filter capabilities OFF.
• Per-call bounds are not a native-plugin security sandbox.

Signature

sco_result (*)(sco_plugin *, uint64_t *)

Service and availability

Service index

Property	Value
Symbol	sc_world_control_v1.camera_acquire
Record ID	sc-world-control-v1-camera-acquire
Service	game.world.control
Table	sc_world_control_v1
Version macro	SC_WORLD_CONTROL_VERSION_1_0
Packed table version	65536
Since / availability	size >= 24; 1.0
Complete member extent (x64 bytes)	24
Table size (x64 bytes)	40

Header source

Parameters and buffers

sco_result (*camera_acquire)(sco_plugin* self, uint64_t* out_lease);
Exclusive owner-scoped camera lease; output token zero on failure. Same owner reacquire returns same token; foreign owner FAILED. Provider captures all camera/input/mode state before mutation; acquire failure atomic. UNAVAILABLE without complete verified offline adapter and cleanup hook. Capability game.world.free_camera remains OFF.

Results and failures

BAD_ARG invalid owner/input; WRONG_THREAD; UNAVAILABLE absent verified adapter or restart-required; FAILED foreign owner/provider refusal; NOT_FOUND stale lease/no hit. See method-specific output contract.

Absent capability

Absent service: query_service NOT_FOUND; present disabled operation: UNAVAILABLE.

Ownership

Live owner required; call-only copied inputs, host-session borrowed table. No allocation or engine pointers cross boundary. Camera lease exclusive; no steal.

Thread affinity

Game thread only; WRONG_THREAD without provider access.

Callback context

No plugin callbacks. Host-only provider callbacks synchronous, bounded, nonthrowing.

Reentrancy

Recursive calls refused with FAILED; no waits or async work.

Cleanup and cancellation

No persisted ray filter. Ordinary owner unload/service stop restores camera before dropping lease; failure retains backing state and requires restart. Fault-retained native provider cleanup not promised.

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_world_control.h (*camera_acquire)
cpp	typed-wrapper	include/scosdk/game/world_control.hpp t_->camera_acquire(
csharp	unsupported	docs/design/world-control.md C# and sandboxed Lua: unsupported
lua	unsupported	docs/design/world-control.md C# and sandboxed Lua: unsupported

Examples

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

Tests

• tests/abi_world_control.c
• tests/test_world_control.cpp

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