romanesco / Pcx4D

Four dimensional point cloud importer & renderer for Unity

Pcx4D - 4D Point Cloud Importer/Renderer for Unity

Pcx4D is a fork of a Poinc Cloud library called Pcx by Keijiro Takahashi (https://github.com/keijiro/Pcx) for importing 4-dimensional point cloud data.

From version 0.3, we changed the root directory. Now the root directory is Assets/Pcx (or Assets/Pcx4D), so it does not include the whole Unity project any more. Because of that, you can simply use git submodule to include Pcx4D to your Unity project.

Functionalities

• Import and Render 4D PLY files (support both Mesh and ComputeBuffer. See below for more details)

• Support for PLY ASCII format

• 3D PLY files are also supported (note that Pcx4D is upper-compatible with the original Pcx, so Pcx4D conflicts with the original Pcx)

Below is the original README.md for Pcx:

Pcx - Point Cloud Importer/Renderer for Unity

Pcx is a custom importer and renderer that allows handling point cloud data in Unity.

System Requirements

• Unity 2017.3

Pcx uses the 32-bit vertex index format that is newly introduced in Unity 2017.3, so it's not compatible with the previous versions of Unity.

At the time this document is written, Unity 2017.3 is still in the beta testing phase. Note that it possibly introduces some issues with the final released version.

Supported Formats

Currently Pcx only supports PLY binary little-endian format.

Installation

Download one of the unitypackage files from the Releases page and import it to the project.

Container Types

There are two types of container for point clouds.

Mesh

Points are to be contained in a Mesh object. They can be rendered with the standard MeshRenderer component. It's recommended to use the custom shaders included in Pcx (Point Cloud/Point and Point Cloud/Disk).

ComputeBuffer

Points are to be contained in a PointCloudData object, which uses ComputeBuffer to store point data. It can be rendered with using the PointCloudRenderer component.

There are no significant performance difference between these two container types. The ComputeBuffer type is just convenient for animating points with using compute shaders.

Rendering Methods

There are two types of rendering methods in Pcx.

Point (point primitives)

Points are rendered as point primitives when using the Point Cloud/Point shader.

The size of points can be adjusted by the material properties.

These size properties are only supported on some platforms; It may work with OpenGLCore and Metal, but never work with D3D11/12.

This methods is also used when the point size is set to zero in PointCloudRenderer.

Disk (geometry shader)

Points are rendered as small disks when using the Point Cloud/Disk shader or PointCloudRenderer.

This method requires geometry shader support.

Acknowledgements

The point cloud files used in the examples of Pcx are created by authors listed below. These files are licensed under the Creative Commons Attribution license (CC BY 4.0). Please see the following original pages for further details.

• richmond-azaelias.ply - Azaleas, Isabella Plantation, Richmond Park. Created by Thomas Flynn. https://sketchfab.com/models/188576acfe89480f90c38d9df9a4b19a

• anthidium-forcipatum.ply - Anthidium forcipatum ♀ (Point Cloud). Created by Thomas Flynn. https://sketchfab.com/models/3493da15a8db4f34929fc38d9d0fcb2c

• Guanyin.ply - Guanyin (Avalokitesvara). Created by Geoffrey Marchal. https://sketchfab.com/models/9db9a5dfb6744a5586dfcb96cb8a7dc5

License

MIT