VDB_AX(1)

📦
version 10.0.1 · 3 versions
, in ubuntu questing

✨ NAME ✨

vdb_ax — the utility for processing OpenVDB data using AX 💖 (yes bestie, we're in VDB_AX(1) territory, section 1, User Commands, and it's so much more fun than it sounds)

🌸 DESCRIPTION 🌸

okay so, here's the whole vibe:

usage: vdb_ax [command] [--help|-h] [-v] [<args>]

It's a CLI utility for processing OpenVDB data using AX. That's the entire mission statement. Short, sweet, iconic. 👑

  • -h, --help, -help — prints the help and dips. no notes.
  • -v, --verbose — turns on verbose mode, which means it prints timing and diagnostics. it's giving "tell me everything that's happening" energy 🗣️

💅 [execute] — read/process/write VDB file/streams (the default command)

like, if you don't say what command you want, this is the one you get. it's the main character. 🎀

  • -i [file.vdb] — append an input vdb file to be read
  • -s [code], -f [file] — input code to execute, either as a string or from a file
  • -o [file.vdb] — write the result to a given vdb file
  • --opt [NONE|O0|O1|O2|Os|Oz|O3] — compilation optimization level (Default: 03)
  • --threads [n] — number of threads to use, 0 uses all available (Default: 0)
  • --werror — warnings as errors. no more "it's just a warning" excuses, bestie 😤
  • --max-errors [n] — maximum error messages, 0 allows all error messages (Default: 0)
  • --copy-file-metadata — copy the file level metadata of the first input to the output

🦋 Volumes:

  • --create-missing [ON|OFF] — whether to implicitly create volumes (Default: ON)
  • --tree-level [l1|l1:l2] — a node level or node range to process (Default: 0:4)
  • --node-iter [ON|OFF|ALL] — the active state type of nodes to process (Default: ON)
  • --tile-stream [ON|OFF|AUTO] — set the active tile streaming behaviour (Default: AUTO)
  • --volume-grain [g1|g1:g2] — threading grain size for processing nodes (Default: 1:32)
  • --bindings ["ax_name:volume_name,..."] — attribute bindings for volumes

🌈 Points:

  • --create-missing [ON|OFF] — whether to implicitly point attributes (Default: ON)
  • --group [name] — a point group to process
  • --points-grain [n] — the threading grain size for processing nodes (Default: 1)
  • --bindings ["ax_name:point_attr_name,..."] — attribute bindings for points

🔥 [analyze] — parse code and run analysis

this one's for the girlies who like to look inside the code before running it. forensic slay 🔍

  • --ast-print — print the generated abstract syntax tree
  • --re-print — re-interpret print of the code post ast traversal
  • --reg-print — print the attribute registry (name, types, access, dependencies)
  • --try-compile <points | volumes> — attempt compilation for points, volumes or both if no option is provided

🧚 [functions] — query available function information

window shopping, but for functions 🛍️

  • --list <filter-name> — list functions, their documentation and their signatures
  • --list-names — list all available functions names only
📬 got a bug report, a question, or just need to talk about it? Email <openvdb-dev@lists.aswf.io> and/or open issues at https://github.com/AcademySoftwareFoundation/openvdb. they're literally so nice, go say hi 🫶

💜 AUTHOR 💜

This manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system (but may be used by others). we love a credited author, periodt.

and that's a wrap on vdb_ax version 10.0.1, dated August 2025 ✨ ty for coming to my ted talk, go process some VDBs, mwah 💋

📦 where this page comes from