OgreShaderProgramProcessor.h
Go to the documentation of this file.
1 /*
2 -----------------------------------------------------------------------------
3 This source file is part of OGRE
4 (Object-oriented Graphics Rendering Engine)
5 For the latest info, see http://www.ogre3d.org
6 
7 Copyright (c) 2000-2013 Torus Knot Software Ltd
8 Permission is hereby granted, free of charge, to any person obtaining a copy
9 of this software and associated documentation files (the "Software"), to deal
10 in the Software without restriction, including without limitation the rights
11 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12 copies of the Software, and to permit persons to whom the Software is
13 furnished to do so, subject to the following conditions:
14 
15 The above copyright notice and this permission notice shall be included in
16 all copies or substantial portions of the Software.
17 
18 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 THE SOFTWARE.
25 -----------------------------------------------------------------------------
26 */
27 #ifndef _ShaderProgramProcessor_
28 #define _ShaderProgramProcessor_
29 
31 #include "OgreShaderParameter.h"
32 #include "OgreShaderFunctionAtom.h"
33 
34 
35 namespace Ogre {
36 namespace RTShader {
37 
50 {
51 
52 // Interface.
53 public:
54 
58 
60  virtual ~ProgramProcessor();
61 
63  virtual const String& getTargetLanguage() const = 0;
64 
70  virtual bool preCreateGpuPrograms(ProgramSet* programSet) = 0;
71 
76  virtual bool postCreateGpuPrograms(ProgramSet* programSet) = 0;
77 
78 // Protected types.
79 protected:
80 
81  //-----------------------------------------------------------------------------
82  // Class that holds merge parameter information.
84  {
85  // Interface.
86  public:
89 
90 
92  void clear();
93 
95  void addSourceParameter(ParameterPtr srcParam, int mask);
96 
98  size_t getSourceParameterCount() const { return mSrcParameterCount; }
99 
101  ParameterPtr getSourceParameter(unsigned int index) { return mSrcParameter[index]; }
102 
104  int getSourceParameterMask(unsigned int index) const { return mSrcParameterMask[index]; }
105 
107  int getDestinationParameterMask(unsigned int index) const { return mDstParameterMask[index]; }
108 
111 
113  ParameterPtr getDestinationParameter(int usage, int index);
114 
115  protected:
116 
118  void createDestinationParameter(int usage, int index);
119 
120 
121  protected:
122  // Destination merged parameter.
124  // Source parameters - 4 source at max 1,1,1,1 -> 4.
125  ParameterPtr mSrcParameter[4];
126  // Source parameters mask. OPM_ALL means all fields used, otherwise it is split source parameter.
127  int mSrcParameterMask[4];
128  // Destination parameters mask. OPM_ALL means all fields used, otherwise it is split source parameter.
129  int mDstParameterMask[4];
130  // The actual source parameters count.
132  // The number of used floats.
134  };
136 
137 
138  //-----------------------------------------------------------------------------
139  // A struct that defines merge parameters combination.
141  {
142  // The count of each source type. I.E (1 FLOAT1, 0 FLOAT2, 1 FLOAT3, 0 FLOAT4).
143  size_t srcParameterTypeCount[4];
144  // Source parameters mask. OPM_ALL means all fields used, otherwise it is split source parameter.
145  int srcParameterMask[4];
146 
148  int float1Count, int float1Mask,
149  int float2Count, int float2Mask,
150  int float3Count, int float3Mask,
151  int float4Count, int float4Mask)
152  {
153  srcParameterTypeCount[0] = float1Count;
154  srcParameterTypeCount[1] = float2Count;
155  srcParameterTypeCount[2] = float3Count;
156  srcParameterTypeCount[3] = float4Count;
157  srcParameterMask[0] = float1Mask;
158  srcParameterMask[1] = float2Mask;
159  srcParameterMask[2] = float3Mask;
160  srcParameterMask[3] = float4Mask;
161 
162  }
163  };
165 
166  //-----------------------------------------------------------------------------
170 
171 protected:
172 
175 
181  virtual bool compactVsOutputs(Function* vsMain, Function* fsMain);
182 
188  void countVsTexcoordOutputs(Function* vsMain, int& outTexCoordSlots, int& outTexCoordFloats);
189 
194  void buildTexcoordTable(const ShaderParameterList& paramList, ShaderParameterList outParamsTable[4]);
195 
196 
201  void mergeParameters(ShaderParameterList paramsTable[4], MergeParameterList& mergedParams, ShaderParameterList& splitParams);
202 
203 
209 
215  bool mergeParametersByCombination(const MergeCombination& combination, ShaderParameterList paramsTable[4],
216  MergeParameter* mergedParameter);
217 
223  void mergeParametersReminders(ShaderParameterList paramsTable[4], MergeParameterList& mergedParams, ShaderParameterList& splitParams);
224 
225 
227  void generateLocalSplitParameters(Function* func, GpuProgramType progType, MergeParameterList& mergedParams, ShaderParameterList& splitParams, LocalParameterMap& localParamsMap);
228 
231  void rebuildParameterList(Function* func, int paramsUsage, MergeParameterList& mergedParams);
232 
235 
238 
241 
244 
247 
250 
252  static int getParameterMaskByFloatCount(int floatCount);
253 
255  void bindAutoParameters(Program* pCpuProgram, GpuProgramPtr pGpuProgram);
256 
257 protected:
258  // Merging combinations defs.
260  // Maximum texcoord slots.
262  // Maximum texcoord floats count.
264  map<Function *, String *>::type mFunctionMap; // Map between function signatures and source code
265 
266 };
267 
268 
272 }
273 }
274 
275 #endif
276 
#define _OgreRTSSExport
Superclass for all objects that wish to use custom memory allocators when their new / delete operator...
A class that represents a shader based program function.
void addSourceParameter(ParameterPtr srcParam, int mask)
Add source parameter to this merged.
ParameterPtr getDestinationParameter(int usage, int index)
Return the destination parameter.
int getSourceParameterMask(unsigned int index) const
Return source parameter mask by index.
int getUsedFloatCount()
Return the number of used floats.
int getDestinationParameterMask(unsigned int index) const
Return destination parameter mask by index.
void clear()
Clear the state of this merge parameter.
ParameterPtr getSourceParameter(unsigned int index)
Return source parameter by index.
size_t getSourceParameterCount() const
Return the source parameter count.
void createDestinationParameter(int usage, int index)
Creates the destination parameter by a given class and index.
A class that provides extra processing services on CPU based programs.
map< Function *, String * >::type mFunctionMap
void buildMergeCombinations()
Build parameter merging combinations.
void rebuildParameterList(Function *func, int paramsUsage, MergeParameterList &mergedParams)
Rebuild the given parameters list using the merged parameters.
ProgramProcessor()
Class constructor.
void rebuildFunctionInvocations(FunctionAtomInstanceList &funcAtomList, MergeParameterList &mergedParams, LocalParameterMap &localParamsMap)
Rebuild function invocations by replacing references to old source parameters with the matching merge...
void countVsTexcoordOutputs(Function *vsMain, int &outTexCoordSlots, int &outTexCoordFloats)
Internal method that counts vertex shader texcoord output slots and output floats.
void mergeParametersReminders(ShaderParameterList paramsTable[4], MergeParameterList &mergedParams, ShaderParameterList &splitParams)
Merge reminders parameters that could not be merged into one slot using the predefined combinations.
void buildParameterReferenceMap(FunctionAtomInstanceList &funcAtomList, ParameterOperandMap &paramsRefMap)
Builds a map between parameter and all the references to it.
vector< MergeCombination >::type MergeCombinationList
void bindAutoParameters(Program *pCpuProgram, GpuProgramPtr pGpuProgram)
Bind the auto parameters for a given CPU and GPU program set.
static int getParameterFloatCount(GpuConstantType type)
Return number of floats needed by the given type.
virtual bool postCreateGpuPrograms(ProgramSet *programSet)=0
Called after creation of the GPU programs.
void buildTexcoordTable(const ShaderParameterList &paramList, ShaderParameterList outParamsTable[4])
Internal function that builds parameters table.
static int getParameterMaskByFloatCount(int floatCount)
Return the parameter mask of by the float count type (I.E: X|Y for 2 etc..)
map< Parameter *, OperandPtrVector >::type ParameterOperandMap
void mergeParameters(ShaderParameterList paramsTable[4], MergeParameterList &mergedParams, ShaderParameterList &splitParams)
Merge the parameters from the given table.
vector< MergeParameter >::type MergeParameterList
virtual ~ProgramProcessor()
Class destructor.
void replaceParametersReferences(MergeParameterList &mergedParams, ParameterOperandMap &paramsRefMap)
Replace references to old parameters with the new merged parameters.
virtual bool compactVsOutputs(Function *vsMain, Function *fsMain)
Compact the vertex shader output registers.
void generateLocalSplitParameters(Function *func, GpuProgramType progType, MergeParameterList &mergedParams, ShaderParameterList &splitParams, LocalParameterMap &localParamsMap)
Generates local parameters for the split parameters and perform packing/unpacking operation using the...
bool mergeParametersByCombination(const MergeCombination &combination, ShaderParameterList paramsTable[4], MergeParameter *mergedParameter)
Internal function that creates merged parameter from given combination.
void mergeParametersByPredefinedCombinations(ShaderParameterList paramsTable[4], MergeParameterList &mergedParams)
Internal function that creates merged parameter using pre defined combinations.
virtual const String & getTargetLanguage() const =0
Return the target language of this processor.
map< Parameter *, ParameterPtr >::type LocalParameterMap
void replaceSplitParametersReferences(LocalParameterMap &localParamsMap, ParameterOperandMap &paramsRefMap)
Replace references to old parameters that have been split with the new local parameters that represen...
virtual bool preCreateGpuPrograms(ProgramSet *programSet)=0
Called before creation of the GPU programs.
static int getParameterMaskByType(GpuConstantType type)
Return the parameter mask of by the given parameter type (I.E: X|Y for FLOAT2 etc....
Container class for shader based programs.
A class that represents a shader based program.
GpuConstantType
Enumeration of the types of constant we may encounter in programs.
vector< FunctionAtom * >::type FunctionAtomInstanceList
vector< ParameterPtr >::type ShaderParameterList
GpuProgramType
Enumerates the types of programs which can run on the GPU.
_StringBase String
MergeCombination(int float1Count, int float1Mask, int float2Count, int float2Mask, int float3Count, int float3Mask, int float4Count, int float4Mask)
std::map< K, V, P, A > type
std::vector< T, A > type

Copyright © 2012 Torus Knot Software Ltd
Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.