diff options
author | Mattias Andrée <maandree@kth.se> | 2016-12-01 10:29:15 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2016-12-01 10:29:15 +0100 |
commit | 375f7fa038400d2a89fc72898d452791ed0d1248 (patch) | |
tree | 71b4a0995a6fb7cb0e305d3c143884687cfcab9c | |
parent | m (diff) | |
download | cg-tools-375f7fa038400d2a89fc72898d452791ed0d1248.tar.gz cg-tools-375f7fa038400d2a89fc72898d452791ed0d1248.tar.bz2 cg-tools-375f7fa038400d2a89fc72898d452791ed0d1248.tar.xz |
Add cg-limits.1
Signed-off-by: Mattias Andrée <maandree@kth.se>
-rw-r--r-- | man/cg-limits.1 | 131 | ||||
-rw-r--r-- | src/cg-limits.c | 2 |
2 files changed, 132 insertions, 1 deletions
diff --git a/man/cg-limits.1 b/man/cg-limits.1 new file mode 100644 index 0000000..49cbe4d --- /dev/null +++ b/man/cg-limits.1 @@ -0,0 +1,131 @@ +.TH CG-LIMITS 1 CG-TOOLS +.SH NAME +cg-limits - Adjust the brightness and contrast on the monitors +.SH SYNOPSIS +.B cg-limits +.RB [ \-M +.IR method ] +.RB [ \-S +.IR site ] +.RB [ \-c +.IR crtc "]... ["\fB\-R\fP +.IR rule ] +.RB ( \-x +| +.RB [ \-p +.IR priority ] +.RB [ \-d ] +.RB ([ \-B +.IR brightness-file ] +.RB [ \-C +.IR contrast-file ] +| +.IB brightness-all : contrast-all +| +.IB brightness-red : contrast-red +.IB brightness-green : contrast-green +.IR brightness-blue \fB:\fP contrast-blue )) +.SH DESCRIPTION +.B cg-limits +sets the brightness (the brightness of black) on the monitors to +.I brightness-all +and the contrast (the brightness of white) on the monitors to +.I contrast-all +on all channels, or the brightness to +.IR brightness-red , +.IR brightness-green , +and +.I brightness-blue +to the red, green, and blue channels, respectively, and the +contrasts to +.IR contrast-red , +.IR contrast-green , +and +.IR contrast-blue . +Alternatively, +.B cg-limits +can change the brightness on each monitor independently by +using reading the values from +.I brightness-file +and the contrast on each monitor independently by +using reading the values from +.I contrast-file +or default files. +.P +The files are 4 column text file where empty lines and lines +starting with a '#', after any whitespace, are ignored. +The values in the columns should be, in order, a monitor's +EDID, that monitor's red value, green value, and blue value. +.SH OPTIONS +.TP +.B \-B " "\fIbrightness-file\fP +Read the brightness values from the selected file. +.TP +.B \-C " "\fIbrightness-file\fP +Read the contrast values from the selected file. +.TP +.BR \-c " "\fIcrtc\fP +Apply the filter to the CRTC with the monitor whose EDID is +.IR crtc . +By default, the filter is applied to all monitors. +.TP +.B \-d +Keep the process alive and remove the filter on death. +.TP +.BR \-M " "\fImethod\fP +Adjustment method name or number. Recognised names include: + +.nf +\fBdummy\fP Dummy method +\fBrandr\fP X RAndR +\fBvidmode\fP X VidMode +\fBdrm\fP Linux DRM +\fBgdi\fP Windows GDI +\fBquartz\fP Quartz Core Graphics +.fi + +The adjustment methods are supported via +.BR libgamma (7). +Only methods that were enabled when +.B libgamma +was compiled will be supported. +.TP +.BR \-p " "\fIpriority\fP +Set the priority of the filter. Filters with lower priority +are applied before filters with higher priority. The value +must be a signed 64-bit integer (between -9223372036854775807 +and 9223372036854775808). +.BR cg-limits 's +default priority is -4611686018427387904. +.TP +.BR \-R " "\fIrule\fP +Set the rule of of the filter to +.IR rule . +This is the last part of the filter's identifier (class). +The default rule is +.BR standard . +.TP +.BR \-S " "\fIsite\fP +Select the site to which to connect. For example +.RB ' :0 ', +for local display 0 when using +.BR X . +.TP +.B \-x +Remove the currently applied filter. +.SH FILES +.TP +.B ~/.config/brightness +The default brightness table file. +.TP +.B ~/.config/contrast +The default contrast table file. +.TP +.B /etc/brightness +The fallback brightness table file. +.TP +.B /etc/contrast +The fallback contrast table file. +.SH BUGS +Please report bugs to https://github.com/maandree/cg-tools/issues +or to maandree@kth.se diff --git a/src/cg-limits.c b/src/cg-limits.c index bf8ba83..5df54e3 100644 --- a/src/cg-limits.c +++ b/src/cg-limits.c @@ -149,7 +149,7 @@ void usage(void) { fprintf(stderr, "Usage: %s [-M method] [-S site] [-c crtc]... [-R rule] (-x | [-p priority] [-d] " - "([-B brigtness-file] [-C contrast-file] | brightness-all:contrast-all | " + "([-B brightness-file] [-C contrast-file] | brightness-all:contrast-all | " "brightness-red:contrast-red brightness-green:contrast-green brightness-blue:contrast-blue))\n", argv0); exit(1); |