lofty 0.25.3

Audio metadata library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

pub(super) mod properties;

use super::find_last_page;
use super::tag::VorbisComments;
use crate::config::ParseOptions;
use crate::error::FileParseError;
use crate::file::FileType;
use crate::ogg::constants::{OPUSHEAD, OPUSTAGS};
use properties::OpusProperties;

use std::io::{Read, Seek};

use lofty_attr::LoftyFile;

/// An OGG Opus file
#[derive(LoftyFile)]
#[lofty(read_fn = "Self::read_from")]
pub struct OpusFile {
	/// The vorbis comments contained in the file
	///
	/// NOTE: While a metadata packet is required, it isn't required to actually have any data.
	#[lofty(tag_type = "VorbisComments")]
	pub(crate) vorbis_comments_tag: VorbisComments,
	/// The file's audio properties
	pub(crate) properties: OpusProperties,
}

impl OpusFile {
	fn read_from<R>(reader: &mut R, parse_options: ParseOptions) -> Result<Self, FileParseError>
	where
		R: Read + Seek,
	{
		let file_information = super::read::read_from(reader, OPUSHEAD, OPUSTAGS, 2, parse_options)
			.map_err(|e| e.with_format(FileType::Opus))?;

		Ok(Self {
			properties: if parse_options.read_properties {
				properties::read_properties(reader, &file_information.1, &file_information.2)?
			} else {
				OpusProperties::default()
			},
			// A metadata packet is mandatory in Opus
			vorbis_comments_tag: file_information.0.unwrap_or_default(),
		})
	}
}