Skip to content

Latest commit

 

History

History
125 lines (82 loc) · 3.65 KB

README.md

File metadata and controls

125 lines (82 loc) · 3.65 KB
Raw

Pcx - Point Cloud Importer/Renderer for Unity

GIF GIF

Pcx is a custom importer and renderer that allows for 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.

Supported Formats

Currently Pcx only supports PLY binary little-endian format.

Installation

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

You can also use Git support on Package Manager to import the package. Add the following line to the dependencies section in the package manifest file (Packages/manifest.json). Note that this feature is only available in Unity 2018.3. See the forum thread for futher details.

"jp.keijiro.pcx": "https://github.com/keijiro/Pcx.git#upm"

Container Types

Inspector

There are three 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.

Texture

Points are baked into Texture2D objects that can be used as attribute maps in Visual Effect Graph.

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.

Points Points

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

Inspector

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

This method 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.

Disks

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.

License

MIT