read_dense_vector()

bool MayaFlux::IO::Detail::VDBArchive::read_dense_vector	(	size_t	index,
		const glm::ivec3 &	region_min,
		const glm::uvec3 &	resolution,
		const glm::vec3 &	background,
		std::vector< glm::vec3 > &	out,
		bool *	precision_lost = nullptr
	)		const

Materialize a vector grid's cells over an explicit region.

As read_dense_scalar, for a grid whose leaf value type is vec3f, vec3d or vec3i. Non-vec3f types are converted component-wise via MayaFlux::try_convert; precision_lost is set if any of the three components of any element lost precision.

Returns

False if index is out of range, the grid is scalar-typed, or resolution has a zero axis. Call last_error() for detail.

Definition at line 783 of file VDBArchive.cpp.

{
    if (!m_state->read_file_open || index >= m_state->read_file.num_grids) {
        m_last_error = "read_dense_vector: grid index out of range";
        return false;
    }
    if (resolution.x == 0 || resolution.y == 0 || resolution.z == 0) {
        m_last_error = "read_dense_vector: zero resolution";
        return false;
    }
 
    const tvdb_grid_t& grid = m_state->read_file.grids[index];
    const tvdb_value_type_t vt = leaf_value_type(grid);
 
    if (!is_vector_type(vt)) {
        const char* name = tvdb_grid_name(&m_state->read_file, index);
        m_last_error = "read_dense_vector: grid '" + std::string(name ? name : "") + "' is scalar-typed";
        return false;
    }
    const size_t elem_size = tvdb_value_type_size(vt);
    if (elem_size == 0) {
        m_last_error = "read_dense_vector: grid has an unsupported leaf value type";
        return false;
    }
 
    if (precision_lost) {
        *precision_lost = false;
    }
 
    out.assign(static_cast<size_t>(resolution.x) * resolution.y * resolution.z, background);
 
    DenseVectorCtx ctx {};
    ctx.region_min = region_min;
    ctx.region_max = region_min + glm::ivec3(resolution);
    ctx.vt = vt;
    ctx.elem_size = elem_size;
    ctx.precision_lost = precision_lost;
    ctx.out = &out;
 
    tvdb_grid_visit_leaves(&grid, dense_vector_visit, &ctx);
    return true;
}

References elem_size, index, m_last_error, m_state, name, out, precision_lost, region_min, and vt.