Class GeometryUtils

Hierarchy

GeometryUtils

Index

Constructors

Methods

applyTransformation createFaceNormals createFaceTangents createIndices createUVs createVertexNormals createVertexTangents getAABB mergeGeometry normalizeNormals raycast

Constructors

constructor

new GeometryUtils(): GeometryUtils
Returns GeometryUtils

Methods

applyTransformation

applyTransformation(transform: Matrix4x4, positions: AttributeBufferSourceTypes, normals?: AttributeBufferSourceTypes, tangents?: AttributeBufferSourceTypes): void
应用变换矩阵
Parameters
- transform: Matrix4x4
  
  变换矩阵
- positions: AttributeBufferSourceTypes
  
  顶点数据
- Optional normals: AttributeBufferSourceTypes
  
  顶点法线数据
- Optional tangents: AttributeBufferSourceTypes
  
  顶点切线数据
Returns void
- Defined in src/3d/geometrys/GeometryUtils.ts:340

createFaceNormals

createFaceNormals(indices: number[], positions: number[], useFaceWeights?: boolean): {
faceNormals: number[];
faceWeights: number[];
}
计算面法线数据
Parameters
- indices: number[]
  
  顶点索引数据
- positions: number[]
  
  顶点数据
- useFaceWeights: boolean = false
  
  是否计算面权重
Returns {
faceNormals: number[];
faceWeights: number[];
}
- faceNormals: number[]
- faceWeights: number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:271

createFaceTangents

createFaceTangents(indices: ArrayLike<number>, positions: ArrayLike<number>, uvs: ArrayLike<number>, useFaceWeights?: boolean): {
faceTangents: number[];
faceWeights: number[];
}
计算面切线数据
Parameters
- indices: ArrayLike<number>
  
  顶点索引数据
- positions: ArrayLike<number>
  
  顶点数据
- uvs: ArrayLike<number>
  
  uv数据
- useFaceWeights: boolean = false
  
  是否计算面权重
Returns {
faceTangents: number[];
faceWeights: number[];
}
- faceTangents: number[]
- faceWeights: number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:190

createIndices

createIndices(positions: number[]): number[]
根据顶点数量按顺序创建顶点索引
Parameters
- positions: number[]
  
  顶点数据
Returns number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:15

createUVs

createUVs(positions: number[]): number[]
创建循环uv数据
Parameters
- positions: number[]
  
  顶点数据
Returns number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:31

createVertexNormals

createVertexNormals(indices: number[], positions: number[], useFaceWeights?: boolean): number[]
计算顶点法线数据
Parameters
- indices: number[]
  
  顶点索引
- positions: number[]
  
  顶点数据
- useFaceWeights: boolean = false
  
  是否使用面权重计算法线
Returns number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:54

createVertexTangents

createVertexTangents(indices: ArrayLike<number>, positions: ArrayLike<number>, uvs: ArrayLike<number>, useFaceWeights?: boolean): number[]
计算顶点切线数据
Parameters
- indices: ArrayLike<number>
  
  顶点索引
- positions: ArrayLike<number>
  
  顶点数据
- uvs: ArrayLike<number>
  
  uv数据
- useFaceWeights: boolean = false
  
  是否使用面权重计算切线数据
Returns number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:122

getAABB

getAABB(positions: number[], out?: Box3): Box3
获取包围盒
Parameters
- positions: number[]
  
  顶点数据
- out: Box3 = ...
Returns Box3
- Defined in src/3d/geometrys/GeometryUtils.ts:622

mergeGeometry

mergeGeometry(geometrys: {
    indices: number[];
    normals?: number[];
    positions: number[];
    tangents?: number[];
    uvs?: number[];
}[]): {
    indices: number[];
    normals?: number[];
    positions: number[];
    tangents?: number[];
    uvs?: number[];
}
合并几何体
Parameters
- geometrys: {
      indices: number[];
      normals?: number[];
      positions: number[];
      tangents?: number[];
      uvs?: number[];
  }[]
  
  几何体列表
Returns {
    indices: number[];
    normals?: number[];
    positions: number[];
    tangents?: number[];
    uvs?: number[];
}
- indices: number[]
- Optional normals?: number[]
- positions: number[]
- Optional tangents?: number[]
- Optional uvs?: number[]
- Defined in src/3d/geometrys/GeometryUtils.ts:419

