#include "all.h"

Include dependency graph for x.c:

Data Structures
struct	con_state

Macros
#define	MAX(x, y) ((x) > (y) ? (x) : (y))

Typedefs
typedef struct con_state	con_state

Functions
static con_state *	state_for_frame (xcb_window_t window)

void	x_con_init (Con *con)
	Initializes the X11 part for the given container. More...

void	x_reinit (Con *con)
	Re-initializes the associated X window state for this container. More...

void	x_reparent_child (Con con, Con old)
	Reparents the child window of the given container (necessary for sticky containers). More...

void	x_move_win (Con src, Con dest)
	Moves a child window from Container src to Container dest. More...

void	x_con_kill (Con *con)
	Kills the window decoration associated with the given container. More...

bool	window_supports_protocol (xcb_window_t window, xcb_atom_t atom)
	Returns true if the client supports the given protocol atom (like WM_DELETE_WINDOW) More...

void	x_window_kill (xcb_window_t window, kill_window_t kill_window)
	Kills the given X11 window using WM_DELETE_WINDOW (if supported). More...

static void	x_draw_title_border (Con con, struct deco_render_params p)

static void	x_draw_decoration_after_title (Con con, struct deco_render_params p)

void	x_draw_decoration (Con *con)
	Draws the decoration of the given container onto its parent. More...

void	x_deco_recurse (Con *con)
	Recursively calls x_draw_decoration. More...

static void	set_hidden_state (Con *con)

void	x_push_node (Con *con)
	This function pushes the properties of each node of the layout tree to X11 if they have changed (like the map state, position of the window, …). More...

static void	x_push_node_unmaps (Con *con)

static bool	is_con_attached (Con *con)

void	x_push_changes (Con *con)
	Pushes all changes (state of each node, see x_push_node() and the window stack) to X11. More...

void	x_raise_con (Con *con)
	Raises the specified container in the internal stack of X windows. More...

void	x_set_name (Con con, const char name)
	Sets the WM_NAME property (so, no UTF8, but used only for debugging anyways) of the given name. More...

void	update_shmlog_atom ()
	Set up the SHMLOG_PATH atom. More...

void	x_set_i3_atoms (void)
	Sets up i3 specific atoms (I3_SOCKET_PATH and I3_CONFIG_PATH) More...

void	x_set_warp_to (Rect *rect)
	Set warp_to coordinates. More...

void	x_mask_event_mask (uint32_t mask)
	Applies the given mask to the event mask of every i3 window decoration X11 window. More...

Variables
xcb_window_t	ewmh_window
	The EWMH support window that is used to indicate that an EWMH-compliant window manager is present. More...

xcb_window_t	focused_id = XCB_NONE
	Stores the X11 window ID of the currently focused window. More...

static xcb_window_t	last_focused = XCB_NONE

static Rect *	warp_to

	state_head

	old_state_head

	initial_mapping_head

Macro Definition Documentation

◆ MAX

#define MAX	(	x,
		y
	)	((x) > (y) ? (x) : (y))

Definition at line 14 of file x.c.

Referenced by x_push_node().

Typedef Documentation

◆ con_state

typedef struct con_state con_state

Function Documentation

◆ is_con_attached()

static bool is_con_attached ( Con * con )

static

Definition at line 965 of file x.c.

References Con::nodes_head, Con::parent, and TAILQ_FOREACH.

Referenced by x_push_changes().

◆ set_hidden_state()

static void set_hidden_state ( Con * con )

static

Definition at line 661 of file x.c.

References con_is_hidden(), conn, DLOG, Con::frame, Window::id, surface_t::id, con_state::is_hidden, con_state::state, state_for_frame(), Con::window, xcb_add_property_atom(), and xcb_remove_property_atom().

Referenced by x_push_node().

Here is the call graph for this function:

◆ state_for_frame()

static con_state* state_for_frame ( xcb_window_t window )

static

Definition at line 90 of file x.c.

References CIRCLEQ_FOREACH, ELOG, con_state::id, and con_state::state.

Referenced by set_hidden_state(), x_con_kill(), x_deco_recurse(), x_move_win(), x_push_node(), x_push_node_unmaps(), x_raise_con(), x_reinit(), x_reparent_child(), and x_set_name().

◆ update_shmlog_atom()

void update_shmlog_atom ( void )

Set up the SHMLOG_PATH atom.

Definition at line 1229 of file x.c.

References conn, root, and shmlogname.

Referenced by cmd_shmlog(), and x_set_i3_atoms().

◆ window_supports_protocol()

bool window_supports_protocol	(	xcb_window_t	window,
		xcb_atom_t	atom
	)

Returns true if the client supports the given protocol atom (like WM_DELETE_WINDOW)

Definition at line 265 of file x.c.

References conn.

Referenced by manage_window(), and x_window_kill().

◆ x_con_init()

void x_con_init ( Con * con )

Initializes the X11 part for the given container.

Called exactly once for every container from con_new().

Definition at line 107 of file x.c.

References CIRCLEQ_INSERT_HEAD, colormap, Con::colormap, conn, create_window(), Con::depth, DLOG, draw_util_surface_init(), Con::frame, FRAME_EVENT_MASK, get_visualid_by_depth(), get_visualtype_by_id(), Rect::height, con_state::id, surface_t::id, con_state::initial, initial_mapping_head, con_state::initial_mapping_order, con_state::mapped, con_state::old_state, old_state_head, root, root_depth, root_screen, scalloc(), con_state::state, state_head, TAILQ_INSERT_TAIL, Rect::width, and XCURSOR_CURSOR_POINTER.

Referenced by con_new(), and json_end_map().

Here is the call graph for this function:

◆ x_con_kill()

void x_con_kill ( Con * con )

Kills the window decoration associated with the given container.

Definition at line 239 of file x.c.

References CIRCLEQ_REMOVE, Con::colormap, conn, draw_util_surface_free(), focused_id, Con::frame, Con::frame_buffer, FREE, surface_t::id, initial_mapping_head, con_state::initial_mapping_order, last_focused, con_state::name, con_state::old_state, old_state_head, con_state::state, state_for_frame(), state_head, and TAILQ_REMOVE.

Referenced by tree_close_internal().

Here is the call graph for this function:

◆ x_deco_recurse()

void x_deco_recurse ( Con * con )

Recursively calls x_draw_decoration.

This cannot be done in x_push_node because x_push_node uses focus order to recurse (see the comment above) while drawing the decoration needs to happen in the actual order.

Definition at line 634 of file x.c.

References draw_util_copy_surface(), Con::floating_head, Con::frame, Con::frame_buffer, Rect::height, surface_t::id, con_state::mapped, Con::mapped, Con::nodes_head, Con::rect, con_state::state, state_for_frame(), TAILQ_EMPTY, TAILQ_FOREACH, Con::type, Rect::width, x_deco_recurse(), and x_draw_decoration().

Referenced by load_configuration(), x_deco_recurse(), x_push_changes(), and x_push_node().

Here is the call graph for this function:

◆ x_draw_decoration()

void x_draw_decoration ( Con * con )

Draws the decoration of the given container onto its parent.

Definition at line 379 of file x.c.

References ADJ_LEFT_SCREEN_EDGE, ADJ_LOWER_SCREEN_EDGE, ADJ_NONE, ADJ_RIGHT_SCREEN_EDGE, ADJ_UPPER_SCREEN_EDGE, Colortriple::background, deco_render_params::background, Config::config_client::background, deco_render_params::border_style, BS_NONE, BS_NORMAL, BS_PIXEL, Colortriple::child_border, Config::client, deco_render_params::color, COLOR_TRANSPARENT, con_state::con, con_adjacent_borders(), con_border_style(), con_border_style_rect(), deco_render_params::con_deco_rect, con_get_tree_representation(), con_inside_focused(), deco_render_params::con_is_leaf, con_is_leaf(), con_parse_title_format(), deco_render_params::con_rect, deco_render_params::con_window_rect, config, Con::deco_rect, Con::deco_render_params, draw_util_clear_surface(), draw_util_copy_surface(), draw_util_rectangle(), draw_util_text(), Con::focus_head, focused, Config::config_client::focused, Config::config_client::focused_inactive, Config::font, Con::frame, Con::frame_buffer, FREE, Font::height, Rect::height, Config::hide_edge_borders, I3STRING_FREE, i3string_from_utf8(), surface_t::id, Colortriple::indicator, L_SPLITH, L_SPLITV, L_STACKED, L_TABBED, Con::layout, logical_px(), Con::mark_changed, marks, Con::marks_head, Window::name, mark_t::name, Window::name_x_changed, Con::nodes_head, Con::parent, deco_render_params::parent_layout, Con::pixmap_recreated, predict_text_width(), Con::rect, sasprintf(), scalloc(), Config::show_marks, sstrdup(), TAILQ_EMPTY, TAILQ_FIRST, TAILQ_FOREACH, TAILQ_NEXT, TAILQ_PREV, Colortriple::text, Con::title_format, Con::type, Config::config_client::unfocused, Config::config_client::urgent, Con::urgent, Rect::width, Con::window, Con::window_rect, Rect::x, x_draw_decoration_after_title(), x_draw_title_border(), and Rect::y.

Referenced by x_deco_recurse().

Here is the call graph for this function:

◆ x_draw_decoration_after_title()

static void x_draw_decoration_after_title	(	Con *	con,
		struct deco_render_params *	p
	)

static

Definition at line 340 of file x.c.

References Colortriple::background, Colortriple::border, deco_render_params::color, Con::deco_rect, draw_util_rectangle(), font_is_pango(), Con::frame_buffer, Rect::height, L_TABBED, Con::layout, logical_px(), Con::parent, Rect::width, Rect::x, x_draw_title_border(), and Rect::y.

Referenced by x_draw_decoration().

Here is the call graph for this function:

◆ x_draw_title_border()

static void x_draw_title_border	(	Con *	con,
		struct deco_render_params *	p
	)

static

Definition at line 320 of file x.c.

References ADJ_LEFT_SCREEN_EDGE, ADJ_RIGHT_SCREEN_EDGE, Colortriple::border, deco_render_params::color, con_adjacent_borders(), config, Con::current_border_width, Con::deco_rect, draw_util_rectangle(), Con::frame_buffer, Rect::height, Config::hide_edge_borders, L_STACKED, L_TABBED, Con::layout, Con::parent, TAILQ_NEXT, Rect::width, Rect::x, and Rect::y.

Referenced by x_draw_decoration(), and x_draw_decoration_after_title().

Here is the call graph for this function:

◆ x_mask_event_mask()

void x_mask_event_mask ( uint32_t mask )

Applies the given mask to the event mask of every i3 window decoration X11 window.

This is useful to disable EnterNotify while resizing so that focus is untouched.

Definition at line 1266 of file x.c.

References CIRCLEQ_FOREACH_REVERSE, conn, FRAME_EVENT_MASK, con_state::id, con_state::mapped, con_state::state, and state_head.

Referenced by resize_graphical_handler().

◆ x_move_win()

void x_move_win	(	Con *	src,
		Con *	dest
	)

Moves a child window from Container src to Container dest.

Definition at line 212 of file x.c.

References con_state::con, DLOG, ELOG, Con::frame, surface_t::id, state_for_frame(), and con_state::window_rect.

Referenced by workspace_reassign_sticky().

Here is the call graph for this function:

◆ x_push_changes()

void x_push_changes ( Con * con )

Pushes all changes (state of each node, see x_push_node() and the window stack) to X11.

Definition at line 989 of file x.c.

References CHILD_EVENT_MASK, CIRCLEQ_END, CIRCLEQ_FOREACH, CIRCLEQ_FOREACH_REVERSE, CIRCLEQ_INSERT_TAIL, CIRCLEQ_PREV, CIRCLEQ_REMOVE, con_state::con, con_has_managed_window(), conn, DLOG, Window::doesnt_accept_focus, ELOG, ewmh_update_active_window(), ewmh_update_client_list(), ewmh_update_client_list_stacking(), ewmh_window, focused, focused_id, Con::frame, FRAME_EVENT_MASK, get_output_containing(), Rect::height, con_state::id, Window::id, surface_t::id, con_state::initial, initial_mapping_head, con_state::initial_mapping_order, ipc_send_window_event(), is_con_attached(), last_focused, last_timestamp, con_state::mapped, Con::mapped, Con::name, Window::needs_take_focus, con_state::old_state, old_state_head, root, ROOT_EVENT_MASK, send_take_focus(), srealloc(), con_state::state, state_head, TAILQ_FOREACH, to_focus, con_state::unmap_now, Rect::width, Con::window, Rect::x, x_deco_recurse(), x_push_node(), x_push_node_unmaps(), and Rect::y.

Referenced by DRAGGING_CB(), handle_motif_hints_change(), handle_motion_notify(), handle_windowname_change(), handle_windowname_change_legacy(), and tree_render().

Here is the call graph for this function:

◆ x_push_node()

void x_push_node ( Con * con )

This function pushes the properties of each node of the layout tree to X11 if they have changed (like the map state, position of the window, …).

It recursively traverses all children of the given node.

Definition at line 688 of file x.c.

References Con::border_style, BS_NONE, CHILD_EVENT_MASK, con_state::child_mapped, con_is_leaf(), conn, Con::deco_rect, Window::depth, DLOG, draw_util_copy_surface(), draw_util_surface_free(), draw_util_surface_init(), draw_util_surface_set_size(), fake_absolute_configure_notify(), Con::focus_head, focused, Con::frame, Con::frame_buffer, FRAME_EVENT_MASK, FREE, surface_t::gc, get_visualid_by_depth(), get_visualtype_by_id(), height, Rect::height, Window::id, surface_t::id, Con::ignore_unmap, L_STACKED, L_TABBED, Con::layout, con_state::mapped, Con::mapped, MAX, con_state::name, con_state::need_reparent, Con::nodes_head, con_state::old_frame, Con::parent, Con::pixmap_recreated, con_state::rect, Con::rect, root_depth, set_hidden_state(), con_state::state, state_for_frame(), TAILQ_FIRST, TAILQ_FOREACH, Con::type, con_state::unmap_now, width, Rect::width, Con::window, con_state::window_rect, Con::window_rect, Rect::x, x_deco_recurse(), x_push_node(), xcb_set_window_rect(), and Rect::y.

Referenced by DRAGGING_CB(), x_push_changes(), and x_push_node().

Here is the call graph for this function:

◆ x_push_node_unmaps()

static void x_push_node_unmaps ( Con * con )

static

Definition at line 921 of file x.c.

References conn, DLOG, Con::floating_head, Con::frame, Window::id, surface_t::id, Con::ignore_unmap, con_state::mapped, Con::mapped, Con::name, Con::nodes_head, con_state::state, state_for_frame(), TAILQ_FOREACH, con_state::unmap_now, and Con::window.

Referenced by x_push_changes().

Here is the call graph for this function:

◆ x_raise_con()

void x_raise_con ( Con * con )

Raises the specified container in the internal stack of X windows.

The next call to x_push_changes() will make the change visible in X11.

Definition at line 1198 of file x.c.

References CIRCLEQ_INSERT_HEAD, CIRCLEQ_REMOVE, Con::frame, surface_t::id, con_state::state, state_for_frame(), and state_head.

Referenced by render_con(), render_output(), and render_root().

Here is the call graph for this function:

◆ x_reinit()

void x_reinit ( Con * con )

Re-initializes the associated X window state for this container.

You have to call this when you assign a client to an empty container to ensure that its state gets updated correctly.

Definition at line 177 of file x.c.

References con_state::child_mapped, con_state::con, DLOG, ELOG, Con::frame, surface_t::id, con_state::initial, con_state::state, state_for_frame(), and con_state::window_rect.

Referenced by manage_window().

Here is the call graph for this function:

◆ x_reparent_child()

void x_reparent_child	(	Con *	con,
		Con *	old
	)

Reparents the child window of the given container (necessary for sticky containers).

The reparenting happens in the next call of x_push_changes().

Definition at line 197 of file x.c.

References ELOG, Con::frame, surface_t::id, con_state::need_reparent, con_state::old_frame, con_state::state, and state_for_frame().

Referenced by workspace_reassign_sticky().

Here is the call graph for this function:

◆ x_set_i3_atoms()

void x_set_i3_atoms ( void )

Sets up i3 specific atoms (I3_SOCKET_PATH and I3_CONFIG_PATH)

Definition at line 1239 of file x.c.

References conn, current_configpath, current_socketpath, root, and update_shmlog_atom().

Referenced by cmd_reload(), and main().

Here is the call graph for this function:

◆ x_set_name()

void x_set_name	(	Con *	con,
		const char *	name
	)

Sets the WM_NAME property (so, no UTF8, but used only for debugging anyways) of the given name.

Used for properly tagging the windows for easily spotting i3 windows in xwininfo -root -all.

Definition at line 1213 of file x.c.

References ELOG, Con::frame, FREE, surface_t::id, con_state::name, sstrdup(), con_state::state, and state_for_frame().

Referenced by _create___i3(), create_workspace_on_output(), floating_enable(), manage_window(), output_init_con(), and workspace_get().

Here is the call graph for this function:

◆ x_set_warp_to()

void x_set_warp_to ( Rect * rect )

Set warp_to coordinates.

This will trigger on the next call to x_push_changes().

Definition at line 1255 of file x.c.

References config, Config::mouse_warping, POINTER_WARPING_NONE, and con_state::rect.

Referenced by _con_move_to_con(), _tree_next(), _workspace_show(), and DRAGGING_CB().

◆ x_window_kill()

void x_window_kill	(	xcb_window_t	window,
		kill_window_t	kill_window
	)

Kills the given X11 window using WM_DELETE_WINDOW (if supported).

Definition at line 288 of file x.c.

References conn, KILL_WINDOW, LOG, scalloc(), and window_supports_protocol().

Referenced by tree_close_internal().

Here is the call graph for this function:

Variable Documentation

◆ ewmh_window

xcb_window_t ewmh_window

The EWMH support window that is used to indicate that an EWMH-compliant window manager is present.

This window is created when i3 starts and kept alive until i3 exits. We also use this window as the focused window if no other window is available to be focused on the active workspace in order to prevent keyboard focus issues (see #1378).

Definition at line 17 of file x.c.

Referenced by x_push_changes().