Web Codecs APIwindow_and_dedicated
The allocationSize() method of the VideoFrame interface returns the number of bytes required to hold the video as filtered by options passed into the method.
Syntax
allocationSize()
allocationSize(options)
Parameters
options- : An object containing the following:
rect- : The rectangle of pixels to copy from the
VideoFrame. If unspecified the VideoFrame.visibleRect will be used. This is in the format of a dictionary object containing:x: The x-coordinate.y: The y-coordinate.width: The width of the frame.height: The height of the frame.
- : The rectangle of pixels to copy from the
layout- : A list containing the following values for each plane in the
VideoFrame. Planes may not overlap. If unspecified the planes will be tightly packed:offset- : An integer representing the offset in bytes where the given plane begins.
stride- : An integer representing the number of bytes, including padding, used by each row of the plane.
- : A list containing the following values for each plane in the
format- : A pixel format for the pixel data in the
destination. Can be set to"RGBA","RGBX","BGRA","BGRX". If unspecified, the VideoFrame.format will be used.
- : A pixel format for the pixel data in the
colorSpace- : Specifies the color space of the pixel data in the
destination. Can be set to"srgb"for the sRGB color space or"display-p3"for the display-p3 color space. Only applicable for RGB pixel formats. If unspecified,"srgbwill be used.
- : Specifies the color space of the pixel data in the
- : An object containing the following:
Return value
An integer containing the number of bytes needed to hold the frame as specified by options.
Examples
In the following example the allocationSize is returned for the rectangle at top left with dimensions of 800 by 600.
const videoRect = {
x: 0,
y: 0,
width: 800,
height: 600,
};
let size = VideoFrame.allocationSize({ rect: videoRect });
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
