2012-01-14 16:02:30 +01: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 15:36:25 +02:00
|
|
|
#ifndef I3_COMMANDS_H
|
|
|
|
#define I3_COMMANDS_H
|
2012-01-14 16:02:30 +01:00
|
|
|
|
2012-02-07 23:38:21 +01: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-27 23:32:40 +01:00
|
|
|
/**
|
|
|
|
* Initializes the specified 'Match' data structure and the initial state of
|
|
|
|
* commands.c for matching target windows of a command.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_criteria_init(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A match specification just finished (the closing square bracket was found),
|
|
|
|
* so we filter the list of owindows.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_criteria_match_windows(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Interprets a ctype=cvalue pair and adds it to the current match
|
|
|
|
* specification.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_criteria_add(I3_CMD, char *ctype, char *cvalue);
|
2012-01-14 16:02:30 +01:00
|
|
|
|
2012-01-27 23:32:40 +01:00
|
|
|
/**
|
|
|
|
* Implementation of 'move [window|container] [to] workspace
|
|
|
|
* next|prev|next_on_output|prev_on_output'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_move_con_to_workspace(I3_CMD, char *which);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
2012-09-04 10:51:18 +02: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 23:32:40 +01:00
|
|
|
/**
|
|
|
|
* Implementation of 'move [window|container] [to] workspace <name>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_move_con_to_workspace_name(I3_CMD, char *name);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
2012-04-08 20:33:46 +02:00
|
|
|
/**
|
|
|
|
* Implementation of 'move [window|container] [to] workspace number <number>'.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void cmd_move_con_to_workspace_number(I3_CMD, char *which);
|
|
|
|
|
2012-01-27 23:32:40 +01:00
|
|
|
/**
|
|
|
|
* Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_resize(I3_CMD, char *way, char *direction, char *resize_px, char *resize_ppt);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'border normal|none|1pixel|toggle'.
|
|
|
|
*
|
|
|
|
*/
|
2012-09-24 01:14:00 +02:00
|
|
|
void cmd_border(I3_CMD, char *border_style_str, char *border_width);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'nop <comment>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_nop(I3_CMD, char *comment);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'append_layout <path>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_append_layout(I3_CMD, char *path);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_workspace(I3_CMD, char *which);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
2012-04-08 19:17:46 +02:00
|
|
|
/**
|
|
|
|
* Implementation of 'workspace number <number>'
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void cmd_workspace_number(I3_CMD, char *which);
|
|
|
|
|
2012-01-27 23:32:40 +01:00
|
|
|
/**
|
|
|
|
* Implementation of 'workspace back_and_forth'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_workspace_back_and_forth(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'workspace <name>'
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_workspace_name(I3_CMD, char *name);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'mark <mark>'
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_mark(I3_CMD, char *mark);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'mode <string>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_mode(I3_CMD, char *mode);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'move [window|container] [to] output <str>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_move_con_to_output(I3_CMD, char *name);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'floating enable|disable|toggle'
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_floating(I3_CMD, char *floating_mode);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'move workspace to [output] <str>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_move_workspace_to_output(I3_CMD, char *name);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'split v|h|vertical|horizontal'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_split(I3_CMD, char *direction);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
2012-10-24 07:58:03 +02:00
|
|
|
* Implementation of 'kill [window|client]'.
|
2012-01-27 23:32:40 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_kill(I3_CMD, char *kill_mode_str);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'exec [--no-startup-id] <command>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_exec(I3_CMD, char *nosn, char *command);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus left|right|up|down'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_focus_direction(I3_CMD, char *direction);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus tiling|floating|mode_toggle'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_focus_window_mode(I3_CMD, char *window_mode);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus parent|child'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_focus_level(I3_CMD, char *level);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_focus(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'fullscreen [global]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_fullscreen(I3_CMD, char *fullscreen_mode);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'move <direction> [<pixels> [px]]'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_move_direction(I3_CMD, char *direction, char *move_px);
|
2012-01-27 23:32:40 +01: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-04 03:04:00 +02:00
|
|
|
* Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
|
2012-01-27 23:32:40 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_layout(I3_CMD, char *layout_str);
|
2012-01-27 23:32:40 +01: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-04 03:04:00 +02:00
|
|
|
/**
|
|
|
|
* Implementation of 'layout toggle [all|split]'.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void cmd_layout_toggle(I3_CMD, char *toggle_mode);
|
|
|
|
|
2012-01-27 23:32:40 +01:00
|
|
|
/**
|
2012-10-24 07:58:03 +02:00
|
|
|
* Implementation of 'exit'.
|
2012-01-27 23:32:40 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_exit(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
2012-10-24 07:58:03 +02:00
|
|
|
* Implementation of 'reload'.
|
2012-01-27 23:32:40 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_reload(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
2012-10-24 07:58:03 +02:00
|
|
|
* Implementation of 'restart'.
|
2012-01-27 23:32:40 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_restart(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
2012-10-24 07:58:03 +02:00
|
|
|
* Implementation of 'open'.
|
2012-01-27 23:32:40 +01:00
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_open(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'focus output <output>'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_focus_output(I3_CMD, char *name);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
2012-03-23 13:39:17 +01: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 23:32:40 +01:00
|
|
|
/**
|
|
|
|
* Implementation of 'move scratchpad'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_move_scratchpad(I3_CMD);
|
2012-01-27 23:32:40 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Implementation of 'scratchpad show'.
|
|
|
|
*
|
|
|
|
*/
|
2012-02-07 23:38:21 +01:00
|
|
|
void cmd_scratchpad_show(I3_CMD);
|
2012-01-14 16:02:30 +01:00
|
|
|
|
2012-04-08 20:34:31 +02:00
|
|
|
/**
|
|
|
|
* Implementation of 'rename workspace <name> to <name>'
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void cmd_rename_workspace(I3_CMD, char *old_name, char *new_name);
|
|
|
|
|
introduced i3 command for changing the hidden state and the mode of i3bar
The hidden_state and mode of each i3bar instance can now be controlled from within i3.
Therefore, two new i3 command were introduced:
_
bar hidden_state show|hide|toggle [<bar_id>]
show: always show the bar
hide: normal hide mode
toggle: toggle between show and hide (individually for each bar)
_
bar mode dock|hide|invisible|toggle [<bar_id>]
hide,dock: like before
invisible: always keep the bar hidden
toggle: toggle between dock and hide (individually for each bar)
This patch introduces a hidden_state ("hidden_state hide|show") in the
barconfig, which indicates the current hidden_state of each i3bar
instance. It only affects the bar when in hide mode. Additionally, a new
invisible mode was introduced. In order to change the hidden_state or
mode of the bar from i3, a barconfig-update event was introduced, for
which a bar can subscribe and the bar then gets notified about the
currently set hidden_state and mode in its barconfig.
For convenience, an id field ("id <bar_id>") was added to the barconfig, where one can
set the desired id for the corresponding bar. If the id is not specified, i3 will
deterministically choose an id; otherwise, with the previous random approach for finding
a new id, which is actually not shared with i3bar, as it would determine its id on
startup, the event-subscription would be destroyed on reload. Still, this issue remains
when manually changing the bar_id in the config and then reloading.
fixes #833, #651
2013-05-25 14:30:00 +02:00
|
|
|
/**
|
|
|
|
* Implementation of 'bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]'
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
void cmd_bar(I3_CMD, char *bar_type, char *bar_value, char *bar_id);
|
|
|
|
|
2012-01-14 16:02:30 +01:00
|
|
|
#endif
|