Struct vulkano::command_buffer::sys::UnsafeCommandBufferBuilder

pub struct UnsafeCommandBufferBuilder { /* private fields */ }

Command buffer being built.

Safety

• All submitted commands must be valid and follow the requirements of the Vulkan specification.
• Any resources used by submitted commands must outlive the returned builder and its created command buffer. They must be protected against data races through manual synchronization.

Note: Some checks are still made with debug_assert!. Do not expect to be able to submit invalid commands.

Implementations

impl UnsafeCommandBufferBuilder

pub unsafe fn bind_descriptor_sets<'s>(
    &mut self,
    pipeline_bind_point: PipelineBindPoint,
    pipeline_layout: &PipelineLayout,
    first_set: u32,
    sets: impl IntoIterator<Item = &'s UnsafeDescriptorSet>,
    dynamic_offsets: impl IntoIterator<Item = u32>
)

Calls vkCmdBindDescriptorSets on the builder.

Does nothing if the list of descriptor sets is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn bind_index_buffer(
    &mut self,
    buffer: &dyn BufferAccess,
    index_type: IndexType
)

Calls vkCmdBindIndexBuffer on the builder.

pub unsafe fn bind_pipeline_compute(&mut self, pipeline: &ComputePipeline)

Calls vkCmdBindPipeline on the builder with a compute pipeline.

pub unsafe fn bind_pipeline_graphics(&mut self, pipeline: &GraphicsPipeline)

Calls vkCmdBindPipeline on the builder with a graphics pipeline.

pub unsafe fn bind_vertex_buffers(
    &mut self,
    first_binding: u32,
    params: UnsafeCommandBufferBuilderBindVertexBuffer
)

Calls vkCmdBindVertexBuffers on the builder.

Does nothing if the list of buffers is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn push_constants<D>(
    &mut self,
    pipeline_layout: &PipelineLayout,
    stages: ShaderStages,
    offset: u32,
    size: u32,
    data: &D
)where
    D: BufferContents + ?Sized,

Calls vkCmdPushConstants on the builder.

pub unsafe fn push_descriptor_set<'a>(
    &mut self,
    pipeline_bind_point: PipelineBindPoint,
    pipeline_layout: &PipelineLayout,
    set_num: u32,
    descriptor_writes: impl IntoIterator<Item = &'a WriteDescriptorSet>
)

Calls vkCmdPushDescriptorSetKHR on the builder.

If the list is empty then the command is automatically ignored.

impl UnsafeCommandBufferBuilder

pub unsafe fn begin_debug_utils_label(&mut self, label_info: &DebugUtilsLabel)

Calls vkCmdBeginDebugUtilsLabelEXT on the builder.

Safety

The command pool that this command buffer was allocated from must support graphics or compute operations

pub unsafe fn end_debug_utils_label(&mut self)

Calls vkCmdEndDebugUtilsLabelEXT on the builder.

Safety

There must be an outstanding vkCmdBeginDebugUtilsLabelEXT command prior to the vkQueueEndDebugUtilsLabelEXT on the queue tha CommandBuffer is submitted to.

pub unsafe fn insert_debug_utils_label(&mut self, label_info: &DebugUtilsLabel)

Calls vkCmdInsertDebugUtilsLabelEXT on the builder.

Safety

The command pool that this command buffer was allocated from must support graphics or compute operations

impl UnsafeCommandBufferBuilder

pub unsafe fn set_blend_constants(&mut self, constants: [f32; 4])

Calls vkCmdSetBlendConstants on the builder.

pub unsafe fn set_color_write_enable(
    &mut self,
    enables: impl IntoIterator<Item = bool>
)

Calls vkCmdSetColorWriteEnableEXT on the builder.

If the list is empty then the command is automatically ignored.

pub unsafe fn set_cull_mode(&mut self, cull_mode: CullMode)

Calls vkCmdSetCullModeEXT on the builder.

pub unsafe fn set_depth_bias(
    &mut self,
    constant_factor: f32,
    clamp: f32,
    slope_factor: f32
)

Calls vkCmdSetDepthBias on the builder.

pub unsafe fn set_depth_bias_enable(&mut self, enable: bool)

Calls vkCmdSetDepthBiasEnableEXT on the builder.

pub unsafe fn set_depth_bounds(&mut self, bounds: RangeInclusive<f32>)

Calls vkCmdSetDepthBounds on the builder.

pub unsafe fn set_depth_bounds_test_enable(&mut self, enable: bool)

Calls vkCmdSetDepthBoundsTestEnableEXT on the builder.

pub unsafe fn set_depth_compare_op(&mut self, compare_op: CompareOp)

Calls vkCmdSetDepthCompareOpEXT on the builder.

pub unsafe fn set_depth_test_enable(&mut self, enable: bool)

Calls vkCmdSetDepthTestEnableEXT on the builder.

pub unsafe fn set_depth_write_enable(&mut self, enable: bool)

Calls vkCmdSetDepthWriteEnableEXT on the builder.

pub unsafe fn set_discard_rectangle(
    &mut self,
    first_rectangle: u32,
    rectangles: impl IntoIterator<Item = Scissor>
)

Calls vkCmdSetDiscardRectangleEXT on the builder.

If the list is empty then the command is automatically ignored.

pub unsafe fn set_front_face(&mut self, face: FrontFace)

Calls vkCmdSetFrontFaceEXT on the builder.

pub unsafe fn set_line_stipple(&mut self, factor: u32, pattern: u16)

Calls vkCmdSetLineStippleEXT on the builder.

pub unsafe fn set_line_width(&mut self, line_width: f32)

Calls vkCmdSetLineWidth on the builder.

pub unsafe fn set_logic_op(&mut self, logic_op: LogicOp)

Calls vkCmdSetLogicOpEXT on the builder.

pub unsafe fn set_patch_control_points(&mut self, num: u32)

Calls vkCmdSetPatchControlPointsEXT on the builder.

pub unsafe fn set_primitive_restart_enable(&mut self, enable: bool)

Calls vkCmdSetPrimitiveRestartEnableEXT on the builder.

pub unsafe fn set_primitive_topology(&mut self, topology: PrimitiveTopology)

Calls vkCmdSetPrimitiveTopologyEXT on the builder.

pub unsafe fn set_rasterizer_discard_enable(&mut self, enable: bool)

Calls vkCmdSetRasterizerDiscardEnableEXT on the builder.

pub unsafe fn set_stencil_compare_mask(
    &mut self,
    face_mask: StencilFaces,
    compare_mask: u32
)

Calls vkCmdSetStencilCompareMask on the builder.

pub unsafe fn set_stencil_op(
    &mut self,
    face_mask: StencilFaces,
    fail_op: StencilOp,
    pass_op: StencilOp,
    depth_fail_op: StencilOp,
    compare_op: CompareOp
)

Calls vkCmdSetStencilOpEXT on the builder.

pub unsafe fn set_stencil_reference(
    &mut self,
    face_mask: StencilFaces,
    reference: u32
)

Calls vkCmdSetStencilReference on the builder.

pub unsafe fn set_stencil_test_enable(&mut self, enable: bool)

Calls vkCmdSetStencilTestEnableEXT on the builder.

pub unsafe fn set_stencil_write_mask(
    &mut self,
    face_mask: StencilFaces,
    write_mask: u32
)

Calls vkCmdSetStencilWriteMask on the builder.

pub unsafe fn set_scissor(
    &mut self,
    first_scissor: u32,
    scissors: impl IntoIterator<Item = Scissor>
)

Calls vkCmdSetScissor on the builder.

If the list is empty then the command is automatically ignored.

pub unsafe fn set_scissor_with_count(
    &mut self,
    scissors: impl IntoIterator<Item = Scissor>
)

Calls vkCmdSetScissorWithCountEXT on the builder.

If the list is empty then the command is automatically ignored.

pub unsafe fn set_viewport(
    &mut self,
    first_viewport: u32,
    viewports: impl IntoIterator<Item = Viewport>
)

Calls vkCmdSetViewport on the builder.

If the list is empty then the command is automatically ignored.

pub unsafe fn set_viewport_with_count(
    &mut self,
    viewports: impl IntoIterator<Item = Viewport>
)

Calls vkCmdSetViewportWithCountEXT on the builder.

If the list is empty then the command is automatically ignored.

impl UnsafeCommandBufferBuilder

pub unsafe fn blit_image(&mut self, blit_image_info: &BlitImageInfo)

Calls vkCmdBlitImage on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn clear_color_image(&mut self, clear_info: &ClearColorImageInfo)

Calls vkCmdClearColorImage on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn clear_depth_stencil_image(
    &mut self,
    clear_info: &ClearDepthStencilImageInfo
)

Calls vkCmdClearDepthStencilImage on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn resolve_image(&mut self, resolve_image_info: &ResolveImageInfo)

Calls vkCmdResolveImage on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

impl UnsafeCommandBufferBuilder

pub unsafe fn dispatch(&mut self, group_counts: [u32; 3])

Calls vkCmdDispatch on the builder.

pub unsafe fn dispatch_indirect(&mut self, buffer: &dyn BufferAccess)

Calls vkCmdDispatchIndirect on the builder.

pub unsafe fn draw(
    &mut self,
    vertex_count: u32,
    instance_count: u32,
    first_vertex: u32,
    first_instance: u32
)

Calls vkCmdDraw on the builder.

pub unsafe fn draw_indexed(
    &mut self,
    index_count: u32,
    instance_count: u32,
    first_index: u32,
    vertex_offset: i32,
    first_instance: u32
)

Calls vkCmdDrawIndexed on the builder.

pub unsafe fn draw_indirect(
    &mut self,
    buffer: &dyn BufferAccess,
    draw_count: u32,
    stride: u32
)

Calls vkCmdDrawIndirect on the builder.

pub unsafe fn draw_indexed_indirect(
    &mut self,
    buffer: &dyn BufferAccess,
    draw_count: u32,
    stride: u32
)

Calls vkCmdDrawIndexedIndirect on the builder.

impl UnsafeCommandBufferBuilder

pub unsafe fn begin_query(&mut self, query: Query<'_>, flags: QueryControlFlags)

Calls vkCmdBeginQuery on the builder.

pub unsafe fn end_query(&mut self, query: Query<'_>)

Calls vkCmdEndQuery on the builder.

pub unsafe fn write_timestamp(&mut self, query: Query<'_>, stage: PipelineStage)

Calls vkCmdWriteTimestamp on the builder.

pub unsafe fn copy_query_pool_results<D, T>(
    &mut self,
    queries: QueriesRange<'_>,
    destination: &D,
    stride: DeviceSize,
    flags: QueryResultFlags
)where
    D: TypedBufferAccess<Content = [T]>,
    T: QueryResultElement,

Calls vkCmdCopyQueryPoolResults on the builder.

pub unsafe fn reset_query_pool(&mut self, queries: QueriesRange<'_>)

Calls vkCmdResetQueryPool on the builder.

impl UnsafeCommandBufferBuilder

pub unsafe fn begin_render_pass(
    &mut self,
    render_pass_begin_info: &RenderPassBeginInfo,
    contents: SubpassContents
)

Calls vkCmdBeginRenderPass on the builder.

pub unsafe fn next_subpass(&mut self, contents: SubpassContents)

Calls vkCmdNextSubpass on the builder.

pub unsafe fn end_render_pass(&mut self)

Calls vkCmdEndRenderPass on the builder.

pub unsafe fn begin_rendering(&mut self, rendering_info: &RenderingInfo)

Calls vkCmdBeginRendering on the builder.

pub unsafe fn end_rendering(&mut self)

Calls vkCmdEndRendering on the builder.

pub unsafe fn clear_attachments(
    &mut self,
    attachments: impl IntoIterator<Item = ClearAttachment>,
    rects: impl IntoIterator<Item = ClearRect>
)

Calls vkCmdClearAttachments on the builder.

Does nothing if the list of attachments or the list of rects is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

impl UnsafeCommandBufferBuilder

pub unsafe fn execute_commands(
    &mut self,
    cbs: UnsafeCommandBufferBuilderExecuteCommands
)

Calls vkCmdExecuteCommands on the builder.

Does nothing if the list of command buffers is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

impl UnsafeCommandBufferBuilder

pub unsafe fn pipeline_barrier(&mut self, dependency_info: &DependencyInfo)

pub unsafe fn set_event(
    &mut self,
    event: &Event,
    dependency_info: &DependencyInfo
)

Calls vkCmdSetEvent on the builder.

pub unsafe fn wait_events<'a>(
    &mut self,
    events: impl IntoIterator<Item = (&'a Event, &'a DependencyInfo)>
)

Calls vkCmdWaitEvents on the builder.

pub unsafe fn reset_event(&mut self, event: &Event, stages: PipelineStages)

Calls vkCmdResetEvent on the builder.

impl UnsafeCommandBufferBuilder

pub unsafe fn copy_buffer(&mut self, copy_buffer_info: &CopyBufferInfo)

Calls vkCmdCopyBuffer on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn copy_image(&mut self, copy_image_info: &CopyImageInfo)

Calls vkCmdCopyImage on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn copy_buffer_to_image(
    &mut self,
    copy_buffer_to_image_info: &CopyBufferToImageInfo
)

Calls vkCmdCopyBufferToImage on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn copy_image_to_buffer(
    &mut self,
    copy_image_to_buffer_info: &CopyImageToBufferInfo
)

Calls vkCmdCopyImageToBuffer on the builder.

Does nothing if the list of regions is empty, as it would be a no-op and isn’t a valid usage of the command anyway.

pub unsafe fn fill_buffer(&mut self, fill_buffer_info: &FillBufferInfo)

Calls vkCmdFillBuffer on the builder.

pub unsafe fn update_buffer<D>(
    &mut self,
    data: &D,
    dst_buffer: &dyn BufferAccess,
    dst_offset: DeviceSize
)where
    D: BufferContents + ?Sized,

Calls vkCmdUpdateBuffer on the builder.

impl UnsafeCommandBufferBuilder

pub unsafe fn new(
    pool_alloc: &CommandPoolAlloc,
    begin_info: CommandBufferBeginInfo
) -> Result<UnsafeCommandBufferBuilder, OomError>

Creates a new builder, for recording commands.

Safety

• pool_alloc must outlive the returned builder and its created command buffer.
• kind must match how pool_alloc was created.

pub fn build(self) -> Result<UnsafeCommandBuffer, OomError>

Turns the builder into an actual command buffer.

Trait Implementations

impl Debug for UnsafeCommandBufferBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DeviceOwned for UnsafeCommandBufferBuilder

fn device(&self) -> &Arc<Device>

Returns the device that owns Self.

impl VulkanObject for UnsafeCommandBufferBuilder

type Handle = CommandBuffer

The type of the object.

fn handle(&self) -> Self::Handle

Returns the raw Vulkan handle of the object.