save_volume() [1/2]

bool MayaFlux::IO::IOManager::save_volume	(	const std::shared_ptr< Buffers::VolumeGridBuffer > &	volume,
		const std::string &	filepath,
		const IO::VolumeWriteOptions &	options = {},
		const std::vector< std::string > &	field_names = {}
	)

Download and save a GPU-resident volume to disk asynchronously.

Mirrors save_image(VKImage): download, writer lookup and write all happen inside the dispatched task, so this returns as soon as the task is queued rather than blocking the caller. The future is tracked in the same pool as every other save task; wait_for_pending_saves() waits on it like any other.

Parameters

volume	Volume to read from.
filepath	Destination path; extension selects the writer.
options	Writer options.
field_names	Fields to save. Empty means every declared field.

Returns

True once the task is queued. Download or write failure is logged from the task and does not surface here.

Definition at line 1329 of file IOManager.cpp.

{
    if (!volume) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "save_volume: null volume");
        return false;
    }
 
    track_save_task(std::async(std::launch::async,
        [volume, filepath, options, field_names]() -> bool {
            auto data = IO::download_volume(volume, field_names);
            if (!data) {
                MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
                    "save_volume task: download failed for '{}'", filepath);
                return false;
            }
 
            return Detail::execute_volume_write(filepath, *data, options);
        }));
 
    return true;
}

References MayaFlux::IO::download_volume(), MayaFlux::IO::Detail::execute_volume_write(), MayaFlux::Journal::FileIO, MayaFlux::Journal::IO, MF_ERROR, and track_save_task().

Here is the call graph for this function: