use super::fourcc::{FourCC,ReadFourCC, WriteFourCC, LABL_SIG, NOTE_SIG, ADTL_SIG, LTXT_SIG, DATA_SIG}; use super::list_form::collect_list_form; use byteorder::{WriteBytesExt, ReadBytesExt, LittleEndian}; use encoding::{DecoderTrap,EncoderTrap}; use encoding::{Encoding}; use encoding::all::ASCII; use std::io::{Cursor, Error, Read, Write}; #[derive(Copy,Clone, Debug)] struct RawCue { cue_point_id : u32, frame : u32, chunk_id : FourCC, chunk_start : u32, block_start : u32, frame_offset : u32 } impl RawCue { fn write_to(cues : Vec) -> Vec { let mut writer = Cursor::new(vec![0u8; 0]); writer.write_u32::(cues.len() as u32).unwrap(); for cue in cues.iter() { writer.write_u32::(cue.cue_point_id).unwrap(); writer.write_u32::(cue.frame).unwrap(); writer.write_fourcc(cue.chunk_id).unwrap(); writer.write_u32::(cue.chunk_start).unwrap(); writer.write_u32::(cue.block_start).unwrap(); writer.write_u32::(cue.frame_offset).unwrap(); } writer.into_inner() } fn read_from(data : &[u8]) -> Result,Error> { let mut rdr = Cursor::new(data); let count = rdr.read_u32::()?; let mut retval : Vec = vec![]; for _ in 0..count { retval.push( Self { cue_point_id : rdr.read_u32::()?, frame : rdr.read_u32::()?, chunk_id : rdr.read_fourcc()?, chunk_start : rdr.read_u32::()?, block_start : rdr.read_u32::()?, frame_offset : rdr.read_u32::()? }) } Ok( retval ) } } #[derive(Clone, Debug)] struct RawLabel { cue_point_id : u32, text : Vec } impl RawLabel { fn write_to(&self) -> Vec { let mut writer = Cursor::new(vec![0u8;0]); writer.write_u32::(self.cue_point_id as u32).unwrap(); writer.write(&self.text).unwrap(); writer.into_inner() } fn read_from(data : &[u8]) -> Result { let mut rdr = Cursor::new(data); let length = data.len(); Ok( Self { cue_point_id : rdr.read_u32::()?, text : { let mut buf = vec![0u8; (length - 4) as usize ]; rdr.read_exact(&mut buf)?; buf } }) } } #[derive(Clone, Debug)] struct RawNote { cue_point_id : u32, text : Vec } impl RawNote { fn write_to(&self) -> Vec { let mut writer = Cursor::new(vec![0u8; 0]); writer.write_u32::(self.cue_point_id).unwrap(); writer.write(&self.text).unwrap(); writer.into_inner() } fn read_from(data : &[u8]) -> Result { let mut rdr = Cursor::new(data); let length = data.len(); Ok( Self { cue_point_id : rdr.read_u32::()?, text : { let mut buf = vec![0u8; (length - 4) as usize ]; rdr.read_exact(&mut buf)?; buf } }) } } #[derive(Clone, Debug)] struct RawLtxt { cue_point_id : u32, frame_length : u32, purpose : FourCC, country : u16, language : u16, dialect : u16, code_page : u16, text: Option> } impl RawLtxt { fn write_to(&self) -> Vec { let mut writer = Cursor::new(vec![0u8; 0]); writer.write_u32::(self.cue_point_id).unwrap(); writer.write_u32::(self.frame_length).unwrap(); writer.write_fourcc(self.purpose).unwrap(); writer.write_u16::(self.country).unwrap(); writer.write_u16::(self.language).unwrap(); writer.write_u16::(self.dialect).unwrap(); writer.write_u16::(self.code_page).unwrap(); if let Some(ext_text) = &self.text { writer.write(ext_text).unwrap(); } writer.into_inner() } fn read_from(data : &[u8]) -> Result { let mut rdr = Cursor::new(data); let length = data.len(); Ok( Self { cue_point_id : rdr.read_u32::()?, frame_length : rdr.read_u32::()?, purpose : rdr.read_fourcc()?, country : rdr.read_u16::()?, language : rdr.read_u16::()?, dialect : rdr.read_u16::()?, code_page : rdr.read_u16::()?, text : { if length - 20 > 0 { let mut buf = vec![0u8; (length - 20) as usize]; rdr.read_exact(&mut buf)?; Some( buf ) } else { None } } }) } } #[derive(Clone, Debug)] enum RawAdtlMember { Label(RawLabel), Note(RawNote), LabeledText(RawLtxt), Unrecognized(FourCC) } impl RawAdtlMember { fn compile_adtl(members : &[Self]) -> Vec { let mut w = Cursor::new(vec![0u8; 0]); // It seems like all this casing could be done with traits for member in members.iter() { let (fcc, buf) = match member { RawAdtlMember::Label(l) => ( (LABL_SIG, l.write_to()) ), RawAdtlMember::Note(n) => ( (NOTE_SIG, n.write_to()) ), RawAdtlMember::LabeledText(t) => ( (LTXT_SIG, t.write_to()) ), RawAdtlMember::Unrecognized(f) => (*f, vec![0u8;0] ) // <-- this is a dopey case but here for completeness }; w.write_fourcc(fcc).unwrap(); w.write_u32::(buf.len() as u32).unwrap(); w.write(&buf).unwrap(); if buf.len() % 2 == 1 { w.write_u8(0).unwrap(); } } let chunk_content = w.into_inner(); let mut writer = Cursor::new(vec![0u8; 0]); writer.write_fourcc(ADTL_SIG).unwrap(); writer.write_u32::(chunk_content.len() as u32).unwrap(); writer.write(&chunk_content).unwrap(); writer.into_inner() } fn collect_from(chunk : &[u8]) -> Result,Error> { let chunks = collect_list_form(chunk)?; let mut retval : Vec = vec![]; for chunk in chunks.iter() { retval.push( match chunk.signature { LABL_SIG => RawAdtlMember::Label( RawLabel::read_from(&chunk.contents)? ), NOTE_SIG => RawAdtlMember::Note( RawNote::read_from(&chunk.contents)? ), LTXT_SIG => RawAdtlMember::LabeledText( RawLtxt::read_from(&chunk.contents)? ), x => RawAdtlMember::Unrecognized(x) } ) } Ok( retval ) } } trait AdtlMemberSearch { fn labels_for_cue_point(&self, id: u32) -> Vec<&RawLabel>; fn notes_for_cue_point(&self, id : u32) -> Vec<&RawNote>; fn ltxt_for_cue_point(&self, id: u32) -> Vec<&RawLtxt>; } impl AdtlMemberSearch for Vec { fn labels_for_cue_point(&self, id: u32) -> Vec<&RawLabel> { self.iter().filter_map(|item| { match item { RawAdtlMember::Label(x) if x.cue_point_id == id => Some(x), _ => None } }) .collect() } fn notes_for_cue_point(&self, id: u32) -> Vec<&RawNote> { self.iter().filter_map(|item| { match item { RawAdtlMember::Note(x) if x.cue_point_id == id => Some(x), _ => None } }) .collect() } fn ltxt_for_cue_point(&self, id: u32) -> Vec<&RawLtxt> { self.iter().filter_map(|item| { match item { RawAdtlMember::LabeledText(x) if x.cue_point_id == id => Some(x), _ => None } }) .collect() } } /// A cue point recorded in the `cue` and `adtl` metadata. /// /// ## Resources /// - [Cue list, label and other metadata](https://sites.google.com/site/musicgapi/technical-documents/wav-file-format#smpl) /// /// ### Not Implemented /// - [EBU 3285 Supplement 2](https://tech.ebu.ch/docs/tech/tech3285s2.pdf) (July 2001): Quality chunk and cuesheet pub struct Cue { /// The time of this marker pub frame : u32, /// The length of this marker, if it is a range pub length : Option, /// The text "label"/name of this marker if provided pub label : Option, /// The text "note"/comment of this marker if provided pub note : Option, /// The offser of this marker /// /// **Note:** Applications use the `frame` and `offset` fields /// in different ways. iZotope RX Audio Editor writes the /// marker position to *both* fields, while a Sound Devices /// recorder writes the marker position to *only* the `offset` /// field. pub offset : u32 } fn convert_to_cue_string(buffer : &[u8]) -> String { let trimmed : Vec = buffer.iter().take_while(|c| **c != 0 as u8).cloned().collect(); ASCII.decode(&trimmed, DecoderTrap::Ignore).expect("Error decoding text") } fn convert_from_cue_string(val : &str) -> Vec { ASCII.encode(&val, EncoderTrap::Ignore).expect("Error encoding text") } impl Cue { /// Take a list of `Cue`s and convert it into `RawCue` and `RawAdtlMember`s fn compile_to(cues : &[Cue]) -> (Vec, Vec) { cues.iter().enumerate() .map(|(n, cue)| { let raw_cue = RawCue { cue_point_id: n as u32, frame : cue.frame, chunk_id: DATA_SIG, chunk_start: 0, block_start: 0, frame_offset: cue.offset }; let raw_label = cue.label.as_ref().map(|val| { RawLabel { cue_point_id : n as u32, text: convert_from_cue_string(&val) } }); let raw_note = cue.note.as_ref().map(|val| { RawNote { cue_point_id: n as u32, text : convert_from_cue_string(&val) } }); let raw_ltxt = cue.length.map(|val| { RawLtxt { cue_point_id : n as u32, frame_length : val, purpose : FourCC::make(b"rgn "), country : 0, language : 0, dialect : 0, code_page : 0, text : None } }); (raw_cue, raw_label, raw_note, raw_ltxt) }) .fold((Vec::::new(), Vec::::new()), |(mut cues, mut adtls) , (cue, label, note, ltxt)| { cues.push(cue); label.map(|l| adtls.push( RawAdtlMember::Label(l))); note.map(|n| adtls.push(RawAdtlMember::Note(n))); ltxt.map(|m| adtls.push(RawAdtlMember::LabeledText(m))); (cues, adtls) }) } pub fn collect_from(cue_chunk : &[u8], adtl_chunk : Option<&[u8]>) -> Result, Error> { let raw_cues = RawCue::read_from(cue_chunk)?; let raw_adtl : Vec; if let Some(adtl) = adtl_chunk { raw_adtl = RawAdtlMember::collect_from(adtl)?; } else { raw_adtl = vec![]; } Ok( raw_cues.iter() .map(|i| { Cue { //ident : i.cue_point_id, frame : i.frame, length: { raw_adtl.ltxt_for_cue_point(i.cue_point_id).first() .filter(|x| x.purpose == FourCC::make(b"rgn ")) .map(|x| x.frame_length) }, label: { raw_adtl.labels_for_cue_point(i.cue_point_id).iter() .map(|s| convert_to_cue_string(&s.text)) .next() }, note : { raw_adtl.notes_for_cue_point(i.cue_point_id).iter() //.filter_map(|x| str::from_utf8(&x.text).ok()) .map(|s| convert_to_cue_string(&s.text)) .next() }, offset: i.frame_offset } }).collect() ) } }