Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
prototype limit is the packet header bound of 65535 fields.
- The EdgeWise cluster position scale is now `PclReadOptions.EdgeWiseCoordinateScale`, so the caller states it; the
default keeps the long-standing assumption (32768 units = 0.128 m).
- The LAS exporter writes 1.4 with point formats 6 to 8 (`PclLasOptions` selects version, format, scale and offset);
1.2 with point format 2 stays the default and is byte-identical to before. A projected `EPSG:NNNN` coordinate system
of the source is written as a GeoTIFF record for LAS 1.2 when asked; LAS 1.4 point formats 6 and above require WKT,
which the exporter does not produce, so a 1.4 file carries no coordinate system record.

## [0.1.0] - 2026-11-15

Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ PclIO is a .NET library and command line tool that reads point cloud files from

- Detects the format of a file or folder from its content, extension or layout (`PclFile.DetectKind`).
- Opens a file as a `PclDocument` with its scans, bounds, transforms, metadata and warnings, and streams the points (`ReadAllPoints`, `PclScan.ReadPoints`) with a point limit, a subsampling step and an optional scan transform.
- Exports to ASPRS LAS 1.2 (point format 2), ASCII XYZ, ASCII PTS and JSON.
- Exports to ASPRS LAS 1.2 (point format 2) and 1.4 (point formats 6 to 8), ASCII XYZ, ASCII PTS and JSON.
- Ships the command line tool `pclio` with `info`, `scans`, `points` and `export`.

## Install
Expand Down Expand Up @@ -125,7 +125,7 @@ outside the file is fetched.

| Output | Class | Notes |
| --- | --- | --- |
| LAS 1.2, point format 2 | `PclLasExporter` | Position, intensity, classification, RGB. Fixed 1 mm scale. |
| LAS 1.2, point format 2<br>LAS 1.4, point formats 6 to 8 | `PclLasExporter` (`PclLasOptions` selects version, format, scale, offset and coordinate system record) | Position, intensity, classification, RGB (formats 2 and 7/8; format 8 adds a zero near infrared). 1 mm scale and offset from the data by default. A projected `EPSG:NNNN` coordinate system of the source is written as a GeoTIFF record for LAS 1.2 only when asked; LAS 1.4 requires WKT, which the exporter does not produce, so a 1.4 file carries no coordinate system record. |
| XYZ | `PclXyzExporter` | `X Y Z R G B` when the point has a colour, else `X Y Z I` when it has an intensity, else `X Y Z`. |
| PTS | `PclPtsExporter` | A line with the point count, then `X Y Z Intensity R G B` per point. |
| JSON | `PclJsonExporter` | Metadata and scans; sample points only when a point limit above zero is given. |
Expand Down Expand Up @@ -203,7 +203,7 @@ See the [public API](docs/public-api.md) for the supported surface and [dependen
- Readers limit the sizes and counts that a file declares; the numbers are listed under Limits. A file that exceeds a limit is rejected, with the exceptions described there. Some readers drop points that fail a plausibility rule; see Data filters.
- `SubsampleStep` is applied inside each format's internal blocks, so the spacing is approximate. `MaxPoints` limits one read call.
- A scan transform is scale and translation, or a 4x4 matrix when the format gives one. Rotation values of a `PclTransform` are stored for information and are not applied by `TransformPoint`.
- LAS and PTS export read the source twice (the header needs the count), so the source must be re-enumerable; memory does not depend on the number of points. A point without intensity is written with full intensity and a point without colour as white, because these formats have no "missing" value. LAS stores coordinates with a 1 mm scale, so the extent of each axis must not exceed about 2147 km.
- LAS and PTS export read the source twice (the header needs the count), so the source must be re-enumerable; memory does not depend on the number of points. A point without intensity is written with full intensity and a point without colour as white, because these formats have no "missing" value. LAS stores coordinates with the configured scale (1 mm by default), so the extent of each axis must fit 32-bit integers at that scale; the default offset is the minimum of the data.
- Normals are read where a format has them, but no exporter writes them.
- There is no support for writing or modifying scan files.

Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ file that exceeds a limit is rejected with `InvalidDataException`, with the exce
and counts are listed in the repository README.
- `SubsampleStep` is applied inside each format's internal blocks, so the spacing is approximate; `MaxPoints` limits one read call.
- LAS and PTS export read the source twice; memory does not depend on the number of points. A point without intensity is written with full
intensity and a point without colour as white. LAS uses a 1 mm scale, so the extent of each axis must not exceed about 2147 km.
intensity and a point without colour as white. LAS uses a 1 mm scale by default, so the extent of each axis must fit 32-bit integers at the configured scale.
- Normals are read where a format has them but no exporter writes them.
- Rotation values of a `PclTransform` are stored for information and are not applied by `TransformPoint`.

Expand Down
2 changes: 1 addition & 1 deletion docs/public-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ is empty, rooted, contains invalid characters or resolves outside the folder is

| Type | Use |
|---|---|
| `PclLasExporter` | `Export(doc, stream, options)` writes ASPRS LAS 1.2, point format 2, with a 1 mm scale. Returns the number of points written. |
| `PclLasExporter` / `PclLasOptions` / `LasVersion` | `Export(doc, stream, options, lasOptions)` writes ASPRS LAS 1.2 (point format 2) or 1.4 (point formats 6 to 8), with a configurable scale (default 1 mm) and offset (default the minimum of the data). A projected `EPSG:NNNN` coordinate system of the source is written as a GeoTIFF record for LAS 1.2 when asked; LAS 1.4 requires WKT, which the exporter does not produce, so a 1.4 file carries no coordinate system record. Returns the number of points written. |
| `PclXyzExporter` | `Export(doc, writer, options)` writes `X Y Z R G B`, or `X Y Z I`, or `X Y Z` per point. |
| `PclPtsExporter` | `Export(doc, writer, options)` writes the point count, then `X Y Z Intensity R G B` per point. |
| `PclJsonExporter` | `Export(doc, writer, indented, maxPoints)` writes metadata, scans and, when `maxPoints` is above zero, sample points. |
Expand Down
Loading
Loading