Customizing Window Appearance (StumpWM Manual)

### 5.2 Customizing Window Appearance ¶

Variable: *maxsize-border-width* ¶

  The width in pixels given to the borders of windows with maxsize or ratio hints.

Variable: *transient-border-width* ¶

  The width in pixels given to the borders of transient or pop-up windows.

Variable: *normal-border-width* ¶

  The width in pixels given to the borders of regular windows.

Variable: *window-border-style* ¶

  This controls the appearance of the border around windows. valid values are:

  :thick

    All space within the frame not used by the window is dedicated to the border.

  :thin

    Only the border width as controlled by *maxsize-border-width* *normal-border-width* and *transient-border-width* is used as the border. The rest is filled with the unfocus color.

  :tight

    The same as :thin but the border surrounds the window and the wasted space within the frame is not obscured, revealing the background.

  :none

    Like :tight but no border is ever visible.

  After changing this variable you may need to call sync-all-frame-windows to see the change.

See Colors for an explanation of how to set these color variables.

Function: set-win-bg-color color ¶

  Set the background color of the window. The background color will only be visible for windows with size increment hints such as ‘`emacs`’ and ‘`xterm`’.

Function: set-focus-color color ¶

  Set the border color for focused windows. This is only used when there is more than one frame.

Function: set-unfocus-color color ¶

  Set the border color for windows without focus. This is only used when there is more than one frame.

Function: set-float-focus-color color ¶

  Set the border color for focused windows in a float group.

Function: set-float-unfocus-color color ¶

  Set the border color for windows without focus in a float group.

Function: set-normal-gravity gravity ¶

  Set the default gravity for normal windows. Possible values are `:center` `:top` `:left` `:right` `:bottom` `:top-left` `:top-right` `:bottom-left` and `:bottom-right`.

Function: set-maxsize-gravity gravity ¶

  Set the default gravity for maxsize windows.

Function: set-transient-gravity gravity ¶

  Set the default gravity for transient/pop-up windows.

Command: gravity gravity ¶

  Set a window’s gravity within its frame. Gravity controls where the window will appear in a frame if it is smaller that the frame. Possible values are:

  center
  top
  right
  bottom
  left
  top-right
  top-left
  bottom-right
  bottom-left

Function: gravity-coords gravity width height minx miny maxx maxy ¶

  Get the X and Y coordinates to place something of width WIDTH and height HEIGHT within an area defined by MINX MINY MAXX and MAXY, guided by GRAVITY.