pasture-io 0.5.0

Support for reading and writing point cloud files with pasture
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

use anyhow::Result;
use pasture_core::containers::{BorrowedMutBuffer, MakeBufferFromLayout, OwningBuffer};
use pasture_core::layout::PointLayout;
use pasture_core::meta::Metadata;

/// Base trait for all types that support reading point data
pub trait PointReader {
    /// 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_into<'a, 'b, B: BorrowedMutBuffer<'a>>(
        &mut self,
        point_buffer: &'b mut B,
        count: usize,
    ) -> Result<usize>
    where
        'a: '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`
    fn read<'a, B: OwningBuffer<'a> + MakeBufferFromLayout<'a> + 'a>(
        &mut self,
        count: usize,
    ) -> Result<B> {
        let mut buffer = B::new_from_layout(self.get_default_point_layout().clone());
        buffer.resize(count);
        let actual_count = self.read_into(&mut buffer, count)?;
        buffer.resize(actual_count);
        Ok(buffer)
    }

    /// Returns the `Metadata` of the associated `PointReader`
    fn get_metadata(&self) -> &dyn Metadata;
    /// Returns the default `PointLayout` of the associated `PointReader`
    fn get_default_point_layout(&self) -> &PointLayout;
}