sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (1251B)


      1 background image
      2 ================
      3 
      4 Description
      5 -----------
      6 
      7 Draws a background image in place of the defaultbg color.
      8 
      9 Notes
     10 -----
     11 
     12 The path to the image file has to be configured in `config.h` using the variable
     13 `bgimg` (patch modifies `config.def.h`). The image format is expected to be 
     14 [farbfeld](//tools.suckless.org/farbfeld). In case the background image 
     15 is smaller than the window size the background will be tiled.
     16 
     17 Pseudo Transparency
     18 -------------------
     19 
     20 The variable `pseudotransparency` enables functionality which fixes the 
     21 coordinates of the background image to the screen origin. This emulates the 
     22 effect of transparency without the need for an *X composite manager*.
     23 
     24 *Hint*: With the use of [farbfeld utilities](http://zzo38computer.org/fossil/farbfeld.ui/) 
     25 effects can be applied to the desktop background in an automated fashion. 
     26 Pictured below is an example of the result of a darken and blur operation 
     27 invoked with the following command:
     28 
     29 	jpg2ff < wallpaper.jpg | ff-border e 50 | ff-bright rgba 0 0.5 1 | ff-blur 50 15 > st_wallpaper.ff
     30 
     31 ![Screenshot](pseudo-transparency.png)
     32 
     33 Download
     34 --------
     35 * [st-background-image-0.8.4.diff](st-background-image-0.8.4.diff)
     36 
     37 Authors
     38 -------
     39 * Matthias Schoth - <mschoth@gmail.com>
     40