i3
|
#include "all.h"
Go to the source code of this file.
Data Structures | |
struct | bfs_entry |
Functions | |
static void | con_on_remove_child (Con *con) |
Con * | con_new (Con *parent, i3Window *window) |
Create a new container (and attach it to the given parent, if not NULL). | |
void | con_attach (Con *con, Con *parent, bool ignore_focus) |
Attaches the given container to the given parent. | |
void | con_detach (Con *con) |
Detaches the given container from its current parent. | |
void | con_focus (Con *con) |
Sets input focus to the given container. | |
bool | con_is_leaf (Con *con) |
Returns true when this node is a leaf node (has no children) | |
bool | con_accepts_window (Con *con) |
Returns true if this node accepts a window (if the node swallows windows, it might already have swallowed enough and cannot hold any more). | |
Con * | con_get_output (Con *con) |
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on. | |
Con * | con_get_workspace (Con *con) |
Gets the workspace container this node is on. | |
Con * | con_parent_with_orientation (Con *con, orientation_t orientation) |
Searches parenst of the given 'con' until it reaches one with the specified 'orientation'. | |
Con * | con_get_fullscreen_con (Con *con, int fullscreen_mode) |
Returns the first fullscreen node below this node. | |
bool | con_is_floating (Con *con) |
Returns true if the node is floating. | |
Con * | con_inside_floating (Con *con) |
Checks if the given container is either floating or inside some floating container. | |
bool | con_inside_focused (Con *con) |
Checks if the given container is inside a focused container. | |
Con * | con_by_window_id (xcb_window_t window) |
Returns the container with the given client window ID or NULL if no such container exists. | |
Con * | con_by_frame_id (xcb_window_t frame) |
Returns the container with the given frame ID or NULL if no such container exists. | |
Con * | con_for_window (Con *con, i3Window *window, Match **store_match) |
Returns the first container below 'con' which wants to swallow this window TODO: priority. | |
int | con_num_children (Con *con) |
Returns the number of children of this container. | |
void | con_fix_percent (Con *con) |
Updates the percent attribute of the children of the given container. | |
void | con_toggle_fullscreen (Con *con, int fullscreen_mode) |
Toggles fullscreen mode for the given container. | |
void | con_move_to_workspace (Con *con, Con *workspace, bool fix_coordinates, bool dont_warp) |
Moves the given container to the currently focused container on the given workspace. | |
int | con_orientation (Con *con) |
Returns the orientation of the given container (for stacked containers, vertical orientation is used regardless of the actual orientation of the container). | |
Con * | con_next_focused (Con *con) |
Returns the container which will be focused next when the given container is not available anymore. | |
Con * | con_get_next (Con *con, char way, orientation_t orientation) |
Get the next/previous container in the specified orientation. | |
Con * | con_descend_focused (Con *con) |
Returns the focused con inside this client, descending the tree as far as possible. | |
Con * | con_descend_tiling_focused (Con *con) |
Returns the focused con inside this client, descending the tree as far as possible. | |
Con * | con_descend_direction (Con *con, direction_t direction) |
Rect | con_border_style_rect (Con *con) |
Returns a "relative" Rect which contains the amount of pixels that need to be added to the original Rect to get the final position (obviously the amount of pixels for normal, 1pixel and borderless are different). | |
int | con_border_style (Con *con) |
Use this function to get a container’s border style. | |
void | con_set_border_style (Con *con, int border_style) |
Sets the given border style on con, correctly keeping the position/size of a floating window. | |
void | con_set_layout (Con *con, int layout) |
This function changes the layout of a given container. | |
Rect | con_minimum_size (Con *con) |
Determines the minimum size of the given con by looking at its children (for split/stacked/tabbed cons). |
Variables | |
char * | colors [] |
bool con_accepts_window | ( | Con * | con | ) |
Returns true if this node accepts a window (if the node swallows windows, it might already have swallowed enough and cannot hold any more).
Definition at line 215 of file con.c.
References DLOG, NO_ORIENTATION, Con::orientation, Con::type, and Con::window.
Referenced by manage_window().
Attaches the given container to the given parent.
This happens when moving a container or when inserting a new container at a specific place in the tree.
ignore_focus is to just insert the Con at the end (useful when creating a new split container around some containers, that is, detaching and attaching them in order without wanting to mess with the focus in between).
Definition at line 78 of file con.c.
References config, Config::default_layout, DLOG, focused, Con::num, Con::parent, TAILQ_EMPTY, TAILQ_END, TAILQ_FIRST, TAILQ_FOREACH, TAILQ_INSERT_AFTER, TAILQ_INSERT_BEFORE, TAILQ_INSERT_HEAD, TAILQ_INSERT_TAIL, TAILQ_NEXT, Con::type, Con::window, and workspace_attach_to().
Referenced by _create___i3(), cmd_move_workspace_to_output(), cmd_rename_workspace(), con_move_to_workspace(), con_new(), con_set_layout(), create_workspace_on_output(), floating_disable(), floating_enable(), init_ws_for_output(), insert_con_into(), json_end_map(), output_init_con(), randr_query_outputs(), tree_split(), workspace_attach_to(), workspace_get(), and ws_force_orientation().
int con_border_style | ( | Con * | con | ) |
Use this function to get a container’s border style.
This is important because when inside a stack, the border style is always BS_NORMAL. For tabbed mode, the same applies, with one exception: when the container is borderless and the only element in the tabbed container, the border is not rendered.
For children of a CT_DOCKAREA, the border style is always none.
Definition at line 921 of file con.c.
References Con::border_style, BS_NONE, BS_NORMAL, con_get_fullscreen_con(), con_num_children(), DLOG, Con::layout, Con::parent, and Con::type.
Referenced by con_border_style_rect(), and x_draw_decoration().
Returns a "relative" Rect which contains the amount of pixels that need to be added to the original Rect to get the final position (obviously the amount of pixels for normal, 1pixel and borderless are different).
Definition at line 895 of file con.c.
References BS_1PIXEL, BS_NONE, BS_NORMAL, and con_border_style().
Referenced by con_set_border_style(), handle_configure_request(), render_con(), and tiling_resize().
Con* con_by_frame_id | ( | xcb_window_t | frame | ) |
Returns the container with the given frame ID or NULL if no such container exists.
Definition at line 394 of file con.c.
References all_cons, bfs_entry::con, Con::frame, and TAILQ_FOREACH.
Referenced by handle_button_press(), handle_enter_notify(), handle_expose_event(), handle_motion_notify(), and handle_unmap_notify_event().
Con* con_by_window_id | ( | xcb_window_t | window | ) |
Returns the container with the given client window ID or NULL if no such container exists.
Definition at line 381 of file con.c.
References all_cons, bfs_entry::con, Window::id, TAILQ_FOREACH, and Con::window.
Referenced by floating_enable(), handle_button_press(), handle_client_message(), handle_clientleader_change(), handle_configure_request(), handle_enter_notify(), handle_focus_in(), handle_hints(), handle_normal_hints(), handle_transient_for(), handle_unmap_notify_event(), handle_windowname_change(), handle_windowname_change_legacy(), handle_windowrole_change(), and manage_window().
Con* con_descend_direction | ( | Con * | con, |
direction_t | direction | ||
) |
Definition at line 842 of file con.c.
References bfs_entry::con, con_descend_direction(), con_orientation(), D_DOWN, D_LEFT, D_RIGHT, D_UP, DLOG, HORIZ, TAILQ_FIRST, TAILQ_LAST, and VERT.
Referenced by _tree_next(), and con_descend_direction().
Returns the focused con inside this client, descending the tree as far as possible.
This comes in handy when attaching a con to a workspace at the currently focused position, for example.
Definition at line 801 of file con.c.
References bfs_entry::con, focused, TAILQ_EMPTY, and TAILQ_FIRST.
Referenced by _tree_next(), _workspace_show(), check_crossing_screen_boundary(), cmd_focus_window_mode(), con_move_to_workspace(), con_next_focused(), floating_maybe_reassign_ws(), handle_enter_notify(), main(), randr_query_outputs(), route_click(), scratchpad_show(), tree_close(), and tree_move().
Returns the focused con inside this client, descending the tree as far as possible.
This comes in handy when attaching a con to a workspace at the currently focused position, for example.
Works like con_descend_focused but considers only tiling cons.
Definition at line 816 of file con.c.
References bfs_entry::con, focused, TAILQ_FOREACH, and Con::type.
Referenced by floating_disable(), manage_window(), and tree_open_con().
void con_detach | ( | Con * | con | ) |
Detaches the given container from its current parent.
Definition at line 169 of file con.c.
References focused, Con::parent, TAILQ_REMOVE, and Con::type.
Referenced by attach_to_workspace(), cmd_move_workspace_to_output(), cmd_rename_workspace(), con_move_to_workspace(), con_set_layout(), floating_enable(), init_ws_for_output(), insert_con_into(), randr_query_outputs(), tree_close(), tree_flatten(), and ws_force_orientation().
void con_fix_percent | ( | Con * | con | ) |
Updates the percent attribute of the children of the given container.
This function needs to be called when a window is added or removed from a container.
Definition at line 462 of file con.c.
References con_num_children(), Con::percent, and TAILQ_FOREACH.
Referenced by _create___i3(), attach_to_workspace(), con_move_to_workspace(), floating_disable(), floating_enable(), insert_con_into(), output_init_con(), resize_graphical_handler(), tree_close(), tree_open_con(), and ws_force_orientation().
void con_focus | ( | Con * | con | ) |
Sets input focus to the given container.
Will be updated in X11 in the next run of x_push_changes().
Definition at line 184 of file con.c.
References con_focus(), con_get_workspace(), DLOG, focused, Con::parent, TAILQ_INSERT_HEAD, TAILQ_REMOVE, Con::urgent, and workspace_update_urgent_flag().
Referenced by _tree_next(), _workspace_show(), check_crossing_screen_boundary(), cmd_focus(), cmd_focus_window_mode(), cmd_open(), cmd_rename_workspace(), con_focus(), con_move_to_workspace(), con_set_layout(), floating_disable(), floating_enable(), floating_maybe_reassign_ws(), handle_enter_notify(), handle_focus_in(), handle_motion_notify(), init_ws_for_output(), level_down(), level_up(), main(), manage_window(), randr_query_outputs(), route_click(), scratchpad_move(), scratchpad_show(), tree_append_json(), tree_close(), tree_move(), and ws_force_orientation().
Returns the first container below 'con' which wants to swallow this window TODO: priority.
Definition at line 407 of file con.c.
References con_for_window(), match_matches_window(), and TAILQ_FOREACH.
Referenced by con_for_window(), manage_window(), and randr_query_outputs().
Returns the first fullscreen node below this node.
Definition at line 293 of file con.c.
References bfs_entry::con, Con::fullscreen_mode, smalloc(), TAILQ_EMPTY, TAILQ_FIRST, TAILQ_FOREACH, TAILQ_HEAD, TAILQ_HEAD_INITIALIZER, TAILQ_INSERT_TAIL, and TAILQ_REMOVE.
Referenced by con_border_style(), con_move_to_workspace(), con_toggle_fullscreen(), IPC_HANDLER(), manage_window(), render_con(), render_l_output(), route_click(), and workspace_is_visible().
Con* con_get_next | ( | Con * | con, |
char | way, | ||
orientation_t | orientation | ||
) |
Get the next/previous container in the specified orientation.
This may travel up until it finds a container with suitable orientation.
Definition at line 764 of file con.c.
References bfs_entry::con, con_orientation(), DLOG, LOG, Con::parent, TAILQ_END, TAILQ_NEXT, TAILQ_PREV, and Con::type.
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on.
Definition at line 234 of file con.c.
References Con::parent, and Con::type.
Referenced by _workspace_show(), con_move_to_workspace(), floating_enable(), floating_maybe_reassign_ws(), init_ws_for_output(), manage_window(), resize_graphical_handler(), scratchpad_show(), workspace_get(), workspace_is_visible(), workspace_next_on_output(), workspace_prev_on_output(), and workspace_reassign_sticky().
Gets the workspace container this node is on.
Definition at line 248 of file con.c.
References Con::parent, and Con::type.
Referenced by _workspace_show(), check_crossing_screen_boundary(), cmd_focus(), cmd_focus_window_mode(), cmd_move_window_to_center(), cmd_move_workspace_to_output(), cmd_workspace_name(), con_focus(), con_move_to_workspace(), con_next_focused(), con_toggle_fullscreen(), ewmh_update_current_desktop(), floating_disable(), floating_enable(), handle_enter_notify(), handle_focus_in(), handle_hints(), IPC_HANDLER(), manage_window(), randr_query_outputs(), route_click(), scratchpad_move(), scratchpad_show(), start_application(), TAILQ_HEAD(), tree_close(), tree_move(), workspace_next(), workspace_next_on_output(), workspace_prev(), and workspace_prev_on_output().
Checks if the given container is either floating or inside some floating container.
It returns the FLOATING_CON container.
Definition at line 350 of file con.c.
References bfs_entry::con, con_inside_floating(), Con::floating, Con::parent, and Con::type.
Referenced by cmd_resize(), con_inside_floating(), con_move_to_workspace(), render_con(), route_click(), scratchpad_show(), and tree_move().
bool con_inside_focused | ( | Con * | con | ) |
Checks if the given container is inside a focused container.
Definition at line 368 of file con.c.
References con_inside_focused(), focused, and Con::parent.
Referenced by con_inside_focused(), and x_draw_decoration().
bool con_is_floating | ( | Con * | con | ) |
Returns true if the node is floating.
Definition at line 339 of file con.c.
References DLOG, and Con::floating.
Referenced by cmd_move_direction(), cmd_move_window_to_center(), cmd_move_window_to_position(), con_move_to_workspace(), con_set_border_style(), floating_disable(), floating_enable(), handle_configure_request(), toggle_floating_mode(), tree_close(), and tree_move().
bool con_is_leaf | ( | Con * | con | ) |
Returns true when this node is a leaf node (has no children)
Definition at line 206 of file con.c.
References TAILQ_EMPTY.
Referenced by con_minimum_size(), handle_configure_request(), render_con(), tiling_resize(), tree_move(), and x_draw_decoration().
Determines the minimum size of the given con by looking at its children (for split/stacked/tabbed cons).
Will be called when resizing floating cons
Definition at line 1083 of file con.c.
References con_is_leaf(), con_minimum_size(), Con::deco_rect, DLOG, ELOG, Rect::height, height, HORIZ, Con::layout, max(), min(), Con::orientation, TAILQ_FIRST, TAILQ_FOREACH, Con::type, VERT, Rect::width, and width.
Referenced by con_minimum_size(), and DRAGGING_CB().
Moves the given container to the currently focused container on the given workspace.
The fix_coordinates flag will translate the current coordinates (offset from the monitor position basically) to appropriate coordinates on the destination workspace. Not enabling this behaviour comes in handy when this function gets called by floating_maybe_reassign_ws, which will only "move" a floating window when it already changed its coordinates to a different output.
The dont_warp flag disables pointer warping and will be set when this function is called while dragging a floating window.
TODO: is there a better place for this function?
Definition at line 573 of file con.c.
References CALL, con_attach(), con_descend_focused(), con_detach(), con_fix_percent(), con_focus(), con_get_fullscreen_con(), con_get_output(), con_get_workspace(), con_inside_floating(), con_is_floating(), con_next_focused(), DLOG, floating_fix_coordinates(), Con::name, Con::parent, Con::percent, Con::rect, Con::type, workspace_is_visible(), workspace_show(), and x_set_warp_to().
Referenced by cmd_move_con_to_output(), cmd_move_con_to_workspace(), cmd_move_con_to_workspace_name(), cmd_move_con_to_workspace_number(), floating_maybe_reassign_ws(), scratchpad_move(), and scratchpad_show().
Create a new container (and attach it to the given parent, if not NULL).
This function initializes the data structures and creates the appropriate X11 IDs using x_con_init().
Definition at line 35 of file con.c.
References all_cons, colors, con_attach(), con_on_remove_child(), config, Config::default_border, Window::depth, DLOG, scalloc(), TAILQ_INIT, TAILQ_INSERT_TAIL, and x_con_init().
Referenced by _create___i3(), con_set_layout(), create_workspace_on_output(), floating_enable(), output_init_con(), TAILQ_HEAD(), tree_init(), tree_open_con(), tree_restore(), tree_split(), workspace_attach_to(), workspace_get(), and ws_force_orientation().
Returns the container which will be focused next when the given container is not available anymore.
Called in tree_close and con_move_to_workspace to properly restore focus.
Definition at line 696 of file con.c.
References con_descend_focused(), con_get_workspace(), DLOG, focused, output_get_content(), Con::parent, TAILQ_EMPTY, TAILQ_END, TAILQ_FIRST, TAILQ_NEXT, TAILQ_PREV, and Con::type.
Referenced by con_move_to_workspace(), scratchpad_move(), and tree_close().
int con_num_children | ( | Con * | con | ) |
Returns the number of children of this container.
Definition at line 446 of file con.c.
References TAILQ_FOREACH.
Referenced by _tree_next(), cmd_move_workspace_to_output(), cmd_resize_tiling_direction(), cmd_resize_tiling_width_height(), con_border_style(), con_fix_percent(), con_on_remove_child(), floating_enable(), output_change_mode(), render_con(), tiling_resize(), tree_move(), and tree_split().
|
static |
Definition at line 1046 of file con.c.
References con_num_children(), DLOG, DONT_KILL_WINDOW, ipc_send_event(), LOG, Con::name, TAILQ_EMPTY, tree_close(), Con::type, and workspace_is_visible().
Referenced by con_new().
int con_orientation | ( | Con * | con | ) |
Returns the orientation of the given container (for stacked containers, vertical orientation is used regardless of the actual orientation of the container).
Definition at line 679 of file con.c.
References HORIZ, Con::layout, Con::orientation, and VERT.
Referenced by _tree_next(), con_descend_direction(), con_get_next(), and con_parent_with_orientation().
Con* con_parent_with_orientation | ( | Con * | con, |
orientation_t | orientation | ||
) |
Searches parenst of the given 'con' until it reaches one with the specified 'orientation'.
Aborts when it comes across a floating_con.
Definition at line 260 of file con.c.
References con_orientation(), DLOG, Con::parent, and Con::type.
Referenced by tree_move().
void con_set_border_style | ( | Con * | con, |
int | border_style | ||
) |
Sets the given border style on con, correctly keeping the position/size of a floating window.
Definition at line 945 of file con.c.
References Con::border_style, BS_NORMAL, con_border_style_rect(), con_is_floating(), config, DLOG, Config::font, Font::height, Rect::height, Con::parent, Con::rect, Rect::width, Rect::x, and Rect::y.
Referenced by cmd_border().
void con_set_layout | ( | Con * | con, |
int | layout | ||
) |
This function changes the layout of a given container.
Use it to handle special cases like changing a whole workspace to stacked/tabbed (creates a new split container before).
Definition at line 989 of file con.c.
References bfs_entry::con, con_attach(), con_detach(), con_focus(), con_new(), config, croot, Config::default_orientation, DLOG, Rect::height, HORIZ, Con::layout, NO_ORIENTATION, Con::orientation, Con::rect, TAILQ_EMPTY, TAILQ_END, TAILQ_FIRST, tree_flatten(), Con::type, VERT, and Rect::width.
Referenced by cmd_layout().
void con_toggle_fullscreen | ( | Con * | con, |
int | fullscreen_mode | ||
) |
Toggles fullscreen mode for the given container.
Fullscreen mode will not be entered when there already is a fullscreen container on this workspace.
Definition at line 505 of file con.c.
References con_get_fullscreen_con(), con_get_workspace(), conn, croot, DLOG, Con::fullscreen_mode, Window::id, LOG, Con::name, Con::type, Con::window, and XCB_ATOM_ATOM.
Referenced by cmd_fullscreen(), handle_client_message(), and manage_window().