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/10/15 02:56] – Include documentation on frame_border_top feature emh_mark_ihowto: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 145: Line 147:
  
   * frame_border_top=0 //#Default//   * frame_border_top=0 //#Default//
 +
 +{{ howto:xfwm4:frame_border_top-default.png }}
 +
   * frame_border_top=2 //#Will crop the top 2 pixels off//   * 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 277: 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 308: 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]]