File: videogen.1x

package info (click to toggle)
videogen 0.33-8
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 464 kB
  • sloc: ansic: 2,853; yacc: 853; sh: 124; lex: 118; makefile: 47
file content (219 lines) | stat: -rw-r--r-- 6,622 bytes parent folder | download
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
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
.TH VIDEOGEN 1 "videogen" "Szabolcs Rumi" \" -*- nroff -*-
.SH NAME
videogen \- generate Modelines for Xorg servers
.SH SYNOPSIS
.HP 2
.B videogen
.RB [ \-v | \-q ]
.RB [ \-fb | \-nfb ]
.RB [ \-nv | \-nnv ]
[\fB\-f=\fP<\fIfile\fP|\fB\-\fP>] [\fB\-m=\fImode\fR]
[\fB\-mdc=\fIn\fR] [\fB\-mhf=\fIn\fR] [\fB\-mvf=\fIn\fR] [\fB\-dvf=\fIn\fR]
[\fB\-hv=\fIn\fR] [\fB\-vv=\fIn\fR] [\fB\-hfp=\fIn\fR] [\fB\-hbp=\fIn\fR]
[\fB\-hsp=\fIn\fR] [\fB\-vfp=\fIn\fR] [\fB\-vbp=\fIn\fR] [\fB\-vsp=\fIn\fR]
.SH DESCRIPTION
.B 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.
.P
.B 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.
.SS CONFIGURATION FILE
A configuration file can be used to specify all or part of the parameters needed by
.B 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.
.P
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.
.SS 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.
.SS OPTIONS
The command line options are described below together with their
configuration file variable counterparts (if present).
.PD
.TP
.B "\-v"
.PD 0
.TP 
.B "\-q"
.TP
\fBverbose=on\fP|\fBoff\fP
Turn on/off verbose output. FYI \fB-q\fP stands for quiet ;)
 (default=on)
.PD
.TP
.B "\-fb"
.PD 0
.TP
.B "\-nfb"
.TP
\fBfbset=on\fP|\fBoff\fP
Turn on/off fbset (Linux framebuffer timings) mode. In this mode
fbset timings are printed instead of Modelines.
 (default=off)
.PD
.TP
.B "\-nv"
.PD 0
.TP
.B "\-nnv"
.TP
\fBnvidia=on\fP|\fBoff\fP
Turn on/off non-free NVidia Linux driver compatibility mode.
 (default=on)
.PD
.TP
.BI "\-f=filespec"
Use
.I filespec
as the configuration file. This accepts
.B -
to read the options from the standard input. The "~" character
gets expanded to the home directory of the user running videogen.
 (default=~/.videogen)
.PD
.TP
.BI \-m= modespec
.PD 0
.TP
.BI mode= modespec
Adds
.I modespec
to the list of modes to calculate a Modeline for. This must
be in the form
.B 800x600
(\fIwidth\fP x \fIheight\fP) and it can be specified more than once to add several modes.
.PD
.TP
.BI \-mdc= freq
Set
.I freq
to the maximum dot clock rate of your video card or the
bandwidth of your monitor, whichever is lower, in MHz.
.TP
.BI \-mhf= freq
Set
.I freq
to the maximum horizontal refresh frequency of your monitor in kHz.
.TP
.BI \-mvf= freq
Set
.I freq
to the maximum vertical refresh frequency of your monitor in Hz.
.TP
.BI \-dvf= freq
Set
.I 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)
.TP
.BI \-hv= percent
Set
.I percent
to the percentage of the horizontal frame length you want the visible resolution to be. (optional)
.TP
.BI \-vv= percent
Set
.I percent
to the percentage of the vertical frame length you want the visible resolution to be. (optional)
.TP
.BI \-hfp= duration
Set
.I duration
to the horizontal front porch duration of your monitor in clock ticks. (optional)
.TP
.BI \-hbp= duration
Set
.I duration
to the horizontal back porch duration of your monitor in clock ticks. (optional)
.TP
.BI \-hsp= duration
Set
.I duration
to the minimum horizontal sync pulse duration of your monitor. (optional)
.TP
.BI \-vfp= duration
Set
.I duration
to the vertical front porch duration of your monitor in clock ticks. (optional)
.TP
.BI \-vbp= duration
Set
.I duration
to the vertical back porch duration of your monitor in clock ticks. (optional)
.TP
.BI \-vsp= duration
Set
.I duration
to the minimum vertical sync pulse duration of your monitor. (optional)
.SS ERRORS
You can expect the following error codes to be returned by videogen:
.TP
.I "100"
system error (memory allocation problems, or other)
.TP
.I "101"
command line option error
.TP
.I "102"
configuration file error
.TP
.I "103"
bad resolution error, currently returned when no (valid) modes have been specified anywhere
.TP
.I "104"
bad maximum dot clock rate, currently returned when no proper value has been specified anywhere
.TP
.I "105"
bad maximum horizontal refresh, currently returned when no proper value has been specified anywhere
.TP
.I "106"
bad maximum vertical refresh, currently returned when no proper value has been specified anywhere
.SS 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.
.SH FILES
.TP
.I "~/.videogen"
The default location for the videogen configuration file.
.TP
.I "/etc/X11/xorg.conf"
The Xserver configuration file where Modelines generated with
.B videogen
can be inserted. Currently this must be done by hand.
.TP
.I "/etc/X11/XF86Config"
.PD 0
.TP
.I "/etc/X11/XF86Config-4"
Names of the Xserver configuration file in older releases of X.
.PD
.SH SEE ALSO
.BR some_modes (1),\  Xorg (1),\  xorg.conf (5),\  xvidtune (1)
.SH AUTHOR
Szabolcs Rumi <rumi_at_rtfm_dot_hu>
.SH COPYING
GNU General Public License Version 2 (found in
/usr/share/common-licenses on Debian systems)