index.md - sites - public wiki contents of suckless.org
 (HTM) git clone git://git.suckless.org/sites
 (DIR) Log
 (DIR) Files
 (DIR) Refs
       ---
       index.md (2033B)
       ---
            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 `bgfile` (patch modifies `config.def.h`, changes made there need to be ported to
           14 `config.h` if it already exists). The image format is expected to be
           15 [farbfeld](//tools.suckless.org/farbfeld). In case the background image 
           16 is smaller than the window size the background will be tiled.
           17 
           18 Pseudo Transparency
           19 -------------------
           20 
           21 The variable `pseudotransparency` enables functionality which fixes the 
           22 coordinates of the background image to the screen origin. This emulates the 
           23 effect of transparency without the need for an *X composite manager*.
           24 
           25 *Hint*: With the use of [farbfeld utilities](http://zzo38computer.org/fossil/farbfeld.ui/) 
           26 effects can be applied to the desktop background in an automated fashion. 
           27 Pictured below is an example of the result of a darken and blur operation 
           28 invoked with the following command:
           29 
           30         jpg2ff < wallpaper.jpg | ff-border e 50 | ff-bright rgba 0 0.5 1 | ff-blur 50 15 > st_wallpaper.ff
           31 
           32 ![Screenshot](pseudo-transparency.png)
           33 
           34 Download
           35 --------
           36 
           37 * [st-background-image-0.8.4.diff](st-background-image-0.8.4.diff)
           38 * [st-background-image-0.8.5.diff](st-background-image-0.8.5.diff)
           39 
           40 Signal Reloading
           41 ----------------
           42 
           43 Apply the following patch on top of the previous to enable reloading the
           44 background image when a USR1 signal occurs:
           45 
           46 * [st-background-image-signal-reload-0.8.5.diff](st-background-image-signal-reload-0.8.5.diff)
           47 
           48 If you use the [xresources with signal reloading](//st.suckless.org/patches/xresources-with-reload-signal)
           49 patch ignore the patch above and simply add these two lines to the beginning of
           50 the `reload` function located in the file `x.c`:
           51 
           52         XFreeGC(xw.dpy, xw.bggc);
           53         bginit();
           54 
           55 *Hint*: You can send a USR1 signal to all st processes with the following
           56 command:
           57 
           58         pidof st | xargs kill -s USR1
           59 
           60 Authors
           61 -------
           62 * Matthias Schoth - <mschoth@gmail.com>
           63