transition_layout()

void MayaFlux::Portal::Graphics::TextureLoom::transition_layout	(	const std::shared_ptr< Core::VKImage > &	image,
		vk::ImageLayout	old_layout,
		vk::ImageLayout	new_layout,
		uint32_t	mip_levels = 1,
		uint32_t	array_layers = 1,
		vk::ImageAspectFlags	aspect_mask = vk::ImageAspectFlagBits::eColor
	)

Transition a VKImage to a new Vulkan layout via an immediate submission.

Parameters

image	Image to transition. Must be initialised.
old_layout	Current layout of the image.
new_layout	Target layout.
mip_levels	Number of mip levels covered by the transition.
array_layers	Number of array layers covered by the transition.
aspect_mask	Image aspect flags (colour, depth, stencil).

Delegates to BackendResourceManager and updates the image's tracked layout. Use before binding an image to a compute shader descriptor or before upload/download operations that require a specific layout.

Definition at line 519 of file TextureLoom.cpp.

{
    if (!is_initialized() || !image) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "Invalid parameters for transition_vk_image_layout");
        return;
    }
 
    m_resource_manager->transition_image_layout(
        image->get_image(),
        old_layout,
        new_layout,
        mip_levels, array_layers, aspect_mask);
 
    image->set_current_layout(new_layout);
}

References image, MayaFlux::Journal::ImageProcessing, is_initialized(), m_resource_manager, MF_ERROR, MayaFlux::Journal::Portal, and MayaFlux::Core::BackendResourceManager::transition_image_layout().

Here is the call graph for this function: