xvidtune(1)

NAME
       xvidtune - video mode tuner for XFree86

SYNOPSIS
       xvidtune  [ -prev | -next | -unlock | ] ] [ -toolkitoption
       ... ]

DESCRIPTION
       Xvidtune is a client interface to  the  XFree86  X  server
       video mode extension (XFree86-VidModeExtension).

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

       Without any options (or with only toolkit options) it pre-
       sents 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  con-
       nected 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:

       Left
       Right
       Up
       Down
                 Adjust the video mode so that the  display  will
                 be moved in the appropriate direction.

       Wider
       Narrower
       Shorter
       Taller
                 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/Nar-
                 rower/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.

       BlankDelay1
       BlankDelay2
                 Set the blank delay values.  This affects screen
                 wrapping.   Acceptable  values  are in the range
                 0-7.  The values may be  incremented  or  decre-
                 mented  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
                 blank_delay "*" 0

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

       -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.

SEE ALSO
       XF86Config(4/5) XFree86(1) 

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

BUGS
       X Error handling, i.e. when  the  server  does  not  allow
       xvidtune clients to write new modes, could be better.