Provided by: manpages-fr-extra_20111118_all bug

NOM

       xrandr - Interface primitive en ligne de commande pour l'extension RandR

SYNOPSIS

       xrandr  [-help] [-display display] [-q] [-v] [--verbose] [--dryrun] [--screen snum] [--q1]
       [--q12]
       Options de la version 1.3 de RandR
       [--current] [--noprimary]
       Options par sortie
       [--panning
       largeurxhauteur[+x+y[/largeur_pistexhauteur_piste+piste_x+piste_y[/bord_gauche/bord_haut/bord_droit/bord_bas]]]]
       [--scale xxy] [--transform a,b,c,d,e,f,g,h,i] [--primary]
       Options de la version 1.2 de RandR
       [--prop] [--fb largeurxhauteur] [--fbmm largeurxhauteur] [--dpi dpi] [--newmode nom  mode]
       [--rmmode nom] [--addmode sortie nom] [--delmode sortie nom]
       Options par sortie
       [--output  sortie]  [--auto]  [--mode  mode]  [--preferred] [--pos xxy] [--rate fréquence]
       [--reflect  symétrie]  [--rotate  orientation]  [--left-of  sortie]  [--right-of   sortie]
       [--above  sortie]  [--below  sortie]  [--same-as  sortie] [--set propriété valeur] [--off]
       [--crtc crtc] [--gamma rouge:vert:bleu] [--brightness luminosité]

       Options des versions 1.0 et 1.1 de RandR
       [-o orientation] [-s taille] [-r fréquence] [-x] [-y]

DESCRIPTION

       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
       modes pour chacune d'elles, avec un '+' après le mode préféré et  un  '*'  après  le  mode
       actuel.

       Il y a quelques options globales. Les autres modifient la dernière sortie indiquée par les
       paramètres précédents de  la  ligne  de  commande.  Les  sorties  multiples  peuvent  être
       modifiées simultanément en plaçant plusieurs --output immédiatement suivies des options de
       la sortie correspondante

       -help  Affiche un résumé sur l'utilisation puis quitter.

       -v, --version
              Affiche la version de RandR renvoyée par le serveur X puis quitter.

       --verbose
              Rend xrandr plus verbeux. En combinaison avec -q (ou  sans  autre  option),  xrandr
              montrera  plus  de renseignements sur l'état du serveur. Veuillez remarquer que les
              renseignements à propos du gamma et de la luminosité ne sont que des approximations
              du profil de couleur complet stocké dans le serveur. Avec des options qui modifient
              le  système,  les  modifications  seront  affichées  lorsque  les  changements   de
              configuration sont effectués.

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

       --dryrun
              Effectue  toutes  les  actions  spécifiées  sans  qu'aucune  modification  ne  soit
              apportée.

       --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 anciennes valeurs.

       -d, -display nom
              Cette option permet de sélectionner l'affichage X à utiliser.  Noter  que  ceci  se
              rapporte  à  l'abstraction de l'affichage, mais pas au comportement du moniteur (la
              sortie).

       --screen num_écran
              Cette option choisit quelle configuration  d'écran  modifier.  Noter  que  ceci  se
              rapporte  à  l'abstraction de l'affichage, mais pas au comportement du moniteur (la
              sortie).

       --q1   Oblige l'utilisation de la version 1.1 du protocole  RandR,  même  si  une  version
              supérieure est disponible.

       --q12  Oblige  l'utilisation  de la version 1.2 du protocole RandR, même si elle n'est pas
              indiquée comme étant prise en charge ou si une version supérieure est disponible.

