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
  • In Project Window, create new folder like 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)

  • Import this pointcloud viewer plugin into your Project (from Asset Store window, or from Package Manager in more recent unity versions)
  • 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: Type your converted filename into BinarySourceFile field (if its inside StreamingAssets/ you dont need to enter full path like c:\projects\stuff\viewer\assets\StreamingAssets\myfile.ucpc, instead just put "myfile.ucpc" and the plugin will check if that file exists inside StreamingAssets/ folder)
  • 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)
  • You can now delete the original cloud file and IMPORT folder if you no longer want to convert them again

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