chromium/third_party/blink/web_tests/external/wpt/webxr/hit-test/ar_hittest_subscription_refSpaces.https.html

<!DOCTYPE html>
<script src="/resources/testharness.js"></script>
<script src="/resources/testharnessreport.js"></script>
<script src="../resources/webxr_util.js"></script>
<script src="../resources/webxr_math_utils.js"></script>
<script src="../resources/webxr_test_asserts.js"></script>
<script src="../resources/webxr_test_constants.js"></script>
<script src="../resources/webxr_test_constants_fake_world.js"></script>

<script>

// 1m above world origin.
const VIEWER_ORIGIN_TRANSFORM = {
  position: [0, 1, 0],
  orientation: [0, 0, 0, 1],
};

// 0.25m above world origin.
const FLOOR_ORIGIN_TRANSFORM = {
  position: [0, 0.25, 0],
  orientation: [0, 0, 0, 1],
};

const fakeDeviceInitParams = {
  supportedModes: ["immersive-ar"],
  views: VALID_VIEWS,
  floorOrigin: FLOOR_ORIGIN_TRANSFORM,    // aka mojo_from_floor
  viewerOrigin: VIEWER_ORIGIN_TRANSFORM,  // aka mojo_from_viewer
  supportedFeatures: ALL_FEATURES,
  world: createFakeWorld(5.0, 2.0, 5.0),  // webxr_test_constants_fake_world.js has detailed description of the fake world
};

// Generates a test function given the parameters for the hit test.
// |ray| - ray that will be used to subscribe to hit test.
// |expectedPoses| - array of expected pose objects. The poses are expected to be expressed in local space.
//                   Null entries in the array mean that the given entry will not be validated.
// |refSpaceName| - XRReferenceSpaceType - either 'local', 'local-floor' or 'viewer'.
let testFunctionGenerator = function(ray, expectedPoses, refSpaceName) {
  const testFunction = function(session, fakeDeviceController, t) {
    return Promise.all([
      session.requestReferenceSpace('local'),
      session.requestReferenceSpace('viewer'),
      session.requestReferenceSpace('local-floor'),
    ]).then(([localRefSpace, viewerRefSpace, localFloorRefSpace]) => {

      const refSpaceNameToSpace = {
        'local' : localRefSpace,
        'viewer' : viewerRefSpace,
        'local-floor' : localFloorRefSpace
      };

      const hitTestOptionsInit = {
        space: refSpaceNameToSpace[refSpaceName],
        offsetRay: ray,
      };

      return session.requestHitTestSource(hitTestOptionsInit).then(
        (hitTestSource) => new Promise((resolve, reject) => {

        const requestAnimationFrameCallback = function(time, frame) {
          const hitTestResults = frame.getHitTestResults(hitTestSource);

          t.step(() => {
            assert_equals(hitTestResults.length, expectedPoses.length, "Results length should match expected results length");
            for(const [index, expectedPose] of expectedPoses.entries()) {
              const pose = hitTestResults[index].getPose(localRefSpace);
              assert_true(pose != null, "Each hit test result should have a pose in local space");
              if(expectedPose != null) {
                assert_transform_approx_equals(pose.transform, expectedPose);
              }
            }
          });

          resolve();
        };

        t.step(() => {
          assert_true(hitTestSource != null, "Hit test source should not be null");
        });

        session.requestAnimationFrame(requestAnimationFrameCallback);
      }));
    });
  };

  return testFunction;
};

// Generates a test function that will use local space for hit test subscription.
// See testFunctionGenerator for explanation of other parameters.
const localBasedTestFunctionGenerator = function(ray, expectedPoses) {
  return testFunctionGenerator(ray, expectedPoses, 'local');
};

// Generates a test function that will use viewer space for hit test subscription.
// See testFunctionGenerator for explanation of other parameters.
const viewerBasedTestFunctionGenerator = function(ray, expectedPoses) {
  return testFunctionGenerator(ray, expectedPoses, 'viewer');
};

// Generates a test function that will use local-floor space for hit test subscription.
// See testFunctionGenerator for explanation of other parameters.
const localFloorBasedTestFunctionGenerator = function(ray, expectedPoses) {
  return testFunctionGenerator(ray, expectedPoses, 'local-floor');
};

// All test cases require local-floor and hit-test.
const sessionInit = { 'requiredFeatures': ['local-floor', 'hit-test'] };

// Pose of the first expected hit test result - straight ahead of the viewer, viewer-facing.
const pose_1 = {
  position: {x: 0.0, y: 1.0, z: -2.5, w: 1.0},
  orientation: {x: 0.0, y: -0.707, z: -0.707, w: 0.0},
    // Hit test API will set Y axis to the surface normal at the intersection point,
    // Z axis towards the ray origin and X axis to cross product of Y axis & Z axis.
    // If the surface normal and Z axis would be parallel, the hit test API
    // will attempt to use `up` vector ([0, 1, 0]) as the Z axis, and if it so happens that Z axis
    // and the surface normal would still be parallel, it will use the `right` vector ([1, 0, 0]) as the Z axis.
    // In this particular case, `up` vector will work so the resulting pose.orientation
    // becomes a rotation around [0, 1, 1] vector by 180 degrees.
};

xr_session_promise_test(
  "Ensures subscription to hit test works with viewer space - straight ahead - plane",
  viewerBasedTestFunctionGenerator(new XRRay(), [pose_1]),
  fakeDeviceInitParams, 'immersive-ar', sessionInit);

xr_session_promise_test("Ensures subscription to hit test works with viewer space - straight up - no results",
  viewerBasedTestFunctionGenerator(new XRRay({}, {x: 0.0, y: 1.0, z : 0.0}), []),
  fakeDeviceInitParams, 'immersive-ar', sessionInit);

const pose_2 = {
  position: {x: 0.0, y: 0.0, z: -2.5, w: 1.0},
  orientation: {x: 0.0, y: -0.707, z: -0.707, w: 0.0},
    // See comment for pose_1.orientation for details.
    // In this case, the hit test pose will have Y and Z axis towards the ray origin so it won't be used,
    // but `up` vector will work so the resulting pose.orientation
    // becomes a rotation around [0, 1, 1] vector by 180 degrees.
};

xr_session_promise_test("Ensures subscription to hit test works with local space",
  localBasedTestFunctionGenerator(new XRRay(), [pose_2]),
  fakeDeviceInitParams, 'immersive-ar', sessionInit);

const pose_3 = {
  position: {x: 0.0, y: 0.25, z: -2.5, w: 1.0},
  orientation: {x: 0.0, y: -0.707, z: -0.707, w: 0.0},
    // See comment for pose_1.orientation for details.
    // In this case, the hit test pose will have Y and Z axis towards the ray origin so it won't be used,
    // but `up` vector will work so the resulting pose.orientation
    // becomes a rotation around [0, 1, 1] vector by 180 degrees.
};

xr_session_promise_test("Ensures subscription to hit test works with local-floor space",
  localFloorBasedTestFunctionGenerator(new XRRay(), [pose_3]),
  fakeDeviceInitParams, 'immersive-ar', sessionInit);

</script>