sites

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

index.md (1960B)


      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 
     36 * [st-background-image-0.8.4.diff](st-background-image-0.8.4.diff)
     37 * [st-background-image-0.8.5.diff](st-background-image-0.8.5.diff)
     38 
     39 Signal Reloading
     40 ----------------
     41 
     42 Apply the following patch on top of the previous to enable reloading the
     43 background image when a USR1 signal occurs:
     44 
     45 * [st-background-image-signal-reload-0.8.5.diff](st-background-image-signal-reload-0.8.5.diff)
     46 
     47 If you use the [xresources with signal reloading](//st.suckless.org/patches/xresources-with-reload-signal)
     48 patch ignore the patch above and simply add these two lines to the beginning of
     49 the `reload` function located in the file `x.c`:
     50 
     51 	XFreeGC(xw.dpy, xw.bggc);
     52 	bginit();
     53 
     54 *Hint*: You can send a USR1 signal to all st processes with the following
     55 command:
     56 
     57 	pidof st | xargs kill -s USR1
     58 
     59 Authors
     60 -------
     61 * Matthias Schoth - <mschoth@gmail.com>
     62