mystuff/security/qtpass/files/hsetroot.1
2023-01-10 11:45:28 +01:00

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).