Table of Contents

Class PinPointScan

Namespace
PclIO.Formats.PinPoint
Assembly
PclIO.dll

Scan representation in a PinPoint project.

public sealed class PinPointScan : PclScan

Inheritance

Inherited Members

Properties

BinFilePath

Path of the point data file, or null when it was not found.

public string? BinFilePath { get; }

Property Value

string?

HasColors

True only when the point data file has a colour channel.

public override bool HasColors { get; }

Property Value

bool

HasIntensities

True only when the point data file has an intensity channel.

public override bool HasIntensities { get; }

Property Value

bool

HasNormals

True only when the point data file has a normals channel.

public override bool HasNormals { get; }

Property Value

bool

Id

Identifier of the scan within its document (taken from the file when it has one).

public override string Id { get; }

Property Value

string

Name

Display name of the scan.

public override string Name { get; }

Property Value

string

PointCount

Point count from the manifest or the channel table; 0 when it is not recorded.

public override long PointCount { get; }

Property Value

long

Methods

ReadPoints(PclReadOptions?)

Streams points from the point data file; yields nothing when the file was not found.

public override IEnumerable<PclPoint> ReadPoints(PclReadOptions? options = null)

Parameters

options PclReadOptions?

Returns

IEnumerable<PclPoint>

Remarks

Points are positions as float32 triples. Points with a NaN or infinite coordinate, or with any coordinate whose magnitude exceeds 5000 in the file's own unit, are not returned and are not counted; the remaining points keep consecutive PclIO.PclPoint.Index values. The magnitude limit is a plausibility rule of this reader, not a property of the file format, so positions in a projected coordinate system with large offsets are dropped. PclIO.Formats.PinPoint.PinPointScan.PointCount reports the manifest or channel-table count, so it can be larger than the number of returned points.

A point data file whose layout is neither a table of named channels nor a list of sections with a property table is not decoded, because the file does not describe its layout. Of the channels of the sectioned layout the positions ("Points"), colours ("RGB8", three bytes per point) and intensities ("Intensities8") are read; the per-point flags and the grid indices stored next to them are not interpreted, so every stored point is returned.

Exceptions

InvalidDataException

The point data file is damaged.

NotSupportedException

The point data file has no recognised channel layout, or uses a feature of the sectioned layout that is not supported.