picom/man/compton.1

150 lines
3.9 KiB
Groff
Raw Normal View History

2004-09-09 11:27:16 +08:00
.ds q \N'34'
2011-11-07 08:20:45 +08:00
.TH compton 1
2004-09-09 11:27:16 +08:00
.SH NAME
2011-11-07 08:20:45 +08:00
compton \- a compositor for X11
2004-09-09 11:27:16 +08:00
.SH SYNOPSIS
.B compton
[\-d display] [\-r radius] [\-o opacity] [\-l left\-offset]
[\-t top\-offset] [\-i opacity] [\-e opacity] [\-cCfFSdG]
[\-\-config path] [\-\-shadow\-red value]
[\-\-shadow\-green value] [\-\-shadow\-blue value]
[\-\-inactive\-opacity\-override] [\-\-inactive\-dim value]
[\-\-mark\-wmwin\-focused] [\-\-shadow\-exclude condition]
[\-\-mark\-ovredir\-focused] [\-\-no\-fading\-openclose]
[\-\-shadow\-ignore\-shaped] [\-\-detect\-round\-corners]
2004-09-09 11:27:16 +08:00
.SH DESCRIPTION
2011-11-07 08:20:45 +08:00
.B compton
is a compositor based on Dana Jansens' version of xcompmgr (which itself was
written by Keith Packard). It includes many improvements over the original
xcompmgr, including window frame opacity, inactive window transparency,
and shadows on argb windows.
2004-09-09 11:27:16 +08:00
.SH OPTIONS
.TP
2004-09-10 13:55:19 +08:00
.BI \-d\ display
2012-10-22 20:41:24 +08:00
Which display should be managed.
2004-09-10 13:55:19 +08:00
.TP
.BI \-r\ radius
2012-10-22 20:41:24 +08:00
The blur radius for shadows. (default 12)
.TP
.BI \-o\ opacity
2012-10-22 20:41:24 +08:00
The translucency for shadows. (default .75)
.TP
.BI \-l\ left-offset
2012-10-22 20:41:24 +08:00
The left offset for shadows. (default -15)
.TP
.BI \-t\ top-offset
2012-10-22 20:41:24 +08:00
The top offset for shadows. (default -15)
.TP
.BI \-I\ fade-in-step
2012-10-22 20:41:24 +08:00
Opacity change between steps while fading in. (default 0.028)
.TP
.BI \-O\ fade-out-step
2012-10-22 20:41:24 +08:00
Opacity change between steps while fading out. (default 0.03)
.TP
2012-10-22 20:41:24 +08:00
.BI \-D\ fade-delta-time
The time between steps in a fade in milliseconds. (default 10)
.TP
2012-10-22 20:41:24 +08:00
.BI \-m\ opacity
The opacity for menus. (default 1.0)
2004-09-09 11:27:16 +08:00
.TP
2012-10-22 20:41:24 +08:00
.BI \-c
Enabled client-side shadows on windows.
2004-09-09 11:27:16 +08:00
.TP
2004-09-10 13:55:19 +08:00
.BI \-C
2012-10-22 20:41:24 +08:00
Avoid drawing shadows on dock/panel windows.
2004-09-10 13:55:19 +08:00
.TP
2012-10-22 20:41:24 +08:00
.BI \-z
Zero the part of the shadow's mask behind the window (experimental).
2012-02-27 00:35:17 +08:00
.TP
2012-10-22 20:41:24 +08:00
.BI \-f
Fade windows in/out when opening/closing and when opacity
changes, unless --no-fading-openclose is used.
2004-09-10 13:55:19 +08:00
.TP
2012-10-22 20:41:24 +08:00
.BI \-F
Equals -f. Deprecated.
2012-02-27 01:02:42 +08:00
.TP
2011-11-07 08:20:45 +08:00
.BI \-i\ opacity
2012-10-22 20:41:24 +08:00
Opacity of inactive windows. (0.1 - 1.0)
2011-11-07 08:20:45 +08:00
.TP
.BI \-e\ opacity
2012-10-22 20:41:24 +08:00
Opacity of window titlebars and borders. (0.1 - 1.0)
.TP
.BI \-G
Don't draw shadows on DND windows
.TP
.BI \-b
2012-10-22 20:41:24 +08:00
Daemonize process.
2011-11-07 08:20:45 +08:00
.TP
2004-09-10 13:55:19 +08:00
.BI \-S
2012-10-22 20:41:24 +08:00
Enable synchronous operation (for debugging).
.TP
.BI \--config\ path
Look for configuration file at the path.
.TP
.BI \--shadow-red\ value
Red color value of shadow (0.0 - 1.0, defaults to 0).
.TP
.BI \--shadow-green\ value
Green color value of shadow (0.0 - 1.0, defaults to 0).
.TP
.BI \--shadow-blue\ value
Blue color value of shadow (0.0 - 1.0, defaults to 0).
.TP
.BI \--inactive-opacity-override
Inactive opacity set by -i overrides value of _NET_WM_OPACITY.
.TP
.BI \--inactive-dim\ value
Dim inactive windows. (0.0 - 1.0, defaults to 0)
.TP
.BI \--mark-wmwin-focused
Try to detect WM windows and mark them as active.
.TP
.BI \--shadow-exclude\ condition
Exclude conditions for shadows.
.TP
.BI \--mark-ovredir-focused
Mark over-redirect windows as active.
.TP
.BI \--no-fading-openclose
Do not fade on window open/close.
.TP
.BI \--shadow-ignore-shaped
Do not paint shadows on shaped windows.
.TP
.BI \--detect-rounded-corners
Try to detect windows with rounded corners and don't consider
them shaped windows.
.TP
.BI Format\ of\ a\ condition:
condition = <target>:<type>[<flags>]:<pattern>
<target> is one of "n" (window name), "i" (window class
instance), and "g" (window general class)
<type> is one of "e" (exact match), "a" (match anywhere),
"s" (match from start), "w" (wildcard), and "p" (PCRE
regular expressions, if compiled with the support).
<flags> could be a series of flags. Currently the only defined
flag is "i" (ignore case).
<pattern> is the actual pattern string.
2004-09-09 11:27:16 +08:00
.SH BUGS
2011-11-07 12:03:18 +08:00
Please report any you find to https://github.com/chjj/compton.
2004-09-09 11:27:16 +08:00
.SH AUTHORS
2011-11-07 12:03:18 +08:00
xcompmgr, originally written by Keith Packard, with contributions from
2011-11-07 08:20:45 +08:00
Matthew Allum, Eric Anholt, Dan Doel, Thomas Luebking, Matthew Hawn,
Ely Levy, Phil Blundell, and Carl Worth.
2012-10-22 20:41:24 +08:00
Compton by Christopher Jeffrey, based on Dana Jansens' original work,
with numerous contributions from Richard Grenville.
.SH SEE ALSO
.BR compton-trans (1)