X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=include%2Ffloating.h;h=babfafc9a583f3321dbe32c4394b9d4ca8e22070;hb=d1f8266df068c4ba15019f34c8318f342f7ecb83;hp=884d3cf1fe9df848a5ffdb2f2b9dd8f4e70de1b9;hpb=0aa306890b66047aacb4863df0cfdfd6f46361e6;p=i3%2Fi3 diff --git a/include/floating.h b/include/floating.h index 884d3cf1..babfafc9 100644 --- a/include/floating.h +++ b/include/floating.h @@ -2,29 +2,30 @@ * vim:ts=4:sw=4:expandtab * * i3 - an improved dynamic tiling window manager - * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE) + * © 2009 Michael Stapelberg and contributors (see also: LICENSE) * * floating.c: Floating windows. * */ -#ifndef I3_FLOATING_H -#define I3_FLOATING_H +#pragma once + +#include #include "tree.h" /** Callback for dragging */ -typedef void(*callback_t)(Con*, Rect*, uint32_t, uint32_t, const void*); +typedef void (*callback_t)(Con *, Rect *, uint32_t, uint32_t, const void *); /** Macro to create a callback function for dragging */ -#define DRAGGING_CB(name) \ - static void name(Con *con, Rect *old_rect, uint32_t new_x, \ - uint32_t new_y, const void *extra) +#define DRAGGING_CB(name) \ + static void name(Con *con, Rect *old_rect, uint32_t new_x, \ + uint32_t new_y, const void *extra) /** On which border was the dragging initiated? */ -typedef enum { BORDER_LEFT = (1 << 0), - BORDER_RIGHT = (1 << 1), - BORDER_TOP = (1 << 2), - BORDER_BOTTOM = (1 << 3)} border_t; +typedef enum { BORDER_LEFT = (1 << 0), + BORDER_RIGHT = (1 << 1), + BORDER_TOP = (1 << 2), + BORDER_BOTTOM = (1 << 3) } border_t; /** * Enables floating mode for the given container by detaching it from its @@ -65,25 +66,18 @@ void floating_raise_con(Con *con); */ bool floating_maybe_reassign_ws(Con *con); -#if 0 /** - * Removes the floating client from its workspace and attaches it to the new - * workspace. This is centralized here because it may happen if you move it - * via keyboard and if you move it using your mouse. + * Centers a floating con above the specified rect. * */ -void floating_assign_to_workspace(Client *client, Workspace *new_workspace); +void floating_center(Con *con, Rect rect); /** - * Called whenever the user clicks on a border (not the titlebar!) of a - * floating window. Determines on which border the user clicked and launches - * the drag_pointer function with the resize_callback. + * Moves the given floating con to the current pointer position. * */ -int floating_border_click(xcb_connection_t *conn, Client *client, - xcb_button_press_event_t *event); +void floating_move_to_pointer(Con *con); -#endif /** * Called when the user clicked on the titlebar of a floating window. * Calls the drag_pointer function with the drag_window callback @@ -99,43 +93,48 @@ void floating_drag_window(Con *con, const xcb_button_press_event_t *event); */ void floating_resize_window(Con *con, const bool proportional, const xcb_button_press_event_t *event); -#if 0 /** - * Changes focus in the given direction for floating clients. - * - * Changing to the left/right means going to the previous/next floating client, - * changing to top/bottom means cycling through the Z-index. + * Called when a floating window is created or resized. + * This function resizes the window if its size is higher or lower than the + * configured maximum/minimum size, respectively. * */ -void floating_focus_direction(xcb_connection_t *conn, Client *currently_focused, - direction_t direction); +void floating_check_size(Con *floating_con); /** - * Moves the client 10px to the specified direction. + * This is the return value of a drag operation like drag_pointer. * - */ -void floating_move(xcb_connection_t *conn, Client *currently_focused, - direction_t direction); - -/** - * Hides all floating clients (or show them if they are currently hidden) on - * the specified workspace. + * DRAGGING will indicate the drag action is still in progress and can be + * continued or resolved. + * + * DRAG_SUCCESS will indicate the intention of the drag action should be + * carried out. + * + * DRAG_REVERT will indicate an attempt should be made to restore the state of + * the involved windows to their condition before the drag. + * + * DRAG_ABORT will indicate that the intention of the drag action cannot be + * carried out (e.g. because the window has been unmapped). * */ -void floating_toggle_hide(xcb_connection_t *conn, Workspace *workspace); +typedef enum { + DRAGGING = 0, + DRAG_SUCCESS, + DRAG_REVERT, + DRAG_ABORT +} drag_result_t; -#endif /** - * This function grabs your pointer and lets you drag stuff around (borders). - * Every time you move your mouse, an XCB_MOTION_NOTIFY event will be received - * and the given callback will be called with the parameters specified (client, - * border on which the click originally was), the original rect of the client, - * the event and the new coordinates (x, y). + * This function grabs your pointer and keyboard and lets you drag stuff around + * (borders). Every time you move your mouse, an XCB_MOTION_NOTIFY event will + * be received and the given callback will be called with the parameters + * specified (client, border on which the click originally was), the original + * rect of the client, the event and the new coordinates (x, y). * */ -void drag_pointer(Con *con, const xcb_button_press_event_t *event, - xcb_window_t confine_to, border_t border, int cursor, - callback_t callback, const void *extra); +drag_result_t drag_pointer(Con *con, const xcb_button_press_event_t *event, + xcb_window_t confine_to, border_t border, int cursor, + callback_t callback, const void *extra); /** * Repositions the CT_FLOATING_CON to have the coordinates specified by @@ -146,11 +145,18 @@ void drag_pointer(Con *con, const xcb_button_press_event_t *event, */ void floating_reposition(Con *con, Rect newrect); +/** + * Sets size of the CT_FLOATING_CON to specified dimensions. Might limit the + * actual size with regard to size constraints taken from user settings. + * Additionally, the dimensions may be upscaled until they're divisible by the + * window's size hints. + * + */ +void floating_resize(Con *floating_con, int x, int y); + /** * Fixes the coordinates of the floating window whenever the window gets * reassigned to a different output (or when the output’s rect changes). * */ void floating_fix_coordinates(Con *con, Rect *old_rect, Rect *new_rect); - -#endif