/* -*- Mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/*
Copyright (C) 2013 Jeremy White
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.1 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, see .
*/
/* snd_codec.c
General purpose sound codec routines for use by Spice.
These routines abstract the work of picking a codec and
encoding and decoding the buffers.
Note: these routines have some peculiarities that come from
wanting to provide full backwards compatibility with the original
Spice celt 0.51 implementation. It has some hard requirements
(fixed sample size, fixed compressed buffer size).
See below for documentation of the public routines.
*/
#include "config.h"
#include
#include
#include
#include
#include "snd_codec.h"
#include "mem.h"
#include "log.h"
typedef struct
{
int mode;
int frequency;
#if HAVE_CELT051
CELTMode *celt_mode;
CELTEncoder *celt_encoder;
CELTDecoder *celt_decoder;
#endif
#if HAVE_OPUS
OpusEncoder *opus_encoder;
OpusDecoder *opus_decoder;
#endif
} SndCodecInternal;
/* celt 0.51 specific support routines */
#if HAVE_CELT051
static void snd_codec_destroy_celt051(SndCodecInternal *codec)
{
if (codec->celt_decoder) {
celt051_decoder_destroy(codec->celt_decoder);
codec->celt_decoder = NULL;
}
if (codec->celt_encoder) {
celt051_encoder_destroy(codec->celt_encoder);
codec->celt_encoder = NULL;
}
if (codec->celt_mode) {
celt051_mode_destroy(codec->celt_mode);
codec->celt_mode = NULL;
}
}
static int snd_codec_create_celt051(SndCodecInternal *codec, int purpose)
{
int celt_error;
codec->celt_mode = celt051_mode_create(codec->frequency,
SND_CODEC_PLAYBACK_CHAN,
SND_CODEC_CELT_FRAME_SIZE, &celt_error);
if (! codec->celt_mode) {
spice_printerr("create celt mode failed %d", celt_error);
return SND_CODEC_UNAVAILABLE;
}
if (purpose & SND_CODEC_ENCODE) {
codec->celt_encoder = celt051_encoder_create(codec->celt_mode);
if (! codec->celt_encoder) {
spice_printerr("create celt encoder failed");
goto error;
}
}
if (purpose & SND_CODEC_DECODE) {
codec->celt_decoder = celt051_decoder_create(codec->celt_mode);
if (! codec->celt_decoder) {
spice_printerr("create celt decoder failed");
goto error;
}
}
codec->mode = SPICE_AUDIO_DATA_MODE_CELT_0_5_1;
return SND_CODEC_OK;
error:
snd_codec_destroy_celt051(codec);
return SND_CODEC_UNAVAILABLE;
}
static int snd_codec_encode_celt051(SndCodecInternal *codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size)
{
int n;
if (in_size != SND_CODEC_CELT_FRAME_SIZE * SND_CODEC_PLAYBACK_CHAN * 2)
return SND_CODEC_INVALID_ENCODE_SIZE;
n = celt051_encode(codec->celt_encoder, (celt_int16_t *) in_ptr, NULL, out_ptr, *out_size);
if (n < 0) {
spice_printerr("celt051_encode failed %d\n", n);
return SND_CODEC_ENCODE_FAILED;
}
*out_size = n;
return SND_CODEC_OK;
}
static int snd_codec_decode_celt051(SndCodecInternal *codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size)
{
int n;
n = celt051_decode(codec->celt_decoder, in_ptr, in_size, (celt_int16_t *) out_ptr);
if (n < 0) {
spice_printerr("celt051_decode failed %d\n", n);
return SND_CODEC_DECODE_FAILED;
}
*out_size = SND_CODEC_CELT_FRAME_SIZE * SND_CODEC_PLAYBACK_CHAN * 2 /* 16 fmt */;
return SND_CODEC_OK;
}
#endif
/* Opus support routines */
#if HAVE_OPUS
static void snd_codec_destroy_opus(SndCodecInternal *codec)
{
if (codec->opus_decoder) {
opus_decoder_destroy(codec->opus_decoder);
codec->opus_decoder = NULL;
}
if (codec->opus_encoder) {
opus_encoder_destroy(codec->opus_encoder);
codec->opus_encoder = NULL;
}
}
static int snd_codec_create_opus(SndCodecInternal *codec, int purpose)
{
int opus_error;
if (purpose & SND_CODEC_ENCODE) {
codec->opus_encoder = opus_encoder_create(codec->frequency,
SND_CODEC_PLAYBACK_CHAN,
OPUS_APPLICATION_AUDIO, &opus_error);
if (! codec->opus_encoder) {
spice_printerr("create opus encoder failed; error %d", opus_error);
goto error;
}
}
if (purpose & SND_CODEC_DECODE) {
codec->opus_decoder = opus_decoder_create(codec->frequency,
SND_CODEC_PLAYBACK_CHAN, &opus_error);
if (! codec->opus_decoder) {
spice_printerr("create opus decoder failed; error %d", opus_error);
goto error;
}
}
codec->mode = SPICE_AUDIO_DATA_MODE_OPUS;
return SND_CODEC_OK;
error:
snd_codec_destroy_opus(codec);
return SND_CODEC_UNAVAILABLE;
}
static int snd_codec_encode_opus(SndCodecInternal *codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size)
{
int n;
if (in_size != SND_CODEC_OPUS_FRAME_SIZE * SND_CODEC_PLAYBACK_CHAN * 2)
return SND_CODEC_INVALID_ENCODE_SIZE;
n = opus_encode(codec->opus_encoder, (opus_int16 *) in_ptr, SND_CODEC_OPUS_FRAME_SIZE, out_ptr, *out_size);
if (n < 0) {
spice_printerr("opus_encode failed %d\n", n);
return SND_CODEC_ENCODE_FAILED;
}
*out_size = n;
return SND_CODEC_OK;
}
static int snd_codec_decode_opus(SndCodecInternal *codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size)
{
int n;
n = opus_decode(codec->opus_decoder, in_ptr, in_size, (opus_int16 *) out_ptr,
*out_size / SND_CODEC_PLAYBACK_CHAN / 2, 0);
if (n < 0) {
spice_printerr("opus_decode failed %d\n", n);
return SND_CODEC_DECODE_FAILED;
}
*out_size = n * SND_CODEC_PLAYBACK_CHAN * 2 /* 16 fmt */;
return SND_CODEC_OK;
}
#endif
/*----------------------------------------------------------------------------
** PUBLIC INTERFACE
**--------------------------------------------------------------------------*/
/*
snd_codec_is_capable
Returns TRUE if the current spice implementation can
use the given codec, FALSE otherwise.
mode must be a SPICE_AUDIO_DATA_MODE_XXX enum from spice/enum.h
*/
int snd_codec_is_capable(int mode, int frequency)
{
#if HAVE_CELT051
if (mode == SPICE_AUDIO_DATA_MODE_CELT_0_5_1)
return TRUE;
#endif
#if HAVE_OPUS
if (mode == SPICE_AUDIO_DATA_MODE_OPUS &&
(frequency == SND_CODEC_ANY_FREQUENCY ||
frequency == 48000 || frequency == 24000 ||
frequency == 16000 || frequency == 12000 ||
frequency == 8000) )
return TRUE;
#endif
return FALSE;
}
/*
snd_codec_create
Create a codec control. Required for most functions in this library.
Parameters:
1. codec Pointer to preallocated codec control
2. mode SPICE_AUDIO_DATA_MODE_XXX enum from spice/enum.h
3. encode TRUE if encoding is desired
4. decode TRUE if decoding is desired
Returns:
SND_CODEC_OK if all went well; a different code if not.
snd_codec_destroy is the obvious partner of snd_codec_create.
*/
int snd_codec_create(SndCodec *codec, int mode, int frequency, int purpose)
{
int rc = SND_CODEC_UNAVAILABLE;
SndCodecInternal **c = (SndCodecInternal **) codec;
*c = spice_new0(SndCodecInternal, 1);
(*c)->frequency = frequency;
#if HAVE_CELT051
if (mode == SPICE_AUDIO_DATA_MODE_CELT_0_5_1)
rc = snd_codec_create_celt051(*c, purpose);
#endif
#if HAVE_OPUS
if (mode == SPICE_AUDIO_DATA_MODE_OPUS)
rc = snd_codec_create_opus(*c, purpose);
#endif
return rc;
}
/*
snd_codec_destroy
The obvious companion to snd_codec_create
*/
void snd_codec_destroy(SndCodec *codec)
{
SndCodecInternal **c = (SndCodecInternal **) codec;
if (! c || ! *c)
return;
#if HAVE_CELT051
snd_codec_destroy_celt051(*c);
#endif
#if HAVE_OPUS
snd_codec_destroy_opus(*c);
#endif
free(*c);
*c = NULL;
}
/*
snd_codec_frame_size
Returns the size, in frames, of the raw PCM frame buffer
required by this codec. To get bytes, you'll need
to multiply by channels and sample width.
*/
int snd_codec_frame_size(SndCodec codec)
{
SndCodecInternal *c = (SndCodecInternal *) codec;
#if HAVE_CELT051
if (c && c->mode == SPICE_AUDIO_DATA_MODE_CELT_0_5_1)
return SND_CODEC_CELT_FRAME_SIZE;
#endif
#if HAVE_OPUS
if (c && c->mode == SPICE_AUDIO_DATA_MODE_OPUS)
return SND_CODEC_OPUS_FRAME_SIZE;
#endif
return SND_CODEC_MAX_FRAME_SIZE;
}
/*
snd_codec_encode
Encode a block of data to a compressed buffer.
Parameters:
1. codec Pointer to codec control previously allocated + created
2. in_data Pointer to uncompressed PCM data
3. in_size Input size (for celt, this must be a
particular size, governed by the frame size)
4. out_ptr Pointer to area to write encoded data
5. out_size On input, the maximum size of the output buffer; on
successful return, it will hold the number of bytes
returned. For celt, this must be set to a particular
size to ensure compatibility.
Returns:
SND_CODEC_OK if all went well
*/
int snd_codec_encode(SndCodec codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size)
{
SndCodecInternal *c = (SndCodecInternal *) codec;
#if HAVE_CELT051
if (c && c->mode == SPICE_AUDIO_DATA_MODE_CELT_0_5_1) {
/* The output buffer size in celt determines the compression,
and so is essentially mandatory to use a certain value (47) */
if (*out_size > SND_CODEC_CELT_COMPRESSED_FRAME_BYTES)
*out_size = SND_CODEC_CELT_COMPRESSED_FRAME_BYTES;
return snd_codec_encode_celt051(c, in_ptr, in_size, out_ptr, out_size);
}
#endif
#if HAVE_OPUS
if (c && c->mode == SPICE_AUDIO_DATA_MODE_OPUS)
return snd_codec_encode_opus(c, in_ptr, in_size, out_ptr, out_size);
#endif
return SND_CODEC_ENCODER_UNAVAILABLE;
}
/*
snd_codec_decode
Decode a block of data from a compressed buffer.
Parameters:
1. codec Pointer to codec control previously allocated + created
2. in_data Pointer to compressed data
3. in_size Input size
4. out_ptr Pointer to area to write decoded data
5. out_size On input, the maximum size of the output buffer; on
successful return, it will hold the number of bytes
returned.
Returns:
SND_CODEC_OK if all went well
*/
int snd_codec_decode(SndCodec codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size)
{
SndCodecInternal *c = (SndCodecInternal *) codec;
#if HAVE_CELT051
if (c && c->mode == SPICE_AUDIO_DATA_MODE_CELT_0_5_1)
return snd_codec_decode_celt051(c, in_ptr, in_size, out_ptr, out_size);
#endif
#if HAVE_OPUS
if (c && c->mode == SPICE_AUDIO_DATA_MODE_OPUS)
return snd_codec_decode_opus(c, in_ptr, in_size, out_ptr, out_size);
#endif
return SND_CODEC_DECODER_UNAVAILABLE;
}