ref: af261dcc91071cafd7d83054afb1eb4b2d0083ef
dir: /src/au.c/
/*
* Copyright 1991, 1992, 1993 Guido van Rossum And Sundry Contributors.
* This source code is freely redistributable and may be used for
* any purpose. This copyright notice must be maintained.
* Guido van Rossum And Sundry Contributors are not responsible for
* the consequences of using this software.
*
* October 7, 1998 - cbagwell@sprynet.com
* G.723 was using incorrect # of bits. Corrected to 3 and 5 bits.
*/
/*
* Sound Tools Sun format with header (SunOS 4.1; see /usr/demo/SOUND).
* NeXT uses this format also, but has more format codes defined.
* DEC uses a slight variation and swaps bytes.
* We only support the common formats.
* CCITT G.721 (32 kbit/s) and G.723 (24/40 kbit/s) are also supported,
* courtesy Sun's public domain implementation.
* Output is always in big-endian (Sun/NeXT) order.
*/
#include "st.h"
#include "g72x.h"
#include <stdlib.h>
#include <string.h>
/* Magic numbers used in Sun and NeXT audio files */
#define SUN_MAGIC 0x2e736e64 /* Really '.snd' */
#define SUN_INV_MAGIC 0x646e732e /* '.snd' upside-down */
#define DEC_MAGIC 0x2e736400 /* Really '\0ds.' (for DEC) */
#define DEC_INV_MAGIC 0x0064732e /* '\0ds.' upside-down */
#define SUN_HDRSIZE 24 /* Size of minimal header */
#define SUN_UNSPEC ((unsigned)(~0)) /* Unspecified data size */
#define SUN_ULAW 1 /* u-law encoding */
#define SUN_LIN_8 2 /* Linear 8 bits */
#define SUN_LIN_16 3 /* Linear 16 bits */
#define SUN_LIN_24 4 /* Linear 24 bits */
#define SUN_LIN_32 5 /* Linear 32 bits */
#define SUN_FLOAT 6 /* IEEE FP 32 bits */
#define SUN_DOUBLE 7 /* IEEE FP 64 bits */
#define SUN_G721 23 /* CCITT G.721 4-bits ADPCM */
#define SUN_G723_3 25 /* CCITT G.723 3-bits ADPCM */
#define SUN_G723_5 26 /* CCITT G.723 5-bits ADPCM */
#define SUN_ALAW 27 /* a-law encoding */
/* The other formats are not supported by sox at the moment */
/* Private data */
typedef struct aupriv {
/* For writer: size in bytes */
ULONG data_size;
/* For seeking */
LONG dataStart;
/* For G72x decoding: */
struct g72x_state state;
int (*dec_routine)();
int dec_bits;
unsigned int in_buffer;
int in_bits;
} *au_t;
static void auwriteheader(ft_t ft, ULONG data_size);
int st_auencodingandsize(sun_encoding, encoding, size)
int sun_encoding;
int *encoding;
int *size;
{
switch (sun_encoding) {
case SUN_ULAW:
*encoding = ST_ENCODING_ULAW;
*size = ST_SIZE_BYTE;
break;
case SUN_ALAW:
*encoding = ST_ENCODING_ALAW;
*size = ST_SIZE_BYTE;
break;
case SUN_LIN_8:
*encoding = ST_ENCODING_SIGN2;
*size = ST_SIZE_BYTE;
break;
case SUN_LIN_16:
*encoding = ST_ENCODING_SIGN2;
*size = ST_SIZE_WORD;
break;
case SUN_G721:
*encoding = ST_ENCODING_SIGN2;
*size = ST_SIZE_WORD;
break;
case SUN_G723_3:
*encoding = ST_ENCODING_SIGN2;
*size = ST_SIZE_WORD;
break;
case SUN_G723_5:
*encoding = ST_ENCODING_SIGN2;
*size = ST_SIZE_WORD;
break;
default:
st_report("encoding: 0x%lx", encoding);
return(ST_EOF);
}
return(ST_SUCCESS);
}
int st_auseek(ft,offset)
ft_t ft;
LONG offset;
{
au_t au = (au_t ) ft->priv;
if (au->dec_routine != NULL)
st_fail_errno(ft,ST_ENOTSUP,"Sorry, DEC unsupported");
else
return st_seek(ft,offset*ft->info.size + au->dataStart,SEEK_SET);
return(ft->st_errno);
}
int st_austartread(ft)
ft_t ft;
{
/* The following 6 variables represent a Sun sound header on disk.
The numbers are written as big-endians.
Any extra bytes (totalling hdr_size - 24) are an
"info" field of unspecified nature, usually a string.
By convention the header size is a multiple of 4. */
ULONG magic;
ULONG hdr_size;
ULONG data_size;
ULONG encoding;
ULONG sample_rate;
ULONG channels;
register int i;
char *buf;
au_t p = (au_t ) ft->priv;
int rc;
/* AU is in big endian format. Swap whats read
* in onlittle endian machines.
*/
if (ST_IS_LITTLEENDIAN)
{
ft->swap = ft->swap ? 0 : 1;
}
/* Check the magic word */
st_readdw(ft, &magic);
if (magic == DEC_INV_MAGIC) {
/* Inverted headers are not standard. Code was probably
* left over from pre-standardize period of testing for
* endianess. Its not hurting though.
*/
ft->swap = ft->swap ? 0 : 1;
st_report("Found inverted DEC magic word. Swapping bytes.");
}
else if (magic == SUN_INV_MAGIC) {
ft->swap = ft->swap ? 0 : 1;
st_report("Found inverted Sun/NeXT magic word. Swapping bytes.");
}
else if (magic == SUN_MAGIC) {
st_report("Found Sun/NeXT magic word");
}
else if (magic == DEC_MAGIC) {
st_report("Found DEC magic word");
}
else
{
st_fail_errno(ft,ST_EHDR,"Sun/NeXT/DEC header doesn't start with magic word\nTry the '.ul' file type with '-t ul -r 8000 filename'");
return(ST_EOF);
}
/* Read the header size */
st_readdw(ft, &hdr_size);
if (hdr_size < SUN_HDRSIZE)
{
st_fail_errno(ft,ST_EHDR,"Sun/NeXT header size too small.");
return(ST_EOF);
}
/* Read the data size; may be ~0 meaning unspecified */
st_readdw(ft, &data_size);
/* Read the encoding; there are some more possibilities */
st_readdw(ft, &encoding);
/* Translate the encoding into encoding and size parameters */
/* (Or, for G.72x, set the decoding routine and parameters) */
p->dec_routine = NULL;
p->in_buffer = 0;
p->in_bits = 0;
if(st_auencodingandsize(encoding, &(ft->info.encoding),
&(ft->info.size)) == ST_EOF)
{
st_fail_errno(ft,ST_EFMT,"Unsupported encoding in Sun/NeXT header.\nOnly U-law, signed bytes, signed words, and ADPCM are supported.");
return(ST_EOF);
}
switch (encoding) {
case SUN_G721:
g72x_init_state(&p->state);
p->dec_routine = g721_decoder;
p->dec_bits = 4;
break;
case SUN_G723_3:
g72x_init_state(&p->state);
p->dec_routine = g723_24_decoder;
p->dec_bits = 3;
break;
case SUN_G723_5:
g72x_init_state(&p->state);
p->dec_routine = g723_40_decoder;
p->dec_bits = 5;
break;
}
/* Read the sampling rate */
st_readdw(ft, &sample_rate);
ft->info.rate = sample_rate;
/* Read the number of channels */
st_readdw(ft, &channels);
ft->info.channels = (int) channels;
/* Skip the info string in header; print it if verbose */
hdr_size -= SUN_HDRSIZE; /* #bytes already read */
if (hdr_size > 0) {
/* Allocate comment buffer */
buf = (char *) malloc(hdr_size+1);
for(i = 0; i < hdr_size; i++) {
st_readb(ft, &(buf[i]));
if (feof(ft->fp))
{
st_fail_errno(ft,ST_EOF,"Unexpected EOF in Sun/NeXT header info.");
return(ST_EOF);
}
}
/* Buffer should already be null terminated but
* just in case we malloced an extra byte and
* force the last byte to be 0 anyways.
* This should help work with a greater array of
* software.
*/
buf[hdr_size] = '\0';
ft->comment = buf;
st_report("Input file %s: Sun header info: %s", ft->filename, buf);
}
/* Needed for seeking */
ft->length = data_size/ft->info.size;
if(ft->seekable)
p->dataStart = ftell(ft->fp);
/* Needed for rawread() */
rc = st_rawstartread(ft);
if (rc)
return rc;
return(ST_SUCCESS);
}
/* When writing, the header is supposed to contain the number of
data bytes written, unless it is written to a pipe.
Since we don't know how many bytes will follow until we're done,
we first write the header with an unspecified number of bytes,
and at the end we rewind the file and write the header again
with the right size. This only works if the file is seekable;
if it is not, the unspecified size remains in the header
(this is legal). */
int st_austartwrite(ft)
ft_t ft;
{
au_t p = (au_t ) ft->priv;
int rc;
/* Needed because of rawwrite(); */
rc = st_rawstartwrite(ft);
if (rc)
return rc;
/* AU is in big endian format. Swap whats read in
* on little endian machines.
*/
if (ST_IS_LITTLEENDIAN)
{
ft->swap = ft->swap ? 0 : 1;
}
p->data_size = 0;
auwriteheader(ft, SUN_UNSPEC);
return(ST_SUCCESS);
}
/*
* Unpack input codes and pass them back as bytes.
* Returns 1 if there is residual input, returns -1 if eof, else returns 0.
* (Adapted from Sun's decode.c.)
*/
static int
unpack_input(ft, code)
ft_t ft;
unsigned char *code;
{
au_t p = (au_t ) ft->priv;
unsigned char in_byte;
if (p->in_bits < p->dec_bits) {
if (st_readb(ft, &in_byte) == ST_EOF) {
*code = 0;
return (-1);
}
p->in_buffer |= (in_byte << p->in_bits);
p->in_bits += 8;
}
*code = p->in_buffer & ((1 << p->dec_bits) - 1);
p->in_buffer >>= p->dec_bits;
p->in_bits -= p->dec_bits;
return (p->in_bits > 0);
}
LONG st_auread(ft, buf, samp)
ft_t ft;
LONG *buf, samp;
{
au_t p = (au_t ) ft->priv;
unsigned char code;
int done;
if (p->dec_routine == NULL)
return st_rawread(ft, buf, samp);
done = 0;
while (samp > 0 && unpack_input(ft, &code) >= 0) {
*buf++ = LEFT((*p->dec_routine)(code, AUDIO_ENCODING_LINEAR,
&p->state),
16);
samp--;
done++;
}
return done;
}
LONG st_auwrite(ft, buf, samp)
ft_t ft;
LONG *buf, samp;
{
au_t p = (au_t ) ft->priv;
p->data_size += samp * ft->info.size;
return(st_rawwrite(ft, buf, samp));
}
int st_austopwrite(ft)
ft_t ft;
{
au_t p = (au_t ) ft->priv;
int rc;
/* Needed because of rawwrite(). Do now to flush
* data before seeking around below.
*/
rc = st_rawstopwrite(ft);
if (rc)
return rc;
/* Attempt to update header */
if (ft->seekable)
{
if (fseek(ft->fp, 0L, 0) != 0)
{
st_fail_errno(ft,errno,"Can't rewind output file to rewrite Sun header.");
return(ST_EOF);
}
auwriteheader(ft, p->data_size);
}
return(ST_SUCCESS);
}
int st_ausunencoding(size, encoding)
int size;
int encoding;
{
int sun_encoding;
if (encoding == ST_ENCODING_ULAW && size == ST_SIZE_BYTE)
sun_encoding = SUN_ULAW;
else if (encoding == ST_ENCODING_ALAW && size == ST_SIZE_BYTE)
sun_encoding = SUN_ALAW;
else if (encoding == ST_ENCODING_SIGN2 && size == ST_SIZE_BYTE)
sun_encoding = SUN_LIN_8;
else if (encoding == ST_ENCODING_SIGN2 && size == ST_SIZE_WORD)
sun_encoding = SUN_LIN_16;
else
sun_encoding = -1;
return sun_encoding;
}
static void auwriteheader(ft, data_size)
ft_t ft;
ULONG data_size;
{
ULONG magic;
ULONG hdr_size;
ULONG encoding;
ULONG sample_rate;
ULONG channels;
int x;
int comment_size;
if((encoding = st_ausunencoding(ft->info.size, ft->info.encoding)) == -1) {
st_report("Unsupported output encoding/size for Sun/NeXT header or .AU format not specified.");
st_report("Only U-law, A-law signed bytes, and signed words are supported.");
st_report("Defaulting to 8khz u-law\n");
encoding = SUN_ULAW;
ft->info.encoding = ST_ENCODING_ULAW;
ft->info.size = ST_SIZE_BYTE;
ft->info.rate = 8000; /* strange but true */
}
magic = SUN_MAGIC;
st_writedw(ft, magic);
/* Info field is at least 4 bytes. Here I force it to something
* useful when there is no comments.
*/
if (ft->comment == NULL)
ft->comment = "SOX";
hdr_size = SUN_HDRSIZE;
comment_size = strlen(ft->comment) + 1; /*+1 = null-term. */
if (comment_size < 4)
comment_size = 4; /* minimum size */
hdr_size += comment_size;
st_writedw(ft, hdr_size);
st_writedw(ft, data_size);
st_writedw(ft, encoding);
sample_rate = ft->info.rate;
st_writedw(ft, sample_rate);
channels = ft->info.channels;
st_writedw(ft, channels);
st_writes(ft, ft->comment);
/* Info must be 4 bytes at least and null terminated. */
x = strlen(ft->comment);
for (;x < 3; x++)
st_writeb(ft, 0);
st_writeb(ft, 0);
}