Source code
Revision control
Copy as Markdown
Other Tools
Test Info:
- This WPT test may be referenced by the following Test IDs:
- /webxr/hit-test/ar_hittest_subscription_refSpaces.https.html - WPT Dashboard Interop Dashboard
<!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>