save_image() [3/4]

bool MayaFlux::IO::IOManager::save_image	(	const std::shared_ptr< Core::VKImage > &	image,
		const std::string &	filepath,
		const IO::ImageWriteOptions &	options = {}
	)

Save image data to disk asynchronously.

The source is downloaded from the GPU on the calling thread (must have command queue access) and the encode + disk flush is dispatched to a worker. Returns once the download completes and the encode task is queued; encode/flush failures are logged but do not block the caller.

For synchronous semantics (e.g. shutdown flush, tests) use the IO::save_image / IO::save_texture_buffer free functions in ImageExport.hpp.

The extension of filepath selects the writer via ImageWriterRegistry. Format-variant compatibility is the writer's responsibility (PNG wants uint8, EXR wants float, etc.).

Returns

True if the download succeeded and the encode task was queued.

Definition at line 1206 of file IOManager.cpp.

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

References MayaFlux::IO::download_image(), MayaFlux::IO::Detail::execute_image_write(), MayaFlux::Journal::FileIO, image, MayaFlux::Journal::IO, MF_ERROR, and track_save_task().

Referenced by save_image(), and save_image().

Here is the call graph for this function:

Here is the caller graph for this function: