append_frame() [2/3]

bool MayaFlux::Kakshya::DynamicVideoStream::append_frame	(	const std::shared_ptr< Core::VKImage > &	image,
		const std::shared_ptr< Buffers::VKBuffer > &	staging = nullptr
	)

Download a GPU image straight into the next frame slot.

Blocking, like TextureContainer::from_image. The image must match the stream's width, height and format. Pass a persistent staging buffer (Buffers::create_image_staging_buffer(get_frame_byte_size())) to avoid a per-call Vulkan allocation.

Parameters

image	Initialised source image.
staging	Optional host-visible staging buffer.

Returns

True if the frame was stored.

Definition at line 99 of file DynamicVideoStream.cpp.

{
    if (!image || !image->is_initialized()) {
        MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "DynamicVideoStream::append_frame called with an uninitialised image");
        return false;
    }
 
    uint8_t* slot = claim_frame_slot();
    if (!slot) {
        return false;
    }
 
    Portal::Graphics::TextureLoom::instance().download_data(image, slot, get_frame_byte_size(), staging);
    finish_frame();
    return true;
}

References claim_frame_slot(), MayaFlux::Journal::ContainerProcessing, MayaFlux::Portal::Graphics::TextureLoom::download_data(), finish_frame(), MayaFlux::Kakshya::VideoStreamContainer::get_frame_byte_size(), image, MayaFlux::Portal::Graphics::TextureLoom::instance(), MayaFlux::Journal::Kakshya, and MF_ERROR.

Here is the call graph for this function: