-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
190 lines (161 loc) · 6.59 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
Short: Calculates Picasso96 screen modes
Uploader: cmsj@tenshu.net (Chris Jones)
Author: cmsj@tenshu.net (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)
----------------------------------------------------------------------