tls: Hide backend implementation details from users
[libav.git] / libavformat / mov_chan.h
1 /*
2 * Copyright (c) 2011 Justin Ruggles
3 *
4 * This file is part of Libav.
5 *
6 * Libav is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * Libav is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with Libav; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 /**
22 * mov 'chan' tag reading/writing.
23 * @author Justin Ruggles
24 */
25
26 #ifndef AVFORMAT_MOV_CHAN_H
27 #define AVFORMAT_MOV_CHAN_H
28
29 #include <stdint.h>
30
31 #include "libavcodec/avcodec.h"
32 #include "avformat.h"
33
34 /**
35 * Get the channel layout for the specified channel layout tag.
36 *
37 * @param[in] tag channel layout tag
38 * @param[out] bitmap channel bitmap (only used if needed)
39 * @return channel layout
40 */
41 uint64_t ff_mov_get_channel_layout(uint32_t tag, uint32_t bitmap);
42
43 /**
44 * Get the channel layout tag for the specified codec id and channel layout.
45 * If the layout tag was not found, use a channel bitmap if possible.
46 *
47 * @param[in] codec_id codec id
48 * @param[in] channel_layout channel layout
49 * @param[out] bitmap channel bitmap
50 * @return channel layout tag
51 */
52 uint32_t ff_mov_get_channel_layout_tag(enum AVCodecID codec_id,
53 uint64_t channel_layout,
54 uint32_t *bitmap);
55
56 /**
57 * Read 'chan' tag from the input stream.
58 *
59 * @param s AVFormatContext
60 * @param pb AVIOContext
61 * @param st The stream to set codec values for
62 * @param size Remaining size in the 'chan' tag
63 * @return 0 if ok, or negative AVERROR code on failure
64 */
65 int ff_mov_read_chan(AVFormatContext *s, AVIOContext *pb, AVStream *st,
66 int64_t size);
67
68 #endif /* AVFORMAT_MOV_CHAN_H */