Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
howto:xfwm4_theme [2020/08/19 19:41] – add TOC and section divs kevinbowenhowto:xfwm4_theme [2024/11/20 22:15] (current) – Small write up for new stretched bitmap feature in 4.20 rozniak
Line 12: Line 12:
   * **[[#XPM (X PixMap) format|XPM (X PixMap) format]]**   * **[[#XPM (X PixMap) format|XPM (X PixMap) format]]**
   * **[[#Xfwm 4.2 new functionality|Xfwm 4.2 new functionality]]**   * **[[#Xfwm 4.2 new functionality|Xfwm 4.2 new functionality]]**
-  * **[[#Conclusion|Conclusion]]** 
   * **[[#List of frame and button part names|List of frame and button part names]]**   * **[[#List of frame and button part names|List of frame and button part names]]**
 +  * **[[#Xfwm 4.20 new functionality|Xfwm 4.20 new functionality]]**
 +  * **[[#Conclusion|Conclusion]]**
  
 ---- ----
Line 19: Line 20:
  
 ===== Introduction ===== ===== Introduction =====
-Xfwm4, Xfce4's native window manager uses a simple yet flexible pixmap based theme engine using images in .xpm format. Xfwm4 also uses a text file for other configuration options (see themerc section). Further to this you can also make a theme pick up gtk theme colours which will be covered in the gtk color pickup section of the document.+Xfwm4, Xfce's native window manager, uses a simple yet flexible pixmap based theme engine using images in .xpm format. Xfwm4 also uses a text file for other configuration options (see themerc section). Further to this you can also make a theme pick up gtk theme colours which will be covered in the gtk color pickup section of the document.
  
 {{ howto:xfwm4:xfwm4-window.gif |Figure 1 - A sample window}} {{ howto:xfwm4:xfwm4-window.gif |Figure 1 - A sample window}}
  
 +----
 ===== Themes locations ===== ===== Themes locations =====
 In Xfwm4 version 4.0, the themes are searched in the following directories: In Xfwm4 version 4.0, the themes are searched in the following directories:
Line 140: Line 142:
  
 If you don't have a menu button, you can use a blank square. Or you cannot use this option. If you don't have a menu button, you can use a blank square. Or you cannot use this option.
 +
 +==== Frame border top====
 +XFWM Versions 4.14.1 and above can take advantage of this feature to crop the top frame border of maximized application windows.
 +
 +  * frame_border_top=0 //#Default//
 +
 +{{ howto:xfwm4:frame_border_top-default.png }}
 +
 +  * frame_border_top=2 //#Will crop the top 2 pixels off//
 +
 +{{ howto:xfwm4:frame_border_top-2.png }}
 +
  
 [[|Back to Top]] [[|Back to Top]]
Line 271: Line 285:
  
 [[|Back to Top]] [[|Back to Top]]
----- 
  
-===== Conclusion ===== 
-I hope this small "how-to" for creating themes for xfwm4 will help you design your own themes. It would be great if you could share your themes with others on [[http://www.xfce-look.org]] (which is the preferred site for Xfce related themes) or from [[http://browse.deviantart.com/customization/skins/linuxutil/xfce/?alltime=yes#order=9]]. 
- 
-[[|Back to Top]] 
 ---- ----
  
Line 302: Line 311:
 | bottom-left-active  | bottom-left-inactive  |                   |                  |                         |                           |                           |                          | | bottom-left-active  | bottom-left-inactive  |                   |                  |                         |                           |                           |                          |
 | left-active         | left-inactive         |                   |                  |                         |                           |                           |                          | | left-active         | left-inactive         |                   |                  |                         |                           |                           |                          |
-===== Credits ===== + 
-This how-to has been started by Drewbian (drewbian at tsn dot cc) and later modifed by Olivier Fourdan (fourdan at xfce dot org) and Renato Santos (renatosan at gmail dot com).+---- 
 + 
 +===== Xfwm 4.20 new functionality ===== 
 +Xfwm 4.20 introduces the ability to have bitmaps that stretch across each side of the window decorations. This feature allows for things such as horizontal gradients - prior to this, with tiling as the only option, only vertical gradients were possible. 
 + 
 +Xfwm will use parts with the suffix "-stretch" if they exist, like so: 
 + 
 +^ Original            ^ Stretched                   ^ 
 +| top-left-active     | top-left-active-stretch     | 
 +| top-active          | top-active-stretch          | 
 +| top-right-active    | top-right-active-stretch    | 
 +| left-active         | left-active-stretch         | 
 +| right-active        | right-active-stretch        | 
 +| bottom-left-active  | bottom-left-active-stretch  | 
 +| bottom-active       | bottom-active-stretch       | 
 +| bottom-right-active | bottom-right-active-stretch | 
 + 
 +The same of course applies to the "inactive" variants of each part. 
 + 
 +It is recommended you still supply a non-stretched variant of theme parts for backwards compatibility purposes. Since this is additive, supplying both non-stretched and stretched will mean users of Xfwm <= 4.18 will use the tiled version, and >= 4.20 will use the stretched version. 
 + 
 +---- 
 + 
 +===== Conclusion ===== 
 +I hope this small "how-to" for creating themes for xfwm4 will help you design your own themes. It would be great if you could share your themes with others on [[http://www.xfce-look.org]] (which is the preferred site for Xfce related themes) or from [[http://browse.deviantart.com/customization/skins/linuxutil/xfce/?alltime=yes#order=9]]. 
  
 [[|Back to Top]] [[|Back to Top]]
 ---- ----
 [[:howto:install_new_themes:|Back to HowTo install themes page]] [[:howto:install_new_themes:|Back to HowTo install themes page]]