create_2d_uninitialized()

std::shared_ptr< Core::VKImage > MayaFlux::Portal::Graphics::TextureLoom::create_2d_uninitialized	(	uint32_t	width,
		uint32_t	height,
		ImageFormat	format = ImageFormat::RGBA8,
		uint32_t	mip_levels = 1
	)

Allocate a 2D texture without uploading data or transitioning its layout - left VK_IMAGE_LAYOUT_UNDEFINED.

Every create_2d*() overload above performs (and blocks on) an initial layout transition or upload of its own, even when called with no data - create_2d(w, h, format, nullptr) still does a blocking transition to eShaderReadOnlyOptimal before returning. Use this instead when the caller is about to record its own upload right after (e.g. upload_data(image, data, size, staging, true) with deferred=true), so the whole undefined -> transfer-dst -> copy -> shader-read sequence is recorded once into a deferred command batch instead of paying for a separate blocking queue.waitIdle() first.

Parameters

width	Width in pixels.
height	Height in pixels.
format	Image format (default RGBA8).
mip_levels	Number of mipmap levels (1 = no mipmaps).

Returns

VKImage with device memory allocated, still in VK_IMAGE_LAYOUT_UNDEFINED, or nullptr on failure. The caller owns transitioning it before use.

Definition at line 141 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;
    }
 
    m_textures.push_back(image);
    MF_INFO(Journal::Component::Portal, Journal::Context::ImageProcessing,
        "Created 2D texture (uninitialized): {}x{}, format: {}, mips: {}",
        width, height, vk::to_string(vk_format), mip_levels);
    return image;
}

References 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::VKImage::TYPE_2D, and width.

Here is the call graph for this function: