gl-shader-extract v1.1.2

gl-shader-extract

Extracts active uniforms and attributes from a compiled WebGLProgram at runtime and normalizes their types to match GLSL syntax.

For an offline version, see glsl-extract.

Example

var extract = require('gl-shader-extract')

var fragSource = 'void main()'
var vertSource = `
  attribute vec4 position;
  uniform mat4 projection;
  void main() { 
    gl_Position = projection * position;
  }
`

//compile the source into a WebGLProgram object
var program = ...

//get the uniforms and attributes
var data = extract(gl, program)

console.log(data.attributes[0]) 
// { type: "vec4", name: 'position' }

console.log(data.uniforms[0]) 
// { type: "mat4", name: 'projection' }

Usage

Install

npm install gl-shader-extract --save

API

data = extract(gl, program)

Extracts the type and name from each uniform/attribute that was active in the shader. The returned data looks like this:

{
  attributes: [ { name: 'position', type: 'vec4' } ],
  uniforms: [ { name: 'projection', type: 'mat4' } ]
}

uniforms = extract.uniforms(gl, program)

As above, but only extracts the uniforms array.

attributes = extract.attributes(gl, program)

As above, but only extracts the attributes array.

Type Mapping

WebGL 2.0 Support

The following are also translated in WebGL2.

Credits

This was pulled out from @mikolalysenko's gl-shader for use in other engines/frameworks.

License

MIT, see LICENSE.md for details.