SurfaceSupportSampler3D

Physics-backed 3D support sampler. Casts deterministic downward rays across a GRID footprint. The returned evidence is consumed by [SurfaceSupportEvaluator3D]; this class owns no placement policy.

Source: addons/grid_placement/systems/building/3d/surface_support_sampler_3d.gd

Syntax

class SurfaceSupportSampler3D extends RefCounted

Members

Name	Kind	Summary
SAMPLES_PER_CELL	Field	Four quadrant samples per footprint cell.
RAY_ORIGIN_ABOVE	Field	Start far enough above ordinary terrain relief to avoid originating below it.
RAY_LENGTH	Field	Maximum supported vertical search distance.
ROLE_GRID	Field
ROLE_CENTER	Field
supported	Property	One downward support ray: where it landed (or the intended X/Z on a miss), the surface normal (zero on a miss), and its role: a footprint coverage sample or the explicit footprint-center probe.
position	Property
normal	Property
role	Property
surface_name	Property
sample_footprint	Method
samples	Property
space_state	Property
highest_reference_y	Property
center_sum	Property
cell_center	Property
grid_surface	Property
origin_y	Property
step	Property
start_offset	Property
grid_basis	Property
cell_center	Property
local_offset	Property
world_offset	Property
sample_xz	Property
footprint_center	Property
origin	Property
target	Property
query	Property
hit	Property
collider	Property