Table of Contents

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, IDisposable

Inheritance

Implements

Inherited Members

Properties

Kind

The format kind of this document.

public override PclFileKind Kind { get; }

Property Value

PclFileKind

MajorVersion

Major version of the E57 file format from the file header.

public uint MajorVersion { get; }

Property Value

uint

MinorVersion

Minor version of the E57 file format from the file header.

public uint MinorVersion { get; }

Property Value

uint

PageSize

Physical page size in bytes from the file header (always 1024).

public ulong PageSize { get; }

Property Value

ulong

ProjectGuid

Identifier stored in the XML section, or an empty string when the file has none.

public string ProjectGuid { get; }

Property Value

string

Scans

The scans contained in the document, in file order.

public override IReadOnlyList<PclScan> Scans { get; }

Property Value

IReadOnlyList<PclScan>

XmlContent

The XML section of the file as text.

public string XmlContent { get; }

Property Value

string

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

path string

Path of the .e57 file.

options PclReadOptions?

Not used when opening; accepted for symmetry with the other readers.

Returns

E57Document

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.