sc_world_control_v1.raycast_filtered_many

Catalogue snapshot — development preview

SDK 2.4.0 · game pack 0.8.0 · source d16f013c629797275e40124184b261da54cce0ef Published release: sdk-v2.4.0-rc.1 (release candidate 1, attested assets; the final signed release follows; this development preview is not an approved release). Source-backed inventory is not a runtime or in-game verification claim.

Synchronous scoped bounded multi-hit in the requested zone frame; capacity <=64, count-only permitted, ordered distances and explicit omitted count. Same 32 owner-validated skips and distance clamp as single ray. Grid release runs after query even on error/no hit. Malformed records or cleanup failure publish no hits; cleanup failure latches restart-required. Native capability 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, const double *, const double *, double, const uint64_t *, uint32_t, sc_world_hits *)

Service and availability

Service index

Property	Value
Symbol	sc_world_control_v1.raycast_filtered_many
Record ID	sc-world-control-v1-raycast-filtered-many
Service	game.world.control
Table	sc_world_control_v1
Version macro	SC_WORLD_CONTROL_VERSION_1_1
Packed table version	65537
Since / availability	size >= 48; 1.1
Complete member extent (x64 bytes)	48
Table size (x64 bytes)	48

Header source

Parameters and buffers

sco_result (*raycast_filtered_many)(sco_plugin* self, uint64_t zone_id, const double from[3], const double dir[3], double max_dist, const uint64_t* skip_ids, uint32_t skip_count, sc_world_hits* out_hits);
Synchronous scoped bounded multi-hit in the requested zone frame; capacity <=64, count-only permitted, ordered distances and explicit omitted count. Same 32 owner-validated skips and distance clamp as single ray. Grid release runs after query even on error/no hit. Malformed records or cleanup failure publish no hits; cleanup failure latches restart-required. Native capability 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

Provider acquire/query/release scope lasts one call. Successful acquire is paired exactly once with release before output publication; release failure latches unavailable. No retained caller buffers or filters.

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 (*raycast_filtered_many)
cpp	typed-wrapper	include/scosdk/game/world_control.hpp t_->raycast_filtered_many(
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.