帶有顏色屬性的
new PerInstanceColorAppearance(options)
GeometryInstance實(shí)例的外觀。這允許使用下面第二個(gè)示例中所示的相同Primitive繪制多個(gè)不同顏色的幾何體實(shí)例。
Parameters:
options
(Object)
| Name | Description |
|---|---|
options.flat
Boolean
default false
|
當(dāng)true時(shí)，片段著色中使用平面著色，這意味著不考慮照明。
|
options.faceForward
Boolean
default !options.closed
|
當(dāng)true時(shí)，片段明暗器會(huì)根據(jù)需要翻轉(zhuǎn)曲面法線，以確保法線面向查看器以避免出現(xiàn)黑點(diǎn)。當(dāng)幾何圖形的兩邊都應(yīng)該像WallGeometry那樣加陰影時(shí)，這很有用。
|
options.translucent
Boolean
default true
|
當(dāng)true時(shí)，幾何體將顯示為半透明，因此PerInstanceColorAppearance#renderState啟用了alpha混合。
|
options.closed
Boolean
default false
|
當(dāng)true時(shí)，幾何圖形將關(guān)閉，因此PerInstanceColorAppearance#renderState啟用背面剔除。
|
options.vertexShaderSource
String
|
可選的glsl頂點(diǎn)明暗器源覆蓋默認(rèn)的頂點(diǎn)明暗器。 |
options.fragmentShaderSource
String
|
可選的glsl fragment shader source覆蓋默認(rèn)的fragment shader。 |
options.renderState
RenderState
|
可選的渲染狀態(tài)以覆蓋默認(rèn)的渲染狀態(tài)。 |
Example
// A solid white line segment
var primitive = new bmgl.Primitive({
geometryInstances : new bmgl.GeometryInstance({
geometry : new bmgl.SimplePolylineGeometry({
positions : bmgl.Cartesian3.fromDegreesArray([
0.0, 0.0,
5.0, 0.0
])
}),
attributes : {
color : bmgl.ColorGeometryInstanceAttribute.fromColor(new bmgl.Color(1.0, 1.0, 1.0, 1.0))
}
}),
appearance : new bmgl.PerInstanceColorAppearance({
flat : true,
translucent : false
})
});
// Two rectangles in a primitive, each with a different color
var instance = new bmgl.GeometryInstance({
geometry : new bmgl.RectangleGeometry({
rectangle : bmgl.Rectangle.fromDegrees(0.0, 20.0, 10.0, 30.0)
}),
attributes : {
color : new bmgl.ColorGeometryInstanceAttribute(1.0, 0.0, 0.0, 0.5)
}
});
var anotherInstance = new bmgl.GeometryInstance({
geometry : new bmgl.RectangleGeometry({
rectangle : bmgl.Rectangle.fromDegrees(0.0, 40.0, 10.0, 50.0)
}),
attributes : {
color : new bmgl.ColorGeometryInstanceAttribute(0.0, 0.0, 1.0, 0.5)
}
});
var rectanglePrimitive = new bmgl.Primitive({
geometryInstances : [instance, anotherInstance],
appearance : new bmgl.PerInstanceColorAppearance()
});Members
(static, constant) FLAT_VERTEX_FORMAT : VertexFormat
當(dāng)
PerInstanceColorAppearance#flat為true時(shí)，所有PerInstanceColorAppearance實(shí)例都兼容的VertexFormat。這只需要一個(gè)position屬性。
(static, constant) VERTEX_FORMAT : VertexFormat
(readonly) closed : Boolean
當(dāng)
true時(shí)，幾何圖形將關(guān)閉，因此PerInstanceColorAppearance#renderState啟用背面剔除。如果查看器進(jìn)入幾何圖形，它將不可見。
-
Default Value:
false
(readonly) faceForward : Boolean
當(dāng)
true時(shí)，片段明暗器會(huì)根據(jù)需要翻轉(zhuǎn)曲面法線，以確保法線面向查看器以避免出現(xiàn)黑點(diǎn)。當(dāng)幾何圖形的兩邊都應(yīng)該像WallGeometry那樣加陰影時(shí)，這很有用。
-
Default Value:
true
(readonly) flat : Boolean
當(dāng)
true時(shí)，片段著色中使用平面著色，這意味著不考慮照明。
-
Default Value:
false
(readonly) fragmentShaderSource : String
片段明暗器的glsl源代碼。
material : Material
此屬性是
Appearance接口的一部分，但PerInstanceColorAppearance不使用，因?yàn)槭褂昧送耆远x的片段明暗器。
-
Default Value:
undefined
(readonly) renderState : Object
呈現(xiàn)幾何圖形時(shí)要使用的WebGL固定函數(shù)狀態(tài)。
在構(gòu)造PerInstanceColorAppearance實(shí)例時(shí)，可以顯式定義呈現(xiàn)狀態(tài)，也可以通過PerInstanceColorAppearance#translucent和PerInstanceColorAppearance#closed隱式設(shè)置呈現(xiàn)狀態(tài)。
translucent : Boolean
當(dāng)
true時(shí)，幾何體將顯示為半透明，因此PerInstanceColorAppearance#renderState啟用了alpha混合。
-
Default Value:
true
(readonly) vertexFormat : VertexFormat
此外觀實(shí)例與之兼容的
VertexFormat。幾何體可以有更多的頂點(diǎn)屬性，并且仍然是兼容的（以潛在的性能代價(jià)），但是它不能有更少的頂點(diǎn)屬性。
(readonly) vertexShaderSource : String
頂點(diǎn)明暗器的glsl源代碼。
Methods
getFragmentShaderSource() → {String}
程序創(chuàng)建完整的glsl片段明暗器源。對于
PerInstanceColorAppearance，這是從PerInstanceColorAppearance#fragmentShaderSource、PerInstanceColorAppearance#flat和PerInstanceColorAppearance#faceForward導(dǎo)出的。
創(chuàng)建渲染狀態(tài)。這不是最終的渲染狀態(tài)實(shí)例；相反，它可以包含與上下文中創(chuàng)建的渲染狀態(tài)相同的渲染狀態(tài)屬性的子集。
確定幾何圖形是否基于
PerInstanceColorAppearance#translucent半透明。