Skip to content
mika edited this page Nov 25, 2024 · 14 revisions

Welcome to the PointCloudConverter wiki!

Commandline

GUI

If you start exe without any arguments, it opens GUI image

Input/Output

  • Input file or folder: Source file to convert, if you select folder, then all LAS/LAZ files inside it are converted
  • Input format: LAS (includes LAZ also), no other formats at the moment. *Custom E57 converter is available by request for PointCloud plugin owners.
  • Output: Converted file, usually this is saved into unity project Assets/StreamingAssets/
  • Export format: UCPC (v2), PCROOT (v3). See formats: https://github.com/unitycoder/UnityPointCloudViewer/wiki/Compare-Formats
  • "..." button: Browse Export plugins folder (only GLTF plugin is currently available)

Global Options

  • Read RGB: Reads (and outputs) RGB data
  • Read Intensity: Reads intensity values (gets converted as RGB *unless you have Both RGB+INT enabled, then its saved as separate .int file OR if packed color is also enabled, then XYZ+RGB+INT data is packed in same values)
  • Auto-Offset: Automatically offset points nearer to 0,0,0 (otherwise points are too far to display, enabled by default. It works by taking point cloud bounds as offset)
  • Scale: Scale point cloud values (if your data is millimeters, then use 0.001 scale, to convert into (Unity) meters)
  • Swaps Z and Y: Unity Y is up and often scan data is Z up
  • Invert X: Use this if you data is wrongly mirrored on X axis in unity
  • Invert Z: Use this if you data is wrongly mirrored on Z axis in unity
  • Maximum import point count: Can use this to test with smaller point amount first. (faster)
  • Skip every Nth point: Can be used to reduce point counts
  • Keep every Nth point: Can be used to reduce point counts
  • Maximum file count: When converting whole folder, can limit to first x files (good for testing settings first)
  • Randomize: Randomize point indexes, required for V3 tiles format and Dynamic resolution.
  • Open output folder: After processing, opens output folder in Explorer
  • Import metadata: Imports LAS (1.2) header metadata into JSON file (saves into output folder, outputfilename.json)
  • Read metadata only: If enabled with import metadata, then points are not processed, only reads and exports header data json)
  • Use random seed: If you want to use same random seed (mainly for debugging)

V2 & V3 options

  • Pack colors: Packs color values, improves performance in viewer (but can cause lower precision positions and colors). Requires using special packed material&shader in viewer (those that have name pack in the shader or material)
  • PackMagic: Optional color packing adjustment integer. Increase this value is you have large tiles and notice precision issues in colors. Default is 64. If your output looks less dense than original cloud, adjust grid size and packmagic values. Try to get good gridsize first, then start with packmagic=1, increase/adjust your gridsize until good density is reached, then if your colors are bleeding/overbright, start increasing packmagic value.
  • Custom intensity range: Use 0-65535 intensity range, instead of 0-255 (some LAS files have different ranges)

V3 options

  • Minimum point count per tile: If tile has less points than this value, that tile is discarded. Good for removing tiles with stray points
  • Get Average timestamp per Tile: Calculates averaged scan timestamp from all points in that tile (data is saved into pcroot file)
  • Calculate overlapping tiles: Calculate overlapping tiles (data is saved into pcroot file, can be used to remove overlapping tiles)

Shared options

  • Grid size: Splits point cloud into tiles with this size (in meters). If you have really dense cloud, you should try smaller values. If your cloud is really wide area, can try larger values. (so each tile is 20/50/100 meters). Tip: You don't want to have too many points (tens of millions) in single tile

Videos

Clone this wiki locally