Struct GpuSpatialFrame 

pub struct GpuSpatialFrame { /* private fields */ }

Owned GPU-resident point frame with explicit schema and device identity.

Implementations

impl GpuSpatialFrame

pub fn new( runtime: &WgpuRuntime, schema: PointSchema, positions: GpuAoSoXyzBuffer, ) -> SpatialResult<Self>

Creates a frame owning interleaved positions on runtime.

pub const fn schema(&self) -> &PointSchema

Returns the source point schema.

pub const fn point_count(&self) -> usize

Returns the number of source points.

pub const fn positions(&self) -> &GpuAoSoXyzBuffer

Returns retained interleaved positions.

pub const fn normals(&self) -> Option<&GpuAoSoNormals>

Returns retained normals when attached.

pub const fn voxel_segments(&self) -> Option<&GpuVoxelSegments>

Returns retained voxel segments when attached.

pub const fn radius_grid(&self) -> Option<&GpuAoSoRadiusGrid>

Returns retained radius grid when attached.

pub const fn receipt(&self) -> &GpuExecutionReceipt

Returns execution and transfer accounting.

pub fn has_capability(&self, capability: GpuFrameCapability) -> bool

Returns whether a capability is currently attached.

pub fn validate_runtime(&self, runtime: &WgpuRuntime) -> SpatialResult<()>

Verifies that runtime owns the frame’s buffers.

pub fn attach_normals( &mut self, runtime: &WgpuRuntime, normals: GpuAoSoNormals, ) -> SpatialResult<()>

Attaches per-point normal output after validating length and device.

pub fn attach_voxel_segments( &mut self, segments: GpuVoxelSegments, ) -> SpatialResult<()>

Attaches voxel segments after validating their source point count.

pub fn attach_radius_grid( &mut self, grid: GpuAoSoRadiusGrid, ) -> SpatialResult<()>

Attaches a sparse radius grid after validating its point count.

pub fn attach_attributes( &mut self, runtime: &WgpuRuntime, attributes: Vec<GpuAoSoAttributeChunk>, ) -> SpatialResult<()>

Attaches interleaved attribute chunks after validating total length.

pub fn rebuild_radius_grid( &mut self, runtime: &WgpuRuntime, radius: f32, ) -> SpatialResult<()>

Rebuilds the sparse radius grid from retained positions.

pub fn estimate_normals( &mut self, runtime: &WgpuRuntime, radius: f32, ) -> SpatialResult<()>

Estimates normals using a cached matching grid or rebuilds it first.

pub fn reduce_attributes( &mut self, runtime: &WgpuRuntime, aggregation: AoSoAAttributeAggregation, ) -> SpatialResult<AoSoAAttributeReduction>

Reduces attached interleaved attributes using retained voxel segments.

pub fn readback_positions( &mut self, runtime: &WgpuRuntime, ) -> SpatialResult<Vec<[f32; 3]>>

Explicitly reads interleaved positions back to CPU memory.

pub fn recycle(self, runtime: &WgpuRuntime) -> SpatialResult<()>

Recycles pooled frame buffers after validating the runtime device.