mirror of
https://github.com/mpv-player/mpv
synced 2025-01-02 04:42:10 +00:00
cosmetics: reformat input.h, fix comments
This commit is contained in:
parent
e62fcc3a0e
commit
db4dee4584
@ -158,7 +158,6 @@ typedef enum {
|
||||
MP_CMD_AF_DEL,
|
||||
MP_CMD_AF_CLR,
|
||||
MP_CMD_AF_CMDLINE,
|
||||
|
||||
} mp_command_type;
|
||||
|
||||
// The arg types
|
||||
@ -225,23 +224,25 @@ typedef void (*mp_close_func_t)(int fd);
|
||||
// Set this to grab all incoming key codes
|
||||
extern int (*mp_input_key_cb)(int code);
|
||||
// Should return 1 if the command was processed
|
||||
typedef int (*mp_input_cmd_filter)(mp_cmd_t *cmd, void *ctx);
|
||||
typedef int (*mp_input_cmd_filter)(struct mp_cmd *cmd, void *ctx);
|
||||
|
||||
// This function adds a new key driver.
|
||||
// The first arg is a file descriptor (use a negative value if you don't use any fd)
|
||||
// The second arg tells if we use select on the fd to know if something is available.
|
||||
// The third arg is optional. If null a default function wich reads an int from the
|
||||
// fd will be used.
|
||||
// The last arg can be NULL if nothing is needed to close the driver. The close
|
||||
// function can be used
|
||||
/* Add a new command input source.
|
||||
* "fd" is a file descriptor (use a negative value if you don't use any fd)
|
||||
* "select" tells whether to use select() on the fd to determine when to
|
||||
* try reading.
|
||||
* "read_func" is optional. If NULL a default function which reads data
|
||||
* directly from the fd will be used.
|
||||
* "close_func" will be called when closing. Can be NULL.
|
||||
*/
|
||||
int mp_input_add_cmd_fd(struct input_ctx *ictx, int fd, int select,
|
||||
mp_cmd_func_t read_func, mp_close_func_t close_func);
|
||||
|
||||
// This removes a cmd driver, you usually don't need to use it.
|
||||
void mp_input_rm_cmd_fd(struct input_ctx *ictx, int fd);
|
||||
|
||||
// The args are the same as for the key's drivers. If you don't use any valid fd you MUST
|
||||
// give a read_func.
|
||||
/* The args are similar to the cmd version above, except you must give
|
||||
* a read_func.
|
||||
*/
|
||||
int mp_input_add_key_fd(struct input_ctx *ictx, int fd, int select,
|
||||
mp_key_func_t read_func, mp_close_func_t close_func,
|
||||
void *ctx);
|
||||
@ -249,41 +250,38 @@ int mp_input_add_key_fd(struct input_ctx *ictx, int fd, int select,
|
||||
// As for the cmd one you usually don't need this function.
|
||||
void mp_input_rm_key_fd(struct input_ctx *ictx, int fd);
|
||||
|
||||
/// Get input key from its name.
|
||||
// Get input key from its name.
|
||||
int mp_input_get_key_from_name(const char *name);
|
||||
|
||||
// This function can be used to put a command in the system again. It's used by libmpdemux
|
||||
// when it performs a blocking operation to resend the command it received to the main
|
||||
// loop.
|
||||
int mp_input_queue_cmd(struct input_ctx *ictx, mp_cmd_t* cmd);
|
||||
// Add a command to the command queue.
|
||||
int mp_input_queue_cmd(struct input_ctx *ictx, struct mp_cmd *cmd);
|
||||
|
||||
// This function retrieves the next available command waiting no more than time msec.
|
||||
// If pause is true, the next input will always return a pause command.
|
||||
mp_cmd_t*
|
||||
mp_input_get_cmd(struct input_ctx *ictx, int time, int peek_only);
|
||||
/* Return next available command, or sleep up to "time" ms if none is
|
||||
* available. If "peek_only" is true return a reference to the command
|
||||
* but leave it queued.
|
||||
*/
|
||||
struct mp_cmd *mp_input_get_cmd(struct input_ctx *ictx, int time,
|
||||
int peek_only);
|
||||
|
||||
mp_cmd_t*
|
||||
mp_input_parse_cmd(char* str);
|
||||
/* Parse text and return corresponding struct mp_cmd. */
|
||||
struct mp_cmd *mp_input_parse_cmd(char *str);
|
||||
|
||||
/**
|
||||
* Parse and queue commands separated by '\n'.
|
||||
* @return count of commands new queued.
|
||||
* Return number of commands queued.
|
||||
*/
|
||||
int mp_input_parse_and_queue_cmds(struct input_ctx *ictx, const char *str);
|
||||
|
||||
/// These filters allow you to process the command before MPlayer.
|
||||
/// If a filter returns a true value mp_input_get_cmd will return NULL.
|
||||
void
|
||||
mp_input_add_cmd_filter(mp_input_cmd_filter, void* ctx);
|
||||
// These filters allow you to process the command before MPlayer.
|
||||
// If a filter returns a true value mp_input_get_cmd will return NULL.
|
||||
void mp_input_add_cmd_filter(mp_input_cmd_filter, void *ctx);
|
||||
|
||||
// After getting a command from mp_input_get_cmd you need to free it using this
|
||||
// function
|
||||
void
|
||||
mp_cmd_free(mp_cmd_t* cmd);
|
||||
void mp_cmd_free(struct mp_cmd *cmd);
|
||||
|
||||
// This creates a copy of a command (used by the auto repeat stuff).
|
||||
mp_cmd_t*
|
||||
mp_cmd_clone(mp_cmd_t* cmd);
|
||||
struct mp_cmd *mp_cmd_clone(struct mp_cmd *cmd);
|
||||
|
||||
// Set current input section
|
||||
void mp_input_set_section(struct input_ctx *ictx, char *name);
|
||||
@ -291,7 +289,7 @@ void mp_input_set_section(struct input_ctx *ictx, char *name);
|
||||
// Get current input section
|
||||
char *mp_input_get_section(struct input_ctx *ictx);
|
||||
|
||||
// When you create a new driver you should add it in these 2 functions.
|
||||
// Initialize the input system
|
||||
struct input_conf;
|
||||
struct input_ctx *mp_input_init(struct input_conf *input_conf);
|
||||
|
||||
@ -301,8 +299,7 @@ struct m_config;
|
||||
void mp_input_register_options(struct m_config *cfg);
|
||||
|
||||
// Interruptible usleep: (used by libmpdemux)
|
||||
int
|
||||
mp_input_check_interrupt(struct input_ctx *ictx, int time);
|
||||
int mp_input_check_interrupt(struct input_ctx *ictx, int time);
|
||||
|
||||
extern int async_quit_request;
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user