#include <vk_buffer.hh>

Inherits blender::NonCopyable.

Public Member Functions
	VKBuffer ()=default

virtual	~VKBuffer ()

bool	is_allocated () const

bool	create (size_t size, VkBufferUsageFlags buffer_usage, VkMemoryPropertyFlags required_flags, VkMemoryPropertyFlags preferred_flags, VmaAllocationCreateFlags vma_allocation_flags, float priority, bool export_memory=false)

void	clear (VKContext &context, uint32_t clear_value)

void	update_immediately (const void *data) const

void	update_sub_immediately (size_t start_offset, size_t data_size, const void *data) const

void	update_render_graph (VKContext &context, void *data) const

void	flush () const

void	read (VKContext &context, void *data) const

void	async_flush_to_host (VKContext &context)

void	read_async (VKContext &context, void *data)

bool	free ()

void	free_immediately (VKDevice &device)

int64_t	size_in_bytes () const

VkBuffer	vk_handle () const

void *	mapped_memory_get () const

VkDeviceAddress	device_address_get () const

bool	is_mapped () const

VkDeviceMemory	export_memory_get (size_t &memory_size)

Public Member Functions inherited from blender::NonCopyable
	NonCopyable (const NonCopyable &other)=delete

NonCopyable &	operator= (const NonCopyable &other)=delete

	NonCopyable ()=default

	NonCopyable (NonCopyable &&other)=default

NonCopyable &	operator= (NonCopyable &&other)=default

Detailed Description

Class for handing vulkan buffers (allocation/updating/binding).

Definition at line 23 of file vk_buffer.hh.

Constructor & Destructor Documentation

◆ VKBuffer()

blender::gpu::VKBuffer::VKBuffer ( )

default

◆ ~VKBuffer()

blender::gpu::VKBuffer::~VKBuffer ( )

virtual

Definition at line 16 of file vk_buffer.cc.

References free(), and is_allocated().

Member Function Documentation

◆ async_flush_to_host()

void blender::gpu::VKBuffer::async_flush_to_host ( VKContext & context )

Start a async read-back.

Definition at line 151 of file vk_buffer.cc.

References BLI_assert, blender::gpu::RENEW_RENDER_GRAPH, and blender::gpu::SUBMIT.

Referenced by blender::gpu::VKStorageBuffer::async_flush_to_host(), and read_async().

◆ clear()

void blender::gpu::VKBuffer::clear	(	VKContext &	context,
		uint32_t	clear_value )

Definition at line 142 of file vk_buffer.cc.

References blender::gpu::render_graph::VKFillBufferData::data, blender::gpu::render_graph::VKFillBufferData::size, and blender::gpu::render_graph::VKFillBufferData::vk_buffer.

Referenced by blender::gpu::VKStorageBuffer::clear(), blender::gpu::VKUniformBuffer::clear_to_zero(), blender::gpu::VKIndexBuffer::ensure_updated(), and blender::gpu::VKStorageBuffer::update().

◆ create()

bool blender::gpu::VKBuffer::create	(	size_t	size,
		VkBufferUsageFlags	buffer_usage,
		VkMemoryPropertyFlags	required_flags,
		VkMemoryPropertyFlags	preferred_flags,
		VmaAllocationCreateFlags	vma_allocation_flags,
		float	priority,
		bool	export_memory = false )

Allocate the buffer.

Definition at line 23 of file vk_buffer.cc.

References blender::gpu::render_graph::VKResourceStateTracker::add_buffer(), BLI_assert, ceil_to_multiple_ul(), blender::gpu::VKExtensions::descriptor_buffer, blender::gpu::VKBackend::device, blender::gpu::VKDevice::extensions_get(), blender::gpu::VKDevice::external_memory, blender::gpu::VKBackend::get(), is_allocated(), max_ulul(), blender::gpu::VKDevice::mem_allocator_get(), blender::gpu::VKDevice::queue_family_get(), blender::gpu::VKDevice::resources, result, size_in_bytes(), blender::gpu::VKDevice::vk_handle(), and blender::gpu::VKDevice::vma_pools.

Referenced by blender::gpu::VKDescriptorBufferUpdator::allocate_new_descriptor_set(), blender::gpu::VKPixelBuffer::create(), blender::gpu::VKTexture::read_sub(), blender::gpu::VKTexture::update_sub(), and blender::gpu::VKStagingBuffer::VKStagingBuffer().

◆ device_address_get()

VkDeviceAddress blender::gpu::VKBuffer::device_address_get ( ) const

inline

Definition at line 114 of file vk_buffer.hh.

Referenced by blender::gpu::VKDescriptorBufferUpdator::allocate_new_descriptor_set(), blender::gpu::VKIndexBuffer::device_address_get(), blender::gpu::VKStorageBuffer::device_address_get(), blender::gpu::VKUniformBuffer::device_address_get(), and blender::gpu::VKVertexBuffer::device_address_get().

◆ export_memory_get()

VkDeviceMemory blender::gpu::VKBuffer::export_memory_get ( size_t & memory_size )

Get allocated device memory.

Definition at line 201 of file vk_buffer.cc.

References BLI_assert, blender::gpu::VKBackend::device, blender::gpu::VKBackend::get(), info, and blender::gpu::VKDevice::mem_allocator_get().

Referenced by blender::gpu::VKPixelBuffer::get_native_handle().

◆ flush()

void blender::gpu::VKBuffer::flush ( ) const

Definition at line 135 of file vk_buffer.cc.

References blender::gpu::VKBackend::device, blender::gpu::VKBackend::get(), max_ulul(), blender::gpu::VKDevice::mem_allocator_get(), and size_in_bytes().

◆ free()

bool blender::gpu::VKBuffer::free ( )

Free the buffer.

Discards the buffer so it can be destroyed safely later. Buffers can still be used when rendering so we can only destroy them after the rendering is completed.

Definition at line 219 of file vk_buffer.cc.

References blender::gpu::VKDiscardPool::discard_buffer(), blender::gpu::VKDiscardPool::discard_pool_get(), and is_mapped().

Referenced by blender::gpu::VKPixelBuffer::create(), blender::gpu::VKDevice::deinit(), blender::gpu::VKStagingBuffer::free(), and ~VKBuffer().

◆ free_immediately()

void blender::gpu::VKBuffer::free_immediately ( VKDevice & device )

Destroy the buffer immediately.

Definition at line 233 of file vk_buffer.cc.

References BLI_assert, is_mapped(), blender::gpu::VKDevice::mem_allocator_get(), blender::gpu::render_graph::VKResourceStateTracker::remove_buffer(), and blender::gpu::VKDevice::resources.

◆ is_allocated()

bool blender::gpu::VKBuffer::is_allocated ( ) const

inline

Has this buffer been allocated?

Definition at line 146 of file vk_buffer.hh.

Referenced by blender::gpu::VKUniformBuffer::clear_to_zero(), blender::gpu::VKStagingBuffer::copy_from_device(), blender::gpu::VKStagingBuffer::copy_to_device(), create(), blender::gpu::VKPixelBuffer::create(), blender::gpu::VKStorageBuffer::ensure_allocated(), blender::gpu::VKIndexBuffer::ensure_updated(), blender::gpu::VKUniformBuffer::ensure_updated(), blender::gpu::VKVertexBuffer::read(), blender::gpu::VKStorageBuffer::update(), blender::gpu::VKUniformBuffer::update(), blender::gpu::VKVertexBuffer::update_sub(), blender::gpu::VKVertexBuffer::upload_data(), blender::gpu::VKVertexBuffer::vk_handle(), and ~VKBuffer().

◆ is_mapped()

bool blender::gpu::VKBuffer::is_mapped ( ) const

inline

Is this buffer mapped (visible on host)

Definition at line 141 of file vk_buffer.hh.

Referenced by blender::gpu::VKStagingBuffer::copy_from_device(), blender::gpu::VKStagingBuffer::copy_to_device(), blender::gpu::VKIndexBuffer::ensure_updated(), blender::gpu::VKUniformBuffer::ensure_updated(), free(), free_immediately(), mapped_memory_get(), read(), blender::gpu::VKIndexBuffer::read(), blender::gpu::VKVertexBuffer::read(), read_async(), blender::gpu::VKVertexBuffer::update_sub(), update_sub_immediately(), and blender::gpu::VKVertexBuffer::upload_data().

◆ mapped_memory_get()

