load_image()

std::shared_ptr< Buffers::TextureBuffer > MayaFlux::IO::IOManager::load_image	(	const std::string &	filepath,
		int	desired_channels = 4,
		std::optional< Kakshya::Region >	region = std::nullopt
	)

Load an image file into a TextureBuffer.

Opens the file via ImageReader, decodes to the requested channel layout, 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.).
desired_channels	Channel count passed to ImageReader (0 keeps the source layout).
region	Optional source-pixel rectangle with inclusive end coordinates.

Returns

TextureBuffer with pixel data, or nullptr on failure.

Definition at line 755 of file IOManager.cpp.

{
    auto reader = std::make_shared<IO::ImageReader>(desired_channels, std::move(region));
 
    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.