byte-engine-ghi 0.1.0

Graphics hardware interface layer used by Byte-Engine.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

use ash::vk;

use crate::{buffer::BufferHandle, Uses};

/// When `true`, dynamic buffers use a persistent CPU-writable source buffer
/// plus per-frame staging buffers. The source buffer is copied (CPU memcpy)
/// into the current frame's staging buffer every frame, which is then copied
/// to the GPU buffer via `vkCmdCopyBuffer2`. This avoids data races between
/// frames while allowing the CPU to write only when data actually changes.
pub(crate) const PERSISTENT_WRITE: bool = true;

#[derive(Clone, Copy)]
pub(crate) struct Buffer {
	pub(crate) staging: Option<BufferHandle>,
	/// When `PERSISTENT_WRITE` is enabled on a dynamic buffer, this points to the
	/// shared, persistent CPU-writable source buffer. The user writes here and
	/// data is memcpy'd to per-frame staging buffers each frame.
	pub(crate) source: Option<BufferHandle>,
	pub(crate) buffer: vk::Buffer,
	pub(crate) size: usize,
	pub(crate) device_address: vk::DeviceAddress,
	pub(crate) pointer: *mut u8,
	pub(crate) uses: Uses,
	pub(crate) access: crate::DeviceAccesses,
}