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를 계산하되, transformedOffsetRay가 space의 native origin 좌표계에서 해석될 때, offsetRay가 space의 effective origin 좌표계에서 해석될 때와 동일한 광선을 나타내도록 한다.

6. hitTestSource의 offset ray를 transformedOffsetRay로 초기화한다.

7. hitTestSource를 반환한다.

cancel() 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행하여 히트 테스트 소스를 취소해야 한다:

1. hitTestSource가 active하지 않은 경우, InvalidStateError를 던지고 이 단계를 중단한다.

2. hitTestSource를 session의 활성 히트 테스트 소스 집합에서 제거한다.

session, profile, entityTypes, offsetRay로부터 transient input에 대한 히트 테스트 소스를 생성하기 위해, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. hitTestSource를 새 XRTransientInputHitTestSource로 둔다.

2. hitTestSource의 session을 session으로 초기화한다.

3. hitTestSource의 profile을 profile로 초기화한다.

4. hitTestSource의 entity types를 entityTypes로 초기화한다.

5. hitTestSource의 offset ray를 offsetRay로 초기화한다.

6. hitTestSource를 반환한다.

cancel() 메서드가 호출되면, 사용자 에이전트는 다음 단계를 실행하여 transient input에 대한 히트 테스트 소스를 취소해야 한다:

1. hitTestSource가 active하지 않은 경우, InvalidStateError를 던지고 이 단계를 중단한다.

2. hitTestSource를 session의 transient input에 대한 활성 히트 테스트 소스 집합에서 제거한다.

XRFrame frame, XRHitTestTrackableType의 배열 entityTypes, 그리고 native hit test result nativeResult가 주어졌을 때 히트 테스트 결과를 생성하기 위해, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. hitTestResult를 새 XRHitTestResult로 둔다.

2. session을 frame의 session으로 둔다.

3. device를 session의 XR device로 둔다.

4. device에 nativeResult의 native entity type, nativeEntityType를 조회한다.

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 boolean이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

3. pose를 새 XRPose로 둔다.

4. space를 새 XRSpace로 두고, native origin은 native origin으로, origin offset은 identity transform으로, 그리고 session은 frame의 session으로 설정한다.

5. frame이 나타내는 시점에서 baseSpace 안의 space의 pose를 채워 pose에 넣는다.

6. pose를 반환한다.

XRInputSource inputSource, XRFrame frame, XRHitTestTrackableType의 배열 entityTypes, 그리고 native hit test results의 배열 nativeResults가 주어졌을 때 transient input에 대한 히트 테스트 결과를 생성하기 위해, 사용자 에이전트는 다음 단계를 실행해야 한다:

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의 effective entityTypes 및 options의 effective 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의 effective entityTypes 및 options의 effective offsetRay로 transient input에 대한 히트 테스트 소스를 생성하여 hitTestSource로 둔다.

7. hitTestSource가 null이면, promise를 OperationError로 거부하고 이 단계를 중단한다.

8. 생성된 hitTestSource를 session의 transient input에 대한 활성 히트 테스트 소스 집합에 저장한다.

9. promise를 생성된 hitTestSource로 해결한다.

주어진 XRFrame frame에 대한 모든 히트 테스트 결과를 계산하기 위해, 사용자 에이전트는 다음 단계를 수행해야 한다:

1. frame으로 히트 테스트 결과 계산 알고리즘을 호출한다.

2. frame으로 transient input에 대한 히트 테스트 결과 계산 알고리즘을 호출한다.

주어진 XRFrame frame에 대한 히트 테스트 결과를 계산하기 위해, session의 활성 히트 테스트 소스 집합에 존재하는 각 히트 테스트 소스 hitTestSource에 대해, 사용자 에이전트는 다음 단계를 수행해야 한다:

1. entityTypes를 hitTestSource의 entity types로 둔다.

2. session을 frame의 session으로 둔다.

3. device를 session의 XR device로 둔다.

