https://github.com/senselogic/pcf
Point cloud file format.
https://github.com/senselogic/pcf
Last synced: 6 months ago
JSON representation
Point cloud file format.
- Host: GitHub
- URL: https://github.com/senselogic/pcf
- Owner: SenseLogic
- License: other
- Created: 2022-01-30T21:00:02.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-06-25T20:16:33.000Z (over 2 years ago)
- Last Synced: 2025-06-13T11:03:56.023Z (6 months ago)
- Language: C++
- Homepage:
- Size: 1.66 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# PCF
Point cloud file format.
## Goals
* Simplicity : uses simple data structures with direct access to the point components.
* Versatility : stores multiple scans with any number of components, properties and images.
* Compactness : minimizes the number of bits per component through spatial clustering.
* Performance : can store huge point clouds in memory and serialize them at high speed.
* Portability : implemented in both C++ and D, without using any external dependencies.
## Installation
### C++ version
Install g++ or [Visual C++ 2019 Community](https://docs.microsoft.com/en-us/visualstudio/releases/2019/redistribution#vs2019-download).
Build the executable with the following command lines :
```bash
cd CODE/CPP/TOOL
./make.sh
```
### D version
Install the [DMD 2 compiler](https://dlang.org/download.html) (using the MinGW setup option on Windows).
Build the executable with the following command lines :
```bash
cd CODE/D/TOOL
./make.sh
```
## Command line
```
pcf [options]
```
### Options
```
--read-pts : read a PTS point cloud file
--read-ptx : read a PTX point cloud file
--read-pcf : write a PTS point cloud file
--write-ptx : write a PTX point cloud file
--write-pcf : write a PCF point cloud file
```
### Examples
```bash
pcf --read-ptx cloud.ptx 8 0.001 --dump --write-pcf cloud.pcf
```
Reads a PTX point cloud file, dumps it, and writes a PCF point cloud file.
```bash
pcf --read-pcf test.pcf --dump --write-ptx test.ptx
```
Reads a PCF point cloud file, dumps it, and writes a PTX point cloud file.
## Version
0.3
## Limitations
* All scans share the same list of components.
* The first three components are expected to be the point coordinates.
* The point order is lost if the coordinate components are discretized.
## Author
Eric Pelzer (ecstatic.coder@gmail.com).
## License
This project is licensed under the GNU Lesser General Public License version 3.
See the [LICENSE.md](LICENSE.md) file for details.