t* My OpenBSD ports
       
   URI git clone git://git.codevoid.de/mystuff.git
   DIR Log
   DIR Files
   DIR Refs
       ---
       thsetroot.1 (2664B)
       ---
            1 .\" Original author: Hyriand <hyriand@thegraveyard.org> (2003)
            2 .\" Updated by Martin Hradil (2019)
            3 .\" License: GPL version 2
            4 .TH HSETROOT 1 "2019-11-18" "1.0.5" "imlib2-based wallpaper changer"
            5 
            6 .SH NAME
            7 hsetroot \- imlib2-based wallpaper changer
            8 
            9 .SH SYNOPSIS
           10 .B hsetroot 
           11 .RI [command1 [arg1..]] [command2 [arg1..]]...
           12 
           13 .SH DESCRIPTION
           14 .B hsetroot
           15 is a tool which allows you to compose wallpapers ("root pixmaps")
           16 for X. It has a lot of options like rendering gradients, solids and images
           17 and manipulate these in various ways. hsetroot also supports alpha-channels.
           18 
           19 .B hsetroot
           20 is using XSetWindowBackgroundPixmap instead of XSetWindowBackground also for
           21 solid colors. This makes it a good 
           22 .B xsetroot
           23 replacement when a compositor (compton, xcompmgr, ...) is in use.
           24 
           25 Colors are in the #rgb, #rrggbb, #rrggbbaa, rgb:1/2/3 formats or a X color name.
           26 
           27 .SH GENERIC OPTIONS
           28 .TP
           29 .B \-root
           30 Treat multiple displays as one big screen (ignore xrandr outputs)
           31 .TP
           32 .B \-screens <int>
           33 Set a screenmask to use
           34 
           35 .SH GRADIENTS
           36 .TP
           37 .B \-add <color>
           38 Add color to range using distance 1
           39 .TP
           40 .B \-addd <color> <distance>
           41 Add color to range using custom distance
           42 .TP
           43 .B \-gradient <angle>
           44 Render gradient using specified angle
           45 .TP
           46 .B \-clear
           47 Clear the color range
           48 
           49 .SH SOLID COLOR
           50 .TP
           51 .B \-solid <color>
           52 Render a solid using the specified color
           53 
           54 .SH IMAGE FILES
           55 .TP
           56 .B \-center <image>
           57 Render an image centered on screen
           58 .TP
           59 .B \-cover <image>
           60 Render an image centered on screen scaled to fill the screen fully
           61 .TP
           62 .B \-tile <image>
           63 Render an image tiled
           64 .TP
           65 .B \-full <image>
           66 Render an image maximum aspect
           67 .TP
           68 .B \-extend <image>
           69 Render an image max aspect and fill borders
           70 .TP
           71 .B \-fill <image>
           72 Render an image stretched
           73 
           74 .SH IMAGE MANIPULATION:
           75 .TP
           76 .B \-tint <color>
           77 Tint the current image
           78 .TP
           79 .B \-blur <radius>
           80 Blur the current image
           81 .TP
           82 .B \-sharpen <radius>
           83 Sharpen the current image
           84 .TP
           85 .B \-contrast <amount>
           86 Adjust contrast of current image
           87 .TP
           88 .B \-brightness <amount>
           89 Adjust brightness of current image
           90 .TP
           91 .B \-gamma <amount>
           92 Adjust gamma level of current image
           93 .TP
           94 .B \-flipv
           95 Flip the current image vertically
           96 .TP
           97 .B \-fliph
           98 Flip the current image horizontally
           99 .TP
          100 .B \-flipd
          101 Flip the current image diagonally
          102 
          103 .SH MISC
          104 .TP
          105 .B \-alpha <amount>
          106 Adjust alpha level for colors and images
          107 .TP
          108 .B \-write <filename>
          109 Write current image to file
          110 
          111 .SH SEE ALSO
          112 .BR xsetroot (1)
          113 .BR XSetWindowBackgroundPixmap (3)
          114 .BR xcompmgr (1)
          115 
          116 .SH AUTHOR
          117 hsetroot was written by Hyriand <hyriand@thegraveyard.org> in 2003. 
          118 Martin Hradil updated it in 2019.
          119 .PP
          120 This manual page was written by Stefan Hagen
          121 <sh+ports[at]codevoid[dot]de>, for the OpenBSD project (but may be used by others).