HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HgiGraphicsCmds Class Referenceabstract

#include <graphicsCmds.h>

+ Inheritance diagram for HgiGraphicsCmds:

Public Member Functions

HGI_API ~HgiGraphicsCmds () override
 
virtual HGI_API void PushDebugGroup (const char *label)=0
 Push a debug marker. More...
 
virtual HGI_API void PopDebugGroup ()=0
 Pop the last debug marker. More...
 
virtual HGI_API void SetViewport (GfVec4i const &vp)=0
 Set viewport [left, BOTTOM, width, height] - OpenGL coords. More...
 
virtual HGI_API void SetScissor (GfVec4i const &sc)=0
 
virtual HGI_API void BindPipeline (HgiGraphicsPipelineHandle pipeline)=0
 
virtual HGI_API void BindResources (HgiResourceBindingsHandle resources)=0
 
virtual HGI_API void SetConstantValues (HgiGraphicsPipelineHandle pipeline, HgiShaderStage stages, uint32_t bindIndex, uint32_t byteSize, const void *data)=0
 
virtual HGI_API void BindVertexBuffers (uint32_t firstBinding, HgiBufferHandleVector const &buffers, std::vector< uint32_t > const &byteOffsets)=0
 
virtual HGI_API void DrawIndexed (HgiBufferHandle const &indexBuffer, uint32_t indexCount, uint32_t indexBufferByteOffset, uint32_t firstIndex, uint32_t vertexOffset, uint32_t instanceCount)=0
 
- Public Member Functions inherited from HgiCmds
virtual HGI_API ~HgiCmds ()
 

Protected Member Functions

HGI_API HgiGraphicsCmds ()
 
- Protected Member Functions inherited from HgiCmds
HGI_API HgiCmds ()
 
virtual HGI_API bool _Submit (Hgi *hgi)
 

Detailed Description

A graphics API independent abstraction of graphics commands. HgiGraphicsCmds is a lightweight object that cannot be re-used after it has been submitted. A new cmds object should be acquired for each frame.

Definition at line 47 of file graphicsCmds.h.

Constructor & Destructor Documentation

HGI_API HgiGraphicsCmds::~HgiGraphicsCmds ( )
override
HGI_API HgiGraphicsCmds::HgiGraphicsCmds ( )
protected

Member Function Documentation

virtual HGI_API void HgiGraphicsCmds::BindPipeline ( HgiGraphicsPipelineHandle  pipeline)
pure virtual

Bind a pipeline state object. Usually you call this right after calling CreateGraphicsCmds to set the graphics pipeline state. The resource bindings used when creating the pipeline must be compatible with the resources bound via BindResources().

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::BindResources ( HgiResourceBindingsHandle  resources)
pure virtual

Bind resources such as textures and uniform buffers. Usually you call this right after BindPipeline() and the resources bound must be compatible with the bound pipeline.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::BindVertexBuffers ( uint32_t  firstBinding,
HgiBufferHandleVector const buffers,
std::vector< uint32_t > const byteOffsets 
)
pure virtual

Binds the vertex buffer(s) that describe the vertex attributes. firstBinding the first index to which buffers are bound (usually 0). byteOffsets offset to where the data of each buffer starts, in bytes. strides the size of a vertex in each of the buffers.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::DrawIndexed ( HgiBufferHandle const indexBuffer,
uint32_t  indexCount,
uint32_t  indexBufferByteOffset,
uint32_t  firstIndex,
uint32_t  vertexOffset,
uint32_t  instanceCount 
)
pure virtual

Records a draw command that renders one or more instances of primitives using an indexBuffer starting from the base vertex of the base instance. indexCount is the number of vertices. indexBufferByteOffset: Byte offset within indexBuffer to start reading indices from. vertexOffset: the value added to the vertex index before indexing into the vertex buffer (baseVertex). instanceCount: number of instances (min 1) of the primitves to render.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::PopDebugGroup ( )
pure virtual

Pop the last debug marker.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::PushDebugGroup ( const char *  label)
pure virtual

Push a debug marker.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::SetConstantValues ( HgiGraphicsPipelineHandle  pipeline,
HgiShaderStage  stages,
uint32_t  bindIndex,
uint32_t  byteSize,
const void data 
)
pure virtual

Set Push / Function constants. pipeline is the pipeline that you are binding before the draw call. It contains the program used for the uniform buffer stages describes for what shader stage you are setting the push constant values for. Each stage can have its own (or none) binding and they must match what is described in the shader functions. byteSize is the size of the data you are updating. data is the data you are copying into the push constants block.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::SetScissor ( GfVec4i const sc)
pure virtual

Only pixels that lie within the scissor box are modified by drawing commands.

Implemented in HgiGLGraphicsCmds.

virtual HGI_API void HgiGraphicsCmds::SetViewport ( GfVec4i const vp)
pure virtual

Set viewport [left, BOTTOM, width, height] - OpenGL coords.

Implemented in HgiGLGraphicsCmds.


The documentation for this class was generated from the following file: