Shader cesium中材质

Shader

首先，在本文开始前，我们先普及一下材质的概念，这里推荐材质，普及材质的内容都是截取自该网站，我觉得他写的已经够好了。在开始普及概念前，推荐一首我此刻想到的歌《光---陈粒》。

在真实世界里，每个物体会对光产生不同的反应。钢看起来比陶瓷花瓶更闪闪发光，一个木头箱子不会像钢箱子一样对光产生很强的反射。每个物体对镜面高光也有不同的反应。有些物体不会散射(Scatter)很多光却会反射(Reflect)很多光，结果看起来就有一个较小的高光点(Highlight)，有些物体散射了很多，它们就会产生一个半径更大的高光。如果我们想要在OpenGL中模拟多种类型的物体，我们必须为每个物体分别定义材质(Material)属性。

我们指定一个物体和一个光的颜色来定义物体的图像输出，并使之结合环境(Ambient)和镜面强度(Specular Intensity)元素。当描述物体的时候，我们可以使用3种光照元素：环境光照(Ambient Lighting)、漫反射光照(Diffuse Lighting)、镜面光照(Specular Lighting)定义一个材质颜色。通过为每个元素指定一个颜色，我们已经对物体的颜色输出有了精密的控制。现在把一个镜面高光元素添加到这三个颜色里，这是我们需要的所有材质属性：

struct Material
{vec3 ambient;vec3 diffuse;vec3 specular;float shininess;
};

以上是对材质的一个最简单概括，我们下面进入Cesium的环节。先来看看Cesium在Shader中对Material的定义：

struct czm_material
{vec3 diffuse;float specular;float shininess;vec3 normal;vec3 emission;float alpha;
};

和上面给出的结构体大致相同，区别是少了环境光ambient，但多了法向量normal，自发光emission和alpha，我们带着这个疑问看一下Cesium处理材质的片段着色器：

varying vec3 v_positionEC;
varying vec3 v_normalEC;
void main()
{vec3 positionToEyeEC = -v_positionEC;vec3 normalEC = normalize(v_normalEC);
#ifdef FACE_FORWARDnormalEC = faceforward(normalEC, vec3(0.0, 0.0, 1.0), -normalEC);
#endifczm_materialInput materialInput;materialInput.normalEC = normalEC;materialInput.positionToEyeEC = positionToEyeEC;czm_material material = czm_getDefaultMaterial(materialInput);gl_FragColor = czm_phong(normalize(positionToEyeEC), material);
}

此时的坐标系是以相机为中心点，首先获取当前点的位置和法向量，通过czm_getMaterial获取默认的一个材质对象，gl_FragColor通过czm_phong方法得到对应的颜色。对于phong，在OpenGL SuperBible里面有详细的说明，大概就是通过material的属性，根据光的位置和光的颜色，最终计算出在该点当前环境和自身材质的影响下对应的颜色。我们来看看czm_phong的实现：

vec4 czm_phong(vec3 toEye, czm_material material)
{float diffuse = czm_private_getLambertDiffuseOfMaterial(vec3(0.0, 0.0, 1.0), material);if (czm_sceneMode == czm_sceneMode3D) {diffuse += czm_private_getLambertDiffuseOfMaterial(vec3(0.0, 1.0, 0.0), material);}float specular = czm_private_getSpecularOfMaterial(czm_sunDirectionEC, toEye, material) + czm_private_getSpecularOfMaterial(czm_moonDirectionEC, toEye, material);vec3 materialDiffuse = material.diffuse * 0.5;vec3 ambient = materialDiffuse;vec3 color = ambient + material.emission;color += materialDiffuse * diffuse;color += material.specular * specular;return vec4(color, material.alpha);
}

如上是phong颜色计算的算法，我并没有给出getLambertDiffuse和getSpecular的具体代码，都是光的基本物理规律。这里要说的是getLambertDiffuse的参数，如果是球面物体时，会调用czm_private_phong，此时参数为czm_sunDirectionEC，也就是太阳的位置，而这里认为光源的位置是靠近相机的某一个点，另外，环境光ambient默认是反射光的一半，这个也说的过去，最后我们看到最终颜色的alpha位是material.alpha。

上面是Shader中涉及到材质的一个最简过程：材质最终影响的是片段着色器中的颜色gl_FragColor，而所有czm_开头的都是Cesium内建的方法和对象，Cesium已经帮我们提供好了光学模型和计算方法，并不需要我们操心，而我们要做的，就是指定对应物体的材质属性，通过修改material中的属性值，来影响最终的效果。所以，接下来的问题就是如何指定物体的材质属性。

材质的风格有很多种，形状也不尽相同，线面各异，为此，Cesium提供了Material对象，来方便我们设置材质。

Fabric

我们先来看看Cesium都提供了哪些内建材质类型，以及如何创建对应的Material，我也是参考的Cesium在github wike上对Fabric的介绍，更详细的内容可以自己去看。在Cesium中，Fabric是描述材质的一种json格式。材质可以很简单，就是对象表面的一个贴图，也可以是一个图案，比如条形或棋盘形。

比如ImageType类型，Cesium提供了如下两种方式来设置：

// 方法一
primitive.appearance.material = new Cesium.Material({fabric : {type : 'Image',uniforms : {image : '../images/Cesium_Logo_Color.jpg'}}
});
// 方法二
primitive.appearance..material = Material.fromType('Image');
primitive.appearance..uniforms.image = 'image.png';

Cesium默认提供了十八个类型：

ColorType
ImageType
DiffuseMapType
AlphaMapType
SpecularMapType
EmissionMapType
BumpMapType
NormalMapType
GridType
StripeType
CheckerboardType
DotType
WaterType
RimLightingType
FadeType
PolylineArrowType
PolylineGlowType
PolylineOutlineType

当然，Cesium支持多个Type的叠加效果，如下是DiffuseMap和NormalMap的一个叠加，components中指定material中diffuse、specular、normal的映射关系和值：

primitive.appearance.material = new Cesium.Material({fabric : {materials : {applyDiffuseMaterial : {type : 'DiffuseMap',uniforms : {image : '../images/bumpmap.png'}},normalMap : {type : 'NormalMap',uniforms : {image : '../images/normalmap.png',strength : 0.6}}},components : {diffuse : 'diffuseMaterial.diffuse',specular : 0.01,normal : 'normalMap.normal'}}
});

当然，这些都满足不了你的欲望？你也可以自定义一个自己的MaterialType，我们先了解Cesium.Material的内部实现后，再来看看自定义Material。

Material

用户通常只需要指定type，uniforms，components三个属性，构建一个Fabric的JSON。这是因为Material在初始化时，会加载上述默认的十八个类型，比如对应的ColorType代码：

Material.ColorType = 'Color';
Material._materialCache.addMaterial(Material.ColorType, {fabric : {type : Material.ColorType,uniforms : {color : new Color(1.0, 0.0, 0.0, 0.5)},components : {diffuse : 'color.rgb',alpha : 'color.a'}},translucent : function(material) {return material.uniforms.color.alpha < 1.0;}
});
// 创建material
polygon.material = Cesium.Material.fromType('Color');
polygon.material.uniforms.color = new Cesium.Color(1.0, 1.0, 0.0, 1.0);

其他的类型也大概相同，在初始化的时候已经全部构建。因此，用户在执行创建时，已经有了一个ColorMaterial，只是对里面的一些属性修改为自己的期望值的过程。我们具体Material.fromType的具体内容：

Material.fromType = function(type, uniforms) {var material = new Material({fabric : {type : type}});return material;
};function Material(options) {initializeMaterial(options, this);if (!defined(Material._uniformList[this.type])) {Material._uniformList[this.type] = Object.keys(this._uniforms);}
}function initializeMaterial(options, result) {var cachedMaterial = Material._materialCache.getMaterial(result.type);createMethodDefinition(result);createUniforms(result);// translucent
}

initializeMaterial则是其中的重点，里面有三个关键点：1createMethodDefinition，2createUniforms，3translucent，我们来看看都做了什么

function createMethodDefinition(material) {// 获取components属性// ColorType:{ diffuse : 'color.rgb', alpha : 'color.a'}var components = material._template.components;var source = material._template.source;if (defined(source)) {material.shaderSource += source + '\n';} else {material.shaderSource += 'czm_material czm_getMaterial(czm_materialInput materialInput)\n{\n';material.shaderSource += 'czm_material material = czm_getDefaultMaterial(materialInput);\n';if (defined(components)) {for ( var component in components) {if (components.hasOwnProperty(component)) {// 根据components中的属性，修改Material中对应属性的获取方式material.shaderSource += 'material.' + component + ' = ' + components[component] + ';\n';}}}// 封装得到片段着色器中获取material的函数material.shaderSource += 'return material;\n}\n';}
}

如上是Key1的作用，拼装出片段着色器中获取material的函数，如果Type是Color下，获取的函数代码如下：

czm_material czm_getMaterial(czm_materialInput materialInput)
{czm_material material = czm_getDefaultMaterial(materialInput);material.diffuse = color.rgb;material.alpha = color.a;return material;
}

可以对照ColorType的FabricComponents属性，对号入座。下面就是对Fabric的uniforms属性的解析过程了：createUniforms。这里主要有两个作用，第一，根据uniforms，在片源着色器中声明对应的uniform变量，比如ColorType中uniform对应的color变量，则需要声明该变量，当然cesium做了一个特殊的处理，给他们一个标号，保证唯一：更新后的代码如下：

uniform vec4 color_0;
czm_material czm_getMaterial(czm_materialInput materialInput)
{czm_material material = czm_getDefaultMaterial(materialInput);material.diffuse = color_0.rgb;material.alpha = color_0.a;return material;
}

第二个作用是为后面的uniformMap做准备，声明了变量了，当然需要准备好该变量的赋值，建立好这个key-value的过程，保存到material._uniforms数组中：

function createUniform(material, uniformId) {// 根据变量的类型，建立对应的return value方法if (uniformType === 'sampler2D') {material._uniforms[newUniformId] = function() {return material._textures[uniformId];};material._updateFunctions.push(createTexture2DUpdateFunction(uniformId));} else if (uniformType === 'samplerCube') {material._uniforms[newUniformId] = function() {return material._textures[uniformId];};material._updateFunctions.push(createCubeMapUpdateFunction(uniformId));} else if (uniformType.indexOf('mat') !== -1) {var scratchMatrix = new matrixMap[uniformType]();material._uniforms[newUniformId] = function() {return matrixMap[uniformType].fromColumnMajorArray(material.uniforms[uniformId], scratchMatrix);};} else {material._uniforms[newUniformId] = function() {return material.uniforms[uniformId];};}
}

createUniforms方法后则是对translucent的处理，这个会影响到Pimitive创建RenderState，以及渲染队列的设置。将Fabric中的translucent方法保存在material._translucentFunctions中。

Primitive

此时，我们已经创建好一个color类型的Material，将其赋给对应的Primitive，代码如下：

primitive.appearance.material = Cesium.Material.fromType('Color');

这里出现了一个新的的对象：Appearance。这里，Material只是负责片段着色器中，材质部分的代码，而Appearance则负责该Primitvie整个Shader的代码，包括顶点着色器和片段着色器两个部分，同时，需要根据Appearance的状态来设置对应的RenderState，可以说Appearance是在Material之上的又一层封装。一共有MaterialAppearance、EllipsoidSurfaceAppearance等六类，大同小异，每个对象的属性值不同，但逻辑上统一有Appearance来负责。我们看如下一个Primitive的创建：

var rectangle = scene.primitives.add(new Cesium.Primitive({geometryInstances : new Cesium.GeometryInstance({geometry : new Cesium.RectangleGeometry({rectangle : Cesium.Rectangle.fromDegrees(-120.0, 20.0, -60.0, 40.0),vertexFormat : Cesium.EllipsoidSurfaceAppearance.VERTEX_FORMAT})}),appearance : new Cesium.EllipsoidSurfaceAppearance({aboveGround : false})
}));

如上创建的是一个EllipsoidSurfaceAppearance，创建时如果没有指定Material，则内部默认采用ColorTyoe的材质。当执行Primitive.update时，Appearance的就发挥了自己的价值：

Primitive.prototype.update = function(frameState) {createRenderStates(this, context, appearance, twoPasses);createShaderProgram(this, frameState, appearance);createCommands(this, appearance, material, translucent, twoPasses, this._colorCommands, this._pickCommands, frameState);
}

