input/input.h

   1 /*
   2  * This file is part of MPlayer.
   3  *
   4  * MPlayer is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * MPlayer is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along
  15  * with MPlayer; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  17  */
  18
  19 #ifndef MPLAYER_INPUT_H
  20 #define MPLAYER_INPUT_H
  21
  22 #include <stdbool.h>
  23
  24 // All command IDs
  25 enum mp_command_type {
  26     MP_CMD_SEEK,
  27     MP_CMD_AUDIO_DELAY,
  28     MP_CMD_QUIT,
  29     MP_CMD_PAUSE,
  30     MP_CMD_PLAY_TREE_STEP,
  31     MP_CMD_PLAY_TREE_UP_STEP,
  32     MP_CMD_PLAY_ALT_SRC_STEP,
  33     MP_CMD_SUB_DELAY,
  34     MP_CMD_OSD,
  35     MP_CMD_VOLUME,
  36     MP_CMD_CONTRAST,
  37     MP_CMD_BRIGHTNESS,
  38     MP_CMD_HUE,
  39     MP_CMD_SATURATION,
  40     MP_CMD_FRAMEDROPPING,
  41     MP_CMD_TV_STEP_CHANNEL,
  42     MP_CMD_TV_STEP_NORM,
  43     MP_CMD_TV_STEP_CHANNEL_LIST,
  44     MP_CMD_CAPTURING,
  45     MP_CMD_VO_FULLSCREEN,
  46     MP_CMD_SUB_POS,
  47     MP_CMD_DVDNAV,
  48     MP_CMD_SCREENSHOT,
  49     MP_CMD_PANSCAN,
  50     MP_CMD_MUTE,
  51     MP_CMD_LOADFILE,
  52     MP_CMD_LOADLIST,
  53     MP_CMD_VF_CHANGE_RECTANGLE,
  54     MP_CMD_GAMMA,
  55     MP_CMD_SUB_VISIBILITY,
  56     MP_CMD_GET_TIME_LENGTH,
  57     MP_CMD_GET_PERCENT_POS,
  58     MP_CMD_TV_SET_CHANNEL,
  59     MP_CMD_EDL_MARK,
  60     MP_CMD_SUB_ALIGNMENT,
  61     MP_CMD_TV_LAST_CHANNEL,
  62     MP_CMD_OSD_SHOW_TEXT,
  63     MP_CMD_TV_SET_FREQ,
  64     MP_CMD_TV_SET_NORM,
  65     MP_CMD_TV_SET_BRIGHTNESS,
  66     MP_CMD_TV_SET_CONTRAST,
  67     MP_CMD_TV_SET_HUE,
  68     MP_CMD_TV_SET_SATURATION,
  69     MP_CMD_GET_VO_FULLSCREEN,
  70     MP_CMD_GET_SUB_VISIBILITY,
  71     MP_CMD_SUB_FORCED_ONLY,
  72     MP_CMD_VO_ONTOP,
  73     MP_CMD_SUB_SELECT,
  74     MP_CMD_VO_ROOTWIN,
  75     MP_CMD_SWITCH_VSYNC,
  76     MP_CMD_SWITCH_RATIO,
  77     MP_CMD_FRAME_STEP,
  78     MP_CMD_SPEED_INCR,
  79     MP_CMD_SPEED_MULT,
  80     MP_CMD_SPEED_SET,
  81     MP_CMD_RUN,
  82     MP_CMD_SUB_LOG,
  83     MP_CMD_SWITCH_AUDIO,
  84     MP_CMD_GET_TIME_POS,
  85     MP_CMD_SUB_LOAD,
  86     MP_CMD_SUB_REMOVE,
  87     MP_CMD_KEYDOWN_EVENTS,
  88     MP_CMD_VO_BORDER,
  89     MP_CMD_SET_PROPERTY,
  90     MP_CMD_SET_PROPERTY_OSD,
  91     MP_CMD_GET_PROPERTY,
  92     MP_CMD_OSD_SHOW_PROPERTY_TEXT,
  93     MP_CMD_OSD_SHOW_PROGRESSION,
  94     MP_CMD_SEEK_CHAPTER,
  95     MP_CMD_GET_FILENAME,
  96     MP_CMD_GET_VIDEO_CODEC,
  97     MP_CMD_GET_VIDEO_BITRATE,
  98     MP_CMD_GET_VIDEO_RESOLUTION,
  99     MP_CMD_GET_AUDIO_CODEC,
 100     MP_CMD_GET_AUDIO_BITRATE,
 101     MP_CMD_GET_AUDIO_SAMPLES,
 102     MP_CMD_GET_META_TITLE,
 103     MP_CMD_GET_META_ARTIST,
 104     MP_CMD_GET_META_ALBUM,
 105     MP_CMD_GET_META_YEAR,
 106     MP_CMD_GET_META_COMMENT,
 107     MP_CMD_GET_META_TRACK,
 108     MP_CMD_GET_META_GENRE,
 109     MP_CMD_RADIO_STEP_CHANNEL,
 110     MP_CMD_RADIO_SET_CHANNEL,
 111     MP_CMD_RADIO_SET_FREQ,
 112     MP_CMD_SET_MOUSE_POS,
 113     MP_CMD_STEP_PROPERTY,
 114     MP_CMD_STEP_PROPERTY_OSD,
 115     MP_CMD_RADIO_STEP_FREQ,
 116     MP_CMD_TV_STEP_FREQ,
 117     MP_CMD_LOOP,
 118     MP_CMD_BALANCE,
 119     MP_CMD_SUB_SCALE,
 120     MP_CMD_TV_TELETEXT_ADD_DEC,
 121     MP_CMD_TV_TELETEXT_GO_LINK,
 122     MP_CMD_TV_START_SCAN,
 123     MP_CMD_SUB_SOURCE,
 124     MP_CMD_SUB_FILE,
 125     MP_CMD_SUB_VOB,
 126     MP_CMD_SUB_DEMUX,
 127     MP_CMD_SWITCH_ANGLE,
 128     MP_CMD_ASS_USE_MARGINS,
 129     MP_CMD_SWITCH_TITLE,
 130     MP_CMD_STOP,
 131
 132     /// DVDNAV commands
 133     MP_CMD_DVDNAV_UP = 1000,
 134     MP_CMD_DVDNAV_DOWN,
 135     MP_CMD_DVDNAV_LEFT,
 136     MP_CMD_DVDNAV_RIGHT,
 137     MP_CMD_DVDNAV_MENU,
 138     MP_CMD_DVDNAV_SELECT,
 139     MP_CMD_DVDNAV_PREVMENU,
 140     MP_CMD_DVDNAV_MOUSECLICK,
 141
 142     /// DVB commands
 143     MP_CMD_DVB_SET_CHANNEL = 5101,
 144
 145     /// Audio Filter commands
 146     MP_CMD_AF_SWITCH,
 147     MP_CMD_AF_ADD,
 148     MP_CMD_AF_DEL,
 149     MP_CMD_AF_CLR,
 150     MP_CMD_AF_CMDLINE,
 151 };
 152
 153 // The arg types
 154 #define MP_CMD_ARG_INT 1
 155 #define MP_CMD_ARG_FLOAT 2
 156 #define MP_CMD_ARG_STRING 3
 157
 158 #define MP_CMD_MAX_ARGS 10
 159
 160 // Error codes for the drivers
 161
 162 // An error occurred but we can continue
 163 #define MP_INPUT_ERROR -1
 164 // A fatal error occurred, this driver should be removed
 165 #define MP_INPUT_DEAD -2
 166 // No input was available
 167 #define MP_INPUT_NOTHING -3
 168 //! Input will be available if you try again
 169 #define MP_INPUT_RETRY -4
 170 // Key FIFO was full - release events may be lost, zero button-down status
 171 #define MP_INPUT_RELEASE_ALL -5
 172
 173
 174 struct input_ctx;
 175
 176 struct mp_cmd_arg {
 177     int type;
 178     bool optional;
 179     union {
 180         int i;
 181         float f;
 182         char *s;
 183     } v;
 184 };
 185
 186 typedef struct mp_cmd {
 187     int id;
 188     char *name;
 189     struct mp_cmd_arg args[MP_CMD_MAX_ARGS];
 190     int nargs;
 191     int pausing;
 192     struct mp_cmd *queue_prev;
 193     struct mp_cmd *queue_next;
 194 } mp_cmd_t;
 195
 196
 197 /* Add a new command input source.
 198  * "fd" is a file descriptor (use a negative value if you don't use any fd)
 199  * "select" tells whether to use select() on the fd to determine when to
 200  * try reading.
 201  * "read_func" is optional. If NULL a default function which reads data
 202  * directly from the fd will be used. It must return either text data
 203  * or one of the MP_INPUT error codes above.
 204  * "close_func" will be called when closing. Can be NULL. Its return value
 205  * is ignored (it's only there to allow using standard close() as the func).
 206  */
 207 int mp_input_add_cmd_fd(struct input_ctx *ictx, int fd, int select,
 208                         int read_func(int fd, char *dest, int size),
 209                         int close_func(int fd));
 210
 211 // This removes a cmd driver, you usually don't need to use it.
 212 void mp_input_rm_cmd_fd(struct input_ctx *ictx, int fd);
 213
 214 /* The args are similar to the cmd version above, except you must give
 215  * a read_func, and it should return key codes (ASCII plus keycodes.h).
 216  */
 217 int mp_input_add_key_fd(struct input_ctx *ictx, int fd, int select,
 218                         int read_func(void *ctx, int fd),
 219                         int close_func(int fd), void *ctx);
 220
 221 // Feed a keypress (alternative to being returned from read_func above)
 222 void mp_input_feed_key(struct input_ctx *ictx, int code);
 223
 224 // As for the cmd one you usually don't need this function.
 225 void mp_input_rm_key_fd(struct input_ctx *ictx, int fd);
 226
 227 // Get input key from its name.
 228 int mp_input_get_key_from_name(const char *name);
 229
 230 // Add a command to the command queue.
 231 int mp_input_queue_cmd(struct input_ctx *ictx, struct mp_cmd *cmd);
 232
 233 /* Return next available command, or sleep up to "time" ms if none is
 234  * available. If "peek_only" is true return a reference to the command
 235  * but leave it queued.
 236  */
 237 struct mp_cmd *mp_input_get_cmd(struct input_ctx *ictx, int time,
 238                                 int peek_only);
 239
 240 /* Parse text and return corresponding struct mp_cmd. */
 241 struct mp_cmd *mp_input_parse_cmd(char *str);
 242
 243 // After getting a command from mp_input_get_cmd you need to free it using this
 244 // function
 245 void mp_cmd_free(struct mp_cmd *cmd);
 246
 247 // This creates a copy of a command (used by the auto repeat stuff).
 248 struct mp_cmd *mp_cmd_clone(struct mp_cmd *cmd);
 249
 250 // Set current input section
 251 void mp_input_set_section(struct input_ctx *ictx, char *name);
 252
 253 // Initialize the input system
 254 struct MPOpts;
 255 struct input_ctx *mp_input_init(struct MPOpts *opts);
 256
 257 void mp_input_uninit(struct input_ctx *ictx);
 258
 259 struct m_config;
 260 void mp_input_register_options(struct m_config *cfg);
 261
 262 // Wake up sleeping input loop from another thread.
 263 void mp_input_wakeup(struct input_ctx *ictx);
 264
 265 // Interruptible usleep:  (used by libmpdemux)
 266 int mp_input_check_interrupt(struct input_ctx *ictx, int time);
 267
 268 extern int async_quit_request;
 269
 270 #endif /* MPLAYER_INPUT_H */