All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
graphicsCmds.h
1 //
2 // Copyright 2019 Pixar
3 //
4 // Licensed under the Apache License, Version 2.0 (the "Apache License")
5 // with the following modification; you may not use this file except in
6 // compliance with the Apache License and the following modification to it:
7 // Section 6. Trademarks. is deleted and replaced with:
8 //
9 // 6. Trademarks. This License does not grant permission to use the trade
10 // names, trademarks, service marks, or product names of the Licensor
11 // and its affiliates, except as required to comply with Section 4(c) of
12 // the License and to reproduce the content of the NOTICE file.
13 //
14 // You may obtain a copy of the Apache License at
15 //
16 // http://www.apache.org/licenses/LICENSE-2.0
17 //
18 // Unless required by applicable law or agreed to in writing, software
19 // distributed under the Apache License with the above modification is
20 // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21 // KIND, either express or implied. See the Apache License for the specific
22 // language governing permissions and limitations under the Apache License.
23 //
24 #ifndef PXR_IMAGING_HGI_GL_GRAPHICS_CMDS_H
25 #define PXR_IMAGING_HGI_GL_GRAPHICS_CMDS_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/base/gf/vec4i.h"
29 #include "pxr/imaging/hgi/graphicsCmds.h"
30 #include "pxr/imaging/hgiGL/api.h"
31 #include "pxr/imaging/hgiGL/hgi.h"
32 #include <cstdint>
33 
34 PXR_NAMESPACE_OPEN_SCOPE
35 
36 struct HgiGraphicsCmdsDesc;
37 class HgiGLDevice;
38 
43 class HgiGLGraphicsCmds final : public HgiGraphicsCmds
44 {
45 public:
46  HGIGL_API
47  ~HgiGLGraphicsCmds() override;
48 
54  HGIGL_API
55  void InsertFunctionOp(std::function<void(void)> const& fn);
56 
57  HGIGL_API
58  void PushDebugGroup(const char* label) override;
59 
60  HGIGL_API
61  void PopDebugGroup() override;
62 
63  HGIGL_API
64  void SetViewport(GfVec4i const& vp) override;
65 
66  HGIGL_API
67  void SetScissor(GfVec4i const& sc) override;
68 
69  HGIGL_API
70  void BindPipeline(HgiGraphicsPipelineHandle pipeline) override;
71 
72  HGIGL_API
73  void BindResources(HgiResourceBindingsHandle resources) override;
74 
75  HGIGL_API
76  void SetConstantValues(
78  HgiShaderStage stages,
79  uint32_t bindIndex,
80  uint32_t byteSize,
81  const void* data) override;
82 
83  HGIGL_API
84  void BindVertexBuffers(
85  uint32_t firstBinding,
86  HgiBufferHandleVector const& buffers,
87  std::vector<uint32_t> const& byteOffsets) override;
88 
89  HGIGL_API
90  void Draw(
91  uint32_t vertexCount,
92  uint32_t firstVertex,
93  uint32_t instanceCount) override;
94 
95  HGIGL_API
96  void DrawIndirect(
97  HgiBufferHandle const& drawParameterBuffer,
98  uint32_t drawBufferOffset,
99  uint32_t drawCount,
100  uint32_t stride) override;
101 
102  HGIGL_API
103  void DrawIndexed(
104  HgiBufferHandle const& indexBuffer,
105  uint32_t indexCount,
106  uint32_t indexBufferByteOffset,
107  uint32_t vertexOffset,
108  uint32_t instanceCount) override;
109 
110  HGIGL_API
111  void DrawIndexedIndirect(
112  HgiBufferHandle const& indexBuffer,
113  HgiBufferHandle const& drawParameterBuffer,
114  uint32_t drawBufferOffset,
115  uint32_t drawCount,
116  uint32_t stride) override;
117 
118  HGIGL_API
119  void MemoryBarrier(HgiMemoryBarrier barrier) override;
120 
121 protected:
122  friend class HgiGL;
123 
124  HGIGL_API
126  HgiGLDevice* device,
127  HgiGraphicsCmdsDesc const& desc);
128 
129  HGIGL_API
130  bool _Submit(Hgi* hgi, HgiSubmitWaitType wait) override;
131 
132 private:
133  HgiGLGraphicsCmds() = delete;
134  HgiGLGraphicsCmds & operator=(const HgiGLGraphicsCmds&) = delete;
135  HgiGLGraphicsCmds(const HgiGLGraphicsCmds&) = delete;
136 
138  void _AddResolveToOps(HgiGLDevice* device);
139 
140  bool _recording;
141  HgiGraphicsCmdsDesc _descriptor;
142  HgiPrimitiveType _primitiveType;
143  HgiGLOpsVector _ops;
144  int _pushStack;
145 
146  // Cmds is used only one frame so storing multi-frame state on will not
147  // survive.
148 };
149 
150 PXR_NAMESPACE_CLOSE_SCOPE
151 
152 #endif
Basic type for a vector of 4 int components.
Definition: vec4i.h:61
HGIGL_API void SetConstantValues(HgiGraphicsPipelineHandle pipeline, HgiShaderStage stages, uint32_t bindIndex, uint32_t byteSize, const void *data) override
Set Push / Function constants.
HGIGL_API void DrawIndirect(HgiBufferHandle const &drawParameterBuffer, uint32_t drawBufferOffset, uint32_t drawCount, uint32_t stride) override
Records a multi-draw command that reads the draw parameters from a provided drawParameterBuffer.
A graphics API independent abstraction of graphics commands.
Definition: graphicsCmds.h:47
HGIGL_API void MemoryBarrier(HgiMemoryBarrier barrier) override
Inserts a barrier so that data written to memory by commands before the barrier is available to comma...
HGIGL_API void BindResources(HgiResourceBindingsHandle resources) override
Bind resources such as textures and uniform buffers.
HGIGL_API void InsertFunctionOp(std::function< void(void)> const &fn)
XXX This function is exposed temporarily for Hgi transition.
HGIGL_API void Draw(uint32_t vertexCount, uint32_t firstVertex, uint32_t instanceCount) override
Records a draw command that renders one or more instances of primitives using the number of vertices ...
HGIGL_API void DrawIndexedIndirect(HgiBufferHandle const &indexBuffer, HgiBufferHandle const &drawParameterBuffer, uint32_t drawBufferOffset, uint32_t drawCount, uint32_t stride) override
Records a indexed multi-draw command that reads the draw parameters from a provided drawParameterBuff...
HGIGL_API void SetScissor(GfVec4i const &sc) override
Only pixels that lie within the scissor box are modified by drawing commands.
OpenGL implementation of HgiGraphicsCmds.
Definition: graphicsCmds.h:43
HGIGL_API void DrawIndexed(HgiBufferHandle const &indexBuffer, uint32_t indexCount, uint32_t indexBufferByteOffset, uint32_t vertexOffset, uint32_t instanceCount) override
Records a draw command that renders one or more instances of primitives using an indexBuffer starting...
OpenGL implementation of the Hydra Graphics Interface.
Definition: hgi.h:53
HGIGL_API void PushDebugGroup(const char *label) override
Push a debug marker.
HGIGL_API void BindVertexBuffers(uint32_t firstBinding, HgiBufferHandleVector const &buffers, std::vector< uint32_t > const &byteOffsets) override
Binds the vertex buffer(s) that describe the vertex attributes.
HGIGL_API void BindPipeline(HgiGraphicsPipelineHandle pipeline) override
Bind a pipeline state object.
Describes the properties to begin a HgiGraphicsCmds.
Hydra Graphics Interface.
Definition: hgi.h:106
HGIGL_API void PopDebugGroup() override
Pop the last debug marker.
HGIGL_API void SetViewport(GfVec4i const &vp) override
Set viewport [left, BOTTOM, width, height] - OpenGL coords.