mirror of
https://github.com/mpv-player/mpv
synced 2024-10-30 04:46:41 +01:00
36099d27f8
This flag is used only by the command parser. Its value overlapped with some of the existing m_option flags, but only flags that did not matter for the command parser (i.e. the flag bits used had mostly private uses in each component). It's still a bit unclean and dangerous to use an essentially random value, so reuse M_OPT_OPTIONAL_PARAM for it. Since M_OPT_OPTIONAL_PARAM has a slightly longer name than MP_CMD_OPT_ARG, I'm going to keep the old name.
140 lines
4.4 KiB
C
140 lines
4.4 KiB
C
/*
|
|
* This file is part of mpv.
|
|
*
|
|
* mpv is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* mpv is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with mpv. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef MP_PARSE_COMMAND_H
|
|
#define MP_PARSE_COMMAND_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include "misc/bstr.h"
|
|
#include "options/m_option.h"
|
|
|
|
#define MP_CMD_DEF_MAX_ARGS 9
|
|
#define MP_CMD_OPT_ARG M_OPT_OPTIONAL_PARAM
|
|
|
|
struct mp_log;
|
|
struct mp_cmd;
|
|
struct mpv_node;
|
|
|
|
struct mp_cmd_def {
|
|
const char *name; // user-visible name (as used in input.conf)
|
|
void (*handler)(void *ctx);
|
|
const struct m_option args[MP_CMD_DEF_MAX_ARGS];
|
|
const void *priv; // for free use by handler()
|
|
bool allow_auto_repeat; // react to repeated key events
|
|
bool on_updown; // always emit it on both up and down key events
|
|
bool vararg; // last argument can be given 0 to multiple times
|
|
bool scalable;
|
|
bool is_abort;
|
|
bool is_soft_abort;
|
|
bool is_ignore;
|
|
};
|
|
|
|
enum mp_cmd_flags {
|
|
MP_ON_OSD_NO = 0, // prefer not using OSD
|
|
MP_ON_OSD_AUTO = 1, // use default behavior of the specific command
|
|
MP_ON_OSD_BAR = 2, // force a bar, if applicable
|
|
MP_ON_OSD_MSG = 4, // force a message, if applicable
|
|
MP_EXPAND_PROPERTIES = 8, // expand strings as properties
|
|
MP_ALLOW_REPEAT = 16, // if used as keybinding, allow key repeat
|
|
MP_ASYNC_CMD = 32,
|
|
|
|
MP_ON_OSD_FLAGS = MP_ON_OSD_NO | MP_ON_OSD_AUTO |
|
|
MP_ON_OSD_BAR | MP_ON_OSD_MSG,
|
|
};
|
|
|
|
// Arbitrary upper bound for sanity.
|
|
#define MP_CMD_MAX_ARGS 100
|
|
|
|
struct mp_cmd_arg {
|
|
const struct m_option *type;
|
|
union {
|
|
int i;
|
|
float f;
|
|
double d;
|
|
char *s;
|
|
char **str_list;
|
|
void *p;
|
|
} v;
|
|
};
|
|
|
|
typedef struct mp_cmd {
|
|
int id;
|
|
char *name;
|
|
struct mp_cmd_arg *args;
|
|
int nargs;
|
|
int flags; // mp_cmd_flags bitfield
|
|
bstr original;
|
|
char *input_section;
|
|
bool is_up_down : 1;
|
|
bool is_up : 1;
|
|
bool emit_on_up : 1;
|
|
bool is_mouse_button : 1;
|
|
bool repeated : 1;
|
|
bool mouse_move : 1;
|
|
int mouse_x, mouse_y;
|
|
struct mp_cmd *queue_next;
|
|
double scale; // for scaling numeric arguments
|
|
int scale_units;
|
|
const struct mp_cmd_def *def;
|
|
char *sender; // name of the client API user which sent this
|
|
char *key_name; // string representation of the key binding
|
|
} mp_cmd_t;
|
|
|
|
extern const struct mp_cmd_def mp_cmds[];
|
|
extern const struct mp_cmd_def mp_cmd_list;
|
|
|
|
// Executing this command will maybe abort playback (play something else, or quit).
|
|
bool mp_input_is_maybe_abort_cmd(struct mp_cmd *cmd);
|
|
// This command will definitely abort playback.
|
|
bool mp_input_is_abort_cmd(struct mp_cmd *cmd);
|
|
|
|
bool mp_input_is_repeatable_cmd(struct mp_cmd *cmd);
|
|
|
|
bool mp_input_is_scalable_cmd(struct mp_cmd *cmd);
|
|
|
|
void mp_print_cmd_list(struct mp_log *out);
|
|
|
|
// Parse text and return corresponding struct mp_cmd.
|
|
// The location parameter is for error messages.
|
|
struct mp_cmd *mp_input_parse_cmd_str(struct mp_log *log, bstr str,
|
|
const char *loc);
|
|
|
|
// Similar to mp_input_parse_cmd(), but takes a list of strings instead.
|
|
// Also, MP_ON_OSD_AUTO | MP_EXPAND_PROPERTIES are not set by default.
|
|
// Keep in mind that these functions (naturally) don't take multiple commands,
|
|
// i.e. a ";" argument does not start a new command.
|
|
struct mp_cmd *mp_input_parse_cmd_strv(struct mp_log *log, const char **argv);
|
|
|
|
struct mp_cmd *mp_input_parse_cmd_node(struct mp_log *log, struct mpv_node *node);
|
|
|
|
// After getting a command from mp_input_get_cmd you need to free it using this
|
|
// function
|
|
void mp_cmd_free(struct mp_cmd *cmd);
|
|
|
|
void mp_cmd_dump(struct mp_log *log, int msgl, char *header, struct mp_cmd *cmd);
|
|
|
|
// This creates a copy of a command (used by the auto repeat stuff).
|
|
struct mp_cmd *mp_cmd_clone(struct mp_cmd *cmd);
|
|
|
|
extern const struct m_option_type m_option_type_cycle_dir;
|
|
|
|
#define OPT_CYCLEDIR(...) \
|
|
OPT_GENERAL(double, __VA_ARGS__, .type = &m_option_type_cycle_dir)
|
|
|
|
#endif
|