浅谈Three.js源码-render之WebGLCapabilities.js

/**
 * @author mrdoob / http://mrdoob.com/
 */

function WebGLCapabilities( gl, extensions, parameters ) {

   var maxAnisotropy;//Anisotropy（各向异性）的最大值。
   // 关于在纹理中 各向异性的使用请点这里：http://www.informit.com/articles/article.aspx?p=770639&seqNum=2

   function getMaxAnisotropy() {//

      if ( maxAnisotropy !== undefined ) return maxAnisotropy;

      var extension = extensions.get( 'EXT_texture_filter_anisotropic' );//查看当前设备是否支持相关扩展

      if ( extension !== null ) {

         maxAnisotropy = gl.getParameter( extension.MAX_TEXTURE_MAX_ANISOTROPY_EXT );

      } else {

         maxAnisotropy = 0;

      }

      return maxAnisotropy;

   }

   function getMaxPrecision( precision ) {//获取着色器中支持的最大精度

      if ( precision === 'highp' ) {

         if ( gl.getShaderPrecisionFormat( gl.VERTEX_SHADER, gl.HIGH_FLOAT ).precision > 0 &&
              gl.getShaderPrecisionFormat( gl.FRAGMENT_SHADER, gl.HIGH_FLOAT ).precision > 0 ) {

            return 'highp';

         }

         precision = 'mediump';

      }

      if ( precision === 'mediump' ) {

         if ( gl.getShaderPrecisionFormat( gl.VERTEX_SHADER, gl.MEDIUM_FLOAT ).precision > 0 &&
              gl.getShaderPrecisionFormat( gl.FRAGMENT_SHADER, gl.MEDIUM_FLOAT ).precision > 0 ) {

            return 'mediump';

         }

      }

      return 'lowp';

   }

   var precision = parameters.precision !== undefined ? parameters.precision : 'highp';
   var maxPrecision = getMaxPrecision( precision );

   if ( maxPrecision !== precision ) {

      console.warn( 'THREE.WebGLRenderer:', precision, 'not supported, using', maxPrecision, 'instead.' );
      precision = maxPrecision;

   }

   var logarithmicDepthBuffer = parameters.logarithmicDepthBuffer === true && !! extensions.get( 'EXT_frag_depth' );
   //EXT_frag_depth也是一种扩展功能，它允许开发人员直接在片元着色器中直接指定深度值
   /*example：
    <script type="x-shader/x-fragment">
    void main() {
    gl_FragColor = vec4(1.0, 0.0, 1.0, 1.0);
    gl_FragDepthEXT = 0.5;
    }
    </script>
   * */

   var maxTextures = gl.getParameter( gl.MAX_TEXTURE_IMAGE_UNITS );//单个片段着色器能访问的纹理单元数，最低16，一般16或32
   var maxVertexTextures = gl.getParameter( gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS );
   var maxTextureSize = gl.getParameter( gl.MAX_TEXTURE_SIZE );
   var maxCubemapSize = gl.getParameter( gl.MAX_CUBE_MAP_TEXTURE_SIZE );

   var maxAttributes = gl.getParameter( gl.MAX_VERTEX_ATTRIBS );
   var maxVertexUniforms = gl.getParameter( gl.MAX_VERTEX_UNIFORM_VECTORS );
   var maxVaryings = gl.getParameter( gl.MAX_VARYING_VECTORS );
   var maxFragmentUniforms = gl.getParameter( gl.MAX_FRAGMENT_UNIFORM_VECTORS );
   /* 1）gl_MaxVertexAttribs

    指示支持的Vertex Attribute的最大值，其值最小为8。

    2）gl_MaxVertexUniformVectors

    指示Vertex Shader最多支持多少个vec4 uniform，其值最小为128。

    3）gl_MaxVaryingVectors

    Vertex Shader最多可以输出多少个vec4变量，其值最小为8。

    4）gl_MaxVertexTextureImageUnits

    Vertex Shader最多支持多少个纹理单元，其值最小为0，即不支持顶点纹理获取。

    5）gl_MaxCombinedTextureImageUnits

    Vertex Shader和Fragment Shader总共最多支持多少个纹理单元，其值最小为8。


    4. 精度限制 （Precision Qualifiers）

    在Vertex Shader中，如果没有指定默认的精度，则float和int的精度为highp。
    在Vertex Shader中，除color和lighting计算为mediump之外，其它的都为highp。*/

   var vertexTextures = maxVertexTextures > 0;
   var floatFragmentTextures = !! extensions.get( 'OES_texture_float' );
   //使用此扩展，纹理的RGBA值可以用32字节的浮点数表示，
   // 详情：https://developer.mozilla.org/zh-CN/docs/Web/API/OES_texture_float
   var floatVertexTextures = vertexTextures && floatFragmentTextures;

   return {

      getMaxAnisotropy: getMaxAnisotropy,
      getMaxPrecision: getMaxPrecision,

      precision: precision,
      logarithmicDepthBuffer: logarithmicDepthBuffer,

      maxTextures: maxTextures,
      maxVertexTextures: maxVertexTextures,
      maxTextureSize: maxTextureSize,
      maxCubemapSize: maxCubemapSize,

      maxAttributes: maxAttributes,
      maxVertexUniforms: maxVertexUniforms,
      maxVaryings: maxVaryings,
      maxFragmentUniforms: maxFragmentUniforms,

      vertexTextures: vertexTextures,
      floatFragmentTextures: floatFragmentTextures,
      floatVertexTextures: floatVertexTextures

   };

}


export { WebGLCapabilities };