Options de la version 1.3 de RandR

       Les options de RandR 1.3 sont utilisées en plus des options possibles pour RandR 1.2.

       --current
              Renvoie la configuration actuelle de l'écran, sans modification matérielle.

       --noprimary
              Ne définit pas de sortie principale.

       Options par sortie

       --panning
       largeurxhauteur[+x+y[/largeur_pistexhauteur_piste+piste_x+piste_y[/bord_gauche/bord_haut/bord_droit/bord_bas]]]
              Cette option définit les paramètres de panorama. Dès que cette option est  activée,
              la  position  CRTC  de  l'écran  bouge avec les mouvements de la souris. Les quatre
              premiers paramètres définissent l'aire de panorama. Les quatre suivants, la zone de
              suivi (qui est la même par défaut). Les quatre derniers, les bords, à 0 par défaut.
              Une hauteur ou une 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.

       --transform a,b,c,d,e,f,g,h,i
              Indique une matrice de transformation à appliquer à la sortie. Un filtre bilinéaire
              est automatiquement sélectionné. La forme mathématique est :
                     a b c
                     d e f
                     g h i
              La transformation repose sur des coordonnées homogènes. La matrice  multipliée  par
              le vecteur de coordonnées d'un pixel de la sortie fournit le vecteur de coordonnées
              transformé d'un pixel du tampon graphique. Plus précisément, le vecteur (x,  y)  du
              pixel de sortie est étendu en trois dimensions (x, y, w), avec 1 pour coordonnée w,
              et multiplie la matrice. Les coordonnées finales  de  périphérique  du  pixel  sont
              alors  calculées  avec  la  division  homogène  par  la  coordonnée  w transformée.
              Autrement dit, les coordonnées de périphérique (x', y') du pixel transformé sont :
                     x' = (ax + by + c) / w' et
                     y' = (dx + ey + f) / w',
                     avec w' = (gx + hy + i).
              Typiquement, a et e correspondent à l'échelle selon  les  axes  X  et  Y,  c  et  f
              correspondent  à  une  translation  suivant  ces  mêmes  axes,  et  g,  h et i sont
              respectivement 0, 0 et 1. La matrice peut également être utilisée pour exprimer des
              transformations plus compliquées, comme la correction de trapèze (« keystone »), ou
              la rotation. Pour une  rotation  d'un  angle  T,  la  formule  suivante  peut  être
              utilisée :
                     cos T -sin T   0
                     sin T  cos T   0
                       0      0     1
              Comme  paramètre  spécial,  au lieu de passer une matrice, on peut passer la chaîne
              none, dans ce cas les valeurs par défaut sont utilisées (une matrice unitaire  sans
              filtre).

       --scale xxy
              Modifie  les  dimensions  de  l'image  de  sortie.  Les  valeurs  supérieures  à  1
              entraîneront une compression de  l'écran  (dimension  de  l'écran  supérieures  aux
              dimensions  du  mode de sortie) et les valeurs inférieures à 1 entraîneront un zoom
              de la  sortie.  Cette  option  est  en  fait  une  version  raccourci  de  l'option
              --transform.

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

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.

       --prop, --properties
              Cette  option  fait  afficher par xrandr les propriétés de chaque sortie. --verbose
              active également --prop.

       --fb largeurxhauteur
              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.

       --fbmm largeurxhauteur
              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.

       --dpi dpi
              Configure aussi la taille physique de  l'écran.  Il  utilise  la  valeur  DPI  pour
              calculer  la  taille  physique  de  l'écran  quelle  que  soit la taille des pixels
              configurée.

       --newmode nom mode
              De nouveaux modelines peuvent être  ajoutés  au  serveur  puis  associés  avec  des
              sorties.  Cette  option  ajoute  un  modeline  au  serveur.  Le  mode est défini en
              utilisant  la  syntaxe  des  ModeLine  de  xorg.conf :   clock   hdisp   hsyncstart
              hsyncend htotal vdisp vsyncstart vsyncend vtotal  flags.  On  peut omettre flags 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 la fréquence de rafraîchissement. Par exemple, vous
              pouvez utiliser cvt.

       --rmmode nom
              Supprime un mode du serveur s'il n'est pas utilisé.

       --addmode sortie nom
              Ajoute un mode à l'ensemble des modes valables d'une sortie.

       --delmode sortie nom
              Enlève un mode à l'ensemble des modes valables d'une sortie.

       Options par sortie

       --output sortie
              Sélectionne la sortie à reconfigurer. Utiliser le nom de la sortie ou le XID.

       --auto Pour  les  sorties connectées mais désactivées, ceci les activera en utilisant 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 désactivera.

       --mode mode
              Ceci sélectionne un mode. Utilisez le nom ou le XID du mode.

       --preferred
              Sélectionne   le   même  mode  que  --auto,  mais  n'active  ou  ne  désactive  pas
              automatiquement la sortie.

       --pos xxy
              Positionne la sortie dans l'écran en utilisant des coordonnées de pixels.  Dans  le
              cas  où  une  symétrie  ou une rotation est appliquée, la translation est appliquée
              après cet effet.

       --rate fréquence
              Ceci marque une préférence pour des fréquences de  rafraîchissement  autour  de  la
              valeur  indiquée.  Quand  plusieurs modes ont le même nom, ceci choisira le mode le
              plus proche de la fréquence de rafraîchissement.

       --reflect symétrie
              La symétrie peut être  « normal »,  « x »,  « y »  ou  « xy ».  Ceci  effectue  une
              symétrie par rapport aux axes indiqués.

       --rotate rotation
              Rotation  peut  être  « normal »,  « left », « right » ou « inverted ». Ceci génère
              respectivement une rotation de la sortie « sans rotation », « à gauche »  (dans  le
              sens  inverse des aiguilles d'une montre), « à droite » (dans le sens des aiguilles
              d'une montre) ou « à l'envers ».

       --left-of, --right-of, --above, --below, --same-as autre_sortie
              Chaque option place la sortie relativement à  une  autre  sortie.  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.

       --set propriété valeur
              Définit  une  propriété  d'une sortie. Les valeurs entières peuvent être spécifiées
              comme une valeur décimale ou hexadécimale (avec un 0x) valable (voir  --prop).  Les
              propriétés  atomiques  peuvent  prendre  pour  valeur toute valeur atomique valable
              (voir --prop). Les  propriétés  prenant  une  chaînes  acceptent  n'importe  quelle
              valeur.

       --off  Désactive la sortie.

       --crtc crtc
              Utilise  le  CRTC  indiqué  (comme  indexé  dans  la  liste  de  CRTC  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.

       --gamma rouge:vert:bleu
              Définit les valeurs, indiquées en virgule flottante, comme correction gamma pour le
              CRTC  actuellement  branché  à cette sortie. Remarquez que pour des sorties clonées
              (c'est-à-dire qui partage le même CRTC) les valeurs doivent être identiques et  que
              le changement d'une sortie vers un autre CRTC ne modifie pas la correction gamma du
              CRTC.

       --brightness luminosité
              Multiplie les valeurs de gamma du CRTC attaché en ce moment  à  la  sortie  par  la
              valeur à virgule flottante indiquée. Utile pour les sorties trop lumineuses ou trop
              sombres. Toutefois, ce n'est qu'une modification logicielle, si votre matériel gère
              la  modification  réelle  de luminosité, l'utilisation de xbacklight est sans doute
              préférable.

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
       version  plus  ancienne.  Elles  sont toujours valables pour les serveurs X plus récentes,
       mais elles n'interagissent pas très bien avec des options de la version 1.2  sur  la  même
       ligne de commande.

       -s, --size index de taille ou --size largeurxhauteur
              Configure  la  taille de l'écran en utilisant la taille indiquée ou l'index dans la
              liste de tailles disponibles.

       -r, --rate, --refresh fréquence
              Définit la fréquence de rafraîchissement à  la  valeur  la  plus  proche  de  celle
              spécifiée.

       -o, --orientation rotation
              Spécifie  l'orientation  de  l'écran,  qui  peut  être  choisie  parmi  « normal »,
              « inverted », « left » ou « right ».

       -x     Inversion de l'image sur l'axe des X.

       -y     Inversion de l'image sur l'axe des Y.

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 :
              xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto  --rotate
              left --right-of LVDS

       Force l'utilisation d'un mode 1024x768 sur la sortie VGA :
              xrandr --newmode "1024x768" 63.50 1024 1072 1176 1328 768 771 775 798 -hsync +vsync
              xrandr --addmode VGA 1024x768
              xrandr --output VGA --mode 1024x768

       Active  le  mode  panoramique  sur  un bureau 1600x768 avec l'affichage en 1024x768 sur la
       sortie VGA:
              xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0

       Active un petit écran LVDS en 1280x800 pour montrer une  petite  version  d'un  bureau  de
       3200x2000  et  avoir  un  grand  écran VGA affichant les environs de la souris à la taille
       normale.
              xrandr --fb  3200x2000  --output  LVDS  --scale  2.5x2.5  --output  VGA  --pos  0x0
              --panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64

       Affiche  la  sortie  VGA sous forme trapézoïdale pour corriger l'image quand le projecteur
       est légèrement au dessus de l'écran :
              xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1

VOIR AUSSI

       Xrandr(3), cvt(1), xkeystone(1), xbacklight(1)

AUTEURS

       Keith Packard, Open Source Technology Center, Intel Corporation. et Jim Gettys,  Cambridge
       Research Laboratory, HP Labs, HP.

TRADUCTION

       Cette  page  de  manuel  a  été  traduite par Gérard Delafond en 2005 puis mise à jour par
       Bernard SIAUD de 2007 à 2010.

       La version présente dans Debian est dorénavant maintenue  par  les  membres  de  la  liste
       <debian-l10n-french  AT  lists  DOT  debian  DOT  org>.  Veuillez signaler toute erreur de
       traduction par un rapport de bogue sur le paquet manpages-fr-extra.