acquire_cached_image()

std::shared_ptr< Core::VKImage > MayaFlux::Portal::Graphics::TextureLoom::acquire_cached_image	(	ImageCacheEntry &	entry,
		const ImageKey &	key
	)

Reuse a matching image in an owner-held entry or create it once.

Parameters

entry	Cache entry retained by the image producer.
key	Immutable image allocation properties.

Returns

Matching image, or nullptr on failure.

Definition at line 434 of file TextureLoom.cpp.

{
    if (key.width == 0 || key.height == 0 || key.layers == 0
        || key.mip_levels == 0)
        return nullptr;
 
    const auto usage = key.kind == ImageKey::Kind::STORAGE_2D
        ? Core::VKImage::Usage::STORAGE
        : Core::VKImage::Usage::TEXTURE_2D;
    if (entry.image && entry.key == key && entry.image->is_initialized()
        && entry.image->get_width() == key.width
        && entry.image->get_height() == key.height
        && entry.image->get_array_layers() == key.layers
        && entry.image->get_mip_levels() == key.mip_levels
        && entry.image->get_format() == to_vulkan_format(key.format)
        && entry.image->get_usage() == usage) {
        return entry.image;
    }
 
    std::shared_ptr<Core::VKImage> image;
    switch (key.kind) {
    case ImageKey::Kind::SAMPLED_2D:
        if (key.layers != 1)
            return nullptr;
        image = create_2d(key.width, key.height, key.format, nullptr, key.mip_levels);
        break;
    case ImageKey::Kind::SAMPLED_ARRAY:
        if (key.mip_levels != 1)
            return nullptr;
        image = create_2d_array(key.width, key.height, key.layers, key.format, nullptr);
        break;
    case ImageKey::Kind::STORAGE_2D:
        if (key.layers != 1 || key.mip_levels != 1)
            return nullptr;
        image = create_storage_image(key.width, key.height, key.format);
        break;
    }
 
    if (image) {
        entry.key = key;
        entry.image = image;
    }
    return image;
}

References create_2d(), create_2d_array(), create_storage_image(), MayaFlux::Portal::Graphics::ImageKey::format, MayaFlux::Portal::Graphics::ImageKey::height, image, MayaFlux::Portal::Graphics::ImageCacheEntry::image, MayaFlux::Portal::Graphics::ImageCacheEntry::key, MayaFlux::Portal::Graphics::ImageKey::kind, MayaFlux::Portal::Graphics::ImageKey::layers, MayaFlux::Portal::Graphics::ImageKey::mip_levels, MayaFlux::Portal::Graphics::ImageKey::SAMPLED_2D, MayaFlux::Portal::Graphics::ImageKey::SAMPLED_ARRAY, MayaFlux::Core::VKImage::STORAGE, MayaFlux::Portal::Graphics::ImageKey::STORAGE_2D, MayaFlux::Core::VKImage::TEXTURE_2D, to_vulkan_format(), usage, and MayaFlux::Portal::Graphics::ImageKey::width.

Referenced by MayaFlux::Portal::Graphics::ImageCacheSet::acquire(), and refresh_cached_image().

Here is the call graph for this function:

Here is the caller graph for this function: