Struct pasture_io::las::LASReader

pub struct LASReader<'a, R: Read + Seek + Send + 'a> { /* private fields */ }

PointReader implementation for LAS/LAZ files

Implementations

impl LASReader<'static, BufReader<File>>

pub fn from_path<P: AsRef<Path>>( path: P, point_layout_matches_memory_layout: bool ) -> Result<LASReader<'static, BufReader<File>>>

Creates a new LASReader by opening the file at the given path. Tries to determine whether the file is compressed from the file extension (i.e. files with extension .laz are assumed to be compressed). If point_layout_matches_memory_layout is true, the reader will return point data with a PointLayout that exactly matches the binary layout of the LAS point records. See [point_layout_from_las_point_format] for more information.

Errors

If path does not exist, cannot be opened or does not point to a valid LAS/LAZ file, an error is returned.

impl<'a, R: Read + Seek + Send> LASReader<'a, R>

pub fn from_read( read: R, is_compressed: bool, point_layout_matches_memory_layout: bool ) -> Result<Self>

Creates a new LASReader from the given read. This method has to know whether the read points to a compressed LAZ file or a regular LAS file. If point_layout_matches_memory_layout is true, the reader will return point data with a PointLayout that exactly matches the binary layout of the LAS point records. See [point_layout_from_las_point_format] for more information.

Errors

If the given Read does not represent a valid LAS/LAZ file, an error is returned.

pub fn remaining_points(&self) -> usize

pub fn header(&self) -> &Header

Returns the LAS header for the associated LASReader

pub fn las_metadata(&self) -> &LASMetadata

Returns the LAS metadata for the associated LASReader

Trait Implementations

impl<'a, R: Read + Seek + Send + 'a> PointReader for LASReader<'a, R>

fn get_metadata(&self) -> &dyn Metadata

Returns the Metadata of the associated PointReader

fn get_default_point_layout(&self) -> &PointLayout

Returns the default PointLayout of the associated PointReader

fn read_into<'b, 'c, B: BorrowedMutBuffer<'b>>( &mut self, point_buffer: &'c mut B, count: usize ) -> Result<usize>

where 'b: 'c,

Read count points from this PointReader into the given point_buffer. Uses the PointLayout of the given PointBuffer for reading. If no conversion from the default PointLayout to this new layout are possible, an error is returned. On success, returns the number of points that were read. Overwrites existing data in point_buffer starting at the first point, so the length of point_buffer must be greater than or equal to count

fn read<'a, B: OwningBuffer<'a> + MakeBufferFromLayout<'a> + 'a>( &mut self, count: usize ) -> Result<B>

Reads at most count points from this PointReader into a new buffer of type B. The PointLayout this new buffer will be equal to self.get_default_point_layout

impl<'a, R: Read + Seek + Send + 'a> SeekToPoint for LASReader<'a, R>

fn seek_point(&mut self, position: SeekFrom) -> Result<usize>

Seek to the point at the given position in the underlying stream.

fn point_index(&mut self) -> Result<usize>

Returns the index of the current point in the underlying stream. This is equivalent to calling seek_point(SeekFrom::Current(0)).

fn point_count(&mut self) -> Result<usize>

Returns the total number of points in the underlying stream.