java.lang.Object
- org.lwjgl.system.Pointer.Default
- - org.lwjgl.system.Struct
  - - org.lwjgl.vulkan.VkSubpassDependency

All Implemented Interfaces:

java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
```
public class VkSubpassDependency
extends org.lwjgl.system.Struct
implements org.lwjgl.system.NativeResource
```
Structure specifying a subpass dependency.
Description

If srcSubpass is equal to dstSubpass then the VkSubpassDependency describes a subpass self-dependency, and only constrains the pipeline barriers allowed within a subpass instance. Otherwise, when a render pass instance which includes a subpass dependency is submitted to a queue, it defines a memory dependency between the subpasses identified by srcSubpass and dstSubpass.

If srcSubpass is equal to SUBPASS_EXTERNAL, the first synchronization scope includes commands that occur earlier in submission order than the CmdBeginRenderPass used to begin the render pass instance. Otherwise, the first set of commands includes all commands submitted as part of the subpass instance identified by srcSubpass and any load, store or multisample resolve operations on attachments used in srcSubpass. In either case, the first synchronization scope is limited to operations on the pipeline stages determined by the source stage mask specified by srcStageMask.

If dstSubpass is equal to SUBPASS_EXTERNAL, the second synchronization scope includes commands that occur later in submission order than the CmdEndRenderPass used to end the render pass instance. Otherwise, the second set of commands includes all commands submitted as part of the subpass instance identified by dstSubpass and any load, store or multisample resolve operations on attachments used in dstSubpass. In either case, the second synchronization scope is limited to operations on the pipeline stages determined by the destination stage mask specified by dstStageMask.

The first access scope is limited to access in the pipeline stages determined by the source stage mask specified by srcStageMask. It is also limited to access types in the source access mask specified by srcAccessMask.

The second access scope is limited to access in the pipeline stages determined by the destination stage mask specified by dstStageMask. It is also limited to access types in the destination access mask specified by dstAccessMask.

The availability and visibility operations defined by a subpass dependency affect the execution of image layout transitions within the render pass.
Note

For non-attachment resources, the memory dependency expressed by subpass dependency is nearly identical to that of a VkMemoryBarrier (with matching srcAccessMask/dstAccessMask parameters) submitted as a part of a CmdPipelineBarrier (with matching srcStageMask/dstStageMask parameters). The only difference being that its scopes are limited to the identified subpasses rather than potentially affecting everything before and after.

For attachments however, subpass dependencies work more like a VkImageMemoryBarrier defined similarly to the VkMemoryBarrier above, the queue family indices set to QUEUE_FAMILY_IGNORED, and layouts as follows:
- The equivalent to oldLayout is the attachment’s layout according to the subpass description for srcSubpass.
- The equivalent to newLayout is the attachment’s layout according to the subpass description for dstSubpass.
Valid Usage
- If the geometry shaders feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_GEOMETRY_SHADER_BIT
- If the geometry shaders feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_GEOMETRY_SHADER_BIT
- If the tessellation shaders feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT
- If the tessellation shaders feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT
- srcSubpass must be less than or equal to dstSubpass, unless one of them is SUBPASS_EXTERNAL, to avoid cyclic dependencies and ensure a valid execution order
- srcSubpass and dstSubpass must not both be equal to SUBPASS_EXTERNAL
- If srcSubpass is equal to dstSubpass and not all of the stages in srcStageMask and dstStageMask are framebuffer-space stages, the logically latest pipeline stage in srcStageMask must be logically earlier than or equal to the logically earliest pipeline stage in dstStageMask
- Any access flag included in srcAccessMask must be supported by one of the pipeline stages in srcStageMask, as specified in the table of supported access types
- Any access flag included in dstAccessMask must be supported by one of the pipeline stages in dstStageMask, as specified in the table of supported access types
- If srcSubpass equals dstSubpass, and srcStageMask and dstStageMask both include a framebuffer-space stage, then dependencyFlags must include DEPENDENCY_BY_REGION_BIT
- If dependencyFlags includes DEPENDENCY_VIEW_LOCAL_BIT, srcSubpass must not be equal to SUBPASS_EXTERNAL
- If dependencyFlags includes DEPENDENCY_VIEW_LOCAL_BIT, dstSubpass must not be equal to SUBPASS_EXTERNAL
- If srcSubpass equals dstSubpass and that subpass has more than one bit set in the view mask, then dependencyFlags must include DEPENDENCY_VIEW_LOCAL_BIT
- If the mesh shaders feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_MESH_SHADER_BIT_NV
- If the task shaders feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_TASK_SHADER_BIT_NV
- If the mesh shaders feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_MESH_SHADER_BIT_NV
- If the task shaders feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_TASK_SHADER_BIT_NV
Valid Usage (Implicit)
- srcStageMask must be a valid combination of VkPipelineStageFlagBits values
- srcStageMask must not be 0
- dstStageMask must be a valid combination of VkPipelineStageFlagBits values
- dstStageMask must not be 0
- srcAccessMask must be a valid combination of VkAccessFlagBits values
- dstAccessMask must be a valid combination of VkAccessFlagBits values
- dependencyFlags must be a valid combination of VkDependencyFlagBits values
See Also

VkRenderPassCreateInfo

Member documentation
- srcSubpass – the subpass index of the first subpass in the dependency, or SUBPASS_EXTERNAL.
- dstSubpass – the subpass index of the second subpass in the dependency, or SUBPASS_EXTERNAL.
- srcStageMask – a bitmask of VkPipelineStageFlagBits specifying the source stage mask.
- dstStageMask – a bitmask of VkPipelineStageFlagBits specifying the destination stage mask
- srcAccessMask – a bitmask of VkAccessFlagBits specifying a source access mask.
- dstAccessMask – a bitmask of VkAccessFlagBits specifying a destination access mask.
- dependencyFlags – a bitmask of VkDependencyFlagBits.
Layout
```
 struct VkSubpassDependency {
     uint32_t srcSubpass;
     uint32_t dstSubpass;
     VkPipelineStageFlags srcStageMask;
     VkPipelineStageFlags dstStageMask;
     VkAccessFlags srcAccessMask;
     VkAccessFlags dstAccessMask;
     VkDependencyFlags dependencyFlags;
 }
```

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class VkSubpassDependency.Buffer
An array of VkSubpassDependency structs.
- Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
  org.lwjgl.system.Pointer.Default

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`ALIGNOF`	The struct alignment in bytes.
`static int`	`DEPENDENCYFLAGS DSTACCESSMASK DSTSTAGEMASK DSTSUBPASS`	The struct member offsets.
`static int`	`SIZEOF`	The struct size in bytes.
`static int`	`SRCACCESSMASK SRCSTAGEMASK SRCSUBPASS`	The struct member offsets.

Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE

Constructor Summary

Constructors
Constructor	Description
`VkSubpassDependency(java.nio.ByteBuffer container)`	Creates a `VkSubpassDependency` instance at the current position of the specified `ByteBuffer` container.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static VkSubpassDependency`	`calloc()`	Returns a new `VkSubpassDependency` instance allocated with `memCalloc`.
`static VkSubpassDependency.Buffer`	`calloc(int capacity)`	Returns a new `VkSubpassDependency.Buffer` instance allocated with `memCalloc`.
`static VkSubpassDependency`	`callocStack()`	Returns a new `VkSubpassDependency` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static VkSubpassDependency.Buffer`	`callocStack(int capacity)`	Returns a new `VkSubpassDependency.Buffer` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static VkSubpassDependency.Buffer`	`callocStack(int capacity, org.lwjgl.system.MemoryStack stack)`	Returns a new `VkSubpassDependency.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkSubpassDependency`	`callocStack(org.lwjgl.system.MemoryStack stack)`	Returns a new `VkSubpassDependency` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkSubpassDependency`	`create()`	Returns a new `VkSubpassDependency` instance allocated with `BufferUtils`.
`static VkSubpassDependency.Buffer`	`create(int capacity)`	Returns a new `VkSubpassDependency.Buffer` instance allocated with `BufferUtils`.
`static VkSubpassDependency`	`create(long address)`	Returns a new `VkSubpassDependency` instance for the specified memory address.
`static VkSubpassDependency.Buffer`	`create(long address, int capacity)`	Create a `VkSubpassDependency.Buffer` instance at the specified memory.
`static VkSubpassDependency`	`createSafe(long address)`	Like `create`, but returns `null` if `address` is `NULL`.
`static VkSubpassDependency.Buffer`	`createSafe(long address, int capacity)`	Like `create`, but returns `null` if `address` is `NULL`.
`int`	`dependencyFlags()`	Returns the value of the `dependencyFlags` field.
`VkSubpassDependency`	`dependencyFlags(int value)`	Sets the specified value to the `dependencyFlags` field.
`int`	`dstAccessMask()`	Returns the value of the `dstAccessMask` field.
`VkSubpassDependency`	`dstAccessMask(int value)`	Sets the specified value to the `dstAccessMask` field.
`int`	`dstStageMask()`	Returns the value of the `dstStageMask` field.
`VkSubpassDependency`	`dstStageMask(int value)`	Sets the specified value to the `dstStageMask` field.
`int`	`dstSubpass()`	Returns the value of the `dstSubpass` field.
`VkSubpassDependency`	`dstSubpass(int value)`	Sets the specified value to the `dstSubpass` field.
`static VkSubpassDependency`	`malloc()`	Returns a new `VkSubpassDependency` instance allocated with `memAlloc`.
`static VkSubpassDependency.Buffer`	`malloc(int capacity)`	Returns a new `VkSubpassDependency.Buffer` instance allocated with `memAlloc`.
`static VkSubpassDependency`	`mallocStack()`	Returns a new `VkSubpassDependency` instance allocated on the thread-local `MemoryStack`.
`static VkSubpassDependency.Buffer`	`mallocStack(int capacity)`	Returns a new `VkSubpassDependency.Buffer` instance allocated on the thread-local `MemoryStack`.
`static VkSubpassDependency.Buffer`	`mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)`	Returns a new `VkSubpassDependency.Buffer` instance allocated on the specified `MemoryStack`.
`static VkSubpassDependency`	`mallocStack(org.lwjgl.system.MemoryStack stack)`	Returns a new `VkSubpassDependency` instance allocated on the specified `MemoryStack`.
`static int`	`ndependencyFlags(long struct)`	Unsafe version of `dependencyFlags()`.
`static void`	`ndependencyFlags(long struct, int value)`	Unsafe version of `dependencyFlags`.
`static int`	`ndstAccessMask(long struct)`	Unsafe version of `dstAccessMask()`.
`static void`	`ndstAccessMask(long struct, int value)`	Unsafe version of `dstAccessMask`.
`static int`	`ndstStageMask(long struct)`	Unsafe version of `dstStageMask()`.
`static void`	`ndstStageMask(long struct, int value)`	Unsafe version of `dstStageMask`.
`static int`	`ndstSubpass(long struct)`	Unsafe version of `dstSubpass()`.
`static void`	`ndstSubpass(long struct, int value)`	Unsafe version of `dstSubpass`.
`static int`	`nsrcAccessMask(long struct)`	Unsafe version of `srcAccessMask()`.
`static void`	`nsrcAccessMask(long struct, int value)`	Unsafe version of `srcAccessMask`.
`static int`	`nsrcStageMask(long struct)`	Unsafe version of `srcStageMask()`.
`static void`	`nsrcStageMask(long struct, int value)`	Unsafe version of `srcStageMask`.
`static int`	`nsrcSubpass(long struct)`	Unsafe version of `srcSubpass()`.
`static void`	`nsrcSubpass(long struct, int value)`	Unsafe version of `srcSubpass`.
`VkSubpassDependency`	`set(int srcSubpass, int dstSubpass, int srcStageMask, int dstStageMask, int srcAccessMask, int dstAccessMask, int dependencyFlags)`	Initializes this struct with the specified values.
`VkSubpassDependency`	`set(VkSubpassDependency src)`	Copies the specified struct data to this struct.
`int`	`sizeof()`
`int`	`srcAccessMask()`	Returns the value of the `srcAccessMask` field.
`VkSubpassDependency`	`srcAccessMask(int value)`	Sets the specified value to the `srcAccessMask` field.
`int`	`srcStageMask()`	Returns the value of the `srcStageMask` field.
`VkSubpassDependency`	`srcStageMask(int value)`	Sets the specified value to the `srcStageMask` field.
`int`	`srcSubpass()`	Returns the value of the `srcSubpass` field.
`VkSubpassDependency`	`srcSubpass(int value)`	Sets the specified value to the `srcSubpass` field.

Methods inherited from interface org.lwjgl.system.NativeResource
close, free

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString

Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull

- Field Detail
  - SIZEOF
    
    The struct size in bytes.
  - ALIGNOF
    
    The struct alignment in bytes.
  - SRCSUBPASS, DSTSUBPASS, SRCSTAGEMASK, DSTSTAGEMASK, SRCACCESSMASK, DSTACCESSMASK, DEPENDENCYFLAGS
    
    The struct member offsets.
