GeometryPipeline

幾何圖形的內(nèi)容管道函數(shù)。

See:

Geometry

Methods

(static) compressVertices(geometry) → {Geometry}

壓縮并打包幾何體“正常”屬性值以保存內(nèi)存。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

Example

geometry = bmgl.GeometryPipeline.compressVertices(geometry);

(static) computeNormal(geometry) → {Geometry}

計(jì)算包含TRIANGLES的幾何體的每個(gè)頂點(diǎn)法線，方法是平均與頂點(diǎn)關(guān)聯(lián)的所有三角形的法線。結(jié)果是一個(gè)新的normal屬性添加到幾何圖形中。這假定為逆時(shí)針纏繞順序。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

Example

bmgl.GeometryPipeline.computeNormal(geometry);

Throws

DeveloperError : geometry.indexs長度必須大于0且是3的倍數(shù)。
DeveloperError : geometry.primitiveType必須為PrimitiveType.TRIANGLES。

(static) computeTangentAndBitangent(geometry) → {Geometry}

為包含TRIANGLES的幾何體計(jì)算每個(gè)頂點(diǎn)切線和位切線。結(jié)果是添加到幾何體的新tangent和bitangent屬性。這假定為逆時(shí)針纏繞順序。

基于Eric Lengyel的計(jì)算任意網(wǎng)格的切線空間基向量。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

Example

bmgl.GeometryPipeline.computeTangentAndBiTangent(geometry);

Throws

DeveloperError : geometry.indexs長度必須大于0且是3的倍數(shù)。
DeveloperError : geometry.primitiveType必須為PrimitiveType.TRIANGLES。

(static) createAttributeLocations(geometry) → {Object}

創(chuàng)建將屬性名稱映射到唯一位置（索引）以匹配頂點(diǎn)屬性和著色程序的對象。

Parameters:

geometry (Geometry) 未修改的幾何圖形，用于創(chuàng)建對象。

Example

var attributeLocations = bmgl.GeometryPipeline.createAttributeLocations(geometry);
// Example output
// {
//   'position' : 0,
//   'normal' : 1
// }

(static) createLineSegmentsForVectors(geometry, attributeName, length) → {Geometry}

創(chuàng)建一個(gè)新的Geometry，其中LINES表示提供的幾何圖形的提供屬性（attributeName）。這用于可視化向量屬性，如法線、切線和位切線。

Parameters:

geometry (Geometry) 具有屬性的Geometry實(shí)例。

attributeName (String) (default 'normal') 屬性的名稱。

length (Number) (default 10000.0) 每段線的長度，單位為米。這可以是負(fù)的，使向量指向相反的方向。

Example

var geometry = bmgl.GeometryPipeline.createLineSegmentsForVectors(instance.geometry, 'bitangent', 100000.0);

Throws

DeveloperError : geometry.attributes必須具有與attribute name參數(shù)同名的屬性。

(static) encodeAttribute(geometry, attributeName, attributeHighName, attributeLowName) → {Geometry}

將浮點(diǎn)幾何體屬性值編碼為兩個(gè)單獨(dú)的屬性，以提高渲染精度。

這通常用于創(chuàng)建高精度位置頂點(diǎn)屬性。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

attributeName (String) 屬性的名稱。

attributeHighName (String) 編碼高位的屬性名稱。

attributeLowName (String) 已編碼低位的屬性名稱。

Example

geometry = bmgl.GeometryPipeline.encodeAttribute(geometry, 'position3D', 'position3DHigh', 'position3DLow');

Throws

DeveloperError : 幾何圖形必須具有與attributeName參數(shù)匹配的屬性。
DeveloperError : 屬性componentdatatype必須是componentdatatype.double。

(static) fitToUnsignedShortIndices(geometry) → {Array.<Geometry>}

如有必要，將幾何拆分為多個(gè)幾何圖形，以確保indices中的索引適合無符號的短褲。當(dāng)不支持無符號int索引時(shí)，這用于滿足WebGL的要求。

