Class: HingeConstraint
Defined in: packages/physics/constraint/HingeConstraint.ts:9
Hinge constraint.
Extends
ConstraintBase<btHingeConstraint>
Constructors
Constructor
new HingeConstraint():
HingeConstraint
Returns
HingeConstraint
Inherited from
ConstraintBase<Ammo.btHingeConstraint>.constructor
Properties
object3D
object3D:
Object3D=null
Defined in: src/components/ComponentBase.ts:29
owner object3D
Inherited from
ConstraintBase.object3D
isDestroyed
isDestroyed:
boolean=false
Defined in: src/components/ComponentBase.ts:77
Inherited from
ConstraintBase.isDestroyed
pivotSelf
pivotSelf:
Vector3
Defined in: packages/physics/constraint/ConstraintBase.ts:19
The pivot point for the self body FrameInA Origin
Inherited from
ConstraintBase.pivotSelf
pivotTarget
pivotTarget:
Vector3
Defined in: packages/physics/constraint/ConstraintBase.ts:24
The pivot point for the target body FrameInB Origin
Inherited from
ConstraintBase.pivotTarget
rotationSelf
rotationSelf:
Quaternion
Defined in: packages/physics/constraint/ConstraintBase.ts:29
The rotation for the self body FrameInA Rotation
Inherited from
ConstraintBase.rotationSelf
rotationTarget
rotationTarget:
Quaternion
Defined in: packages/physics/constraint/ConstraintBase.ts:34
The rotation for the target body FrameInB Rotation
Inherited from
ConstraintBase.rotationTarget
disableCollisionsBetweenLinkedBodies
disableCollisionsBetweenLinkedBodies:
boolean=true
Defined in: packages/physics/constraint/ConstraintBase.ts:36
Inherited from
ConstraintBase.disableCollisionsBetweenLinkedBodies
axisSelf
axisSelf:
Vector3=Vector3.UP
Defined in: packages/physics/constraint/HingeConstraint.ts:14
Hinge axis direction on this rigid body. Default Vector3.UP
axisTarget
axisTarget:
Vector3=Vector3.UP
Defined in: packages/physics/constraint/HingeConstraint.ts:19
Hinge axis direction on the target rigid body. Default Vector3.UP
useReferenceFrameA
useReferenceFrameA:
boolean=true
Defined in: packages/physics/constraint/HingeConstraint.ts:24
Whether to use this rigid body's reference frame. Default true
useTwoBodiesTransformOverload
useTwoBodiesTransformOverload:
boolean=false
Defined in: packages/physics/constraint/HingeConstraint.ts:30
Whether to use the two-bodies-transform overload. If true, the transforms of both rigid bodies are used as the constraint's reference frames. Default false
Accessors
visibleLayer
Get Signature
get visibleLayer():
number
Defined in: src/components/ComponentBase.ts:46
Composition-layer membership bitmask. The pass / camera / collector filters via
(component.visibleLayer & pass.layerMask & camera.cullingMask) !== 0
Defaults to VisibleLayer.Default (bit 0) so a fresh subclass is visible to passes whose layerMask is VisibleLayer.All (which includes bit 0). Application code can assign project-specific bits (1..31) to organise the scene into composition layers.
Returns
number
Set Signature
set visibleLayer(
value):void
Defined in: src/components/ComponentBase.ts:50
Parameters
value
number
Returns
void
Inherited from
ConstraintBase.visibleLayer
eventDispatcher
Get Signature
get eventDispatcher():
CEventDispatcher
Defined in: src/components/ComponentBase.ts:63
Returns
CEventDispatcher
Set Signature
set eventDispatcher(
value):void
Defined in: src/components/ComponentBase.ts:68
Parameters
value
CEventDispatcher
Returns
void
Inherited from
ConstraintBase.eventDispatcher
isStart
Get Signature
get isStart():
boolean
Defined in: src/components/ComponentBase.ts:79
Returns
boolean
Inherited from
ConstraintBase.isStart
transform
Get Signature
get transform():
Transform
Defined in: src/components/ComponentBase.ts:89
Return the Transform component attached to the Object3D. Null before the component is attached — addComponent assigns object3D only after construction — so constructor-time callers can probe safely via this.transform?..
Returns
Transform
Inherited from
ConstraintBase.transform
enable
Get Signature
get enable():
boolean
Defined in: src/components/ComponentBase.ts:113
Enable/disable components. The enabled components can be updated, while the disabled components cannot be updated.
Returns
boolean
Set Signature
set enable(
value):void
Defined in: src/components/ComponentBase.ts:96
Enable/disable components. The enabled components can be updated, while the disabled components cannot be updated.
Parameters
value
boolean
Returns
void
Inherited from
ConstraintBase.enable
breakingThreshold
Get Signature
get breakingThreshold():
number
Defined in: packages/physics/constraint/ConstraintBase.ts:41
Breaking impulse threshold. The larger the value, the harder the constraint is to break.
Returns
number
Set Signature
set breakingThreshold(
value):void
Defined in: packages/physics/constraint/ConstraintBase.ts:45
Parameters
value
number
Returns
void
Inherited from
ConstraintBase.breakingThreshold
constraint
Get Signature
get constraint():
T
Defined in: packages/physics/constraint/ConstraintBase.ts:87
Get the constraint instance
Returns
T
Inherited from
ConstraintBase.constraint
targetRigidbody
Get Signature
get targetRigidbody():
Rigidbody
Defined in: packages/physics/constraint/ConstraintBase.ts:119
Target rigid body component
Returns
Set Signature
set targetRigidbody(
value):void
Defined in: packages/physics/constraint/ConstraintBase.ts:123
Parameters
value
Returns
void
Inherited from
ConstraintBase.targetRigidbody
limitInfo
Get Signature
get limitInfo(): [
number,number,number,number,number?]
Defined in: packages/physics/constraint/HingeConstraint.ts:38
Get the current limit parameters.
Returns
[number, number, number, number, number?]
motorConfigInfo
Get Signature
get motorConfigInfo(): [
boolean,number,number]
Defined in: packages/physics/constraint/HingeConstraint.ts:42
Get the current motor configuration parameters.
Returns
[boolean, number, number]
Methods
init()
init(
param?):void
Defined in: src/components/ComponentBase.ts:161
Parameters
param?
any
Returns
void
Inherited from
ConstraintBase.init
stop()
stop():
void
Defined in: src/components/ComponentBase.ts:163
Returns
void
Inherited from
ConstraintBase.stop
onEnable()?
optionalonEnable(view?):any
Defined in: src/components/ComponentBase.ts:164
Parameters
view?
View3D
Returns
any
Inherited from
ConstraintBase.onEnable
onDisable()?
optionalonDisable(view?):any
Defined in: src/components/ComponentBase.ts:165
Parameters
view?
View3D
Returns
any
Inherited from
ConstraintBase.onDisable
onUpdate()?
optionalonUpdate(view?):any
Defined in: src/components/ComponentBase.ts:166
Parameters
view?
View3D
Returns
any
Inherited from
ConstraintBase.onUpdate
onLateUpdate()?
optionalonLateUpdate(view?):any
Defined in: src/components/ComponentBase.ts:167
Parameters
view?
View3D
Returns
any
Inherited from
ConstraintBase.onLateUpdate
onBeforeUpdate()?
optionalonBeforeUpdate(view?):any
Defined in: src/components/ComponentBase.ts:168
Parameters
view?
View3D
Returns
any
Inherited from
ConstraintBase.onBeforeUpdate
onCompute()?
optionalonCompute(view?,command?):any
Defined in: src/components/ComponentBase.ts:169
Parameters
view?
View3D
command?
GPUCommandEncoder
Returns
any
Inherited from
ConstraintBase.onCompute
onGraphic()?
optionalonGraphic(view?):any
Defined in: src/components/ComponentBase.ts:170
Parameters
view?
View3D
Returns
any
Inherited from
ConstraintBase.onGraphic
onParentChange()?
optionalonParentChange(lastParent?,currentParent?):any
Defined in: src/components/ComponentBase.ts:171
Parameters
lastParent?
Object3D
currentParent?
Object3D
Returns
any
Inherited from
ConstraintBase.onParentChange
onAddChild()?
optionalonAddChild(child):any
Defined in: src/components/ComponentBase.ts:172
Parameters
child
Object3D
Returns
any
Inherited from
ConstraintBase.onAddChild
onRemoveChild()?
optionalonRemoveChild(child):any
Defined in: src/components/ComponentBase.ts:173
Parameters
child
Object3D
Returns
any
Inherited from
ConstraintBase.onRemoveChild
cloneTo()
cloneTo(
obj):void
Defined in: src/components/ComponentBase.ts:180
clone component data to target object3D
Parameters
obj
Object3D
target object3D
Returns
void
Inherited from
ConstraintBase.cloneTo
copyComponent()
copyComponent(
from):this
Defined in: src/components/ComponentBase.ts:182
Parameters
from
this
Returns
this
Inherited from
ConstraintBase.copyComponent
beforeDestroy()
beforeDestroy(
force?):void
Defined in: src/components/ComponentBase.ts:249
before release this component, object refrences are not be set null now.
Parameters
force?
boolean
Returns
void
Inherited from
ConstraintBase.beforeDestroy
start()
start():
Promise<void>
Defined in: packages/physics/constraint/ConstraintBase.ts:50
Returns
Promise<void>
Inherited from
ConstraintBase.start
wait()
wait():
Promise<btHingeConstraint>
Defined in: packages/physics/constraint/ConstraintBase.ts:97
Asynchronously retrieve the fully initialized constraint instance
Returns
Promise<btHingeConstraint>
Inherited from
ConstraintBase.wait
resetConstraint()
resetConstraint():
Promise<btHingeConstraint>
Defined in: packages/physics/constraint/ConstraintBase.ts:105
Reset the constraint: destroy the current constraint instance, recreate it, and return the new constraint instance
Returns
Promise<btHingeConstraint>
Inherited from
ConstraintBase.resetConstraint
destroy()
destroy(
force?):void
Defined in: packages/physics/constraint/ConstraintBase.ts:127
release this component
Parameters
force?
boolean
Returns
void
Inherited from
ConstraintBase.destroy
setLimit()
setLimit(
low,high,softness,biasFactor,relaxationFactor?):void
Defined in: packages/physics/constraint/HingeConstraint.ts:52
Set the rotation limits of the hinge constraint.
Parameters
low
number
The minimum hinge angle (lower limit).
high
number
The maximum hinge angle (upper limit).
softness
number
Softness coefficient indicating how soft the limit is. In the range 0 to 1; 1 means fully rigid.
biasFactor
number
Bias factor controlling the strength of the limit's restoring force. Typically in the range 0 to 1.
relaxationFactor?
number
(Optional) Relaxation factor controlling how quickly the limit recovers. Larger values mean faster recovery.
Returns
void
enableAngularMotor()
enableAngularMotor(
enableMotor,targetVelocity,maxMotorImpulse):void
Defined in: packages/physics/constraint/HingeConstraint.ts:63
Enable or disable the angular motor.
Parameters
enableMotor
boolean
Whether to enable the motor.
targetVelocity
number
The motor's target velocity.
maxMotorImpulse
number
The motor's maximum impulse.
Returns
void

