ref: 0ce74a0cf19cf7e4cbca46b15d87010a428ed38b
dir: /src/skelform.c/
/*
* libSoX skeleton file format handler.
*
* Copyright 1999 Chris Bagwell And Sundry Contributors
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, write to the Free Software
* Foundation, Fifth Floor, 51 Franklin Street, Boston, MA 02111-1301,
* USA. */
#include "sox_i.h"
#include <string.h>
/* Private data for SKEL file */
typedef struct skelform
{
sox_size_t remaining_samples;
} *skelform_t;
assert_static(sizeof(struct skelform) <= SOX_MAX_FILE_PRIVSIZE,
/* else */ skel_PRIVSIZE_too_big);
/* Note that if any of your methods doesn't need to do anything, you
can instead use the relevant sox_*_nothing* method */
/*
* Do anything required before you start reading samples.
* Read file header.
* Find out sampling rate,
* size and encoding of samples,
* mono/stereo/quad.
*/
static int startread(sox_format_t * ft)
{
skelform_t sk = (skelform_t)ft->priv;
sox_size_t samples_in_file;
/* If you need to seek around the input file. */
if (!ft->seekable) {
sox_fail_errno(ft, SOX_EOF, "skel inputfile must be a file");
return SOX_EOF;
}
/*
* If your format is headerless and has fixed values for
* the following items, you can hard code them here (see cdr.c).
* If your format contains a header with format information
* then you should set it here.
*/
ft->signal.rate = 44100; /* or 8000, 16000, 32000, 48000, ... */
ft->signal.size = SOX_SIZE_8BIT; /* or 16BIT ... */
ft->signal.encoding = SOX_ENCODING_UNSIGNED; /* or SIGN2 ... */
ft->signal.channels = 1; /* or 2 or 4 */
append_comment(&ft->comments, "any comment in file header.");
/* If your format doesn't have a header then samples_in_file
* can be determined by the file size.
*/
samples_in_file = sox_filelength(ft) / ft->signal.size;
/* If you can detect the length of your file, record it here. */
ft->length = samples_in_file;
sk->remaining_samples = samples_in_file;
return SOX_SUCCESS;
}
/*
* Read up to len samples of type sox_sample_t from file into buf[].
* Return number of samples read, or 0 if at end of file.
*/
static sox_size_t read(sox_format_t * ft, sox_sample_t *buf, sox_size_t len)
{
skelform_t UNUSED sk = (skelform_t)ft->priv;
sox_size_t done;
unsigned char sample;
for (done = 0; done < len; done++) {
if (feof(ft->fp)) /* no more samples */
break;
sample = fgetc(ft->fp);
switch (ft->signal.size) {
case SOX_SIZE_8BIT:
switch (ft->signal.encoding) {
case SOX_ENCODING_UNSIGNED:
*buf++ = SOX_UNSIGNED_8BIT_TO_SAMPLE(sample,);
break;
default:
sox_fail("Undetected sample encoding in read!");
exit(2);
}
break;
default:
sox_fail("Undetected bad sample size in read!");
exit(2);
}
}
return done;
}
/*
* Do anything required when you stop reading samples.
* Don't close input file!
*/
static int stopread(sox_format_t UNUSED * ft)
{
return SOX_SUCCESS;
}
static int startwrite(sox_format_t * ft)
{
skelform_t UNUSED sk = (skelform_t)ft->priv;
/* If you have to seek around the output file. */
/* If header contains a length value then seeking will be
* required. Instead of failing, it's sometimes nice to
* just set the length to max value and not fail.
*/
if (!ft->seekable) {
sox_fail("Output .skel file must be a file, not a pipe");
return SOX_EOF;
}
if (ft->signal.rate != 44100)
sox_fail("Output .skel file must have a sample rate of 44100Hz");
if (ft->signal.size == 0) {
sox_fail("Did not specify a size for .skel output file");
return SOX_EOF;
}
/* error check ft->signal.encoding */
/* error check ft->signal.channels */
/* Write file header, if any */
/* Write comment field, if any */
return SOX_SUCCESS;
}
/*
* Write len samples of type sox_sample_t from buf[] to file.
* Return number of samples written.
*/
static sox_size_t write(sox_format_t * ft, const sox_sample_t *buf, sox_size_t len)
{
skelform_t UNUSED sk = (skelform_t)ft->priv;
switch (ft->signal.size) {
case SOX_SIZE_8BIT:
switch (ft->signal.encoding) {
case SOX_ENCODING_UNSIGNED:
while (len--) {
len = sox_writeb(ft, SOX_SAMPLE_TO_UNSIGNED_8BIT(*buf++, ft->clips));
if (len == 0)
break;
}
break;
default:
sox_fail("Undetected bad sample encoding in write!");
exit(2);
}
break;
default:
sox_fail("Undetected bad sample size in write!");
exit(2);
}
return len;
}
static int stopwrite(sox_format_t UNUSED * ft)
{
/* All samples are already written out. */
/* If file header needs fixing up, for example it needs the number
of samples in a field, seek back and write them here. */
return SOX_SUCCESS;
}
static int seek(sox_format_t UNUSED * ft, sox_size_t UNUSED offset)
{
/* Seek relative to current position. */
return SOX_SUCCESS;
}
/* Format file suffixes */
static const char *names[] = {
"skel",
NULL
};
/* Format descriptor
* If no specific processing is needed for any of
* the 7 functions, then the function above can be deleted
* and 0 used in place of the its name below.
*/
static sox_format_handler_t sox_skel_format = {
names,
SOX_FILE_SEEK,
startread,
read,
stopread,
startwrite,
write,
stopwrite,
seek
};
const sox_format_handler_t *sox_skel_format_fn(void);
const sox_format_handler_t *sox_skel_format_fn(void)
{
return &sox_skel_format;
}