/* $NetBSD: libaudio.h,v 1.22 2024/03/08 06:57:59 mrg Exp $ */ /* * Copyright (c) 1999, 2009, 2013, 2015, 2019, 2024 Matthew R. Green * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ /* * audio formats */ #define AUDIO_FORMAT_DEFAULT -1 #define AUDIO_FORMAT_NONE 1 #define AUDIO_FORMAT_SUN 2 #define AUDIO_FORMAT_WAV 3 int audio_format_from_str (char *); /* * Audio encoding formats; this is a additional to those set * in sys/audioio.h, but with a large offset to avoid future * conflicts (additional ones are libaudio-software only.) * * This is to support floating-point WAV files. These require * software conversion to a supported format. */ #define AUDIO_ENCODING_LIBAUDIO_FLOAT32 1001 /* 32-bit IEEE FP. */ #define AUDIO_ENCODING_LIBAUDIO_FLOAT64 1002 /* 64-bit IEEE FP. */ /* * We copy the Sun/NeXT on-disk audio header format and document what * we know of it here. * * The header size appears to be an offset to where the data really * begins, rather than defining the real length of the audio header. * The Sun/NeXT audio format seems to only use 24 bytes of data (with * an additional 8 bytes of nuls written, padding it to 32 bytes). * * If the size of the audio data is unknown (eg, reading from a pipe) * the Sun demo audio tools place AUDIO_UNKNOWN_SIZE in the * `data_size' member. * * For stereo data, the channels appear to be interleaved with the * left channel first. For more channels, who knows? */ /* * This is the Sun/NeXT audio file magic value. Note that it * is also `.snd' in ASCII. */ #define AUDIO_FILE_MAGIC ((u_int32_t)0x2e736e64) #define AUDIO_UNKNOWN_SIZE ((unsigned)(~0)) typedef struct { u_int32_t magic; u_int32_t hdr_size; /* header size; in bytes */ u_int32_t data_size; /* optional; in bytes */ u_int32_t encoding; /* see below */ u_int32_t sample_rate; /* per second */ u_int32_t channels; /* number of interleaved channels */ } sun_audioheader; #define Audio_filehdr sun_audioheader /* SunOS compat(?) */ /* * these are the types of "encoding" for above. taken from the * SunOS . */ #define AUDIO_FILE_ENCODING_MULAW_8 1 #define AUDIO_FILE_ENCODING_LINEAR_8 2 #define AUDIO_FILE_ENCODING_LINEAR_16 3 #define AUDIO_FILE_ENCODING_LINEAR_24 4 #define AUDIO_FILE_ENCODING_LINEAR_32 5 #define AUDIO_FILE_ENCODING_FLOAT 6 #define AUDIO_FILE_ENCODING_DOUBLE 7 #define AUDIO_FILE_ENCODING_ADPCM_G721 23 #define AUDIO_FILE_ENCODING_ADPCM_G722 24 #define AUDIO_FILE_ENCODING_ADPCM_G723_3 25 #define AUDIO_FILE_ENCODING_ADPCM_G723_5 26 #define AUDIO_FILE_ENCODING_ALAW_8 27 const char *audio_enc_from_val (int); int audio_enc_to_val (const char *); int audio_sun_to_encoding (int, u_int *, u_int *); int audio_encoding_to_sun (int, int, int *); /* * RIFF WAVE files. Sources: RFC 2361, and various Microsoft docs * https://learn.microsoft.com/en-us/windows/win32/xaudio2/resource-interchange-file-format--riff- * https://learn.microsoft.com/en-us/previous-versions/windows/hardware/design/dn653308(v=vs.85) * "Multimedia Programming Interface and Data Specifications 1.0" chapter 4 */ /* * This is the WAV audio file magic value. Note that it * is also `RIFF' and `WAVE' in ASCII. */ #define WAVAUDIO_FILE_MAGIC_RIFF ((u_int32_t)0x52494646) #define WAVAUDIO_FILE_MAGIC_WAVE ((u_int32_t)0x57415645) #define WAVAUDIO_FILE_MAGIC_FMT ((u_int32_t)0x666d7420) #define WAVAUDIO_FILE_MAGIC_DATA ((u_int32_t)0x64617461) /* From RFC 2361 */ #define WAVE_FORMAT_UNKNOWN (0x0000) #define WAVE_FORMAT_PCM (0x0001) #define WAVE_FORMAT_ADPCM (0x0002) #define WAVE_FORMAT_IEEE_FLOAT (0x0003) #define WAVE_FORMAT_VSELP (0x0004) #define WAVE_FORMAT_IBM_CVSD (0x0005) #define WAVE_FORMAT_ALAW (0x0006) #define WAVE_FORMAT_MULAW (0x0007) #define WAVE_FORMAT_OKI_ADPCM (0x0010) #define WAVE_FORMAT_IMA_ADPCM (0x0011) #define WAVE_FORMAT_MEDIASPACE_ADPCM (0x0012) #define WAVE_FORMAT_SIERRA_ADPCM (0x0013) #define WAVE_FORMAT_G723_ADPCM (0x0014) #define WAVE_FORMAT_DIGISTD (0x0015) #define WAVE_FORMAT_DIGIFIX (0x0016) #define WAVE_FORMAT_DIALOGIC_OKI_ADPCM (0x0017) #define WAVE_FORMAT_MEDIAVISION_ADPCM (0x0018) #define WAVE_FORMAT_CU_CODEC (0x0019) #define WAVE_FORMAT_YAMAHA_ADPCM (0x0020) #define WAVE_FORMAT_SONARC (0x0021) #define WAVE_FORMAT_DSPGROUP_TRUESPEECH (0x0022) #define WAVE_FORMAT_ECHOSC1 (0x0023) #define WAVE_FORMAT_AUDIOFILE_AF36 (0x0024) #define WAVE_FORMAT_APTX (0x0025) #define WAVE_FORMAT_AUDIOFILE_AF10 (0x0026) #define WAVE_FORMAT_PROSODY_1612 (0x0027) #define WAVE_FORMAT_LRC (0x0028) #define WAVE_FORMAT_DOLBY_AC2 (0x0030) #define WAVE_FORMAT_GSM610 (0x0031) #define WAVE_FORMAT_MSNAUDIO (0x0032) #define WAVE_FORMAT_ANTEX_ADPCME (0x0033) #define WAVE_FORMAT_CONTROL_RES_VQLPC (0x0034) #define WAVE_FORMAT_DIGIREAL (0x0035) #define WAVE_FORMAT_DIGIADPCM (0x0036) #define WAVE_FORMAT_CONTROL_RES_CR10 (0x0037) #define WAVE_FORMAT_NMS_VBXADPCM (0x0038) #define WAVE_FORMAT_ROLAND_RDAC (0x0039) #define WAVE_FORMAT_ECHOSC3 (0x003a) #define WAVE_FORMAT_ROCKWELL_ADPCM (0x003b) #define WAVE_FORMAT_ROCKWELL_DIGITALK (0x003c) #define WAVE_FORMAT_XEBEC (0x003d) #define WAVE_FORMAT_G721_ADPCM (0x0040) #define WAVE_FORMAT_G728_CELP (0x0041) #define WAVE_FORMAT_MSG723 (0x0042) #define WAVE_FORMAT_MPEG (0x0050) #define WAVE_FORMAT_RT24 (0x0052) #define WAVE_FORMAT_PAC (0x0053) #define WAVE_FORMAT_MPEGLAYER3 (0x0055) #define WAVE_FORMAT_LUCENT_G723 (0x0059) #define WAVE_FORMAT_CIRRUS (0x0060) #define WAVE_FORMAT_ESPCM (0x0061) #define WAVE_FORMAT_VOXWARE (0x0062) #define WAVE_FORMAT_CANOPUS_ATRAC (0x0063) #define WAVE_FORMAT_G726_ADPCM (0x0064) #define WAVE_FORMAT_G722_ADPCM (0x0065) #define WAVE_FORMAT_DSAT (0x0066) #define WAVE_FORMAT_DSAT_DISPLAY (0x0067) #define WAVE_FORMAT_VOXWARE_BYTE_ALIGNED (0x0069) #define WAVE_FORMAT_VOXWARE_AC8 (0x0070) #define WAVE_FORMAT_VOXWARE_AC10 (0x0071) #define WAVE_FORMAT_VOXWARE_AC16 (0x0072) #define WAVE_FORMAT_VOXWARE_AC20 (0x0073) #define WAVE_FORMAT_VOXWARE_RT24 (0x0074) #define WAVE_FORMAT_VOXWARE_RT29 (0x0075) #define WAVE_FORMAT_VOXWARE_RT29HW (0x0076) #define WAVE_FORMAT_VOXWARE_VR12 (0x0077) #define WAVE_FORMAT_VOXWARE_VR18 (0x0078) #define WAVE_FORMAT_VOXWARE_TQ40 (0x0079) #define WAVE_FORMAT_SOFTSOUND (0x0080) #define WAVE_FORMAT_VOXWARE_TQ60 (0x0081) #define WAVE_FORMAT_MSRT24 (0x0082) #define WAVE_FORMAT_G729A (0x0083) #define WAVE_FORMAT_MVI_MV12 (0x0084) #define WAVE_FORMAT_DF_G726 (0x0085) #define WAVE_FORMAT_DF_GSM610 (0x0086) #define WAVE_FORMAT_ISIAUDIO (0x0088) #define WAVE_FORMAT_ONLIVE (0x0089) #define WAVE_FORMAT_SBC24 (0x0091) #define WAVE_FORMAT_DOLBY_AC3_SPDIF (0x0092) #define WAVE_FORMAT_ZYXEL_ADPCM (0x0097) #define WAVE_FORMAT_PHILIPS_LPCBB (0x0098) #define WAVE_FORMAT_PACKED (0x0099) #define WAVE_FORMAT_RHETOREX_ADPCM (0x0100) #define WAVE_FORMAT_IRAT (0x0101) #define WAVE_FORMAT_VIVO_G723 (0x0111) #define WAVE_FORMAT_VIVO_SIREN (0x0112) #define WAVE_FORMAT_DIGITAL_G723 (0x0123) #define WAVE_FORMAT_CREATIVE_ADPCM (0x0200) #define WAVE_FORMAT_CREATIVE_FASTSPEECH8 (0x0202) #define WAVE_FORMAT_CREATIVE_FASTSPEECH10 (0x0203) #define WAVE_FORMAT_QUARTERDECK (0x0220) #define WAVE_FORMAT_FM_TOWNS_SND (0x0300) #define WAVE_FORMAT_BTV_DIGITAL (0x0400) #define WAVE_FORMAT_VME_VMPCM (0x0680) #define WAVE_FORMAT_OLIGSM (0x1000) #define WAVE_FORMAT_OLIADPCM (0x1001) #define WAVE_FORMAT_OLICELP (0x1002) #define WAVE_FORMAT_OLISBC (0x1003) #define WAVE_FORMAT_OLIOPR (0x1004) #define WAVE_FORMAT_LH_CODEC (0x1100) #define WAVE_FORMAT_NORRIS (0x1400) #define WAVE_FORMAT_ISIAUDIO2 (0x1401) #define WAVE_FORMAT_SOUNDSPACE_MUSICOMPRESS (0x1500) #define WAVE_FORMAT_DVM (0x2000) #define WAVE_FORMAT_EXTENSIBLE (0xfffe) const char *wav_enc_from_val (int); typedef struct { char name[4]; u_int32_t len; } wav_audioheaderpart; typedef struct { u_int16_t tag; u_int16_t channels; u_int32_t sample_rate; u_int32_t avg_bytes_per_sec; u_int16_t alignment; u_int16_t bits_per_sample; } __packed wav_audioheaderfmt; typedef struct { u_int16_t len; u_int16_t valid_bits; u_int32_t speaker_pos_mask; u_int16_t sub_tag; u_int8_t guid[14]; } __packed wav_audiohdrextensible; /* returns size of header, or -ve for failure */ ssize_t audio_wav_parse_hdr (void *, size_t, u_int *, u_int *, u_int *, u_int *, off_t *); extern int verbose; /* * audio routine error codes */ #define AUDIO_ENOENT -1 /* no such audio format */ #define AUDIO_ESHORTHDR -2 /* short header */ #define AUDIO_EWAVUNSUPP -3 /* WAV: unsupported file */ #define AUDIO_EWAVBADPCM -4 /* WAV: bad PCM bps */ #define AUDIO_EWAVNODATA -5 /* WAV: missing data */ #define AUDIO_EINTERNAL -6 /* internal error */ #define AUDIO_MAXERRNO 5 /* and something to get a string associated with this error */ const char *audio_errstring (int); /* * generic routines? */ void decode_int (const char *, int *); void decode_uint (const char *, unsigned *); void decode_time (const char *, struct timeval *); void decode_encoding (const char *, int *); /* * Track info, for reading/writing sun/wav header. * * Note that write_header() may change the values of format, * encoding. */ struct track_info { int outfd; char *header_info; int format; int encoding; int precision; int qflag; off_t total_size; int sample_rate; int channels; }; typedef void (*write_conv_func) (u_char *, int); void write_header (struct track_info *); write_conv_func write_get_conv_func(struct track_info *); /* backends for the above */ int sun_prepare_header(struct track_info *ti, void **hdrp, size_t *lenp, int *leftp); int wav_prepare_header(struct track_info *ti, void **hdrp, size_t *lenp, int *leftp); write_conv_func sun_write_get_conv_func(struct track_info *ti); write_conv_func wav_write_get_conv_func(struct track_info *ti); extern char audio_default_info[8]; /* * get/put 16/32 bits of big/little endian data */ #include #include #include #if BYTE_ORDER == BIG_ENDIAN #define getle16(v) bswap16(v) #define getle32(v) bswap32(v) #define getbe16(v) (v) #define getbe32(v) (v) #define putle16(x,v) (x) = bswap16(v) #define putle32(x,v) (x) = bswap32(v) #define putbe16(x,v) (x) = (v) #define putbe32(x,v) (x) = (v) #else #define getle16(v) (v) #define getle32(v) (v) #define getbe16(v) bswap16(v) #define getbe32(v) bswap32(v) #define putle16(x,v) (x) = (v) #define putle32(x,v) (x) = (v) #define putbe16(x,v) (x) = bswap16(v) #define putbe32(x,v) (x) = bswap32(v) #endif