xrhandfound
Description​
This event is emitted by xrhand when a hand is first found.
xrhandfound.detail : {id, transform, vertices, normals, handKind, attachmentPoints}
| Property | Description |
|---|---|
| id | A numerical id of the located hand. |
transform: {position, rotation, scale} | Transform information of the located hand. |
| vertices: [{x, y, z}] | Position of hand points, relative to transform. |
| normals: [{x, y, z}] | Normal direction of vertices, relative to transform. |
| handKind | A numerical representation of the handedness of the located hand. Valid values are 0 (unspecified), 1 (left), and 2 (right). |
attachmentPoints: { name, position: {x,y,z} } | See XR8.HandController.AttachmentPoints for list of available attachment points. position is relative to the transform. |
transform is an object with the following properties:
| Property | Description |
|---|---|
| position {x, y, z} | The 3d position of the located hand. |
| rotation {w, x, y, z} | The 3d local orientation of the located hand. |
| scale | A scale factor that should be applied to objects attached to this hand. |
attachmentPoints is an object with the following properties:
| Property | Description |
|---|---|
| name | The name of the attachment point. See XR8.HandController.AttachmentPoints for list of available attachment points. |
| position {x, y, z} | The 3d position of the attachment point on the located hand. |
| rotation {w, x, y, z} | The rotation quaternion that rotates positive-Y vector to the attachment point bone vector. |
| innerPoint {x, y, z} | The inner point of an attachment point. (ex. hand palm side) |
| outerPoint {x, y, z} | The outer point of an attachment point. (ex. hand backside) |
| radius | The radius of finger attachment points. |
| minorRadius | The shortest radius from hand surface to the wrist attachment point. |
| majorRadius | The longest radius from hand surface to the wrist attachment point. |
Example​
const handRigidComponent = {
init: function () {
const object3D = this.el.object3D
object3D.visible = false
const show = ({detail}) => {
const {position, rotation, scale} = detail.transform
object3D.position.copy(position)
object3D.quaternion.copy(rotation)
object3D.scale.set(scale, scale, scale)
object3D.visible = true
}
const hide = ({detail}) => { object3D.visible = false }
this.el.sceneEl.addEventListener('xrhandfound', show)
this.el.sceneEl.addEventListener('xrhandupdated', show)
this.el.sceneEl.addEventListener('xrhandlost', hide)
}
}