Vulkan Pipeline State

class renderdoc.VKState

The full current Vulkan pipeline state.

colorBlend

The color blending configuration.

Type

VKColorBlendState

compute

The currently bound compute pipeline, if any.

Type

VKPipeline

computeShader

The compute shader stage.

Type

VKShader

conditionalRendering

The current conditional rendering state.

Type

VKConditionalRendering

currentPass

The current renderpass, subpass and framebuffer.

Type

VKCurrentPass

depthStencil

The depth-stencil state.

Type

VKDepthStencil

fragmentShader

The fragment shader stage.

Type

VKShader

geometryShader

The geometry shader stage.

Type

VKShader

graphics

The currently bound graphics pipeline, if any.

Type

VKPipeline

images

The resource states for the currently live resources.

Type

List[VKImageData]

inputAssembly

The input assembly stage.

Type

VKInputAssembly

meshShader

The mesh shader stage.

Type

VKShader

multisample

The multisampling configuration.

Type

VKMultiSample

pushconsts

The raw push constant data.

Type

bytes

rasterizer

The rasterization configuration.

Type

VKRasterizer

shaderMessages

The shader messages retrieved for this action.

Type

List[ShaderMessage]

taskShader

The task shader stage.

Type

VKShader

tessControlShader

The tessellation control shader stage.

Type

VKShader

tessEvalShader

The tessellation evaluation shader stage.

Type

VKShader

tessellation

The tessellation stage.

Type

VKTessellation

transformFeedback

The transform feedback stage.

Type

VKTransformFeedback

vertexInput

The vertex input stage.

Type

VKVertexInput

vertexShader

The vertex shader stage.

Type

VKShader

viewportScissor

The viewport setup.

Type

VKViewState

Pipeline and Bindings

class renderdoc.VKPipeline

Describes the object and descriptor set bindings of a Vulkan pipeline object.

descriptorSets

The bound descriptor sets.

Type

List[VKDescriptorSet]

flags

The flags used to create the pipeline object.

pipelineComputeLayoutResourceId

The ResourceId of the compute pipeline layout object.

pipelineFragmentLayoutResourceId

The ResourceId of the fragment pipeline layout object.

When not using pipeline libraries, this will be identical to pipelinePreRastLayoutResourceId.

pipelinePreRastLayoutResourceId

The ResourceId of the pre-rasterization pipeline layout object.

When not using pipeline libraries, this will be identical to pipelineFragmentLayoutResourceId.

pipelineResourceId

The ResourceId of the pipeline object.

class renderdoc.VKDescriptorSet

The contents of a descriptor set.

descriptorSetResourceId

The ResourceId of the descriptor set object.

dynamicOffsets

A list of dynamic offsets to be applied to specific bindings, on top of the contents of their descriptors.

Note

The returned values from PipeState.GetConstantBuffer() already have these offsets applied.

Type

List[VKDynamicOffset]

layoutResourceId

The ResourceId of the descriptor set layout that matches this set.

pushDescriptor

Indicates if this is a virtual ‘push’ descriptor set.

class renderdoc.VKDynamicOffset

A dynamic offset applied to a single descriptor access.

descriptorByteOffset

The offset in bytes to the descriptor in the storage.

Type

int

dynamicBufferByteOffset

The dynamic offset to apply to the buffer in bytes.

Type

int

Vertex Input

class renderdoc.VKInputAssembly

Describes the vulkan input assembly configuration.

indexBuffer

The index buffer binding.

Type

VKIndexBuffer

primitiveRestartEnable

True if primitive restart is enabled for strip primitives.

topology

The current primitive topology.

Type

Topology

class renderdoc.VKIndexBuffer

Describes the Vulkan index buffer binding.

byteOffset

The byte offset from the start of the buffer to the beginning of the index data.

byteStride

The number of bytes for each index in the index buffer. Typically 2 or 4 bytes but it can be 0 if no index buffer is bound.

resourceId

The ResourceId of the index buffer.

class renderdoc.VKVertexInput

Describes the fixed-function vertex input fetch setup.

attributes

The vertex attributes.

Type

List[VKVertexAttribute]

bindings

The vertex bindings.

Type

List[VKVertexBinding]

vertexBuffers

The vertex buffers.

Type

List[VKVertexBuffer]

class renderdoc.VKVertexAttribute

Describes the configuration of a single vertex attribute.

binding

The vertex binding where data will be sourced from.

byteOffset

The byte offset from the start of each vertex data in the binding to this attribute.

format

The format describing how the input element is interpreted.

Type

ResourceFormat

location

The location in the shader that is bound to this attribute.

class renderdoc.VKVertexBinding

Describes a vertex binding.

instanceDivisor

The instance rate divisor.

If this is 0 then every vertex gets the same value.

If it’s 1 then one element is read for each instance, and for N greater than 1 then N instances read the same element before advancing.

perInstance

True if the vertex data is instance-rate.

vertexBufferBinding

The vertex binding where data will be sourced from.

class renderdoc.VKVertexBuffer

Describes a single Vulkan vertex buffer binding.

byteOffset

The byte offset from the start of the buffer to the beginning of the vertex data.

byteSize

The size of the vertex buffer.

byteStride

The byte stride between the start of one set of vertex data and the next.

resourceId

The ResourceId of the buffer bound to this slot.

Shader

class renderdoc.VKShader

Describes a Vulkan shader stage.

entryPoint

The name of the entry point in the shader module that is used.

pushConstantRangeByteOffset

The byte offset into the push constant data that is visible to this shader.

pushConstantRangeByteSize

The number of bytes in the push constant data that is visible to this shader.

reflection

The reflection data for this shader.

Type

ShaderReflection

requiredSubgroupSize

The required subgroup size specified for this shader at pipeline creation time.

resourceId

The ResourceId of the shader module object.

shaderObject

Whether the shader is a shader object or shader module.

specializationData

The provided specialization constant data. Shader constants store the byte offset into this buffer as their byteOffset. This data includes the applied specialization constants over the top of the default values, so it is safe to read any constant from here and get the correct current value.

Type

bytes

specializationIds

The specialization constant ID for each entry in the specialization constant block of reflection info. This corresponds to the constantID in VkSpecializationMapEntry, while the offset and size into specializationData can be obtained from the reflection info.

Type

List[int]

stage

A ShaderStage identifying which stage this shader is bound to.

Tessellation

class renderdoc.VKTessellation

Describes the state of the fixed-function tessellator.

domainOriginUpperLeft

True if the tessellation domain origin is upper-left, False if lower-left.

numControlPoints

The number of control points in each input patch.

Transform Feedback

class renderdoc.VKTransformFeedback

Describes the state of the fixed-function transform feedback.

buffers

The bound transform feedback buffers.

Type

List[VKXFBBuffer]

rasterizedStream

Which stream-out stream is being used for rasterization.

Type

int

class renderdoc.VKXFBBuffer

Describes a single transform feedback binding.

active

A flag indicating if this buffer is active or not.

bufferResourceId

The ResourceId of the bound data buffer.

byteOffset

The offset in bytes to the start of the data in the bufferResourceId.

byteSize

The size in bytes of the data buffer.

counterBufferOffset

The offset in bytes to the counter in the counterBufferResourceId.

counterBufferResourceId

The ResourceId of the buffer storing the counter value (if set).

Rasterizer

class renderdoc.VKViewportScissor

Describes a combined viewport and scissor region.

scissor

The scissor.

Type

Scissor

vp

The viewport.

Type

Viewport

class renderdoc.VKViewState

Describes the view state in the pipeline.

depthNegativeOneToOne

Whether depth clip range is set to [-1, 1] through VK_EXT_depth_clip_control.

discardRectangles

The discard rectangles, if enabled.

Type

List[VKRenderArea]

discardRectanglesExclusive

True if a fragment in any one of the discard rectangles fails the discard test, and a fragment in none of them passes.

False if a fragment in any one of the discard rectangles passes the discard test, and a fragment in none of them is discarded.

Note

A True value and an empty list of discardRectangles means the test is effectively disabled, since with no rectangles no fragment can be inside one.

viewportScissors

The bound viewports and scissors.

Type

List[VKViewportScissor]

class renderdoc.VKRasterizer

Describes the rasterizer state in the pipeline.

conservativeRasterization

The active conservative rasterization mode.

cullMode

