sync()

std::shared_ptr< Core::VKImage > MayaFlux::Portal::Text::AtlasImage::sync

(

GlyphAtlas &

atlas

)

Bring the image up to date with atlas.

Creates the image on first use and again when atlas is a different atlas, has a different size from the one last synced, or the image was released by the texture manager shutting down. Otherwise uploads the atlas pixels only when it is dirty.

Parameters

atlas

Atlas to mirror.

Returns

The current image, or null if the texture manager is not initialized or the image could not be created.

Definition at line 9 of file AtlasImage.cpp.

{
    auto& loom = Portal::Graphics::get_texture_manager();
    if (!loom.is_initialized()) {
        return nullptr;
    }
 
    const std::span<const uint8_t> pixels = atlas.texture().pixel_bytes(0);
    const uint32_t size = atlas.atlas_size();
 
    if (!m_image || !m_image->is_initialized() || m_atlas != &atlas || m_size != size) {
        m_image = loom.create_2d(size, size, Portal::Graphics::ImageFormat::R8, pixels.data(), 1);
        if (!m_image) {
            MF_ERROR(Journal::Component::Portal, Journal::Context::API,
                "AtlasImage: could not create a {}x{} atlas image", size, size);
            m_atlas = nullptr;
            m_size = 0;
            return nullptr;
        }
        m_atlas = &atlas;
        m_size = size;
        ++m_generation;
        atlas.clear_dirty();
        return m_image;
    }
 
    if (atlas.is_dirty()) {
        loom.upload_data(m_image, pixels.data(), pixels.size());
        atlas.clear_dirty();
    }
 
    return m_image;
}

References MayaFlux::Journal::API, MayaFlux::Portal::Text::GlyphAtlas::atlas_size(), MayaFlux::Portal::Text::GlyphAtlas::clear_dirty(), MayaFlux::Portal::Graphics::get_texture_manager(), MayaFlux::Portal::Text::GlyphAtlas::is_dirty(), m_atlas, m_generation, m_image, m_size, MF_ERROR, MayaFlux::Kakshya::TextureContainer::pixel_bytes(), pixels, MayaFlux::Journal::Portal, size, and MayaFlux::Portal::Text::GlyphAtlas::texture().

Referenced by MayaFlux::Portal::Forma::internal::TextSlice::refresh().

Here is the call graph for this function:

Here is the caller graph for this function: