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  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