src/third_party/angle/src/libGLESv2/renderer/Renderer.h

   1 //
   2 // Copyright (c) 2012-2014 The ANGLE Project Authors. All rights reserved.
   3 // Use of this source code is governed by a BSD-style license that can be
   4 // found in the LICENSE file.
   5 //
   6
   7 // Renderer.h: Defines a back-end specific class that hides the details of the
   8 // implementation-specific renderer.
   9
  10 #ifndef LIBGLESV2_RENDERER_RENDERER_H_
  11 #define LIBGLESV2_RENDERER_RENDERER_H_
  12
  13 #include "libGLESv2/Uniform.h"
  14 #include "libGLESv2/angletypes.h"
  15
  16 #if !defined(ANGLE_COMPILE_OPTIMIZATION_LEVEL)
  17 // WARNING: D3DCOMPILE_OPTIMIZATION_LEVEL3 may lead to a DX9 shader compiler hang.
  18 // It should only be used selectively to work around specific bugs.
  19 #define ANGLE_COMPILE_OPTIMIZATION_LEVEL D3DCOMPILE_OPTIMIZATION_LEVEL1
  20 #endif
  21
  22 namespace egl
  23 {
  24 class Display;
  25 }
  26
  27 namespace gl
  28 {
  29 class InfoLog;
  30 class ProgramBinary;
  31 struct LinkedVarying;
  32 class VertexAttribute;
  33 class Buffer;
  34 class Texture;
  35 class Framebuffer;
  36 struct VertexAttribCurrentValueData;
  37 }
  38
  39 namespace rx
  40 {
  41 class TextureStorageInterface2D;
  42 class TextureStorageInterfaceCube;
  43 class TextureStorageInterface3D;
  44 class TextureStorageInterface2DArray;
  45 class VertexBuffer;
  46 class IndexBuffer;
  47 class QueryImpl;
  48 class FenceImpl;
  49 class BufferStorage;
  50 struct TranslatedIndexData;
  51 class ShaderExecutable;
  52 class SwapChain;
  53 class RenderTarget;
  54 class Image;
  55 class TextureStorage;
  56 class UniformStorage;
  57
  58 struct ConfigDesc
  59 {
  60     GLenum  renderTargetFormat;
  61     GLenum  depthStencilFormat;
  62     GLint   multiSample;
  63     bool    fastConfig;
  64     bool    es3Capable;
  65 };
  66
  67 struct dx_VertexConstants
  68 {
  69     float depthRange[4];
  70     float viewAdjust[4];
  71 };
  72
  73 struct dx_PixelConstants
  74 {
  75     float depthRange[4];
  76     float viewCoords[4];
  77     float depthFront[4];
  78 };
  79
  80 enum ShaderType
  81 {
  82     SHADER_VERTEX,
  83     SHADER_PIXEL,
  84     SHADER_GEOMETRY
  85 };
  86
  87 class Renderer
  88 {
  89   public:
  90     explicit Renderer(egl::Display *display);
  91     virtual ~Renderer();
  92
  93     virtual EGLint initialize() = 0;
  94     virtual bool resetDevice() = 0;
  95
  96     virtual int generateConfigs(ConfigDesc **configDescList) = 0;
  97     virtual void deleteConfigs(ConfigDesc *configDescList) = 0;
  98
  99     virtual void sync(bool block) = 0;
 100
 101     virtual SwapChain *createSwapChain(HWND window, HANDLE shareHandle, GLenum backBufferFormat, GLenum depthBufferFormat) = 0;
 102
 103     virtual void generateSwizzle(gl::Texture *texture) = 0;
 104     virtual void setSamplerState(gl::SamplerType type, int index, const gl::SamplerState &sampler) = 0;
 105     virtual void setTexture(gl::SamplerType type, int index, gl::Texture *texture) = 0;
 106
 107     virtual bool setUniformBuffers(const gl::Buffer *vertexUniformBuffers[], const gl::Buffer *fragmentUniformBuffers[]) = 0;
 108
 109     virtual void setRasterizerState(const gl::RasterizerState &rasterState) = 0;
 110     virtual void setBlendState(gl::Framebuffer *framebuffer, const gl::BlendState &blendState, const gl::ColorF &blendColor,
 111                                unsigned int sampleMask) = 0;
 112     virtual void setDepthStencilState(const gl::DepthStencilState &depthStencilState, int stencilRef,
 113                                       int stencilBackRef, bool frontFaceCCW) = 0;
 114
 115     virtual void setScissorRectangle(const gl::Rectangle &scissor, bool enabled) = 0;
 116     virtual bool setViewport(const gl::Rectangle &viewport, float zNear, float zFar, GLenum drawMode, GLenum frontFace,
 117                              bool ignoreViewport) = 0;
 118
 119     virtual bool applyRenderTarget(gl::Framebuffer *frameBuffer) = 0;
 120     virtual void applyShaders(gl::ProgramBinary *programBinary, bool rasterizerDiscard, bool transformFeedbackActive, const gl::VertexFormat inputLayout[]) = 0;
 121     virtual void applyUniforms(const gl::ProgramBinary &programBinary) = 0;
 122     virtual bool applyPrimitiveType(GLenum primitiveType, GLsizei elementCount) = 0;
 123     virtual GLenum applyVertexBuffer(gl::ProgramBinary *programBinary, const gl::VertexAttribute vertexAttributes[], gl::VertexAttribCurrentValueData currentValues[],
 124                                      GLint first, GLsizei count, GLsizei instances) = 0;
 125     virtual GLenum applyIndexBuffer(const GLvoid *indices, gl::Buffer *elementArrayBuffer, GLsizei count, GLenum mode, GLenum type, TranslatedIndexData *indexInfo) = 0;
 126     virtual void applyTransformFeedbackBuffers(gl::Buffer *transformFeedbackBuffers[], GLintptr offsets[]) = 0;
 127
 128     virtual void drawArrays(GLenum mode, GLsizei count, GLsizei instances, bool transformFeedbackActive) = 0;
 129     virtual void drawElements(GLenum mode, GLsizei count, GLenum type, const GLvoid *indices,
 130                               gl::Buffer *elementArrayBuffer, const TranslatedIndexData &indexInfo, GLsizei instances) = 0;
 131
 132     virtual void clear(const gl::ClearParameters &clearParams, gl::Framebuffer *frameBuffer) = 0;
 133
 134     virtual void markAllStateDirty() = 0;
 135
 136     // lost device
 137     virtual void notifyDeviceLost() = 0;
 138     virtual bool isDeviceLost() = 0;
 139     virtual bool testDeviceLost(bool notify) = 0;
 140     virtual bool testDeviceResettable() = 0;
 141
 142     // Renderer capabilities
 143     virtual DWORD getAdapterVendor() const = 0;
 144     virtual std::string getRendererDescription() const = 0;
 145     virtual GUID getAdapterIdentifier() const = 0;
 146
 147     virtual bool getBGRATextureSupport() const = 0;
 148     virtual bool getDXT1TextureSupport() const = 0;
 149     virtual bool getDXT3TextureSupport() const = 0;
 150     virtual bool getDXT5TextureSupport() const = 0;
 151     virtual bool getEventQuerySupport() const = 0;
 152     virtual bool getFloat32TextureSupport() const = 0;
 153     virtual bool getFloat32TextureFilteringSupport() const= 0;
 154     virtual bool getFloat32TextureRenderingSupport() const= 0;
 155     virtual bool getFloat16TextureSupport()  const= 0;
 156     virtual bool getFloat16TextureFilteringSupport() const= 0;
 157     virtual bool getFloat16TextureRenderingSupport() const = 0;
 158     virtual bool getRGB565TextureSupport() const = 0;
 159     virtual bool getLuminanceTextureSupport() const = 0;
 160     virtual bool getLuminanceAlphaTextureSupport() const = 0;
 161     virtual bool getRGTextureSupport() const = 0;
 162     bool getVertexTextureSupport() const { return getMaxVertexTextureImageUnits() > 0; }
 163     virtual unsigned int getMaxVertexTextureImageUnits() const = 0;
 164     virtual unsigned int getMaxCombinedTextureImageUnits() const = 0;
 165     virtual unsigned int getReservedVertexUniformVectors() const = 0;
 166     virtual unsigned int getReservedFragmentUniformVectors() const = 0;
 167     virtual unsigned int getMaxVertexUniformVectors() const = 0;
 168     virtual unsigned int getMaxFragmentUniformVectors() const = 0;
 169     virtual unsigned int getMaxVaryingVectors() const = 0;
 170     virtual unsigned int getMaxVertexShaderUniformBuffers() const = 0;
 171     virtual unsigned int getMaxFragmentShaderUniformBuffers() const = 0;
 172     virtual unsigned int getReservedVertexUniformBuffers() const = 0;
 173     virtual unsigned int getReservedFragmentUniformBuffers() const = 0;
 174     virtual unsigned int getMaxTransformFeedbackBuffers() const = 0;
 175     virtual unsigned int getMaxTransformFeedbackSeparateComponents() const = 0;
 176     virtual unsigned int getMaxTransformFeedbackInterleavedComponents() const = 0;
 177     virtual unsigned int getMaxUniformBufferSize() const = 0;
 178     virtual bool getNonPower2TextureSupport() const = 0;
 179     virtual bool getDepthTextureSupport() const = 0;
 180     virtual bool getOcclusionQuerySupport() const = 0;
 181     virtual bool getInstancingSupport() const = 0;
 182     virtual bool getTextureFilterAnisotropySupport() const = 0;
 183     virtual bool getPBOSupport() const = 0;
 184     virtual float getTextureMaxAnisotropy() const = 0;
 185     virtual bool getShareHandleSupport() const = 0;
 186     virtual bool getDerivativeInstructionSupport() const = 0;
 187     virtual bool getPostSubBufferSupport() const = 0;
 188     virtual int getMaxRecommendedElementsIndices() const = 0;
 189     virtual int getMaxRecommendedElementsVertices() const = 0;
 190
 191     virtual int getMajorShaderModel() const = 0;
 192     virtual float getMaxPointSize() const = 0;
 193     virtual int getMaxViewportDimension() const = 0;
 194     virtual int getMaxTextureWidth() const = 0;
 195     virtual int getMaxTextureHeight() const = 0;
 196     virtual int getMaxTextureDepth() const = 0;
 197     virtual int getMaxTextureArrayLayers() const = 0;
 198     virtual bool get32BitIndexSupport() const = 0;
 199     virtual int getMinSwapInterval() const = 0;
 200     virtual int getMaxSwapInterval() const = 0;
 201
 202     virtual GLsizei getMaxSupportedSamples() const = 0;
 203     virtual GLsizei getMaxSupportedFormatSamples(GLenum internalFormat) const = 0;
 204     virtual GLsizei getNumSampleCounts(GLenum internalFormat) const = 0;
 205     virtual void getSampleCounts(GLenum internalFormat, GLsizei bufSize, GLint *params) const = 0;
 206
 207     virtual unsigned int getMaxRenderTargets() const = 0;
 208
 209     // Pixel operations
 210     virtual bool copyToRenderTarget(TextureStorageInterface2D *dest, TextureStorageInterface2D *source) = 0;
 211     virtual bool copyToRenderTarget(TextureStorageInterfaceCube *dest, TextureStorageInterfaceCube *source) = 0;
 212     virtual bool copyToRenderTarget(TextureStorageInterface3D *dest, TextureStorageInterface3D *source) = 0;
 213     virtual bool copyToRenderTarget(TextureStorageInterface2DArray *dest, TextureStorageInterface2DArray *source) = 0;
 214
 215     virtual bool copyImage(gl::Framebuffer *framebuffer, const gl::Rectangle &sourceRect, GLenum destFormat,
 216                            GLint xoffset, GLint yoffset, TextureStorageInterface2D *storage, GLint level) = 0;
 217     virtual bool copyImage(gl::Framebuffer *framebuffer, const gl::Rectangle &sourceRect, GLenum destFormat,
 218                            GLint xoffset, GLint yoffset, TextureStorageInterfaceCube *storage, GLenum target, GLint level) = 0;
 219     virtual bool copyImage(gl::Framebuffer *framebuffer, const gl::Rectangle &sourceRect, GLenum destFormat,
 220                            GLint xoffset, GLint yoffset, GLint zOffset, TextureStorageInterface3D *storage, GLint level) = 0;
 221     virtual bool copyImage(gl::Framebuffer *framebuffer, const gl::Rectangle &sourceRect, GLenum destFormat,
 222                            GLint xoffset, GLint yoffset, GLint zOffset, TextureStorageInterface2DArray *storage, GLint level) = 0;
 223
 224     virtual bool blitRect(gl::Framebuffer *readTarget, const gl::Rectangle &readRect, gl::Framebuffer *drawTarget, const gl::Rectangle &drawRect,
 225                           const gl::Rectangle *scissor, bool blitRenderTarget, bool blitDepth, bool blitStencil, GLenum filter) = 0;
 226     virtual void readPixels(gl::Framebuffer *framebuffer, GLint x, GLint y, GLsizei width, GLsizei height, GLenum format,
 227                             GLenum type, GLuint outputPitch, const gl::PixelPackState &pack, void* pixels) = 0;
 228
 229     // RenderTarget creation
 230     virtual RenderTarget *createRenderTarget(SwapChain *swapChain, bool depth) = 0;
 231     virtual RenderTarget *createRenderTarget(int width, int height, GLenum format, GLsizei samples) = 0;
 232
 233     // Shader operations
 234     virtual ShaderExecutable *loadExecutable(const void *function, size_t length, rx::ShaderType type,
 235                                              const std::vector<gl::LinkedVarying> &transformFeedbackVaryings,
 236                                              bool separatedOutputBuffers) = 0;
 237     virtual ShaderExecutable *compileToExecutable(gl::InfoLog &infoLog, const char *shaderHLSL, rx::ShaderType type,
 238                                                   const std::vector<gl::LinkedVarying> &transformFeedbackVaryings,
 239                                                   bool separatedOutputBuffers, D3DWorkaroundType workaround) = 0;
 240     virtual UniformStorage *createUniformStorage(size_t storageSize) = 0;
 241
 242     // Image operations
 243     virtual Image *createImage() = 0;
 244     virtual void generateMipmap(Image *dest, Image *source) = 0;
 245     virtual TextureStorage *createTextureStorage2D(SwapChain *swapChain) = 0;
 246     virtual TextureStorage *createTextureStorage2D(GLenum internalformat, bool renderTarget, GLsizei width, GLsizei height, int levels) = 0;
 247     virtual TextureStorage *createTextureStorageCube(GLenum internalformat, bool renderTarget, int size, int levels) = 0;
 248     virtual TextureStorage *createTextureStorage3D(GLenum internalformat, bool renderTarget, GLsizei width, GLsizei height, GLsizei depth, int levels) = 0;
 249     virtual TextureStorage *createTextureStorage2DArray(GLenum internalformat, bool renderTarget, GLsizei width, GLsizei height, GLsizei depth, int levels) = 0;
 250
 251     // Buffer creation
 252     virtual VertexBuffer *createVertexBuffer() = 0;
 253     virtual IndexBuffer *createIndexBuffer() = 0;
 254     virtual BufferStorage *createBufferStorage() = 0;
 255
 256     // Query and Fence creation
 257     virtual QueryImpl *createQuery(GLenum type) = 0;
 258     virtual FenceImpl *createFence() = 0;
 259
 260     // Current GLES client version
 261     void setCurrentClientVersion(int clientVersion) { mCurrentClientVersion = clientVersion; }
 262     int getCurrentClientVersion() const { return mCurrentClientVersion; }
 263
 264     // Buffer-to-texture and Texture-to-buffer copies
 265     virtual bool supportsFastCopyBufferToTexture(GLenum internalFormat) const = 0;
 266     virtual bool fastCopyBufferToTexture(const gl::PixelUnpackState &unpack, unsigned int offset, RenderTarget *destRenderTarget,
 267                                          GLenum destinationFormat, GLenum sourcePixelsType, const gl::Box &destArea) = 0;
 268
 269     virtual bool getLUID(LUID *adapterLuid) const = 0;
 270     virtual GLenum getNativeTextureFormat(GLenum internalFormat) const = 0;
 271     virtual rx::VertexConversionType getVertexConversionType(const gl::VertexFormat &vertexFormat) const = 0;
 272     virtual GLenum getVertexComponentType(const gl::VertexFormat &vertexFormat) const = 0;
 273
 274   protected:
 275     egl::Display *mDisplay;
 276
 277   private:
 278     DISALLOW_COPY_AND_ASSIGN(Renderer);
 279
 280     int mCurrentClientVersion;
 281 };
 282
 283 }
 284 #endif // LIBGLESV2_RENDERER_RENDERER_H_