// Copyright (c) 2018-2020, The rav1e contributors. All rights reserved // // This source code is subject to the terms of the BSD 2 Clause License and // the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License // was not distributed with this source code in the LICENSE file, you can // obtain it at www.aomedia.org/license/software. If the Alliance for Open // Media Patent License 1.0 was not distributed with this source code in the // PATENTS file, you can obtain it at www.aomedia.org/license/patent. use crate::math::*; use crate::pixel::*; use crate::plane::*; #[cfg(feature = "serialize")] use serde::{Deserialize, Serialize}; /// Represents a raw video frame #[derive(Debug, Clone, Eq, PartialEq)] #[cfg_attr(feature = "serialize", derive(Serialize, Deserialize))] pub struct Frame { /// Planes constituting the frame. pub planes: [Plane; 3], } impl Frame { /// Creates a new frame with the given parameters. /// /// Allocates data for the planes. pub fn new_with_padding( width: usize, height: usize, chroma_sampling: ChromaSampling, luma_padding: usize, ) -> Self { let luma_width = width.align_power_of_two(3); let luma_height = height.align_power_of_two(3); let (chroma_decimation_x, chroma_decimation_y) = chroma_sampling.get_decimation().unwrap_or((0, 0)); let (chroma_width, chroma_height) = chroma_sampling.get_chroma_dimensions(luma_width, luma_height); let chroma_padding_x = luma_padding >> chroma_decimation_x; let chroma_padding_y = luma_padding >> chroma_decimation_y; Frame { planes: [ Plane::new(luma_width, luma_height, 0, 0, luma_padding, luma_padding), Plane::new( chroma_width, chroma_height, chroma_decimation_x, chroma_decimation_y, chroma_padding_x, chroma_padding_y, ), Plane::new( chroma_width, chroma_height, chroma_decimation_x, chroma_decimation_y, chroma_padding_x, chroma_padding_y, ), ], } } }