Struct DsfFile

pub struct DsfFile { /* private fields */ }

In memory representation of a DSF file.

The DSF File Format Specification divides a DSF file into four chunks:

• DSD chunk: basic file headers, size and pointers to other chunks.
• Fmt chunk: information about the audio format e.g. sampling rate, etc.
• Data chunk: the audio samples.
• Metadata chunk: an optional ID3v2 metadata tag.

The fields of the DsfFile struct reflect this specification, with an additional File field for the underlying file.

Implementations

impl DsfFile

pub fn open(path: &Path) -> Result<DsfFile, Error>

Attempt to open and parse the metadata of DSF file in read-only mode. Sample data is not read into memory to keep the memory footprint small.

Errors

This function will return an error if path does not exist or is not a readable and valid DSF file.

Examples

 use dsf::DsfFile;
 use std::path::Path;

 let path = Path::new("my/music.dsf");

 match DsfFile::open(path) {
     Ok(dsf_file) => {
         println!("DSF file metadata:\n\n{}", dsf_file);
     }
     Err(error) => {
         println!("Error: {}", error);
     }
 }

pub fn file(&self) -> &File

Return a reference to the underlying File.

pub fn dsd_chunk(&self) -> &DsdChunk

Return a reference to the DsdChunk.

pub fn fmt_chunk(&self) -> &FmtChunk

Return a reference to the FmtChunk.

pub fn data_chunk(&self) -> &DataChunk

Return a reference to the DataChunk.

pub fn id3_tag(&self) -> &Option<Tag>

Return a reference to the optional ID3v2 Tag.

pub fn frames(&mut self) -> Result<Frames<'_>, Error>

Return a representation of the sample data as Frames.

Errors

This function will return an error if the sample data is not readable.

pub fn interleaved_u32_samples_iter( &mut self, ) -> Result<InterleavedU32SamplesIter<'_>, Error>

Return an InterleavedU32SamplesIter for the sample data contained in this DSF file.

Errors

This function will return an error if the sample data is not readable.

Trait Implementations

impl Display for DsfFile

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

Formats the value using the given formatter.