XRANDR(1) General Commands Manual XRANDR(1) NOM xrandr - interface primitive de l'extension RandR en ligne de commande SYNOPSIS xrandr [--help] [--display affichage] [-q] [-v] [--verbose] [--dryrun] [--screen num_ecran] [--q1] [--q12] [--current] [--noprimary] [--panning largeurxhauteur[+x+y[/track_widthxtrack_height+track_x+track_y[/bordure_gauche/bordure_haut/bordure_droite/bordure_bas]]]] [--scale x[xy]] [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb largeurxhauteur] [--fbmm largeurxhauteur] [--dpi dpi] [--dpi depuis-sortie] [--newmode nom mode] [--rmmode nom] [--addmode sortie nom] [--delmode sortie nom] [--output sortie] [--auto] [--mode mode] [--preferred] [--pos xxy] [--rate freq] [--reflect reflexion] [--rotate orientation] [--left-of sortie] [--right-of sortie] [--above sortie] [--below sortie] [--same-as sortie] [--set caracteristique valeur] [--off] [--crtc crtc] [--gamma rouge[:vert:bleu]] [--brightness luminosite] [-o orientation] [-s taille] [-r freq] [-x] [-y] [--listproviders] [--setprovideroutputsource fournisseur source] [--setprovideroffloadsink fournisseur sink] [--listmonitors] [--listactivemonitors] [--setmonitor nom geometrie sorties] [--delmonitor nom] DESCRIPTION Xrandr est utilise pour specifier la taille, l'orientation ou la reflexion des sorties d'un ecran. Il peut egalement specifier la taille de l'ecran. Si appele sans aucune option, il affichera le statut des sorties, montrant les modes existant pour chacune d'entre elles, avec un << + >> apres les modes preferes et une << * >> apres le mode en cours. Il y a peu d'options globales. Les autres options modifient la derniere sortie specifiee dans les parametres precedents passes dans la ligne de commande. De nombreuses sorties peuvent etre modifiees au meme moment a l'aide de plusieurs options --output suivies immediatement par leurs options de modification correspondantes. --help Afficher un sommaire des differentes utilisations possibles et sortir. -v, --version Afficher la version de RandR rapportee par le serveur X et sortir. --verbose xrandr devient plus verbeux. Quand utilise avec -q (ou sans autre option), xrandr affichera plus d'informations sur l'etat du serveur. Veuillez noter que les informations sur le gamma et la luminosite sont seulement des approximations du profil couleur du serveur. Quand utilise avec des options qui reconfigurent le systeme, l'evolution sera rapportee pendant les changements de configuration. -q, --query Quand cette option est presente, ou quand aucun changement de configuration n'a ete demande, xrandr affichera l'etat actuel du systeme. --dryrun Effectuer toutes les actions specifiees sans apporter aucune modification. --nograb Appliquer les modifications sans neutraliser l'ecran. Cela evite de bloquer les autres applications lors de la mise a jour, mais cela pourrait conduire certaines applications qui detectent le redimensionnement de l'ecran a recevoir les anciennes valeurs. -d, --display nom Cette option selectionne l'ecran X a utiliser. Veuillez noter que cela concerne la forme abstraite de l'ecran X, non le moniteur (ou la sortie). --screen num-ecran Cette option selectionne l'ecran a manipuler. Veuillez noter que cela concerne la forme abstraite de l'ecran X, non le moniteur (ou la sortie). --q1 Forcer l'utilisation de la version 1.1 du protocole RandR, meme si une version plus recente est disponible. --q12 Forcer l'utilisation de la version 1.2 du protocole RandR, meme si l'ecran ne semble pas etre compatible ou qu'une version plus recente soit disponible. Options de RandR version 1.5 Les options de RandR 1.5 sont utilisees comme une supercollection des options de RandR 1.4. --listmonitors Rapporter des informations sur tous les moniteurs definis. --listactivemonitors Rapporter des informations sur les moniteurs actifs en ce moment. --setmonitor nom geometrie sorties Definir un nouvel ecran avec une certaine geometrie et les sorties associees. La liste en sortie est soit le mot clef none ou soit une liste de sorties separees par des virgules. La geometrie est soit le mot clef auto, celui-ci conduira le moniteur a suivre automatiquement la geometrie des sorties associees, ou soit une specification manuelle sous la forme w/mmwxh/mmh+x+y ou w,h, x, y sont exprimes en pixels et ou mmw, mmh sont les dimensions physiques du moniteur. --delmonitor nom Supprimer le moniteur defini par l'utilisateur. Options de RandR version 1.4 Les options de RandR 1.4 sont utilisees comme une supercollection des options de RandR 1.3. --listproviders Rapporter des informations sur les fournisseurs disponibles. --setprovideroutputsource fournisseur source Definir source en tant que source des images de la sortie d'affichage pour fournisseur. Cela n'est possible que si source et fournisseur ont, respectivement, les possibilites Source Output et Sink Output. Si source vaut 0x0, fournisseur est deconnecte de sa source d'affichage actuelle. --setprovideroffloadsink fournisseur sink Definir fournisseur en tant que peripherique de destination pour le rendu de sink. Cela n'est possible que si fournisseur et sink ont respectivement les possibilites Source Offload et Sink Offload. Si sink vaut 0x0, fournisseur est deconnecte de sa source de destination de rendu. Options de RandR version 1.3 Les options de RandR 1.3 sont utilisees comme une supercollection des options de RandR 1.2. --current Retourner la configuration de l'ecran en cours, sans recherche de changements materiels. --noprimary Ne pas definir de sortie primaire. Options par sortie --panning largeurxhauteur[+x+y[/track_widthxtrack_height+track_x+track_y[/bordure_gauche/bordure_haute/bordure_droite/bordure_bas]]] Cette option definit les parametres de glissement. Des que le glissement est active, la position du CRTC peut changer a chaque mouvement du pointeur. Les quatre premiers parametres indiquent la zone du glissement, les quatre suivants celle de poursuite du pointeur (qui est par defaut la meme). Les quatre derniers parametres indiquent la bordure et sont a 0 par defaut. Une largeur ou une hauteur a 0 desactivent le glissement sur l'axe en question. Vous devez generalement definir simultanement la taille de l'ecran avec --fb. --transform a,b,c,d,e,f,g,h,i Specifier une matrice de transformation a appliquer a la sortie. Un filtre bilineaire est automatiquement selectionne sauf si le parametre --filter est egalement specifie. La formule mathematique correspond a : a b c d e f g h i La transformation s'appuie sur des coordonnees homogenes. La matrice multipliee par les composantes vectorielles d'un pixel d'affichage donne les composantes vectorielles transformees d'un pixel dans le tampon graphique. Plus precisement, le vecteur (x y) du pixel d'affichage est etendu a trois valeurs (x y w), avec 1 comme coordonnee w multiplie par la matrice. Les coordonnees du pixel final du peripherique sont alors calculees avec ce qu'on appelle la division homogene par la coordonnee w transformee. Autrement dit, les coordonnees (x' y') du pixel transforme sont : x' = (ax + by + c) / w' et y' = (dx + ey + f) / w' , avec w' = (gx + hy + i) . Typiquement, a et e correspondent a la mise a l'echelle sur les axes X et Y, c et f correspondent a la translation sur ces axes, et g, h et i sont respectivement 0, 0 et 1. Cette matrice peut etre egalement utilisee pour formuler des transformations plus complexes telles que la correction de trapeze, ou la rotation. Pour une rotation d'un angle T, cette formule peut etre utilisee : cos T -sin T 0 sin T cos T 0 0 0 1 En tant qu'argument special, on peut passer, a la place d'une matrice, la chaine de caracteres none : dans ce cas les valeurs par defaut sont utilisees (une matrice unitaire sans filtre). --filter mode-de-filtre Choisir une methode de mise a l'echelle quand l'ecran est redimensionne ou transforme. Peut etre soit << bilinear >> (bilineaire) ou << nearest >> (le plus proche). --scale x[xy] Changer les dimensions de l'image en sortie. Si la valeur y est omise, la valeur x sera utilisee pour les deux dimensions. Les valeurs plus grandes que 1 resultent en un ecran compresse (un ecran aux dimensions plus grandes que celles de la sortie), et inversement pour les valeurs inferieures a 1. Cette option est en fait une version simplifiee de l'option --transform. --scale-from wxh Specifier la taille en pixels de la zone du framebuffer a afficher sur cette sortie. Cette option est en fait une version raccourcie de l'option --transform. --primary Specifier la sortie comme primaire. Elle sera affichee en premier lors des requetes geometriques Xinerama et RANDR. Options de RandR version 1.2 Ces options sont disponibles pour un serveur X gerant RandR version 1.2 ou ulterieure. --prop, --properties Cette option conduit xrandr a afficher le contenu des proprietes de chaque sortie. --verbose active implicitement --prop. --fb largeurxhauteur Reconfigure l'ecran avec la taille specifiee. Tous les moniteurs configures doivent tenir dans cette taille. Quand cette option n'est pas fournie, xrandr calcule la plus petite taille de l'ecran qui contiendra toute la collection de sorties configurees. Cette option fournit un moyen de surcharger ce comportement. --fbmm largeurxhauteur Specifier la valeur rapportee comme taille physique de l'ecran X dans son entier (la reunion de tous les moniteurs configures). Dans des configurations avec plusieurs moniteurs ayant des resolutions differentes, la valeur n'a pas de signification physique mais peut etre utilisee sur certains anciens clients qui ne gerent pas RandR version 1.2 afin de calculer une mise a l'echelle de la fonte de reference. Normalement, xrandr reinitialise les valeurs rapportees de la taille physique afin de maintenir le DPI constant. Cela surcharge la maniere de calculer. Le DPI par defaut est 96. --dpi dpi --dpi depuis-sortie Cela definit egalement la valeur rapportee comme taille physique de l'ecran X dans son entier (reunion de tous les moniteurs configures). Dans des configurations avec plusieurs moniteurs de differentes resolutions, la valeur n'a pas de sens physique, mais elle peut etre utilisee par des clients primaires qui ne prennent pas en charge RandR version 1.2 pour calculer une mise a l'echelle de la fonte de reference. Cette option utilise soit la valeur de DPI specifiee, soit la DPI de la sortie donnee, pour calculer une taille physique adaptee en utilisant n'importe quelle taille de pixel qui sera definie. Les valeurs classiques sont celles par defaut (96 dpi), le DPI du seul moniteur dans les configurations a un moniteur, ou le DPI du moniteur primaire dans les configurations a plusieurs moniteurs. --newmode nom mode De nouvelles definitions d'ecran (modeline) peuvent etre ajoutees au serveur puis associees aux sorties. Cette option fait la premiere chose. Le mode est indique en utilisant la syntaxe Modeline pour xorg.conf : les drapeaux clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal. Les drapeaux peuvent valoir 0 ou plus de +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Divers outils permettent de calculer les definitions habituelles a partir de la hauteur, de la largeur et de la frequence de rafraichissement, vous pouvez par exemple utiliser cvt. --rmmode nom Cela supprime un mode du serveur s'il n'est utilise autrement. --addmode sortie nom Ajouter un mode a l'ensemble des modes valables pour une sortie. --delmode sortie nom Supprimer un mode de l'ensemble des modes valables pour une sortie. Options par sortie --output sortie Selectionner une sortie a reconfigurer. Utilisez soit le nom de la sortie soit son XID. --auto Pour les sorties connectees mais desactivees, cela les activera en utilisant leur premier mode prefere (ou, si aucun mode n'est prefere, quelque chose de proche de 96 dpi). Pour les sorties deconnectees mais activees, cela les desactivera. --mode mode Cela selectionne un mode. Utilisez soit le nom ou le XID pour mode --preferred Cela selectionne le meme mode que --auto, a l'exception qu'il n'active ou ne desactive pas automatiquement la sortie. --pos xxy Positionner la sortie sur l'ecran en utilisant des coordonnees en pixels. Si une reflexion ou une rotation est appliquee, la translation s'opere apres ses effets. --rate freq Cela marque une preference pour les frequences de rafraichissement proches de la valeur specifiee, quand de nombreux modes ont le meme nom. Cela selectionnera la frequence de rafraichissement qui est la plus proche. --reflect reflexion Reflexion peut etre << normal >>, << x >>, << y >> ou << xy >>. Cela reflechit le contenu de la sortie selon les axes donnes. --rotate rotation La rotation peut etre soit << normal >> (normale), soit << left >> (gauche), soit << right >> (droite) ou encore << inverted >> (inversee). Cela conduit le contenu des sorties a etre pivote vers certaine direction. << right >> (droite) specifie une rotation dans le sens des aiguilles d'une montre et inversement pour << left >> (gauche). --left-of, --right-of, --above, --below, --same-as autre-sortie Utiliser une de ces options pour positionner la sortie par rapport a la position d'une autre sortie. Cela permet d'arranger commodement les sorties a l'interieur de un ecran. La position est toujours calculee par rapport a la nouvelle position de l'autre sortie, donc on ne peut pas dire --output a --left-of b --output b --left-of a. --set caracteristique valeur Definir les caracteristiques d'une sortie. Des caracteristiques numeriques peuvent etre indiquees (voir --prop) dans une liste separee par des virgules de valeurs decimales ou hexadecimales (precedees de 0x). Les proprietes atomiques peuvent etre positionnees sur n'importe quel valeur atomique (voir --prop). Les caracteristiques de chaine peuvent etre positionnees a n'importe quelle valeur. --off Desactiver la sortie. --crtc crtc Utiliser le crtc specifie (soit comme index d'une liste de CRTC ou d'XID). Normalement, cette option n'est pas necessaire car xrandr essaie de faire des choix senses quant au crtc a utiliser avec chaque sortie. Quand cela echoue pour une raison ou pour une autre, cette option peut outrepasser la selection normale. --gamma rouge[:vert:bleu] Faire des valeurs decimales specifiees une correction gamma sur le CRTC actuellement connecte a la sortie. Si vert et bleu ne sont pas indiques, la valeur rouge sera utilisee pour les trois composants. Remarquez que vous ne pouvez pas avoir deux valeurs differentes pour deux sorties clones (a savoir qui partagent le meme CRTC) et que le passage d'une sortie vers un autre CRTC ne modifie en aucun cas les corrections gamma du CRTC. --brightness luminosite Multiplier les valeurs gamma du CRTC connecte a la sortie par la valeur decimale specifiee. Utile pour des sorties a la luminosite trop importante ou trop faible. Toutefois, il ne s'agit que d'une modification logicielle, si votre materiel gere, en fait, la modification de la luminosite, vous prefererez probablement utiliser xbacklight. Options de RandR version 1.1 Ces options sont disponibles pour les serveurs X prenant en charge RandR version 1.1 ou inferieure. Elles fonctionnent encore sur les nouveaux serveurs X, mais elles n'interagissent pas sensiblement avec les options de la version 1.2 sur la meme ligne de commande. -s, --size size-index ou --size largeurxhauteur Cela determine la taille de l'ecran, soit en l'adaptant a la taille soit en utilisant l'index de la liste des tailles disponibles. -r, --rate, --refresh freq Cela specifie la frequence de rafraichissement le plus proche de la valeur donnee. -o, --orientation rotation Cela specifie l'orientation de l'ecran, et peut etre soit normal (normale), soit inverted (inversee), soit left (gauche) ou right (droite). -x Reflexion sur l'axe X. -y Reflexion sur l'axe Y. EXEMPLES Positionner une sortie appelee LVDS sur son mode prefere, puis positionner a sa droite une sortie appelee VGA sur le mode prefere de l'ecran physiquement oriente dans le sens des aiguilles d'une montre : xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS Forcer l'utilisation du mode 1024x768 sur une sortie se nommant 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 Activer le glissement sur un bureau de 1600x768 dans un affichage en mode 1024x768 sur une sortie appelee VGA : xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0 Avoir un petit ecran LVDS 1280x800 affichant une petite version d'un grand bureau de 3200x2000 et avoir un grand ecran VGA pour afficher l'environnement de la souris dans une 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 Afficher la sortie VGA sous forme de trapeze pour une correction logicielle (keystone) si le videoprojecteur est legerement au-dessus de l'ecran : 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 La traduction francaise de cette page de manuel a ete creee par Jose JORGE, Cyril Guilloud , Simon Depiets, Gerard Delafond , Bernard Siaud, Nicolas Francois , David Prevot , Jean-Philippe MENGUAL et Matteo RossillolLaruelle Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . X Version 11 xrandr 1.5.2 XRANDR(1)