sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | 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