OpenGL Pipeline State ¶

indexByteStride¶: The byte width of the index buffer - typically 1, 2 or 4 bytes. It can be 0 for non-indexed draws.

Note

This does not correspond to a real GL state since the index type is specified per-action in the call itself. This is an implicit state derived from the last (or current) action at any given event.

primitiveRestart¶: True if primitive restart is enabled for strip primitives.

provokingVertexLast¶

True if the provoking vertex is the last one in the primitive.

False if the provoking vertex is the first one.

restartIndex¶: The index value to use to indicate a strip restart.

topology¶: The byte width of the index buffer - typically 1, 2 or 4 bytes.

Note

This does not correspond to a real GL state since the topology is specified per-action in the call itself. This is an implicit state derived from the last (or current) action at any given event.

vertexArrayObject¶: The ResourceId of the vertex array object that’s bound.

vertexBuffers¶

The vertex buffers.

Type: List[GLVertexBuffer]

class renderdoc.GLVertexAttribute¶

Describes the configuration for a single vertex attribute.

Note

If old-style vertex attrib pointer setup was used for the vertex attributes then it will be decomposed into 1:1 attributes and buffers.

byteOffset¶: The byte offset from the start of the vertex data in the vertex buffer from vertexBufferSlot.

enabled¶: True if this vertex attribute is enabled.

floatCast¶

Only valid for integer formatted attributes, True if they are cast to float.

This is because they were specified with an integer format but glVertexAttribFormat (not glVertexAttribIFormat) so they will be cast.

format¶

The format describing how the vertex attribute is interpreted.

Type: ResourceFormat

genericValue¶

The generic value of the vertex attribute if no buffer is bound.

Type: PixelValue

vertexBufferSlot¶: The vertex buffer input slot where the data is sourced from.

class renderdoc.GLVertexBuffer¶

Describes a single OpenGL vertex buffer binding.

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

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

instanceDivisor¶

The instance rate divisor.

If this is 0 then the vertex buffer is read at vertex rate.

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.

resourceId¶: The ResourceId of the buffer bound to this slot.

Shader ¶

class renderdoc.GLShader¶

Describes an OpenGL shader stage.

bindpointMapping¶

The bindpoint mapping data to match reflection.

Type: ShaderBindpointMapping

programResourceId¶: The ResourceId of the program bound to this stage.

reflection¶

The reflection data for this shader.

Type: ShaderReflection

shaderResourceId¶: The ResourceId of the shader object itself.

stage¶: A ShaderStage identifying which stage this shader is bound to.

subroutines¶

A list of integers with the subroutine values.

Type: List[int]

Fixed Vertex Processing ¶

class renderdoc.GLFixedVertexProcessing¶

Describes the setup for fixed vertex processing operations.

clipNegativeOneToOne¶

True if the clip-space Z goes from -1 to 1.

False if the clip-space Z goes from 0 to 1.

clipOriginLowerLeft¶

True if the clipping origin should be in the lower left.

False if it’s in the upper left.

clipPlanes¶

An 8-tuple of bool determining which user clipping planes are enabled.

Type: Tuple[bool,…]

defaultInnerLevel¶

A tuple of float giving the default inner level of tessellation.

Type: Tuple[float,float]

defaultOuterLevel¶

A tuple of float giving the default outer level of tessellation.

Type: Tuple[float,float,float,float]

discard¶: True if primitives should be discarded during rasterization.

Shader Bindings ¶

class renderdoc.GLTexture¶

Describes the details of a texture.

completeStatus¶: The details of the texture’s (in)completeness. If this string is empty, the texture is complete. Otherwise it contains an explanation of why the texture is believed to be incomplete.

depthReadChannel¶

The channel to read from in a depth-stencil texture.

-1 for non depth-stencil textures.

0 if depth should be read.

1 if stencil should be read.

firstMip¶: Valid for textures - the first mip that is available.

numMips¶: Valid for textures - the number of mips that are available.

