Struct PointDataBuilder 

pub struct PointDataBuilder { /* private fields */ }

Builder for PointData.

Construct via PointDataBuilder::new, configure the point format and coordinate transforms, then finalize with one of:

• build — an empty PointData, sized to zero points.
• build_from_bytes — wrap an existing Vec<u8> of tightly-packed records for the configured format.
• build_from_points — encode owned Points against the configured format and transforms.

Configure by either passing a Header wholesale with for_header — the typical case when you already have a Reader or Writer in hand — or by setting the pieces individually with with_format and with_transforms.

The format and transforms are cached for per-point accessor dispatch and must match the file these records will be filled from or were produced from.

Example

use las::{PointDataBuilder, Reader};

let reader = Reader::from_path("tests/data/autzen.las").unwrap();
let points = PointDataBuilder::new().for_header(reader.header()).build();
assert!(points.is_empty());

Implementations

impl PointDataBuilder

pub fn new() -> Self

Creates a new builder with default format and transforms.

pub fn with_format(self, format: Format) -> Self

Sets the point format the resulting PointData will be decoded against.

pub fn with_transforms(self, transforms: Vector<Transform>) -> Self

Sets the coordinate transforms applied when decoding x/y/z.

pub fn for_header(self, header: &Header) -> Self

Configures format and transforms from a Header.

Shorthand for chaining with_format(*header.point_format()) and with_transforms(*header.transforms()). Works equally well with reader.header(), writer.header(), or a Header built manually via Builder.

Example

use las::{PointDataBuilder, Reader};

let reader = Reader::from_path("tests/data/autzen.las").unwrap();
let points = PointDataBuilder::new().for_header(reader.header()).build();
assert!(points.is_empty());

pub fn build(self) -> PointData

Builds an empty PointData.

pub fn build_from_bytes(self, bytes: Vec<u8>) -> Result<PointData>

Builds a PointData by taking ownership of an existing byte buffer.

The byte buffer must be a sequence of tightly-packed point records for the configured format — i.e. its length must be a multiple of the format’s record length. Useful for callers that already have a decompressed Vec<u8> in hand (custom decompressor, memory-mapped region, received over the wire).

Errors

Returns Error::InvalidCloudByteLength if bytes.len() is not a multiple of the format’s record length.

Example

use las::{point::Format, PointDataBuilder, Transform, Vector};

let format = Format::new(0).unwrap();
let transforms: Vector<Transform> = Default::default();
let record_len = format.len() as usize;
let bytes = vec![0u8; record_len * 5];
let points = PointDataBuilder::new()
    .with_format(format)
    .with_transforms(transforms)
    .build_from_bytes(bytes)
    .unwrap();
assert_eq!(points.len(), 5);

pub fn build_from_points<I>(self, points: I) -> Result<PointData>

where I: IntoIterator<Item = Point>,

Builds a PointData by encoding owned Points against the configured format and transforms.

This is the bulk-write counterpart to Reader::read_points: if you’re constructing points programmatically (not reading a file), hand them here and pass the result to Writer::write_points.

Errors

Returns an error if any point’s optional field set doesn’t match the target format, or if a coordinate transform overflows.

Trait Implementations

impl Clone for PointDataBuilder

fn clone(&self) -> PointDataBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PointDataBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PointDataBuilder

fn default() -> PointDataBuilder

Returns the “default value” for a type.