audio_output.h 9.2 KB
Newer Older
1
/*****************************************************************************
2
 * audio_output.h : audio output interface
3
 *****************************************************************************
4
 * Copyright (C) 2002 VideoLAN
5
 * $Id: audio_output.h,v 1.82 2003/08/14 11:47:32 gbazin Exp $
6
 *
7
 * Authors: Christophe Massiot <massiot@via.ecp.fr>
8 9 10 11 12
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
13
 *
14 15
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 17
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
18
 *
19 20 21
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
22 23
 *****************************************************************************/

24
/*****************************************************************************
25
 * audio_sample_format_t
26
 *****************************************************************************
27
 * This structure defines a format for audio samples.
28
 *****************************************************************************/
29
struct audio_sample_format_t
Michel Kaempf's avatar
Michel Kaempf committed
30
{
31 32 33 34
    vlc_fourcc_t        i_format;
    unsigned int        i_rate;
    /* Describes the channels configuration of the samples (ie. number of
     * channels which are available in the buffer, and positions). */
35
    uint32_t            i_physical_channels;
36 37
    /* Describes from which original channels, before downmixing, the
     * buffer is derived. */
38
    uint32_t            i_original_channels;
39 40
    /* Optional - for A/52, SPDIF and DTS types : */
    /* Bytes used by one compressed frame, depends on bitrate. */
41
    unsigned int        i_bytes_per_frame;
42
    /* Number of sampleframes contained in one compressed frame. */
43
    unsigned int        i_frame_length;
44 45 46
    /* Please note that it may be completely arbitrary - buffers are not
     * obliged to contain a integral number of so-called "frames". It's
     * just here for the division :
47 48
     * buffer_size = i_nb_samples * i_bytes_per_frame / i_frame_length
     */
49
};
Michel Kaempf's avatar
Michel Kaempf committed
50

51
#define AOUT_FMTS_IDENTICAL( p_first, p_second ) (                          \
52 53
    ((p_first)->i_format == (p_second)->i_format)                           \
      && ((p_first)->i_rate == (p_second)->i_rate)                          \
54 55
      && ((p_first)->i_physical_channels == (p_second)->i_physical_channels)\
      && ((p_first)->i_original_channels == (p_second)->i_original_channels) )
56

57 58 59
/* Check if i_rate == i_rate and i_channels == i_channels */
#define AOUT_FMTS_SIMILAR( p_first, p_second ) (                            \
    ((p_first)->i_rate == (p_second)->i_rate)                               \
60 61
      && ((p_first)->i_physical_channels == (p_second)->i_physical_channels)\
      && ((p_first)->i_original_channels == (p_second)->i_original_channels) )
62

Sam Hocevar's avatar
 
Sam Hocevar committed
63
#ifdef WORDS_BIGENDIAN
64 65
#   define AOUT_FMT_S16_NE VLC_FOURCC('s','1','6','b')
#   define AOUT_FMT_U16_NE VLC_FOURCC('u','1','6','b')
Sam Hocevar's avatar
 
Sam Hocevar committed
66
#else
67 68
#   define AOUT_FMT_S16_NE VLC_FOURCC('s','1','6','l')
#   define AOUT_FMT_U16_NE VLC_FOURCC('u','1','6','l')
69 70
#endif

71
#define AOUT_FMT_NON_LINEAR( p_format )                                    \
72 73 74
    ( ((p_format)->i_format == VLC_FOURCC('s','p','d','i'))                \
       || ((p_format)->i_format == VLC_FOURCC('a','5','2',' '))            \
       || ((p_format)->i_format == VLC_FOURCC('d','t','s',' ')) )
75

