Class Tool

自定义工具方法

Methods

degToRad

degToRad(deg: number): number
Parameters
- deg: number
Returns number
Description
角度转弧度

Date
2025/11/18

getChildrenInfo

getChildrenInfo(model: Object3D): Object3D<Object3DEventMap>[]
获取模型的子模型信息
Parameters
- model: Object3D
  模型
Returns Object3D<Object3DEventMap>[]
{Object3D[]}

getFacingAngle

getFacingAngle(
currentPos: { x: number; z: number },
targetPos: { x: number; z: number },
): number
获取从当前位置朝向目标位置的角度
Parameters
- currentPos: { x: number; z: number }
  当前位置 {x: number, z: number}
- targetPos: { x: number; z: number }
  目标位置 {x: number, z: number}
Returns number

getFlattenJoints

getFlattenJoints(joints: any): any[]
将带层级的关节树结构变成扁平化的关节数组
Parameters
- joints: any
  关节树结构
Returns any[]
{any[]}

getLocalToWorldPosition

getLocalToWorldPosition(obj: Object3D, localPosition: Vector3 | xyz): Vector3
Parameters
- obj: Object3D
  模型
- localPosition: Vector3 | xyz
  局部坐标
Returns Vector3
{Vector3}

Description
获取局部坐标到世界坐标

getModelBox

getModelBox(obj: Object3D, scale?: number): Box3
获取模型包围盒
Parameters
- obj: Object3D
  模型
- Optionalscale: number = 1
  系数：大于 1 放大包围盒尺寸，小于 1 缩小；中心点保持不变
Returns Box3
{Box3}

getModelCenter

getModelCenter(obj: Object3D): Vector3
获取模型中心点位置
Parameters
- obj: Object3D
  模型
Returns Vector3
{Vector3}

getModelFace

getModelFace(model: Object3D): number
获取模型三角面数
Parameters
- model: Object3D
  模型
Returns number
{number} 三角面数

getModelInfo

getModelInfo(model: Object3D): object
获取模型信息
Parameters
- model: Object3D
  模型
Returns object
{object}

getModelJson

getModelJson(obj: Object3D): Object
获取模型JSON数据
Parameters
- obj: Object3D
  模型
Returns Object
{Object}

getModelLocalAxes

getModelLocalAxes(obj: Object3D): { x: Vector3; y: Vector3; z: Vector3 }
Parameters
- obj: Object3D
  模型
Returns { x: Vector3; y: Vector3; z: Vector3 }
{Vector3}

Description
获取模型局部坐标轴方向

getModelSize

getModelSize(
    obj: Object3D,
): {
    center: Vector3;
    depth: number;
    height: number;
    max: Vector3;
    min: Vector3;
    width: number;
}
获取模型包围盒尺寸
Parameters
- obj: Object3D
Returns {
    center: Vector3;
    depth: number;
    height: number;
    max: Vector3;
    min: Vector3;
    width: number;
}

getModelSphere

getModelSphere(obj: Object3D): Sphere
获取模型的包裹球
Parameters
- obj: Object3D
Returns Sphere
{Sphere}

getModelVertex

getModelVertex(model: Object3D): number
获取模型顶点数
Parameters
- model: Object3D
  模型
Returns number
{number} 顶点数

getPointDistance

getPointDistance(start: xyz, end: xyz): number
计算两点间距离
Parameters
- start: xyz
- end: xyz
Returns number
{number}

getPointLineDistance

getPointLineDistance(point: xyz, line: { end: xyz; start: xyz }): number
获取点到线的最小距离
Parameters
- point: xyz
  点位置
- line: { end: xyz; start: xyz }
  线数据
Returns number

getWorldPosition

getWorldPosition(obj: Object3D): Vector3
获取模型世界坐标位置
Parameters
- obj: Object3D
  模型
Returns Vector3

getWorldToLocalPosition

getWorldToLocalPosition(obj: Object3D, worldPosition: Vector3 | xyz): Vector3
Parameters
- obj: Object3D
  模型
- worldPosition: Vector3 | xyz
  世界坐标系
Returns Vector3
Description
获取世界坐标到局部坐标

initBox3

initBox3(): Box3
创建Box3

Returns Box3

initClock

initClock(): Timer
生成时钟，获取当前时间

Returns Timer
{Timer}

initColor

initColor(color?: string): Color
创建Three.js颜色
Parameters
- Optionalcolor: string
Returns Color

initEuler

initEuler(x?: number, y?: number, z?: number, order?: EulerOrder): Euler
创建欧拉角
Parameters
- Optionalx: number
- Optionaly: number
- Optionalz: number
- Optionalorder: EulerOrder
Returns Euler

initGroup

initGroup(): Group<Object3DEventMap>
创建Group

Returns Group<Object3DEventMap>

initMatrix3

initMatrix3(): Matrix3
创建3x3矩阵

Returns Matrix3

initMatrix4

initMatrix4(): Matrix4
创建4x4矩阵

Returns Matrix4
{Matrix4}

initQuaternion

initQuaternion(): Quaternion
创建Quaternion

Returns Quaternion

initVector2

initVector2(x?: number, y?: number): Vector2
创建Vector2向量
Parameters
- Optionalx: number
- Optionaly: number
Returns Vector2
{Vector2}

initVector3

initVector3(x?: number, y?: number, z?: number): Vector3
创建Vector3向量
Parameters
- Optionalx: number
- Optionaly: number
- Optionalz: number
Returns Vector3
{Vector3}

initVector3ByAxis

initVector3ByAxis(axis: "x" | "y" | "z", value?: number): Vector3
获取轴向量
Parameters
- axis: "x" | "y" | "z"
  轴
- Optionalvalue: number = 1
Returns Vector3
{Vector3}

initVector3ByTwoPoints

initVector3ByTwoPoints(start: xyz, end: xyz, normalize?: boolean): Vector3
根据两个点生成方向向量（终点 - 起点，默认归一化为单位向量）
Parameters
- start: xyz
  起点
- end: xyz
  终点
- Optionalnormalize: boolean = true
  是否归一化
Returns Vector3
{Vector3}

initVector4

initVector4(x?: number, y?: number, z?: number, w?: number): Vector4
创建Vector4向量
Parameters
- Optionalx: number
- Optionaly: number
- Optionalz: number
- Optionalw: number
Returns Vector4

normalizeAngle

normalizeAngle(angle: number): number
标准化角度，确保角度在 [-π, π] 范围内，取最短旋转路径
Parameters
- angle: number
  原始角度(弧度)
Returns number

ownMarker

ownMarker(obj: Object3D, domId?: string): boolean
判断模型是否有2D标记
Parameters
- obj: Object3D
  模型
- OptionaldomId: string
  2D标记id
Returns boolean

radToDeg

radToDeg(rad: number): number
Parameters
- rad: number
Returns number
Description
弧度转角度

Date
2025/11/18

setVisualPosition

setVisualPosition(
    obj: Object3D,
    target: Vector3 | xyz,
    axes?: "xz" | "xyz",
): void
按包围盒中心设置世界坐标，补偿模型原点偏移
Parameters
- obj: Object3D
  已加载的模型（需已设置 scale/rotation）
- target: Vector3 | xyz
  希望物体实际出现的世界坐标
- axes: "xz" | "xyz" = 'xz'
  默认 xz：地面拖放只对齐水平位置，保留原有高度
Returns void