normalizeNormals

normalizeNormals(normals: number[]): void
标准化法线数据
Parameters
- normals: number[]
  
  被标准化的法线数据
Returns void
- Defined in src/3d/geometrys/GeometryUtils.ts:632

raycast

raycast(ray: Ray3, indices: ArrayLike<number>, positions: AttributeBufferSourceTypes, uvs: AttributeBufferSourceTypes, shortestCollisionDistance?: number, cullFace?: CullFace): {
    index: number;
    localNormal: Vector3;
    localPosition: Vector3;
    rayEntryDistance: number;
    uv: Vector2;
}
射线投影几何体

Todo

See
- 3D数学基础：图形与游戏开发 P278 是否可用该内容优化运算效率？
- 优化参考 three.js Ray.intersectTriangle
Parameters
- ray: Ray3
  
  射线
- indices: ArrayLike<number>
- positions: AttributeBufferSourceTypes
- uvs: AttributeBufferSourceTypes
- shortestCollisionDistance: number = Number.MAX_VALUE
  
  当前最短碰撞距离
- cullFace: CullFace = 'NONE'
  
  裁剪面枚举
Returns {
    index: number;
    localNormal: Vector3;
    localPosition: Vector3;
    rayEntryDistance: number;
    uv: Vector2;
}
- index: number
- localNormal: Vector3
- localPosition: Vector3
- rayEntryDistance: number
- uv: Vector2
- Defined in src/3d/geometrys/GeometryUtils.ts:460

Class GeometryUtils

Hierarchy

Index

Constructors

Methods

Constructors

constructor

Returns GeometryUtils

Methods

applyTransformation

Parameters

transform: Matrix4x4

positions: AttributeBufferSourceTypes

Optional normals: AttributeBufferSourceTypes

Optional tangents: AttributeBufferSourceTypes

Returns void

createFaceNormals

Parameters

indices: number[]

positions: number[]

useFaceWeights: boolean = false

Returns { faceNormals: number[]; faceWeights: number[]; }

faceNormals: number[]

faceWeights: number[]

createFaceTangents

Parameters

indices: ArrayLike<number>

positions: ArrayLike<number>

uvs: ArrayLike<number>

useFaceWeights: boolean = false

Returns { faceTangents: number[]; faceWeights: number[]; }

faceTangents: number[]

faceWeights: number[]

createIndices

Parameters

positions: number[]

Returns number[]

createUVs

Parameters

positions: number[]

Returns number[]

createVertexNormals

Parameters

indices: number[]

positions: number[]

useFaceWeights: boolean = false

Returns number[]

createVertexTangents

Parameters

indices: ArrayLike<number>

positions: ArrayLike<number>

uvs: ArrayLike<number>

useFaceWeights: boolean = false

Returns number[]

getAABB

Parameters

positions: number[]

out: Box3 = ...

Returns Box3

mergeGeometry

Parameters

geometrys: { indices: number[]; normals?: number[]; positions: number[]; tangents?: number[]; uvs?: number[]; }[]

Returns { indices: number[]; normals?: number[]; positions: number[]; tangents?: number[]; uvs?: number[]; }

indices: number[]

Optional normals?: number[]

positions: number[]

Optional tangents?: number[]

Optional uvs?: number[]

normalizeNormals

Parameters

normals: number[]

Returns void

raycast

Todo

See

Parameters

ray: Ray3

indices: ArrayLike<number>

positions: AttributeBufferSourceTypes

uvs: AttributeBufferSourceTypes

`Optional` normals: AttributeBufferSourceTypes

`Optional` tangents: AttributeBufferSourceTypes

Returns {
faceNormals: number[];
faceWeights: number[];
}

Returns {
faceTangents: number[];
faceWeights: number[];
}

geometrys: {
indices: number[];
normals?: number[];
positions: number[];
tangents?: number[];
uvs?: number[];
}[]

Returns {
indices: number[];
normals?: number[];
positions: number[];
tangents?: number[];
uvs?: number[];
}

`Optional` normals?: number[]

`Optional` tangents?: number[]

`Optional` uvs?: number[]

Returns {
index: number;
localNormal: Vector3;
localPosition: Vector3;
rayEntryDistance: number;
uv: Vector2;
}