Developer Guide
Build, install, consume and extend the OPX C++20 reference implementation.
Build from source
OPX uses CMake for the 0.5.0 interoperability preview. The verified current development state passes configure/build/test, release-check, install and package validation with 147 automated CTest checks. The default release/CI profile remains dependency-light with OPX_ENABLE_ZSTD=OFF and OPX_ENABLE_PDAL=OFF; optional integrations remain guarded behind CMake options.
git clone https://github.com/opx-format/opx.git cd opx cmake -S . -B build -DOPX_ENABLE_ZSTD=OFF -DOPX_ENABLE_PDAL=OFF cmake --build build ctest --test-dir build --output-on-failure cmake --build build --target opx_release_check cmake --install build --prefix build/install cmake --build build --target package
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