allocate()

std::optional< ImageData > MayaFlux::Kakshya::ImageData::allocate ( uint32_t  width, uint32_t  height, uint32_t  channels, ImageFormat  format  )

static

Allocate zeroed pixel storage of the variant format calls for.

The variant matches what is_consistent() expects: uint8 for the 8-bit formats, uint16 for the 16-bit and half-float formats, float for the 32-bit float formats. Holds width * height * channels elements.

Returns

The sized ImageData, or nullopt when any dimension or the channel count is zero, or the format has no storage mapping.

Definition at line 5 of file ImageData.cpp.

{
    using F = ImageFormat;
 
    if (width == 0 || height == 0 || channels == 0) {
        return std::nullopt;
    }
 
    ImageData result;
    result.width = width;
    result.height = height;
    result.channels = channels;
    result.format = format;
 
    const size_t element_count = static_cast<size_t>(width) * height * channels;
 
    switch (format) {
    case F::R8:
    case F::RG8:
    case F::RGBA8:
    case F::RGBA8_SRGB:
    case F::BGRA8:
    case F::BGRA8_SRGB:
        result.pixels.emplace<std::vector<uint8_t>>(element_count);
        break;
 
    case F::R16:
    case F::RG16:
    case F::RGBA16:
    case F::R16F:
    case F::RG16F:
    case F::RGBA16F:
        result.pixels.emplace<std::vector<uint16_t>>(element_count);
        break;
 
    case F::R32F:
    case F::RG32F:
    case F::RGBA32F:
        result.pixels.emplace<std::vector<float>>(element_count);
        break;
 
    default:
        return std::nullopt;
    }
 
    return result;
}

References channels, element_count(), format, height, pixels, and width.

Referenced by MayaFlux::Portal::Graphics::TextureLoom::download_image(), and from_bytes().

Here is the call graph for this function:

Here is the caller graph for this function: