4.1 MediaStreamConstraints dictionary

partial dictionary MediaStreamConstraints {
    (boolean or MediaTrackConstraints) depth = false;
};

The depth attribute MUST return the value it was initialized to. When the object is created, this attribute MUST be initialized to false. If true, the attribute represents a request that the MediaStream object returned as an argument of the NavigatorUserMediaSuccessCallback contains a depth track. If a Constraints structure is provided, it further specifies the nature and settings of the depth track.

4.2 MediaStream interface

partial interface MediaStream {
    sequence<MediaStreamTrack> getDepthTracks ();
};

The getDepthTracks() method, when invoked, MUST return a sequence of MediaStreamTrack objects representing the depth tracks in this stream.

The getDepthTracks() method MUST return a sequence that represents a snapshot of all the MediaStreamTrack objects in this stream's track set whose kind is equal to "depth". The conversion from the track set to the sequence is user agent defined and the order does not have to be stable between calls.

4.3 MediaStreamTrack interface

The kind attribute MUST, on getting, return the string "depth" if the object represents a depth track.

4.4 DepthData interface

[Constructor(unsigned long sw, unsigned long sh),
 Constructor(Uint16Array data, unsigned long sw, optional unsigned long sh),
 Exposed=Window,Worker]
interface DepthData {
    readonly    attribute unsigned long    width;
    readonly    attribute unsigned long    height;
    readonly    attribute Uint16Array      data;
    readonly    attribute CameraParameters parameters;
};

New DepthData objects MUST be initialised so that their width attribute is set to the number of entries per row in the depth data, their height attribute is set to the number of rows in the depth data, and their data attribute, except where an existing array is provided, is initialised to a new Uint16Array object. The Uint16Array object MUST use a new Canvas depth ArrayBuffer for its storage, and MUST have a zero start offset and a length equal to the length of its storage, in bytes.

A Canvas Depth ArrayBuffer is an ArrayBuffer whose data is represented in left-to-right order, row by row top to bottom, starting with the top left, with each pixel's depth component being given in that order for each pixel. Each depth component of each pixel represented in this array MUST be in the range 0..65536, representing the 16 bit value for that depth component. The depth components MUST be assigned consecutive indices starting with 0 for the top left pixel's depth component.

4.5 CameraParameters interface

Each DepthData interface is associated with a CameraParameters object. It represents the parameters of a pinhole camera model that describes the mathematical relationship between the coordinates of a 3D point and its projection onto the image plane.

interface CameraParameters {
    readonly    attribute double focalLength;
    readonly    attribute double horizontalViewAngle;
    readonly    attribute double verticalViewAngle;
};

The focalLength attribute, on getting, MUST return the focal length of the camera in millimeters.

The horizontalViewAngle attribute, on getting, MUST return the horizontal angle of view in degrees.

The verticalViewAngle attribute, on getting, MUST return the vertical angle of view in degrees.

4.6 CanvasRenderingContext2D interface

partial interface CanvasRenderingContext2D {
    DepthData createDepthData (double sw, double sh);
    DepthData createDepthData (DepthData depthdata);
    DepthData getDepthData (double sx, double sy, double sw, double sh);
    void      putDepthData (DepthData depthdata, double dx, double dy);
    void      putDepthData (DepthData depthdata, double dx, double dy, double dirtyX, double dirtyY, double dirtyWidth, double dirtyHeight);
};