76 77 78 79
/* This is heavily borrowed from libmad, by Robert Leslie <rob@mars.org> */
/*
 * Fixed-point format: 0xABBBBBBB
 * A == whole part      (sign + 3 bits)
80
 * B == fractional part (28 bits)
81 82 83 84 85 86 87 88 89 90
 *
 * Values are signed two's complement, so the effective range is:
 * 0x80000000 to 0x7fffffff
 *       -8.0 to +7.9999999962747097015380859375
 *
 * The smallest representable value is:
 * 0x00000001 == 0.0000000037252902984619140625 (i.e. about 3.725e-9)
 *
 * 28 bits of fractional accuracy represent about
 * 8.6 digits of decimal accuracy.
91
 *
92 93 94 95
 * Fixed-point numbers can be added or subtracted as normal
 * integers, but multiplication requires shifting the 64-bit result
 * from 56 fractional bits back to 28 (and rounding.)
 */
96
typedef int32_t vlc_fixed_t;
97 98 99 100 101 102
#define FIXED32_FRACBITS 28
#define FIXED32_MIN ((vlc_fixed_t) -0x80000000L)
#define FIXED32_MAX ((vlc_fixed_t) +0x7fffffffL)
#define FIXED32_ONE ((vlc_fixed_t) 0x10000000)


103 104 105 106 107 108 109 110 111 112 113
/*
 * Channels descriptions
 */

/* Values available for physical and original channels */
#define AOUT_CHAN_CENTER            0x1
#define AOUT_CHAN_LEFT              0x2
#define AOUT_CHAN_RIGHT             0x4
#define AOUT_CHAN_REARCENTER        0x10
#define AOUT_CHAN_REARLEFT          0x20
#define AOUT_CHAN_REARRIGHT         0x40
114 115 116
#define AOUT_CHAN_MIDDLELEFT        0x100
#define AOUT_CHAN_MIDDLERIGHT       0x200
#define AOUT_CHAN_LFE               0x1000
117 118 119 120

/* Values available for original channels only */
#define AOUT_CHAN_DOLBYSTEREO       0x10000
#define AOUT_CHAN_DUALMONO          0x20000
Christophe Massiot's avatar
Christophe Massiot committed
121
#define AOUT_CHAN_REVERSESTEREO     0x40000
122 123

#define AOUT_CHAN_PHYSMASK          0xFFFF
124

gbazin's avatar
 
gbazin committed
125 126 127
/* Values used for the audio-device and audio-channels object variables */
#define AOUT_VAR_MONO               1
#define AOUT_VAR_STEREO             2
128 129 130 131 132 133
#define AOUT_VAR_2F2R               4
#define AOUT_VAR_3F2R               5
#define AOUT_VAR_5_1                6
#define AOUT_VAR_6_1                7
#define AOUT_VAR_7_1                8
#define AOUT_VAR_SPDIF              10
gbazin's avatar
 
gbazin committed
134 135 136 137 138 139

#define AOUT_VAR_CHAN_STEREO        1
#define AOUT_VAR_CHAN_RSTEREO       2
#define AOUT_VAR_CHAN_LEFT          3
#define AOUT_VAR_CHAN_RIGHT         4
#define AOUT_VAR_CHAN_DOLBYS        5
140

141 142 143 144 145
/*****************************************************************************
 * aout_buffer_t : audio output buffer
 *****************************************************************************/
struct aout_buffer_t
{
146
    byte_t *                p_buffer;
147
    int                     i_alloc_type;
148
    /* i_size is the real size of the buffer (used for debug ONLY), i_nb_bytes
149 150
     * is the number of significative bytes in it. */
    size_t                  i_size, i_nb_bytes;
151
    unsigned int            i_nb_samples;
152
    mtime_t                 start_date, end_date;
153

154 155
    struct aout_buffer_t *  p_next;
};
156

Christophe Massiot's avatar
Christophe Massiot committed
157 158
/* Size of a frame for S/PDIF output. */
#define AOUT_SPDIF_SIZE 6144
159

160
/* Number of samples in an A/52 frame. */
161
#define A52_FRAME_NB 1536
162

163 164 165 166 167
/*****************************************************************************
 * audio_date_t : date incrementation without long-term rounding errors
 *****************************************************************************/
