Short:        Calculates Picasso96 screen modes
Uploader:     [email protected] (Chris Jones)
Author:       [email protected] (Chris Jones)
Type:         util/cli
Version:      0.2
Architecture: m68k-amigaos >= 3.1
Distribution: Aminet


NAME

   umc - universal modeline calculator  

SYNOPSIS

   umc x y refresh [OPTIONS]
   umc x y hclock [OPTIONS]
   umc x y pclock [OPTIONS]  

DESCRIPTION

   umc is a modeline calculator that fully implements the Coordinated Video
   Timing and General Timing Formula spreadsheets published by the Video
   Electronics Standards Association (www.vesa.org). Simply input a desired
   resolution and clock frequency. All clock frequencies must be given in Hz.
   For a full length, mostly accurate modeline tutorial visit
   http://lrmc.sourceforge.net  

INSTALLATION

   Copy the umc executable somewhere like C:

OPTIONS

   -d
   --doublescan
           Calculate a doublescanned modeline. Doublescanned modes are useful
           for running low resolutions on high resolution monitors, but they
           can also be used to display low resolutions with a very small
           scanline, popular gaming resolutions like 640x480 and 800x600.
           Doublescanned modes are not supported by many video cards. You
           should only use this option if you know your video card supports
           them.
   -i
   --interlace
           Calculate an interlaced modeline. Interlaced modes are useful for
           running very high resolutions. Interlaced modes are not supported
           by many video cards. You should only use this option if you know
           your video card supports them.
   -m number
   --margin=number
           Margin size as a percentage of the resolution (default = 0). All
           margins are equal percentage wise (i.e. %top = %bottom = %left =
           %right).
   -v number
   --vertical-sync=number
           Number of lines in vertical sync, UMC = 4, GTF = 3, CVT varies by
           aspect ratio as follows:
           4:3 = 4 lines (default)
           16:9 = 5 lines
           16:10 = 6 lines
           5:4 = 7 lines
           15:9 = 7 lines
   -x
   --X11R6
           Print modeline in X11R6 format.
   -f
   --fb
           Print modeline in fbset format.
   -p
   --p96
           Print mode info in Picasso 96 format (default).
   --gtf
           Use General Timing Formula. To avoid any parameter conflicts
           always specify this option first. UMC's default calculations are
           equivalent to:
           umc x y clock -gtf -f 4 -v 4 [OPTIONS]
   --cvt
           Use Coordinated Video Timing. See -v, --vertical-sync option above
           for the correct number of lines to use in vertical sync. The
           default is 4 lines = 4:3 aspect ratio (i.e. standard PC monitor).
           To avoid any parameter conflicts always specify this option first.
   --rbt
           Use Reduced Blanking Timing. To avoid any parameter conflicts
           always specify this option first.
           This option is particularly useful for video cards which are unable
           to drive high pixel clocks (e.g. Vampire cards)
    

ADVANCED OPTIONS

   -c number
   --character-cell=number
           Number of pixels per character cell (default = 8).
   -p number
   --pclock-step=number
           Pixel clock multiple (UMC default = 0, GTF default = 0, CVT
           default = 0.25).
   -h number
   --horizontal-sync=number
           Horizontal sync as a percentage of total active (default = 8).
   -f number
   --vertical-front-porch=number
           Number of lines in front porch (UMC default = 4, GTF default = 1,
           CVT default = 3).
   -b number
   --vertical-back-porch=number
           Minimum number of lines in vertical back porch (default = 6).
   -y number
   --back-porch-plus-sync=number
           Number of microseconds in vertical sync and back porch (default
           550).
   -w number
   --horizontal-blanking-ticks=number
           Number of pixel clock ticks in horizontal blanking time, RBT only
           (default 160).
   -s number
   --horizontal-sync-ticks=number
           Number of pixel clock ticks in horizontal sync, RBT only (default
           32).
   -t number
   --vertical-blanking-time=number
           Minimum vertical blanking time in microseconds, RBT only (default
           = 460)
   -M number
   --gradient=number
           The value of M used to calculate the horizontal blanking time
           (DEFAULT = 600).
   -C number
   --offset=number
           The value of C used to calculate the horizontal blanking time
           (DEFAULT = 40).
   -K number
   --scaling-factor=number
           The value of K used to calculate the horizontal blanking time
           (DEFAULT = 128).
   -J number
   --scale-factor-weight=number
           The value of J used to calculate the horizontal blanking time
           (DEFAULT = 20).
    

EXAMPLES

    umc 1280 960 72
           Calculate a modeline for a 1280x960 resolution running at a
           refresh rate of 72Hz. Print the modeline in Picasso96 format.
    umc 640 480 60 -d
           Calculate a modeline for a 640x480 resolution running at a refresh
           rate of 60Hz, doublescanned. Print the modeline in Picasso96 format.
    umc 1280 960 31500 -i
           Calculate a modeline for a 1280x960 resolution running at a
           horizontal clock of 31.5kHz, interlaced. Print the modeline in
           Picasso96 format.
    umc 1280 960 125000000
           Calculate a modeline for a 1280x960 resolution running at a pixel
           clock of 125mHz. Print the modeline in Picasso96 format.
    

AUTHOR

   Written by Des Jones. Amiga port and Picasso96 support by Chris Jones.

BUGS THAT AREN'T BUGS

   Doublescanned calculations are not formally laid out in either the GTF or
   CVT worksheets. Though easily added, for consistency purposes the default
   vertical front porch and sync times were changed to be a multiple of 2.
   Consequently, umc calculations differ ever so slightly from VESA's. See
   the --gtf and --cvt options above for unmolested calculations. Only the
   GTF supports horizontal clock and pixel clock driven calculations. Clock
   frequencies must always be given in Hz, never in kHz or mHz.  

BUGS

   The fbset modeline format has never been tested. It may not work. Other
   bugs may be reported at http://sourceforge.net/projects/umc/  

COPYRIGHT

   Copyright 2005 Des Jones.
   This is free software; see the source for copying conditions. There is NO
   warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
   PURPOSE.  

SEE ALSO

   lrmc(1), advv(1), gtf(1)

     ----------------------------------------------------------------------