如果幾何體沒有任何indices，則此函數(shù)無效。

Parameters:

geometry (Geometry) 要拆分為多個(gè)幾何圖形的幾何圖形。

Example

var geometries = bmgl.GeometryPipeline.fitToUnsignedShortIndices(geometry);

Throws

DeveloperError : geometry.primitivetype必須等于primitivetype.triangles、primitivetype.lines或primitivetype.points
DeveloperError : 所有幾何屬性列表必須具有相同數(shù)量的屬性。

(static) projectTo2D(geometry, attributeName, attributeName3D, attributeName2D, projection) → {Geometry}

將幾何圖形的3Dposition屬性投影到二維，將position屬性替換為單獨(dú)的position3D和position2D屬性。

如果幾何體沒有position，則此函數(shù)無效。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

attributeName (String) 屬性的名稱。

attributeName3D (String) 3D中屬性的名稱。

attributeName2D (String) 二維中屬性的名稱。

projection (Object) (default new GeographicProjection()) 要使用的投影。

Example

geometry = bmgl.GeometryPipeline.projectTo2D(geometry, 'position', 'position3D', 'position2D');

Throws

DeveloperError : 幾何圖形必須具有與attributeName參數(shù)匹配的屬性。
DeveloperError : 屬性componentdatatype必須是componentdatatype.double。
DeveloperError : 無法將點(diǎn)投影到二維。

(static) reorderForPostVertexCache(geometry, cacheCapacity) → {Geometry}

重新排序幾何體的indices以通過使用tipsify算法從GPU的后頂點(diǎn)著色緩存獲得更好的性能。如果幾何圖形primitiveType不是TRIANGLES或幾何圖形沒有indices，則此功能無效。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

cacheCapacity (Number) (default 24) 可保留在GPU頂點(diǎn)緩存中的頂點(diǎn)數(shù)。

Example

geometry = bmgl.GeometryPipeline.reorderForPostVertexCache(geometry);

Throws

DeveloperError : cacheCapacity必須大于2。

See:

GeometryPipeline.reorderForPreVertexCache
Fast Triangle Reordering for Vertex Locality and Reduced Overdraw by Sander, Nehab, and Barczak

(static) reorderForPreVertexCache(geometry) → {Geometry}

重新排序幾何體的屬性和indices以從GPU的前頂點(diǎn)著色緩存獲得更好的性能。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

Example

geometry = bmgl.GeometryPipeline.reorderForPreVertexCache(geometry);

Throws

DeveloperError : geometry.attributes中的每個(gè)屬性數(shù)組必須具有相同數(shù)量的屬性。

See:

GeometryPipeline.reorderForPostVertexCache

(static) toWireframe(geometry) → {Geometry}

將幾何圖形的三角形索引轉(zhuǎn)換為線條索引。如果幾何圖形有indices且其primitiveType為TRIANGLES、TRIANGLE_STRIP、TRIANGLE_FAN，則將其轉(zhuǎn)換為LINES；否則，不會(huì)更改幾何圖形。

這通常用于創(chuàng)建用于可視化調(diào)試的線框幾何圖形。

Parameters:

geometry (Geometry) 要修改的幾何圖形。

Example

geometry = bmgl.GeometryPipeline.toWireframe(geometry);

Throws

DeveloperError : geometry.primitivetype必須是三角形、三角形條帶或三角形扇。

(static) transformToWorldCoordinates(instance) → {GeometryInstance}

將幾何體實(shí)例轉(zhuǎn)換為世界坐標(biāo)。這會(huì)將實(shí)例的modelMatrix更改為Matrix4.IDENTITY，并轉(zhuǎn)換以下屬性（如果存在）：position、normal、tangent和bitangent。

Parameters:

instance (GeometryInstance) 要修改的幾何體實(shí)例。

Example

bmgl.GeometryPipeline.transformToWorldCoordinates(instance);