[PATCH] xrandr: add more information about the transform option in the manpage

[Bernard Siaud alias Troumad]

Le 03/01/2010 01:20, Eric Piel a écrit :
> Hello,
>
> Here is a patch for the xrandr manpage to describe with more precision
> the --transform option, which, as Bernard noted, was rather vague.
>
> It's against git head.
> See you,
> Eric
>
Hello,

1) Good for the new example
2) Why
xrandr --fb 3200x2000
and not :
xrandr \-\-fb 3200x2000
I think that whe need a \ before a - . No ?
3) I don(t know what is keystone shaping ! It's not easy for me to 
translate it in french !


My french translate :

.\"
.\" 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]
[\-\-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]]]]
.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>\]
[\-\-off]
[\-\-crtc <crtc>]
.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



.IP \-\-help

.IP \-v

.IP \-\-verbose

.IP "\-q (sans autres options)"

.IP "\-screen snum"

.PP
.SH "options de la version 1.3 de RandR"
.PP

.PP
.IP \-\-current

.IP \-\-noprimary

.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éfini 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 quatres premiers 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
(a b)(x)+(c)
.br
(d e)(y) (f)
.br
──────────────
.br
((g h)(x)+1)·i
.br
(y)
.RE
Typiquement, \fIa\fP et \fIe\fP correspondent à l'échelle selon les axes 
X etd 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 en forme de clef de voute 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 vide, 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 raccourci de l'option \fI\-\-transform\fP.
.IP \-\-primary


.PP
.SH "options de la version 1.2 de RandR"
.IP "\-\-prop"

.IP "\-\-fb <largeur>x<hauteur>"

.IP "\-\-fbmm <largeur>x<hauteur>"

.IP "\-\-dpi <dpi>"

.IP "\-\-newmode \fInom\fP \fImode\fP

.IP "\-\-rmmode \fInom\fP"

.IP "\-\-addmode \fIsortie\fP \fInom\fP"

.IP "\-\-delmode \fIsortie\fP \fInom\fP"

.PP
.B Options par sortie
.IP "\-\-output <sortie>"

.IP \-\-auto

.IP "\-\-mode <mode>"
Ceci selectionne un mode. Employer le nom ou le XID du mode.
.IP \-\-preferred

.IP "\-\-pos <x>x<y>"

.IP "\-\-rate <rate>"



.IP "\-\-rotate rotation"

.IP "\-\-left\-of, \-\-right\-of, \-\-above, \-\-below <autre_sortie>"

.IP \-\-off

.IP "\-\-crtc <crtc>"

.PP
.SH "Options de la version 1.1 de RandR"
.IP "\-s <index de taille> ou <largeur>x<hauteur>"

.IP "\-o rotation"

.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 à son mode préféré de l'écran, et à sa 
droite place la sortie appelée VGA à son mode
préféré de l'é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 forme de clé de voûte de sorte qu'il est 
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, relisee par Gérard Delafond le 06 mars 
2005 et par Bernard SIAUD le 20 mai 2007, le 21 ecembre 2008 et le 28 
octobre 2009

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.



-- 
Amicalement vOOotre, Troumad Alias Bernard SIAUD, http://troumad.org
N'envoyez que des documents avec des formats ouverts, comme 
http://fr.openoffice.org
Adresse electronique speciale liste