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_écran] [--q1] [--q12] [--current] [--noprimary] [--pan-
ning largeurxhauteur[+x+y[/track_widthx-
track_height+track_x+track_y[/bordure_gauche/bordure_haut/bor-
dure_droite/bordure_bas]]]] [--scale x[xy]] [--scale-from wxh]
[--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb largeurxhau-
teur] [--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 fréq] [--reflect réflexion] [--rotate orientation]
[--left-of sortie] [--right-of sortie] [--above sortie] [--below sor-
tie] [--same-as sortie] [--set caractéristique valeur] [--off] [--crtc
crtc] [--gamma rouge[:vert:bleu]] [--brightness luminosité] [-o orien-
tation] [-s taille] [-r fréq] [-x] [-y] [--listproviders] [--setprovi-
deroutputsource fournisseur source] [--setprovideroffloadsink fournis-
seur sink] [--listmonitors] [--listactivemonitors] [--setmonitor nom
géométrie sorties] [--delmonitor nom]
DESCRIPTION
Xrandr est utilisé pour spécifier la taille, l'orientation ou la ré-
flexion des sorties d'un écran. Il peut également spécifier la taille
de l'écran.
Si appelé sans aucune option, il affichera le statut des sorties, mon-
trant les modes existant pour chacune d'entre elles, avec un « + »
après les modes préférés et une « * » après le mode en cours.
Il y a peu d'options globales. Les autres options modifient la dernière
sortie spécifiée dans les paramètres précédents passés dans la ligne de
commande. De nombreuses sorties peuvent être modifiées au même moment à
l’aide de plusieurs options --output suivies immédiatement par leurs
options de modification correspondantes.
--help Afficher un sommaire des différentes utilisations possibles et
sortir.
-v, --version
Afficher la version de RandR rapportée par le serveur X et sor-
tir.
--verbose
xrandr devient plus verbeux. Quand utilisé avec -q (ou sans
autre option), xrandr affichera plus d'informations sur l’état
du serveur. Veuillez noter que les informations sur le gamma et
la luminosité sont seulement des approximations du profil cou-
leur du serveur. Quand utilisé avec des options qui reconfi-
gurent le système, l’évolution sera rapportée pendant les chan-
gements de configuration.
-q, --query
Quand cette option est présente, ou quand aucun changement de
configuration n'a été demandé, xrandr affichera l’état actuel du
système.
--dryrun
Effectuer toutes les actions spécifiées sans apporter aucune mo-
dification.
--nograb
Appliquer les modifications sans neutraliser l'écran. Cela évite
de bloquer les autres applications lors de la mise à jour, mais
cela pourrait conduire certaines applications qui détectent le
redimensionnement de l'écran à recevoir les anciennes valeurs.
-d, --display nom
Cette option sélectionne l'écran X à utiliser. Veuillez noter
que cela concerne la forme abstraite de l'écran X, non le moni-
teur (ou la sortie).
--screen num-écran
Cette option sélectionne l'écran à manipuler. Veuillez noter que
cela concerne la forme abstraite de l'écran X, non le moniteur
(ou la sortie).
--q1 Forcer l'utilisation de la version 1.1 du protocole RandR, même
si une version plus récente est disponible.
--q12 Forcer l'utilisation de la version 1.2 du protocole RandR, même
si l'écran ne semble pas être compatible ou qu'une version plus
récente soit disponible.
Options de RandR version 1.5
Les options de RandR 1.5 sont utilisées comme une supercollection des
options de RandR 1.4.
--listmonitors
Rapporter des informations sur tous les moniteurs définis.
--listactivemonitors
Rapporter des informations sur les moniteurs actifs en ce mo-
ment.
--setmonitor nom géométrie sorties
Définir un nouvel écran avec une certaine géométrie et les sor-
ties associées. La liste en sortie est soit le mot clef none ou
soit une liste de sorties séparées par des virgules. La géomé-
trie est soit le mot clef auto, celui-ci conduira le moniteur à
suivre automatiquement la géométrie des sorties associées, ou
soit une spécification manuelle sous la forme w/mmwxh/mmh+x+y où
w,h, x, y sont exprimés en pixels et où mmw, mmh sont les dimen-
sions physiques du moniteur.
--delmonitor nom
Supprimer le moniteur défini par l'utilisateur.
Options de RandR version 1.4
Les options de RandR 1.4 sont utilisées comme une supercollection des
options de RandR 1.3.
--listproviders
Rapporter des informations sur les fournisseurs disponibles.
--setprovideroutputsource fournisseur source
Définir source en tant que source des images de la sortie d'af-
fichage pour fournisseur. Cela n'est possible que si source et
fournisseur ont, respectivement, les possibilités Source Output
et Sink Output. Si source vaut 0x0, fournisseur est déconnecté
de sa source d'affichage actuelle.
--setprovideroffloadsink fournisseur sink
Définir fournisseur en tant que périphérique de destination pour
le rendu de sink. Cela n'est possible que si fournisseur et sink
ont respectivement les possibilités Source Offload et Sink Of-
fload. Si sink vaut 0x0, fournisseur est déconnecté de sa source
de destination de rendu.
Options de RandR version 1.3
Les options de RandR 1.3 sont utilisées comme une supercollection des
options de RandR 1.2.
--current
Retourner la configuration de l'écran en cours, sans recherche
de changements matériels.
--noprimary
Ne pas définir de sortie primaire.
Options par sortie
--panning largeurxhauteur[+x+y[/track_widthx-
track_height+track_x+track_y[/bordure_gauche/bordure_haute/bor-
dure_droite/bordure_bas]]]
Cette option définit les paramètres de glissement. Dès que le
glissement est activé, la position du CRTC peut changer à chaque
mouvement du pointeur. Les quatre premiers paramètres indiquent
la zone du glissement, les quatre suivants celle de poursuite du
pointeur (qui est par défaut la même). Les quatre derniers pa-
ramètres indiquent la bordure et sont à 0 par défaut. Une lar-
geur ou une hauteur à 0 désactivent le glissement sur l'axe en
question. Vous devez généralement définir simultanément la
taille de l'écran avec --fb.
--transform a,b,c,d,e,f,g,h,i
Spécifier une matrice de transformation à appliquer à la sortie.
Un filtre bilinéaire est automatiquement sélectionné sauf si le
paramètre --filter est également spécifié. La formule mathéma-
tique correspond à :
a b c
d e f
g h i
La transformation s'appuie sur des coordonnées homogènes. La ma-
trice multipliée par les composantes vectorielles d'un pixel
d'affichage donne les composantes vectorielles transformées d'un
pixel dans le tampon graphique. Plus précisément, le vecteur (x
y) du pixel d'affichage est étendu à trois valeurs (x y w), avec
1 comme coordonnée w multiplié par la matrice. Les coordonnées
du pixel final du périphérique sont alors calculées avec ce
qu'on appelle la division homogène par la coordonnée w transfor-
mée. Autrement dit, les coordonnées (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 à la mise à l'échelle sur les
axes X et Y, c et f correspondent à la translation sur ces axes,
et g, h et i sont respectivement 0, 0 et 1. Cette matrice peut
être également utilisée pour formuler des transformations plus
complexes telles que la correction de trapèze, ou la rotation.
Pour une rotation d'un angle T, cette formule peut être utili-
sée :
cos T -sin T 0
sin T cos T 0
0 0 1
En tant qu'argument spécial, on peut passer, à la place d'une
matrice, la chaîne de caractères none : dans ce cas les valeurs
par défaut sont utilisées (une matrice unitaire sans filtre).
--filter mode-de-filtre
Choisir une méthode de mise à l'échelle quand l'écran est redi-
mensionné ou transformé. Peut être soit « bilinear » (bili-
néaire) 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 utilisée pour les deux dimensions. Les
valeurs plus grandes que 1 résultent en un écran compressé (un
écran aux dimensions plus grandes que celles de la sortie), et
inversement pour les valeurs inférieures à 1. Cette option est
en fait une version simplifiée de l'option --transform.
--scale-from wxh
Spécifier la taille en pixels de la zone du framebuffer à affi-
cher sur cette sortie. Cette option est en fait une version rac-
courcie de l'option --transform.
--primary
Spécifier la sortie comme primaire. Elle sera affichée en pre-
mier lors des requêtes géométriques Xinerama et RANDR.
Options de RandR version 1.2
Ces options sont disponibles pour un serveur X gérant RandR version 1.2
ou ultérieure.
--prop, --properties
Cette option conduit xrandr à afficher le contenu des propriétés
de chaque sortie. --verbose active implicitement --prop.
--fb largeurxhauteur
Reconfigure l'écran avec la taille spécifiée. Tous les moniteurs
configurés doivent tenir dans cette taille. Quand cette option
n'est pas fournie, xrandr calcule la plus petite taille de
l'écran qui contiendra toute la collection de sorties configu-
rées. Cette option fournit un moyen de surcharger ce comporte-
ment.
--fbmm largeurxhauteur
Spécifier la valeur rapportée comme taille physique de l'écran X
dans son entier (la réunion de tous les moniteurs configurés).
Dans des configurations avec plusieurs moniteurs ayant des réso-
lutions différentes, la valeur n'a pas de signification physique
mais peut être utilisée sur certains anciens clients qui ne
gèrent pas RandR version 1.2 afin de calculer une mise à
l'échelle de la fonte de référence. Normalement, xrandr réini-
tialise les valeurs rapportées de la taille physique afin de
maintenir le DPI constant. Cela surcharge la manière de calcu-
ler. Le DPI par défaut est 96.
--dpi dpi
--dpi depuis-sortie
Cela définit également la valeur rapportée comme taille physique
de l'écran X dans son entier (réunion de tous les moniteurs
configurés). Dans des configurations avec plusieurs moniteurs de
différentes résolutions, la valeur n'a pas de sens physique,
mais elle peut être utilisée par des clients primaires qui ne
prennent pas en charge RandR version 1.2 pour calculer une mise
à l’échelle de la fonte de référence. Cette option utilise soit
la valeur de DPI spécifiée, soit la DPI de la sortie donnée,
pour calculer une taille physique adaptée en utilisant n'importe
quelle taille de pixel qui sera définie. Les valeurs classiques
sont celles par défaut (96 dpi), le DPI du seul moniteur dans
les configurations à un moniteur, ou le DPI du moniteur primaire
dans les configurations à plusieurs moniteurs.
--newmode nom mode
De nouvelles définitions d’écran (modeline) peuvent être ajou-
tées au serveur puis associées aux sorties. Cette option fait la
première chose. Le mode est indiqué en utilisant la syntaxe Mo-
deline 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, In-
terlace, DoubleScan, CSync, +CSync, -CSync. Divers outils per-
mettent de calculer les définitions habituelles à partir de la
hauteur, de la largeur et de la fréquence de rafraîchissement,
vous pouvez par exemple utiliser cvt.
--rmmode nom
Cela supprime un mode du serveur s'il n'est utilisé autrement.
--addmode sortie nom
Ajouter un mode à l'ensemble des modes valables pour une sortie.
--delmode sortie nom
Supprimer un mode de l'ensemble des modes valables pour une sor-
tie.
Options par sortie
--output sortie
Sélectionner une sortie à reconfigurer. Utilisez soit le nom de
la sortie soit son XID.
--auto Pour les sorties connectées mais désactivées, cela les activera
en utilisant leur premier mode préféré (ou, si aucun mode n'est
préféré, quelque chose de proche de 96 dpi). Pour les sorties
déconnectées mais activées, cela les désactivera.
--mode mode
Cela sélectionne un mode. Utilisez soit le nom ou le XID pour
mode
--preferred
Cela sélectionne le même mode que --auto, à l'exception qu'il
n'active ou ne désactive pas automatiquement la sortie.
--pos xxy
Positionner la sortie sur l'écran en utilisant des coordonnées
en pixels. Si une réflexion ou une rotation est appliquée, la
translation s'opère après ses effets.
--rate fréq
Cela marque une préférence pour les fréquences de rafraichisse-
ment proches de la valeur spécifiée, quand de nombreux modes ont
le même nom. Cela sélectionnera la fréquence de rafraichissement
qui est la plus proche.
--reflect réflexion
Réflexion peut être « normal », « x », « y » ou « xy ». Cela ré-
fléchit le contenu de la sortie selon les axes donnés.
--rotate rotation
La rotation peut être soit « normal » (normale), soit « left »
(gauche), soit « right » (droite) ou encore « inverted » (inver-
sée). Cela conduit le contenu des sorties à être pivoté vers
certaine direction. « right » (droite) spécifie 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 rap-
port à la position d'une autre sortie. Cela permet d'arranger
commodément les sorties à l’intérieur de un écran. La position
est toujours calculée par rapport à la nouvelle position de
l'autre sortie, donc on ne peut pas dire --out-
put a --left-of b --output b --left-of a.
--set caractéristique valeur
Définir les caractéristiques d'une sortie. Des caractéristiques
numériques peuvent être indiquées (voir --prop) dans une liste
séparée par des virgules de valeurs décimales ou hexadécimales
(précédées de 0x). Les propriétés atomiques peuvent être posi-
tionnées sur n'importe quel valeur atomique (voir --prop). Les
caractéristiques de chaîne peuvent être positionnées à n'importe
quelle valeur.
--off Désactiver la sortie.
--crtc crtc
Utiliser le crtc spécifié (soit comme index d'une liste de CRTC
ou d’XID). Normalement, cette option n'est pas nécessaire car
xrandr essaie de faire des choix sensés quant au crtc à utiliser
avec chaque sortie. Quand cela échoue pour une raison ou pour
une autre, cette option peut outrepasser la sélection normale.
--gamma rouge[:vert:bleu]
Faire des valeurs décimales spécifiées une correction gamma sur
le CRTC actuellement connecté à la sortie. Si vert et bleu ne
sont pas indiqués, la valeur rouge sera utilisée pour les trois
composants. Remarquez que vous ne pouvez pas avoir deux valeurs
différentes pour deux sorties clones (à savoir qui partagent le
même CRTC) et que le passage d’une sortie vers un autre CRTC ne
modifie en aucun cas les corrections gamma du CRTC.
--brightness luminosité
Multiplier les valeurs gamma du CRTC connecté à la sortie par la
valeur décimale spécifiée. Utile pour des sorties à la lumino-
sité trop importante ou trop faible. Toutefois, il ne s'agit que
d'une modification logicielle, si votre matériel gère, en fait,
la modification de la luminosité, vous préfèrerez 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 inférieure. Elles fonctionnent encore sur les nou-
veaux serveurs X, mais elles n'interagissent pas sensiblement avec les
options de la version 1.2 sur la même ligne de commande.
-s, --size size-index ou --size largeurxhauteur
Cela détermine la taille de l'écran, soit en l’adaptant à la
taille soit en utilisant l'index de la liste des tailles dispo-
nibles.
-r, --rate, --refresh fréq
Cela spécifie la fréquence de rafraichissement le plus proche de
la valeur donnée.
-o, --orientation rotation
Cela spécifie l'orientation de l'écran, et peut être soit normal
(normale), soit inverted (inversée), soit left (gauche) ou right
(droite).
-x Réflexion sur l'axe X.
-y Réflexion sur l'axe Y.
EXEMPLES
Positionner une sortie appelée LVDS sur son mode préféré, puis posi-
tionner à sa droite une sortie appelée VGA sur le mode préféré de
l'écran physiquement orienté 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 appelée VGA :
xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning
1600x0
Avoir un petit écran LVDS 1280x800 affichant une petite version d'un
grand bureau de 3200x2000 et avoir un grand écran 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 trapèze pour une correction logi-
cielle (keystone) si le vidéoprojecteur 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
La traduction française de cette page de manuel a été créée par José
JORGE, Cyril Guilloud <guilloud@lautre.net>, Simon Depiets, Gérard De-
lafond <gerard@delafond.org>, Bernard Siaud, Nicolas François <nico-
las.francois@centraliens.net>, David Prévot <david@tilapin.org>, Jean-
Philippe MENGUAL <jpmengual@debian.org> et Mattéo Rossillol‑‑Laruelle
<beatussum@protonmail.com>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
X Version 11 xrandr 1.5.1 XRANDR(1)
Generated by dwww version 1.15 on Sat Jun 29 01:49:02 CEST 2024.