Struct vulkano::render_pass::SubpassDependency

pub struct SubpassDependency {
    pub src_subpass: Option<u32>,
    pub dst_subpass: Option<u32>,
    pub src_stages: PipelineStages,
    pub dst_stages: PipelineStages,
    pub src_access: AccessFlags,
    pub dst_access: AccessFlags,
    pub dependency_flags: DependencyFlags,
    pub view_offset: i32,
    pub _ne: NonExhaustive,
}

A dependency between two subpasses of a render pass.

The implementation is allowed to change the order of the subpasses within a render pass, unless you specify that there exists a dependency between two subpasses (ie. the result of one will be used as the input of another one). Subpass dependencies work similar to pipeline barriers, except that they operate on whole subpasses instead of individual images.

If src_subpass and dst_subpass are equal, then this specifies a subpass self-dependency. The src_stages must all be logically earlier in the pipeline than the dst_stages, and if they both contain a framebuffer-space stage, then by_region must be activated.

If src_subpass or dst_subpass are set to None, this specifies an external dependency. An external dependency specifies a dependency on commands that were submitted before the render pass instance began (for src_subpass), or on commands that will be submitted after the render pass instance ends (for dst_subpass). The values must not both be None.

Fields

src_subpass: Option<u32>

The index of the subpass that writes the data that dst_subpass is going to use.

None specifies an external dependency.

The default value is None.

dst_subpass: Option<u32>

The index of the subpass that reads the data that src_subpass wrote.

None specifies an external dependency.

The default value is None.

src_stages: PipelineStages

The pipeline stages that must be finished on src_subpass before the dst_stages of dst_subpass can start.

The default value is PipelineStages::empty().

dst_stages: PipelineStages

The pipeline stages of dst_subpass that must wait for the src_stages of src_subpass to be finished. Stages that are earlier than the stages specified here can start before the src_stages are finished.

The default value is PipelineStages::empty().

src_access: AccessFlags

The way src_subpass accesses the attachments on which we depend.

The default value is AccessFlags::empty().

dst_access: AccessFlags

The way dst_subpass accesses the attachments on which we depend.

The default value is AccessFlags::empty().

dependency_flags: DependencyFlags

Dependency flags that modify behavior of the subpass dependency.

If a src_subpass equals dst_subpass, then:

• If src_stages and dst_stages both contain framebuffer-space stages, this must include BY_REGION.
• If the subpass’s view_mask has more than one view, this must include VIEW_LOCAL.

The default value is DependencyFlags::empty().

view_offset: i32

If multiview rendering is being used (the subpasses have a nonzero view_mask), and dependency_flags includes VIEW_LOCAL, specifies an offset relative to the view index of dst_subpass: each view d in dst_subpass depends on view d + view_offset in src_subpass. If the source view index does not exist, the dependency is ignored for that view.

If dependency_flags does not include VIEW_LOCAL, or if src_subpass and dst_subpass are the same, the value must be 0.

The default value is 0.

_ne: NonExhaustive

Trait Implementations

impl Clone for SubpassDependency

fn clone(&self) -> SubpassDependency

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SubpassDependency

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

Formats the value using the given formatter.

impl Default for SubpassDependency

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SubpassDependency

fn eq(&self, other: &SubpassDependency) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SubpassDependency

impl StructuralEq for SubpassDependency

impl StructuralPartialEq for SubpassDependency