load_from_memory()

std::optional< ImageData > MayaFlux::IO::ImageReader::load_from_memory ( const void *  data, size_t  size  )

static

Load image from memory (static utility)

Parameters

data	Pointer to image data in memory
size	Size of the image data in bytes

Returns

Image data or nullopt on failure

Definition at line 353 of file ImageReader.cpp.

{
    if (!data || size == 0) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "Invalid memory buffer for image loading");
        return std::nullopt;
    }
 
    int width {}, height {}, channels {};
 
    stbi_info_from_memory(
        static_cast<const unsigned char*>(data),
        static_cast<int>(size),
        &width, &height, &channels);
 
    int load_as = (channels == 3) ? 4 : 0; // Force RGBA for RGB images
 
    unsigned char* pixels = stbi_load_from_memory(
        static_cast<const unsigned char*>(data),
        static_cast<int>(size),
        &width, &height, &channels,
        load_as);
 
    if (!pixels) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "Failed to decode image from memory: {}",
            stbi_failure_reason());
        return std::nullopt;
    }
 
    int result_channels = (load_as != 0) ? load_as : channels;
 
    MF_INFO(Journal::Component::IO, Journal::Context::FileIO,
        "Loaded image from memory ({}x{}, {} channels{})",
        width, height, result_channels,
        (channels == 3 && result_channels == 4) ? " [RGB→RGBA]" : "");
 
    ImageData result;
    size_t data_size = static_cast<size_t>(width) * height * result_channels;
    result.pixels.resize(data_size);
    std::memcpy(result.pixels.data(), pixels, data_size);
 
    result.width = width;
    result.height = height;
    result.channels = result_channels;
 
    switch (result_channels) {
    case 1:
        result.format = Portal::Graphics::ImageFormat::R8;
        break;
    case 2:
        result.format = Portal::Graphics::ImageFormat::RG8;
        break;
    case 4:
        result.format = Portal::Graphics::ImageFormat::RGBA8;
        break;
    default:
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "Unsupported channel count: {}", result_channels);
        stbi_image_free(pixels);
        return std::nullopt;
    }
 
    stbi_image_free(pixels);
    return result;
}

References MayaFlux::Journal::FileIO, MayaFlux::Journal::IO, MF_ERROR, MF_INFO, MayaFlux::IO::ImageData::pixels, MayaFlux::Portal::Graphics::R8, MayaFlux::Portal::Graphics::RG8, and MayaFlux::Portal::Graphics::RGBA8.