263 lines
8.0 KiB
C
263 lines
8.0 KiB
C
/* $NetBSD: libaudio.h,v 1.21 2019/11/09 12:46:44 mrg Exp $ */
|
|
|
|
/*
|
|
* Copyright (c) 1999, 2009, 2013, 2015, 2019 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 *);
|
|
|
|
/*
|
|
* M$ WAV files, info gleamed from sox sources
|
|
*/
|
|
|
|
/*
|
|
* 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)
|
|
|
|
/* purloined from public Microsoft RIFF docs via sox, mplayer, or directly */
|
|
#define WAVE_FORMAT_UNKNOWN (0x0000)
|
|
#define WAVE_FORMAT_PCM (0x0001)
|
|
#define WAVE_FORMAT_ADPCM (0x0002)
|
|
#define WAVE_FORMAT_IEEE_FLOAT (0x0003)
|
|
#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_DIGISTD (0x0015)
|
|
#define WAVE_FORMAT_DIGIFIX (0x0016)
|
|
#define WAVE_FORMAT_DOLBY_AC2 (0x0030)
|
|
#define WAVE_FORMAT_GSM610 (0x0031)
|
|
#define WAVE_FORMAT_ROCKWELL_ADPCM (0x003b)
|
|
#define WAVE_FORMAT_ROCKWELL_DIGITALK (0x003c)
|
|
#define WAVE_FORMAT_G721_ADPCM (0x0040)
|
|
#define WAVE_FORMAT_G728_CELP (0x0041)
|
|
#define WAVE_FORMAT_MPEG (0x0050)
|
|
#define WAVE_FORMAT_MPEGLAYER3 (0x0055)
|
|
#define WAVE_FORMAT_G726_ADPCM (0x0064)
|
|
#define WAVE_FORMAT_G722_ADPCM (0x0065)
|
|
#define IBM_FORMAT_MULAW (0x0101)
|
|
#define IBM_FORMAT_ALAW (0x0102)
|
|
#define IBM_FORMAT_ADPCM (0x0103)
|
|
#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_bps;
|
|
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 dummy[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
|