WebXR Device API
The XRRay() constructor creates a new XRRay object which is a geometric ray described by an origin point and a direction vector.
Syntax
new XRRay()
new XRRay(origin)
new XRRay(origin, direction)
new XRRay(transform)
Parameters
origin- : A point object defining the 3-dimensional point in space that the ray originates from, in meters. All dimensions are optional, however, if provided, the origin's
wproperty must be 1.0. The object is initialized to{ x: 0.0, y: 0.0, z: 0.0, w: 1.0 }by default.
- : A point object defining the 3-dimensional point in space that the ray originates from, in meters. All dimensions are optional, however, if provided, the origin's
direction- : A vector object defining the ray's 3-dimensional directional vector. All dimensions are optional, however, if provided, the direction's
wproperty must be 0.0. The object is initialized to:{ x: 0.0, y: 0.0, z: -1.0, w: 0.0 }by default.
- : A vector object defining the ray's 3-dimensional directional vector. All dimensions are optional, however, if provided, the direction's
transform- : An XRRigidTransform object representing the position and orientation of the ray.
Return value
A newly-created XRRay object.
Exceptions
- TypeError
- : Thrown if one of the following conditions is met:
- all of
direction'sx,y, andzcoordinates are zero. direction'swcoordinate is not 0.0.origin'swcoordinate is not 1.0.
- all of
- : Thrown if one of the following conditions is met:
Examples
Creating XRRay objects
The XRRay() constructor allows you to create new rays by either providing an origin point and a direction vector, or by passing in an XRRigidTransform object.
// Default configuration
let ray1 = new XRRay();
// Specifying origin, leaving direction as default
let ray2 = new XRRay({ y: 0.5 });
// Specifying both, origin and direction
let origin = { x: 10.0, y: 10.0, z: 10.0, w: 1.0 };
let direction = { x: 10.0, y: 0.0, z: 0.0, w: 0.0 };
let ray3 = new XRRay(origin, direction);
// Using DOMPoint.fromPoint
let ray4 = new XRRay(DOMPoint.fromPoint(origin), DOMPoint.fromPoint(direction));
// Using rigid transform
let rigidTransform = new XRRigidTransform(
DOMPoint.fromPoint(origin),
DOMPoint.fromPoint(direction),
);
let ray5 = new XRRay(rigidTransform);
Specifications
Browser compatibility
See also
- DOMPoint
- DOMPoint.fromPoint_static
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
