VideoFrame: allocationSize() method
Baseline
2024
Newly available
Since September 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Note: This feature is available in Dedicated Web Workers.
Phương thức allocationSize() của giao diện VideoFrame trả về số byte cần thiết để chứa video được lọc theo các tùy chọn được truyền vào phương thức.
Cú pháp
allocationSize()
allocationSize(options)
Tham số
optionsOptional-
Một đối tượng chứa các thuộc tính sau:
rectOptional-
Hình chữ nhật của các pixel cần sao chép từ
VideoFrame. Nếu không được chỉ định,visibleRectsẽ được dùng. Định dạng là một đối tượng từ điển chứa:x: Tọa độ x.y: Tọa độ y.width: Chiều rộng của khung hình.height: Chiều cao của khung hình.
layoutOptional-
Danh sách chứa các giá trị sau cho mỗi mặt phẳng trong
VideoFrame. Các mặt phẳng không được chồng lên nhau. Nếu không được chỉ định, các mặt phẳng sẽ được đóng gói chặt chẽ: formatOptional-
Định dạng pixel cho dữ liệu pixel trong
destination. Có thể đặt thành"RGBA","RGBX","BGRA","BGRX". Nếu không được chỉ định,formatsẽ được dùng. colorSpaceOptional-
Chỉ định không gian màu của dữ liệu pixel trong
destination. Có thể đặt thành"srgb"cho không gian màu sRGB hoặc"display-p3"cho không gian màu display-p3. Chỉ áp dụng cho định dạng pixel RGB. Nếu không được chỉ định,"srgb"sẽ được dùng.
Giá trị trả về
Một số nguyên chứa số byte cần thiết để chứa khung hình được chỉ định bởi options.
Ví dụ
Trong ví dụ sau, allocationSize được trả về cho hình chữ nhật ở góc trên bên trái với kích thước 800 x 600.
const videoRect = {
x: 0,
y: 0,
width: 800,
height: 600,
};
let size = VideoFrame.allocationSize({ rect: videoRect });
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebCodecs> # dom-videoframe-allocationsize> |