Type

QualitativeQualityOptions

Quality options expressing a qualitative (subjective) quality level.

type QualitativeQualityOptions = {
	quality: number | QualityLevel;
	preferBitrate?: boolean;
	bitrateMode?: 'constant' | 'variable';
};

See QualityLevel.

Used by

• QualityOptions

Properties

quality

quality: number | QualityLevel;

A qualitative quality level. Either a number ranging from 0 to 1, where 0 means worst and 1 means best quality, or one of five named levels ('very-low', 'low', 'medium', 'high', 'very-high'), which map to 0, 0.25, 0.5, 0.75 and 1, respectively.

Values outside the [0, 1] range are also allowed for extreme behavior, but might break on certain systems.

Internally, either bitrate- or quantizer-driven encoding will be used, depending on availability and settings.

See QualityLevel.

preferBitrate

preferBitrate?: boolean;

When true, the quality level always maps to a bitrate, even if quantizer-based encoding is available. Useful when a predictable output size matters more than constant quality.

bitrateMode

bitrateMode?: 'constant' | 'variable';

The bitrate mode to use when encoding resolves to bitrate-based encoding.