AFprintInfoRecs


Routine:

void AFprintInfoRecs (const AFILE *AFp, FILE *fpinfo)

Purpose:

Print all information records for an audio file

Description:

This formats and prints information records for an audio file. Non-printing control characters are replaced by a scarab ('\xA4') character. Long lines are truncated with a trailing ... to indicate truncation.

When an input file containing AFsp information records is opened with AFopnRead, information records are read and stored in the audio file parameter structure. The following records affect the audio file information that is stored in the audio file parameter structure or printed when the file is opened.

- "date:" or "creation_date:" record
The data and time in that record is printed when the file is opened rather than the file modification date obtained from the file system.
- "sample_rate:" record
The sample rate in the record is compared to the sample rate from the file header. If the file header sample rate from the header is an integer value and agrees with the rounded value of the value in the record, the value from the record used to set the Sfreq variable in the audio file parameter structure.
- "loudspeakers:" record
The loudspeaker locations are decoded and the result is stored in the SpkrConfig array in the audio file parameter structure. The list of speaker positions is printed when the file is opened, along with the other file information.
- "name:", "title:", "comment:", or "display_text:" record
This information record printed as "Description: <text>" when the file is opened.

Information records found in input audio files are returned in the AFInfo structure which is part of the audio file parameter structure. The information records are determined from the audio file as follows.

AU files:
Text information precedes the audio data. If the "AFsp" identifier is present, the remaining text is stored as information records in the audio file parameter structure. Otherwise the text is stored as an "info:" information record.
AIFF and AIFF-C files:
The text information can appear in several different header chunks. This information is extracted and stored as information records in the audio file parameter structure.
 "NAME" chunk text => "name:" information record
 "AUTH" chunk text => "author" information record
 "(c) " chunk text => "copyright:" information record
 "ANNO" chunk text => "annotation:" information record
If an "ANNO" chunk text has an "AFsp" tag as a preamble, the remaining text is stored as individual information records
WAVE files:
Information records are generated from "afsp", "DISP", "LIST", or "bext" chunks. The information is extracted and stored as information records in the audio file parameter structure.
Text from an "afsp" chunk is extracted and stored as individual information records.
"DISP" chunk text is stored as a "display_text:" information record.
"LIST" chunk INFO text has further subcategories as follows.
   "IARL" text => "archival_location:" information record.
   "IART" text => "artist:" information record.
   "ICMS" text => "commissioned:" information record.
   "ICMT" text => "comment:" information record.
   "ICOP" text => "copyright:" information record.
   "ICRD" text => "creation_date:" information record.
   "IENG" text => "engineer:" information record.
   "IGNR" text => "genre:" information record.
   "IKEY" text => "keywords:" information record.
   "IMED" text => "medium:" information record.
   "INAM" text => "name:" information record.
   "IPRD" text => "product:" information record.
   "ISBJ" text => "subject:" information record.
   "ISFT" text => "software:" information record.
   "ISRC" text => "source:" information record.
   "ISRF" text => "source_form:" information record.
   "ITCH" text => "technician:" information record.
"bext" chunk information (Broadcast WAVE files) is extracted and returned as information records.
SPPACK files:
"comment:" and "command:" information records
ESPS sampled data feature files:
The following information record identifiers are picked up from the file header.
 "date:"            "header_version:"       "program:"
 "program_version:" "program_compile_date:" "start_time:"
 "max_value:"
INRS-Telecom files:
"date:" information record
NSP files:
"comment:" information record
IRCAM soundfiles:
"SF_COMMENT:" information record
NIST SPHERE files:
Text in the header is parsed and stored as information records. The identifier is picked up from the header. Possible identifiers include,
 "database_id:"            "database_version:"
 "utterance_id:"           "sample_min:"
 "sample_max:"             "conversation_id:"
 "microphone:"             "prompt_id:"
 "recording_date:"         "recording_environment:"
 "recording_site:"         "recording_time:"
 "sample_checksum:"        "speaker_sentence_number:"
 "speaker_session_number:" "speaker_utterance_number:"
 "speaker_id:"             "speaker_id_a:"
 "speaker_id_b:"           "speaking_mode:"
 "utterance_id:".
Cadence SPW Signal files:
A "comment:" information record is generated from the second line of a header. Keyword lines in the header generate information records.
Text audio files (with header):
A "title:" information record is generated from the second line of the header. Keyword lines in the header generate information records. A multi-line description is returned as a "description:" information record.

Parameters:

<- void AFprintInfoRecs
-> const AFILE *AFp
Audio file parameter structure
<-> FILE *fpinfo
Output stream for the file information. If fpinfo is NULL, no information is written.

Author / revision:

P. Kabal / Revision 1.14 2018-11-14

See Also

AFopnRead, AFsetInfo


Main Index libtsp