122 lines
2.6 KiB
Groff
122 lines
2.6 KiB
Groff
.\" Original author: Hyriand <hyriand@thegraveyard.org> (2003)
|
|
.\" Updated by Martin Hradil (2019)
|
|
.\" License: GPL version 2
|
|
.TH HSETROOT 1 "2019-11-18" "1.0.5" "imlib2-based wallpaper changer"
|
|
|
|
.SH NAME
|
|
hsetroot \- imlib2-based wallpaper changer
|
|
|
|
.SH SYNOPSIS
|
|
.B hsetroot
|
|
.RI [command1 [arg1..]] [command2 [arg1..]]...
|
|
|
|
.SH DESCRIPTION
|
|
.B hsetroot
|
|
is a tool which allows you to compose wallpapers ("root pixmaps")
|
|
for X. It has a lot of options like rendering gradients, solids and images
|
|
and manipulate these in various ways. hsetroot also supports alpha-channels.
|
|
|
|
.B hsetroot
|
|
is using XSetWindowBackgroundPixmap instead of XSetWindowBackground also for
|
|
solid colors. This makes it a good
|
|
.B xsetroot
|
|
replacement when a compositor (compton, xcompmgr, ...) is in use.
|
|
|
|
Colors are in the #rgb, #rrggbb, #rrggbbaa, rgb:1/2/3 formats or a X color name.
|
|
|
|
.SH GENERIC OPTIONS
|
|
.TP
|
|
.B \-root
|
|
Treat multiple displays as one big screen (ignore xrandr outputs)
|
|
.TP
|
|
.B \-screens <int>
|
|
Set a screenmask to use
|
|
|
|
.SH GRADIENTS
|
|
.TP
|
|
.B \-add <color>
|
|
Add color to range using distance 1
|
|
.TP
|
|
.B \-addd <color> <distance>
|
|
Add color to range using custom distance
|
|
.TP
|
|
.B \-gradient <angle>
|
|
Render gradient using specified angle
|
|
.TP
|
|
.B \-clear
|
|
Clear the color range
|
|
|
|
.SH SOLID COLOR
|
|
.TP
|
|
.B \-solid <color>
|
|
Render a solid using the specified color
|
|
|
|
.SH IMAGE FILES
|
|
.TP
|
|
.B \-center <image>
|
|
Render an image centered on screen
|
|
.TP
|
|
.B \-cover <image>
|
|
Render an image centered on screen scaled to fill the screen fully
|
|
.TP
|
|
.B \-tile <image>
|
|
Render an image tiled
|
|
.TP
|
|
.B \-full <image>
|
|
Render an image maximum aspect
|
|
.TP
|
|
.B \-extend <image>
|
|
Render an image max aspect and fill borders
|
|
.TP
|
|
.B \-fill <image>
|
|
Render an image stretched
|
|
|
|
.SH IMAGE MANIPULATION:
|
|
.TP
|
|
.B \-tint <color>
|
|
Tint the current image
|
|
.TP
|
|
.B \-blur <radius>
|
|
Blur the current image
|
|
.TP
|
|
.B \-sharpen <radius>
|
|
Sharpen the current image
|
|
.TP
|
|
.B \-contrast <amount>
|
|
Adjust contrast of current image
|
|
.TP
|
|
.B \-brightness <amount>
|
|
Adjust brightness of current image
|
|
.TP
|
|
.B \-gamma <amount>
|
|
Adjust gamma level of current image
|
|
.TP
|
|
.B \-flipv
|
|
Flip the current image vertically
|
|
.TP
|
|
.B \-fliph
|
|
Flip the current image horizontally
|
|
.TP
|
|
.B \-flipd
|
|
Flip the current image diagonally
|
|
|
|
.SH MISC
|
|
.TP
|
|
.B \-alpha <amount>
|
|
Adjust alpha level for colors and images
|
|
.TP
|
|
.B \-write <filename>
|
|
Write current image to file
|
|
|
|
.SH SEE ALSO
|
|
.BR xsetroot (1)
|
|
.BR XSetWindowBackgroundPixmap (3)
|
|
.BR xcompmgr (1)
|
|
|
|
.SH AUTHOR
|
|
hsetroot was written by Hyriand <hyriand@thegraveyard.org> in 2003.
|
|
Martin Hradil updated it in 2019.
|
|
.PP
|
|
This manual page was written by Stefan Hagen
|
|
<sh+ports@codevoid.de>, for the OpenBSD project (but may be used by others).
|