resourceId¶: The ResourceId of the underlying resource the view refers to.

swizzle¶

The swizzle applied to a texture.

Type: TextureSwizzle4

type¶: The TextureType of the texture.

typeConflict¶

The details of any type conflict on this binding. This can happen if multiple uniforms are pointing to the same binding but with different types. In this case it is impossible to disambiguate which binding was used.

If this string is empty, no conflict is present. Otherwise it contains the bindings which are in conflict and their types.

class renderdoc.GLSampler¶

Describes the sampler properties of a texture.

UseBorder()¶

Check if the border color is used in this OpenGL sampler.

Returns: True if the border color is used, False otherwise.
Return type: bool

addressR¶: The AddressMode in the R direction.

addressS¶: The AddressMode in the S direction.

addressT¶: The AddressMode in the T direction.

borderColor¶

The RGBA border color.

Type: Tuple[float,float,float,float]

compareFunction¶: The CompareFunction for comparison samplers.

filter¶

The filtering mode.

Type: TextureFilter

maxAnisotropy¶: The maximum anisotropic filtering level to use.

maxLOD¶: The maximum mip level that can be used.

minLOD¶: The minimum mip level that can be used.

mipLODBias¶: A bias to apply to the calculated mip level before sampling.

resourceId¶: The ResourceId of the sampler object, if a separate one is set.

seamlessCubeMap¶: True if seamless cubemap filtering is enabled for this texture.

class renderdoc.GLBuffer¶

Describes the properties of a buffer.

byteOffset¶: The byte offset from the start of the buffer.

byteSize¶: The byte size of the buffer.

resourceId¶: The ResourceId of the buffer object.

class renderdoc.GLImageLoadStore¶

Describes the properties of a load/store image.

imageFormat¶

The format that the image is bound as.

Type: ResourceFormat

layered¶: True if multiple layers are bound together to the image. False if only one layer is bound.

mipLevel¶: The mip of the texture that’s used in the attachment.

readAllowed¶: True if loading from the image is allowed.

resourceId¶: The ResourceId of the texture object.

slice¶: The slice of the texture that’s used in the attachment.

type¶: The TextureType of the texture.

writeAllowed¶: True if storing to the image is allowed.

Transform Feedback ¶

class renderdoc.GLFeedback¶

Describes the current feedback state.

active¶: True if the transform feedback object is currently active.

bufferResourceId¶

The buffer bindings.

Type: Tuple[ResourceId,ResourceId,ResourceId,ResourceId]

byteOffset¶

The buffer byte offsets.

Type: Tuple[int,int,int,int]

byteSize¶

The buffer byte sizes.

Type: Tuple[int,int,int,int]

feedbackResourceId¶: The ResourceId of the transform feedback binding.

paused¶: True if the transform feedback object is currently paused.

Rasterizer ¶

class renderdoc.GLRasterizer¶

Describes the rasterization state of the OpenGL pipeline.

scissors¶

The bound scissor regions.

Type: List[Scissor]

state¶

The details of the rasterization state.

Type: GLRasterizerState

viewports¶

The bound viewports.

Type: List[Viewport]

class renderdoc.GLRasterizerState¶

Describes the rasterizer state toggles.

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

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

cullMode¶: The polygon CullMode.

depthBias¶: The fixed depth bias value to apply to z-values.

depthClamp¶: True if pixels outside of the near and far depth planes should be clamped and to 0.0 to 1.0 and not clipped.

fillMode¶: The polygon FillMode.

frontCCW¶: True if counter-clockwise polygons are front-facing. False if clockwise polygons are front-facing.

lineWidth¶: The fixed line width in pixels.

minSampleShadingRate¶: The minimum sample shading rate.

multisampleEnable¶: True if multisampling should be used during rendering.

offsetClamp¶: The clamp value for calculated depth bias from depthBias and slopeScaledDepthBias

