VDB Guide

This is a guide for environment setup of VDB and troubleshoot.

Installation

Prerequisite

• Windows
  • Install Visual Studio 2022
  • Install vcpkg
• Mac
  • Install HomeBrew

Install OpenVDB alone

Strictly follow the steps introduced in OpenVDB Github.

Install NanoVDB with OpenVDB

• Windows: script
  1. Install dependencies

     vcpkg install zlib:x64-windows
     vcpkg install blosc:x64-windows
     vcpkg install tbb:x64-windows
     vcpkg install boost-iostreams:x64-windows
     vcpkg install boost-any:x64-windows
     vcpkg install boost-algorithm:x64-windows
     vcpkg install boost-interprocess:x64-windows

  2. Configure and build OpenVDB & NanoVDB

     git clone https://github.com/AcademySoftwareFoundation/openvdb.git
     cd openvdb
     mkdir build
     cd build
     cmake .. -DUSE_NANOVDB=ON -DCMAKE_INSTALL_PREFIX="<path_to_install>" -DCMAKE_TOOLCHAIN_FILE="<path_to_vcpkg>/scripts/buildsystems/vcpkg.cmake"
     cmake --build . parallel 4 --config Release --target install

Use NanoVDB

Troubleshoot

• Building OpenVDB & NanoVDB: LINK : fatal error LNK1248: image size exceeds maximum allowable size
  • Solution: Choose Release configuration rather than Debug during building.
• Compiling NanoVDB examples: error: no member named ... in 'openvdb...
  • Solution: Define NANOVDB_USE_OPENVDB beforing including NanoVDB headers.

References

• OpenVDB Github
• OpenVDB Build Documentation
• Issue 1701: [BUG] I cannot compile my code using NanoVDB