Improvement: Use select() for main loop
- Back to using select() for main loop. Thus we are not longer relying on libevent. - Add generic timeout system (untested) to prepare for D-Bus support. - Drop troff man pages. Revise Makefile to improve documentation building, fix double LDFLAGS inclusion, and re-add -lrt. This turns asciidoc into a build time dependency. - Change fading time calculation. - Add --logpath and ostream_reopen() for debugging with -b. - Drop unused lceil_ntimes() and other helper functions. - Only very limited tests are done. Bugs to be expected.
This commit is contained in:
Richard Grenville
@ -1,68 +0,0 @@
|
||||
.ds q \N'34'
|
||||
.TH compton\-trans 1
|
||||
|
||||
.SH NAME
|
||||
compton\-trans \- an opacity setter tool
|
||||
|
||||
.SH SYNOPSIS
|
||||
.nf
|
||||
.B compton-trans [-w WINDOW_ID] [-n WINDOW_NAME] [-c] [-s] OPACITY
|
||||
.fi
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B compton-trans
|
||||
is a bash script that sets _NET_WM_WINDOW_OPACITY only using standard
|
||||
command-line utilities for X11, including xprop(1) and xwininfo(1).
|
||||
It is similar to other utilities like transset(1) or transset-df(1).
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.BI \-w\ window\-id
|
||||
Specify the window id to target.
|
||||
.TP
|
||||
.BI \-n\ window\-name
|
||||
Specify and try to match a window name.
|
||||
.TP
|
||||
.BI \-c
|
||||
Specify the current window as a target.
|
||||
.TP
|
||||
.BI \-s
|
||||
Select target window with mouse cursor.
|
||||
This is the default if no window has been specified.
|
||||
.TP
|
||||
.BI \-o\ opacity
|
||||
Specify the new opacity value for the window. This value
|
||||
can be anywhere from 1-100. If it is prefixed with a plus
|
||||
or minus (+/-), this will increment or decrement from the
|
||||
target window's current opacity instead.
|
||||
|
||||
.SH EXAMPLES
|
||||
.TP
|
||||
Set window id to opacity of 75%.
|
||||
compton-trans -w "$WINDOWID" 75
|
||||
.TP
|
||||
Set window name, "urxvt", to opacity of 75%.
|
||||
compton-trans -n "urxvt" 75
|
||||
.TP
|
||||
Set current window to opacity of 75%.
|
||||
compton-trans -c 75
|
||||
.TP
|
||||
Select target window and set opacity to 75%.
|
||||
compton-trans -s 75
|
||||
.TP
|
||||
Increment current window opacity by 5%.
|
||||
compton-trans -c +5
|
||||
.TP
|
||||
Decrement current window opacity by 5%.
|
||||
compton-trans -c -- -5
|
||||
|
||||
.SH BUGS
|
||||
Please report any you find to https://github.com/chjj/compton.
|
||||
|
||||
.SH AUTHORS
|
||||
Christopher Jeffrey (https://github.com/chjj)
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR compton(1),
|
||||
.BR xprop(1),
|
||||
.BR xwininfo(1)
|
||||
177
man/compton.1
177
man/compton.1
@ -1,177 +0,0 @@
|
||||
.ds q \N'34'
|
||||
.TH compton 1
|
||||
|
||||
.SH NAME
|
||||
compton \- a compositor for X11
|
||||
|
||||
.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]
|
||||
|
||||
.SH DESCRIPTION
|
||||
.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.
|
||||
|
||||
.SH EXAMPLE
|
||||
|
||||
$ compton -cC -i 0.6 -e 0.6 -f
|
||||
|
||||
$ compton --config ~/compton.conf
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.BI \-d\ display
|
||||
Which display should be managed.
|
||||
.TP
|
||||
.BI \-r\ radius
|
||||
The blur radius for shadows. (default 12)
|
||||
.TP
|
||||
.BI \-o\ opacity
|
||||
The translucency for shadows. (default .75)
|
||||
.TP
|
||||
.BI \-l\ left\-offset
|
||||
The left offset for shadows. (default -15)
|
||||
.TP
|
||||
.BI \-t\ top\-offset
|
||||
The top offset for shadows. (default -15)
|
||||
.TP
|
||||
.BI \-I\ fade\-in\-step
|
||||
Opacity change between steps while fading in. (default 0.028)
|
||||
.TP
|
||||
.BI \-O\ fade\-out\-step
|
||||
Opacity change between steps while fading out. (default 0.03)
|
||||
.TP
|
||||
.BI \-D\ fade\-delta\-time
|
||||
The time between steps in a fade in milliseconds. (default 10)
|
||||
.TP
|
||||
.BI \-m\ opacity
|
||||
The opacity for menus. (default 1.0)
|
||||
.TP
|
||||
.BI \-c
|
||||
Enabled client-side shadows on windows.
|
||||
.TP
|
||||
.BI \-C
|
||||
Avoid drawing shadows on dock/panel windows.
|
||||
.TP
|
||||
.BI \-z
|
||||
Zero the part of the shadow's mask behind the window (experimental).
|
||||
.TP
|
||||
.BI \-f
|
||||
Fade windows in/out when opening/closing and when opacity
|
||||
changes, unless --no-fading-openclose is used.
|
||||
.TP
|
||||
.BI \-F
|
||||
Equals -f. Deprecated.
|
||||
.TP
|
||||
.BI \-i\ opacity
|
||||
Opacity of inactive windows. (0.1 - 1.0)
|
||||
.TP
|
||||
.BI \-e\ opacity
|
||||
Opacity of window titlebars and borders. (0.1 - 1.0)
|
||||
.TP
|
||||
.BI \-G
|
||||
Don't draw shadows on DND windows
|
||||
.TP
|
||||
.BI \-b
|
||||
Daemonize/background process.
|
||||
.TP
|
||||
.BI \-S
|
||||
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.
|
||||
|
||||
.SH CONFIGURATION
|
||||
(A more robust sample configuration file exists in the compton
|
||||
repository.)
|
||||
|
||||
.B Example
|
||||
|
||||
.B ~/compton.conf:
|
||||
|
||||
# Shadows
|
||||
shadow = true;
|
||||
|
||||
# Opacity
|
||||
inactive-opacity = 0.8;
|
||||
frame-opacity = 0.7;
|
||||
|
||||
# Fades
|
||||
fading = true;
|
||||
|
||||
.B Run with:
|
||||
|
||||
$ compton --config ~/compton.conf
|
||||
|
||||
.SH BUGS
|
||||
Please report any you find to https://github.com/chjj/compton.
|
||||
|
||||
.SH AUTHORS
|
||||
xcompmgr, originally written by Keith Packard, with contributions from
|
||||
Matthew Allum, Eric Anholt, Dan Doel, Thomas Luebking, Matthew Hawn,
|
||||
Ely Levy, Phil Blundell, and Carl Worth.
|
||||
Compton by Christopher Jeffrey, based on Dana Jansens' original work,
|
||||
with numerous contributions from Richard Grenville.
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR compton-trans(1)
|
||||
Reference in New Issue
Block a user