/*      $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 <multimedia/audio_filehdr.h>.
*/
#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 <sys/types.h>
#include <machine/endian.h>
#include <machine/bswap.h>

#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

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.