WebGLProgram

Constructor for the GLSL program sent to vertex and fragment shaders, including default uniforms and attributes.

Built-in uniforms and attributes

Vertex shader (unconditional):


    // = object.matrixWorld
    uniform mat4 modelMatrix;

    // = camera.matrixWorldInverse * object.matrixWorld
    uniform mat4 modelViewMatrix;

    // = camera.projectionMatrix
    uniform mat4 projectionMatrix;

    // = camera.matrixWorldInverse
    uniform mat4 viewMatrix;

    // = inverse transpose of modelViewMatrix
    uniform mat3 normalMatrix;

    // = camera position in world space
    uniform vec3 cameraPosition;


    // default vertex attributes provided by Geometry and BufferGeometry
    attribute vec3 position;
    attribute vec3 normal;
    attribute vec2 uv;

Note that you can therefore calculate the position of a vertex in the vertex shader by: gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); or alternatively gl_Position = projectionMatrix * viewMatrix * modelMatrix * vec4(position, 1.0);

Vertex shader (conditional):


    #ifdef USE_COLOR
      // vertex color attribute
      attribute vec3 color;
    #endif


    #ifdef USE_MORPHTARGETS

      attribute vec3 morphTarget0;
      attribute vec3 morphTarget1;
      attribute vec3 morphTarget2;
      attribute vec3 morphTarget3;
      attribute vec3 morphTarget4;
      attribute vec3 morphTarget5;

      #ifdef USE_MORPHNORMALS

        attribute vec3 morphNormal0;
        attribute vec3 morphNormal1;
        attribute vec3 morphNormal2;
        attribute vec3 morphNormal3;
        attribute vec3 morphNormal4;
        attribute vec3 morphNormal5;

      #else

        attribute vec3 morphTarget6;
        attribute vec3 morphTarget7;
        attribute vec3 morphTarget8;
        attribute vec3 morphTarget9;
        attribute vec3 morphTarget10;
        attribute vec3 morphTarget11;

      #endif
    #endif


    #ifdef USE_SKINNING
      attribute vec4 skinIndex;
      attribute vec4 skinWeight;
    #endif


    #ifdef USE_INSTANCING
      // Note that modelViewMatrix is not set when rendering an instanced model,
      // but can be calculated from viewMatrix * modelMatrix.
      //
      // Basic Usage:
      //   gl_Position = projectionMatrix * viewMatrix * modelMatrix * instanceMatrix * vec4(position, 1.0);
      attribute mat4 instanceMatrix;
    #endif

Fragment shader:


    uniform mat4 viewMatrix;
    uniform vec3 cameraPosition;

Constructor

WebGLProgram(renderer : WebGLRenderer, cacheKey : String, parameters : Object)

For parameters see WebGLRenderer.

Properties

# .name : String

The name of the respective shader program.

# .id : String

The identifier of this instance.

# .cacheKey : String

This key enables the reusability of a single WebGLProgram for different materials.

# .usedTimes : Integer

How many times this instance is used for rendering render items.

# .program : Object

The actual shader program.

# .vertexShader : WebGLShader

An instance of WebGLShader representing the vertex shader.

# .fragmentShader : WebGLShader

An instance of WebGLShader representing the frament shader.

Methods

# .getUniforms () : Object

Returns a name-value mapping of all active uniform locations.

# .getAttributes () : Object

Returns a name-value mapping of all active vertex attribute locations.

# .destroy () : null

Destroys an instance of WebGLProgram.

Source

For more info on how to obtain the source code of this module see this page.

Last updated on Mon Sep 20 2021