extract() [1/2]

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

Extract every selected grid onto a caller-supplied lattice.

Parameters

lattice	Output lattice, as in the load() overload.
options	Grid selection.

Returns

Populated VolumeData, or nullopt if no file is open or on failure; check get_last_error().

Definition at line 200 of file VolumeReader.cpp.

{
    if (!m_is_open) {
        set_error("No file open");
        return std::nullopt;
    }
 
    const size_t count = m_archive->read_grid_count();
    if (count == 0) {
        set_error("No grids in file");
        return std::nullopt;
    }
 
    const auto indices = select_indices(*m_archive, count, options.field_names);
    if (indices.empty()) {
        set_error("No matching grids");
        return std::nullopt;
    }
 
    const auto first = m_archive->grid_summary(indices.front());
    if (glm::any(glm::lessThanEqual(first.voxel_size, glm::vec3(0.0F)))) {
        set_error("First selected grid has a degenerate voxel size");
        return std::nullopt;
    }
 
    const glm::vec3 region_min_f = (lattice.bounds.min - first.translation) / first.voxel_size + glm::vec3(0.5F);
    const glm::ivec3 region_min = glm::ivec3(glm::round(region_min_f));
 
    return materialize(indices, region_min, lattice);
}

References MayaFlux::Kinesis::Lattice3D::bounds, count, MayaFlux::IO::VolumeReadOptions::field_names, m_archive, m_is_open, materialize(), MayaFlux::Kinesis::AABB3D::min, region_min, and set_error().

Here is the call graph for this function: