load() [1/2]

std::optional< Kakshya::VolumeData > MayaFlux::IO::VolumeReader::load	(	const std::string &	filepath,
		const Kinesis::Lattice3D &	lattice,
		const VolumeReadOptions &	options = {}
	)

Load every selected grid onto a caller-supplied lattice.

As load(), but the output lattice is lattice rather than derived from the file. The only path that round-trips a write exactly; see the class docs.

Parameters

filepath	Path to the .vdb file.
lattice	Output lattice. Its resolution and bounds are used as given; nothing about it is validated against the file's own transform.
options	Grid selection.

Returns

Populated VolumeData, or nullopt on failure; check get_last_error().

Definition at line 133 of file VolumeReader.cpp.

{
    if (!open(filepath)) {
        return std::nullopt;
    }
    auto result = extract(lattice, options);
    close();
    return result;
}

References close(), extract(), and open().

Here is the call graph for this function: