WebXR ヒットテストモジュール

session、space、entityTypes、offsetRay から ヒットテストソースを作成するために、ユーザーエージェントは次の 手順を実行しなければなりません。

1. hitTestSource を新しい XRHitTestSource とします。

2. hitTestSource の session を session に初期化します。

3. hitTestSource の native origin を、space の native origin に初期化します。

4. hitTestSource の entity types を entityTypes に初期化します。

5. offsetRay と space から transformedOffsetRay を計算します。これは、 space の native origin 座標系で解釈されたときに、 space の effective origin 座標系で解釈された offsetRay と同じレイを表すようにします。

6. hitTestSource の offset ray を transformedOffsetRay に初期化します。

7. hitTestSource を返します。

cancel() メソッドが呼び出されたとき、ユーザーエージェントは次の手順を実行することにより ヒットテストソースをキャンセルしなければなりません。

1. hitTestSource が active でない場合、InvalidStateError を投げ、これらの手順を中止します。

2. hitTestSource を session の有効なヒットテストソースの集合から削除します。

session、profile、entityTypes、offsetRay から 一時的入力用のヒットテストソースを作成する ために、ユーザー エージェントは次の手順を実行しなければなりません。

1. hitTestSource を新しい XRTransientInputHitTestSource とします。

2. hitTestSource の session を session に初期化します。

3. hitTestSource の profile を profile に初期化します。

4. hitTestSource の entity types を entityTypes に初期化します。

5. hitTestSource の offset ray を offsetRay に初期化します。

6. hitTestSource を返します。

cancel() メソッドが呼び出されたとき、ユーザーエージェントは次の手順を実行することにより 一時的入力用のヒットテストソースをキャンセル しなければなりません。

1. hitTestSource が active でない場合、InvalidStateError を投げ、これらの手順を中止します。

2. hitTestSource を session の一時的入力用の有効なヒット テストソースの集合から削除します。

XRFrame frame、XRHitTestTrackableType の配列 entityTypes、および native hit test result nativeResult が与えられたとき、 ヒットテスト結果を作成するために、ユーザー エージェントは次の手順を実行しなければなりません。

1. hitTestResult を新しい XRHitTestResult とします。

2. session を frame の session とします。

3. device を session の XR device とします。

4. nativeResult の native entity type、nativeEntityType について device に問い合わせます。

5. native entity type から変換し、 nativeEntityType を entityType にします。

6. entityType が null であるか、entityTypes 配列に存在しない場合、 null を返し、これらの手順を中止します。

7. hitTestResult の frame を frame に設定します。

8. hitTestResult の native origin を、 nativeResult から取得された native origin に設定します。

9. hitTestResult を返します。

getPose(baseSpace) メソッドが hitTestResult 上で呼び出されたとき、ユーザーエージェントは次の手順を実行しなければなりません。

1. frame を hitTestResult の frame とします。

2. frame の active ブール値が false である場合、InvalidStateError を投げ、これらの手順を中止します。

3. pose を新しい XRPose とします。

4. space を新しい XRSpace とし、native origin は native origin に、origin offset は identity transform に、そして session は frame の session に設定します。

5. frame によって表される時点で、baseSpace における space のポーズを pose に取り込みます。

6. pose を返します。

XRInputSource inputSource、XRFrame frame、XRHitTestTrackableType の配列 entityTypes、および native hit test results の配列 nativeResults が与えられたとき、 一時的入力用のヒットテスト結果を作成する ために、ユーザーエージェントは次の手順を実行しなければなりません。

1. hitTestResult を新しい XRTransientInputHitTestResult とします。

2. hitTestResult の frame を frame に設定します。

3. hitTestResult の inputSource を inputSource に設定します。

4. results を XRHitTestResult の空配列とします。

5. nativeResults 内の各 nativeResult について:

   1. frame、entityTypes、および nativeResult から ヒットテスト結果を作成し、 result とします。

   2. result が null の場合、 nativeResults 内の次の項目へ進みます。

   3. result を results 配列に追加します。

6. hitTestResult の results を results に設定します。

7. hitTestResult を返します。

requestHitTestSource(options) メソッドは、XRSession session 上で呼び出されたとき、次の手順を実行しなければなりません。

1. promise を 新しい Promise とします。

2. hit-test 機能記述子が session の 有効化された機能のリストに含まれていない場合、promise を NotSupportedError で却下し、これらの手順を中止します。

3. session の ended 値が true である場合、InvalidStateError を投げ、これらの手順を中止します。

4. ユーザーエージェントは、不合理な数の要求がある場合、promise を NotAllowedError で却下し、これらの手順を中止してもよいです。

5. すべてのヒットテスト結果を計算するアルゴリズムが session の フレーム更新のリストにまだ存在しない場合は、 それを追加します。

6. session、options の space、 options の 有効な entityTypes、および options の 有効な offsetRay を用いて、 ヒットテストソースを作成し、 hitTestSource とします。

7. hitTestSource が null である場合、promise を OperationError で却下し、 これらの手順を中止します。

8. 作成された hitTestSource を session の 有効なヒットテストソースの集合に格納します。

9. promise を、作成された hitTestSource で解決します。

requestHitTestSourceForTransientInput(options) メソッドは、XRSession session 上で呼び出されたとき、次の手順を実行しなければなりません。

1. promise を 新しい Promise とします。

2. hit-test 機能 記述子が session の 有効化された機能のリストに含まれていない場合、promise を NotSupportedError で却下し、これらの手順を中止します。

3. session の ended 値が true である場合、InvalidStateError を投げ、これらの手順を中止します。

4. ユーザーエージェントは、不合理な数の要求がある場合、promise を NotAllowedError で却下し、これらの手順を中止してもよいです。

5. すべてのヒットテスト結果を計算するアルゴリズムが session の フレーム更新のリストにまだ存在しない場合は、 それを追加します。

6. session、options の profile、 options の 有効な entityTypes、および options の 有効な offsetRay を用いて、 一時的入力用のヒットテストソースを 作成し、hitTestSource とします。

7. hitTestSource が null である場合、promise を OperationError で却下し、 これらの手順を中止します。

8. 作成された hitTestSource を session の 一時的入力用の有効なヒット テストソースの集合に格納します。

9. promise を、作成された hitTestSource で解決します。

与えられた XRFrame frame について、すべてのヒットテスト結果を計算するために、ユーザーエージェントは次の手順を 実行しなければなりません。

1. frame を用いて ヒットテスト結果を計算するアルゴリズムを呼び出します。

2. frame を用いて 一時的入力のヒットテスト結果を 計算するアルゴリズムを呼び出します。

与えられた XRFrame frame について、session の 有効なヒットテストソースの集合に存在する各ヒットテストソース hitTestSource について、ヒットテスト結果を計算するために、ユーザー エージェントは次の手順を実行しなければなりません。

1. entityTypes を hitTestSource の entity types とします。

2. session を frame の session とします。

3. device を session の XR device とします。

4. hitTestSource の native origin の最新の coordinates を、device のトラッキングシステムに問い合わせます。

5. hitTestSource の offset ray、offsetRay を coordinates に相対して表現されているものとして解釈し、その解釈を使用して native hit test を実行し、native hit test results nativeResults を取得します。

6. hitTestResults を空の リストとします。

7. nativeResults 内の各 native hit test result nativeResult について、 次の手順を実行します。

   1. frame、entityTypes、および nativeResult から ヒットテスト結果を作成し、 hitTestResult とします。

   2. hitTestResult が null である場合、 nativeResults 内の次の項目へ進みます。

   3. hitTestResults が、offsetRay から nativeResult までの レイに沿った距離でソートされたままになるように、 hitTestResult を hitTestResults に追加します。

8. hitTestResults を、frame の ヒットテストソースから ヒットテスト結果へのマップに、hitTestSource キーの下で格納します。

与えられた XRFrame frame について、session の 一時的入力用の有効なヒットテスト ソースの集合に存在する各ヒットテストソース hitTestSource について、 一時的入力のヒットテスト結果を計算する ために、ユーザーエージェントは次の手順を実行しなければなりません。

1. entityTypes を hitTestSource の entity types とします。

2. session を frame の session とします。

3. device を session の XR device とします。

4. candidateInputSources を、有効な XR 入力ソースのリストに含まれる session のすべての入力ソースのうち、一時的とみなされるものの集合とします。

5. matchingInputSources を、 candidateInputSources に含まれるすべての入力ソースのうち、その profiles 配列が、hitTestSource の profile と等しい項目を含むものの集合とします。

6. hitTestResults を XRTransientInputHitTestResults の空配列とします。

7. matchingInputSources 内の各一時的入力ソース inputSource について:

   1. inputSource の targetRaySpace の native origin の最新の coordinates を、device のトラッキングシステムに問い合わせます。

   2. hitTestSource の offset ray を、 coordinates に相対して表現されているものとして解釈し、その解釈を使用して native hit test を実行し、native hit test results nativeResults を取得します。

   3. frame、inputSource、 entityTypes、および nativeResults から 一時的入力用のヒットテスト結果を 作成し、hitTestResult とします。

   4. hitTestResult を hitTestResults 配列に追加します。

