mirror of
https://gitlab.uni-freiburg.de/opensourcevdi/spice-common
synced 2025-12-26 22:55:35 +00:00
f3d6c5f322
Include headers required for implementation only in the implementation file. This remove dependency and avoid the user component having to check for header flags (in this case HAVE_CELT051 and HAVE_OPUS). This make easier integration in other components. This also make compilation faster. Signed-off-by: Frediano Ziglio <fziglio@redhat.com>
74 lines
2.9 KiB
C
74 lines
2.9 KiB
C
/* -*- 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_SPICE_COMMON_SND_CODEC
|
|
#define H_SPICE_COMMON_SND_CODEC
|
|
|
|
/* 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
|