diff options
author | wolfbeast <mcwerewolf@gmail.com> | 2018-08-05 11:35:53 +0200 |
---|---|---|
committer | wolfbeast <mcwerewolf@gmail.com> | 2018-08-05 11:35:53 +0200 |
commit | 6bd66b1728eeddb058066edda740aaeb2ceaec23 (patch) | |
tree | 985faf01c526763515731569fa01a99f4dbef36e /gfx/angle/include/GLSLANG/ShaderLang.h | |
parent | e0a8dcfed131ffa58a5e2cb1d30fe48c745c2fdc (diff) | |
parent | 559824514dc95e02fbe81f1786e6ac13ee8e9d55 (diff) | |
download | UXP-6bd66b1728eeddb058066edda740aaeb2ceaec23.tar UXP-6bd66b1728eeddb058066edda740aaeb2ceaec23.tar.gz UXP-6bd66b1728eeddb058066edda740aaeb2ceaec23.tar.lz UXP-6bd66b1728eeddb058066edda740aaeb2ceaec23.tar.xz UXP-6bd66b1728eeddb058066edda740aaeb2ceaec23.zip |
Merge branch 'master' into js-modules
Diffstat (limited to 'gfx/angle/include/GLSLANG/ShaderLang.h')
-rwxr-xr-x | gfx/angle/include/GLSLANG/ShaderLang.h | 584 |
1 files changed, 238 insertions, 346 deletions
diff --git a/gfx/angle/include/GLSLANG/ShaderLang.h b/gfx/angle/include/GLSLANG/ShaderLang.h index deead5e43..47c7533e0 100755 --- a/gfx/angle/include/GLSLANG/ShaderLang.h +++ b/gfx/angle/include/GLSLANG/ShaderLang.h @@ -6,6 +6,23 @@ #ifndef GLSLANG_SHADERLANG_H_ #define GLSLANG_SHADERLANG_H_ +#if defined(COMPONENT_BUILD) && !defined(ANGLE_TRANSLATOR_STATIC) +#if defined(_WIN32) || defined(_WIN64) + +#if defined(ANGLE_TRANSLATOR_IMPLEMENTATION) +#define COMPILER_EXPORT __declspec(dllexport) +#else +#define COMPILER_EXPORT __declspec(dllimport) +#endif // defined(ANGLE_TRANSLATOR_IMPLEMENTATION) + +#else // defined(_WIN32) || defined(_WIN64) +#define COMPILER_EXPORT __attribute__((visibility("default"))) +#endif + +#else // defined(COMPONENT_BUILD) && !defined(ANGLE_TRANSLATOR_STATIC) +#define COMPILER_EXPORT +#endif + #include <stddef.h> #include "KHR/khrplatform.h" @@ -32,10 +49,9 @@ typedef unsigned int GLenum; // Version number for shader translation API. // It is incremented every time the API changes. -#define ANGLE_SH_VERSION 167 +#define ANGLE_SH_VERSION 155 -enum ShShaderSpec -{ +typedef enum { SH_GLES2_SPEC, SH_WEBGL_SPEC, @@ -44,9 +60,31 @@ enum ShShaderSpec SH_GLES3_1_SPEC, SH_WEBGL3_SPEC, -}; -enum ShShaderOutput + // The CSS Shaders spec is a subset of the WebGL spec. + // + // In both CSS vertex and fragment shaders, ANGLE: + // (1) Reserves the "css_" prefix. + // (2) Renames the main function to css_main. + // (3) Disables the gl_MaxDrawBuffers built-in. + // + // In CSS fragment shaders, ANGLE: + // (1) Disables the gl_FragColor built-in. + // (2) Disables the gl_FragData built-in. + // (3) Enables the css_MixColor built-in. + // (4) Enables the css_ColorMatrix built-in. + // + // After passing a CSS shader through ANGLE, the browser is expected to append + // a new main function to it. + // This new main function will call the css_main function. + // It may also perform additional operations like varying assignment, texture + // access, and gl_FragColor assignment in order to implement the CSS Shaders + // blend modes. + // + SH_CSS_SHADERS_SPEC +} ShShaderSpec; + +typedef enum { // ESSL output only supported in some configurations. SH_ESSL_OUTPUT = 0x8B45, @@ -65,171 +103,166 @@ enum ShShaderOutput SH_GLSL_440_CORE_OUTPUT = 0x8B87, SH_GLSL_450_CORE_OUTPUT = 0x8B88, + // HLSL output only supported in some configurations. + // Deprecated: + SH_HLSL_OUTPUT = 0x8B48, + SH_HLSL9_OUTPUT = 0x8B48, + SH_HLSL11_OUTPUT = 0x8B49, + // Prefer using these to specify HLSL output type: SH_HLSL_3_0_OUTPUT = 0x8B48, // D3D 9 SH_HLSL_4_1_OUTPUT = 0x8B49, // D3D 11 SH_HLSL_4_0_FL9_3_OUTPUT = 0x8B4A // D3D 11 feature level 9_3 -}; +} ShShaderOutput; // Compile options. - -using ShCompileOptions = uint64_t; - -const ShCompileOptions SH_VALIDATE = 0; -const ShCompileOptions SH_VALIDATE_LOOP_INDEXING = UINT64_C(1) << 0; -const ShCompileOptions SH_INTERMEDIATE_TREE = UINT64_C(1) << 1; -const ShCompileOptions SH_OBJECT_CODE = UINT64_C(1) << 2; -const ShCompileOptions SH_VARIABLES = UINT64_C(1) << 3; -const ShCompileOptions SH_LINE_DIRECTIVES = UINT64_C(1) << 4; -const ShCompileOptions SH_SOURCE_PATH = UINT64_C(1) << 5; -const ShCompileOptions SH_UNROLL_FOR_LOOP_WITH_INTEGER_INDEX = UINT64_C(1) << 6; -// If a sampler array index happens to be a loop index, -// 1) if its type is integer, unroll the loop. -// 2) if its type is float, fail the shader compile. -// This is to work around a mac driver bug. -const ShCompileOptions SH_UNROLL_FOR_LOOP_WITH_SAMPLER_ARRAY_INDEX = UINT64_C(1) << 7; - -// This flag works around bug in Intel Mac drivers related to abs(i) where -// i is an integer. -const ShCompileOptions SH_EMULATE_ABS_INT_FUNCTION = UINT64_C(1) << 8; - -// Enforce the GLSL 1.017 Appendix A section 7 packing restrictions. -// This flag only enforces (and can only enforce) the packing -// restrictions for uniform variables in both vertex and fragment -// shaders. ShCheckVariablesWithinPackingLimits() lets embedders -// enforce the packing restrictions for varying variables during -// program link time. -const ShCompileOptions SH_ENFORCE_PACKING_RESTRICTIONS = UINT64_C(1) << 9; - -// This flag ensures all indirect (expression-based) array indexing -// is clamped to the bounds of the array. This ensures, for example, -// that you cannot read off the end of a uniform, whether an array -// vec234, or mat234 type. The ShArrayIndexClampingStrategy enum, -// specified in the ShBuiltInResources when constructing the -// compiler, selects the strategy for the clamping implementation. -const ShCompileOptions SH_CLAMP_INDIRECT_ARRAY_BOUNDS = UINT64_C(1) << 10; - -// This flag limits the complexity of an expression. -const ShCompileOptions SH_LIMIT_EXPRESSION_COMPLEXITY = UINT64_C(1) << 11; - -// This flag limits the depth of the call stack. -const ShCompileOptions SH_LIMIT_CALL_STACK_DEPTH = UINT64_C(1) << 12; - -// This flag initializes gl_Position to vec4(0,0,0,0) at the -// beginning of the vertex shader's main(), and has no effect in the -// fragment shader. It is intended as a workaround for drivers which -// incorrectly fail to link programs if gl_Position is not written. -const ShCompileOptions SH_INIT_GL_POSITION = UINT64_C(1) << 13; - -// This flag replaces -// "a && b" with "a ? b : false", -// "a || b" with "a ? true : b". -// This is to work around a MacOSX driver bug that |b| is executed -// independent of |a|'s value. -const ShCompileOptions SH_UNFOLD_SHORT_CIRCUIT = UINT64_C(1) << 14; - -// This flag initializes output variables to 0 at the beginning of main(). -// It is to avoid undefined behaviors. -const ShCompileOptions SH_INIT_OUTPUT_VARIABLES = UINT64_C(1) << 15; - -// This flag scalarizes vec/ivec/bvec/mat constructor args. -// It is intended as a workaround for Linux/Mac driver bugs. -const ShCompileOptions SH_SCALARIZE_VEC_AND_MAT_CONSTRUCTOR_ARGS = UINT64_C(1) << 16; - -// This flag overwrites a struct name with a unique prefix. -// It is intended as a workaround for drivers that do not handle -// struct scopes correctly, including all Mac drivers and Linux AMD. -const ShCompileOptions SH_REGENERATE_STRUCT_NAMES = UINT64_C(1) << 17; - -// This flag makes the compiler not prune unused function early in the -// compilation process. Pruning coupled with SH_LIMIT_CALL_STACK_DEPTH -// helps avoid bad shaders causing stack overflows. -const ShCompileOptions SH_DONT_PRUNE_UNUSED_FUNCTIONS = UINT64_C(1) << 18; - -// This flag works around a bug in NVIDIA 331 series drivers related -// to pow(x, y) where y is a constant vector. -const ShCompileOptions SH_REMOVE_POW_WITH_CONSTANT_EXPONENT = UINT64_C(1) << 19; - -// This flag works around bugs in Mac drivers related to do-while by -// transforming them into an other construct. -const ShCompileOptions SH_REWRITE_DO_WHILE_LOOPS = UINT64_C(1) << 20; - -// This flag works around a bug in the HLSL compiler optimizer that folds certain -// constant pow expressions incorrectly. Only applies to the HLSL back-end. It works -// by expanding the integer pow expressions into a series of multiplies. -const ShCompileOptions SH_EXPAND_SELECT_HLSL_INTEGER_POW_EXPRESSIONS = UINT64_C(1) << 21; - -// Flatten "#pragma STDGL invariant(all)" into the declarations of -// varying variables and built-in GLSL variables. This compiler -// option is enabled automatically when needed. -const ShCompileOptions SH_FLATTEN_PRAGMA_STDGL_INVARIANT_ALL = UINT64_C(1) << 22; - -// Some drivers do not take into account the base level of the texture in the results of the -// HLSL GetDimensions builtin. This flag instructs the compiler to manually add the base level -// offsetting. -const ShCompileOptions SH_HLSL_GET_DIMENSIONS_IGNORES_BASE_LEVEL = UINT64_C(1) << 23; - -// This flag works around an issue in translating GLSL function texelFetchOffset on -// INTEL drivers. It works by translating texelFetchOffset into texelFetch. -const ShCompileOptions SH_REWRITE_TEXELFETCHOFFSET_TO_TEXELFETCH = UINT64_C(1) << 24; - -// This flag works around condition bug of for and while loops in Intel Mac OSX drivers. -// Condition calculation is not correct. Rewrite it from "CONDITION" to "CONDITION && true". -const ShCompileOptions SH_ADD_AND_TRUE_TO_LOOP_CONDITION = UINT64_C(1) << 25; - -// This flag works around a bug in evaluating unary minus operator on integer on some INTEL -// drivers. It works by translating -(int) into ~(int) + 1. -const ShCompileOptions SH_REWRITE_INTEGER_UNARY_MINUS_OPERATOR = UINT64_C(1) << 26; - -// This flag works around a bug in evaluating isnan() on some INTEL D3D and Mac OSX drivers. -// It works by using an expression to emulate this function. -const ShCompileOptions SH_EMULATE_ISNAN_FLOAT_FUNCTION = UINT64_C(1) << 27; - -// This flag will use all uniforms of unused std140 and shared uniform blocks at the -// beginning of the vertex/fragment shader's main(). It is intended as a workaround for Mac -// drivers with shader version 4.10. In those drivers, they will treat unused -// std140 and shared uniform blocks' members as inactive. However, WebGL2.0 based on -// OpenGL ES3.0.4 requires all members of a named uniform block declared with a shared or std140 -// layout qualifier to be considered active. The uniform block itself is also considered active. -const ShCompileOptions SH_USE_UNUSED_STANDARD_SHARED_BLOCKS = UINT64_C(1) << 28; - -// This flag will keep invariant declaration for input in fragment shader for GLSL >=4.20 on AMD. -// From GLSL >= 4.20, it's optional to add invariant for fragment input, but GPU vendors have -// different implementations about this. Some drivers forbid invariant in fragment for GLSL>= 4.20, -// e.g. Linux Mesa, some drivers treat that as optional, e.g. NVIDIA, some drivers require invariant -// must match between vertex and fragment shader, e.g. AMD. The behavior on AMD is obviously wrong. -// Remove invariant for input in fragment shader to workaround the restriction on Intel Mesa. -// But don't remove on AMD Linux to avoid triggering the bug on AMD. -const ShCompileOptions SH_DONT_REMOVE_INVARIANT_FOR_FRAGMENT_INPUT = UINT64_C(1) << 29; - -// Due to spec difference between GLSL 4.1 or lower and ESSL3, some platforms (for example, Mac OSX -// core profile) require a variable's "invariant"/"centroid" qualifiers to match between vertex and -// fragment shader. A simple solution to allow such shaders to link is to omit the two qualifiers. -// Note that the two flags only take effect on ESSL3 input shaders translated to GLSL 4.1 or lower. -// TODO(zmo): This is not a good long-term solution. Simply dropping these qualifiers may break some -// developers' content. A more complex workaround of dynamically generating, compiling, and -// re-linking shaders that use these qualifiers should be implemented. -const ShCompileOptions SH_REMOVE_INVARIANT_AND_CENTROID_FOR_ESSL3 = UINT64_C(1) << 30; +typedef enum { + SH_VALIDATE = 0, + SH_VALIDATE_LOOP_INDEXING = 0x0001, + SH_INTERMEDIATE_TREE = 0x0002, + SH_OBJECT_CODE = 0x0004, + SH_VARIABLES = 0x0008, + SH_LINE_DIRECTIVES = 0x0010, + SH_SOURCE_PATH = 0x0020, + SH_UNROLL_FOR_LOOP_WITH_INTEGER_INDEX = 0x0040, + // If a sampler array index happens to be a loop index, + // 1) if its type is integer, unroll the loop. + // 2) if its type is float, fail the shader compile. + // This is to work around a mac driver bug. + SH_UNROLL_FOR_LOOP_WITH_SAMPLER_ARRAY_INDEX = 0x0080, + + // This is needed only as a workaround for certain OpenGL driver bugs. + SH_EMULATE_BUILT_IN_FUNCTIONS = 0x0100, + + // This is an experimental flag to enforce restrictions that aim to prevent + // timing attacks. + // It generates compilation errors for shaders that could expose sensitive + // texture information via the timing channel. + // To use this flag, you must compile the shader under the WebGL spec + // (using the SH_WEBGL_SPEC flag). + SH_TIMING_RESTRICTIONS = 0x0200, + + // This flag prints the dependency graph that is used to enforce timing + // restrictions on fragment shaders. + // This flag only has an effect if all of the following are true: + // - The shader spec is SH_WEBGL_SPEC. + // - The compile options contain the SH_TIMING_RESTRICTIONS flag. + // - The shader type is GL_FRAGMENT_SHADER. + SH_DEPENDENCY_GRAPH = 0x0400, + + // Enforce the GLSL 1.017 Appendix A section 7 packing restrictions. + // This flag only enforces (and can only enforce) the packing + // restrictions for uniform variables in both vertex and fragment + // shaders. ShCheckVariablesWithinPackingLimits() lets embedders + // enforce the packing restrictions for varying variables during + // program link time. + SH_ENFORCE_PACKING_RESTRICTIONS = 0x0800, + + // This flag ensures all indirect (expression-based) array indexing + // is clamped to the bounds of the array. This ensures, for example, + // that you cannot read off the end of a uniform, whether an array + // vec234, or mat234 type. The ShArrayIndexClampingStrategy enum, + // specified in the ShBuiltInResources when constructing the + // compiler, selects the strategy for the clamping implementation. + SH_CLAMP_INDIRECT_ARRAY_BOUNDS = 0x1000, + + // This flag limits the complexity of an expression. + SH_LIMIT_EXPRESSION_COMPLEXITY = 0x2000, + + // This flag limits the depth of the call stack. + SH_LIMIT_CALL_STACK_DEPTH = 0x4000, + + // This flag initializes gl_Position to vec4(0,0,0,0) at the + // beginning of the vertex shader's main(), and has no effect in the + // fragment shader. It is intended as a workaround for drivers which + // incorrectly fail to link programs if gl_Position is not written. + SH_INIT_GL_POSITION = 0x8000, + + // This flag replaces + // "a && b" with "a ? b : false", + // "a || b" with "a ? true : b". + // This is to work around a MacOSX driver bug that |b| is executed + // independent of |a|'s value. + SH_UNFOLD_SHORT_CIRCUIT = 0x10000, + + // This flag initializes output variables to 0 at the beginning of main(). + // It is to avoid undefined behaviors. + SH_INIT_OUTPUT_VARIABLES = 0x20000, + // TODO(zmo): obsolete, remove after ANGLE roll into Chromium. + SH_INIT_VARYINGS_WITHOUT_STATIC_USE = 0x20000, + + // This flag scalarizes vec/ivec/bvec/mat constructor args. + // It is intended as a workaround for Linux/Mac driver bugs. + SH_SCALARIZE_VEC_AND_MAT_CONSTRUCTOR_ARGS = 0x40000, + + // This flag overwrites a struct name with a unique prefix. + // It is intended as a workaround for drivers that do not handle + // struct scopes correctly, including all Mac drivers and Linux AMD. + SH_REGENERATE_STRUCT_NAMES = 0x80000, + + // This flag makes the compiler not prune unused function early in the + // compilation process. Pruning coupled with SH_LIMIT_CALL_STACK_DEPTH + // helps avoid bad shaders causing stack overflows. + SH_DONT_PRUNE_UNUSED_FUNCTIONS = 0x100000, + + // This flag works around a bug in NVIDIA 331 series drivers related + // to pow(x, y) where y is a constant vector. + SH_REMOVE_POW_WITH_CONSTANT_EXPONENT = 0x200000, + + // This flag works around bugs in Mac drivers related to do-while by + // transforming them into an other construct. + SH_REWRITE_DO_WHILE_LOOPS = 0x400000, + + // This flag works around a bug in the HLSL compiler optimizer that folds certain + // constant pow expressions incorrectly. Only applies to the HLSL back-end. It works + // by expanding the integer pow expressions into a series of multiplies. + SH_EXPAND_SELECT_HLSL_INTEGER_POW_EXPRESSIONS = 0x800000, + + // Flatten "#pragma STDGL invariant(all)" into the declarations of + // varying variables and built-in GLSL variables. This compiler + // option is enabled automatically when needed. + SH_FLATTEN_PRAGMA_STDGL_INVARIANT_ALL = 0x1000000, + + // Some drivers do not take into account the base level of the texture in the results of the + // HLSL GetDimensions builtin. This flag instructs the compiler to manually add the base level + // offsetting. + SH_HLSL_GET_DIMENSIONS_IGNORES_BASE_LEVEL = 0x2000000, + + // This flag works around an issue in translating GLSL function texelFetchOffset on + // INTEL drivers. It works by translating texelFetchOffset into texelFetch. + SH_REWRITE_TEXELFETCHOFFSET_TO_TEXELFETCH = 0x4000000, +} ShCompileOptions; // Defines alternate strategies for implementing array index clamping. -enum ShArrayIndexClampingStrategy -{ - // Use the clamp intrinsic for array index clamping. - SH_CLAMP_WITH_CLAMP_INTRINSIC = 1, +typedef enum { + // Use the clamp intrinsic for array index clamping. + SH_CLAMP_WITH_CLAMP_INTRINSIC = 1, + + // Use a user-defined function for array index clamping. + SH_CLAMP_WITH_USER_DEFINED_INT_CLAMP_FUNCTION +} ShArrayIndexClampingStrategy; - // Use a user-defined function for array index clamping. - SH_CLAMP_WITH_USER_DEFINED_INT_CLAMP_FUNCTION -}; +// +// Driver must call this first, once, before doing any other +// compiler operations. +// If the function succeeds, the return value is true, else false. +// +COMPILER_EXPORT bool ShInitialize(); +// +// Driver should call this at shutdown. +// If the function succeeds, the return value is true, else false. +// +COMPILER_EXPORT bool ShFinalize(); // The 64 bits hash function. The first parameter is the input string; the // second parameter is the string length. -using ShHashFunction64 = khronos_uint64_t (*)(const char *, size_t); +typedef khronos_uint64_t (*ShHashFunction64)(const char*, size_t); // // Implementation dependent built-in resources (constants and extensions). // The names for these resources has been obtained by stripping gl_/GL_. // -struct ShBuiltInResources +typedef struct { // Constants. int MaxVertexAttribs; @@ -361,7 +394,15 @@ struct ShBuiltInResources // maximum number of buffer object storage in machine units int MaxAtomicCounterBufferSize; -}; + +} ShBuiltInResources; + +// +// Initialize built-in resources with minimum expected values. +// Parameters: +// resources: The object to initialize. Will be comparable with memcmp. +// +COMPILER_EXPORT void ShInitBuiltInResources(ShBuiltInResources *resources); // // ShHandle held by but opaque to the driver. It is allocated, @@ -370,26 +411,7 @@ struct ShBuiltInResources // // If handle creation fails, 0 will be returned. // -using ShHandle = void *; - -// -// Driver must call this first, once, before doing any other -// compiler operations. -// If the function succeeds, the return value is true, else false. -// -bool ShInitialize(); -// -// Driver should call this at shutdown. -// If the function succeeds, the return value is true, else false. -// -bool ShFinalize(); - -// -// Initialize built-in resources with minimum expected values. -// Parameters: -// resources: The object to initialize. Will be comparable with memcmp. -// -void ShInitBuiltInResources(ShBuiltInResources *resources); +typedef void *ShHandle; // // Returns the a concatenated list of the items in ShBuiltInResources as a @@ -397,7 +419,7 @@ void ShInitBuiltInResources(ShBuiltInResources *resources); // This function must be updated whenever ShBuiltInResources is changed. // Parameters: // handle: Specifies the handle of the compiler to be used. -const std::string &ShGetBuiltInResourcesString(const ShHandle handle); +COMPILER_EXPORT const std::string &ShGetBuiltInResourcesString(const ShHandle handle); // // Driver calls these to create and destroy compiler objects. @@ -412,11 +434,12 @@ const std::string &ShGetBuiltInResourcesString(const ShHandle handle); // SH_HLSL_3_0_OUTPUT or SH_HLSL_4_1_OUTPUT. Note: Each output type may only // be supported in some configurations. // resources: Specifies the built-in resources. -ShHandle ShConstructCompiler(sh::GLenum type, - ShShaderSpec spec, - ShShaderOutput output, - const ShBuiltInResources *resources); -void ShDestruct(ShHandle handle); +COMPILER_EXPORT ShHandle ShConstructCompiler( + sh::GLenum type, + ShShaderSpec spec, + ShShaderOutput output, + const ShBuiltInResources *resources); +COMPILER_EXPORT void ShDestruct(ShHandle handle); // // Compiles the given shader source. @@ -436,42 +459,45 @@ void ShDestruct(ShHandle handle); // There is no need to specify this parameter when // compiling for WebGL - it is implied. // SH_INTERMEDIATE_TREE: Writes intermediate tree to info log. -// Can be queried by calling sh::GetInfoLog(). +// Can be queried by calling ShGetInfoLog(). // SH_OBJECT_CODE: Translates intermediate tree to glsl or hlsl shader. -// Can be queried by calling sh::GetObjectCode(). +// Can be queried by calling ShGetObjectCode(). // SH_VARIABLES: Extracts attributes, uniforms, and varyings. // Can be queried by calling ShGetVariableInfo(). // -bool ShCompile(const ShHandle handle, - const char *const shaderStrings[], - size_t numStrings, - ShCompileOptions compileOptions); +COMPILER_EXPORT bool ShCompile( + const ShHandle handle, + const char * const shaderStrings[], + size_t numStrings, + int compileOptions); // Clears the results from the previous compilation. -void ShClearResults(const ShHandle handle); +COMPILER_EXPORT void ShClearResults(const ShHandle handle); // Return the version of the shader language. -int ShGetShaderVersion(const ShHandle handle); +COMPILER_EXPORT int ShGetShaderVersion(const ShHandle handle); // Return the currently set language output type. -ShShaderOutput ShGetShaderOutputType(const ShHandle handle); +COMPILER_EXPORT ShShaderOutput ShGetShaderOutputType( + const ShHandle handle); // Returns null-terminated information log for a compiled shader. // Parameters: // handle: Specifies the compiler -const std::string &ShGetInfoLog(const ShHandle handle); +COMPILER_EXPORT const std::string &ShGetInfoLog(const ShHandle handle); // Returns null-terminated object code for a compiled shader. // Parameters: // handle: Specifies the compiler -const std::string &ShGetObjectCode(const ShHandle handle); +COMPILER_EXPORT const std::string &ShGetObjectCode(const ShHandle handle); // Returns a (original_name, hash) map containing all the user defined // names in the shader, including variable names, function names, struct // names, and struct field names. // Parameters: // handle: Specifies the compiler -const std::map<std::string, std::string> *ShGetNameHashingMap(const ShHandle handle); +COMPILER_EXPORT const std::map<std::string, std::string> *ShGetNameHashingMap( + const ShHandle handle); // Shader variable inspection. // Returns a pointer to a list of variables of the designated type. @@ -479,12 +505,18 @@ const std::map<std::string, std::string> *ShGetNameHashingMap(const ShHandle han // Returns NULL on failure. // Parameters: // handle: Specifies the compiler -const std::vector<sh::Uniform> *ShGetUniforms(const ShHandle handle); -const std::vector<sh::Varying> *ShGetVaryings(const ShHandle handle); -const std::vector<sh::Attribute> *ShGetAttributes(const ShHandle handle); -const std::vector<sh::OutputVariable> *ShGetOutputVariables(const ShHandle handle); -const std::vector<sh::InterfaceBlock> *ShGetInterfaceBlocks(const ShHandle handle); -sh::WorkGroupSize ShGetComputeShaderLocalGroupSize(const ShHandle handle); +COMPILER_EXPORT const std::vector<sh::Uniform> *ShGetUniforms(const ShHandle handle); +COMPILER_EXPORT const std::vector<sh::Varying> *ShGetVaryings(const ShHandle handle); +COMPILER_EXPORT const std::vector<sh::Attribute> *ShGetAttributes(const ShHandle handle); +COMPILER_EXPORT const std::vector<sh::OutputVariable> *ShGetOutputVariables(const ShHandle handle); +COMPILER_EXPORT const std::vector<sh::InterfaceBlock> *ShGetInterfaceBlocks(const ShHandle handle); +COMPILER_EXPORT sh::WorkGroupSize ShGetComputeShaderLocalGroupSize(const ShHandle handle); + +typedef struct +{ + sh::GLenum type; + int size; +} ShVariableInfo; // Returns true if the passed in variables pack in maxVectors following // the packing rules from the GLSL 1.017 spec, Appendix A, section 7. @@ -493,8 +525,9 @@ sh::WorkGroupSize ShGetComputeShaderLocalGroupSize(const ShHandle handle); // Parameters: // maxVectors: the available rows of registers. // variables: an array of variables. -bool ShCheckVariablesWithinPackingLimits(int maxVectors, - const std::vector<sh::ShaderVariable> &variables); +COMPILER_EXPORT bool ShCheckVariablesWithinPackingLimits( + int maxVectors, + const std::vector<sh::ShaderVariable> &variables); // Gives the compiler-assigned register for an interface block. // The method writes the value to the output variable "indexOut". @@ -503,155 +536,14 @@ bool ShCheckVariablesWithinPackingLimits(int maxVectors, // handle: Specifies the compiler // interfaceBlockName: Specifies the interface block // indexOut: output variable that stores the assigned register -bool ShGetInterfaceBlockRegister(const ShHandle handle, - const std::string &interfaceBlockName, - unsigned int *indexOut); +COMPILER_EXPORT bool ShGetInterfaceBlockRegister(const ShHandle handle, + const std::string &interfaceBlockName, + unsigned int *indexOut); // Gives a map from uniform names to compiler-assigned registers in the default // interface block. Note that the map contains also registers of samplers that // have been extracted from structs. -const std::map<std::string, unsigned int> *ShGetUniformRegisterMap(const ShHandle handle); - -// Temporary duplicate of the scoped APIs, to be removed when we roll ANGLE and fix Chromium. -// TODO(jmadill): Consolidate with these APIs once we roll ANGLE. - -namespace sh -{ - -// -// Driver must call this first, once, before doing any other compiler operations. -// If the function succeeds, the return value is true, else false. -// -bool Initialize(); -// -// Driver should call this at shutdown. -// If the function succeeds, the return value is true, else false. -// -bool Finalize(); - -// -// Initialize built-in resources with minimum expected values. -// Parameters: -// resources: The object to initialize. Will be comparable with memcmp. -// -void InitBuiltInResources(ShBuiltInResources *resources); - -// -// Returns the a concatenated list of the items in ShBuiltInResources as a null-terminated string. -// This function must be updated whenever ShBuiltInResources is changed. -// Parameters: -// handle: Specifies the handle of the compiler to be used. -const std::string &GetBuiltInResourcesString(const ShHandle handle); - -// -// Driver calls these to create and destroy compiler objects. -// -// Returns the handle of constructed compiler, null if the requested compiler is not supported. -// Parameters: -// type: Specifies the type of shader - GL_FRAGMENT_SHADER or GL_VERTEX_SHADER. -// spec: Specifies the language spec the compiler must conform to - SH_GLES2_SPEC or SH_WEBGL_SPEC. -// output: Specifies the output code type - for example SH_ESSL_OUTPUT, SH_GLSL_OUTPUT, -// SH_HLSL_3_0_OUTPUT or SH_HLSL_4_1_OUTPUT. Note: Each output type may only -// be supported in some configurations. -// resources: Specifies the built-in resources. -ShHandle ConstructCompiler(sh::GLenum type, - ShShaderSpec spec, - ShShaderOutput output, - const ShBuiltInResources *resources); -void Destruct(ShHandle handle); - -// -// Compiles the given shader source. -// If the function succeeds, the return value is true, else false. -// Parameters: -// handle: Specifies the handle of compiler to be used. -// shaderStrings: Specifies an array of pointers to null-terminated strings containing the shader -// source code. -// numStrings: Specifies the number of elements in shaderStrings array. -// compileOptions: A mask containing the following parameters: -// SH_VALIDATE: Validates shader to ensure that it conforms to the spec -// specified during compiler construction. -// SH_VALIDATE_LOOP_INDEXING: Validates loop and indexing in the shader to -// ensure that they do not exceed the minimum -// functionality mandated in GLSL 1.0 spec, -// Appendix A, Section 4 and 5. -// There is no need to specify this parameter when -// compiling for WebGL - it is implied. -// SH_INTERMEDIATE_TREE: Writes intermediate tree to info log. -// Can be queried by calling sh::GetInfoLog(). -// SH_OBJECT_CODE: Translates intermediate tree to glsl or hlsl shader. -// Can be queried by calling sh::GetObjectCode(). -// SH_VARIABLES: Extracts attributes, uniforms, and varyings. -// Can be queried by calling ShGetVariableInfo(). -// -bool Compile(const ShHandle handle, - const char *const shaderStrings[], - size_t numStrings, - ShCompileOptions compileOptions); - -// Clears the results from the previous compilation. -void ClearResults(const ShHandle handle); - -// Return the version of the shader language. -int GetShaderVersion(const ShHandle handle); - -// Return the currently set language output type. -ShShaderOutput GetShaderOutputType(const ShHandle handle); - -// Returns null-terminated information log for a compiled shader. -// Parameters: -// handle: Specifies the compiler -const std::string &GetInfoLog(const ShHandle handle); - -// Returns null-terminated object code for a compiled shader. -// Parameters: -// handle: Specifies the compiler -const std::string &GetObjectCode(const ShHandle handle); - -// Returns a (original_name, hash) map containing all the user defined names in the shader, -// including variable names, function names, struct names, and struct field names. -// Parameters: -// handle: Specifies the compiler -const std::map<std::string, std::string> *GetNameHashingMap(const ShHandle handle); - -// Shader variable inspection. -// Returns a pointer to a list of variables of the designated type. -// (See ShaderVars.h for type definitions, included above) -// Returns NULL on failure. -// Parameters: -// handle: Specifies the compiler -const std::vector<sh::Uniform> *GetUniforms(const ShHandle handle); -const std::vector<sh::Varying> *GetVaryings(const ShHandle handle); -const std::vector<sh::Attribute> *GetAttributes(const ShHandle handle); -const std::vector<sh::OutputVariable> *GetOutputVariables(const ShHandle handle); -const std::vector<sh::InterfaceBlock> *GetInterfaceBlocks(const ShHandle handle); -sh::WorkGroupSize GetComputeShaderLocalGroupSize(const ShHandle handle); - -// Returns true if the passed in variables pack in maxVectors followingthe packing rules from the -// GLSL 1.017 spec, Appendix A, section 7. -// Returns false otherwise. Also look at the SH_ENFORCE_PACKING_RESTRICTIONS -// flag above. -// Parameters: -// maxVectors: the available rows of registers. -// variables: an array of variables. -bool CheckVariablesWithinPackingLimits(int maxVectors, - const std::vector<sh::ShaderVariable> &variables); - -// Gives the compiler-assigned register for an interface block. -// The method writes the value to the output variable "indexOut". -// Returns true if it found a valid interface block, false otherwise. -// Parameters: -// handle: Specifies the compiler -// interfaceBlockName: Specifies the interface block -// indexOut: output variable that stores the assigned register -bool GetInterfaceBlockRegister(const ShHandle handle, - const std::string &interfaceBlockName, - unsigned int *indexOut); - -// Gives a map from uniform names to compiler-assigned registers in the default interface block. -// Note that the map contains also registers of samplers that have been extracted from structs. -const std::map<std::string, unsigned int> *GetUniformRegisterMap(const ShHandle handle); - -} // namespace sh +COMPILER_EXPORT const std::map<std::string, unsigned int> *ShGetUniformRegisterMap( + const ShHandle handle); #endif // GLSLANG_SHADERLANG_H_ |