Module las::raw

source ·
Expand description

Raw structures that map directly to their definitions in the las format specifications.

In general, these structures are “dumb”, meaning that they do the least amount of validity checking possible without losing information. Users should prefer to use the non-raw versions, e.g. las::Header over las::raw::Header, in order to ensure that they are following The Rules. into_raw can be used to create the raw versions:

use las::{Vlr, Header, Point};
let raw_header = Header::default().into_raw().unwrap();
let raw_vlr = Vlr::default().into_raw(false).unwrap();
let raw_point = Point::default().into_raw(&Default::default()).unwrap();

Raw structures all have write_to and read_from methods that can be used to put and extract them from streams of bytes:

use las::point::Format;
use las::raw::{Header, Vlr, Point};
use std::io::Cursor;
let mut cursor = Cursor::new(Vec::new());
let point_format = Format::new(3).unwrap();

// Write the structures in an arbitrary order.
Point::default().write_to(&mut cursor, &point_format).unwrap();
Header::default().write_to(&mut cursor).unwrap();
Vlr::default().write_to(&mut cursor).unwrap();

cursor.set_position(0);

// And read them back.
Point::read_from(&mut cursor, &point_format).unwrap();
Header::read_from(&mut cursor).unwrap();
Vlr::read_from(&mut cursor, false).unwrap();

Re-exports§

  • pub use self::header::Header;
  • pub use self::point::Point;
  • pub use self::vlr::Vlr;

Modules§

  • header
    Raw file metadata.
  • point
    Defines raw las points and some enums required to handle the various point formats.
  • vlr
    Variable length records, both extended and regular.

Constants§