2001-12-11 20:47:02 +00:00
|
|
|
.\"
|
|
|
|
|
.\" Man page for Bsetroot
|
|
|
|
|
.\"
|
|
|
|
|
.\" Copyright (c) 2000 by Wilbert Berendsen <wbsoft@xs4all.nl>
|
2004-06-29 13:41:59 +00:00
|
|
|
.\" Copyright (c) 2004 by Curt "Asenchi" Micol <asenchi@asenchi.com>
|
|
|
|
|
.\"
|
|
|
|
|
.\" This page was updated for Fluxbox by Curt "Asenchi" Micol on June 25, 2004
|
2001-12-11 20:47:02 +00:00
|
|
|
.\"
|
2004-06-07 22:44:19 +00:00
|
|
|
.\" Permission to use, copy, modify, and distribute this documentation for
|
|
|
|
|
.\" any purpose with or without fee is hereby granted, provided that the
|
|
|
|
|
.\" above copyright notice and this permission notice appear in all copies.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THE DOCUMENTATION IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
|
|
|
|
|
.\" WARRANTIES WITH REGARD TO THIS DOCUMENTATION INCLUDING ALL IMPLIED
|
|
|
|
|
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
|
|
|
|
|
.\" AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
|
|
|
|
|
.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
|
|
|
|
|
.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
|
|
|
.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
|
|
|
.\" PERFORMANCE OF THIS DOCUMENTATION
|
|
|
|
|
.\"
|
2004-06-29 13:41:59 +00:00
|
|
|
.TH bsetroot 1 "June 25th, 2004" "0.60.3"
|
2001-12-11 20:47:02 +00:00
|
|
|
.SH NAME
|
2004-06-29 13:41:59 +00:00
|
|
|
bsetroot \- a simple background utility used by the Fluxbox window manager, ori
|
|
|
|
|
ginally written
|
|
|
|
|
for and by the original Blackbox window manager team.
|
2001-12-11 20:47:02 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.BR bsetroot " \-help"
|
|
|
|
|
.br
|
|
|
|
|
.B bsetroot
|
|
|
|
|
.RI "[ \-display " display " ] \-solid " color
|
|
|
|
|
.br
|
|
|
|
|
.B bsetroot
|
|
|
|
|
.RI "[ \-display " display " ] \-mod " "x y" " \-fg " color " \-bg " color
|
|
|
|
|
.br
|
|
|
|
|
.B bsetroot
|
|
|
|
|
.RI "[ \-display " display " ] \-gradient " texture " \-from " color " \-to " color
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
Bsetroot is a utility that can control the appearance of the root window in
|
|
|
|
|
three ways: Either give it a solid color, or write a two color modula pattern
|
|
|
|
|
to it, or render a gradient texture, based on two different colors.
|
|
|
|
|
.PP
|
|
|
|
|
Bsetroot resembles
|
|
|
|
|
.IR xsetroot (1)
|
|
|
|
|
in this functionality but it supports multiple screen displays, and gradient
|
2004-06-29 13:41:59 +00:00
|
|
|
textures the same way as Blackbox or Fluxbox does.
|
2001-12-11 20:47:02 +00:00
|
|
|
It doesn't handle cursors etc.
|
2004-06-29 13:41:59 +00:00
|
|
|
Bsetroot was originally part of the Blackbox package and was carried over with
|
|
|
|
|
the code that became Fluxbox.
|
2001-12-11 20:47:02 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
|
Bsetroot operates in three ways, you must choose one of the first 3 options:
|
|
|
|
|
.TP
|
|
|
|
|
.BI \-solid " color"
|
|
|
|
|
Sets the root window to specified color.
|
|
|
|
|
.TP
|
|
|
|
|
.BI \-mod " x y"
|
|
|
|
|
Creates a modula pattern. You must specify
|
|
|
|
|
.BR \-bg " and " \-fg
|
|
|
|
|
colors.
|
|
|
|
|
.TP
|
|
|
|
|
.BI \-gradient " texturestring"
|
|
|
|
|
Renders the specified texture string to the root window.
|
2004-06-29 13:41:59 +00:00
|
|
|
.RS
|
|
|
|
|
.PP
|
|
|
|
|
.I texturestring
|
|
|
|
|
may be one of:
|
|
|
|
|
.PP
|
|
|
|
|
.B Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic / Rectangle / Pyramid
|
|
|
|
|
.PP
|
|
|
|
|
Select one of these texture types, they only apply when
|
|
|
|
|
.B \-gradient
|
|
|
|
|
is specifed. You must also specify both a
|
2001-12-11 20:47:02 +00:00
|
|
|
.BR \-from " and a " \-to
|
|
|
|
|
color.
|
2004-06-29 13:41:59 +00:00
|
|
|
.RE
|
2001-12-11 20:47:02 +00:00
|
|
|
.TP
|
|
|
|
|
.BI \-display " display"
|
|
|
|
|
Tells Bsetroot to connect to the specified display.
|
|
|
|
|
.TP
|
|
|
|
|
.BI "\-bg, \-background " color
|
|
|
|
|
Background color.
|
|
|
|
|
Needed for
|
|
|
|
|
.B \-mod
|
|
|
|
|
patterns.
|
|
|
|
|
.TP
|
|
|
|
|
.BI "\-fg, \-foreground " color
|
|
|
|
|
Foreground color.
|
|
|
|
|
Needed for
|
|
|
|
|
.B \-mod
|
|
|
|
|
patterns.
|
|
|
|
|
.TP
|
|
|
|
|
.BI \-from " color"
|
|
|
|
|
Start color for rendering textures.
|
|
|
|
|
Needed for
|
|
|
|
|
.B \-gradient
|
|
|
|
|
operation mode.
|
|
|
|
|
.TP
|
|
|
|
|
.BI \-to " color"
|
|
|
|
|
Ending color for rendering textures.
|
|
|
|
|
Needed for
|
|
|
|
|
.B \-gradient
|
|
|
|
|
operation mode.
|
|
|
|
|
.TP
|
|
|
|
|
.B \-help
|
|
|
|
|
Prints version info and short help text.
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
Bsetroot is written and maintained by Brad Hughes
|
|
|
|
|
.nh \" hyphenation off
|
|
|
|
|
(blackbox@alug.org)
|
|
|
|
|
.hy \" on again
|
|
|
|
|
and Jeff Raven
|
|
|
|
|
.nh
|
|
|
|
|
(jraven@psu.edu).
|
2004-06-29 13:41:59 +00:00
|
|
|
.PP
|
|
|
|
|
This manpage was modified by Curt "Asenchi" Micol <asenchi@asenchi.com> for
|
|
|
|
|
the Fluxbox window manager.
|
2001-12-11 20:47:02 +00:00
|
|
|
.hy
|
|
|
|
|
.SH SEE ALSO
|
2004-06-29 13:41:59 +00:00
|
|
|
.IR fluxbox (1)
|
|
|
|
|
.IR fbsetbg (1)
|
