Struct CopcStreamingReader 

pub struct CopcStreamingReader<S: ByteSource> { /* private fields */ }

Async streaming COPC reader.

open() reads the LAS header, VLRs, and root hierarchy page. Deeper hierarchy pages and point chunks are loaded on demand.

Implementations

impl<S: ByteSource> CopcStreamingReader<S>

pub async fn open(source: S) -> Result<Self, CopcError>

Open a COPC file.

pub fn header(&self) -> &CopcHeader

The parsed COPC file header.

pub fn copc_info(&self) -> &CopcInfo

Shortcut for header().copc_info().

pub fn evlr_offset(&self) -> u64

File offset where EVLRs start.

pub fn evlr_count(&self) -> u32

Number of EVLRs in the file.

pub fn source(&self) -> &S

The underlying byte source.

pub fn get(&self, key: &VoxelKey) -> Option<&HierarchyEntry>

Look up a hierarchy entry by voxel key.

pub fn entries(&self) -> impl Iterator<Item = (&VoxelKey, &HierarchyEntry)>

Iterate all loaded hierarchy entries.

pub fn children(&self, key: &VoxelKey) -> Vec<&HierarchyEntry>

Return loaded child entries for a given node.

Only returns children that are already in the hierarchy cache. If deeper hierarchy pages haven’t been loaded yet, this may return fewer children than actually exist in the file.

pub fn node_count(&self) -> usize

Number of loaded hierarchy entries.

pub fn has_pending_pages(&self) -> bool

Whether there are hierarchy pages that haven’t been loaded yet.

pub async fn load_pending_pages(&mut self) -> Result<(), CopcError>

Load the next batch of pending hierarchy pages.

pub async fn load_all_hierarchy(&mut self) -> Result<(), CopcError>

Load all remaining hierarchy pages.

pub async fn fetch_chunk( &self, key: &VoxelKey, ) -> Result<DecompressedChunk, CopcError>

Fetch and decompress a single point chunk.

pub fn read_points( &self, chunk: &DecompressedChunk, ) -> Result<Vec<Point>, CopcError>

Parse all points from a decompressed chunk.

pub fn read_points_range( &self, chunk: &DecompressedChunk, range: Range<u32>, ) -> Result<Vec<Point>, CopcError>

Parse a sub-range of points from a decompressed chunk.

Only the points in range are parsed — bytes outside the range are skipped. Pair with NodeTemporalEntry::estimate_point_range from the copc-temporal crate to read only the points that fall within a time window.