PerInstanceColorAppearance

new SuperMap3D.PerInstanceColorAppearance(options)

这允许使用同一个Primitive绘制多个几何体实例，每个实例都有不同的颜色，如下面第二个示例所示。
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 时，几何体将呈现半透明效果，因此PerInstanceColorAppearance#renderState 将启用 alpha 混合。
closed Boolean false optional 为 true 时，几何体将被关闭，因此PerInstanceColorAppearance#renderState 将启用背面剔除。
vertexShaderSource String optional 可选的 GLSL 顶点着色器源，用于覆盖默认的顶点着色器。
fragmentShaderSource String optional 可选的 GLSL 片段着色器源，用于覆盖默认的片段着色器。
renderState RenderState optional 可选的呈现状态，用于覆盖默认呈现状态。
Example:
// A solid white line segment
var primitive = new SuperMap3D.Primitive({
  geometryInstances : new SuperMap3D.GeometryInstance({
    geometry : new SuperMap3D.SimplePolylineGeometry({
      positions : SuperMap3D.Cartesian3.fromDegreesArray([
        0.0, 0.0,
        5.0, 0.0
      ])
    }),
    attributes : {
      color : SuperMap3D.ColorGeometryInstanceAttribute.fromColor(new SuperMap3D.Color(1.0, 1.0, 1.0, 1.0))
    }
  }),
  appearance : new SuperMap3D.PerInstanceColorAppearance({
    flat : true,
    translucent : false
  })
});

// Two rectangles in a primitive, each with a different color
var instance = new SuperMap3D.GeometryInstance({
  geometry : new SuperMap3D.RectangleGeometry({
    rectangle : SuperMap3D.Rectangle.fromDegrees(0.0, 20.0, 10.0, 30.0)
  }),
  attributes : {
    color : new SuperMap3D.Color(1.0, 0.0, 0.0, 0.5)
  }
});

var anotherInstance = new SuperMap3D.GeometryInstance({
  geometry : new SuperMap3D.RectangleGeometry({
    rectangle : SuperMap3D.Rectangle.fromDegrees(0.0, 40.0, 10.0, 50.0)
  }),
  attributes : {
    color : new SuperMap3D.Color(0.0, 0.0, 1.0, 0.5)
  }
});

var rectanglePrimitive = new SuperMap3D.Primitive({
  geometryInstances : [instance, anotherInstance],
  appearance : new SuperMap3D.PerInstanceColorAppearance()
});

Members

staticconstantSuperMap3D.PerInstanceColorAppearance.FLAT_VERTEX_FORMAT : VertexFormat

当PerInstanceColorAppearance#flat为false时，所有PerInstanceColorAppearance实例兼容的VertexFormat这只需要一个位置属性。

staticconstantSuperMap3D.PerInstanceColorAppearance.VERTEX_FORMAT : VertexFormat

与所有PerInstanceColorAppearance实例兼容的VertexFormat顶点格式。这只需要位置和 st 属性。

readonlyclosed : Boolean

为true时，几何体将处于关闭状态，因此PerInstanceColorAppearance#renderState 将启用背面剔除。如果查看器进入该几何体，它将不可见。
Default Value: false

readonlyfaceForward : Boolean

为true时，片段着色器会根据需要翻转表面法线，以确保法线面向观察者，避免出现暗点。 当需要对几何体的两侧（如WallGeometry）进行着色时，这一点非常有用。
Default Value: true

readonlyflat : Boolean

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

readonlyfragmentShaderSource : String

片段着色器的 GLSL 源代码。

material : Material

该属性是 Appearance 界面的一部分，但不会被 PerInstanceColorAppearance 使用，因为它使用的是完全自定义的片段着色器。
Default Value: undefined

readonlyrenderState : Object

渲染几何体时使用的 WebGL 固定函数状态。

渲染状态可以在构建 PerInstanceColorAppearance 实例时显式定义，也可以通过 PerInstanceColorAppearance#translucent 和 PerInstanceColorAppearance#closed 隐式设置。

translucent : Boolean

为 true 时，几何体将呈现半透明效果，因此PerInstanceColorAppearance#renderState 将启用 alpha 混合。
Default Value: true

readonlyvertexFormat : VertexFormat

此外观实例兼容的 VertexFormat 顶点格式。一个几何体可以拥有更多顶点属性，并且仍然是兼容的，但可能要付出性能代价，但不能少。

readonlyvertexShaderSource : String

顶点着色器的 GLSL 源代码。

Methods

getFragmentShaderSource() → String

程序化创建完整的GLSL片段着色器源。对于PerInstanceColorAppearance来说，这是从PerInstanceColorAppearance#fragmentShaderSource、PerInstanceColorAppearance#flat和PerInstanceColorAppearance#faceForward衍生而来。
Returns:
完整的 GLSL 片段着色器源。

getRenderState() → Object

创建一个呈现状态。这不是最终的呈现状态实例；相反，它可以包含与上下文中创建的呈现状态相同的呈现状态属性子集。
Returns:
The render state.

isTranslucent() → Boolean

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