Skip to content

GLTF GLB Exporter

mika edited this page May 25, 2025 · 38 revisions

(WIP)

GLTF/GLB Exporter Documentation

CONTENTS


Features

  • Easily convert LAS/LAZ files into GLB (GLTF) format
  • Use GUI or command line to convert (hybrid application)
  • Batch processing with multi-threading
  • Additional options for point cloud filtering, scaling, swapping y-z axis, splitting to smaller files and more
  • Supports LAS 1.0 to 1.4
  • RGB colors : read point cloud RGB colors
  • Intensity or Classification color : read point cloud intensity/classification colors (only RGB or Intensity or Classification, not both at the same time currently)
  • LAZ header metadata : Exports LAZ header metadata into additional JSON file

Purchase

GLTF/GLB Exporter is available as a separate plugin for PointCloudConverter (this current repo)
Visit: https://las2gltf.kelobyte.fi *50% discount for existing Pointcloud Viewer & Tools users!

Quick Start

  • Once you have installed the converter plugin, you can select GLB Export format
  • GLB Export format in the dropdown menu
  • Select your LAZ source file (you can download sample file here: https://files.fm/u/658mgracwb )
  • Set output folder
  • Adjust settings, Recommended initial settings:
    • [ x ] Auto-Offset, to bring cloud near 0,0,0.
    • [ x ] Swap Y and Z (because Unity Y is Up)
    • [ x ] Invert X is often required for LAZ to GLB files, otherwise point cloud is mirrored in X axis
  • For most clouds, you want [x] Split to grid is disabled, so that you get single file output
  • Optional: You can now save your settings into File for later Use, press Export Settings
  • Press Convert to begin processing
  • If you enabled [x] Open output folder, Explorer window is opened (so you can access file easily)

Installation

Using Commandline

  • Check main converter commandline arguments: https://github.com/unitycoder/PointCloudConverter/wiki/Commandline-Arguments
  • Or use GUI to setup correct settings and press "Get Arguments" (to get ready to use commandline args)
  • Or run: pointcloudconverter.exe -? to get help output
  • GLTF specific arguments are:
    • -exportformat=glb
    • -usegrid=true *if you want to split cloud(s) into multiple files

Limitations

  • Really large files cannot be converted as single glb files (tested: 2.8gb laz file works, 3.8gb laz file doesn't work, need to use split to grid to output multiple files)

Troubleshooting

Conversion runs successfully, but there is not output

  • Your LAZ file is probably too large. Use [x] Split to grid to output multiple files

GLTF point cloud color is brighter/lighter than original data

  • enable srgb to convert color space (or use -srgb=true from commandline

My glb cloud is split into multiple files?

  • Disable [ ] Use Grid (split to grid) option in converter

Support

FAQ

Does this work on Mac or Linux?

  • No, it is Windows only

Does it have GUI or Commandline?

  • Both, if you run exe without arguments, it opens the GUI.

I want to request new features

How get point cloud colors in Blender?

  • Use plugin (if doesnt work otherwise)
  • Setup Shader (to use color attribute) image
  • Setup Geometry node (to render vertices as points) image