Skip to content

xConvert CLI — Overview

xConvert CLI (xconvert) is the standalone conversion and optimization engine of the XViewr platform, packaged as a self-contained command-line tool.

It handles the full pipeline from raw CAD files to browser-ready 3D assets: format conversion, geometry decimation with multiple LOD levels, Draco compression, and spatial chunking for progressive streaming in the XViewr viewer.


What It Does

StageWhat happens
ConvertParses STEP, IGES, FBX, OBJ, GLB, STL, PLY, point clouds → GLB
DecimateGenerates LOD0–LOD3 using adaptive RMS or Hausdorff-bounded quality
CompressDraco-compresses geometry via KHR_draco_mesh_compression
ChunkSpatially partitions large models into octree chunks for streaming

Deployment Models

On-premises (recommended for enterprise) The CLI ships as a self-contained binary (Windows MSI or Linux tar.gz). No Python, no cloud dependency, no network access required after setup. All OCCT libraries and native binaries are bundled.

Server-side (XViewr platform)x-convert — the XViewr job server — spawns xconvert as a subprocess for file uploads coming through the browser UI.

CI / automation Use --json flag to get newline-delimited JSON progress events on stdout, suitable for integration into any pipeline.


Supported Input Formats

ExtensionFormat
.step, .stpSTEP (OpenCASCADE 7.9)
.iges, .igsIGES (OpenCASCADE 7.9)
.fbxFBX (via FBX2glTF)
.glb, .gltfglTF 2.0
.objWavefront OBJ
.stlSTL
.plyPLY
.e57, .las, .laz, .xyzPoint cloud

Supported Output Formats

glb (default), fbx, obj, stl

XViewr SDK and xConvert CLI documentation.