pointFadeThreshold¶: The threshold value at which points are clipped if they exceed this size.

pointOriginUpperLeft¶: True if the point sprite texture origin is upper-left. False if lower-left.

pointSize¶: The fixed point size in pixels.

programmablePointSize¶: True if the point size can be programmably exported from a shader.

sampleCoverage¶: True if a temporary mask using sampleCoverageValue should be used to resolve the final output color.

sampleCoverageInvert¶: True if the temporary sample coverage mask should be inverted.

sampleCoverageValue¶: The sample coverage value used if sampleCoverage is True.

sampleMask¶: True if the generated samples should be bitwise AND masked with sampleMaskValue.

sampleMaskValue¶: The sample mask value that should be masked against the generated coverage.

sampleShading¶: True if rendering should happen at sample-rate frequency.

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

Depth/Stencil State ¶

class renderdoc.GLDepthState¶

Describes the depth state.

depthBounds¶: True if depth bounds tests should be applied.

depthEnable¶: True if depth testing should be performed.

depthFunction¶: The CompareFunction to use for testing depth values.

depthWrites¶: True if depth values should be written to the depth target.

farBound¶: The far plane bounding value.

nearBound¶: The near plane bounding value.

class renderdoc.GLStencilState¶

Describes the stencil state.

backFace¶

The stencil state for back-facing polygons.

Type: StencilFace

frontFace¶

The stencil state for front-facing polygons.

Type: StencilFace

stencilEnable¶: True if stencil operations should be performed.

Framebuffer ¶

class renderdoc.GLFrameBuffer¶

Describes the current state of the framebuffer stage of the pipeline.

blendState¶

The details of the blending state.

Type: GLBlendState

dither¶: True if dithering should be used when writing to color buffers.

drawFBO¶

The draw framebuffer.

Type: GLFBO

framebufferSRGB¶: True if sRGB correction should be applied when writing to an sRGB-formatted texture.

readFBO¶

The read framebuffer.

Type: GLFBO

class renderdoc.GLFBO¶

Describes the contents of a framebuffer object.

colorAttachments¶

The framebuffer color attachments.

Type: List[GLAttachment]

depthAttachment¶

The framebuffer depth attachment.

Type: GLAttachment

drawBuffers¶

The draw buffer indices into the colorAttachments attachment list.

Type: List[int]

readBuffer¶: The read buffer index in the colorAttachments attachment list.

resourceId¶: The ResourceId of the framebuffer.

stencilAttachment¶

The framebuffer stencil attachment.

Type: GLAttachment

class renderdoc.GLAttachment¶

Describes the state of a framebuffer attachment.

mipLevel¶: The mip of the texture that’s used in the attachment.

numSlices¶: The number of slices of the texture that are used in the attachment.

resourceId¶: The ResourceId of the texture bound to this attachment.

slice¶: The slice of the texture that’s used in the attachment.

swizzle¶

The swizzle applied to the texture.

Type: TextureSwizzle4

Blending ¶

class renderdoc.GLBlendState¶

Describes the blend pipeline state.

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]

Hints ¶

class renderdoc.GLHints¶

Describes the current state of GL hints and smoothing.

derivatives¶: A QualityHint with the derivatives hint.

lineSmoothing¶: A QualityHint with the line smoothing hint.

lineSmoothingEnabled¶: True if line smoothing is enabled.

polySmoothing¶: A QualityHint with the polygon smoothing hint.

polySmoothingEnabled¶: True if polygon smoothing is enabled.

textureCompression¶: A QualityHint with the texture compression hint.

class renderdoc.QualityHint(value)¶

An API specific hint for a certain behaviour. A legacy concept in OpenGL that controls hints to the implementation where there is room for interpretation within the range of valid behaviour.

DontCare¶: The hinted behaviour can follow any valid path as the implementation decides.

Nicest¶: The hinted behaviour should follow the most correct or highest quality path.

Fastest¶: The hinted behaviour should follow the most efficient path.