.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH VDB_LOD "1" "February 2024" "vdb_lod 10.0.1" "User Commands"
.SH NAME
vdb_lod - generates a volume mipmap from an OpenVDB grid
.SH SYNOPSIS
.B vdb_lod
\fI\,in.vdb out.vdb -range FROM\/\fR[\fI\,-TO\/\fR[\fI\,:STEP\/\fR]] [\fI\,options\/\fR]
.SH DESCRIPTION
Which: generates a volume mipmap from an OpenVDB grid
Where:
.TP
FROM
is the highest\-resolution mip level to be generated
.TP
TO
is the lowest\-resolution mip level to be generated (default: FROM)
.TP
STEP
is the mip level step size (default: 1)
.SH OPTIONS
.TP
\fB\-name\fR S[,S,S,...]
name(s) of the grid(s) to be processed
(default: process all grids of supported types)
.TP
\fB\-keep\fR
pass through grids that were not processed
(default: discard grids that were not processed)
.TP
\fB\-nokeep\fR
cancel an earlier \fB\-keep\fR option
.TP
\fB\-p\fR, \fB\-preserve\fR
if only one mip level is generated, give it the same
name as the original grid (default: name each level
"NAME_level_N", where NAME is the original grid name
and N is the level number, e.g., "density_level_0")
.TP
\fB\-nopreserve\fR
cancel an earlier \fB\-p\fR or \fB\-preserve\fR option
.TP
\fB\-version\fR
print version information
.PP
Mip level 0 is the input grid.  Each successive integer level is half
the resolution of the previous level.  Fractional levels are supported.
.SH EXAMPLES
.IP
Generate levels 0, 1, and 2 (full resolution, half resolution,
and quarter resolution, respectively) for all grids of supported types
and ignore all other grids:
.IP
vdb_lod in.vdb out.vdb \-range 0\-2
.IP
Generate levels 0, 0.5, and 1 for all grids of supported types
and pass through all other grids:
.IP
vdb_lod in.vdb out.vdb \-range 0\-1:0.5 \-keep
.IP
Generate level 3 for the first of multiple grids named "density":
.IP
vdb_lod in.vdb out.vdb \-range 3 \-name 'density[0]'
.IP
Generate level 1.5 for the second of multiple unnamed grids and for
the grid named "velocity" and give the resulting grids the same names
as the original grids:
.IP
vdb_lod in.vdb out.vdb \-range 1.5 \-name '[1],velocity' \-p
.SH AUTHOR
This manual page was written by Mathieu Malaterre <malat@debian.org> for the
Debian GNU/Linux system (but may be used by others).