8. hitTestResults を、frame の 一時的入力用の ヒットテストソースからヒットテスト結果へのマップに、 hitTestSource キーの下で格納します。

getHitTestResults(hitTestSource) メソッドが XRFrame frame 上で呼び出されたとき、ユーザーエージェントは次の手順を実行しなければなりません。

1. frame の active ブール値が false の場合、InvalidStateError を投げ、これらの手順を中止します。

2. hitTestSource の項目が frame の ヒットテストソースから ヒットテスト結果へのマップに存在することを確認します。項目が存在しない場合、InvalidStateError を投げ、これらの手順を中止します。

3. frame の ヒットテストソースから ヒットテスト結果へのマップ内で hitTestSource の項目を検索し、 それを results に代入します。

4. results を返します。

getHitTestResultsForTransientInput(hitTestSource) メソッドが XRFrame frame 上で呼び出されたとき、ユーザーエージェントは次の手順を実行しなければなりません。

1. frame の active ブール値が false の場合、InvalidStateError を投げ、これらの手順を中止します。

2. hitTestSource の項目が frame の 一時的入力用の ヒットテストソースからヒットテスト結果へのマップに存在することを確認します。項目が存在しない場合、 InvalidStateError を投げ、これらの手順を中止します。

3. frame の 一時的入力用の ヒットテストソースからヒットテスト結果へのマップ内で hitTestSource の項目を検索し、 それを results に代入します。

4. results を返します。

XRRay(origin, direction) コンストラクターは、 呼び出されたときに次の手順を実行しなければなりません。

1. ray を新しい XRRay とします。

2. ray の origin を { x: 0.0, y: 0.0, z: 0.0, w: 1.0 } に初期化します。

3. ray の direction を { x: 0.0, y: 0.0, z: -1.0, w: 0.0 } に初期化します。

4. direction の x、 y、 および z がすべてゼロである場合、TypeError を投げ、これらの手順を中止します。

5. direction の w が 0.0 でない場合、TypeError を投げ、これらの手順を中止します。

6. origin の w が 1.0 でない場合、TypeError を投げ、これらの手順を中止します。

7. ray の origin の x 値を origin の x に、 y 値を origin の y に、 そして z 値を origin の z に初期化します。

8. ray の direction の x 値を direction の x に、 y 値を direction の y に、 そして z 値を direction の z に初期化します。

9. ray の direction の x、 y、 および z 成分を正規化します。

10. ray の matrix を null に初期化します。

11. ray を返します。

XRRay(transform) コンストラクターは、 呼び出されたときに次の手順を実行しなければなりません。

1. ray を新しい XRRay とします。

2. ray の origin を { x: 0.0, y: 0.0, z: 0.0, w: 1.0 } に初期化します。

3. ray の direction を { x: 0.0, y: 0.0, z: -1.0, w: 0.0 } に初期化します。

4. transform の matrix を左から前乗算することにより、ray の origin を変換し、ray をその結果に設定します。

5. transform の matrix を左から前乗算することにより、ray の direction を変換し、ray をその結果に設定します。

6. ray の direction の x、 y、 および z 成分を正規化します。

7. ray の matrix を null に初期化します。

8. ray を返します。

与えられた XRRay ray について、その行列を取得するには

1. ray の matrix が null でない場合、次の手順を実行します。

   1. matrix に対する IsDetachedBuffer 操作が false の場合、ray の matrix を返します。

2. z をベクトル [0, 0, -1] とします。

3. axis を z と ray の direction の ベクトル外積、z × direction とします。

4. cos_angle を z と ray の direction の スカラー内積、z · direction とします。

5. 次に基づいて rotation を設定します。

   cos_angle が -1 より大きく 1 より小さい場合

   rotation を、axis の周りで arccos(cos_angle) だけ右手系の平面回転を表す 回転行列に設定します。

   それ以外で、cos_angle が -1 の場合

   rotation を、ベクトル [1, 0, 0] の周りで arccos(cos_angle) だけ右手系の平面回転を表す回転行列に設定します。

   それ以外の場合

   rotation を単位行列に設定します。

6. translation を、ray の origin に対応する成分を持つ平行移動行列とします。

7. matrix を、列ベクトル表記において rotation を左から translation に前乗算した結果（すなわち translation * rotation）とします。

8. ray の matrix を matrix に設定します。

9. matrix を返します。

XRRay ray から任意のエンティティ entity までの レイに沿った距離 distance は、 ray.origin + ray.direction * distance がエンティティ entity に属する点となり、distance が非負であり、かつ上記の述語が なお成立するより小さい distance の値が存在しないように定義されます。 「エンティティに属する点」の意味を定義するのは XR device に委ねられます。