Class E57Document
- Namespace
- PclIO.Formats.E57
- Assembly
- PclIO.dll
An ASTM E57 3D Imaging Data File (.e57). Supported: the file header, the checksummed page layout, the XML section, scan names, ids, Cartesian bounds and poses (translation and rotation quaternion), and points stored as uncompressed bit-packed streams where Cartesian X/Y/Z are single or double precision floats and colour or intensity are Integer fields in the range 0..255. Not supported (reported with System.NotSupportedException when points are read): scaled-integer or integer coordinates, other codecs, and packets whose streams hold different record counts. Spherical coordinates, per-point invalid-state flags, images and 2D data are not interpreted.
public sealed class E57Document : PclDocument, IDisposableInheritance
Implements
Inherited Members
Properties
Kind
The format kind of this document.
public override PclFileKind Kind { get; }Property Value
MajorVersion
Major version of the E57 file format from the file header.
public uint MajorVersion { get; }Property Value
MinorVersion
Minor version of the E57 file format from the file header.
public uint MinorVersion { get; }Property Value
PageSize
Physical page size in bytes from the file header (always 1024).
public ulong PageSize { get; }Property Value
ProjectGuid
Identifier stored in the XML section, or an empty string when the file has none.
public string ProjectGuid { get; }Property Value
Scans
The scans contained in the document, in file order.
public override IReadOnlyList<PclScan> Scans { get; }Property Value
XmlContent
The XML section of the file as text.
public string XmlContent { get; }Property Value
Methods
Open(string, PclReadOptions?)
Opens an E57 file and reads its header and XML section; point data is read lazily.
public static E57Document Open(string path, PclReadOptions? options = null)Parameters
pathstring-
Path of the .e57 file.
optionsPclReadOptions?-
Not used when opening; accepted for symmetry with the other readers.
Returns
Exceptions
- FileNotFoundException
-
The file does not exist.
- InvalidDataException
-
The header, a page checksum or the XML section is malformed or truncated.
- NotSupportedException
-
The format version is not supported.