- Constructor Detail
  - VkSubpassDependency
```
public VkSubpassDependency(java.nio.ByteBuffer container)
```
    Creates a VkSubpassDependency instance at the current position of the specified ByteBuffer container. Changes to the buffer's content will be visible to the struct instance and vice versa.
    The created instance holds a strong reference to the container object.
- Method Detail
  - sizeof
```
public int sizeof()
```
    Specified by:
    
    sizeof in class org.lwjgl.system.Struct
  - srcSubpass
```
public int srcSubpass()
```
    Returns the value of the srcSubpass field.
  - dstSubpass
```
public int dstSubpass()
```
    Returns the value of the dstSubpass field.
  - srcStageMask
```
public int srcStageMask()
```
    Returns the value of the srcStageMask field.
  - dstStageMask
```
public int dstStageMask()
```
    Returns the value of the dstStageMask field.
  - srcAccessMask
```
public int srcAccessMask()
```
    Returns the value of the srcAccessMask field.
  - dstAccessMask
```
public int dstAccessMask()
```
    Returns the value of the dstAccessMask field.
  - dependencyFlags
```
public int dependencyFlags()
```
    Returns the value of the dependencyFlags field.
  - srcSubpass
```
public VkSubpassDependency srcSubpass(int value)
```
    Sets the specified value to the srcSubpass field.
  - dstSubpass
```
public VkSubpassDependency dstSubpass(int value)
```
    Sets the specified value to the dstSubpass field.
  - srcStageMask
```
public VkSubpassDependency srcStageMask(int value)
```
    Sets the specified value to the srcStageMask field.
  - dstStageMask
```
public VkSubpassDependency dstStageMask(int value)
```
    Sets the specified value to the dstStageMask field.
  - srcAccessMask
```
public VkSubpassDependency srcAccessMask(int value)
```
    Sets the specified value to the srcAccessMask field.
  - dstAccessMask
```
public VkSubpassDependency dstAccessMask(int value)
```
    Sets the specified value to the dstAccessMask field.
  - dependencyFlags
```
public VkSubpassDependency dependencyFlags(int value)
```
    Sets the specified value to the dependencyFlags field.
  - set
```
public VkSubpassDependency set(int srcSubpass,
                               int dstSubpass,
                               int srcStageMask,
                               int dstStageMask,
                               int srcAccessMask,
                               int dstAccessMask,
                               int dependencyFlags)
```
    Initializes this struct with the specified values.
  - set
```
public VkSubpassDependency set(VkSubpassDependency src)
```
    Copies the specified struct data to this struct.
    
    Parameters:
    
    src - the source struct
    
    Returns:
    
    this struct
  - malloc
```
public static VkSubpassDependency malloc()
```
    Returns a new VkSubpassDependency instance allocated with memAlloc. The instance must be explicitly freed.
  - calloc
```
public static VkSubpassDependency calloc()
```
    Returns a new VkSubpassDependency instance allocated with memCalloc. The instance must be explicitly freed.
  - create
```
public static VkSubpassDependency create()
```
    Returns a new VkSubpassDependency instance allocated with BufferUtils.
  - create
```
public static VkSubpassDependency create(long address)
```
    Returns a new VkSubpassDependency instance for the specified memory address.
  - createSafe
```
@Nullable
public static VkSubpassDependency createSafe(long address)
```
    Like create, but returns null if address is NULL.
  - malloc
```
public static VkSubpassDependency.Buffer malloc(int capacity)
```
    Returns a new VkSubpassDependency.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - calloc
```
public static VkSubpassDependency.Buffer calloc(int capacity)
```
    Returns a new VkSubpassDependency.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkSubpassDependency.Buffer create(int capacity)
```
    Returns a new VkSubpassDependency.Buffer instance allocated with BufferUtils.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkSubpassDependency.Buffer create(long address,
                                                int capacity)
```
    Create a VkSubpassDependency.Buffer instance at the specified memory.
    
    Parameters:
    
    address - the memory address
    
    capacity - the buffer capacity
  - createSafe
```
@Nullable
public static VkSubpassDependency.Buffer createSafe(long address,
                                                    int capacity)
```
    Like create, but returns null if address is NULL.
  - mallocStack
```
public static VkSubpassDependency mallocStack()
```
    Returns a new VkSubpassDependency instance allocated on the thread-local MemoryStack.
  - callocStack
```
public static VkSubpassDependency callocStack()
```
    Returns a new VkSubpassDependency instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
  - mallocStack
```
public static VkSubpassDependency mallocStack(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkSubpassDependency instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
  - callocStack
```
public static VkSubpassDependency callocStack(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkSubpassDependency instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
  - mallocStack
```
public static VkSubpassDependency.Buffer mallocStack(int capacity)
```
    Returns a new VkSubpassDependency.Buffer instance allocated on the thread-local MemoryStack.
    
    Parameters:
    
    capacity - the buffer capacity
  - callocStack
```
public static VkSubpassDependency.Buffer callocStack(int capacity)
```
    Returns a new VkSubpassDependency.Buffer instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    capacity - the buffer capacity
  - mallocStack
```
public static VkSubpassDependency.Buffer mallocStack(int capacity,
                                                     org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkSubpassDependency.Buffer instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - callocStack
```
public static VkSubpassDependency.Buffer callocStack(int capacity,
                                                     org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkSubpassDependency.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - nsrcSubpass
```
public static int nsrcSubpass(long struct)
```
    Unsafe version of srcSubpass().
  - ndstSubpass
```
public static int ndstSubpass(long struct)
```
    Unsafe version of dstSubpass().
  - nsrcStageMask
```
public static int nsrcStageMask(long struct)
```
    Unsafe version of srcStageMask().
  - ndstStageMask
```
public static int ndstStageMask(long struct)
```
    Unsafe version of dstStageMask().
  - nsrcAccessMask
```
public static int nsrcAccessMask(long struct)
```
    Unsafe version of srcAccessMask().
  - ndstAccessMask
```
public static int ndstAccessMask(long struct)
```
    Unsafe version of dstAccessMask().
  - ndependencyFlags
```
public static int ndependencyFlags(long struct)
```
    Unsafe version of dependencyFlags().
  - nsrcSubpass
```
public static void nsrcSubpass(long struct,
                               int value)
```
    Unsafe version of srcSubpass.
  - ndstSubpass
```
public static void ndstSubpass(long struct,
                               int value)
```
    Unsafe version of dstSubpass.
  - nsrcStageMask
```
public static void nsrcStageMask(long struct,
                                 int value)
```
    Unsafe version of srcStageMask.
  - ndstStageMask
```
public static void ndstStageMask(long struct,
                                 int value)
```
    Unsafe version of dstStageMask.
  - nsrcAccessMask
```
public static void nsrcAccessMask(long struct,
                                  int value)
```
    Unsafe version of srcAccessMask.
  - ndstAccessMask
```
public static void ndstAccessMask(long struct,
                                  int value)
```
    Unsafe version of dstAccessMask.
  - ndependencyFlags
```
public static void ndependencyFlags(long struct,
                                    int value)
```
    Unsafe version of dependencyFlags.

Class VkSubpassDependency

Description

Note

Valid Usage

Valid Usage (Implicit)

See Also

Member documentation

Layout

Nested Class Summary

Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

Field Summary

Fields inherited from interface org.lwjgl.system.Pointer

Constructor Summary

Method Summary

Methods inherited from interface org.lwjgl.system.NativeResource

Methods inherited from class java.lang.Object

Methods inherited from class org.lwjgl.system.Pointer.Default

Methods inherited from class org.lwjgl.system.Struct

Field Detail

SIZEOF

ALIGNOF

SRCSUBPASS, DSTSUBPASS, SRCSTAGEMASK, DSTSTAGEMASK, SRCACCESSMASK, DSTACCESSMASK, DEPENDENCYFLAGS

Constructor Detail

VkSubpassDependency

Method Detail

sizeof

srcSubpass

dstSubpass

srcStageMask

dstStageMask

srcAccessMask

dstAccessMask

dependencyFlags

srcSubpass

dstSubpass

srcStageMask

dstStageMask

srcAccessMask

dstAccessMask

dependencyFlags

set

set

malloc

calloc

create

create

createSafe

malloc

calloc

create

create

createSafe

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

nsrcSubpass

ndstSubpass

nsrcStageMask

ndstStageMask

nsrcAccessMask

ndstAccessMask

ndependencyFlags

nsrcSubpass

ndstSubpass

nsrcStageMask

ndstStageMask

nsrcAccessMask

ndstAccessMask

ndependencyFlags