blit_layer()

bool MayaFlux::Portal::Graphics::TextureLoom::blit_layer	(	const std::shared_ptr< Core::VKImage > &	src,
		const std::shared_ptr< Core::VKImage > &	dst,
		const LayerBlit &	blit = {},
		bool	deferred = false
	)

Copy a layer of one image into a layer of another, scaling to fit.

Works between any two color images, so it writes GPU images into an array layer without a host read, and also converts between supported formats. A cubic filter is not available and falls back to linear.

Parameters

src	Source image, distinct from dst.
dst	Destination image.
blit	Layers, rectangles, filter and flips.
deferred	Record for deferred submission.

Returns

True if the blit was recorded or executed.

Definition at line 766 of file TextureLoom.cpp.

{
    if (!is_initialized() || !src || !dst) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "Invalid parameters for blit_layer");
        return false;
    }
 
    if (blit.src_layer >= src->get_array_layers() || blit.dst_layer >= dst->get_array_layers()) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "blit_layer: layer {} of {} or layer {} of {} does not exist",
            blit.src_layer, src->get_array_layers(), blit.dst_layer, dst->get_array_layers());
        return false;
    }
 
    constexpr auto color = vk::ImageAspectFlagBits::eColor;
    if (src->get_aspect_flags() != color || dst->get_aspect_flags() != color) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "blit_layer: only color images can be blitted");
        return false;
    }
 
    const auto src_offsets = region_offsets(blit.src, *src);
    auto dst_offsets = region_offsets(blit.dst, *dst);
    if (!src_offsets || !dst_offsets) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "blit_layer: a rectangle lies outside its image");
        return false;
    }
 
    if (blit.filter == FilterMode::CUBIC) {
        MF_WARN(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "blit_layer: cubic filtering is not available, using linear");
    }
 
    if (blit.flip_x) {
        std::swap(dst_offsets->first.x, dst_offsets->second.x);
    }
    if (blit.flip_y) {
        std::swap(dst_offsets->first.y, dst_offsets->second.y);
    }
 
    const vk::ImageBlit region {
        vk::ImageSubresourceLayers { color, 0, blit.src_layer, 1 },
        { src_offsets->first, src_offsets->second },
        vk::ImageSubresourceLayers { color, 0, blit.dst_layer, 1 },
        { dst_offsets->first, dst_offsets->second }
    };
 
    return m_resource_manager->blit_image(src, dst, region, to_blit_filter(blit.filter), deferred);
}

References MayaFlux::Core::BackendResourceManager::blit_image(), color, MayaFlux::Portal::Graphics::CUBIC, dst, MayaFlux::Portal::Graphics::LayerBlit::dst, MayaFlux::Portal::Graphics::LayerBlit::dst_layer, MayaFlux::Portal::Graphics::LayerBlit::filter, MayaFlux::Portal::Graphics::LayerBlit::flip_x, MayaFlux::Portal::Graphics::LayerBlit::flip_y, MayaFlux::Journal::ImageProcessing, is_initialized(), m_resource_manager, MF_ERROR, MF_WARN, MayaFlux::Journal::Portal, src, MayaFlux::Portal::Graphics::LayerBlit::src, and MayaFlux::Portal::Graphics::LayerBlit::src_layer.

Here is the call graph for this function: