// Copyright 2024 The ChromiumOS Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
use std::rc::Rc;
use crate::codec::av1::parser::FrameHeaderObu;
use crate::codec::av1::parser::ReferenceFrameType;
use crate::codec::av1::parser::SequenceHeaderObu;
use crate::codec::av1::parser::REFS_PER_FRAME;
use crate::encoder::av1::EncoderConfig;
use crate::encoder::av1::AV1;
use crate::encoder::stateless::av1::predictor::LowDelayAV1;
use crate::encoder::stateless::BitstreamPromise;
use crate::encoder::stateless::Predictor;
use crate::encoder::stateless::StatelessBackendResult;
use crate::encoder::stateless::StatelessCodec;
use crate::encoder::stateless::StatelessEncoderExecute;
use crate::encoder::stateless::StatelessVideoEncoderBackend;
use crate::encoder::EncodeResult;
use crate::encoder::FrameMetadata;
use crate::encoder::PredictionStructure;
use crate::encoder::Tunings;
use crate::BlockingMode;
mod predictor;
#[cfg(feature = "vaapi")]
pub mod vaapi;
pub struct BackendRequest
{
/// Current sequence's header OBU
sequence: SequenceHeaderObu,
/// Current frame OBU contains
frame: FrameHeaderObu,
/// Input frame to be encoded
input: P,
/// Input frame metadata
input_meta: FrameMetadata,
/// References for the frame to be encoded
/// Use `ReferenceFrameType::Golden - ReferenceFrameType::Last` for indexing
references: [Option>; REFS_PER_FRAME],
/// The reference frame search priority list. From highest to lowest
/// Use [`ReferenceFrameType::Intra`] for invalid
ref_frame_ctrl_l0: [ReferenceFrameType; REFS_PER_FRAME],
ref_frame_ctrl_l1: [ReferenceFrameType; REFS_PER_FRAME],
/// Period between intra frames
intra_period: u32,
/// Period between intra frame and P frame
ip_period: u32,
/// [`Tunings`] for the frame
tunings: Tunings,
/// Container for the request output. [`StatelessAV1EncoderBackend`] impl shall move it and
/// append the slice data to it. This prevents unnecessary copying of bitstream around.
coded_output: Vec,
}
impl StatelessCodec for AV1
where
Backend: StatelessVideoEncoderBackend,
{
type Reference = Backend::Reconstructed;
type Request = BackendRequest;
type CodedPromise = BitstreamPromise;
type ReferencePromise = Backend::ReconPromise;
}
/// Trait for stateless encoder backend for H.264
pub trait StatelessAV1EncoderBackend: StatelessVideoEncoderBackend {
/// Submit a [`BackendRequest`] to the backend. This operation returns both a
/// [`StatelessVideoEncoderBackend::ReconPromise`] and a
/// [`StatelessVideoEncoderBackend::CodedPromise`] with resulting slice data.
fn encode_tile_group(
&mut self,
request: BackendRequest,
) -> StatelessBackendResult<(Self::ReconPromise, Self::CodedPromise)>;
}
pub type StatelessEncoder =
crate::encoder::stateless::StatelessEncoder;
impl StatelessEncoderExecute
for StatelessEncoder
where
Backend: StatelessAV1EncoderBackend,
{
fn execute(
&mut self,
request: BackendRequest,
) -> EncodeResult<()> {
let meta = request.input_meta.clone();
// The [`BackendRequest`] has a frame from predictor. Decresing internal counter.
self.predictor_frame_count -= 1;
log::trace!("submitting new request");
let (recon, bitstream) = self.backend.encode_tile_group(request)?;
// Wrap promise from backend with headers and metadata
let tilegroup_promise = BitstreamPromise { bitstream, meta };
self.output_queue.add_promise(tilegroup_promise);
self.recon_queue.add_promise(recon);
Ok(())
}
}
impl StatelessEncoder
where
Backend: StatelessAV1EncoderBackend,
{
fn new_av1(backend: Backend, config: EncoderConfig, mode: BlockingMode) -> EncodeResult {
let predictor: Box> = match config.pred_structure {
PredictionStructure::LowDelay { limit } => Box::new(LowDelayAV1::new(config, limit)),
};
Self::new(backend, mode, predictor)
}
}