1 /*
2  * TV interface
3  *
4  * Copyright (C) 2001 Alex Beregszászi
5  * Copyright (C) 2007 Attila Ötvös
6  * Copyright (C) 2007 Vladimir Voroshilov <voroshil@gmail.com>
7  *
8  * This file is part of MPlayer.
9  *
10  * MPlayer is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * MPlayer is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License along
21  * with MPlayer; if not, write to the Free Software Foundation, Inc.,
22  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23  */
24 
25 #ifndef MPLAYER_TV_H
26 #define MPLAYER_TV_H
27 
28 #include "libmpcodecs/dec_teletext.h"
29 #include "libmpdemux/demuxer.h"
30 
31 typedef struct tv_param_s {
32     char *freq;
33     char *channel;
34     char *chanlist;
35     char *norm;
36     int automute;
37     int normid;
38     char *device;
39     char *driver;
40     int width;
41     int height;
42     int input;
43     int outfmt;
44     float fps;
45     char **channels;
46     int noaudio;
47     int immediate;
48     int audiorate;
49     int audio_id;
50     int amode;
51     int volume;
52     int bass;
53     int treble;
54     int balance;
55     int forcechan;
56     int force_audio;
57     int buffer_size;
58     int mjpeg;
59     int decimation;
60     int quality;
61     int alsa;
62     char* adevice;
63     int brightness;
64     int contrast;
65     int hue;
66     int saturation;
67     int gain;
68     struct tt_param teletext;
69 
70     int scan;
71     int scan_threshold;
72     float scan_period;
73     /**
74       Terminate stream with video renderer instead of Null renderer
75       Will help if video freezes but audio does not.
76       May not work with -vo directx and -vf crop combination.
77     */
78     int hidden_video_renderer;
79     /**
80       For VIVO cards VP pin have to be rendered too.
81       This tweak will cause VidePort pin stream to be terminated with video renderer
82       instead of removing it from graph.
83       Use if your card have vp pin and video is still choppy.
84       May not work with -vo directx and -vf crop combination.
85     */
86     int hidden_vp_renderer;
87     /**
88       Use system clock as sync source instead of default graph clock (usually the clock
89       from one of live sources in graph.
90     */
91     int system_clock;
92     /**
93       Some audio cards creates audio chunks with about 0.5 sec size.
94       This can cause choppy video when using mplayer with immediatemode=0
95       Use followingtweak to decrease audio chunk sizes.
96       It will create audio chunks with time length equal to one video frame time.
97     */
98     int normalize_audio_chunks;
99 } tv_param_t;
100 
101 extern tv_param_t stream_tv_defaults;
102 
103 typedef struct tvi_info_s
104 {
105     struct tvi_handle_s * (*tvi_init)(tv_param_t* tv_param);
106     const char *name;
107     const char *short_name;
108     const char *author;
109     const char *comment;
110 } tvi_info_t;
111 
112 
113 struct priv;
114 
115 typedef struct tvi_functions_s
116 {
117     int (*init)(struct priv *priv);
118     int (*uninit)(struct priv *priv);
119     int (*control)(struct priv *priv, int cmd, void *arg);
120     int (*start)(struct priv *priv);
121     double (*grab_video_frame)(struct priv *priv, char *buffer, int len);
122     int (*get_video_framesize)(struct priv *priv);
123     double (*grab_audio_frame)(struct priv *priv, char *buffer, int len);
124     int (*get_audio_framesize)(struct priv *priv);
125 } tvi_functions_t;
126 
127 typedef struct tvi_handle_s {
128     const tvi_functions_t	*functions;
129     void		*priv;
130     int 		seq;
131     demuxer_t		*demuxer;
132 
133     /* specific */
134     int			norm;
135     int			chanlist;
136     const struct CHANLIST *chanlist_s;
137     int			channel;
138     tv_param_t          * tv_param;
139     void                * scan;
140 } tvi_handle_t;
141 
142 typedef struct tv_channels_s {
143     int index;
144     char number[5];
145     char name[20];
146     int norm;
147     int   freq;
148     struct tv_channels_s *next;
149     struct tv_channels_s *prev;
150 } tv_channels_t;
151 
152 extern tv_channels_t *tv_channel_list;
153 extern tv_channels_t *tv_channel_current, *tv_channel_last;
154 extern char *tv_channel_last_real;
155 
156 typedef struct {
157     unsigned int     scan_timer;
158     int     channel_num;
159     int     new_channels;
160 } tv_scan_t;
161 
162 #define TVI_CONTROL_FALSE		0
163 #define TVI_CONTROL_TRUE		1
164 #define TVI_CONTROL_NA			-1
165 #define TVI_CONTROL_UNKNOWN		-2
166 
167 /* ======================== CONTROLS =========================== */
168 
169 /* GENERIC controls */
170 #define TVI_CONTROL_IS_AUDIO		0x1
171 #define TVI_CONTROL_IS_VIDEO		0x2
172 #define TVI_CONTROL_IS_TUNER		0x3
173 #define TVI_CONTROL_IMMEDIATE           0x4
174 
175 /* VIDEO controls */
176 #define TVI_CONTROL_VID_GET_FPS		0x101
177 #define TVI_CONTROL_VID_GET_PLANES	0x102
178 #define TVI_CONTROL_VID_GET_BITS	0x103
179 #define TVI_CONTROL_VID_CHK_BITS	0x104
180 #define TVI_CONTROL_VID_SET_BITS	0x105
181 #define TVI_CONTROL_VID_GET_FORMAT	0x106
182 #define TVI_CONTROL_VID_CHK_FORMAT	0x107
183 #define TVI_CONTROL_VID_SET_FORMAT	0x108
184 #define TVI_CONTROL_VID_GET_WIDTH	0x109
185 #define TVI_CONTROL_VID_CHK_WIDTH	0x110
186 #define TVI_CONTROL_VID_SET_WIDTH	0x111
187 #define TVI_CONTROL_VID_GET_HEIGHT	0x112
188 #define TVI_CONTROL_VID_CHK_HEIGHT	0x113
189 #define TVI_CONTROL_VID_SET_HEIGHT	0x114
190 #define TVI_CONTROL_VID_GET_BRIGHTNESS	0x115
191 #define TVI_CONTROL_VID_SET_BRIGHTNESS	0x116
192 #define TVI_CONTROL_VID_GET_HUE		0x117
193 #define TVI_CONTROL_VID_SET_HUE		0x118
194 #define TVI_CONTROL_VID_GET_SATURATION	0x119
195 #define TVI_CONTROL_VID_SET_SATURATION	0x11a
196 #define TVI_CONTROL_VID_GET_CONTRAST	0x11b
197 #define TVI_CONTROL_VID_SET_CONTRAST	0x11c
198 #define TVI_CONTROL_VID_GET_PICTURE	0x11d
199 #define TVI_CONTROL_VID_SET_PICTURE	0x11e
200 #define TVI_CONTROL_VID_SET_GAIN	0x11f
201 #define TVI_CONTROL_VID_GET_GAIN	0x120
202 #define TVI_CONTROL_VID_SET_WIDTH_HEIGHT	0x121
203 
204 /* TUNER controls */
205 #define TVI_CONTROL_TUN_GET_FREQ	0x201
206 #define TVI_CONTROL_TUN_SET_FREQ	0x202
207 #define TVI_CONTROL_TUN_GET_TUNER	0x203	/* update priv->tuner struct for used input */
208 #define TVI_CONTROL_TUN_SET_TUNER	0x204	/* update priv->tuner struct for used input */
209 #define TVI_CONTROL_TUN_GET_NORM	0x205
210 #define TVI_CONTROL_TUN_SET_NORM	0x206
211 #define TVI_CONTROL_TUN_GET_SIGNAL	0x207
212 
213 /* AUDIO controls */
214 #define TVI_CONTROL_AUD_GET_FORMAT	0x301
215 #define TVI_CONTROL_AUD_GET_SAMPLERATE	0x302
216 #define TVI_CONTROL_AUD_GET_SAMPLESIZE	0x303
217 #define TVI_CONTROL_AUD_GET_CHANNELS	0x304
218 #define TVI_CONTROL_AUD_SET_SAMPLERATE	0x305
219 
220 /* SPECIFIC controls */
221 #define TVI_CONTROL_SPC_GET_INPUT	0x401	/* set input channel (tv,s-video,composite..) */
222 #define TVI_CONTROL_SPC_SET_INPUT	0x402	/* set input channel (tv,s-video,composite..) */
223 #define TVI_CONTROL_SPC_GET_NORMID	0x403	/* get normid from norm name */
224 
225 //tvi_* ioctl (not dec_teletext.c !!!)
226 #define TVI_CONTROL_VBI_INIT           0x501   ///< vbi init
227 #define TVI_CONTROL_GET_VBI_PTR        0x502   ///< get teletext private pointer
228 
229 int tv_set_color_options(tvi_handle_t *tvh, int opt, int val);
230 int tv_get_color_options(tvi_handle_t *tvh, int opt, int* val);
231 #define TV_COLOR_BRIGHTNESS	1
232 #define TV_COLOR_HUE		2
233 #define TV_COLOR_SATURATION	3
234 #define TV_COLOR_CONTRAST	4
235 
236 int tv_step_channel_real(tvi_handle_t *tvh, int direction);
237 int tv_step_channel(tvi_handle_t *tvh, int direction);
238 #define TV_CHANNEL_LOWER	1
239 #define TV_CHANNEL_HIGHER	2
240 
241 int tv_last_channel(tvi_handle_t *tvh);
242 
243 int tv_set_channel_real(tvi_handle_t *tvh, char *channel);
244 int tv_set_channel(tvi_handle_t *tvh, char *channel);
245 
246 int tv_step_norm(tvi_handle_t *tvh);
247 int tv_step_chanlist(tvi_handle_t *tvh);
248 
249 int tv_set_freq(tvi_handle_t *tvh, unsigned long freq);
250 int tv_get_freq(tvi_handle_t *tvh, unsigned long *freq);
251 int tv_get_signal(tvi_handle_t *tvh);
252 int tv_step_freq(tvi_handle_t *tvh, float step_interval);
253 
254 int tv_set_norm(tvi_handle_t *tvh, char* norm);
255 
256 void tv_start_scan(tvi_handle_t *tvh, int start);
257 
258 tvi_handle_t *tv_new_handle(int size, const tvi_functions_t *functions);
259 void tv_free_handle(tvi_handle_t *h);
260 
261 #define TV_NORM_PAL		1
262 #define TV_NORM_NTSC		2
263 #define TV_NORM_SECAM		3
264 #define TV_NORM_PALNC		4
265 #define TV_NORM_PALM		5
266 #define TV_NORM_PALN		6
267 #define TV_NORM_NTSCJP		7
268 
269 #endif /* MPLAYER_TV_H */
270