Cesium原理篇：Material【转】
https://www.cnblogs.com/fuckgiser/p/6171245.html
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_FORWARD
normalEC = faceforward(normalEC, vec3(0.0, 0.0, 1.0), -normalEC);
#endif
czm_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之间的关系我们后续再介绍这种创建方式下的不同之处。
