open()

bool MayaFlux::IO::Detail::VDBArchive::open

(

const std::string &

path

)

Open a .vdb and read every grid's tree into memory.

Replaces whatever a previous open() on this instance had loaded. Does not touch the write-side grid accumulation, so an instance is safe to open for reading even if add_grid was never called — the two are independent state.

Parameters

path	Source path, already resolved by the caller.

Returns

False on failure; call last_error() for detail.

Definition at line 648 of file VDBArchive.cpp.

{
    if (m_state->read_file_open) {
        tvdb_file_close(&m_state->read_file);
        m_state->read_file_open = false;
    }
 
    tvdb_error_t err;
    std::memset(&err, 0, sizeof(err));
 
    if (tvdb_file_open(&m_state->read_file, path.c_str(), nullptr, &err) != TVDB_OK) {
        m_last_error = std::string("open failed: ")
            + (err.message[0] != '\0' ? err.message : "unknown");
        return false;
    }
    m_state->read_file_open = true;
 
    if (tvdb_read_all_grids(&m_state->read_file, &err) != TVDB_OK) {
        m_last_error = std::string("grid read failed: ")
            + (err.message[0] != '\0' ? err.message : "unknown");
        tvdb_file_close(&m_state->read_file);
        m_state->read_file_open = false;
        return false;
    }
 
    return true;
}

References m_last_error, and m_state.