4. device의 트래킹 시스템에 hitTestSource의 native origin의 최신 coordinates를 조회한다.

5. hitTestSource의 offset ray, offsetRay를 coordinates에 상대적으로 표현된 것처럼 해석하고, 그 해석을 사용하여 native hit test를 수행하여 native hit test results nativeResults를 얻는다.

6. hitTestResults를 빈 list로 둔다.

7. nativeResults의 각 native hit test result nativeResult에 대해 다음 단계를 수행한다:

   1. frame, entityTypes, 그리고 nativeResult로부터 히트 테스트 결과를 생성하여 hitTestResult로 둔다.

   2. hitTestResult가 null이면, nativeResults의 다음 항목으로 계속한다.

   3. hitTestResults에 hitTestResult를 추가하되, 목록이 offsetRay에서 nativeResult까지의 광선을 따른 거리 순서로 정렬된 상태를 유지하도록 한다.

8. hitTestResults를 frame의 히트 테스트 소스에서 히트 테스트 결과로의 맵에 hitTestSource 키 아래 저장한다.

주어진 XRFrame frame에 대한 transient input에 대한 히트 테스트 결과를 계산하기 위해, session의 transient input에 대한 활성 히트 테스트 소스 집합에 존재하는 각 히트 테스트 소스 hitTestSource에 대해, 사용자 에이전트는 다음 단계를 수행해야 한다:

1. entityTypes를 hitTestSource의 entity types로 둔다.

2. session을 frame의 session으로 둔다.

3. device를 session의 XR device로 둔다.

4. candidateInputSources를 transient로 간주되고 활성 XR 입력 소스 목록에 포함된 모든 session의 입력 소스 집합으로 둔다.

5. matchingInputSources를 candidateInputSources에 포함된 입력 소스 중, 그 profiles 배열이 hitTestSource의 profile과 동일한 항목을 포함하는 모든 입력 소스의 집합으로 둔다.

6. hitTestResults를 XRTransientInputHitTestResults의 빈 배열로 둔다.

7. matchingInputSources의 각 transient input source inputSource에 대해:

   1. device의 트래킹 시스템에 inputSource의 targetRaySpace의 native origin의 최신 coordinates를 조회한다.

   2. hitTestSource의 offset ray를 coordinates에 상대적으로 표현된 것처럼 해석하고, 그 해석을 사용하여 native hit test를 수행하여 native hit test results nativeResults를 얻는다.

   3. frame, inputSource, entityTypes, 그리고 nativeResults로부터 transient input에 대한 히트 테스트 결과를 생성하여 hitTestResult로 둔다.

   4. hitTestResult를 hitTestResults 배열에 추가한다.

8. hitTestResults를 frame의 transient input에 대한 히트 테스트 소스에서 히트 테스트 결과로의 맵에 hitTestSource 키 아래 저장한다.

getHitTestResults(hitTestSource) 메서드가 XRFrame frame에서 호출될 때, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. frame의 active boolean이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

2. hitTestSource에 대한 항목이 frame의 히트 테스트 소스에서 히트 테스트 결과로의 맵에 존재하는지 확인한다. 항목이 존재하지 않으면, InvalidStateError를 던지고 이 단계를 중단한다.

3. frame의 히트 테스트 소스에서 히트 테스트 결과로의 맵에서 hitTestSource에 대한 항목을 찾아 results에 할당한다.

4. results를 반환한다.

getHitTestResultsForTransientInput(hitTestSource) 메서드가 XRFrame frame에서 호출될 때, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. frame의 active boolean이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

2. hitTestSource에 대한 항목이 frame의 transient input에 대한 히트 테스트 소스에서 히트 테스트 결과로의 맵에 존재하는지 확인한다. 항목이 존재하지 않으면, InvalidStateError를 던지고 이 단계를 중단한다.

3. frame의 transient input에 대한 히트 테스트 소스에서 히트 테스트 결과로의 맵에서 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가 모두 0이면, 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에 대해 matrix를 획득하려면

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 장치에 달려 있다.