stream/tv.h

   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 typedef struct tvi_functions_s
 113 {
 114     int (*init)();
 115     int (*uninit)();
 116     int (*control)();
 117     int (*start)();
 118     double (*grab_video_frame)();
 119     int (*get_video_framesize)();
 120     double (*grab_audio_frame)();
 121     int (*get_audio_framesize)();
 122 } tvi_functions_t;
 123
 124 typedef struct tvi_handle_s {
 125     const tvi_functions_t       *functions;
 126     void                *priv;
 127     int                 seq;
 128     demuxer_t           *demuxer;
 129
 130     /* specific */
 131     int                 norm;
 132     int                 chanlist;
 133     const struct CHANLIST *chanlist_s;
 134     int                 channel;
 135     tv_param_t          * tv_param;
 136     void                * scan;
 137 } tvi_handle_t;
 138
 139 typedef struct tv_channels_s {
 140     int index;
 141     char number[5];
 142     char name[20];
 143     int norm;
 144     int   freq;
 145     struct tv_channels_s *next;
 146     struct tv_channels_s *prev;
 147 } tv_channels_t;
 148
 149 extern tv_channels_t *tv_channel_list;
 150 extern tv_channels_t *tv_channel_current, *tv_channel_last;
 151 extern char *tv_channel_last_real;
 152
 153 typedef struct {
 154     unsigned int     scan_timer;
 155     int     channel_num;
 156     int     new_channels;
 157 } tv_scan_t;
 158
 159 #define TVI_CONTROL_FALSE               0
 160 #define TVI_CONTROL_TRUE                1
 161 #define TVI_CONTROL_NA                  -1
 162 #define TVI_CONTROL_UNKNOWN             -2
 163
 164 /* ======================== CONTROLS =========================== */
 165
 166 /* GENERIC controls */
 167 #define TVI_CONTROL_IS_AUDIO            0x1
 168 #define TVI_CONTROL_IS_VIDEO            0x2
 169 #define TVI_CONTROL_IS_TUNER            0x3
 170 #define TVI_CONTROL_IMMEDIATE           0x4
 171
 172 /* VIDEO controls */
 173 #define TVI_CONTROL_VID_GET_FPS         0x101
 174 #define TVI_CONTROL_VID_GET_PLANES      0x102
 175 #define TVI_CONTROL_VID_GET_BITS        0x103
 176 #define TVI_CONTROL_VID_CHK_BITS        0x104
 177 #define TVI_CONTROL_VID_SET_BITS        0x105
 178 #define TVI_CONTROL_VID_GET_FORMAT      0x106
 179 #define TVI_CONTROL_VID_CHK_FORMAT      0x107
 180 #define TVI_CONTROL_VID_SET_FORMAT      0x108
 181 #define TVI_CONTROL_VID_GET_WIDTH       0x109
 182 #define TVI_CONTROL_VID_CHK_WIDTH       0x110
 183 #define TVI_CONTROL_VID_SET_WIDTH       0x111
 184 #define TVI_CONTROL_VID_GET_HEIGHT      0x112
 185 #define TVI_CONTROL_VID_CHK_HEIGHT      0x113
 186 #define TVI_CONTROL_VID_SET_HEIGHT      0x114
 187 #define TVI_CONTROL_VID_GET_BRIGHTNESS  0x115
 188 #define TVI_CONTROL_VID_SET_BRIGHTNESS  0x116
 189 #define TVI_CONTROL_VID_GET_HUE         0x117
 190 #define TVI_CONTROL_VID_SET_HUE         0x118
 191 #define TVI_CONTROL_VID_GET_SATURATION  0x119
 192 #define TVI_CONTROL_VID_SET_SATURATION  0x11a
 193 #define TVI_CONTROL_VID_GET_CONTRAST    0x11b
 194 #define TVI_CONTROL_VID_SET_CONTRAST    0x11c
 195 #define TVI_CONTROL_VID_GET_PICTURE     0x11d
 196 #define TVI_CONTROL_VID_SET_PICTURE     0x11e
 197 #define TVI_CONTROL_VID_SET_GAIN        0x11f
 198 #define TVI_CONTROL_VID_GET_GAIN        0x120
 199 #define TVI_CONTROL_VID_SET_WIDTH_HEIGHT        0x121
 200
 201 /* TUNER controls */
 202 #define TVI_CONTROL_TUN_GET_FREQ        0x201
 203 #define TVI_CONTROL_TUN_SET_FREQ        0x202
 204 #define TVI_CONTROL_TUN_GET_TUNER       0x203   /* update priv->tuner struct for used input */
 205 #define TVI_CONTROL_TUN_SET_TUNER       0x204   /* update priv->tuner struct for used input */
 206 #define TVI_CONTROL_TUN_GET_NORM        0x205
 207 #define TVI_CONTROL_TUN_SET_NORM        0x206
 208 #define TVI_CONTROL_TUN_GET_SIGNAL      0x207
 209
 210 /* AUDIO controls */
 211 #define TVI_CONTROL_AUD_GET_FORMAT      0x301
 212 #define TVI_CONTROL_AUD_GET_SAMPLERATE  0x302
 213 #define TVI_CONTROL_AUD_GET_SAMPLESIZE  0x303
 214 #define TVI_CONTROL_AUD_GET_CHANNELS    0x304
 215 #define TVI_CONTROL_AUD_SET_SAMPLERATE  0x305
 216
 217 /* SPECIFIC controls */
 218 #define TVI_CONTROL_SPC_GET_INPUT       0x401   /* set input channel (tv,s-video,composite..) */
 219 #define TVI_CONTROL_SPC_SET_INPUT       0x402   /* set input channel (tv,s-video,composite..) */
 220 #define TVI_CONTROL_SPC_GET_NORMID      0x403   /* get normid from norm name */
 221
 222 //tvi_* ioctl (not dec_teletext.c !!!)
 223 #define TVI_CONTROL_VBI_INIT           0x501   ///< vbi init
 224 #define TVI_CONTROL_GET_VBI_PTR        0x502   ///< get teletext private pointer
 225
 226 int tv_set_color_options(tvi_handle_t *tvh, int opt, int val);
 227 int tv_get_color_options(tvi_handle_t *tvh, int opt, int* val);
 228 #define TV_COLOR_BRIGHTNESS     1
 229 #define TV_COLOR_HUE            2
 230 #define TV_COLOR_SATURATION     3
 231 #define TV_COLOR_CONTRAST       4
 232
 233 int tv_step_channel_real(tvi_handle_t *tvh, int direction);
 234 int tv_step_channel(tvi_handle_t *tvh, int direction);
 235 #define TV_CHANNEL_LOWER        1
 236 #define TV_CHANNEL_HIGHER       2
 237
 238 int tv_last_channel(tvi_handle_t *tvh);
 239
 240 int tv_set_channel_real(tvi_handle_t *tvh, char *channel);
 241 int tv_set_channel(tvi_handle_t *tvh, char *channel);
 242
 243 int tv_step_norm(tvi_handle_t *tvh);
 244 int tv_step_chanlist(tvi_handle_t *tvh);
 245
 246 int tv_set_freq(tvi_handle_t *tvh, unsigned long freq);
 247 int tv_get_freq(tvi_handle_t *tvh, unsigned long *freq);
 248 int tv_get_signal(tvi_handle_t *tvh);
 249 int tv_step_freq(tvi_handle_t *tvh, float step_interval);
 250
 251 int tv_set_norm(tvi_handle_t *tvh, char* norm);
 252
 253 void tv_start_scan(tvi_handle_t *tvh, int start);
 254
 255 #define TV_NORM_PAL             1
 256 #define TV_NORM_NTSC            2
 257 #define TV_NORM_SECAM           3
 258 #define TV_NORM_PALNC           4
 259 #define TV_NORM_PALM            5
 260 #define TV_NORM_PALN            6
 261 #define TV_NORM_NTSCJP          7
 262
 263 #endif /* MPLAYER_TV_H */