1
/* $Id: config.h 4414 2013-03-05 08:21:02Z riza $ */
3
* Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com)
5
* This program is free software; you can redistribute it and/or modify
6
* it under the terms of the GNU General Public License as published by
7
* the Free Software Foundation; either version 2 of the License, or
8
* (at your option) any later version.
10
* This program is distributed in the hope that it will be useful,
11
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
* GNU General Public License for more details.
15
* You should have received a copy of the GNU General Public License
16
* along with this program; if not, write to the Free Software
17
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19
#ifndef __PJMEDIA_VIDEODEV_CONFIG_H__
20
#define __PJMEDIA_VIDEODEV_CONFIG_H__
24
* @brief Video config.
26
#include <pjmedia/types.h>
33
* @defgroup video_device_api Video Device API
34
* @brief PJMEDIA video device abstraction API.
38
* @defgroup s1_video_device_config Compile time configurations
39
* @ingroup video_device_api
40
* @brief Compile time configurations
45
* This setting controls the maximum number of formats that can be
46
* supported by a video device.
50
#ifndef PJMEDIA_VID_DEV_INFO_FMT_CNT
51
# define PJMEDIA_VID_DEV_INFO_FMT_CNT 16
56
* This setting controls whether SDL support should be included.
58
* Default: 0 (or detected by configure)
60
#ifndef PJMEDIA_VIDEO_DEV_HAS_SDL
61
# define PJMEDIA_VIDEO_DEV_HAS_SDL 0
62
# define PJMEDIA_VIDEO_DEV_SDL_HAS_OPENGL 0
67
* This setting controls whether QT support should be included.
69
* Default: 0 (or detected by configure)
71
#ifndef PJMEDIA_VIDEO_DEV_HAS_QT
72
# define PJMEDIA_VIDEO_DEV_HAS_QT 0
77
* This setting controls whether IOS support should be included.
79
* Default: 0 (or detected by configure)
81
#ifndef PJMEDIA_VIDEO_DEV_HAS_IOS
82
# define PJMEDIA_VIDEO_DEV_HAS_IOS 0
87
* This setting controls whether Direct Show support should be included.
89
* Default: 0 (unfinished)
91
#ifndef PJMEDIA_VIDEO_DEV_HAS_DSHOW
92
# define PJMEDIA_VIDEO_DEV_HAS_DSHOW 0 //PJ_WIN32
97
* This setting controls whether colorbar source support should be included.
101
#ifndef PJMEDIA_VIDEO_DEV_HAS_CBAR_SRC
102
# define PJMEDIA_VIDEO_DEV_HAS_CBAR_SRC 1
107
* This setting controls whether ffmpeg support should be included.
109
* Default: 0 (unfinished)
111
#ifndef PJMEDIA_VIDEO_DEV_HAS_FFMPEG
112
# define PJMEDIA_VIDEO_DEV_HAS_FFMPEG 0
119
* Default: 0 (or detected by configure)
121
#ifndef PJMEDIA_VIDEO_DEV_HAS_V4L2
122
# define PJMEDIA_VIDEO_DEV_HAS_V4L2 0
127
* Enable support for AVI player virtual capture device.
131
#ifndef PJMEDIA_VIDEO_DEV_HAS_AVI
132
# define PJMEDIA_VIDEO_DEV_HAS_AVI 1
136
* Specify the SDL library name to be linked with Visual Studio project.
137
* By default, the name is autodetected based on SDL version ("sdl.lib" or
138
* "sdl2.lib"), but application may explicitly specify the library name if this
139
* autodetection fails. Common names are: "sdl2.lib" or "sdl.lib".
141
* Default: undeclared.
143
#ifndef PJMEDIA_SDL_LIB
144
# undef PJMEDIA_SDL_LIB
154
#endif /* __PJMEDIA_VIDEODEV_CONFIG_H__ */
157
--------------------- DOCUMENTATION FOLLOWS ---------------------------
161
* @addtogroup video_device_api Video Device API
164
PJMEDIA Video Device API is a cross-platform video API appropriate for use with
165
VoIP applications and many other types of video streaming applications.
167
The API abstracts many different video API's on various platforms, such as:
168
- native Direct Show video for Win32 and Windows Mobile devices
169
- null-video implementation
170
- and more to be implemented in the future
172
The Video Device API/library is an evolution from PJMEDIA @ref PJMED_SND and
173
contains many enhancements:
175
- Forward compatibility:
177
The new API has been designed to be extensible, it will support new API's as
178
well as new features that may be introduced in the future without breaking
179
compatibility with applications that use this API as well as compatibility
180
with existing device implementations.
182
- Device capabilities:
184
At the heart of the API is device capabilities management, where all possible
185
video capabilities of video devices should be able to be handled in a generic
186
manner. With this framework, new capabilities that may be discovered in the
187
future can be handled in manner without breaking existing applications.
191
The device capabilities framework enables applications to use and control
192
video features built-in in the device, such as:
198
Some video devices support built-in hardware video codecs, and application
199
can use the video device in encoded mode to make use of these hardware
204
The new API supports multiple video backends (called factories or drivers in
205
the code) to be active simultaneously, and video backends may be added or
206
removed during run-time.