create_2d() [2/2]

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

Create a 2D texture.

Parameters

width	Width in pixels
height	Height in pixels
format	Image format
data	Optional initial pixel data (nullptr = empty)
mip_levels	Number of mipmap levels (1 = no mipmaps)

Returns

Initialized VKImage ready for use

Creates device-local texture optimized for shader sampling. If data provided, uploads immediately and transitions to shader read layout.

Definition at line 96 of file TextureLoom.cpp.

{
    if (!is_initialized()) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "TextureLoom not initialized");
        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,
        mip_levels, 1,
        Kakshya::DataModality::IMAGE_COLOR);
 
    m_resource_manager->initialize_image(image);
 
    if (!image->is_initialized()) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::ImageProcessing,
            "Failed to initialize VKImage");
        return nullptr;
    }
 
    if (data) {
        size_t data_size = calculate_image_size(width, height, 1, format);
        upload_data(image, data, data_size);
    } else {
        m_resource_manager->transition_image_layout(
            image->get_image(),
            vk::ImageLayout::eUndefined,
            vk::ImageLayout::eShaderReadOnlyOptimal,
            mip_levels, 1, 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 texture: {}x{}, format: {}, mips: {}",
        width, height, vk::to_string(vk_format), mip_levels);
    return image;
}

References calculate_image_size(), format, 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.

Referenced by acquire_cached_image(), MayaFlux::Kakshya::TextureCollection::append(), create_2d(), MayaFlux::Yantra::VisionAnalyzer::resolve_image(), and MayaFlux::Yantra::VisionExtractor::resolve_image().

Here is the call graph for this function:

Here is the caller graph for this function: