Skip to content

Quickstart

Jump to bottom
mika edited this page Mar 25, 2020 · 12 revisions

Steps

Import (raw) point cloud files into Unity Project

  • Open Unity Project
  • Create folder IMPORT/ *or can be named anything else also
  • Using Windows Explorer, Drag & Drop your point cloud files into this folder (inside unity, or outside unity)
  • Example: Import folder in Projects window, with point cloud file dropped in (In Unity)
  • image
  • Example: Import folder in Assets folder, with point cloud file dropped in (viewer in Explorer)
  • image
  • *I'd recommend using some special folder, that is ignored from version control systems (like git), so that you huge point cloud files are not committed there

Converting Point Cloud (for viewing in Unity)

  • Window/PointCloudTools/Convert PointCloud to Binary (DX11)
  • Drag&Drop your point cloud file from Project window (for example that Import/ folder) into the "Point Cloud source file" field
  • Example: Drag & Dropping file from Project into converter window
  • image
  • Adjust Converter settings, at least select correct import format from the dropdown menu
  • *Recommended: Enable "[x] Use V2 .ucpc Format", since its faster to load than original v1 .bin format
  • More info about settings PointCloud2Binary settings
  • Click "Convert to Binary" button
  • Set output folder (Usually StreamingAssets/) and filename (for example "test.ucpc"), wait for conversion..done
  • Now open example scene "PointCloudTools/Demos/PointCloudViewer/Scenes/PointCloud-BinaryLoaderV2.scene"
  • Select "@BinaryViewer" gameobject from scene Hierarchy window
  • Inspector: Set your output folder path and filename into BinarySourceFile field:
  • image
  • Use the default "PointCloudColorSizeDX11v2.mat" material if you have RGB data, or "PointCloudColorsTintDX11" if you don't have RGB data
  • Hit Play to run the scene, cloud should appear in the view (use WASD keys+Mouse to fly)

Convert your PointCloud into Unity Mesh assets

  • Window/PointCloudTools/Convert PointCloud to Unity Meshes
  • Drag&Drop your point cloud file from Project window into the "Point Cloud source file" field
  • Adjust settings. More info about PointCloud2Mesh settings
  • Assign material, for example "PointCloudColorsMesh" (if you have RGB data) or "PointCloudSingleColorMesh" if you don't have RGB data
  • Click "Convert to meshes" button
  • Select output folder, wait for conversion..done
  • Meshes are also added to the current open scene
Clone this wiki locally