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 314 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 {};
    unsigned char* pixels = stbi_load_from_memory(
        static_cast<const unsigned char*>(data),
        static_cast<int>(size),
        &width, &height, &channels,
        0);
 
    if (!pixels) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "Failed to decode image from memory: {}",
            stbi_failure_reason());
        return std::nullopt;
    }
 
    Portal::Graphics::ImageFormat format {};
    switch (channels) {
    case 1:
        format = Portal::Graphics::ImageFormat::R8;
        break;
    case 2:
        format = Portal::Graphics::ImageFormat::RG8;
        break;
    case 3:
        format = Portal::Graphics::ImageFormat::RGB8;
        break;
    case 4:
        format = Portal::Graphics::ImageFormat::RGBA8;
        break;
    default:
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "Unsupported channel count: {}", channels);
        stbi_image_free(pixels);
        return std::nullopt;
    }
 
    ImageData result;
    size_t data_size = static_cast<long>(width * height) * channels;
    result.pixels.resize(data_size);
    std::memcpy(result.pixels.data(), pixels, data_size);
 
    result.width = width;
    result.height = height;
    result.format = format;
 
    stbi_image_free(pixels);
 
    MF_INFO(Journal::Component::IO, Journal::Context::FileIO,
        "Loaded image from memory ({}x{}, {} channels)",
        width, height, channels);
 
    return result;
}

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