void * blender::gpu::VKBuffer::mapped_memory_get ( ) const

inline

Get the reference to the mapped memory.

Can only be called when the buffer is (still) mapped.

Definition at line 135 of file vk_buffer.hh.

References BLI_assert_msg, and is_mapped().

Referenced by blender::gpu::VKDescriptorBufferUpdator::allocate_new_descriptor_set(), blender::gpu::VKImmediate::begin(), blender::gpu::VKPixelBuffer::map(), blender::gpu::VKTexture::read_sub(), blender::gpu::VKTexture::update_sub(), and blender::gpu::VKVertexBuffer::update_sub().

◆ read()

void blender::gpu::VKBuffer::read	(	VKContext &	context,
		void *	data ) const

Read the buffer (synchronously).

Definition at line 171 of file vk_buffer.cc.

References BLI_assert, BLI_assert_msg, data, is_mapped(), blender::gpu::RENEW_RENDER_GRAPH, blender::gpu::SUBMIT, and blender::gpu::WAIT_FOR_COMPLETION.

Referenced by blender::gpu::VKIndexBuffer::read(), and blender::gpu::VKVertexBuffer::read().

◆ read_async()

void blender::gpu::VKBuffer::read_async	(	VKContext &	context,
		void *	data )

Wait until the async read back is finished and fill the given data with the content of the buffer.

Will start a new async read-back when there is no read back in progress.

Definition at line 159 of file vk_buffer.cc.

References async_flush_to_host(), BLI_assert_msg, data, blender::gpu::VKBackend::device, blender::gpu::VKBackend::get(), is_mapped(), and blender::gpu::VKDevice::wait_for_timeline().

Referenced by blender::gpu::VKStorageBuffer::read().

◆ size_in_bytes()

int64_t blender::gpu::VKBuffer::size_in_bytes ( ) const

inline

Definition at line 97 of file vk_buffer.hh.

Referenced by create(), blender::gpu::VKVertexBuffer::ensure_buffer_view(), flush(), and blender::gpu::VKStorageBuffer::size_in_bytes().

◆ update_immediately()

void blender::gpu::VKBuffer::update_immediately ( const void * data ) const

Definition at line 112 of file vk_buffer.cc.

References data, and update_sub_immediately().

Referenced by blender::gpu::VKIndexBuffer::ensure_updated(), blender::gpu::VKUniformBuffer::ensure_updated(), and blender::gpu::VKStorageBuffer::update().

◆ update_render_graph()

void blender::gpu::VKBuffer::update_render_graph	(	VKContext &	context,
		void *	data ) const

Update the buffer as part of the render graph evaluation. The ownership of data will be transferred to the render graph and should have been allocated using guarded alloc.

Definition at line 125 of file vk_buffer.cc.

References BLI_assert, blender::gpu::render_graph::VKUpdateBufferData::data, data, blender::gpu::render_graph::VKUpdateBufferData::data_size, and blender::gpu::render_graph::VKUpdateBufferData::dst_buffer.

Referenced by blender::gpu::VKUniformBuffer::ensure_updated(), and blender::gpu::VKUniformBuffer::update().

◆ update_sub_immediately()

void blender::gpu::VKBuffer::update_sub_immediately	(	size_t	start_offset,
		size_t	data_size,
		const void *	data ) const

Definition at line 117 of file vk_buffer.cc.

References BLI_assert_msg, data, is_mapped(), and start_offset.

Referenced by update_immediately(), and blender::gpu::VKVertexBuffer::update_sub().

◆ vk_handle()

VkBuffer blender::gpu::VKBuffer::vk_handle ( ) const

inline

Definition at line 102 of file vk_buffer.hh.

The documentation for this class was generated from the following files:

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ VKBuffer()

◆ ~VKBuffer()

Member Function Documentation

◆ async_flush_to_host()

◆ clear()

◆ create()

◆ device_address_get()

◆ export_memory_get()

◆ flush()

◆ free()

◆ free_immediately()

◆ is_allocated()

◆ is_mapped()

◆ mapped_memory_get()

◆ read()

◆ read_async()

◆ size_in_bytes()

◆ update_immediately()

◆ update_render_graph()

◆ update_sub_immediately()

◆ vk_handle()