GL Shader Validator
A GLSL and ESSL validator for Sublime Text 2 and 3
- Total 6K
- Win 3K
- Mac 2K
- Linux 778
|May 17||May 16||May 15||May 14||May 13||May 12||May 11||May 10||May 9||May 8||May 7||May 6||May 5||May 4||May 3||May 2||May 1||Apr 30||Apr 29||Apr 28||Apr 27||Apr 26||Apr 25||Apr 24||Apr 23||Apr 22||Apr 21||Apr 20||Apr 19||Apr 18||Apr 17||Apr 16||Apr 15||Apr 14||Apr 13||Apr 12||Apr 11||Apr 10||Apr 9||Apr 8||Apr 7||Apr 6||Apr 5||Apr 4||Apr 3|
GL Shader Validator
This is a Sublime Text 2 / 3 plugin that passes GLSL / ESSL to ANGLE's preprocessor / compiler for validation. Any errors that ANGLE finds are routed back to Sublime and the tokens in the shader are highlighted for your convenience and debugging joy. To see the details of the error check the status message in the bottom left of the Sublime view.
You can, and probably should, install GL Shader Validator via Package Control
If you would like to install it manually, clone this repo into your packages folder (typically ~/Library/Application Support/Sublime Text 2/Packages).
cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages git clone git://github.com/WebGLTools/GL-Shader-Validator.git "GL Shader Validator"
If you're on Windows 7 the path looks more like this, assuming you have Git installed:
cd c:\users\YOUR_ACCOUNT\AppData\Roaming\Sublime Text 2\Packages git clone git://github.com/WebGLTools/GL-Shader-Validator.git "GL Shader Validator"
Also if you're using Sublime Text 3 then you just switch the
2 in the path above to
3 and you should be all set.
Assuming that you have a GLSL / ESSL syntax highlighter installed in Sublime, all you should need to do is install the plugin and your shader code will be validated as expected.
It's worth saying that ANGLE expects vertex shaders to have the file
.vert and fragment shaders
.frag. If you do not name your files
with that suffix ANGLE (and therefore the plugin) will not be able
to validate your shaders. Sadness will ensue.
You can set the default specification to use in the settings: “ Preferences > Package Settings > GL Shader Validator > Settings - Default
This can be overridden in a specific shader by adding comments: `/* spec: webgl */` for WebGL, `/* spec: es2 */` for OpenGL ES 2.0 or `/* spec: css */ ` for Custom Filters / CSS Shaders ## Permissions This plugin requires use of a command line utility called essl_to_glsl, which is bundled with the plugin. By default, however, the utility will not have execute permissions. The plugin will attempt to enable those permissions automatically when it loads, but should that fail you will receive the following error message: > GLShaderValidator: permission denied to use essl_to_glsl command In such instances you should enable execute permissions yourself:
cd ~/Library/Application Support/Sublime Text 2/Packages/GL\ Shader\ Validator chmod +x essl_to_glsl
## Settings You can modify the settings file (`GLShaderValidator.sublime-settings`) inside the plugin folder. You will find the documentation for the settings in that file. There aren't many of those right now, but if you want more let us know via the repo's Issues. ## Credits * [Paul Lewis](http://aerotwist.com) * [Brendan Kenny](http://extremelysatisfactorytotalitarianism.com/)