Class PinPointScan
- Namespace
- PclIO.Formats.PinPoint
- Assembly
- PclIO.dll
Scan representation in a PinPoint project.
public sealed class PinPointScan : PclScanInheritance
Inherited Members
Properties
BinFilePath
Path of the point data file, or null when it was not found.
public string? BinFilePath { get; }Property Value
HasColors
True only when the point data file has a colour channel.
public override bool HasColors { get; }Property Value
HasIntensities
True only when the point data file has an intensity channel.
public override bool HasIntensities { get; }Property Value
HasNormals
True only when the point data file has a normals channel.
public override bool HasNormals { get; }Property Value
Id
Identifier of the scan within its document (taken from the file when it has one).
public override string Id { get; }Property Value
Name
Display name of the scan.
public override string Name { get; }Property Value
PointCount
Point count from the manifest or the channel table; 0 when it is not recorded.
public override long PointCount { get; }Property Value
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
optionsPclReadOptions?
Returns
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.