WebXR 핸드 입력 모듈 - 레벨 1

partial interface XRInputSource {
   [SameObject] readonly attribute XRHand? hand;
};

enum XRHandJoint {
  "wrist",

  "thumb-metacarpal",
  "thumb-phalanx-proximal",
  "thumb-phalanx-distal",
  "thumb-tip",

  "index-finger-metacarpal",
  "index-finger-phalanx-proximal",
  "index-finger-phalanx-intermediate",
  "index-finger-phalanx-distal",
  "index-finger-tip",

  "middle-finger-metacarpal",
  "middle-finger-phalanx-proximal",
  "middle-finger-phalanx-intermediate",
  "middle-finger-phalanx-distal",
  "middle-finger-tip",

  "ring-finger-metacarpal",
  "ring-finger-phalanx-proximal",
  "ring-finger-phalanx-intermediate",
  "ring-finger-phalanx-distal",
  "ring-finger-tip",

  "pinky-finger-metacarpal",
  "pinky-finger-phalanx-proximal",
  "pinky-finger-phalanx-intermediate",
  "pinky-finger-phalanx-distal",
  "pinky-finger-tip"
};

[Exposed=Window]
interface XRHand {
    iterable<XRHandJoint, XRJointSpace>;

    readonly attribute unsigned long size;
    XRJointSpace get(XRHandJoint key);
};

각 XRHand 객체는 [[joints]] 내부 슬롯을 가지며, 이는 키가 XRHandJoint 타입이고 값이 XRJointSpace 타입인 쌍들의 정렬된 맵입니다。

내부 슬롯 [[joints]]의 순서는 골격 관절 아래의 관절 목록에 의해 주어집니다。

[[joints]]는 세션 동안 변경되어서는 안 됩니다。

반복할 값 쌍은 XRHand 객체에 대해 키가 XRHandJoint이고 값이 해당 XRHandJoint에 대응하는 XRJointSpace인 값 쌍들의 목록이며, 그 순서는 골격 관절 아래의 관절 목록에 따릅니다。

get(jointName) 메서드는 XRHand의 this에서 호출될 때 다음 단계를 실행해야 합니다：

1. joints를 this의 [[joints]] 내부 슬롯의 값으로 둡니다。

2. joints[jointName]를 반환합니다。(알 수 없는 jointName의 경우 undefined를 반환함을 의미합니다。）

[Exposed=Window]
interface XRJointSpace: XRSpace {
  readonly attribute XRHandJoint jointName;
};

partial interface XRFrame {
    XRJointPose? getJointPose(XRJointSpace joint, XRSpace baseSpace);
    boolean fillJointRadii(sequence<XRJointSpace> jointSpaces, Float32Array radii);

    boolean fillPoses(sequence<XRSpace> spaces, XRSpace baseSpace, Float32Array transforms);
};

getJointPose(XRJointSpace joint, XRSpace baseSpace) 메서드는 해당 joint의 baseSpace에 대한 포즈를 XRJointPose로 반환하며, XRFrame의 시간을 기준으로 한다.

이 메서드가 호출될 때, UA는 다음을 실행해야 한다:

1. frame을 this로 한다.

2. session을 frame의 session 객체로 한다.

3. frame의 active가 false면 InvalidStateError 발생 후 종료한다.

4. baseSpace나 joint의 session이 this session과 다르면 InvalidStateError 발생 후 종료한다.

5. pose를 session의 relevant realm에 새로운 XRJointPose 객체로 생성한다.

6. frame이 나타내는 시점에서 joint의 baseSpace에서의 포즈 초기화를 pose에 force emulation=false로 해서 채운다.

7. pose가 null이면 null을 리턴한다.

8. pose의 radius 를 joint의 반지름 값으로 하며 필요시 에뮬레이션한다.

9. pose를 반환한다.

fillJointRadii(sequence<XRJointSpace> jointSpaces, Float32Array radii) 메서드는 jointSpaces에 해당하는 radii에 반지름 값을 쓰며, 모든 공간이 유효한 포즈를 갖는지 boolean으로 반환한다.

이 메서드가 XRFrame frame에서 호출될 때 UA는 다음을 반드시 수행해야 한다:

1. frame을 this로 한다.

2. session을 frame의 session 객체로 한다.

3. frame의 active가 false면 InvalidStateError 발생 후 종료.

4. jointSpaces 내 각 joint에 대해:

   1. joint의 session이 session과 다르면 InvalidStateError 발생 후 종료.

5. jointSpaces 길이가 radii의 요소 개수보다 크면 TypeError 발생 후 종료.

6. offset을 0으로 하는 새 숫자 변수로 둔다.

7. allValid을 true로 한다.

8. jointSpaces 내 모든 joint에 대해:

   1. offset의 radii 값을 다음과 같이 설정함:

      UA가 joint의 hand의 모든 관절 포즈를 얻을 수 있으면:

      offset의 radii에 해당 반지름을 설정.

      아니면

      offset의 radii에 NaN을 설정.

      allValid에 false를 대입.

   2. offset을 1 증가.

9. allValid을 반환.

fillPoses(sequence<XRSpace> spaces, XRSpace baseSpace, Float32Array transforms) 메서드는 spaces 각각의 baseSpace 기준 포즈 행렬을 transforms에 채우고, 모든 공간이 유효한 포즈를 가지는지 boolean으로 반환한다.

이 메서드가 XRFrame frame에서 호출되면, UA는 다음을 수행해야 한다:

1. frame을 this로 한다.

2. session을 frame의 session 객체로 한다.

3. frame의 active가 false면 InvalidStateError 발생 후 종료.

4. spaces 시퀀스 내 각 space에 대해:

   1. space의 session이 session과 다르면 InvalidStateError 발생 후 종료.

5. baseSpace의 session이 session과 다르면 InvalidStateError 발생 후 종료.

6. spaces 길이 * 16이 transforms의 요소 개수보다 크면 TypeError 발생 후 종료.

7. offset을 0으로 하는 새 숫자 변수로 둠.

8. pose를 다음 기준으로 초기화:

   fillPoses()가 이전에 호출된 적 있으면 UA가 객체 재사용 허용

   pose는 앞서 호출에 사용된 객체 동일하게 둔다.

   아니면

   pose를 session의 relevant realm에 새로운 XRPose 객체로 생성.

9. allValid을 true로 한다.

10. spaces 내 각 space에 대해:

    1. frame이 나타내는 시점에서 space의 baseSpace 기준 포즈 초기화를 pose에 채운다.

    2. pose가 null이면 아래 실행:

    3. offset부터 16개의 transforms 요소를 NaN으로 설정.

    4. allValid을 false로 한다.

    5. pose가 null 아니면 pose의 matrix 멤버 요소 전체를 offset부터 transforms에 복사한다.

    6. offset을 16 증가.

11. allValid을 반환.

[Exposed=Window]
interface XRJointPose: XRPose {
    readonly attribute float radius;
};