2 * This file is part of MPlayer.
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.
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.
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.
19 #ifndef MPLAYER_INPUT_H
20 #define MPLAYER_INPUT_H
25 enum mp_command_type
{
30 MP_CMD_GRAB_FRAMES
, // deprecated: was a no-op command for years
31 MP_CMD_PLAY_TREE_STEP
,
32 MP_CMD_PLAY_TREE_UP_STEP
,
33 MP_CMD_PLAY_ALT_SRC_STEP
,
37 MP_CMD_MIXER_USEMASTER
,
43 MP_CMD_TV_STEP_CHANNEL
,
45 MP_CMD_TV_STEP_CHANNEL_LIST
,
55 MP_CMD_VF_CHANGE_RECTANGLE
,
57 MP_CMD_SUB_VISIBILITY
,
58 MP_CMD_VOBSUB_LANG
, // deprecated: combined with SUB_SELECT
59 MP_CMD_GET_TIME_LENGTH
,
60 MP_CMD_GET_PERCENT_POS
,
62 MP_CMD_TV_SET_CHANNEL
,
65 MP_CMD_TV_LAST_CHANNEL
,
69 MP_CMD_TV_SET_BRIGHTNESS
,
70 MP_CMD_TV_SET_CONTRAST
,
72 MP_CMD_TV_SET_SATURATION
,
73 MP_CMD_GET_VO_FULLSCREEN
,
74 MP_CMD_GET_SUB_VISIBILITY
,
75 MP_CMD_SUB_FORCED_ONLY
,
91 MP_CMD_KEYDOWN_EVENTS
,
94 MP_CMD_SET_PROPERTY_OSD
,
96 MP_CMD_OSD_SHOW_PROPERTY_TEXT
,
97 MP_CMD_OSD_SHOW_PROGRESSION
,
100 MP_CMD_GET_VIDEO_CODEC
,
101 MP_CMD_GET_VIDEO_BITRATE
,
102 MP_CMD_GET_VIDEO_RESOLUTION
,
103 MP_CMD_GET_AUDIO_CODEC
,
104 MP_CMD_GET_AUDIO_BITRATE
,
105 MP_CMD_GET_AUDIO_SAMPLES
,
106 MP_CMD_GET_META_TITLE
,
107 MP_CMD_GET_META_ARTIST
,
108 MP_CMD_GET_META_ALBUM
,
109 MP_CMD_GET_META_YEAR
,
110 MP_CMD_GET_META_COMMENT
,
111 MP_CMD_GET_META_TRACK
,
112 MP_CMD_GET_META_GENRE
,
113 MP_CMD_RADIO_STEP_CHANNEL
,
114 MP_CMD_RADIO_SET_CHANNEL
,
115 MP_CMD_RADIO_SET_FREQ
,
116 MP_CMD_SET_MOUSE_POS
,
117 MP_CMD_STEP_PROPERTY
,
118 MP_CMD_STEP_PROPERTY_OSD
,
119 MP_CMD_RADIO_STEP_FREQ
,
124 MP_CMD_TV_TELETEXT_ADD_DEC
,
125 MP_CMD_TV_TELETEXT_GO_LINK
,
126 MP_CMD_TV_START_SCAN
,
132 MP_CMD_ASS_USE_MARGINS
,
137 MP_CMD_DVDNAV_UP
= 1000,
142 MP_CMD_DVDNAV_SELECT
,
143 MP_CMD_DVDNAV_PREVMENU
,
144 MP_CMD_DVDNAV_MOUSECLICK
,
147 MP_CMD_DVB_SET_CHANNEL
= 5101,
149 /// Audio Filter commands
158 #define MP_CMD_ARG_INT 1
159 #define MP_CMD_ARG_FLOAT 2
160 #define MP_CMD_ARG_STRING 3
162 #define MP_CMD_MAX_ARGS 10
164 // Error codes for the drivers
166 // An error occurred but we can continue
167 #define MP_INPUT_ERROR -1
168 // A fatal error occurred, this driver should be removed
169 #define MP_INPUT_DEAD -2
170 // No input was available
171 #define MP_INPUT_NOTHING -3
172 //! Input will be available if you try again
173 #define MP_INPUT_RETRY -4
174 // Key FIFO was full - release events may be lost, zero button-down status
175 #define MP_INPUT_RELEASE_ALL -5
190 typedef struct mp_cmd
{
193 struct mp_cmd_arg args
[MP_CMD_MAX_ARGS
];
196 struct mp_cmd
*queue_prev
;
197 struct mp_cmd
*queue_next
;
201 /* Add a new command input source.
202 * "fd" is a file descriptor (use a negative value if you don't use any fd)
203 * "select" tells whether to use select() on the fd to determine when to
205 * "read_func" is optional. If NULL a default function which reads data
206 * directly from the fd will be used. It must return either text data
207 * or one of the MP_INPUT error codes above.
208 * "close_func" will be called when closing. Can be NULL. Its return value
209 * is ignored (it's only there to allow using standard close() as the func).
211 int mp_input_add_cmd_fd(struct input_ctx
*ictx
, int fd
, int select
,
212 int read_func(int fd
, char *dest
, int size
),
213 int close_func(int fd
));
215 // This removes a cmd driver, you usually don't need to use it.
216 void mp_input_rm_cmd_fd(struct input_ctx
*ictx
, int fd
);
218 /* The args are similar to the cmd version above, except you must give
219 * a read_func, and it should return key codes (ASCII plus keycodes.h).
221 int mp_input_add_key_fd(struct input_ctx
*ictx
, int fd
, int select
,
222 int read_func(void *ctx
, int fd
),
223 int close_func(int fd
), void *ctx
);
225 // Feed a keypress (alternative to being returned from read_func above)
226 void mp_input_feed_key(struct input_ctx
*ictx
, int code
);
228 // As for the cmd one you usually don't need this function.
229 void mp_input_rm_key_fd(struct input_ctx
*ictx
, int fd
);
231 // Get input key from its name.
232 int mp_input_get_key_from_name(const char *name
);
234 // Add a command to the command queue.
235 int mp_input_queue_cmd(struct input_ctx
*ictx
, struct mp_cmd
*cmd
);
237 /* Return next available command, or sleep up to "time" ms if none is
238 * available. If "peek_only" is true return a reference to the command
239 * but leave it queued.
241 struct mp_cmd
*mp_input_get_cmd(struct input_ctx
*ictx
, int time
,
244 /* Parse text and return corresponding struct mp_cmd. */
245 struct mp_cmd
*mp_input_parse_cmd(char *str
);
248 * Parse and queue commands separated by '\n'.
249 * Return number of commands queued.
251 int mp_input_parse_and_queue_cmds(struct input_ctx
*ictx
, const char *str
);
253 // After getting a command from mp_input_get_cmd you need to free it using this
255 void mp_cmd_free(struct mp_cmd
*cmd
);
257 // This creates a copy of a command (used by the auto repeat stuff).
258 struct mp_cmd
*mp_cmd_clone(struct mp_cmd
*cmd
);
260 // Set current input section
261 void mp_input_set_section(struct input_ctx
*ictx
, char *name
);
263 // Get current input section
264 char *mp_input_get_section(struct input_ctx
*ictx
);
266 // Initialize the input system
268 struct input_ctx
*mp_input_init(struct input_conf
*input_conf
);
270 void mp_input_uninit(struct input_ctx
*ictx
);
273 void mp_input_register_options(struct m_config
*cfg
);
275 // Wake up sleeping input loop from another thread.
276 void mp_input_wakeup(struct input_ctx
*ictx
);
278 // Interruptible usleep: (used by libmpdemux)
279 int mp_input_check_interrupt(struct input_ctx
*ictx
, int time
);
281 extern int async_quit_request
;
283 #endif /* MPLAYER_INPUT_H */