Struct CommandStreamDraft 

pub struct CommandStreamDraft<A = ()> {
    pub args: A,
    /* private fields */
}

A finalized command stream definition that can be prepared later.

Drafts are useful when construction should happen separately from preparation. Convert a draft with CommandStreamDraft::into_stream for unprepared insertion or CommandStreamDraft::prepare to cache preparation work.

let draft = CommandStream::finalize(|stream| {
    stream.begin_cmd().record_cmd(|_| {});
});

let prepared = draft.prepare(&mut pool)?;
let mut graph = Graph::new();
graph.insert_cmd_stream(&prepared).finish();

Fields

args: A

Typed handles returned by the finalization callback.

Implementations

impl<A> CommandStreamDraft<A>

pub fn into_stream(self) -> CommandStream<A>

Converts this draft into a command stream without preparing optimizations.

Unprepared streams avoid preparation cost until insertion, but they do not cache the prepared schedule or static recording resources.

pub fn prepare<P>(self, pool: &mut P) -> Result<CommandStream<A>, DriverError>

where P: SubmissionPool,

Prepares this stream by optimizing its finalized graph and leasing static recording resources for the prepared schedule.

This is most useful when the same stream is inserted many times with different arguments.

Trait Implementations

impl<A: Debug> Debug for CommandStreamDraft<A>

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

Formats the value using the given formatter.