i3/include/commands.h

281 lines
5.4 KiB
C
Raw Normal View History

/*
* vim:ts=4:sw=4:expandtab
*
* i3 - an improved dynamic tiling window manager
* © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
*
* commands.c: all command functions (see commands_parser.c)
*
*/
#ifndef I3_COMMANDS_H
#define I3_COMMANDS_H
#include "commands_parser.h"
/** The beginning of the prototype for every cmd_ function. */
#define I3_CMD Match *current_match, struct CommandResult *cmd_output
/*
* Helper data structure for an operation window (window on which the operation
* will be performed). Used to build the TAILQ owindows.
*
*/
typedef struct owindow {
Con *con;
TAILQ_ENTRY(owindow) owindows;
} owindow;
typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
2012-01-27 17:32:40 -05:00
/**
* Initializes the specified 'Match' data structure and the initial state of
* commands.c for matching target windows of a command.
*
*/
void cmd_criteria_init(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* A match specification just finished (the closing square bracket was found),
* so we filter the list of owindows.
*
*/
void cmd_criteria_match_windows(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Interprets a ctype=cvalue pair and adds it to the current match
* specification.
*
*/
void cmd_criteria_add(I3_CMD, char *ctype, char *cvalue);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move [window|container] [to] workspace
* next|prev|next_on_output|prev_on_output'.
*
*/
void cmd_move_con_to_workspace(I3_CMD, char *which);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move [window|container] [to] workspace back_and_forth'.
*
*/
void cmd_move_con_to_workspace_back_and_forth(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move [window|container] [to] workspace <name>'.
*
*/
void cmd_move_con_to_workspace_name(I3_CMD, char *name);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move [window|container] [to] workspace number <number>'.
*
*/
void cmd_move_con_to_workspace_number(I3_CMD, char *which);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
*
*/
void cmd_resize(I3_CMD, char *way, char *direction, char *resize_px, char *resize_ppt);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'border normal|none|1pixel|toggle'.
*
*/
void cmd_border(I3_CMD, char *border_style_str);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'nop <comment>'.
*
*/
void cmd_nop(I3_CMD, char *comment);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'append_layout <path>'.
*
*/
void cmd_append_layout(I3_CMD, char *path);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
*
*/
void cmd_workspace(I3_CMD, char *which);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'workspace number <number>'
*
*/
void cmd_workspace_number(I3_CMD, char *which);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'workspace back_and_forth'.
*
*/
void cmd_workspace_back_and_forth(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'workspace <name>'
*
*/
void cmd_workspace_name(I3_CMD, char *name);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'mark <mark>'
*
*/
void cmd_mark(I3_CMD, char *mark);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'mode <string>'.
*
*/
void cmd_mode(I3_CMD, char *mode);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move [window|container] [to] output <str>'.
*
*/
void cmd_move_con_to_output(I3_CMD, char *name);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'floating enable|disable|toggle'
*
*/
void cmd_floating(I3_CMD, char *floating_mode);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move workspace to [output] <str>'.
*
*/
void cmd_move_workspace_to_output(I3_CMD, char *name);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'split v|h|vertical|horizontal'.
*
*/
void cmd_split(I3_CMD, char *direction);
2012-01-27 17:32:40 -05:00
/**
* Implementaiton of 'kill [window|client]'.
*
*/
void cmd_kill(I3_CMD, char *kill_mode_str);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'exec [--no-startup-id] <command>'.
*
*/
void cmd_exec(I3_CMD, char *nosn, char *command);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'focus left|right|up|down'.
*
*/
void cmd_focus_direction(I3_CMD, char *direction);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'focus tiling|floating|mode_toggle'.
*
*/
void cmd_focus_window_mode(I3_CMD, char *window_mode);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'focus parent|child'.
*
*/
void cmd_focus_level(I3_CMD, char *level);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'focus'.
*
*/
void cmd_focus(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'fullscreen [global]'.
*
*/
void cmd_fullscreen(I3_CMD, char *fullscreen_mode);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move <direction> [<pixels> [px]]'.
*
*/
void cmd_move_direction(I3_CMD, char *direction, char *move_px);
2012-01-27 17:32:40 -05:00
/**
Introduce splith/splitv layouts, remove orientation With this commit, the "default" layout is replaced by the splith and splitv layouts. splith is equivalent to default with orientation horizontal and splitv is equivalent to default with orientation vertical. The "split h" and "split v" commands continue to work as before, they split the current container and you will end up in a split container with layout splith (after "split h") or splitv (after "split v"). To change a splith container into a splitv container, use either "layout splitv" or "layout toggle split". The latter command is used in the default config as mod+l (previously "layout default"). In case you have "layout default" in your config file, it is recommended to just replace it by "layout toggle split", which will work as "layout default" did before when pressing it once, but toggle between horizontal/vertical when pressing it repeatedly. The rationale behind this commit is that it’s cleaner to have all parameters that influence how windows are rendered in the layout itself rather than having a special parameter in combination with only one layout. This enables us to change existing split containers in all cases without breaking existing features (see ticket #464). Also, users should feel more confident about whether they are actually splitting or just changing an existing split container now. As a nice side-effect, this commit brings back the "layout toggle" feature we once had in i3 version 3 (see the userguide). AFAIK, it is safe to use in-place restart to upgrade into versions after this commit (switching to an older version will break your layout, though). Fixes #464
2012-08-03 21:04:00 -04:00
* Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
2012-01-27 17:32:40 -05:00
*
*/
void cmd_layout(I3_CMD, char *layout_str);
2012-01-27 17:32:40 -05:00
Introduce splith/splitv layouts, remove orientation With this commit, the "default" layout is replaced by the splith and splitv layouts. splith is equivalent to default with orientation horizontal and splitv is equivalent to default with orientation vertical. The "split h" and "split v" commands continue to work as before, they split the current container and you will end up in a split container with layout splith (after "split h") or splitv (after "split v"). To change a splith container into a splitv container, use either "layout splitv" or "layout toggle split". The latter command is used in the default config as mod+l (previously "layout default"). In case you have "layout default" in your config file, it is recommended to just replace it by "layout toggle split", which will work as "layout default" did before when pressing it once, but toggle between horizontal/vertical when pressing it repeatedly. The rationale behind this commit is that it’s cleaner to have all parameters that influence how windows are rendered in the layout itself rather than having a special parameter in combination with only one layout. This enables us to change existing split containers in all cases without breaking existing features (see ticket #464). Also, users should feel more confident about whether they are actually splitting or just changing an existing split container now. As a nice side-effect, this commit brings back the "layout toggle" feature we once had in i3 version 3 (see the userguide). AFAIK, it is safe to use in-place restart to upgrade into versions after this commit (switching to an older version will break your layout, though). Fixes #464
2012-08-03 21:04:00 -04:00
/**
* Implementation of 'layout toggle [all|split]'.
*
*/
void cmd_layout_toggle(I3_CMD, char *toggle_mode);
2012-01-27 17:32:40 -05:00
/**
* Implementaiton of 'exit'.
*
*/
void cmd_exit(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementaiton of 'reload'.
*
*/
void cmd_reload(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementaiton of 'restart'.
*
*/
void cmd_restart(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementaiton of 'open'.
*
*/
void cmd_open(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'focus output <output>'.
*
*/
void cmd_focus_output(I3_CMD, char *name);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move [window|container] [to] [absolute] position <px> [px] <px> [px]
*
*/
void cmd_move_window_to_position(I3_CMD, char *method, char *x, char *y);
/**
* Implementation of 'move [window|container] [to] [absolute] position center
*
*/
void cmd_move_window_to_center(I3_CMD, char *method);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'move scratchpad'.
*
*/
void cmd_move_scratchpad(I3_CMD);
2012-01-27 17:32:40 -05:00
/**
* Implementation of 'scratchpad show'.
*
*/
void cmd_scratchpad_show(I3_CMD);
/**
* Implementation of 'rename workspace <name> to <name>'
*
*/
void cmd_rename_workspace(I3_CMD, char *old_name, char *new_name);
#endif