load_image()

std::shared_ptr< Buffers::TextureBuffer > MayaFlux::IO::IOManager::load_image

(

const std::string &

filepath

)

Load an image file into a TextureBuffer.

Opens the file via ImageReader, decodes to RGBA8, and creates a TextureBuffer containing the pixel data. The reader is retained for the lifetime of IOManager.

Parameters

filepath

Path to the image file (PNG, JPG, BMP, TGA, etc.).

Returns

TextureBuffer with pixel data, or nullptr on failure.

Definition at line 599 of file IOManager.cpp.

{
    auto reader = std::make_shared<IO::ImageReader>();
 
    if (!reader->open(filepath)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "Failed to open image: {}", filepath);
        return nullptr;
    }
 
    auto texture_buffer = reader->create_texture_buffer();
 
    if (!texture_buffer) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "Failed to create texture buffer from: {}", filepath);
        return nullptr;
    }
 
    m_image_readers.push_back(std::move(reader));
 
    MF_INFO(Journal::Component::API, Journal::Context::FileIO,
        "Loaded image: {} ({}x{})",
        std::filesystem::path(filepath).filename().string(),
        texture_buffer->get_width(),
        texture_buffer->get_height());
 
    return texture_buffer;
}

References MayaFlux::Journal::API, MayaFlux::Journal::FileIO, m_image_readers, MF_ERROR, and MF_INFO.