The polygon CullMode.

depthBias

The fixed depth bias value to apply to z-values.

depthBiasClamp

The clamp value for calculated depth bias from depthBias and slopeScaledDepthBias

depthBiasEnable

Whether depth biasing is enabled.

depthClampEnable

True if pixels outside of the near and far depth planes should be clamped and to 0.0 to 1.0.

depthClipEnable

True if pixels outside of the near and far depth planes should be clipped.

Note

In Vulkan 1.0 this value was implicitly set to the opposite of depthClampEnable, but with later extensions & versions it can be set independently.

extraPrimitiveOverestimationSize

The extra size in pixels to increase primitives by during conservative rasterization, in the x and y directions in screen space.

See conservativeRasterizationMode

fillMode

The polygon FillMode.

frontCCW

True if counter-clockwise polygons are front-facing. False if clockwise polygons are front-facing.

lineRasterMode

The line rasterization mode.

lineStippleFactor

The line stipple factor, or 0 if line stipple is disabled.

lineStipplePattern

The line stipple bit-pattern.

lineWidth

The fixed line width in pixels.

pipelineShadingRate

The current pipeline fragment shading rate. This will always be 1x1 when a fragment shading rate has not been specified.

Type

Tuple[int,int]

provokingVertexFirst

Whether the provoking vertex is the first one (default behaviour).

rasterizerDiscardEnable

True if primitives should be discarded during rasterization.

shadingRateCombiners

The fragment shading rate combiners.

The combiners are applied as follows, according to the Vulkan spec:

intermediateRate = combiner[0] ( pipelineShadingRate,  shaderExportedShadingRate ) finalRate        = combiner[1] ( intermediateRate,     imageBasedShadingRate     )

Where the first input is from pipelineShadingRate and the second is the exported shading rate from the last pre-rasterization shader stage, which defaults to 1x1 if not exported.

The intermediate result is then used as the first input to the second combiner, together with the shading rate sampled from the fragment shading rate attachment.

Type

Tuple[ShadingRateCombiner,ShadingRateCombiner]

slopeScaledDepthBias

The slope-scaled depth bias value to apply to z-values.

Multisampling

class renderdoc.VKMultiSample

Describes the multisampling state in the pipeline.

minSampleShading

The minimum sample shading rate.

rasterSamples

How many samples to use when rasterizing.

sampleLocations

The custom sample locations configuration.

Type

VKSampleLocations

sampleMask

A mask that generated samples should be masked with using bitwise AND.

sampleShadingEnable

True if rendering should happen at sample-rate frequency.

class renderdoc.VKSampleLocations

Describes state of custom sample locations in the pipeline.

customLocations

The custom sample locations. Only x and y are valid, z and w are set to 0.0.

If the list is empty then the standard sample pattern is in use.

Type

List[FloatVector]

gridHeight

The height in pixels of the region configured.

gridWidth

The width in pixels of the region configured.

Blending

class renderdoc.VKColorBlendState

Describes the pipeline blending state.

alphaToCoverageEnable

True if alpha-to-coverage should be used when blending to an MSAA target.

alphaToOneEnable

True if alpha-to-one should be used when blending to an MSAA target.

blendFactor

The constant blend factor to use in blend equations.

Type

Tuple[float,float,float,float]

blends

The blend operations for each target.

Type

List[ColorBlend]

Depth/Stencil State

class renderdoc.VKDepthStencil

Describes the pipeline depth-stencil state.

backFace

The stencil state for back-facing polygons.

Type

StencilFace

depthBoundsEnable

True if depth bounds tests should be applied.

depthFunction

The CompareFunction to use for testing depth values.

depthTestEnable

True if depth testing should be performed.

depthWriteEnable

True if depth values should be written to the depth target.

frontFace

The stencil state for front-facing polygons.

Type

StencilFace

maxDepthBounds

The far plane bounding value.

minDepthBounds

The near plane bounding value.

stencilTestEnable

True if stencil operations should be performed.

Renderpass and Framebuffer

class renderdoc.VKCurrentPass

Describes the current pass instance at the current time.

colorFeedbackAllowed

If feedback loops are allowed on color attachments

depthFeedbackAllowed

If feedback loops are allowed on depth attachments

