Struct Level 

pub struct Level {
    pub mode: Option<LevelMode>,
    pub lufs: Option<f64>,
    pub gain_db: Param,
    pub ref_dbfs: Option<f64>,
    pub nat_db: Option<f64>,
    pub duck_db: Option<f64>,
    pub fade_in: Option<f64>,
    pub fade_out: Option<f64>,
}

ffcine.audio.level/1: per-clip gain, R128 levelling, ducking and fades.

Fields

mode: Option<LevelMode>

Defaults to the bus’s: dialogue, music, ambience, sfx.

lufs: Option<f64>

Explicit target in LUFS, overriding mode.

gain_db: Param

Extra gain after levelling (may be keyframed).

ref_dbfs: Option<f64>

sfx mode reference (dBFS RMS of the loudest 100 ms).

nat_db: Option<f64>

Music level under a dialogue-track clip in music mode (dB from -22 LUFS).

duck_db: Option<f64>

How far the music dips while this clip plays (dialogue: -14, nat: -7; SFX: 0, for punchlines like a record scratch).

fade_in: Option<f64>

Fades in seconds (default: dialogue 0.125 crossfade, ambience 0.8, others 0.01).

fade_out: Option<f64>

Implementations

impl Level

pub fn mode(&self, bus: Bus) -> LevelMode

pub fn audible(&self, bus: Bus) -> bool

Whether the clip is heard at all (audio: music shots without nat_db aren’t).

pub fn target(&self, bus: Bus) -> Option<f64>

Integrated loudness target (LUFS), None for no levelling.

pub fn target_in(&self, bus: Bus, d: &ClipDefaults) -> Option<f64>

Level::target with the dialogue and nat targets of d (project.mix).

pub fn duck(&self, bus: Bus) -> f64

The music duck while this clip plays (dB, <= 0).

pub fn duck_in(&self, bus: Bus, d: &ClipDefaults) -> f64

Level::duck with the dips of d (project.mix).

Trait Implementations

impl Clone for Level

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Level

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Level

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Level

where Level: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Level

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Level

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Level