224 lines
9.9 KiB
XML
224 lines
9.9 KiB
XML
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||
|
|
<class name="XRHandTracker" inherits="RefCounted" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
||
|
|
<brief_description>
|
||
|
|
A tracked hand in XR.
|
||
|
|
</brief_description>
|
||
|
|
<description>
|
||
|
|
A hand tracking system will create an instance of this object and add it to the [XRServer]. This tracking system will then obtain skeleton data, convert it to the Godot Humanoid hand skeleton and store this data on the [XRHandTracker] object.
|
||
|
|
Use [XRHandModifier3D] to animate a hand mesh using hand tracking data.
|
||
|
|
</description>
|
||
|
|
<tutorials>
|
||
|
|
<link title="XR documentation index">$DOCS_URL/tutorials/xr/index.html</link>
|
||
|
|
</tutorials>
|
||
|
|
<methods>
|
||
|
|
<method name="get_hand_joint_angular_velocity" qualifiers="const">
|
||
|
|
<return type="Vector3" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<description>
|
||
|
|
Returns the angular velocity for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="get_hand_joint_flags" qualifiers="const">
|
||
|
|
<return type="int" enum="XRHandTracker.HandJointFlags" is_bitfield="true" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<description>
|
||
|
|
Returns flags about the validity of the tracking data for the given hand joint (see [enum XRHandTracker.HandJointFlags]).
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="get_hand_joint_linear_velocity" qualifiers="const">
|
||
|
|
<return type="Vector3" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<description>
|
||
|
|
Returns the linear velocity for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="get_hand_joint_radius" qualifiers="const">
|
||
|
|
<return type="float" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<description>
|
||
|
|
Returns the radius of the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="get_hand_joint_transform" qualifiers="const">
|
||
|
|
<return type="Transform3D" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<description>
|
||
|
|
Returns the transform for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="set_hand_joint_angular_velocity">
|
||
|
|
<return type="void" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<param index="1" name="angular_velocity" type="Vector3" />
|
||
|
|
<description>
|
||
|
|
Sets the angular velocity for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="set_hand_joint_flags">
|
||
|
|
<return type="void" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<param index="1" name="flags" type="int" enum="XRHandTracker.HandJointFlags" is_bitfield="true" />
|
||
|
|
<description>
|
||
|
|
Sets flags about the validity of the tracking data for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="set_hand_joint_linear_velocity">
|
||
|
|
<return type="void" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<param index="1" name="linear_velocity" type="Vector3" />
|
||
|
|
<description>
|
||
|
|
Sets the linear velocity for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="set_hand_joint_radius">
|
||
|
|
<return type="void" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<param index="1" name="radius" type="float" />
|
||
|
|
<description>
|
||
|
|
Sets the radius of the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
<method name="set_hand_joint_transform">
|
||
|
|
<return type="void" />
|
||
|
|
<param index="0" name="joint" type="int" enum="XRHandTracker.HandJoint" />
|
||
|
|
<param index="1" name="transform" type="Transform3D" />
|
||
|
|
<description>
|
||
|
|
Sets the transform for the given hand joint.
|
||
|
|
</description>
|
||
|
|
</method>
|
||
|
|
</methods>
|
||
|
|
<members>
|
||
|
|
<member name="hand" type="int" setter="set_hand" getter="get_hand" enum="XRHandTracker.Hand" default="0">
|
||
|
|
The type of hand.
|
||
|
|
</member>
|
||
|
|
<member name="hand_tracking_source" type="int" setter="set_hand_tracking_source" getter="get_hand_tracking_source" enum="XRHandTracker.HandTrackingSource" default="0">
|
||
|
|
The source of the hand tracking data.
|
||
|
|
</member>
|
||
|
|
<member name="has_tracking_data" type="bool" setter="set_has_tracking_data" getter="get_has_tracking_data" default="false">
|
||
|
|
If [code]true[/code], the hand tracking data is valid.
|
||
|
|
</member>
|
||
|
|
</members>
|
||
|
|
<constants>
|
||
|
|
<constant name="HAND_LEFT" value="0" enum="Hand">
|
||
|
|
A left hand.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_RIGHT" value="1" enum="Hand">
|
||
|
|
A right hand.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_MAX" value="2" enum="Hand">
|
||
|
|
Represents the size of the [enum Hand] enum.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_TRACKING_SOURCE_UNKNOWN" value="0" enum="HandTrackingSource">
|
||
|
|
The source of hand tracking data is unknown.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_TRACKING_SOURCE_UNOBSTRUCTED" value="1" enum="HandTrackingSource">
|
||
|
|
The source of hand tracking data is unobstructed, meaning that an accurate method of hand tracking is used. These include optical hand tracking, data gloves, etc.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_TRACKING_SOURCE_CONTROLLER" value="2" enum="HandTrackingSource">
|
||
|
|
The source of hand tracking data is a controller, meaning that joint positions are inferred from controller inputs.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_TRACKING_SOURCE_MAX" value="3" enum="HandTrackingSource">
|
||
|
|
Represents the size of the [enum HandTrackingSource] enum.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_PALM" value="0" enum="HandJoint">
|
||
|
|
Palm joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_WRIST" value="1" enum="HandJoint">
|
||
|
|
Wrist joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_THUMB_METACARPAL" value="2" enum="HandJoint">
|
||
|
|
Thumb metacarpal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_THUMB_PHALANX_PROXIMAL" value="3" enum="HandJoint">
|
||
|
|
Thumb phalanx proximal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_THUMB_PHALANX_DISTAL" value="4" enum="HandJoint">
|
||
|
|
Thumb phalanx distal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_THUMB_TIP" value="5" enum="HandJoint">
|
||
|
|
Thumb tip joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_INDEX_FINGER_METACARPAL" value="6" enum="HandJoint">
|
||
|
|
Index finger metacarpal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_INDEX_FINGER_PHALANX_PROXIMAL" value="7" enum="HandJoint">
|
||
|
|
Index finger phalanx proximal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_INDEX_FINGER_PHALANX_INTERMEDIATE" value="8" enum="HandJoint">
|
||
|
|
Index finger phalanx intermediate joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_INDEX_FINGER_PHALANX_DISTAL" value="9" enum="HandJoint">
|
||
|
|
Index finger phalanx distal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_INDEX_FINGER_TIP" value="10" enum="HandJoint">
|
||
|
|
Index finger tip joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_MIDDLE_FINGER_METACARPAL" value="11" enum="HandJoint">
|
||
|
|
Middle finger metacarpal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_MIDDLE_FINGER_PHALANX_PROXIMAL" value="12" enum="HandJoint">
|
||
|
|
Middle finger phalanx proximal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_MIDDLE_FINGER_PHALANX_INTERMEDIATE" value="13" enum="HandJoint">
|
||
|
|
Middle finger phalanx intermediate joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_MIDDLE_FINGER_PHALANX_DISTAL" value="14" enum="HandJoint">
|
||
|
|
Middle finger phalanx distal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_MIDDLE_FINGER_TIP" value="15" enum="HandJoint">
|
||
|
|
Middle finger tip joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_RING_FINGER_METACARPAL" value="16" enum="HandJoint">
|
||
|
|
Ring finger metacarpal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_RING_FINGER_PHALANX_PROXIMAL" value="17" enum="HandJoint">
|
||
|
|
Ring finger phalanx proximal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_RING_FINGER_PHALANX_INTERMEDIATE" value="18" enum="HandJoint">
|
||
|
|
Ring finger phalanx intermediate joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_RING_FINGER_PHALANX_DISTAL" value="19" enum="HandJoint">
|
||
|
|
Ring finger phalanx distal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_RING_FINGER_TIP" value="20" enum="HandJoint">
|
||
|
|
Ring finger tip joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_PINKY_FINGER_METACARPAL" value="21" enum="HandJoint">
|
||
|
|
Pinky finger metacarpal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_PINKY_FINGER_PHALANX_PROXIMAL" value="22" enum="HandJoint">
|
||
|
|
Pinky finger phalanx proximal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_PINKY_FINGER_PHALANX_INTERMEDIATE" value="23" enum="HandJoint">
|
||
|
|
Pinky finger phalanx intermediate joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_PINKY_FINGER_PHALANX_DISTAL" value="24" enum="HandJoint">
|
||
|
|
Pinky finger phalanx distal joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_PINKY_FINGER_TIP" value="25" enum="HandJoint">
|
||
|
|
Pinky finger tip joint.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_MAX" value="26" enum="HandJoint">
|
||
|
|
Represents the size of the [enum HandJoint] enum.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_FLAG_ORIENTATION_VALID" value="1" enum="HandJointFlags" is_bitfield="true">
|
||
|
|
The hand joint's orientation data is valid.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_FLAG_ORIENTATION_TRACKED" value="2" enum="HandJointFlags" is_bitfield="true">
|
||
|
|
The hand joint's orientation is actively tracked. May not be set if tracking has been temporarily lost.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_FLAG_POSITION_VALID" value="4" enum="HandJointFlags" is_bitfield="true">
|
||
|
|
The hand joint's position data is valid.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_FLAG_POSITION_TRACKED" value="8" enum="HandJointFlags" is_bitfield="true">
|
||
|
|
The hand joint's position is actively tracked. May not be set if tracking has been temporarily lost.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_FLAG_LINEAR_VELOCITY_VALID" value="16" enum="HandJointFlags" is_bitfield="true">
|
||
|
|
The hand joint's linear velocity data is valid.
|
||
|
|
</constant>
|
||
|
|
<constant name="HAND_JOINT_FLAG_ANGULAR_VELOCITY_VALID" value="32" enum="HandJointFlags" is_bitfield="true">
|
||
|
|
The hand joint's angular velocity data is valid.
|
||
|
|
</constant>
|
||
|
|
</constants>
|
||
|
|
</class>
|