Developer Guide

Build, install, consume and extend the OPX C++20 reference implementation.

Build from source

OPX uses CMake for the 0.2.0-dev interoperability preview. The verified current build passed configure/build and 111 automated CTest checks. The default profile remains dependency-light; PDAL support is optional and disabled unless explicitly requested.

git clone https://github.com/opx-format/opx.git
cd opx
cmake -S . -B build
cmake --build build
ctest --test-dir build --output-on-failure

# Optional PDAL skeleton check
cmake -S . -B build-pdal-off -DOPX_ENABLE_PDAL=OFF
cmake --build build-pdal-off

Install and consume

OPX exports a CMake package target for downstream C++ projects.

cmake --install build --prefix install

find_package(OPX CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE OPX::opx)
SDK Essentials

Common workflows

Create a synthetic dataset

opx-build-synthetic --output sample.opx \
  --points 10000 --tiling octree \
  --with-rgb --with-lod

Validate and inspect

opx-validate sample.opx
opx-info sample.opx
opx-check-layout sample.opx

LAS interoperability

opx-import-las input.las output.opx
opx-export-las output.opx roundtrip.las

Query points

opx-query-box sample.opx \
  0 0 0 100000 100000 100000 \
  --count-points --lod adaptive

Repository

Repository URL configured in this website:

Open Git Repository