Blame
|
1 | ## PLY File Loader |
||||||
|
2 | |||||||
|
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 | ||||||||
|
23 | --- |
||||||
|
24 | |||||||
| 25 | ::: buttonlink |
|||||||
| 26 | [View device source](https://github.com/matth-av/pointcaster/tree/qt/src/plugins/devices/ply) |
|||||||
| 27 | ::: |
|||||||
