MaterialAppearance

new Cesium.MaterialAppearance(options)
Scene/MaterialAppearance.js 50

支持材质着色的任意几何图形的外观（与EllipsoidSurfaceAppearance相反）。

Name Type Description

options

Object

optional 具有以下属性的对象：

Name	Type	Default	Description
`flat`	Boolean	`false`	optional 当`true`时，在片段着色器中使用了平面着色，这意味着没有考虑到光照。
`faceForward`	Boolean	`!options.closed`	optional 当 `true`时，片段着色器会根据需要翻转表面法线，以确保法线面对观察者，避免出现黑斑。当几何图形的两侧都应像`WallGeometry` 一样着色时，这很有用。
`translucent`	Boolean	`true`	optional 当`true`时，几何图形应该是半透明的，因此`MaterialAppearance#renderState`启用了alpha混合。
`closed`	Boolean	`false`	optional 当`true`时，几何图形将被关闭，因此`MaterialAppearance#renderState`启用了背面剔除。
`materialSupport`	MaterialAppearance.MaterialSupport	`MaterialAppearance.MaterialSupport.TEXTURED`	optional 支持的材质类型。
`material`	Material	`Material.ColorType`	optional 用于确定片元颜色的材质。
`vertexShaderSource`	String		optional 可选的GLSL顶点着色器源覆盖默认的顶点着色器。
`fragmentShaderSource`	String		optional 可选的GLSL片段着色器源覆盖默认的片段着色器。
`renderState`	RenderState		optional 可选的渲染状态来覆盖默认的渲染状态。

Example:

var 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:

Cesium Sandcastle Material Appearance Demo

See:

Fabric

Members

readonlyclosed : Boolean
Scene/MaterialAppearance.js 148

当true时，几何图形将被关闭，因此MaterialAppearance#renderState启用了后表面剔除。

Default Value: false

readonlyfaceForward : Boolean
Scene/MaterialAppearance.js 214

当 true时，片段着色器会根据需要翻转表面法线，以确保法线面对观察者，避免出现黑斑。当几何图形的两侧都应像WallGeometry 一样着色时，这很有用。

Default Value: true

readonlyflat : Boolean
Scene/MaterialAppearance.js 197

当true时，在片段着色器中使用了平面着色，这意味着没有考虑到光照。

Default Value: false

readonlyfragmentShaderSource : String
Scene/MaterialAppearance.js 114

片段着色器的GLSL源代码。完整的片段着色器源是根据MaterialAppearance#material、MaterialAppearance#flat和MaterialAppearance#faceForward构建的。使用MaterialAppearance#getFragmentShaderSource获得完整的源代码。

material : Material
Scene/MaterialAppearance.js 66

用于确定片元颜色的材质。与其他MaterialAppearance属性不同，它不是只读的，所以外观的材质可以动态改变。

Default Value: Material.ColorType

See:

Fabric

readonlymaterialSupport : MaterialAppearance.MaterialSupport
Scene/MaterialAppearance.js 164

此实例支持的材质类型。这影响了所需的VertexFormat和顶点、片段着色器的复杂性。

Default Value: MaterialAppearance.MaterialSupport.TEXTURED

readonlyrenderState : Object
Scene/MaterialAppearance.js 132

渲染几何图形时的WEBGL状态。

可以在构造MaterialAppearance实例时显式定义渲染状态，也可以通过MaterialAppearance#半透明和MaterialAppearance#closed隐式设置渲染状态。

translucent : Boolean
Scene/MaterialAppearance.js 75

当true时，几何图形应该是半透明的。

Default Value: true

readonlyvertexFormat : VertexFormat
Scene/MaterialAppearance.js 181

与此外观实例兼容的VertexFormat。几何图形可以有更多的顶点属性，而且仍然是兼容的——以潜在的性能成本为代价——但它不能有更少的顶点属性。

Default Value: MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat

readonlyvertexShaderSource : String
Scene/MaterialAppearance.js 99

顶点着色器的GLSL源代码。

Methods

getFragmentShaderSource() → String
Scene/MaterialAppearance.js 228

创建完整的GLSL片段着色源。对于MaterialAppearance，这是从MaterialAppearance#fragmentShaderSource、MaterialAppearance#material、MaterialAppearance#flat、MaterialAppearance#faceForward派生出来的。

Returns:

完整的GLSL片段着色器。

getRenderState() → Object
Scene/MaterialAppearance.js 245

创建渲染状态。这不是最终的渲染状态实例；相反，它可以包含与上下文中创建的呈现状态相同的渲染状态属性的子集。

Returns:

渲染的状态。

isTranslucent() → Boolean
Scene/MaterialAppearance.js 236

根据MaterialAppearance#translucent和Material#isTranslucent确定几何图形是否为半透明。

Returns:

如果外观是半透明的true。