首先Appearance基类提供了默认的defaultRenderState，也提供了getRenderState的方法，如下：

Appearance.getDefaultRenderState = function(translucent, closed, existing) {var rs = {depthTest : {enabled : true}};if (translucent) {rs.depthMask = false;rs.blending = BlendingState.ALPHA_BLEND;}if (closed) {rs.cull = {enabled : true,face : CullFace.BACK};}if (defined(existing)) {rs = combine(existing, rs, true);}return rs;
};Appearance.prototype.getRenderState = function() {var translucent = this.isTranslucent();var rs = clone(this.renderState, false);if (translucent) {rs.depthMask = false;rs.blending = BlendingState.ALPHA_BLEND;} else {rs.depthMask = true;}return rs;
};

然后，各个子类按照自己的需要，看是否使用基类的方法，还是自己有特殊用处，比如EllipsoidSurfaceAppearance类：

function EllipsoidSurfaceAppearance(options) {this._vertexShaderSource = defaultValue(options.vertexShaderSource, EllipsoidSurfaceAppearanceVS);this._fragmentShaderSource = defaultValue(options.fragmentShaderSource, EllipsoidSurfaceAppearanceFS);this._renderState = Appearance.getDefaultRenderState(translucent, !aboveGround, options.renderState);
}
EllipsoidSurfaceAppearance.prototype.getRenderState = Appearance.prototype.getRenderState;function createRenderStates(primitive, context, appearance, twoPasses) {var renderState = appearance.getRenderState();
}

这样，EllipsoidSurfaceAppearance采用自己的顶点着色器和片段着色器的代码，但RenderState和getRenderState方法都直接用的基类的，因此，当primitive调用createRenderStates方法时，尽管当前的appearance可能类型不一，但确保都有统一一套调用接口，最终创建满足当前需要的RS，当然，这里主要是translucent的区别。

接着，就是创建ShaderProgram：

function createShaderProgram(primitive, frameState, appearance) {var vs = primitive._batchTable.getVertexShaderCallback()(appearance.vertexShaderSource);var fs = appearance.getFragmentShaderSource();
}Appearance.prototype.getFragmentShaderSource = function() {var parts = [];if (this.flat) {parts.push('#define FLAT');}if (this.faceForward) {parts.push('#define FACE_FORWARD');}if (defined(this.material)) {parts.push(this.material.shaderSource);}parts.push(this.fragmentShaderSource);return parts.join('\n');
};

这里代码比较清楚，就是通过Appearance获取vs和fs，这里多了一个batchTable，这是因为该Primitive可能是批次的封装，因此需要把batch部分的vs和appearance的vs合并，batchTable后面有时间的话，在单独介绍。这里可以看到getFragmentShaderSource，增加了一下宏，同时，在Appearance中，不仅有自己的fragmentShaderSource，同时也把我们之前在Material中封装的material.shaderSource也追加进去。真的是海纳百川的历程。

这样，就来到最后一步，构建Command:

function createCommands(primitive, appearance, material, translucent, twoPasses, colorCommands, pickCommands, frameState) {var uniforms = combine(appearanceUniformMap, materialUniformMap);uniforms = primitive._batchTable.getUniformMapCallback()(uniforms);var pass = translucent ? Pass.TRANSLUCENT : Pass.OPAQUE;// ……colorCommand.uniformMap = uniforms;colorCommand.pass = pass;//……
}

可见，Material的uniforms合并后绑定到了command的uniformMap中，另外translucent也用来判断渲染队列。至此，Material->Appearance->Renderer的整个过程就结束了。可见，Material主要涉及到初始化和Primitive.update部分。

当然，之前我们介绍过，通过创建Entity的方式，也可以通过DataSourceDisplay这个过程最终创建Primitive并添加到PrimitiveCollection这种方式。这和直接构建Primitive基本相似，只是多绕了一圈。当然，这一圈也不是白绕的，因为会做批次的处理，合并多个风格相似的Geometry。当然，这就牵扯到Batch，Appearance以及MaterialProperty之间的关系我们后续再介绍这种创建方式下的不同之处。

关注公众号，不定期更新