gfx/angle/extensions/ANGLE_translated_shader_source.txt@129ffea94266
gfx/angle/extensions/ANGLE_translated_shader_source.txt
Sat, 03 Jan 2015 20:18:00 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Sat, 03 Jan 2015 20:18:00 +0100
- branch
- TOR_BUG_3246
- changeset 7
- 129ffea94266
- permissions
- -rw-r--r--
Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.
1 Name
3 ANGLE_translated_shader_source
5 Name Strings
7 GL_ANGLE_translated_shader_source
9 Contributors
11 Daniel Koch, TransGaming Inc.
12 Gregg Tavares, Google Inc.
13 Kenneth Russell, Google Inc.
14 Zhenyao Mo, Google Inc.
16 Contact
18 Zhenyao Mo, Google Inc. (zmo 'at' google 'dot' com)
20 Status
22 Implemented in ANGLE ES2
24 Version
26 Last Modified Date: October 5, 2011
27 Author Revision: 2
29 Number
31 OpenGL ES Extension #113
33 Dependencies
35 OpenGL ES 2.0 is required.
37 The extension is written against the OpenGL ES 2.0 specification.
39 Overview
41 WebGL uses the GLSL ES 2.0 spec on all platforms, and translates these
42 shaders to the host platform's native language (HLSL, GLSL, and even GLSL
43 ES). For debugging purposes, it is useful to be able to examine the shader
44 after translation.
46 This extension addes a new function to query the translated shader source,
47 and adds a new enum for GetShaderiv's <pname> parameter to query the
48 translated shader source length.
50 IP Status
52 No known IP claims.
54 New Types
56 None
58 New Procedures and Functions
60 void GetTranslatedShaderSourceANGLE(uint shader, sizei bufsize,
61 sizei* length, char* source);
63 New Tokens
65 Accepted by the <pname> parameter of GetShaderiv:
67 TRANSLATED_SHADER_SOURCE_LENGTH_ANGLE 0x93A0
69 Additions to Chapter 6 of the OpenGL ES 2.0 Specification (State and State
70 Requests)
72 Append in the end of the fourth paragraph of section 6.1.8 (Shader and
73 Program Queries):
75 " If <pname> is TRANSLATED_SHADER_LENGTH_ANGLE, the length of the translated
76 source string, including a null terminator, is returned. If no source has
77 been defined, CompileShader has not been called, or the translation has
78 failed for <shader>, zero is returned."
80 Append after the last paragraph of section 6.1.8 (Shader and Program
81 Queries):
83 "The command
85 void GetTranslatedShaderSourceANGLE( uint shader, sizei bufSize,
86 sizei *length, char *source );
88 returns in <source> the string making up the translated source code for
89 the shader object <shader>. The string <source> will be null terminated.
90 The actual number of characters written into <source>, excluding the null
91 terminator, is returned in <length>. If <length> is NULL, no length is
92 returned. The maximum number of characters that may be written into
93 <source>, including the null terminator, is speciļ¬ed by <bufSize>. The
94 string <source> is the translated string of a concatenation of the strings
95 passed to the GL using ShaderSource. The length of this translated string
96 is given by TRANSLATED_SHADER_SOURCE_LENGTH_ANGLE, which can be queried
97 with GetShaderiv.
99 If no source has been defined, CompileShader has not been called, or the
100 translation has failed for <shader>, zero is returned for <length>, and
101 an empty string is returned for <source>.
103 If the value of SHADER_COMPILER is not TRUE, then the error INVALID_-
104 OPERATION is generated."
106 Issues
108 1) What enum value should be used for TRANSLATED_SHADER_SOURCE_LENGTH_ANGLE?
110 RESOLVED: The first draft used a temporary enum value. This been replaced
111 with a enum allocated from the ANGLE range of GL enums.
113 Revision History
115 Revision 1, 2011/09/29, zmo
116 - first draft
117 Revision 2, 2011/10/05, dgkoch
118 - assigned enum
