1xvidtune(1)                 General Commands Manual                xvidtune(1)
2
3
4

NAME

6       xvidtune - video mode tuner for Xorg
7

SYNOPSIS

9       xvidtune [ -show | -prev | -next | -unlock ] [ -toolkitoption ... ]
10

DESCRIPTION

12       Xvidtune  is  a  client  interface to the X server video mode extension
13       (XFree86-VidModeExtension).
14
15       When given one of the non-toolkit options, xvidtune provides a  command
16       line interface to either print or switch the video mode.
17
18       Without any options (or with only toolkit options) it presents the user
19       with various buttons and sliders that  can  be  used  to  interactively
20       adjust existing video modes.  It will also print the settings in a for‐
21       mat suitable for inclusion in an xorg.conf file.
22
23       Normally the Xorg X servers only allow changes  to  be  made  with  the
24       XFree86-VidModeExtension  from clients connected via a local connection
25       type.
26
27       Note:  The original mode settings can be restored by pressing  the  `R'
28       key,  and  this  can  be  used to restore a stable screen in situations
29       where the screen becomes unreadable.
30
31       The available buttons are:
32
33       Left
34       Right
35       Up
36       Down
37                 Adjust the video mode so that the display will  be  moved  in
38                 the appropriate direction.
39
40       Wider
41       Narrower
42       Shorter
43       Taller
44                 Adjust  the  video  mode  so that the display size is altered
45                 appropriately.
46
47       Quit      Exit the program.
48
49       Apply     Adjust the current video mode to match the selected settings.
50
51       Auto      Cause the Up/Down/Right/Left,  Wider/Narrower/Shorter/Taller,
52                 Restore,  and  the  special  S3 buttons to be applied immedi‐
53                 ately.  This button can be toggled.
54
55       Test      Temporarily switch to the selected settings.
56
57       Restore   Return the settings to their original values.
58
59       Fetch     Query the server for its current settings.
60
61       Show      Print the currently selected settings to stdout in  xorg.conf
62                 "Modeline" format.  The primary selection is similarly set.
63
64       Next      Switch the Xserver to the next video mode.
65
66       Prev      Switch the Xserver to the previous video mode.
67
68       For some S3-based cards (964 and 968) the following are also available:
69
70       InvertVCLK
71                 Change the VCLK invert/non-invert state.
72
73       EarlySC   Change the Early SC state.  This affects screen wrapping.
74
75       BlankDelay1
76       BlankDelay2
77                 Set  the  blank  delay values.  This affects screen wrapping.
78                 Acceptable values are in the range 0-7.  The  values  may  be
79                 incremented  or  decremented with the `+' and `-' buttons, or
80                 by pressing the `+' or `-' keys in the text field.
81
82       For S3-864/868 based cards InvertVCLK and BlankDelay1  may  be  useful.
83       For S3 Trio32/Trio64 cards only InvertVCLK is available.  At the moment
84       there are no default settings available for these chips  in  the  video
85       mode  extension  and thus this feature is disabled in xvidtune.  It can
86       be enabled by setting any of the optional S3  commands  in  the  screen
87       section of xorg.conf, e.g. using
88                 blank_delay "∗" 0
89

OPTIONS

91       xvidtune accepts the standard X Toolkit command line options as well as
92       the following:
93
94       -show     Print the current settings to stdout in xorg.conf  "Modeline"
95                 format and exit.
96
97       -prev     Switch the Xserver to the previous video mode.
98
99       -next     Switch the Xserver to the next video mode.
100
101       -unlock   Normally,  xvidtune will disable the switching of video modes
102                 via hot-keys while it is running.  If  for  some  reason  the
103                 program did not exit cleanly and they are still disabled, the
104                 program can be re-run with this option to re-enable the  mode
105                 switching key combinations.
106

SEE ALSO

108       xrandr(1), Xorg(1), xorg.conf(5).
109

AUTHORS

111       Kaleb S. Keithley, X Consortium.
112       Additions and modifications by Jon Tombs, David Dawes, and Joe Moss.
113

BUGS

115       X  Error handling, i.e. when the server does not allow xvidtune clients
116       to write new modes, could be better.
117
118
119
120X Version 11                    xvidtune 1.0.3                     xvidtune(1)