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
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
| .\"
.\" Copyright 2001 Keith Packard.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation, and that the name of Keith Packard not be used in
.\" advertising or publicity pertaining to distribution of the software without
.\" specific, written prior permission. Keith Packard makes no
.\" representations about the suitability of this software for any purpose. It
.\" is provided "as is" without express or implied warranty.
.\"
.\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
.\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
.\"
.\" $XFree86: xc/programs/xrandr/xrandr.man,v 1.6 2003/06/12 14:12:39 eich Exp $
.\"
.TH "XRANDR" "1" "xrandr 1.3.2" "X Version 11" ""
.SH "NOM"
xrandr \- interface primitive en ligne de commande pour l'extension RandR
.SH "SYNOPSIS"
.B "xrandr"
[\-help] [\-display \fIdisplay\fP]
[\-q] [\-v]
[\-\-verbose]
[\-\-dryrun]
[\-\-screen \fIsnum\fP]
[\-\-q1] [\-\-q12]
.br
.B options de la version 1.3 de RandR
.br
[\-\-current]
[\-\-noprimary]
.br
[\-\-panning <largeur>x<hauteur>[+\fIx\fP+\fIy\fP[/\fIlargeur_piste\fPx\fIhauteur_piste\fP+\fIpiste_x\fP+\fIpiste_y\fP[/\fIbord_gauche\fP/\fIbord_haut\fP/\fIbord_droit\fP/\fIbord_bas\fP]]]]
[\-\-scale \fIx\fPx\fIy\fP]
[\-\-transform \fIa\fP,\fIb\fP,\fIc\fP,\fId\fP,\fIe\fP,\fIf\fP,\fIg\fP,\fIh\fP,\fIi\fP]
[\-\-primary]
.br
.B options de la version 1.2 de RandR
.br
[\-\-prop]
[\-\-fb <largeur>x<hauteur>]
[\-\-fbmm <largeur>x<hauteur>]
[\-\-dpi <dpi>]
[\-\-newmode <nom> <mode>]
[\-\-rmmode <nom>]
[\-\-addmode <sortie> <nom>]
[\-\-delmode <sortie> <nom>]
.br
.B options par sortie
.br
[\-\-output <sortie>]
[\-\-auto]
[\-\-mode <mode>]
[\-\-preferred]
[\-\-pos <x>x<y>]
[\-\-rate <rate>]
[\-\-reflect \fIreflection\fP]
[\-\-rotate \fIorientation\fP]
[\-\-left\-of <sortie>\]
[\-\-right\-of <sortie>\]
[\-\-above <sortie>\]
[\-\-below <sortie>\]
[\-\-same-as \fIoutput\fP\]
[\-\-set \fIproperty\fP \fIvalue\fP]
[\-\-off]
[\-\-crtc <crtc>]
[\-\-gamma \fIred\fP:\fIgreen\fP:\fIblue\fP]
[\-\-brightness \fIbrightness\fP]
.br
.B options des versions 1.0 et 1.1 de RandR
.br
[\-o \fIorientation\fP]
[\-s \fItaille\fP]
[\-x] [\-y]
.SH "DESCRIPTION"
.I Xrandr
sert à déterminer la taille , l'orientation et/ou la réflexion pour la sortie d'un écran.
Il peut aussi définir la taille de l'écran.
L'appel sans option provoque l'affichage de l'état des sorties, la liste de toutes les
options pour chacun d'eux, avec un '+' après le mode préféré
et un '*' après le mode actuel.
Il y a quelques options globales. D'autres modifient la dernière sortie spécifiée
dans la ligne de commande. De sorties multiples peuvent être modifiées simultanément
en plaçant plusieurs \-\-output immédiatement suivies des options de la sortie correspondante
.IP \-\-help
Affiche un résumé sur l'utilisation, et se termine normalement.
.IP "\-v, \-\-version"
Affiche la version de RandR supportée par le serveur X et sort.
.IP \-\-verbose
Rend xrandr plus bavard. Quand il est utilisé avec -q (ou sans autres options), xrandr
montrera plus d'informations sur l'état du serveur. Quand il est utilisé avec les options
qui modifient le système, l'état d'avancement est affiché tout en exécutant les
changements de configuration.
.IP "\-q, \-\-query"
Quand cette option est présente, ou quand aucun changement de configuration
n'est demandé, xrandr montrera l'état actuel du système.
.IP "\-\-dryrun"
Effectue toutes les actions spécifiées sans qu'aucune modification ne soit apportée.
.IP "\-\-nograb"
Applique les modifications sans verrouiller l'accès à l'écran. Ceci
évite de bloquer les autres applications pendant la mise à jour, mais
peut empêcher certaines applications qui détectent les changements de
taille d'écran de recevoir les dernières valeurs.
.IP "\-d, \-display \fIname\fP"
Cette option permet de sélectionner l'affichage X à utiliser. Remarque : ceci se réfère
à la sortie abstraite, pas au moniteur (ou sortie).
.IP "\-screen snum"
Cette option choisit l'écran à modifier. Noter que ceci se rapporte à l'écran X abstrait,
pas au moniteur (ou sortie).
.IP \-\-q1
Force l'utilisation de la version 1.1 du protocole, même si une version supérieure est disponible.
.IP \-\-q12
Force l'utilisation de la version 1.2 du protocole, même si elle n'est pas indiquée comme
supportée ou si une version supérieure est disponible.
.PP
.SH "options de la version 1.3 de RandR"
.PP
Les options de RandR 1.3 sont utilisées en plus des options possibles pour RandR 1.2.
.PP
.IP \-\-current
Renvoie la configuration actuelle de l'écran, sans rechercher les changements matériels.
.IP \-\-noprimary
Ne définit pas la sortie principale.
.PP
.B Options par sortie
.IP \-\-panning
"<largeur>x<hauteur>[+\fIx\fP+\fIy\fP[/\fIlargeur_piste\fPx\fIhauteur_piste\fP+\fIpiste_x\fP+\fIpiste_y\fP[/\fIbord_gauche\fP/\fIbord_haut\fP/\fIbord_droit\fP/\fIbord_bas\fP]]]"
Cette option définit les paramètres de panorama. Dès que cette option est activée, la
position de l'écran bouge avec les mouvements de la souris. Les quatre premiers arguments
définissent l'aire de panorama. les quatre suivants, la zone de suivi (qui est la même par
défaut). Les quatre suivants, les bords, à 0 par défaut. La hauteur ou la largeur fixée à 0
désactive le panorama sur l'axe associé. Généralement, vous devez fixer la taille de l'écran
avec \-\-fb en même temps.
.IP "\-\-transform \fIa\fP,\fIb\fP,\fIc\fP,\fId\fP,\fIe\fP,\fIf\fP,\fIg\fP,\fIh\fP,\fIi\fP"
Le point de coordonnées (x, y) de l'écran physique affiche le point virtuel dont les coordonnées
sont trouvées par le calcul suivant :
.RS
x' = (ax + by + c) / w' et
.br
y' = (dx + ey + f) / w' ,
.br
with w' = (gx + hy + i) .
.RE
Typiquement, \fIa\fP et \fIe\fP correspondent à l'échelle selon les axes X et Y, \fIc\fP et \fIf\fP
correspondent à une translation suivant ces mêmes axes, et \fIg\fP, \fIh\fP, et \fIi\fP
sont respectivement 0, 0 et 1. La matrice peut ainsi être utilisée pour exprimer des
transformations plus complexes comme une correction de trapèze ou rotation. Pour une
rotation d'un angle T, la formule suivante peut être utilisée :
.RS
cos T -sin T 0
.br
sin T cos T 0
.br
0 0 1
.RE
Comme argument spécial, au lieu de passer une matrice, on peut passer la chaîne "\fInone\fP", dans ce cas
les valeurs par défaut sont utilisées (une matrice unitaire sans filtre).
.IP "\-\-scale \fIx\fPx\fIy\fP"
en fait une version raccourcie de l'option \fI\-\-transform\fP.
.IP \-\-primary
Définit la sortie comme primaire.
Cette sortie sera classée première pour les requêtes de géométrie de Xinerama et RandR.
.PP
.SH "options de la version 1.2 de RandR"
Ces options ne sont disponibles que pour les serveurs X fournis avec les versions de RandR 1.2 ou plus récentes.
.IP "\-\-prop, \-\-properties"
Cette option fait afficher par xrandr les propriétés de chaque sortie \-\-verbose permet aussi \-\-prop.
.IP "\-\-fb <largeur>x<hauteur>"
Reconfigure l'écran à la taille spécifiée. Tous les moniteurs configurés doivent loger dans ce rectangle. Quand cette option n'est pas fournie, xrandr calcule la plus petite taille d'écran qui contiendra l'ensemble des sorties configurées\ ; cette option permet de configurer ce comportement.
.IP "\-\-fbmm <largeur>x<hauteur>"
Configure la taille physique de l'écran. Normalement, xrandr remet à zéro ces valeurs pour garder la constante de DPI. Ceci annule ce comportement par défaut.
.IP "\-\-dpi <dpi>"
Configure aussi la taille physique de l'écran. Il utilise la valeur DPI pour calculer la taille physique de l'écran quoiqu'une taille physique en pixels doive être configurée.
.IP "\-\-newmode \fInom\fP \fImode\fP
De nouveaux modelines peuvent être ajoutés et associés avec des sorties. Ces modes sont définis en utilisant la syntaxe des ModeLine de xorg.conf : hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal \fIflags\fP. On peut omettre \fIflags\fP ou des paramètres parmi +HSync, \-HSync, +VSync, \-VSync, Interlace, DoubleScan, CSync, +CSync, \-CSync. Plusieurs outils permettent de calculer les paramètres usuels des modelines : hauteur, largeur, et le taux de rafraîchissement, vous pouvez utiliser, par exemple, cvt.
.IP "\-\-rmmode \fInom\fP"
Cela supprime un mode du serveur s'il est inutilisé.
.IP "\-\-addmode \fIsortie\fP \fInom\fP"
Ajoute un mode à l'ensemble des modes valides d'une sortie.
.IP "\-\-delmode \fIsortie\fP \fInom\fP"
Enlève un mode à l'ensemble des modes valides d'une sortie.
.PP
.B Options par sortie
.IP "\-\-output <sortie>"
Sélectionne la sortie à reconfigurer. Employer le nom de la sortie ou le XID.
.IP \-\-auto
Pour les sorties connectées mais neutralisées, ceci les activera en employant leur mode préféré (ou, quelque chose autour de 96 dpi si elles n'ont aucun mode préféré). Pour les sorties débranchées mais activées, ceci les neutralisera.
.IP "\-\-mode <mode>"
Ceci selectionne un mode. Employer le nom ou le XID du mode.
.IP \-\-preferred
Sélectionne le même mode que \-\-auto, mais n'active ou ne désactive pas automatiquement la sortie.
.IP "\-\-pos <x>x<y>"
Position de la sortie dans l'écran en utilisant des coordonnées en pixels.
.IP "\-\-rate <rate>"
Ceci marque une préférence pour des vitesses de rafraîchissement autour de la valeur indiquée. Quand les modes multiples ont le même nom, ceci choisira le mode le plus proche avec la vitesse de rafraîchissement.
.IP "\-\-reflect symétrie"
La symétrie peut être 'normal', 'x', 'y' ou 'xy'. Ceci effectue une symétrie par rapport aux axes indiqués.
.IP "\-\-rotate rotation"
Rotation peut être 'normal', 'left', 'right' ou 'inverted'. Ceci génère respectivement une rotation de la sortie 'sans rotation' , 'à gauche', 'à droite' ou 'à l'envers'.
.IP "\-\-left\-of, \-\-right\-of, \-\-above, \-\-below <autre_sortie>"
Utiliser une de ces options pour placer la sortie active relativement à une autre sortie, respectivement à gauche, à droite au\-dessus, au\-dessous. Ceci permet un placement commode des sorties dans l'écran. La position est toujours calculée relativement à la nouvelle position de l'autre sortie. Ainsi, il n'est pas admissible d'indiquer \-\-output a \-\-left\-of b \-\-output b \-\-left\-of a.
.IP "\-\-set \fIpropriété\fP \fIvaleur\fP" // à revoir //
Définit une propriété de sortie. Les valeurs entières peuvent être spécifiées comme une valeur décimale ou hexadécimale (avec un 0x) valide (voir \-\-prop).
Les propriétés précises peuvent être définies parmi celles existantes (voir \-\-prop).
Les propriétés dont les valeurs sont des chaînes de caractères peuvent être définies à toutes les valeurs.
.IP \-\-off
Désactive la sortie
.IP "\-\-crtc <crtc>"
Emploie le CRTC indiqué (comme indexé dans la liste de CRTCs ou de XID). Normalement, cette option n'est pas exigée lorsque xrandr essaye de faire le choix délicat du crtc à employer avec chaque sortie. Quand ce choix échoue pour quelque raison, cette option peut remplacer le choix normal.
.IP "\-\-gamma \fIred\fP:\fIgreen\fP:\fIblue\fP"
Définit les valeurs, spécifiées en virgule flottante, comme correction
gamma pour le CRTC actuellement branché à cette sortie. Remarquez que
pour des sorties clonées (c-à-d qui partagent le même CRTC) les valeurs
seront identiques, et que le changement d'une sortie vers un autre CRTC
ne modifie pas la correction gamma du CRTC.
.IP "\-\-brightness \fIbrightness\fP"
Multiplie les valeurs gamma sur le CRTC actuellement rattaché à la sortie par la valeur flottante spécifiée. Utile pour des sorties trop vives ou trop sombres.
.PP
.SH "Options de la version 1.1 de RandR"
Ces options sont disponibles pour les serveurs X qui ont la version 1.1 de RandR ou une plus ancienne. Elles sont toujours valides pour les versions plus récentes, mais elles ne sont pas recommandées.
.IP "\-s, \-\-size <index de taille> ou <largeur>x<hauteur>"
Configure la taille de l'écran en utilisant l'index dans la liste de tailles disponibles ou la taille exacte.
.IP "\-r, \-\-rate, \-\-refresh \fIrate\fP"
Selectionne la fréquence de rafraîchissement la plus proche de la valeur spécifiée.
.IP "\-o, \-\-orientation rotation"
Spécifie l'orientation de l'écran, et peut être choisie parmi "normal", "inverted", "left" ou "right"
.IP \-x
Inversion de l'image sur l'axe des X.
.IP \-y
Inversion de l'image sur l'axe des Y.
.SH "EXEMPLES"
Configure la sortie appelée LVDS au mode préféré de l'écran, et place à sa droite la sortie appelée VGA au mode
préféré de son écran avec une rotation dans le sens des aiguilles d'une montre :
.RS
xrandr \-\-output LVDS \-\-auto \-\-rotate normal \-\-pos 0x0 \-\-output VGA \-\-auto \-\-rotate left \-\-right\-of LVDS
.RE
.PP
Force l'utilisation d'un mode 1024x768 sur la sortie VGA :
.RS
xrandr \-\-newmode "1024x768" 63.50 1024 1072 1176 1328 768 771 775 798 \-hsync +vsync
.br
xrandr \-\-addmode VGA 1024x768
.br
xrandr \-\-output VGA \-\-mode 1024x768
.RE
.PP
Active le panning sur le bureau 1600x768 pendant l'affichage en 1024x768 sur la sortie VGA:
.RS
xrandr \-\-fb 1600x768 \-\-output VGA \-\-mode 1024x768 \-\-panning 1600x0
.RE
.PP
Active un petit écran LVDS en 1280x800 pour montrer un bureau de 3200x2000 et avoir un grand écran VGA
affichant les environs de la souris à la taille normale.
.RS
xrandr \-\-fb 3200x2000 \-\-output LVDS \-\-scale 2.5x2.5 \-\-output VGA \-\-pos 0x0 \-\-panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64
.RE
.PP
Affiche la sortie VGA en transformation trapézoïdale de sorte qu'il soit projeté correctement
lorsque le projecteur est légèrement supérieur à l'écran :
.RS
xrandr \-\-fb 1024x768 \-\-output VGA \-\-transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
.RE
.SH "VOIR AUSSI"
Xrandr(3), cvt(1), xkeystone(1)
.SH "AUTEURS"
Keith Packard,
Open Source Technology Center, Intel Corporation.
et
Jim Gettys,
Cambridge Research Laboratory, HP Labs, HP.
.SH "TRADUCTION"
Ce document est une traduction, réalisée par Gérard Delafond le 06 mars 2005 et par Bernard SIAUD le 20 mai 2007, le 21 décembre 2008 et le 5 janvier 2010
L'équipe de traduction à fait le maximum pour réaliser une adaptation française de qualité
La version anglaise la plus à jour de ce document est toujours consultable via la commande : LANGUAGE=en man xrandr
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans de cette page de manuel. |
