#include "all.h"
#include "yajl_utils.h"

Include dependency graph for workspace.c:

Functions
static void	_workspace_apply_default_orientation (Con *ws)

Con *	workspace_get (const char num, bool created)
	Returns a pointer to the workspace with the given number (starting at 0), creating the workspace if necessary (by allocating the necessary amount of memory and initializing the data structures correctly). More...

void	extract_workspace_names_from_bindings (void)
	Extracts workspace names from keybindings (e.g. More...

Con *	create_workspace_on_output (Output output, Con content)
	Returns a pointer to a new workspace in the given output. More...

bool	workspace_is_visible (Con *ws)
	Returns true if the workspace is currently visible. More...

Con *	_get_sticky (Con con, const char sticky_group, Con *exclude)

static void	workspace_reassign_sticky (Con *con)

static void	workspace_defer_update_urgent_hint_cb (EV_P_ ev_timer *w, int revents)

static void	_workspace_show (Con *workspace)

void	workspace_show (Con *workspace)
	Switches to the given workspace. More...

void	workspace_show_by_name (const char *num)
	Looks up the workspace by name and switches to it. More...

Con *	workspace_next (void)
	Returns the next workspace. More...

Con *	workspace_prev (void)
	Returns the previous workspace. More...

Con *	workspace_next_on_output (void)
	Returns the next workspace on the same output. More...

Con *	workspace_prev_on_output (void)
	Returns the previous workspace on the same output. More...

void	workspace_back_and_forth (void)
	Focuses the previously focused workspace. More...

Con *	workspace_back_and_forth_get (void)
	Returns the previously focused workspace con, or NULL if unavailable. More...

static bool	get_urgency_flag (Con *con)

void	workspace_update_urgent_flag (Con *ws)
	Goes through all clients on the given workspace and updates the workspace’s urgent flag accordingly. More...

void	ws_force_orientation (Con *ws, orientation_t orientation)
	'Forces' workspace orientation by moving all cons into a new split-con with the same orientation as the workspace and then changing the workspace orientation. More...

Con *	workspace_attach_to (Con *ws)
	Called when a new con (with a window, not an empty or split con) should be attached to the workspace (for example when managing a new window or when moving an existing window to the workspace level). More...

Con *	workspace_encapsulate (Con *ws)
	Creates a new container and re-parents all of children from the given workspace into it. More...

bool	workspace_move_to_output (Con ws, const char name)
	Move the given workspace to the specified output. More...

Variables
static char *	previous_workspace_name = NULL

static char **	binding_workspace_names = NULL

Function Documentation

◆ _get_sticky()

Con* _get_sticky	(	Con *	con,
		const char *	sticky_group,
		Con *	exclude
	)

Definition at line 267 of file workspace.c.

References Con::floating_head, Con::nodes_head, Con::sticky_group, TAILQ_FOREACH, and Con::window.

Referenced by workspace_reassign_sticky().

◆ _workspace_apply_default_orientation()

static void _workspace_apply_default_orientation ( Con * ws )

static

Definition at line 28 of file workspace.c.

References con_get_output(), config, Config::default_orientation, DLOG, Rect::height, HORIZ, L_SPLITH, L_SPLITV, Con::layout, NO_ORIENTATION, Con::rect, and Rect::width.

Referenced by create_workspace_on_output(), and workspace_get().

Here is the call graph for this function:

◆ _workspace_show()

static void _workspace_show ( Con * workspace )

static

Definition at line 363 of file workspace.c.

References CF_NONE, CF_OUTPUT, con_descend_focused(), con_focus(), con_get_output(), con_get_workspace(), con_is_internal(), config, DLOG, DONT_KILL_WINDOW, ewmh_update_current_desktop(), ewmh_update_desktop_names(), ewmh_update_desktop_viewport(), ewmh_update_number_of_desktops(), ewmh_update_wm_desktop(), Con::floating_head, focused, FREE, Con::fullscreen_mode, ipc_marshal_workspace_event(), ipc_send_event(), ipc_send_workspace_event(), LOG, main_loop, Con::name, Con::nodes_head, output_push_sticky_windows(), Con::parent, previous_workspace_name, Con::rect, scalloc(), sstrdup(), TAILQ_EMPTY, TAILQ_FOREACH, tree_close_internal(), Con::urgency_timer, Con::urgent, workspace_defer_update_urgent_hint_cb(), workspace_is_visible(), workspace_reassign_sticky(), Config::workspace_urgency_timer, x_set_warp_to(), and y.

Referenced by workspace_show(), and workspace_show_by_name().

Here is the call graph for this function:

◆ create_workspace_on_output()

Con* create_workspace_on_output	(	Output *	output,
		Con *	content
	)

Returns a pointer to a new workspace in the given output.

The workspace is created attached to the tree hierarchy through the given content container.

Definition at line 173 of file workspace.c.

References _workspace_apply_default_orientation(), binding_workspace_names, CF_OUTPUT, con_attach(), con_new(), config, croot, Config::default_layout, DLOG, Con::fullscreen_mode, GREP_FIRST, LOG, Workspace_Assignment::name, Con::name, Con::nodes_head, Con::num, Workspace_Assignment::output, output_get_content(), output_primary_name(), sasprintf(), sstrdup(), TAILQ_FOREACH, Con::type, Con::workspace_layout, ws_assignments, ws_name_to_number(), and x_set_name().

Referenced by init_ws_for_output(), and workspace_move_to_output().

Here is the call graph for this function:

◆ extract_workspace_names_from_bindings()

void extract_workspace_names_from_bindings ( void )

Extracts workspace names from keybindings (e.g.

“web” from “bindsym $mod+1 workspace web”), so that when an output needs a workspace, i3 can start with the first configured one. Needs to be called before reorder_bindings() so that the config-file order is used, not the i3-internal order.

Definition at line 119 of file workspace.c.

References binding_workspace_names, bindings, Binding::command, DLOG, FREE, LOG, parse_string(), srealloc(), and TAILQ_FOREACH.

Referenced by parse_file().

Here is the call graph for this function:

◆ get_urgency_flag()

static bool get_urgency_flag ( Con * con )

static

Definition at line 773 of file workspace.c.

References Con::floating_head, Con::nodes_head, TAILQ_FOREACH, and Con::urgent.

Referenced by workspace_update_urgent_flag().

◆ workspace_attach_to()

Con* workspace_attach_to ( Con * ws )

Called when a new con (with a window, not an empty or split con) should be attached to the workspace (for example when managing a new window or when moving an existing window to the workspace level).

Depending on the workspace_layout setting, this function either returns the workspace itself (default layout) or creates a new stacked/tabbed con and returns that.

Definition at line 848 of file workspace.c.

References con_attach(), con_fix_percent(), con_new(), DLOG, L_DEFAULT, Con::layout, Con::name, and Con::workspace_layout.

Referenced by _con_attach(), and insert_con_into().

Here is the call graph for this function:

◆ workspace_back_and_forth()

void workspace_back_and_forth ( void )

Focuses the previously focused workspace.

Definition at line 748 of file workspace.c.

References DLOG, previous_workspace_name, and workspace_show_by_name().

Referenced by cmd_workspace_back_and_forth(), and maybe_back_and_forth().

Here is the call graph for this function:

◆ workspace_back_and_forth_get()

Con* workspace_back_and_forth_get ( void )

Returns the previously focused workspace con, or NULL if unavailable.

Definition at line 761 of file workspace.c.

References DLOG, previous_workspace_name, and workspace_get().

Referenced by cmd_move_con_to_workspace_back_and_forth(), and maybe_auto_back_and_forth_workspace().

Here is the call graph for this function:

◆ workspace_defer_update_urgent_hint_cb()

static void workspace_defer_update_urgent_hint_cb	(	EV_P_ ev_timer *	w,
		int	revents
	)

static

Definition at line 347 of file workspace.c.

References con_get_workspace(), con_set_urgency(), con_update_parents_urgency(), DLOG, FREE, ipc_send_window_event(), main_loop, tree_render(), Con::urgency_timer, Con::urgent, and workspace_update_urgent_flag().

Referenced by _workspace_show().

Here is the call graph for this function:

◆ workspace_encapsulate()

Con* workspace_encapsulate ( Con * ws )

Creates a new container and re-parents all of children from the given workspace into it.

The container inherits the layout from the workspace.

Definition at line 880 of file workspace.c.

References con_attach(), con_detach(), con_new(), DLOG, ELOG, Con::layout, Con::name, Con::nodes_head, TAILQ_EMPTY, and TAILQ_FIRST.

Referenced by _con_move_to_con(), and tree_split().

Here is the call graph for this function:

◆ workspace_get()

Con* workspace_get	(	const char *	num,
		bool *	created
	)

Returns a pointer to the workspace with the given number (starting at 0), creating the workspace if necessary (by allocating the necessary amount of memory and initializing the data structures correctly).

If created is not NULL, *created will be set to whether or not the workspace has just been created.

Definition at line 48 of file workspace.c.

References _workspace_apply_default_orientation(), con_attach(), con_get_output(), con_new(), config, croot, Config::default_layout, DLOG, ewmh_update_desktop_names(), ewmh_update_desktop_viewport(), ewmh_update_number_of_desktops(), ewmh_update_wm_desktop(), focused, FREE, GREP_FIRST, ipc_send_workspace_event(), LOG, Workspace_Assignment::name, Con::name, Con::nodes_head, Con::num, Workspace_Assignment::output, output_get_content(), Con::parent, sasprintf(), sstrdup(), TAILQ_FOREACH, Con::type, Con::workspace_layout, ws_assignments, ws_name_to_number(), and x_set_name().

Referenced by cmd_focus(), cmd_move_con_to_workspace_name(), cmd_move_con_to_workspace_number(), handle_client_message(), manage_window(), scratchpad_fix_resolution(), scratchpad_move(), scratchpad_show(), workspace_back_and_forth_get(), workspace_move_to_output(), and workspace_show_by_name().

Here is the call graph for this function:

◆ workspace_is_visible()

bool workspace_is_visible ( Con * ws )

Returns true if the workspace is currently visible.

Especially important for multi-monitor environments, as they can have multiple currenlty active workspaces.

Definition at line 254 of file workspace.c.

References CF_OUTPUT, con_get_fullscreen_con(), con_get_output(), LOG, and Workspace_Assignment::output.

Referenced by _con_move_to_con(), _tree_next(), _workspace_show(), cmd_focus_output(), cmd_move_con_to_output(), con_move_to_output(), con_on_remove_child(), con_set_layout(), handle_client_message(), handle_configure_request(), init_ws_for_output(), IPC_HANDLER(), manage_window(), move_to_output_directed(), output_push_sticky_windows(), and workspace_move_to_output().

Here is the call graph for this function:

◆ workspace_move_to_output()

bool workspace_move_to_output	(	Con *	ws,
		const char *	name
	)

Move the given workspace to the specified output.

This returns true if and only if moving the workspace was successful.

Definition at line 909 of file workspace.c.

References CALL, xoutput::con, con_attach(), con_detach(), con_num_children(), create_workspace_on_output(), croot, DLOG, ELOG, floating_fix_coordinates(), Con::floating_head, Con::focus_head, get_output_for_con(), get_output_from_string(), GREP_FIRST, ipc_send_workspace_event(), LOG, Workspace_Assignment::name, Con::name, Con::nodes_head, Workspace_Assignment::output, output_get_content(), output_primary_name(), Con::parent, Con::rect, TAILQ_FIRST, TAILQ_FOREACH, workspace_get(), workspace_is_visible(), workspace_show(), and ws_assignments.

Referenced by cmd_move_workspace_to_output(), and cmd_rename_workspace().

Here is the call graph for this function:

◆ workspace_next()

Con* workspace_next ( void )

Returns the next workspace.

Definition at line 507 of file workspace.c.

References con_get_workspace(), con_is_internal(), croot, focused, NODES_FOREACH, Con::nodes_head, Con::num, Workspace_Assignment::output, output_get_content(), TAILQ_FOREACH, and TAILQ_NEXT.

Referenced by cmd_move_con_to_workspace(), and cmd_workspace().

Here is the call graph for this function:

◆ workspace_next_on_output()

Con* workspace_next_on_output ( void )

Returns the next workspace on the same output.

Definition at line 636 of file workspace.c.

References con_get_output(), con_get_workspace(), focused, NODES_FOREACH, Con::num, Workspace_Assignment::output, output_get_content(), and TAILQ_NEXT.

Referenced by cmd_move_con_to_workspace(), and cmd_workspace().

Here is the call graph for this function:

◆ workspace_prev()

Con* workspace_prev ( void )

Returns the previous workspace.

Definition at line 570 of file workspace.c.

References con_get_workspace(), con_is_internal(), croot, focused, NODES_FOREACH_REVERSE, Con::nodes_head, Con::num, Workspace_Assignment::output, output_get_content(), TAILQ_FOREACH_REVERSE, and TAILQ_PREV.

Referenced by cmd_move_con_to_workspace(), and cmd_workspace().

Here is the call graph for this function:

◆ workspace_prev_on_output()

Con* workspace_prev_on_output ( void )

Returns the previous workspace on the same output.

Definition at line 691 of file workspace.c.

References con_get_output(), con_get_workspace(), DLOG, focused, Con::name, NODES_FOREACH_REVERSE, Con::num, Workspace_Assignment::output, output_get_content(), and TAILQ_PREV.

Referenced by cmd_move_con_to_workspace(), and cmd_workspace().

Here is the call graph for this function:

◆ workspace_reassign_sticky()

static void workspace_reassign_sticky ( Con * con )

static

Definition at line 304 of file workspace.c.

References _get_sticky(), con_get_output(), Con::floating_head, LOG, Con::mapped, Con::name, Con::nodes_head, Workspace_Assignment::output, Con::sticky_group, TAILQ_FOREACH, Con::window, x_move_win(), and x_reparent_child().

Referenced by _workspace_show().

Here is the call graph for this function:

◆ workspace_show()

void workspace_show ( Con * ws )

Switches to the given workspace.

Definition at line 489 of file workspace.c.

References _workspace_show().

Referenced by _con_move_to_con(), _tree_next(), check_crossing_screen_boundary(), cmd_focus(), cmd_focus_output(), cmd_rename_workspace(), cmd_workspace(), cmd_workspace_number(), con_enable_fullscreen(), handle_button_press(), handle_client_message(), handle_configure_request(), handle_enter_notify(), handle_focus_in(), init_ws_for_output(), randr_disable_output(), route_click(), scratchpad_show(), and workspace_move_to_output().

Here is the call graph for this function:

◆ workspace_show_by_name()

void workspace_show_by_name ( const char * num )

Looks up the workspace by name and switches to it.

Definition at line 497 of file workspace.c.

References _workspace_show(), and workspace_get().

Referenced by cmd_workspace_name(), cmd_workspace_number(), init_ws_for_output(), and workspace_back_and_forth().

Here is the call graph for this function:

◆ workspace_update_urgent_flag()

void workspace_update_urgent_flag ( Con * ws )

Goes through all clients on the given workspace and updates the workspace’s urgent flag accordingly.

Definition at line 791 of file workspace.c.

References DLOG, get_urgency_flag(), ipc_send_workspace_event(), and Con::urgent.

Referenced by _con_move_to_con(), con_focus(), con_set_urgency(), tree_close_internal(), and workspace_defer_update_urgent_hint_cb().

Here is the call graph for this function:

◆ ws_force_orientation()

void ws_force_orientation	(	Con *	ws,
		orientation_t	orientation
	)

'Forces' workspace orientation by moving all cons into a new split-con with the same orientation as the workspace and then changing the workspace orientation.

Definition at line 805 of file workspace.c.

References con_attach(), con_detach(), con_fix_percent(), con_focus(), con_new(), DLOG, Con::focus_head, HORIZ, L_SPLITH, L_SPLITV, Con::layout, Con::nodes_head, Con::parent, TAILQ_EMPTY, and TAILQ_FIRST.

Referenced by tree_move().

Here is the call graph for this function:

Variable Documentation

◆ binding_workspace_names

char** binding_workspace_names = NULL

static

Definition at line 20 of file workspace.c.

Referenced by create_workspace_on_output(), and extract_workspace_names_from_bindings().

◆ previous_workspace_name

char* previous_workspace_name = NULL

static

Definition at line 16 of file workspace.c.

Referenced by _workspace_show(), workspace_back_and_forth(), and workspace_back_and_forth_get().

Functions

Variables

Function Documentation

◆ _get_sticky()

◆ _workspace_apply_default_orientation()

◆ _workspace_show()

◆ create_workspace_on_output()

◆ extract_workspace_names_from_bindings()

◆ get_urgency_flag()

◆ workspace_attach_to()

◆ workspace_back_and_forth()

◆ workspace_back_and_forth_get()

◆ workspace_defer_update_urgent_hint_cb()

◆ workspace_encapsulate()

◆ workspace_get()

◆ workspace_is_visible()

◆ workspace_move_to_output()

◆ workspace_next()

◆ workspace_next_on_output()

◆ workspace_prev()

◆ workspace_prev_on_output()

◆ workspace_reassign_sticky()

◆ workspace_show()

◆ workspace_show_by_name()

◆ workspace_update_urgent_flag()

◆ ws_force_orientation()

Variable Documentation

◆ binding_workspace_names

◆ previous_workspace_name