refresh_cached_image()

std::shared_ptr< Core::VKImage > MayaFlux::Portal::Graphics::TextureLoom::refresh_cached_image	(	ImageCacheEntry &	entry,
		const ImageKey &	key,
		std::span< const uint8_t >	pixels,
		const std::shared_ptr< Buffers::VKBuffer > &	staging = {}
	)

Refresh a sampled image in an owner-held cache entry.

Parameters

entry	Cache entry retained by the image producer.
key	Sampled image allocation properties.
pixels	Complete pixel bytes for every layer.
staging	Optional caller staging buffer. Without one, upload_data uses its existing transient staging path.

Returns

Refreshed image, or nullptr when validation or creation fails.

Definition at line 480 of file TextureLoom.cpp.

{
    if (key.kind == ImageKey::Kind::STORAGE_2D || key.width == 0
        || key.height == 0 || key.layers == 0)
        return nullptr;
 
    const size_t required = calculate_image_size(key.width, key.height, 1, key.format)
        * key.layers;
    if (pixels.size() != required) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "Cached image upload has {} bytes, expected {}", pixels.size(), required);
        return nullptr;
    }
 
    if (staging && (staging->get_size() < required || !staging->get_mapped_ptr())) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "Cached image staging buffer is unavailable or too small");
        return nullptr;
    }
 
    auto image = acquire_cached_image(entry, key);
    if (!image)
        return nullptr;
 
    if (staging) {
        upload_data(image, pixels.data(), pixels.size(), staging);
    } else {
        upload_data(image, pixels.data(), pixels.size());
    }
 
    return image;
}

References acquire_cached_image(), calculate_image_size(), MayaFlux::Portal::Graphics::ImageKey::format, MayaFlux::Portal::Graphics::ImageKey::height, image, MayaFlux::Journal::ImageProcessing, MayaFlux::Portal::Graphics::ImageKey::kind, MayaFlux::Portal::Graphics::ImageKey::layers, MF_ERROR, pixels, MayaFlux::Journal::Portal, MayaFlux::Portal::Graphics::ImageKey::STORAGE_2D, upload_data(), and MayaFlux::Portal::Graphics::ImageKey::width.

Referenced by MayaFlux::Kakshya::TextureContainer::cached_array_image(), MayaFlux::Kakshya::TextureContainer::cached_layer_image(), MayaFlux::Kakshya::WindowContainer::image_at(), MayaFlux::Kakshya::WindowContainer::image_at(), MayaFlux::Kakshya::WindowContainer::region_to_image(), MayaFlux::Buffers::TextureArrayBuffer::submit_layer(), MayaFlux::Kakshya::WindowContainer::to_image(), and MayaFlux::Kakshya::WindowContainer::to_image().

Here is the call graph for this function:

Here is the caller graph for this function: