Debian Codegraph @

upstream/debian-unstable/man1/xvidtune.1

raw
1 .\" $XFree86: xc/programs/xvidtune/xvidtune.man,v $
2 .\"
3 .\" Copyright (c) 1995 Kaleb S. KEITHLEY
4 .\"
5 .\" Permission is hereby granted, free of charge, to any person obtaining
6 .\" a copy of this software and associated documentation files (the
7 .\" "Software"), to deal in the Software without restriction, including
8 .\" without limitation the rights to use, copy, modify, merge, publish,
9 .\" distribute, sublicense, and/or sell copies of the Software, and to
10 .\" permit persons to whom the Software is furnished to do so, subject to
11 .\" the following conditions:
12 .\"
13 .\" The above copyright notice and this permission notice shall be included
14 .\" in all copies or substantial portions of the Software.
15 .\"
16 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19 .\" IN NO EVENT SHALL Kaleb S. KEITHLEY BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 .\" OTHER DEALINGS IN THE SOFTWARE.
23 .\"
24 .\" Except as contained in this notice, the name of Kaleb S. KEITHLEY shall
25 .\" not be used in advertising or otherwise to promote the sale, use or
26 .\" other dealings in this Software without prior written authorization
27 .\" from Kaleb S. KEITHLEY.
28 .\"
29 .TH xvidtune 1 "xvidtune 1.0.4" "X Version 11"
30 .SH NAME
31 xvidtune \- video mode tuner for Xorg
32 .SH SYNOPSIS
33 .B xvidtune
34 [
35 .B -show
36 |
37 .B -prev
38 |
39 .B -next
40 |
41 .B -unlock
42 |
43 .B -timeout
44 .I sec
45 ] [
46 .I \-toolkitoption
47 \&.\|.\|. ]
48 .SH DESCRIPTION
49 Xvidtune is a client interface to the X server video mode
50 extension (XFree86-VidModeExtension).
51 .PP
52 When given one of the non-toolkit options, xvidtune provides
53 a command line interface to either print or switch the video mode.
54 .PP
55 Without any options (or with only toolkit options) it
56 presents the user with various buttons and sliders that can be
57 used to interactively adjust existing video modes.
58 It will also print the settings in a format suitable for inclusion
59 in an xorg.conf file.
60 .PP
61 Normally the Xorg X servers only allow changes to be made with
62 the XFree86-VidModeExtension from clients connected via a local
63 connection type.
64 .PP
65 Note: The original mode settings can be restored by pressing the `R' key,
66 and this can be used to restore a stable screen in situations where the
67 screen becomes unreadable.
68 .PP
69 The available buttons are:
70 .PP
71 .nf
72 .B Left
73 .B Right
74 .B Up
75 .B Down
76 .fi
77 .RS 10
78 Adjust the video mode so that the display will be moved in the
79 appropriate direction.
80 .RE
81 .PP
82 .nf
83 .B Wider
84 .B Narrower
85 .B Shorter
86 .B Taller
87 .fi
88 .RS 10
89 Adjust the video mode so that the display size is altered
90 appropriately.
91 .RE
92 .TP 10
93 .B Quit
94 Exit the program.
95 .TP 10
96 .B Apply
97 Adjust the current video mode to match the selected settings.
98 .TP 10
99 .B Auto
100 Cause the Up/Down/Right/Left, Wider/Narrower/Shorter/Taller, Restore,
101 and the special S3 buttons to be applied immediately.
102 This button can be toggled.
103 .TP 10
104 .B Test
105 Temporarily switch to the selected settings.
106 .TP 10
107 .B Restore
108 Return the settings to their original values.
109 .TP 10
110 .B Fetch
111 Query the server for its current settings.
112 .TP 10
113 .B Show
114 Print the currently selected settings to stdout in xorg.conf
115 "Modeline" format. The primary selection is similarly set.
116 .TP 10
117 .B Next
118 Switch the Xserver to the next video mode.
119 .TP 10
120 .B Prev
121 Switch the Xserver to the previous video mode.
122 .PP
123 For some S3-based cards (964 and 968) the following are also available:
124 .TP 10
125 .B InvertVCLK
126 Change the VCLK invert/non-invert state.
127 .TP 10
128 .B EarlySC
129 Change the Early SC state. This affects screen wrapping.
130 .PP
131 .nf
132 .B BlankDelay1
133 .B BlankDelay2
134 .fi
135 .RS 10
136 Set the blank delay values. This affects screen wrapping. Acceptable
137 values are in the range 0\-7. The values may be incremented or decremented
138 with the `+' and `-' buttons, or by pressing the `+' or `-' keys in the
139 text field.
140 .RE
141 .PP
142 For S3-864/868 based cards \fIInvertVCLK\fP and \fIBlankDelay1\fP may
143 be useful. For S3 Trio32/Trio64 cards only \fIInvertVCLK\fP is available.
144 At the moment there are no default settings available for these chips
145 in the video mode extension and thus this feature is disabled in xvidtune.
146 It can be enabled by setting any of the optional S3 commands in the
147 screen section of xorg.conf, e.g. using
148 .RS 10
149 .B blank_delay \fI"\(**"\fP 0
150 .RE
151 .SH OPTIONS
152 \fIxvidtune\fP accepts the standard X Toolkit command line options as well
153 as the following:
154 .TP 10
155 .B \-show
156 Print the current settings to stdout in xorg.conf
157 "Modeline" format and exit.
158 .TP 10
159 .B \-prev
160 Switch the Xserver to the previous video mode.
161 .TP 10
162 .B \-next
163 Switch the Xserver to the next video mode.
164 .TP 10
165 .B \-unlock
166 Normally, \fIxvidtune\fP will disable the switching of video modes
167 via hot-keys while it is running. If for some reason the program
168 did not exit cleanly and they are still disabled, the program can
169 be re-run with this option to re-enable the mode switching key
170 combinations.
171 .TP 10
172 .B \-timeout \fIsec\fP
173 Set testmode timeout in seconds.
174 .SH SEE ALSO
175 .BR xrandr (1),
176 .BR Xorg (1),
177 .BR xorg.conf (5).
178 .SH AUTHORS
179 Kaleb S. Keithley, X Consortium.
180 .br
181 Additions and modifications by Jon Tombs, David Dawes, and Joe Moss.
182 .SH BUGS
183 X Error handling, i.e. when the server does not allow xvidtune
184 clients to write new modes, could be better.