gl-basic-shader

Generates and compiles a basic shader with some common attributes and uniforms and a Model, View, Projection vertex transform.

var createShader = require('gl-basic-shader')
var shader = createShader(gl, {
    texcoord: true,    //vertex texcoords
    normal: false,     //vertex normals
    color: true,       //vertex colors
    tint: [1, 0, 0, 1] //uniform color tint
})

//do some stuff with it
shader.bind()
shader.uniforms.texture0 = 0
shader.attribuets.texcoord0.pointer() 
shader.attributes.color.pointer()

The resulting shader will be compiled with the generated source:

// vertex shader
attribute vec4 position;
attribute vec4 color;
attribute vec2 texcoord0;
uniform mat4 projection;
uniform mat4 view;
uniform mat4 model;
varying vec4 v_col;
varying vec2 v_tex0;
void main() {
   gl_Position = projection * view * model * position;
   v_col = color;
   v_tex0 = texcoord0;
   gl_PointSize = 1.0;
}

//fragment shader 
#ifdef GL_ES
precision mediump float;
#endif
varying vec4 v_col;
varying vec2 v_tex0;
uniform sampler2D texture0;
uniform vec4 tint;
void main() {
   gl_FragColor = v_col *  texture2D(texture0,  v_tex0) * tint;
}

Usage

shader = createShader(gl[, options])

Creates a basic shader with the given options:

• texcoord whether to generate texcoord0 attribute vec2 and texture0 sampler2D. If this is a number, then N texcoords and samplers will be used: texture0, texture1, etc.
• normal wherther to generate a normal attribute vec3
• color whether to generate a color attribute vec4
• tint the default value bound to the tint uniform vec4, if not specified then white is used

If the texcoord, normal or color options are false (or texcoord is 0) then that attribute will not be included in the shader.

The projection, model, and view matrices are set to an identity matrix initially.

createShader.generate([options])

This function is exposed to provide the generated shader source, useful for testing and other purposes where GL shader compilation may not be desirable. The options are the same as the constructor.

var source = require('gl-basic-shader').generate(options)
console.log(source.vertex, source.fragment)

attributes

The attributes. Some may not be present if not specified at construction.

• vec4 position
• vec3 normal
• vec4 color
• vec2 texcoord0, texcoord1, etc..

uniforms

The uniforms.

• mat4 model
• mat4 view
• mat4 projection
• vec4 tint
• sampler2D texture0, texture1, etc

License

MIT, see LICENSE.md for details.