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