5. Cue Marker and Range Metadata

5.1. Notes

Cue metadata stores timed markers that clients use to mark times of interest in a wave file, and optionally give them a name and longer comment. Markers can also have an associated length, allowing ranges of times in a file to be marked.

5.1.1. String Encoding of Cue Metadata

Cue labels and notes will be decoded using the string encoding passed to WavInfoReader's info_encoding= parameter, which by default is latin_1 (ISO 8859-1).

Text associated with ltxt time ranges may specify their own encoding in the form of a Windows codepage number. wavinfo will attempt to use the encoding specified.

Note

cset character set/locale metadata is not supported. If it is present in the file it will be ignored by wavinfo.

5.2. Class Reference

class wavinfo.wave_cues_reader.WavCuesReader(cues: List[wavinfo.wave_cues_reader.CueEntry], labels: List[wavinfo.wave_cues_reader.LabelEntry], ranges: List[wavinfo.wave_cues_reader.RangeLabel], notes: List[wavinfo.wave_cues_reader.LabelEntry])

each_cue() → Generator[Tuple[int, int], None, None]

Iterate through each cue.

Yields:: the cue’s name and sample_offset

label_and_note(cue_ident: int) → Tuple[str | None, str | None]

Get the label and note (extended comment) for a cue.

Parameters:: cue_ident – the cue’s name, its unique identifying number
Returns:: a tuple of the the cue’s label (if present) and note (if present)

range(cue_ident: int) → int | None

Get the length of the time range for a cue, if it has one.

Parameters:: cue_ident – the cue’s name, its unique identifying number
Returns:: the length of the marker’s range, or None