Blame

03c06d Matt Hughes 2026-08-12 10:57:52
1
## PLY File Loader
0be088 Matt Hughes 2026-08-12 01:23:39
2
002f8b Matt Hughes 2026-10-11 19:23:54
3
The PLY File Loader plays back point clouds stored as [PLY](https://paulbourke.net/dataformats/ply/) files, in either ASCII or binary format. It can open a single file as a static cloud, or a folder of `.ply` files as a sequence. Sequence frames are played in filename order.
4
*[PLY]: Polygon File Format
5
6
Sequences stream from disk. Upcoming frames are prefetched and buffered in the background, so long recordings don't need to fit in memory.
7
8
### Device Properties
9
- **File**: the `.ply` file or folder to load.
10
- **Position Units**: the units positions are stored in. _Automatic_ treats floating point positions as metres and integer positions as millimetres.
11
- **Sequence**: playback settings for folders.
12
- **Looping**: restart from the start frame after reaching the end frame.
13
- **Frame Rate**: playback speed in frames per second.
14
- **Start Frame / End Frame**: the range of frames to play. An end frame of `-1` plays to the last file.
15
- **Current Frame**: the frame being displayed. Can be used to scrub through a sequence.
16
- **Buffer Capacity**: the number of decoded frames held in memory.
17
- **Prefetch Ahead**: the number of frames to decode ahead of playback.
18
- **Attributes**: how extra per-point properties in the file are imported.
19
- **Target**: the point attribute this property is read into, e.g. _Point Scale_ for per-point sizes.
20
- **Precision**: store values at full precision, or quantised to 16 or 8 bits to save memory and network bandwidth.
21
- **Range Min / Range Max**: the range of values preserved when quantising.
22
a7372d Matt Hughes 2026-08-12 12:00:37
23
---
0be088 Matt Hughes 2026-08-12 01:23:39
24
25
::: buttonlink
26
[View device source](https://github.com/matth-av/pointcaster/tree/qt/src/plugins/devices/ply)
27
:::