create_2d_array()

std::shared_ptr< Core::VKImage > MayaFlux::Portal::Graphics::TextureLoom::create_2d_array	(	uint32_t	width,
		uint32_t	height,
		uint32_t	layers,
		ImageFormat	format = ImageFormat::RGBA8,
		const void *	data = nullptr
	)

Create a 2D texture array.

All layers share the same width, height, and format. The image view type is VK_IMAGE_VIEW_TYPE_2D_ARRAY, making it bindable as sampler2DArray in GLSL.

Parameters

width	Width in pixels per layer.
height	Height in pixels per layer.
layers	Number of array layers. Must be > 0.
format	Image format (default RGBA8).
data	Optional pixel data for all layers concatenated in order (layer 0 first). Must be exactly width * height * bpp(format) * layers bytes when non-null. Pass nullptr to allocate without uploading; the image is transitioned to eShaderReadOnlyOptimal.

Returns

Initialised VKImage with array_layers == layers, or nullptr on failure.

Definition at line 213 of file TextureLoom.cpp.

{
    if (!is_initialized()) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "TextureLoom not initialized");
        return nullptr;
    }
 
    if (layers == 0) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "create_2d_array: layers must be > 0");
        return nullptr;
    }
 
    auto vk_format = to_vulkan_format(format);
    auto image = std::make_shared<Core::VKImage>(
        width, height, 1, vk_format,
        Core::VKImage::Usage::TEXTURE_2D,
        Core::VKImage::Type::TYPE_2D,
        1, layers,
        Kakshya::DataModality::IMAGE_COLOR);
 
    m_resource_manager->initialize_image(image);
 
    if (!image->is_initialized()) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "create_2d_array: failed to initialize VKImage ({}x{} layers={})",
            width, height, layers);
        return nullptr;
    }
 
    if (data) {
        const size_t total = calculate_image_size(width, height, 1, format) * layers;
        upload_data(image, data, total);
    } else {
        m_resource_manager->transition_image_layout(
            image->get_image(),
            vk::ImageLayout::eUndefined,
            vk::ImageLayout::eShaderReadOnlyOptimal,
            1, layers, vk::ImageAspectFlagBits::eColor);
        image->set_current_layout(vk::ImageLayout::eShaderReadOnlyOptimal);
    }
 
    m_textures.push_back(image);
    MF_INFO(Journal::Component::Portal, Journal::Context::ImageProcessing,
        "Created 2D array texture: {}x{} layers={} format={}",
        width, height, layers, vk::to_string(vk_format));
    return image;
}

References calculate_image_size(), height, image, MayaFlux::Kakshya::IMAGE_COLOR, MayaFlux::Journal::ImageProcessing, MayaFlux::Core::BackendResourceManager::initialize_image(), is_initialized(), m_resource_manager, m_textures, MF_ERROR, MF_INFO, MayaFlux::Journal::Portal, MayaFlux::Core::VKImage::TEXTURE_2D, to_vulkan_format(), MayaFlux::Core::BackendResourceManager::transition_image_layout(), MayaFlux::Core::VKImage::TYPE_2D, upload_data(), and width.

Here is the call graph for this function: