4 * i3 - an improved dynamic tiling window manager
6 * © 2009-2010 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
20 * Returns a pointer to the workspace with the given number (starting at 0),
21 * creating the workspace if necessary (by allocating the necessary amount of
22 * memory and initializing the data structures correctly).
25 Workspace *workspace_get(int number);
28 * Sets the name (or just its number) for the given workspace. This has to
29 * be called for every workspace as the rendering function
30 * (render_internal_bar) relies on workspace->name and workspace->name_len
34 void workspace_set_name(Workspace *ws, const char *name);
37 * Returns true if the workspace is currently visible. Especially important for
38 * multi-monitor environments, as they can have multiple currenlty active
42 bool workspace_is_visible(Workspace *ws);
44 /** Switches to the given workspace */
45 void workspace_show(xcb_connection_t *conn, int workspace);
48 * Assigns the given workspace to the given screen by correctly updating its
49 * state and reconfiguring all the clients on this workspace.
51 * This is called when initializing a screen and when re-assigning it to a
52 * different screen which just got available (if you configured it to be on
53 * screen 1 and you just plugged in screen 1).
56 void workspace_assign_to(Workspace *ws, Output *screen, bool hide_it);
59 * Initializes the given workspace if it is not already initialized. The given
60 * screen is to be understood as a fallback, if the workspace itself either
61 * was not assigned to a particular screen or cannot be placed there because
62 * the screen is not attached at the moment.
65 void workspace_initialize(Workspace *ws, Output *screen, bool recheck);
68 * Gets the first unused workspace for the given screen, taking into account
69 * the preferred_screen setting of every workspace (workspace assignments).
72 Workspace *get_first_workspace_for_screen(Output *screen);
75 * Unmaps all clients (and stack windows) of the given workspace.
77 * This needs to be called separately when temporarily rendering a workspace
78 * which is not the active workspace to force reconfiguration of all clients,
79 * like in src/xinerama.c when re-assigning a workspace to another screen.
82 void workspace_unmap_clients(xcb_connection_t *conn, Workspace *u_ws);
85 * Maps all clients (and stack windows) of the given workspace.
88 void workspace_map_clients(xcb_connection_t *conn, Workspace *ws);
91 * Goes through all clients on the given workspace and updates the workspace’s
92 * urgent flag accordingly.
95 void workspace_update_urgent_flag(Workspace *ws);
98 * Returns the width of the workspace.
101 int workspace_width(Workspace *ws);
104 * Returns the effective height of the workspace (without the internal bar and
105 * without dock clients).
108 int workspace_height(Workspace *ws);