MaterialAppearance

new Cesium.MaterialAppearance ( options )

支持材质着色的任意几何体的外观(例如,与 EllipsoidSurfaceAppearance 相对)。
Name Type Description
options Object 具有以下属性的 可选 对象:
姓名 类型 默认 描述
flat 布尔值 false 可选 当为 true 时,片段着色器中使用平面着色,这意味着不考虑光照。
faceForward 布尔值 !options.closed 可选 true 时,片段着色器根据需要翻转表面法线,以确保法线面向观察者以避免黑点。当几何图形的两侧都应像 WallGeometry 一样着色时,这很有用。
translucent 布尔值 true 可选 true 时,几何体应该是半透明的,所以 MaterialAppearance#renderState 启用了 alpha 混合。
closed 布尔值 false 可选 true 时,几何体应该是关闭的,所以 MaterialAppearance#renderState 启用了背面剔除。
materialSupport MaterialAppearance.MaterialSupportType MaterialAppearance.MaterialSupport.TEXTURED 可选 将支持的材料类型。
material 材料 Material.ColorType 可选 用于确定片段颜色的材质。
vertexShaderSource 细绳 optional 可选的 GLSL 顶点着色器源,用于覆盖默认顶点着色器。
fragmentShaderSource 细绳 optional 可选的 GLSL 片段着色器源,用于覆盖默认片段着色器。
renderState 目的 optional 可选的渲染状态,用于覆盖默认渲染状态。
Example:
const primitive = new Cesium.Primitive({
  geometryInstances : new Cesium.GeometryInstance({
    geometry : new Cesium.WallGeometry({
            materialSupport :  Cesium.MaterialAppearance.MaterialSupport.BASIC.vertexFormat,
      // ...
    })
  }),
  appearance : new Cesium.MaterialAppearance({
    material : Cesium.Material.fromType('Color'),
    faceForward : true
  })

});
Demo:
See:

Namespaces

MaterialSupport

Members

readonly closed : Boolean

当为 true 时,几何体应该是关闭的,因此 MaterialAppearance#renderState 启用了背面剔除。如果查看者进入几何图形,它将不可见。
Default Value: false

readonly faceForward : Boolean

当为 true 时,片段着色器会根据需要翻转表面法线,以确保法线面向观察者以避免黑点。当几何图形的两侧都应像 WallGeometry 一样着色时,这很有用。
Default Value: true

readonly flat : Boolean

当为 true 时,片段着色器中使用平面着色,这意味着不考虑光照。
Default Value: false

readonly fragmentShaderSource : String

片段着色器的 GLSL 源代码。完整的片段着色器源是根据 MaterialAppearance#material MaterialAppearance#flat MaterialAppearance#faceForward 。使用 MaterialAppearance#getFragmentShaderSource 获取完整的源代码。
用于确定片段颜色的材料。与其他 MaterialAppearance 属性不同,这不是只读的,因此外观的材质可以即时更改。
Default Value: Material.ColorType
See:
此实例支持的材质类型。这会影响所需的 VertexFormat 以及顶点和片段着色器的复杂性。
Default Value: MaterialAppearance.MaterialSupport.TEXTURED

readonly renderState : Object

渲染几何图形时使用的 WebGL 固定功能状态。

渲染状态可以在构造 MaterialAppearance 实例时显式定义,也可以通过 MaterialAppearance#translucent MaterialAppearance#closed 隐式设置。

当为 true 时,几何体应该是半透明的。
Default Value: true
此外观实例兼容的 VertexFormat 。一个几何图形可以有更多的顶点属性并且仍然是兼容的——以潜在的性能成本为代价——但它不能少。
Default Value: MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat

readonly vertexShaderSource : String

顶点着色器的 GLSL 源代码。

Methods

getFragmentShaderSource () String

Returns:
完整的 GLSL 片段着色器源。

getRenderState () Object

创建渲染状态。这不是最终的渲染状态实例;相反,它可以包含与在上下文中创建的渲染状态相同的渲染状态属性的子集。
Returns:
渲染状态。

isTranslucent () Boolean

根据 MaterialAppearance#translucent Material#isTranslucent 确定几何体是否半透明。
Returns:
如果外观是半透明的,则为 true

Type Definitions

Cesium.MaterialAppearance.MaterialSupportType

Properties:
Name Type Description
vertexFormat VertexFormat
vertexShaderSource String
fragmentShaderSource String