avdevice.h 2.77 KB
Newer Older
Luca Abeni's avatar
Luca Abeni committed
1
/*
2
 * This file is part of Libav.
Luca Abeni's avatar
Luca Abeni committed
3
 *
4
 * Libav is free software; you can redistribute it and/or
Luca Abeni's avatar
Luca Abeni committed
5 6 7 8
 * 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.
 *
9
 * Libav is distributed in the hope that it will be useful,
Luca Abeni's avatar
Luca Abeni committed
10 11 12 13 14
 * 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
15
 * License along with Libav; if not, write to the Free Software
Luca Abeni's avatar
Luca Abeni committed
16 17 18
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

19 20
#ifndef AVDEVICE_AVDEVICE_H
#define AVDEVICE_AVDEVICE_H
Luca Abeni's avatar
Luca Abeni committed
21

22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
/**
 * @file
 * @ingroup lavd
 * Main libavdevice API header
 */

/**
 * @defgroup lavd Special devices muxing/demuxing library
 * @{
 * Libavdevice is a complementary library to @ref libavf "libavformat". It
 * provides various "special" platform-specific muxers and demuxers, e.g. for
 * grabbing devices, audio capture and playback etc. As a consequence, the
 * (de)muxers in libavdevice are of the AVFMT_NOFILE type (they use their own
 * I/O functions). The filename passed to avformat_open_input() often does not
 * refer to an actually existing file, but has some special device-specific
 * meaning - e.g. for the x11grab device it is the display name.
 *
 * To use libavdevice, simply call avdevice_register_all() to register all
 * compiled muxers and demuxers. They all use standard libavformat API.
 * @}
 */

44 45
#include "libavutil/avutil.h"

46
#define LIBAVDEVICE_VERSION_MAJOR 53
47
#define LIBAVDEVICE_VERSION_MINOR  2
48
#define LIBAVDEVICE_VERSION_MICRO  0
49

50 51 52 53 54 55
#define LIBAVDEVICE_VERSION_INT AV_VERSION_INT(LIBAVDEVICE_VERSION_MAJOR, \
                                               LIBAVDEVICE_VERSION_MINOR, \
                                               LIBAVDEVICE_VERSION_MICRO)
#define LIBAVDEVICE_VERSION     AV_VERSION(LIBAVDEVICE_VERSION_MAJOR, \
                                           LIBAVDEVICE_VERSION_MINOR, \
                                           LIBAVDEVICE_VERSION_MICRO)
Luca Abeni's avatar
Luca Abeni committed
56 57
#define LIBAVDEVICE_BUILD       LIBAVDEVICE_VERSION_INT

58 59 60 61
#ifndef FF_API_V4L
#define FF_API_V4L              (LIBAVDEVICE_VERSION_MAJOR < 54)
#endif

62
/**
63
 * Return the LIBAVDEVICE_VERSION_INT constant.
64 65 66
 */
unsigned avdevice_version(void);

67
/**
68
 * Return the libavdevice build-time configuration.
69
 */
Stefano Sabatini's avatar
Stefano Sabatini committed
70
const char *avdevice_configuration(void);
71 72

/**
73
 * Return the libavdevice license.
74
 */
Stefano Sabatini's avatar
Stefano Sabatini committed
75
const char *avdevice_license(void);
76

Luca Abeni's avatar
Luca Abeni committed
77 78 79 80 81 82
/**
 * Initialize libavdevice and register all the input and output devices.
 * @warning This function is not thread safe.
 */
void avdevice_register_all(void);

83
#endif /* AVDEVICE_AVDEVICE_H */
Luca Abeni's avatar
Luca Abeni committed
84