When given one of the non-toolkit options, xvidtune provides a command line
interface to either switch the video mode.

Without any options (or with
only toolkit options) it presents the user with various buttons and sliders
that can be used to interactively adjust existing video modes. It will also
print the settings in a format suitable for inclusion in an XF86Config
file.

Normally the XFree86 X servers only allow changes to be made with
the XFree86-VidModeExtension from clients connected via a local connection
type.

Note: The original mode settings can be restored by pressing the
`R' key, and this can be used to restore a stable screen in situations where
the screen becomes unreadable.

The available buttons are:

LeftRightUpDown

Adjust the video mode so that the display will be moved in the appropriate
direction.

WiderNarrowerShorterTaller

Adjust the video mode so that the display size is altered appropriately.

Quit

Exit the program.

Apply

Adjust the current video mode to match the
selected settings.

Auto

Cause the Up/Down/Right/Left, Wider/Narrower/Shorter/Taller,
Restore, and the special S3 buttons to be applied immediately. This button
can be toggled.

Test

Temporarily switch to the selected settings.

Restore

Return the settings to their original values.

Fetch

Query the server for
its current settings.

Show

Print the currently selected settings to stdout
in XF86Config "Modeline" format. The primary selection is similarly set.

Next

Switch the Xserver to the next video mode.

Prev

Switch the Xserver
to the previous video mode.

For some S3-based cards (964 and 968) the following
are also available:

InvertVCLK

Change the VCLK invert/non-invert state.

EarlySC

Change the Early SC state. This affects screen wrapping.

BlankDelay1BlankDelay2

Set the blank delay values. This affects screen wrapping. Acceptable values
are in the range 0-7. The values may be incremented or decremented with
the `+' and `-' buttons, or by pressing the `+' or `-' keys in the text field.

For
S3-864/868 based cards InvertVCLK and BlankDelay1 may be useful. For S3
Trio32/Trio64 cards only InvertVCLK is available. At the moment there are
no default settings available for these chips in the video mode extension
and thus this feature is disabled in xvidtune. It can be enabled by setting
any of the optional S3 commands in the screen section of XF86Config, e.g.
using

xvidtune accepts the standard X Toolkit
command line options as well as the following:

-show

Print the current settings
to stdout in XF86Config "Modeline" format and exit.

-prev

Switch the Xserver
to the previous video mode.

-next

Switch the Xserver to the next video mode.

-unlock

Normally, xvidtune will disable the switching of video modes via
hot-keys while it is running. If for some reason the program did not exit
cleanly and they are still disabled, the program can be re-run with this
option to re-enable the mode switching key combinations.