mesa/docs/MESA_shader_debug.spec

195 lines
3.7 KiB
Plaintext
Raw Normal View History

2006-05-30 10:35:36 +01:00
Name
MESA_shader_debug
Name Strings
GL_MESA_shader_debug
Contact
Brian Paul (brian.paul 'at' tungstengraphics.com)
Michal Krol (mjkrol 'at' gmail.com)
Status
XXX - Not complete yet!!!
Version
Last Modified Date: May 29, 2006
Author Revision: 0.1
$Date: 2006/05/30 09:35:36 $ $Revision: 1.1 $
Number
TBD
Dependencies
OpenGL 1.5 is required.
The extension is written against the OpenGL 1.5 specification.
ARB_shading_language_100 is required.
ARB_shader_objects is required.
The extension is written against the OpenGL Shading Language
1.10 Specification.
Overview
TBD
IP Status
None
Issues
None
New Procedures and Functions
TBD
New Types
None
New Tokens
TBD
Additions to Chapter 2 of the OpenGL 1.5 Specification
(OpenGL Operation)
None
Additions to Chapter 3 of the OpenGL 1.5 Specification (Rasterization)
None
Additions to Chapter 4 of the OpenGL 1.5 Specification (Per-Fragment
Operations and the Frame Buffer)
None
Additions to Chapter 5 of the OpenGL 1.5 Specification
(Special Functions)
None
Additions to Chapter 6 of the OpenGL 1.5 Specification (State and State
Requests)
None
Additions to Appendix A of the OpenGL 1.5 Specification (Invariance)
None
Additions to Chapter 1 of the OpenGL Shading Language 1.10 Specification
(Introduction)
None
Additions to Chapter 2 of the OpenGL Shading Language 1.10 Specification
(Overview of OpenGL Shading)
None
Additions to Chapter 3 of the OpenGL Shading Language 1.10 Specification
(Basics)
None
Additions to Chapter 4 of the OpenGL Shading Language 1.10 Specification
(Variables and Types)
None
Additions to Chapter 5 of the OpenGL Shading Language 1.10 Specification
(Operators and Expressions)
None
Additions to Chapter 6 of the OpenGL Shading Language 1.10 Specification
(Statements and Structure)
None
Additions to Chapter 7 of the OpenGL Shading Language 1.10 Specification
(Built-in Variables)
None
Additions to Chapter 8 of the OpenGL Shading Language 1.10 Specification
(Built-in Functions)
Add a new section 8.10 "Debug Functions":
Debug functions are available to both fragment and vertex shaders.
They are used to track the execution of a shader by logging
passed-in arguments to the shader's info log. That values can be
retrieved and validated by the application after shader execution
is complete.
void printMESA(const float value);
void printMESA(const int value);
void printMESA(const bool value);
void printMESA(const vec2 value);
void printMESA(const vec3 value);
void printMESA(const vec4 value);
void printMESA(const ivec2 value);
void printMESA(const ivec3 value);
void printMESA(const ivec4 value);
void printMESA(const bvec2 value);
void printMESA(const bvec3 value);
void printMESA(const bvec4 value);
void printMESA(const mat2 value);
void printMESA(const mat3 value);
void printMESA(const mat4 value);
void printMESA(const sampler1D value);
void printMESA(const sampler2D value);
void printMESA(const sampler3D value);
void printMESA(const samplerCube value);
void printMESA(const sampler1DShadow value);
void printMESA(const sampler2DShadow value);
Additions to Chapter 9 of the OpenGL Shading Language 1.10 Specification
(Shading Language Grammar)
None
Additions to Chapter 10 of the OpenGL Shading Language 1.10
Specification (Issues)
None
Additions to the AGL/EGL/GLX/WGL Specifications
None
GLX Protocol
None
Errors
TBD
New State
TBD
New Implementation Dependent State
TBD
Sample Code
TBD
Revision History
29 May 2006
Initial draft. (Michal Krol)