Class: HingeConstraint

铰链约束

Hierarchy

• ConstraintBase<btHingeConstraint>

  ↳ HingeConstraint

Constructors

• constructor

Properties

• pivotSelf
• pivotTarget
• rotationSelf
• rotationTarget
• disableCollisionsBetweenLinkedBodies
• axisSelf
• axisTarget
• useReferenceFrameA
• useTwoBodiesTransformOverload
• object3D
• isDestroyed

Accessors

• breakingThreshold
• constraint
• targetRigidbody
• limitInfo
• motorConfigInfo
• eventDispatcher
• isStart
• transform
• enable

Methods

• start
• wait
• resetConstraint
• destroy
• setLimit
• enableAngularMotor
• init
• stop
• onEnable
• onDisable
• onUpdate
• onLateUpdate
• onBeforeUpdate
• onCompute
• onGraphic
• onParentChange
• onAddChild
• onRemoveChild
• cloneTo
• copyComponent
• beforeDestroy

Constructors

constructor

• new HingeConstraint(): HingeConstraint

Returns

HingeConstraint

Inherited from

ConstraintBase<Ammo.btHingeConstraint>.constructor

Properties

pivotSelf

• pivotSelf: Vector3

The pivot point for the self body FrameInA Origin

Inherited from

ConstraintBase.pivotSelf

Defined in

packages/physics/constraint/ConstraintBase.ts:19

---

pivotTarget

• pivotTarget: Vector3

The pivot point for the target body FrameInB Origin

Inherited from

ConstraintBase.pivotTarget

Defined in

packages/physics/constraint/ConstraintBase.ts:24

---

rotationSelf

• rotationSelf: Quaternion

The rotation for the self body FrameInA Rotation

Inherited from

ConstraintBase.rotationSelf

Defined in

packages/physics/constraint/ConstraintBase.ts:29

---

rotationTarget

• rotationTarget: Quaternion

The rotation for the target body FrameInB Rotation

Inherited from

ConstraintBase.rotationTarget

Defined in

packages/physics/constraint/ConstraintBase.ts:34

---

disableCollisionsBetweenLinkedBodies

• disableCollisionsBetweenLinkedBodies: boolean = true

Inherited from

ConstraintBase.disableCollisionsBetweenLinkedBodies

Defined in

packages/physics/constraint/ConstraintBase.ts:36

---

axisSelf

• axisSelf: Vector3 = Vector3.UP

自身刚体上的铰链轴方向。 默认值 Vector3.UP

Defined in

packages/physics/constraint/HingeConstraint.ts:14

---

axisTarget

• axisTarget: Vector3 = Vector3.UP

目标刚体上的铰链轴方向。 默认值 Vector3.UP

Defined in

packages/physics/constraint/HingeConstraint.ts:19

---

useReferenceFrameA

• useReferenceFrameA: boolean = true

是否使用自身刚体的参考框架。 默认值 true

Defined in

packages/physics/constraint/HingeConstraint.ts:24

---

useTwoBodiesTransformOverload

• useTwoBodiesTransformOverload: boolean = false

是否使用两个刚体的变换重载方式。 如果为 true，则使用两个刚体的变换作为约束的参考框架。 默认值 false

Defined in

packages/physics/constraint/HingeConstraint.ts:30

---

object3D

• object3D: Object3D = null

owner object3D

Inherited from

ConstraintBase.object3D

Defined in

src/components/ComponentBase.ts:17

---

isDestroyed

• Optional isDestroyed: boolean

Inherited from

ConstraintBase.isDestroyed

Defined in

src/components/ComponentBase.ts:38

Accessors

breakingThreshold

• get breakingThreshold(): number

断裂脉冲阈值，值越大，约束越不易断裂。

Returns

number

Inherited from

ConstraintBase.breakingThreshold

Defined in

packages/physics/constraint/ConstraintBase.ts:41

• set breakingThreshold(value): void

Parameters

Name	Type
value	number

Returns

void

Inherited from

ConstraintBase.breakingThreshold

Defined in

packages/physics/constraint/ConstraintBase.ts:45

---

constraint

• get constraint(): T

获取约束实例

Returns

T

Inherited from

ConstraintBase.constraint

Defined in

packages/physics/constraint/ConstraintBase.ts:87

---

targetRigidbody

• get targetRigidbody(): Rigidbody

目标刚体组件

Returns

Rigidbody

Inherited from

ConstraintBase.targetRigidbody

Defined in

packages/physics/constraint/ConstraintBase.ts:119

• set targetRigidbody(value): void

Parameters

Name	Type
value	Rigidbody

Returns

void

Inherited from

ConstraintBase.targetRigidbody

Defined in

packages/physics/constraint/ConstraintBase.ts:123

---

limitInfo

• get limitInfo(): [number, number, number, number, number?]

获取当前的限制参数。

Returns

[number, number, number, number, number?]

Defined in

packages/physics/constraint/HingeConstraint.ts:38

---

motorConfigInfo

• get motorConfigInfo(): [boolean, number, number]

获取当前的马达配置参数。

Returns

[boolean, number, number]

Defined in

packages/physics/constraint/HingeConstraint.ts:42

---

eventDispatcher

• get eventDispatcher(): CEventDispatcher

Returns

CEventDispatcher

Inherited from

ConstraintBase.eventDispatcher

Defined in

src/components/ComponentBase.ts:23

• set eventDispatcher(value): void

Parameters

Name	Type
value	CEventDispatcher

Returns

void

Inherited from

ConstraintBase.eventDispatcher

Defined in

src/components/ComponentBase.ts:28

---

isStart

• get isStart(): boolean

Returns

boolean

Inherited from

ConstraintBase.isStart

Defined in

src/components/ComponentBase.ts:40

---

transform

• get transform(): Transform

Return the Transform component attached to the Object3D.

Returns

Transform

Inherited from

ConstraintBase.transform

Defined in

src/components/ComponentBase.ts:47

---

enable

• get enable(): boolean

Enable/disable components. The enabled components can be updated, while the disabled components cannot be updated.

Returns

boolean

Inherited from

ConstraintBase.enable

Defined in

src/components/ComponentBase.ts:68

• set enable(value): void

Enable/disable components. The enabled components can be updated, while the disabled components cannot be updated.

Parameters

Name	Type
value	boolean

Returns

void

Inherited from

ConstraintBase.enable

Defined in

src/components/ComponentBase.ts:54

Methods

start

▸ start(): Promise<void>

Returns

Promise<void>

Inherited from

ConstraintBase.start

Defined in

packages/physics/constraint/ConstraintBase.ts:50

---

wait

▸ wait(): Promise<btHingeConstraint>

异步获取完成初始化的约束实例

Returns

Promise<btHingeConstraint>

Inherited from

ConstraintBase.wait

Defined in

packages/physics/constraint/ConstraintBase.ts:97

---

resetConstraint

▸ resetConstraint(): Promise<btHingeConstraint>

重置约束，销毁当前约束实例后重新创建并返回新的约束实例

Returns

Promise<btHingeConstraint>

Inherited from

ConstraintBase.resetConstraint

Defined in

packages/physics/constraint/ConstraintBase.ts:105

---

destroy

▸ destroy(force?): void

Parameters

Name	Type
force?	boolean

Returns

void

Inherited from

ConstraintBase.destroy

Defined in

packages/physics/constraint/ConstraintBase.ts:127

---

setLimit

▸ setLimit(low, high, softness, biasFactor, relaxationFactor?): void

设置铰链约束的旋转限制。

Parameters

Name	Type	Description
low	number	铰链旋转的最小角度（下限）。
high	number	铰链旋转的最大角度（上限）。
softness	number	软限制系数，表示限制的柔软程度。值在0到1之间，1表示完全刚性。
biasFactor	number	偏置因子，用于控制限制恢复力的力度。值通常在0到1之间。
relaxationFactor?	number	（可选）松弛因子，控制限制恢复的速度。值越大，恢复越快。

Returns

void

Defined in

packages/physics/constraint/HingeConstraint.ts:52

---

enableAngularMotor

▸ enableAngularMotor(enableMotor, targetVelocity, maxMotorImpulse): void

启用或禁用角度马达。

Parameters

Name	Type	Description
enableMotor	boolean	是否启用马达。
targetVelocity	number	马达的目标速度。
maxMotorImpulse	number	马达的最大推力。

Returns

void

Defined in

packages/physics/constraint/HingeConstraint.ts:63

---

init

▸ init(param?): void

Parameters

Name	Type
param?	any

Returns

void

Inherited from

ConstraintBase.init

Defined in

src/components/ComponentBase.ts:112

---

stop

▸ stop(): void

Returns

void

Inherited from

ConstraintBase.stop

Defined in

src/components/ComponentBase.ts:114

---

onEnable

▸ onEnable(view?): any

Parameters

Name	Type
view?	View3D

Returns

any

Inherited from

ConstraintBase.onEnable

Defined in

src/components/ComponentBase.ts:115

---

onDisable

▸ onDisable(view?): any

Parameters

Name	Type
view?	View3D

Returns

any

Inherited from

ConstraintBase.onDisable

Defined in

src/components/ComponentBase.ts:116

---

onUpdate

▸ onUpdate(view?): any

Parameters

Name	Type
view?	View3D

Returns

any

Inherited from

ConstraintBase.onUpdate

Defined in

src/components/ComponentBase.ts:117

---

onLateUpdate

▸ onLateUpdate(view?): any

Parameters

Name	Type
view?	View3D

Returns

any

Inherited from

ConstraintBase.onLateUpdate

Defined in

src/components/ComponentBase.ts:118

---

onBeforeUpdate

▸ onBeforeUpdate(view?): any

Parameters

Name	Type
view?	View3D

Returns

any

Inherited from

ConstraintBase.onBeforeUpdate

Defined in

src/components/ComponentBase.ts:119

---

onCompute

▸ onCompute(view?, command?): any

Parameters

Name	Type
view?	View3D
command?	GPUCommandEncoder

Returns

any

Inherited from

ConstraintBase.onCompute

Defined in

src/components/ComponentBase.ts:120

---

onGraphic

▸ onGraphic(view?): any

Parameters

Name	Type
view?	View3D

Returns

any

Inherited from

ConstraintBase.onGraphic

Defined in

src/components/ComponentBase.ts:121

---

onParentChange

▸ onParentChange(lastParent?, currentParent?): any

Parameters

Name	Type
lastParent?	Object3D
currentParent?	Object3D

Returns

any

Inherited from

ConstraintBase.onParentChange

Defined in

src/components/ComponentBase.ts:122

---

onAddChild

▸ onAddChild(child): any

Parameters

Name	Type
child	Object3D

Returns

any

Inherited from

ConstraintBase.onAddChild

Defined in

src/components/ComponentBase.ts:123

---

onRemoveChild

▸ onRemoveChild(child): any

Parameters

Name	Type
child	Object3D

Returns

any

Inherited from

ConstraintBase.onRemoveChild

Defined in

src/components/ComponentBase.ts:124

---

cloneTo

▸ cloneTo(obj): void

clone component data to target object3D

Parameters

Name	Type	Description
obj	Object3D	target object3D

Returns

void

Inherited from

ConstraintBase.cloneTo

Defined in

src/components/ComponentBase.ts:131

---

copyComponent

▸ copyComponent(from): this

Parameters

Name	Type
from	this

Returns

this

Inherited from

ConstraintBase.copyComponent

Defined in

src/components/ComponentBase.ts:133

---

beforeDestroy

▸ beforeDestroy(force?): void

before release this component, object refrences are not be set null now.

Parameters

Name	Type
force?	boolean

Returns

void

Inherited from

ConstraintBase.beforeDestroy

Defined in

src/components/ComponentBase.ts:200