xgamma/man/xgamma.man

   1 .\" Copyright 1999  by The XFree86 Project, Inc.
   2 .\"
   3 .\" All Rights Reserved.
   4 .\"
   5 .\" The above copyright notice and this permission notice shall be included
   6 .\" in all copies or substantial portions of the Software.
   7 .\"
   8 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
   9 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  10 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  11 .\" IN NO EVENT SHALL THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES OR
  12 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  13 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  14 .\" OTHER DEALINGS IN THE SOFTWARE.
  15 .\"
  16 .\" Except as contained in this notice, the name of The XFree86 Project shall
  17 .\" not be used in advertising or otherwise to promote the sale, use or
  18 .\" other dealings in this Software without prior written authorization
  19 .\" from The XFree86 Project.
  20 .\"
  21 .TH xgamma 1 __vendorversion__
  22 .SH NAME
  23 xgamma - Alter a monitor's gamma correction through the X server
  24 .SH SYNOPSIS
  25 .B "xgamma"
  26 [-display \fIdisplay\fP] [-screen \fIscreen\fP] [-quiet]
  27 [-gamma f.f | [[-rgamma f.f] [-ggamma f.f] [-bgamma f.f]]]
  28 .SH DESCRIPTION
  29 .PP
  30 .B xgamma
  31 allows X users to query and alter the gamma correction of a monitor via
  32 the X video mode extension (XFree86-VidModeExtension).
  33 .PP
  34 Note that the \fBxgamma\fP utility is obsolete and deficient, \fBxrandr\fP
  35 should be used with drivers that support the \fBXRandr\fP extension.
  36 .PP
  37 If no value for the gamma correction is given via the
  38 .I -gamma
  39 or
  40 .IR -rgamma / -ggamma / -bgamma
  41 options,
  42 .B xgamma
  43 prints the current gamma correction of the display.
  44 .SH OPTIONS
  45 .PP
  46 .TP 8
  47 .B "-display \fIdisplay\fP"
  48 This argument allows you to specify the server to connect to; see \fIX(__miscmansuffix__)\fP.
  49 .PP
  50 .TP 8
  51 .B "-screen \fIscreen\fP"
  52 When multiple displays are configured as a single logical display, this option
  53 allows you to select the screen you wish to change.
  54 .PP
  55 .TP 8
  56 .B "-quiet"
  57 Silence the normal output of
  58 .B xgamma
  59 .PP
  60 .TP 8
  61 .B "-help"
  62 Print out the `Usage:' command syntax summary.
  63 .PP
  64 .TP 8
  65 .B "-gamma f.f"
  66 The gamma correction can either be defined as a single value, or
  67 separately for the red, green and blue components. This argument
  68 specifies the gamma correction as a single value.
  69 .PP
  70 .TP 8
  71 .B "-rgamma f.f"
  72 This argument specifies the red component of the gamma correction.
  73 .PP
  74 .TP 8
  75 .B "-ggamma f.f"
  76 This argument specifies the green component of the gamma correction.
  77 .PP
  78 .TP 8
  79 .B "-bgamma f.f"
  80 This argument specifies the blue component of the gamma correction.
  81 .SH ENVIRONMENT
  82 .PP
  83 .TP 8
  84 .B DISPLAY
  85 To get default host and display number.
  86 .SH BUGS
  87 .PP
  88 This client changes the internal values of the gamma correction for the
  89 Xserver. Whether or not these values are respected depends on the video
  90 drivers.
  91 .PP
  92 The gamma values are passed to the Xserver with 3 decimal places of
  93 accuracy.
  94 .SH SEE ALSO
  95 xvidtune(__appmansuffix__),
  96 xrandr(__appmansuffix__)
  97 .SH AUTHORS
  98 Kaleb S. Keithley, X Consortium.
  99 .br
 100 David Dawes, David Bateman