struct audio_date_t
{
168 169 170
    mtime_t  date;
    uint32_t i_divider;
    uint32_t i_remainder;
171 172
};

173
/*****************************************************************************
Michel Kaempf's avatar
Michel Kaempf committed
174
 * Prototypes
175
 *****************************************************************************/
176 177 178 179
/* From common.c : */
#define aout_New(a) __aout_New(VLC_OBJECT(a))
VLC_EXPORT( aout_instance_t *, __aout_New, ( vlc_object_t * ) );
VLC_EXPORT( void, aout_Delete, ( aout_instance_t * ) );
180
VLC_EXPORT( void, aout_DateInit, ( audio_date_t *, uint32_t ) );
181 182 183
VLC_EXPORT( void, aout_DateSet, ( audio_date_t *, mtime_t ) );
VLC_EXPORT( void, aout_DateMove, ( audio_date_t *, mtime_t ) );
VLC_EXPORT( mtime_t, aout_DateGet, ( const audio_date_t * ) );
184
VLC_EXPORT( mtime_t, aout_DateIncrement, ( audio_date_t *, uint32_t ) );
185

186 187 188 189 190 191 192
/* From dec.c : */
#define aout_DecNew(a, b, c) __aout_DecNew(VLC_OBJECT(a), b, c)
VLC_EXPORT( aout_input_t *, __aout_DecNew, ( vlc_object_t *, aout_instance_t **, audio_sample_format_t * ) );
VLC_EXPORT( int, aout_DecDelete, ( aout_instance_t *, aout_input_t * ) );
VLC_EXPORT( aout_buffer_t *, aout_DecNewBuffer, ( aout_instance_t *, aout_input_t *, size_t ) );
VLC_EXPORT( void, aout_DecDeleteBuffer, ( aout_instance_t *, aout_input_t *, aout_buffer_t * ) );
VLC_EXPORT( int, aout_DecPlay, ( aout_instance_t *, aout_input_t *, aout_buffer_t * ) );
193

194
/* From intf.c : */
195 196 197 198 199 200 201 202 203 204 205 206
#define aout_VolumeGet(a, b) __aout_VolumeGet(VLC_OBJECT(a), b)
VLC_EXPORT( int, __aout_VolumeGet, ( vlc_object_t *, audio_volume_t * ) );
#define aout_VolumeSet(a, b) __aout_VolumeSet(VLC_OBJECT(a), b)
VLC_EXPORT( int, __aout_VolumeSet, ( vlc_object_t *, audio_volume_t ) );
#define aout_VolumeInfos(a, b) __aout_VolumeInfos(VLC_OBJECT(a), b)
VLC_EXPORT( int, __aout_VolumeInfos, ( vlc_object_t *, audio_volume_t * ) );
#define aout_VolumeUp(a, b, c) __aout_VolumeUp(VLC_OBJECT(a), b, c)
VLC_EXPORT( int, __aout_VolumeUp, ( vlc_object_t *, int, audio_volume_t * ) );
#define aout_VolumeDown(a, b, c) __aout_VolumeDown(VLC_OBJECT(a), b, c)
VLC_EXPORT( int, __aout_VolumeDown, ( vlc_object_t *, int, audio_volume_t * ) );
#define aout_VolumeMute(a, b) __aout_VolumeMute(VLC_OBJECT(a), b)
VLC_EXPORT( int, __aout_VolumeMute, ( vlc_object_t *, audio_volume_t * ) );
207
VLC_EXPORT( int, aout_Restart, ( aout_instance_t * p_aout ) );
gbazin's avatar
 
gbazin committed
208
VLC_EXPORT( int, aout_FindAndRestart, ( vlc_object_t *, const char *, vlc_value_t, vlc_value_t, void * ) );
209
VLC_EXPORT( int, aout_ChannelsRestart, ( vlc_object_t *, const char *, vlc_value_t, vlc_value_t, void * ) );
210