2012-01-14 10:02:30 -05:00
|
|
|
/*
|
|
|
|
* 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)
|
|
|
|
*
|
|
|
|
*/
|
2012-09-21 09:36:25 -04:00
|
|
|
#ifndef I3_COMMANDS_H
|
|
|
|
#define I3_COMMANDS_H
|
2012-01-14 10:02:30 -05:00
|
|
|
|
2012-02-07 17:38:21 -05:00
|
|
|
#include "commands_parser.h"
|
|
|
|
|
|
|
|
/** The beginning of the prototype for every cmd_ function. */
|
|
|
|
#define I3_CMD Match *current_match, struct CommandResult *cmd_output
|
|
|
|
|
2012-01-14 10:02:30 -05:00
|
|
|
/*
|
|
|
|
* 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.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
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.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
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.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_criteria_add(I3_CMD, char *ctype, char *cvalue);
|
2012-01-14 10:02:30 -05:00
|
|
|
|
2012-01-27 17:32:40 -05:00
|
|
|
/**
|
|
|
|
* Implementation of 'move [window|container] [to] workspace
|
|
|
|
* next|prev|next_on_output|prev_on_output'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_move_con_to_workspace(I3_CMD, char *which);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
2012-09-04 04:51:18 -04: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>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_move_con_to_workspace_name(I3_CMD, char *name);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
2012-04-08 14:33:46 -04: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]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
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'.
|
|
|
|
*
|
|
|
|
*/
|
2012-09-23 19:14:00 -04:00
|
|
|
void cmd_border(I3_CMD, char *border_style_str, char *border_width);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'nop <comment>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_nop(I3_CMD, char *comment);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'append_layout <path>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
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'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_workspace(I3_CMD, char *which);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
2012-04-08 13:17:46 -04: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'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_workspace_back_and_forth(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'workspace <name>'
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_workspace_name(I3_CMD, char *name);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'mark <mark>'
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_mark(I3_CMD, char *mark);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'mode <string>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_mode(I3_CMD, char *mode);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'move [window|container] [to] output <str>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_move_con_to_output(I3_CMD, char *name);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'floating enable|disable|toggle'
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_floating(I3_CMD, char *floating_mode);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'move workspace to [output] <str>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
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'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_split(I3_CMD, char *direction);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementaiton of 'kill [window|client]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_kill(I3_CMD, char *kill_mode_str);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'exec [--no-startup-id] <command>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_exec(I3_CMD, char *nosn, char *command);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus left|right|up|down'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_focus_direction(I3_CMD, char *direction);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus tiling|floating|mode_toggle'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_focus_window_mode(I3_CMD, char *window_mode);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus parent|child'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_focus_level(I3_CMD, char *level);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_focus(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'fullscreen [global]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_fullscreen(I3_CMD, char *fullscreen_mode);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'move <direction> [<pixels> [px]]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
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
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -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'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_exit(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementaiton of 'reload'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_reload(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementaiton of 'restart'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_restart(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementaiton of 'open'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_open(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus output <output>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_focus_output(I3_CMD, char *name);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
2012-03-23 08:39:17 -04: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'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_move_scratchpad(I3_CMD);
|
2012-01-27 17:32:40 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'scratchpad show'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 17:38:21 -05:00
|
|
|
void cmd_scratchpad_show(I3_CMD);
|
2012-01-14 10:02:30 -05:00
|
|
|
|
2012-04-08 14:34:31 -04:00
|
|
|
/**
|
|
|
|
* Implementation of 'rename workspace <name> to <name>'
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void cmd_rename_workspace(I3_CMD, char *old_name, char *new_name);
|
|
|
|
|
2012-01-14 10:02:30 -05:00
|
|
|
#endif
|