Struct HevcEncoder 

pub struct HevcEncoder { /* private fields */ }

One software HEVC session for one capture.

Implementations

impl HevcEncoder

pub fn new(settings: &RustCaptureSettings, rgba: bool) -> Result<Self, String>

Open a session on host frames; rgba names the byte order they arrive in.

pub fn codec(&self) -> Codec

pub fn library(&self) -> &'static str

The library behind the session, as the logs name it.

pub fn is_fullcolor(&self) -> bool

pub fn bit_depth(&self) -> u32

The bits per sample the session codes.

pub fn is_full_range(&self) -> bool

The software 4:4:4 of x264’s kind signals full range.

pub fn last_reference(&self) -> Reference

pub fn holds_quantizer(&self) -> bool

Whether hold_quantizer holds a frame at its quantizer: x265 at a constant rate factor, kvazaar never. At a constant rate x265’s rate control moves a forced quantizer back to what its buffer affords (a key frame held at 18 came out 23.2 kB at 26.6 dB at 8 Mbit/s 1080p), and a fresh session whose buffer is the key frame’s budget plans it from a fraction of that buffer (102.5 kB at 34 dB where the budget was 250 kB and the picture before it 53.9 dB), so a constant-rate session holds none.

pub fn last_quality(&self) -> Option<u32>

The quality index (HEVC’s quantizer) the rate control last coded a frame at, held frames aside.

pub fn last_size(&self) -> Option<usize>

The bytes of the last frame the rate control coded, held frames aside.

pub fn invalidate_reference(&mut self, _frame_id: u16) -> bool

The library keeps its reference lists to itself: refused, so the caller codes a key frame.

pub fn hold_quantizer(&mut self, crf: u32)

Encode the next frame at the quantizer the quality index crf selects, leaving the session’s own quality for the frame after: the cleanup of a still screen, at a constant rate factor, where x265 takes it as the frame’s forced quantizer. A constant-rate session codes the frame under its rate control (holds_quantizer). kvazaar takes no quantizer but the one it opens at, and a re-open for the frame would need another to come back, each a key frame, so it codes the frame at its own.

pub fn reconfigure_rate( &mut self, settings: &RustCaptureSettings, ) -> Result<(), String>

Re-open the encoder when a rate or frame-rate setting changed: neither library’s rate control takes a new target while it runs.

pub fn encode_host( &mut self, pixels: &[u8], stride: usize, rgba: bool, frame_number: u64, crf: u32, force_idr: bool, ) -> Result<Vec<u8>, String>

Encode one packed host frame at the quality index crf, as a key frame when force_idr.

Trait Implementations

impl Send for HevcEncoder