Last updated: 2026-09-07
Vulkan Runtime
Vulkan Command
Create reusable compute command pools and command buffers.
The decode runtime uses these wrappers to record dispatches, insert barriers, and synchronize submitted compute work.
2 exports shown
struct
CommandPool
pub const CommandPool = structCommand pool for allocating command buffers.
struct
CommandBuffer
pub const CommandBuffer = structA recorded command buffer that can be submitted and replayed.
Methods
21method
CommandBuffer.init
pub fn init(instance: *const Instance, pool: *const CommandPool) !CommandBufferAllocate a primary command buffer and fence from a compute command pool.
method
CommandBuffer.begin
pub fn begin(self: *CommandBuffer) !voidBegin recording a reusable command buffer.
method
CommandBuffer.beginOneTime
pub fn beginOneTime(self: *CommandBuffer) !voidBegin recording for a single submit-and-discard style workload.
method
CommandBuffer.dispatch
pub fn dispatch( self: *CommandBuffer, pipeline: *const Pipeline, descriptor_set: vk.c.VkDescriptorSet, group_count_x: u32, group_count_y: u32, group_count_z: u32, ) voidRecord a compute dispatch with an already-created descriptor set.
method
CommandBuffer.dispatchWithPush
pub fn dispatchWithPush( self: *CommandBuffer, pipeline: *const Pipeline, descriptor_set: vk.c.VkDescriptorSet, push_data: []const u8, group_count_x: u32, group_count_y: u32, group_count_z: u32, ) voidRecord a compute dispatch that also uploads a serialized push-constant block.
method
CommandBuffer.pushDescAndDispatch
pub fn pushDescAndDispatch( self: *CommandBuffer, pipeline: *const Pipeline, push_desc_fn: ?PushDescriptorFn, buffer_infos: []const vk.c.VkDescriptorBufferInfo, push_data: []const u8, group_count_x: u32, group_count_y: u32, group_count_z: u32, ) voidRecord a compute dispatch using `VK_KHR_push_descriptor`.
method
CommandBuffer.pushDescAndDispatchIndirect
pub fn pushDescAndDispatchIndirect( self: *CommandBuffer, pipeline: *const Pipeline, push_desc_fn: ?PushDescriptorFn, buffer_infos: []const vk.c.VkDescriptorBufferInfo, push_data: []const u8, indirect_buffer: vk.c.VkBuffer, indirect_offset: vk.c.VkDeviceSize, ) voidRecord a push-descriptor compute dispatch whose group counts are read from a device buffer.
The indirect buffer must contain a `VkDispatchIndirectCommand` at the given byte offset.
method
CommandBuffer.computeBufferBarrier
pub fn computeBufferBarrier(self: *const CommandBuffer, buffer: vk.c.VkBuffer, size: vk.c.VkDeviceSize) voidInsert a buffer-specific compute barrier (only synchronizes the given buffer).
May allow the driver to avoid flushing unrelated caches.
method
CommandBuffer.computeToIndirectBufferBarrier
pub fn computeToIndirectBufferBarrier(self: *const CommandBuffer, buffer: vk.c.VkBuffer, size: vk.c.VkDeviceSize) voidInsert a compute-shader-write to indirect-command-read barrier.
Needed when a shader writes VkDispatchIndirectCommand records consumed by vkCmdDispatchIndirect later in the same command buffer.
method
CommandBuffer.computeBuffersBarrier
pub fn computeBuffersBarrier(self: *const CommandBuffer, ranges: []const BufferRange) voidInsert a multi-buffer compute barrier covering several specific buffer ranges in one vkCmdPipelineBarrier call.
Lets the driver flush only the named buffer caches instead of a global memory barrier — when downstream ops only depend on a known subset of pending writes, unrelated in-flight writes can keep flowing. Up to 8 ranges supported in the inline buffer; larger calls fall back to global.
method
CommandBuffer.computeBarrier
pub fn computeBarrier(self: *const CommandBuffer) voidInsert a compute-to-compute pipeline barrier (shader write → shader read).
method
CommandBuffer.computeToTransferBarrier
pub fn computeToTransferBarrier(self: *const CommandBuffer) voidInsert a compute-to-transfer pipeline barrier (shader write → transfer read/write).
method
CommandBuffer.transferToComputeBarrier
pub fn transferToComputeBarrier(self: *const CommandBuffer) voidInsert a transfer-to-compute pipeline barrier (copy/upload → shader read).
method
CommandBuffer.computeAndTransferBarrier
pub fn computeAndTransferBarrier(self: *const CommandBuffer) voidInsert a combined compute→compute+transfer barrier.
Shader writes become visible to both subsequent compute dispatches and transfer reads. Use when compute output feeds both a shader read and a buffer copy in the same stage.
method
CommandBuffer.transferToTransferBarrier
pub fn transferToTransferBarrier(self: *const CommandBuffer) voidInsert a transfer→transfer pipeline barrier (copy write → copy read).
by another vkCmdCopyBuffer in the same or a subsequent command buffer, and the caller wants strict-spec memory visibility without relying on implicit same-queue ordering semantics. This is the cross-CB safety net for effort-6 cycle 7's layer-0 stash buffers.
method
CommandBuffer.end
pub fn end(self: *const CommandBuffer) !voidFinalize command recording so the buffer can be submitted.
method
CommandBuffer.submitAndWait
pub fn submitAndWait(self: *const CommandBuffer, queue: vk.c.VkQueue) !voidSubmit the command buffer and block until the GPU signals completion.
method
CommandBuffer.submit
pub fn submit(self: *const CommandBuffer, queue: vk.c.VkQueue) !voidSubmit recorded work and return immediately.
method
CommandBuffer.waitForCompletion
pub fn waitForCompletion(self: *const CommandBuffer) !voidWait for the command buffer's fence to signal and then reset it.
method
CommandBuffer.reset
pub fn reset(self: *const CommandBuffer) !voidReset the command buffer so new commands can be recorded into it.
method
CommandBuffer.deinit
pub fn deinit(self: *CommandBuffer, pool: *const CommandPool) voidDestroy the command buffer fence and free the command buffer back to its pool.