Skip to main content

CommandBuffer

Struct CommandBuffer 

Source
pub struct CommandBuffer(/* private fields */);
Expand description

MTL4 command buffer for recording GPU commands.

C++ equivalent: MTL4::CommandBuffer

CommandBuffer in Metal 4 provides explicit control over command recording with an allocator-based memory model.

Implementations§

Source§

impl CommandBuffer

Source

pub unsafe fn from_raw(ptr: *mut c_void) -> Option<Self>

Create a CommandBuffer from a raw pointer.

Source

pub fn as_raw(&self) -> *mut c_void

Get the raw pointer.

Source

pub fn device(&self) -> Option<Device>

Get the device.

C++ equivalent: MTL::Device* device() const

Source

pub fn label(&self) -> Option<String>

Get the label.

C++ equivalent: NS::String* label() const

Source

pub fn set_label(&self, label: &str)

Set the label.

C++ equivalent: void setLabel(const NS::String* label)

Source

pub fn begin_command_buffer(&self, allocator: &CommandAllocator)

Begin recording commands with an allocator.

C++ equivalent: void beginCommandBuffer(const MTL4::CommandAllocator* allocator)

Source

pub fn begin_command_buffer_with_options( &self, allocator: &CommandAllocator, options: &CommandBufferOptions, )

Begin recording commands with an allocator and options.

C++ equivalent: void beginCommandBuffer(const MTL4::CommandAllocator*, const MTL4::CommandBufferOptions*)

Source

pub fn end_command_buffer(&self)

End recording commands.

C++ equivalent: void endCommandBuffer()

Source

pub fn use_residency_set(&self, residency_set: &ResidencySet)

Use a residency set.

C++ equivalent: void useResidencySet(const MTL::ResidencySet* residencySet)

Source

pub fn use_residency_sets(&self, residency_sets: &[&ResidencySet])

Use multiple residency sets.

C++ equivalent: void useResidencySets(const MTL::ResidencySet* const[], NS::UInteger count)

Source

pub fn push_debug_group(&self, name: &str)

Push a debug group.

C++ equivalent: void pushDebugGroup(const NS::String* string)

Source

pub fn pop_debug_group(&self)

Pop the current debug group.

C++ equivalent: void popDebugGroup()

Source

pub fn compute_command_encoder(&self) -> Option<ComputeCommandEncoder>

Create a compute command encoder.

C++ equivalent: ComputeCommandEncoder* computeCommandEncoder()

Source

pub fn render_command_encoder( &self, descriptor: &RenderPassDescriptor, ) -> Option<RenderCommandEncoder>

Create a render command encoder with the specified render pass descriptor.

C++ equivalent: RenderCommandEncoder* renderCommandEncoder(const RenderPassDescriptor*)

Source

pub fn machine_learning_command_encoder( &self, ) -> Option<MachineLearningCommandEncoder>

Create a machine learning command encoder.

C++ equivalent: MachineLearningCommandEncoder* machineLearningCommandEncoder()

Source

pub fn resolve_counter_heap( &self, counter_heap: *const c_void, range_location: UInteger, range_length: UInteger, buffer_range: BufferRange, fence_to_wait: *const c_void, fence_to_update: *const c_void, )

Resolve counter heap data into a buffer.

C++ equivalent: void resolveCounterHeap(const MTL4::CounterHeap*, NS::Range, const MTL4::BufferRange, const MTL::Fence*, const MTL::Fence*)

Source

pub fn write_timestamp_into_heap( &self, counter_heap: *const c_void, index: UInteger, )

Write a timestamp into a counter heap.

C++ equivalent: void writeTimestampIntoHeap(const MTL4::CounterHeap*, NS::UInteger)

Trait Implementations§

Source§

impl Clone for CommandBuffer

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for CommandBuffer

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Drop for CommandBuffer

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

impl Referencing for CommandBuffer

Source§

fn as_ptr(&self) -> *const c_void

Get the raw pointer to the Objective-C object.
Source§

fn as_mut_ptr(&self) -> *mut c_void

Get the raw mutable pointer to the Objective-C object.
Source§

fn retain(&self) -> Self
where Self: Clone,

Retain the object, incrementing its reference count. Read more
Source§

fn release(&self)

Release the object, decrementing its reference count. Read more
Source§

fn autorelease(&self) -> Self
where Self: Clone,

Autorelease the object. Read more
Source§

fn retain_count(&self) -> usize

Get the retain count of the object. Read more
Source§

impl Send for CommandBuffer

Source§

impl Sync for CommandBuffer

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.