framebuffer

The framebuffer that is currently being used.

Type

VKFramebuffer

renderArea

The render area that is currently being rendered to.

Type

VKRenderArea

renderpass

The renderpass and subpass that is currently active.

Type

VKRenderPass

stencilFeedbackAllowed

If feedback loops are allowed on stencil attachments

class renderdoc.VKRenderPass

Describes the setup of a renderpass and subpasses.

colorAttachments

The color attachments for the current subpass, as indices into the framebuffer attachments.

Type

List[int]

depthstencilAttachment

An index into the framebuffer attachments for the depth-stencil attachment.

If there is no depth-stencil attachment, this index is -1.

depthstencilResolveAttachment

An index into the framebuffer attachments for the depth-stencil resolve attachment.

If there is no depth-stencil resolve attachment, this index is -1.

dynamic

Whether or not dynamic rendering is in use (no render pass or framebuffer objects).

feedbackLoop

Whether or not there is a potential feedback loop.

fragmentDensityAttachment

An index into the framebuffer attachments for the fragment density attachment.

If there is no fragment density attachment, this index is -1.

Note

Only one at most of fragmentDensityAttachment and shadingRateAttachment will be set.

fragmentDensityOffsets

If VK_QCOM_fragment_density_map_offset is enabled, contains a list of offsets applied to the fragment density map during rendering.

If the list is empty, fdm_offset is disabled and rendering is as normal.

Type

List[Offset]

inputAttachments

The input attachments for the current subpass, as indices into the framebuffer attachments.

Type

List[int]

multiviews

If multiview is enabled, contains a list of view indices to be broadcast to during rendering.

If the list is empty, multiview is disabled and rendering is as normal.

Type

List[int]

resolveAttachments

The resolve attachments for the current subpass, as indices into the framebuffer attachments.

Type

List[int]

resourceId

The ResourceId of the render pass.

shadingRateAttachment

An index into the framebuffer attachments for the fragment shading rate attachment.

If there is no fragment shading rate attachment, this index is -1.

Note

Only one at most of fragmentDensityAttachment and shadingRateAttachment will be set.

shadingRateTexelSize

The size of the framebuffer region represented by each texel in shadingRateAttachment.

For example if this is (2,2) then every texel in the attachment gives the shading rate of a 2x2 block in the framebuffer so the shading rate attachment is half the size of the other attachments in each dimension.

If no attachment is set in shadingRateAttachment this will be (1,1).

Type

Tuple[int,int]

subpass

The index of the current active subpass.

suspended

Whether or not dynamic rendering is currently suspended.

tileOnlyMSAASampleCount

If VK_EXT_multisampled_render_to_single_sampled is enabled, contains the number of samples used to render this subpass.

If the subpass is not internally multisampled, tileOnlyMSAASampleCount is set to 0.

class renderdoc.VKFramebuffer

Describes a framebuffer object and its attachments.

attachments

The attachments of this framebuffer.

Type

List[Descriptor]

height

The height of this framebuffer in pixels.

layers

The number of layers in this framebuffer.

resourceId

The ResourceId of the framebuffer object.

width

The width of this framebuffer in pixels.

class renderdoc.VKRenderArea

Describes a render area in the current framebuffer.

height

The height of the render area.

width

The width of the render area.

x

The X co-ordinate of the render area.

y

The Y co-ordinate of the render area.

Image States

class renderdoc.VKImageData

Contains the current layout of all subresources in the image.

layouts

The subresource regions in this resource.

Type

List[VKImageLayout]

resourceId

The ResourceId of the image.

class renderdoc.VKImageLayout

Contains the layout of a range of subresources in an image.

baseLayer

For 3D textures and texture arrays, the first slice used in the range.

baseMip

The first mip level used in the range.

name

The name of the current image state.

numLayer

For 3D textures and texture arrays, the number of array slices in the range.

numMip

The number of mip levels in the range.

Conditional Rendering

class renderdoc.VKConditionalRendering

Contains the current conditional rendering state.

bufferId

The ResourceId of the buffer containing the predicate for conditional rendering.

byteOffset

The byte offset into buffer where the predicate is located.

isInverted

True if predicate result is inverted.

isPassing

True if the current predicate would render.