150 lines
5.2 KiB
HTML
150 lines
5.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XSETROOT</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XSETROOT</H1>
|
|
Section: User Commands (1)<BR>Updated: xsetroot 1.1.2<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xsetroot - root window parameter setting utility for X
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xsetroot</B>
|
|
|
|
[-help]
|
|
[-version]
|
|
[-def]
|
|
[-display <I>display</I>]
|
|
[-cursor <I>cursorfile maskfile</I>]
|
|
[-cursor_name <I>cursorfontname</I>]
|
|
[-xcf <I>cursorfile</I> <I>cursorsize</I>]
|
|
[-bitmap <I>filename</I>
|
|
| -mod <I>x y</I>
|
|
| -gray
|
|
| -grey
|
|
| -solid <I>color</I>]
|
|
[-bg <I>color</I>]
|
|
[-fg <I>color</I>]
|
|
[-rv]
|
|
[-name <I>string</I>]
|
|
[-d <I>display</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<I>xsetroot</I>
|
|
|
|
program
|
|
allows you to tailor the appearance of the background ("root")
|
|
window on a workstation display running X. Normally, you experiment with
|
|
<I>xsetroot</I>
|
|
|
|
until you find a personalized look that you like, then put the
|
|
<I>xsetroot</I>
|
|
|
|
command that produces it into your X startup file.
|
|
If no options are specified, or if
|
|
<I>-def</I>
|
|
|
|
is specified, the window is reset to its default state. The
|
|
<I>-def</I>
|
|
|
|
option can be specified along with other options and only the non-specified
|
|
characteristics will be reset to the default state.
|
|
<P>
|
|
|
|
Only one of the background color/tiling changing options
|
|
(-solid, -gray, -grey, -bitmap, and -mod) may be specified at a time.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
The various options are as follows:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-help</B><DD>
|
|
Print a usage message and exit.
|
|
<DT id="2"><B>-version</B><DD>
|
|
Print a version message and exit.
|
|
<DT id="3"><B>-def, -default</B><DD>
|
|
Reset unspecified attributes to the default values. (Restores the background
|
|
to the familiar gray mesh and the cursor to the hollow x shape.)
|
|
<DT id="4"><B>-cursor</B> <I>cursorfile</I> <I>maskfile</I><DD>
|
|
This lets you change the pointer cursor to whatever
|
|
you want when the pointer cursor is outside of any window.
|
|
Cursor and mask files are bitmaps (little pictures), and can be made with the
|
|
<I><A HREF="/cgi-bin/man/man2html?1+bitmap">bitmap</A>(1)</I>
|
|
|
|
program. You probably want the mask file to be all black until you
|
|
get used to the way masks work.
|
|
<DT id="5"><B>-cursor_name</B> <I>cursorfontname</I><DD>
|
|
This lets you change the pointer cursor to one of the standard
|
|
cursors from the cursor font. Refer to appendix B of the X protocol for
|
|
the names (except that the XC_ prefix is elided for this option).
|
|
<DT id="6"><B>-xcf</B> <I>cursorfile</I> <I>cursorsize</I><DD>
|
|
This lets you change the pointer cursor to one loaded from an Xcursor file
|
|
as defined by libXcursor, at the specified size.
|
|
<DT id="7"><B>-bitmap</B> <I>filename</I><DD>
|
|
Use the bitmap specified in the file to set the window pattern. You can
|
|
make your own bitmap files (little pictures) using the
|
|
<I><A HREF="/cgi-bin/man/man2html?1+bitmap">bitmap</A>(1)</I>
|
|
|
|
program. The entire background will be made up of repeated "tiles" of
|
|
the bitmap.
|
|
<DT id="8"><B>-mod</B> <I>x</I> <I>y</I><DD>
|
|
This is used if you want a plaid-like grid pattern on your screen.
|
|
x and y are integers ranging from 1 to 16. Try the different combinations.
|
|
Zero and negative numbers are taken as 1.
|
|
<DT id="9"><B>-gray, -grey</B><DD>
|
|
Make the entire background gray (Easier on the eyes).
|
|
<DT id="10"><B>-bg, -background</B> <I>color</I><DD>
|
|
Use ``color'' as the background color.
|
|
<DT id="11"><B>-fg, -foreground</B> <I>color</I><DD>
|
|
Use ``color'' as the foreground color. Foreground and background colors
|
|
are meaningful only in combination with -cursor, -bitmap, or -mod.
|
|
<DT id="12"><B>-rv, -reverse</B><DD>
|
|
This exchanges the foreground and background colors. Normally the foreground
|
|
color is black and the background color is white.
|
|
<DT id="13"><B>-solid</B> <I>color</I><DD>
|
|
This sets the background of the root window to the specified color. This
|
|
option is only useful on color servers.
|
|
<DT id="14"><B>-name</B> <I>string</I><DD>
|
|
Set the name of the root window to ``string''. There is no default value.
|
|
Usually a name is assigned to a window so that the
|
|
window manager can use a text representation when the window is iconified.
|
|
This option is unused since you can't iconify the background.
|
|
<DT id="15"><B>-d, -display</B> <I>display</I><DD>
|
|
Specifies the server to connect to; see <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I>.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+xset">xset</A>(1), <A HREF="/cgi-bin/man/man2html?1+xrdb">xrdb</A>(1), <A HREF="/cgi-bin/man/man2html?3+Xcursor">Xcursor</A>(3)
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Mark Lillibridge, MIT Project Athena
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="17"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="18"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="19"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="20"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="21"><A HREF="#lbAG">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|