three.js BufferGeometryUtils

一個(gè)包含 BufferGeometry 實(shí)例的實(shí)用方法的類(lèi)。

方法

.computeMikkTSpaceTangents ( geometry : BufferGeometry, MikkTSpace : Object, negateSign : Boolean = true ) : Object

• geometry -- BufferGeometry 的實(shí)例。
• MikkTSpace -- examples/jsm/libs/mikktspace.module.js 或 mikktspace npm 包的實(shí)例。在使用前等待 MikkTSpace.ready。
• negateSign -- 是否取反每條切線的符號(hào)分量 (.w)。某些格式的法線貼圖約定是必需的，包括 glTF。

使用 MikkTSpace 算法計(jì)算頂點(diǎn)切線。 MikkTSpace 始終生成相同的切線，并用于大多數(shù)建模工具和法線貼圖面包師。將 MikkTSpace 用于具有法線貼圖的材質(zhì)，因?yàn)椴灰恢碌那芯€可能會(huì)導(dǎo)致法線貼圖中出現(xiàn)細(xì)微的視覺(jué)問(wèn)題，尤其是在鏡像 UV 接縫周?chē)?

與此方法相比，BufferGeometry.computeTangents（一種自定義算法）生成的切線可能與其他軟件中的切線不匹配。自定義算法足以用于 ShaderMaterial 的一般使用，并且可能比 MikkTSpace 更快。

返回原始 BufferGeometry。索引幾何將被取消索引。需要位置、法線和 uv 屬性。

.computeMorphedAttributes ( [param:Mesh | Line | Points object] ) : Object

object -- 網(wǎng)格實(shí)例 |線 |積分。

返回幾何為 BufferGeometry 的變形/蒙皮 Object3D 的當(dāng)前屬性（Position 和 Normal）以及原始屬性：具有 4 個(gè)屬性的對(duì)象：positionAttribute、normalAttribute、morphedPositionAttribute 和 morphedNormalAttribute。有助于光線追蹤或貼花（即，應(yīng)用到具有 BufferGeometry 的變形對(duì)象的 DecalGeometry 將使用原始 BufferGeometry，而不是變形/蒙皮的 BufferGeometry，從而生成不正確的結(jié)果。使用此函數(shù)創(chuàng)建陰影 Object3D 可以正確生成 DecalGeometry） .

.estimateBytesUsed ( geometry : BufferGeometry ) : Number

geometry -- 通過(guò) BufferGeometry 的實(shí)例來(lái)估計(jì)內(nèi)存使用情況。

返回所有用于表示幾何體的屬性所占用的字節(jié)數(shù)。

.interleaveAttributes ( attributes : Array ) : InterleavedBufferAttribute

attributes -- 由 BufferAttribute 實(shí)例組成的數(shù)組。

交叉存儲(chǔ)一組屬性并返回一個(gè)新的對(duì)應(yīng)屬性數(shù)組，這些屬性共享一個(gè) InterleavedBuffer 實(shí)例。所有屬性都必須兼容的該類(lèi)型。如果合并不成功，則該方法返回 null 。

.mergeBufferAttributes ( attributes : Array ) : BufferAttribute

attributes -- 由 BufferAttribute 實(shí)例組成的數(shù)組。

將一組屬性合并為一個(gè)單一的實(shí)例。所有幾何體都必須兼容該屬性，不支持 InterleavedBufferAttributes 。 如果合并不成功，則該方法返回 null 。

.mergeBufferGeometries ( geometries : Array, useGroups : Boolean ) : BufferGeometry

geometries -- 由 BufferGeometry 實(shí)例的數(shù)組。
useGroups -- 是否要為了合并幾何體而產(chǎn)生組。

將一組幾何體合并到一個(gè)實(shí)例中。所有幾何體都必須兼容該屬性。 如果合并不成功，則該方法返回 null。

.mergeGroups ( geometry : BufferGeometry ) : BufferGeometry

geometry -- 要合并組的 BufferGeometry 實(shí)例。

合并給定幾何體的組。

.mergeVertices ( geometry : BufferGeometry, tolerance : Number ) : BufferGeometry

geometry -- 用于合并頂點(diǎn)的 BufferGeometry 實(shí)例。
tolerance -- 要合并的頂點(diǎn)屬性之間允許的最大差異。 默認(rèn)為 1e-4。

返回一個(gè)新的 BufferGeometry ，其中包含將所有（在容差范圍內(nèi)的）具有相似屬性的頂點(diǎn)合并而成的頂點(diǎn)。

.toCreasedNormals ( geometry : BufferGeometry, creaseAngle : Number ) : BufferGeometry

geometry -- 輸入幾何。

creaseAngle -- 折痕角度。

創(chuàng)建一個(gè)新的非索引幾何體，除了以大于折痕角度的角度相交的面外，所有地方都具有平滑的法線。

.toTrianglesDrawMode ( geometry : BufferGeometry, drawMode : TrianglesDrawMode ) : BufferGeometry

geometry -- BufferGeometry 的實(shí)例。

drawMode -- 給定幾何圖形的繪制模式。有效輸入為 THREE.TriangleStripDrawMode 和 THREE.TriangleFanDrawMode。

返回基于 THREE.TrianglesDrawMode 繪制模式的新索引幾何。此模式對(duì)應(yīng)于 gl.TRIANGLES WebGL 原語(yǔ)。

源碼

examples/jsm/utils/BufferGeometryUtils.js