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. |
Partager