create_image_staging_buffer()

MAYAFLUX_API std::shared_ptr< VKBuffer > MayaFlux::Buffers::create_image_staging_buffer

(

size_t

size

)

Allocate a persistent host-visible staging buffer sized for repeated streaming uploads to an image of size bytes.

Call once; pass the result to upload_image_streaming() every frame.

Parameters

size	Byte footprint of the target image (use VKImage::get_size_bytes()).

Returns

Initialised host-visible VKBuffer, or nullptr on failure.

Definition at line 228 of file StagingUtils.cpp.

{
    auto buf = std::make_shared<VKBuffer>(
        size,
        VKBuffer::Usage::STAGING,
        Kakshya::DataModality::IMAGE_COLOR);
 
    auto buffer_service = Registry::BackendRegistry::instance()
                              .get_service<Registry::Service::BufferService>();
 
    if (!buffer_service) {
        error<std::runtime_error>(
            Journal::Component::Buffers,
            Journal::Context::BufferProcessing,
            std::source_location::current(),
            "create_image_staging_buffer requires a valid buffer service");
    }
 
    buffer_service->initialize_buffer(buf);
 
    MF_DEBUG(Journal::Component::Buffers, Journal::Context::BufferProcessing,
        "create_image_staging_buffer: allocated {} bytes", size);
 
    return buf;
}

References MayaFlux::Journal::BufferProcessing, MayaFlux::Journal::Buffers, MayaFlux::Registry::BackendRegistry::get_service(), MayaFlux::Kakshya::IMAGE_COLOR, MayaFlux::Registry::BackendRegistry::instance(), MF_DEBUG, and MayaFlux::Buffers::VKBuffer::STAGING.

Referenced by MayaFlux::Portal::Forma::make_value_row(), MayaFlux::Buffers::TextureProcessor::update_pixels_if_dirty(), and MayaFlux::Buffers::DataWriteProcessor::upload_texture().

Here is the call graph for this function:

Here is the caller graph for this function: