Struct gfx_hal::pool::CommandPool

pub struct CommandPool<B: Backend, C> { /* fields omitted */ }

Strong-typed command pool.

This a safer wrapper around RawCommandPool which ensures that only one command buffer is recorded at the same time from the current queue. Command buffers are stored internally and can only be obtained via a strong-typed CommandBuffer wrapper for encoding.

Methods

impl<B: Backend, C> CommandPool<B, C>

pub unsafe fn new(raw: B::CommandPool) -> Self

Create typed command pool from raw.

Safety

<C as Capability>::supported_by(queue_type) must return true for queue_type being the type of queues from family this raw pool is associated with.

pub unsafe fn reset(&mut self, release_resources: bool)

Reset the command pool and the corresponding command buffers.

Synchronization: You may not free the pool if a command buffer is still in use (pool memory still in use)

pub fn acquire_command_buffer<S: Shot>(&mut self) -> CommandBuffer<B, C, S>

Allocates a new primary command buffer from the pool.

pub fn acquire_secondary_command_buffer<S: Shot>(
    &mut self
) -> SecondaryCommandBuffer<B, C, S>

Allocates a new secondary command buffer from the pool.

pub unsafe fn free<I>(&mut self, cmd_buffers: I) where
    I: IntoIterator,
    I::Item: IntoRawCommandBuffer<B, C>, 

Free the given iterator of command buffers from the pool.

pub fn into_raw(self) -> B::CommandPool

Downgrade a typed command pool to untyped one.

impl<B: Backend, C: Supports<Graphics>> CommandPool<B, C>

pub fn acquire_subpass_command_buffer<S: Shot>(
    &mut self
) -> SubpassCommandBuffer<B, S>

Allocates a new subpass command buffer from the pool.

Trait Implementations

impl<B: Debug + Backend, C: Debug> Debug for CommandPool<B, C> where
    B::CommandPool: Debug, 

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

Formats the value using the given formatter.