summaryrefslogtreecommitdiffstats
path: root/common/snd_codec.h
blob: e4122a480dec04ed1b862639a384cf6040436ebe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
/* -*- Mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/*
   Copyright (C) 2013 Jeremy White <jwhite@codeweavers.com>

   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 <http://www.gnu.org/licenses/>.
*/

#ifndef _H_SND_CODEC
#define _H_SND_CODEC


#if HAVE_CELT051
#include <celt051/celt.h>
#endif

#if HAVE_OPUS
#include  <opus.h>
#endif

/* Spice uses a very fixed protocol when transmitting CELT audio;
   audio must be transmitted in frames of 256, and we must compress
   data down to a fairly specific size (47, computation below).
   While the protocol doesn't inherently specify this, the expectation
   of older clients and server mandates it.
*/
#define SND_CODEC_CELT_FRAME_SIZE       256
#define SND_CODEC_CELT_BIT_RATE         (64 * 1024)
#define SND_CODEC_CELT_PLAYBACK_FREQ    44100
#define SND_CODEC_CELT_COMPRESSED_FRAME_BYTES (SND_CODEC_CELT_FRAME_SIZE * SND_CODEC_CELT_BIT_RATE / \
                                        SND_CODEC_CELT_PLAYBACK_FREQ / 8)

#define SND_CODEC_OPUS_FRAME_SIZE       480
#define SND_CODEC_OPUS_PLAYBACK_FREQ    48000
#define SND_CODEC_OPUS_COMPRESSED_FRAME_BYTES 480

#define SND_CODEC_PLAYBACK_CHAN         2

#define SND_CODEC_MAX_FRAME_SIZE        (MAX(SND_CODEC_CELT_FRAME_SIZE, SND_CODEC_OPUS_FRAME_SIZE))
#define SND_CODEC_MAX_FRAME_BYTES       (SND_CODEC_MAX_FRAME_SIZE * SND_CODEC_PLAYBACK_CHAN * 2 /* FMT_S16 */)
#define SND_CODEC_MAX_COMPRESSED_BYTES  MAX(SND_CODEC_CELT_COMPRESSED_FRAME_BYTES, SND_CODEC_OPUS_COMPRESSED_FRAME_BYTES)

#define SND_CODEC_ANY_FREQUENCY        -1

#define SND_CODEC_OK                    0
#define SND_CODEC_UNAVAILABLE           1
#define SND_CODEC_ENCODER_UNAVAILABLE   2
#define SND_CODEC_DECODER_UNAVAILABLE   3
#define SND_CODEC_ENCODE_FAILED         4
#define SND_CODEC_DECODE_FAILED         5
#define SND_CODEC_INVALID_ENCODE_SIZE   6

#define SND_CODEC_ENCODE                0x0001
#define SND_CODEC_DECODE                0x0002

SPICE_BEGIN_DECLS

typedef struct SndCodecInternal * SndCodec;

int  snd_codec_is_capable(int mode, int frequency);

int  snd_codec_create(SndCodec *codec, int mode, int frequency, int purpose);
void snd_codec_destroy(SndCodec *codec);

int  snd_codec_frame_size(SndCodec codec);

int  snd_codec_encode(SndCodec codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size);
int  snd_codec_decode(SndCodec codec, uint8_t *in_ptr, int in_size, uint8_t *out_ptr, int *out_size);

SPICE_END_DECLS

#endif