1. @threlte/rapier
  2. useJoint

@threlte/rapier

useJoint

Use this hook to initialize any Rapier joint.

INFO

This example initializes a RevoluteImpulseJoint manually. Most of the times you'd want to use a shortcut hook (like 'useRevoluteJoint') to initialize a joint. This hook is used internally to initialize the currently available joints.

<script>
	import { useJoint, RigidBody, Collider } from '@threlte/rapier'

	const { joint, rigidBodyA, rigidBodyB } = useJoint((rbA, rbB, { world, rapier }) => {
    const params = rapier.JointData.revolute(
      { x: 0, y: 10, z: 1 },
      { x: 0, y: 0, z: 0 },
      { x: 0 y: 1, z: 0 }
    )
    return world.createImpulseJoint(params, rbA, rbB, true)
  })
</script>

<RigidBody bind:rigidBody={$rigidBodyA}>
	<Collider shape="cuboid" args={[1, 1, 1]} />
</RigidBody>

<RigidBody bind:rigidBody={$rigidBodyB}>
	<Collider shape="cuboid" args={[1, 1, 1]} />
</RigidBody>

The callback to initialize the Joint is called when both rigidBodyA and rigidBodyB are defined.

Import

Source

Github View Source Code

Package

NPM View Package

Signature

const {
	joint: Writable<T>
	rigidBodyA: Writable<RAPIER.RigidBody>
	rigidBodyB: Writable<RAPIER.RigidBody>
} = useJoint<T extends RAPIER.ImpulseJoint | RAPIER.MultiBodyJoint>(
	initializeJoint: (rigidBodyA: RAPIER.RigidBody, rigidBodyB: RAPIER.RigidBody, RapierContext) => T
)