Enum Target

pub enum Target {
    Mp3,
    Opus,
    Aac,
    Vorbis,
    Flac,
    Wav,
}

A format a copy can be converted into.

Deliberately short. Every entry here is a format a portable player is likely to want, and each one costs a decoder somebody has to have: adding a target nobody asked for is a promise to keep it working.

Variants

Mp3

The one every device plays.

Opus

Best quality per byte at low bitrates, and what a modern player wants.

Aac

What Apple devices prefer, in an MP4 container.

Vorbis

The free lossy format Ogg carries.

Flac

Lossless, and much smaller than WAV: the reason to convert a WAV rip.

Wav

Uncompressed, for a device that plays nothing else.

Implementations

impl Target

pub fn parse(word: &str) -> Option<Target>

The target a typed word names, or None for a word that names none.

pub fn names() -> String

Every spelling accepted, for a message that offers what it refuses.

pub fn lossy_names() -> String

The targets that have a quality setting at all.

Read from the same table as everything else, so a format added tomorrow appears here without anybody remembering to add it — which is the whole reason the table exists.

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

Accepted quality settings for this encoder, for actionable refusals.

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

The file extension a converted file carries, without its dot.

pub fn lossless(self) -> bool

true when the target keeps every sample it was given.

pub fn keeps_embedded_art(self) -> bool

Whether a cover embedded in the source can travel into this target at all. false here is not this code declining to carry it — ffmpeg itself refuses to mux a picture stream into wav, opus or vorbis (verified directly: mapping a video stream into any of the three fails outright and produces no file), so the loss happens at the encoder whatever is asked of it. convert reads this same rule, once.

pub fn tags_it_would_drop( self, present: &BTreeMap<String, Vec<String>>, ) -> Vec<String>

Canonical tag keys present holds that this target is known to drop.

Empty for every target but wav, and empty for wav too when nothing present falls outside its vocabulary — a file tagged with only title, artist and album loses nothing by becoming a WAV.

Trait Implementations

impl Clone for Target

fn clone(&self) -> Target

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl PartialEq for Target

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Target

impl Eq for Target

impl StructuralPartialEq for Target