1 #ifndef _RRSHADERS_HPP 2 #define _RRSHADERS_HPP 3 /*------------------------------------------------------------------------- 4 * drawElements Quality Program Reference Renderer 5 * ----------------------------------------------- 6 * 7 * Copyright 2014 The Android Open Source Project 8 * 9 * Licensed under the Apache License, Version 2.0 (the "License"); 10 * you may not use this file except in compliance with the License. 11 * You may obtain a copy of the License at 12 * 13 * http://www.apache.org/licenses/LICENSE-2.0 14 * 15 * Unless required by applicable law or agreed to in writing, software 16 * distributed under the License is distributed on an "AS IS" BASIS, 17 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 18 * See the License for the specific language governing permissions and 19 * limitations under the License. 20 * 21 *//*! 22 * \file 23 * \brief Shader interfaces. 24 *//*--------------------------------------------------------------------*/ 25 26 #include "rrDefs.hpp" 27 #include "rrVertexAttrib.hpp" 28 #include "rrVertexPacket.hpp" 29 #include "rrFragmentPacket.hpp" 30 #include "rrPrimitivePacket.hpp" 31 #include "rrShadingContext.hpp" 32 #include "deString.h" 33 34 namespace rr 35 { 36 37 /*--------------------------------------------------------------------*//*! 38 * \brief Vertex shader input information 39 *//*--------------------------------------------------------------------*/ 40 struct VertexInputInfo 41 { 42 VertexInputInfo (void) 43 { 44 // sensible defaults 45 type = GENERICVECTYPE_LAST; 46 } 47 48 GenericVecType type; 49 }; 50 51 /*--------------------------------------------------------------------*//*! 52 * \brief Shader varying information 53 *//*--------------------------------------------------------------------*/ 54 struct VertexVaryingInfo 55 { 56 VertexVaryingInfo (void) 57 { 58 // sensible defaults 59 type = GENERICVECTYPE_LAST; 60 flatshade = false; 61 } 62 63 // \note used by std::vector<T>::operator==() const 64 bool operator== (const VertexVaryingInfo& other) const 65 { 66 return type == other.type && 67 flatshade == other.flatshade; 68 } 69 70 GenericVecType type; 71 bool flatshade; 72 }; 73 74 typedef VertexVaryingInfo VertexOutputInfo; 75 typedef VertexVaryingInfo FragmentInputInfo; 76 typedef VertexVaryingInfo GeometryInputInfo; 77 typedef VertexVaryingInfo GeometryOutputInfo; 78 79 /*--------------------------------------------------------------------*//*! 80 * \brief Fragment shader output information 81 *//*--------------------------------------------------------------------*/ 82 struct FragmentOutputInfo 83 { 84 FragmentOutputInfo (void) 85 { 86 // sensible defaults 87 type = GENERICVECTYPE_LAST; 88 } 89 90 GenericVecType type; 91 }; 92 93 /*--------------------------------------------------------------------*//*! 94 * \brief Vertex shader interface 95 * 96 * Vertex shaders execute shading for set of vertex packets. See VertexPacket 97 * documentation for more details on shading API. 98 *//*--------------------------------------------------------------------*/ 99 class VertexShader 100 { 101 public: 102 VertexShader (size_t numInputs, size_t numOutputs) : m_inputs(numInputs), m_outputs(numOutputs) {} 103 104 virtual void shadeVertices (const VertexAttrib* inputs, VertexPacket* const* packets, const int numPackets) const = 0; 105 106 const std::vector<VertexInputInfo>& getInputs() const { return m_inputs; } 107 const std::vector<VertexOutputInfo>& getOutputs() const { return m_outputs; } 108 109 protected: 110 ~VertexShader() {}; // \note Renderer will not delete any objects passed in. 111 112 std::vector<VertexInputInfo> m_inputs; 113 std::vector<VertexOutputInfo> m_outputs; 114 } DE_WARN_UNUSED_TYPE; 115 116 /*--------------------------------------------------------------------*//*! 117 * \brief Fragment shader interface 118 * 119 * Fragment shader executes shading for list of fragment packets. See 120 * FragmentPacket documentation for more details on shading API. 121 *//*--------------------------------------------------------------------*/ 122 class FragmentShader 123 { 124 public: 125 FragmentShader (size_t numInputs, size_t numOutputs) : m_inputs(numInputs), m_outputs(numOutputs) {} 126 127 const std::vector<FragmentInputInfo>& getInputs() const { return m_inputs; } 128 const std::vector<FragmentOutputInfo>& getOutputs() const { return m_outputs; } 129 130 virtual void shadeFragments (FragmentPacket* packets, const int numPackets, const FragmentShadingContext& context) const = 0; // \note numPackets must be greater than zero. 131 132 protected: 133 ~FragmentShader() {}; // \note Renderer will not delete any objects passed in. 134 135 std::vector<FragmentInputInfo> m_inputs; 136 std::vector<FragmentOutputInfo> m_outputs; 137 } DE_WARN_UNUSED_TYPE; 138 139 /*--------------------------------------------------------------------*//*! 140 * \brief Geometry shader input primitive type 141 *//*--------------------------------------------------------------------*/ 142 enum GeometryShaderInputType 143 { 144 GEOMETRYSHADERINPUTTYPE_POINTS = 0, 145 GEOMETRYSHADERINPUTTYPE_LINES, 146 GEOMETRYSHADERINPUTTYPE_LINES_ADJACENCY, 147 GEOMETRYSHADERINPUTTYPE_TRIANGLES, 148 GEOMETRYSHADERINPUTTYPE_TRIANGLES_ADJACENCY, 149 150 GEOMETRYSHADERINPUTTYPE_LAST 151 }; 152 153 /*--------------------------------------------------------------------*//*! 154 * \brief Geometry shader output primitive type 155 *//*--------------------------------------------------------------------*/ 156 enum GeometryShaderOutputType 157 { 158 GEOMETRYSHADEROUTPUTTYPE_POINTS = 0, 159 GEOMETRYSHADEROUTPUTTYPE_LINE_STRIP, 160 GEOMETRYSHADEROUTPUTTYPE_TRIANGLE_STRIP, 161 162 GEOMETRYSHADEROUTPUTTYPE_LAST 163 }; 164 165 /*--------------------------------------------------------------------*//*! 166 * \brief Geometry shader interface 167 * 168 * Geometry shader executes a list of primitive packets and outputs 169 * a new set of vertex packets for new primitives. 170 *//*--------------------------------------------------------------------*/ 171 class GeometryShader 172 { 173 public: 174 GeometryShader (size_t numVaryingInputs, 175 size_t numVaryingOutputs, 176 GeometryShaderInputType inputType, 177 GeometryShaderOutputType outputType, 178 size_t numVerticesOut, 179 size_t numInvocations); 180 181 virtual void shadePrimitives (GeometryEmitter& output, int verticesIn, const PrimitivePacket* packets, const int numPackets, int invocationID) const = 0; 182 183 const std::vector<GeometryInputInfo>& getInputs (void) const { return m_inputs; } 184 const std::vector<GeometryOutputInfo>& getOutputs (void) const { return m_outputs; } 185 inline GeometryShaderInputType getInputType (void) const { return m_inputType; } 186 inline GeometryShaderOutputType getOutputType (void) const { return m_outputType; } 187 inline size_t getNumVerticesOut (void) const { return m_numVerticesOut; } 188 inline size_t getNumInvocations (void) const { return m_numInvocations; } 189 190 protected: 191 const GeometryShaderInputType m_inputType; 192 const GeometryShaderOutputType m_outputType; 193 const size_t m_numVerticesOut; 194 const size_t m_numInvocations; 195 196 std::vector<GeometryInputInfo> m_inputs; 197 std::vector<GeometryOutputInfo> m_outputs; 198 } DE_WARN_UNUSED_TYPE; 199 200 // Helpers for shader implementations. 201 202 template<class Shader> 203 class VertexShaderLoop : public VertexShader 204 { 205 public: 206 VertexShaderLoop (const Shader& shader) : m_shader(shader) {} 207 208 void shadeVertices (const VertexAttrib* inputs, VertexPacket* packets, const int numPackets) const; 209 210 private: 211 const Shader& m_shader; 212 }; 213 214 template<class Shader> 215 void VertexShaderLoop<Shader>::shadeVertices (const VertexAttrib* inputs, VertexPacket* packets, const int numPackets) const 216 { 217 for (int ndx = 0; ndx < numPackets; ndx++) 218 m_shader.shadeVertex(inputs, packets[ndx]); 219 } 220 221 template<class Shader> 222 class FragmentShaderLoop : public FragmentShader 223 { 224 public: 225 FragmentShaderLoop (const Shader& shader) : m_shader(shader) {} 226 227 void shadeFragments (FragmentPacket* packets, const int numPackets) const; 228 229 private: 230 const Shader& m_shader; 231 }; 232 233 template<class Shader> 234 void FragmentShaderLoop<Shader>::shadeFragments (FragmentPacket* packets, const int numPackets) const 235 { 236 for (int ndx = 0; ndx < numPackets; ndx++) 237 m_shader.shadeFragment(packets[ndx]); 238 } 239 240 } // rr 241 242 #endif // _RRSHADERS_HPP 243
