Provided by: videogen_0.33-8_amd64 bug

NAME

       videogen - generate Modelines for Xorg servers

SYNOPSIS

       videogen  [-v|-q] [-fb|-nfb] [-nv|-nnv] [-f=<file|->] [-m=mode] [-mdc=n] [-mhf=n] [-mvf=n]
         [-dvf=n] [-hv=n] [-vv=n] [-hfp=n] [-hbp=n] [-hsp=n] [-vfp=n] [-vbp=n] [-vsp=n]

DESCRIPTION

       videogen generates Modelines for Xorg servers (or XFree86 servers) to  reach  the  highest
       possible  vertical  refresh  rate  at  all  resolutions,  or to match the refresh rate you
       desire. As a new feature, it can obey the non-free NVidia driver's timing constraints.  It
       can print the calculated results in the Linux framebuffer device format as well.

       ATTENTION!   You  only  have  to  specify  the  maximum  dot clock, the maximum horizontal
       frequency, the maximum vertical refresh, and of course the modes (resolutions) to generate
       the  appropriate  Modelines.   The  other  options  are only there for tweaking or solving
       special problems, there are hardcoded defaults for them which are suitable  for  the  vast
       majority of cases.

   CONFIGURATION FILE
       A  configuration  file  can  be  used  to  specify all or part of the parameters needed by
       videogen to perform its calculations. This can be very comfortable in many cases.  You can
       also  specify  a  configuration  file  path  on  the  command  line other than the default
       (~/.videogen) or read from stdin which might be helpful if you want to call videogen  from
       another program or from a script.

       The  general  syntax  rules  are  the following: parameters are specified using name=value
       pairs. The parameter names are matched in a case insensitive manner. Blanks are  optional.
       Multiple  name=value  pairs can be specified on a single line separated by ";" characters.
       Any string after a "#" character is treated as a comment up to the end of the line.

   COMMAND LINE
       The command line options always override the parameters set  in  the  configuration  file.
       This also applies to the mode list, so when one or more modes are specified on the command
       line, the entire list of modes read from the configuration file is replaced by these.

   OPTIONS
       The command line options are  described  below  together  with  their  configuration  file
       variable counterparts (if present).

       -v
       -q
       verbose=on|off
              Turn on/off verbose output. FYI -q stands for quiet ;)
               (default=on)

       -fb
       -nfb
       fbset=on|off
              Turn  on/off fbset (Linux framebuffer timings) mode. In this mode fbset timings are
              printed instead of Modelines.
               (default=off)

       -nv
       -nnv
       nvidia=on|off
              Turn on/off non-free NVidia Linux driver compatibility mode.
               (default=on)

       -f=filespec
              Use filespec as the configuration file. This accepts - to read the options from the
              standard  input.  The "~" character gets expanded to the home directory of the user
              running videogen.
               (default=~/.videogen)

       -m=modespec
       mode=modespec
              Adds modespec to the list of modes to calculate a Modeline for. This must be in the
              form 800x600 (width x height) and it can be specified more than once to add several
              modes.

       -mdc=freq
              Set freq to the maximum dot clock rate of your video card or the bandwidth of  your
              monitor, whichever is lower, in MHz.

       -mhf=freq
              Set freq to the maximum horizontal refresh frequency of your monitor in kHz.

       -mvf=freq
              Set freq to the maximum vertical refresh frequency of your monitor in Hz.

       -dvf=freq
              Set  freq  to  the  vertical refresh frequency which you think would be optimal for
              you, in Hz.  The program will try to  match  this  frequency  at  all  resolutions,
              instead of the maximum frequency that would be technically possible. (optional)

       -hv=percent
              Set  percent  to the percentage of the horizontal frame length you want the visible
              resolution to be. (optional)

       -vv=percent
              Set percent to the percentage of the vertical frame length  you  want  the  visible
              resolution to be. (optional)

       -hfp=duration
              Set duration to the horizontal front porch duration of your monitor in clock ticks.
              (optional)

       -hbp=duration
              Set duration to the horizontal back porch duration of your monitor in clock  ticks.
              (optional)

       -hsp=duration
              Set  duration  to  the  minimum  horizontal  sync  pulse  duration of your monitor.
              (optional)

       -vfp=duration
              Set duration to the vertical front porch duration of your monitor in  clock  ticks.
              (optional)

       -vbp=duration
              Set  duration  to  the vertical back porch duration of your monitor in clock ticks.
              (optional)

       -vsp=duration
              Set duration  to  the  minimum  vertical  sync  pulse  duration  of  your  monitor.
              (optional)

   ERRORS
       You can expect the following error codes to be returned by videogen:

       100    system error (memory allocation problems, or other)

       101    command line option error

       102    configuration file error

       103    bad  resolution error, currently returned when no (valid) modes have been specified
              anywhere

       104    bad maximum dot clock rate, currently  returned  when  no  proper  value  has  been
              specified anywhere

       105    bad  maximum  horizontal  refresh, currently returned when no proper value has been
              specified anywhere

       106    bad maximum vertical refresh, currently returned when  no  proper  value  has  been
              specified anywhere

   FIXED DOT CLOCKS
       If your display adapter does not have a programmable clockchip then you will need to get a
       list of available clocks somehow and enter these as the maximum dot clock frequency.  This
       way  videogen  will  have  to  adjust  (decrease)  the horizontal refresh frequency to get
       exactly the given dot clock rate. A similar  method  can  be  used  to  match  the  proper
       frequencies of a fixed frequency monitor.

FILES

       ~/.videogen
              The default location for the videogen configuration file.

       /etc/X11/xorg.conf
              The  Xserver  configuration  file  where  Modelines  generated with videogen can be
              inserted. Currently this must be done by hand.

       /etc/X11/XF86Config
       /etc/X11/XF86Config-4
              Names of the Xserver configuration file in older releases of X.

SEE ALSO

       some_modes(1), Xorg(1), xorg.conf(5), xvidtune(1)

AUTHOR

       Szabolcs Rumi <rumi_at_rtfm_dot_hu>

COPYING

       GNU General Public License  Version  2  (found  in  /usr/share/common-licenses  on  Debian
       systems)