XRANDR(1) General Commands Manual XRANDR(1) NUME xrandr - interfaa primitiva de linie de comanda pentru extensia RandR SINOPSIS xrandr [--help] [--display afiaj] [-q] [-v] [--verbose] [--dryrun] [--screen numar-ecran] [--q1] [--q12] [--current] [--noprimary] [--panning laimexinalime[+x+y[/laime-chenarxinalime-chenar+chenar-x+chenar-y[/margine-stanga/margine-sus/margine-dreapta/margine-jos]]]] [--scale x[xy]] [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb laimexinalime] [--fbmm laimexinalime] [--dpi dpi] [--dpi de_la-ieire] [--newmode nume mod] [--rmmode nume] [--addmode ieire nume] [--delmode ieire nume] [--output ieire] [--auto] [--mode mod] [--preferred] [--pos xxy] [--rate rata] [--reflect reflexia] [--rotate orientare] [--left-of alta-ieire] [--right-of alta-ieire] [--above alta-ieire] [--below alta-ieire] [--same-as alta-ieire] [--set proprietate valoare] [--off] [--crtc crtc] [--gamma rou[:verde:albastru]] [--brightness luminozitate] [-o orientare] [-s dimensiune] [-r rata] [-x] [-y] [--listproviders] [--setprovideroutputsource furnizor sursa] [--setprovideroffloadsink furnizor sink] [--listmonitors] [--listactivemonitors] [--setmonitor nume geometrie ieiri] [--delmonitor nume] DESCRIERE Xrandr este utilizat pentru a defini dimensiunea, orientarea i/sau reflectarea ieirilor pentru un ecran. De asemenea, poate stabili dimensiunea ecranului. Daca este invocat fara nici o opiune, va afia starea ieirilor, aratand modurile existente pentru fiecare dintre ele, cu un ,,+" dupa modurile preferate i un ,,*" dupa modul curent. Exista cateva opiuni globale. Alte opiuni modifica ultima ieire care este specificata in parametrii anteriori din linia de comanda. Mai multe ieiri pot fi modificate in acelai timp prin folosirea mai multor opiuni ,,--output" urmate imediat de opiunile de modificare corespunzatoare. --help Afieaza un rezumat al utilizarii i iese. -v, --version Afieaza versiunea RandR raportata de serverul X i iese. --verbose Face ca <> sa ofere masaje mai detaliate. Atunci cand este utilizata cu ,,-q" (sau fara alte opiuni), <> va afia mai multe informaii despre starea serverului. Va rugam sa reinei ca informaiile despre gamma i luminozitate sunt doar aproximari ale profilului complet de culoare stocat in server. Atunci cand este utilizata impreuna cu opiuni care reconfigureaza sistemul, va fi raportat progresul in timpul executarii modificarilor de configurare. -q, --query Atunci cand aceasta opiune este prezenta sau cand nu se solicita nicio modificare a configuraiei, <> va afia starea actuala a sistemului. --dryrun Efectueaza toate aciunile specificate, cu excepia faptului ca nu se efectueaza nicio modificare. --nograb Aplica modificarile fara a captura ecranul. Se evita astfel blocarea altor aplicaii in timpul actualizarii, dar este posibil ca unele aplicaii care detecteaza redimensionarea ecranului sa primeasca valori vechi. -d, --display nume Aceasta opiune selecteaza afiajul X care urmeaza sa fie utilizat. Reinei ca se refera la abstractizarea ecranului X, nu la monitor (sau la ieire). --screen numar-ecran Aceasta opiune selecteaza ecranul care trebuie manipulat. Reinei ca se refera la abstractizarea ecranului X, nu la monitor (sau la ieire). --q1 Foreaza utilizarea protocolului RandR versiunea 1.1, chiar daca este disponibila o versiune superioara. --q12 Foreaza utilizarea protocolului RandR versiunea 1.2, chiar daca afiajul nu il raporteaza ca fiind acceptat sau daca este disponibila o versiune superioara. Opiunile RandR versiunea 1.5 Opiunile pentru RandR 1.5 sunt utilizate ca un superset al opiunilor pentru RandR 1.4. --listmonitors Raporteaza informaii despre toate monitoarele definite. --listactivemonitors Raporteaza informaii despre monitoarele active in prezent. --setmonitor nume geometrie ieiri Definete un nou monitor cu geometria data i asociat cu ieirile date. Lista de ieiri este fie cuvantul cheie none, fie o lista de ieiri separate prin virgula. Geometria este fie cuvantul cheie auto, caz in care monitorul va urmari automat geometria ieirilor asociate, fie o specificaie manuala sub forma w/mmwxh/mmh+x+y unde w, h, x, y sunt exprimate in pixeli, iar mmw, mmh sunt dimensiunile fizice ale monitorului. --delmonitor nume terge monitorul definit de utilizator. Opiunile RandR versiunea 1.4 Opiunile pentru RandR 1.4 sunt utilizate ca un superset al opiunilor pentru RandR 1.3. --listproviders Raporteaza informaii despre furnizorii disponibili. --setprovideroutputsource furnizor sursa Stabilete sursa ca sursa a imaginilor de ieire pentru furnizor. Acest lucru este posibil numai daca sursa i furnizorul au capacitaile Source Output i, respectiv, Sink Output. Daca sursa este 0x0, atunci furnizor este deconectat de la sursa sa curenta de ieire. --setprovideroffloadsink furnizor sink Stabilete furnizor ca dispozitiv de descarcare a redarii pentru sink. Acest lucru este posibil numai daca furnizor i sink au capacitaile Source Offload i, respectiv, Sink Offload. Daca sink este 0x0, atunci furnizor este deconectat de la sursa sa curenta de descarcare a redarii. Opiunile RandR versiunea 1.3 Opiunile pentru RandR 1.3 sunt utilizate ca un superset al opiunilor pentru RandR 1.2. --current Returneaza configuraia curenta a ecranului, fara interogare pentru modificari hardware. --noprimary Nu definete o ieire primara. Opiuni pentru ieire --panning laimexinalime[+x+y[/laime-chenarxinalime-chenar+chenar-x+chenar-y[/margine-stanga/margine-sus/margine-dreapta/margine-jos]]] Aceasta opiune stabilete parametrii de panoramare. De indata ce este activata panoramarea, poziia CRTC se poate modifica la fiecare micare a indicatorului. Primii patru parametri specifica zona totala de panoramare, iar urmatorii patru, zona de urmarire a indicatorului (care, in mod implicit, este aceeai zona). Ultimii patru parametri specifica marginea i au valoarea implicita 0. O laime sau o inalime stabilita la zero dezactiveaza panoramarea pe axa respectiva. De obicei, trebuie sa stabilii simultan dimensiunea ecranului cu --fb. --transform a,b,c,d,e,f,g,h,i Specifica o matrice de transformare care se aplica la ieire. Se selecteaza automat un filtru biliniar, cu excepia cazului in care se specifica i parametrul ,,--filter". Forma matematica corespunde la: a b c d e f g h i Transformarea se bazeaza pe coordonate omogene. Matricea inmulita cu vectorul de coordonate al unui pixel de la ieire da vectorul de coordonate transformat al unui pixel din memoria tampon grafica. Mai precis, vectorul (x y) al pixelului de ieire este extins la 3 valori (x y w), cu 1 ca coordonata w i multiplicat cu matricea. Coordonatele finale ale pixelului sunt apoi calculate cu aa-numita diviziune omogena prin coordonata w transformata. Cu alte cuvinte, coordonatele dispozitivului (x' y') ale pixelului transformat sunt: x' = (ax + by + c) / w' i y' = (dx + ey + f) / w' , cu w' = (gx + hy + i) . In mod obinuit, a i e corespund scalarii pe axele X i Y, c i f corespund translaiei pe aceste axe, iar g, h i i sunt, respectiv, 0, 0 i 1. Matricea poate fi, de asemenea, utilizata pentru a exprima transformari mai complexe, cum ar fi corecia de trapez sau rotaia. Pentru o rotaie a unui unghi T, se poate utiliza aceasta formula: cos T -sin T 0 sin T cos T 0 0 0 1 Ca argument special, in loc sa se paseze o matrice, se poate plasa irul none, caz in care se utilizeaza valorile implicite (o matrice unitara fara filtru). --filter mod-filtru Alege metoda filtrului de scalare care urmeaza sa fie aplicata atunci cand ecranul este scalat sau transformat. Poate fi fie ,,bilinear", fie ,,nearest". --scale x[xy] Modifica dimensiunile imaginii de ieire. Daca valoarea y este omisa, valoarea x va fi utilizata pentru ambele dimensiuni. Valorile mai mari de 1 conduc la un ecran comprimat (dimensiunea ecranului mai mare decat dimensiunea modului de ieire), iar valorile mai mici de 1 conduc la o marire a imaginii de ieire. Aceasta opiune este, de fapt, o versiune prescurtata a opiunii --transform. --scale-from wxh Specifica dimensiunea in pixeli a zonei din framebuffer care urmeaza sa fie afiata pe aceasta ieire. Aceasta opiune este, de fapt, o versiune prescurtata a opiunii --transform. --primary Stabilete ieirea ca primara. Aceasta va fi sortata prima in cererile de geometrie Xinerama i RANDR. Opiunile RandR versiunea 1.2 Aceste opiuni sunt disponibile numai pentru serverele X care accepta RandR versiunea 1.2 sau o versiune mai noua. --prop, --properties Aceasta opiune face ca <> sa afieze coninutul proprietailor pentru fiecare ieire. ,,--verbose" activeaza, de asemenea, ,,--prop". --fb laimexinalime Reconfigureaza ecranul la dimensiunea specificata. Toate monitoarele configurate trebuie sa se incadreze in aceasta dimensiune. Atunci cand aceasta opiune nu este furnizata, <> calculeaza cea mai mica dimensiune a ecranului care va conine setul de ieiri configurate; aceasta opiune ofera o modalitate de a anula acest comportament. --fbmm laimexinalime Definete valoarea raportata ca dimensiune fizica a ecranului X ca intreg (uniunea tuturor monitoarelor configurate). In configuraiile cu mai multe monitoare cu DPI-uri diferite, valoarea nu are nicio semnificaie fizica, dar poate fi utilizata de unii clieni vechi care nu accepta RandR versiunea 1.2 pentru a calcula o scalare a fontului de referina. In mod normal, <> reiniializeaza valorile marimilor fizice raportate pentru a menine constant DPI-ul. Aceasta opiune anuleaza acest calcul. Valoarea DPI implicita este 96. --dpi dpi --dpi de_la-ieire Aceasta stabilete, de asemenea, valoarea raportata ca dimensiune fizica a ecranului X ca intreg (uniunea tuturor monitoarelor configurate). In configuraiile cu mai multe monitoare cu DPI-uri diferite, valoarea nu are nicio semnificaie fizica, dar poate fi utilizata de unii clieni vechi care nu accepta RandR versiunea 1.2 pentru a calcula o scalare a fontului de referina. Aceasta opiune utilizeaza fie valoarea DPI specificata, fie DPI-ul ieirii date, pentru a calcula o dimensiune fizica adecvata folosind orice dimensiune a pixelilor care va fi stabilita. Valorile tipice sunt valoarea implicita (96 DPI), DPI-ul unui singur monitor in cazul configuraiilor cu un singur monitor sau DPI-ul monitorului principal in cazul configuraiilor cu mai multe monitoare. --newmode nume mod Se pot adauga noi definiii de ecran ,,modeline" la server i apoi se pot asocia cu ieiri. Aceasta opiune face prima varianta. modul este specificat folosind sintaxa ModeLine pentru xorg.conf: clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal fanioane. fanioane poate fi zero sau mai multe dintre +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Mai multe instrumente permit sa se calculeze definiia ,,modeline" obinuita din inalime, laime i rata de reimprospatare, de exemplu, se poate utiliza cvt. --rmmode nume Aceasta opiune elimina un mod de pe server in cazul in care acesta nu este utilizat. --addmode ieire nume Adauga un mod la setul de moduri valabile pentru o ieire. --delmode ieire nume Elimina un mod din setul de moduri valabile pentru o ieire. Opiuni pentru ieire --output ieire Selecteaza o ieire pentru reconfigurare. Utilizai fie numele ieirii, fie XID-ul. --auto Pentru ieirile conectate, dar dezactivate, acest lucru le va activa folosind primul mod preferat (sau ceva apropiat de 96 dpi, daca nu au un mod preferat). Pentru ieirile deconectate, dar activate, aceasta opiune le va dezactiva. --mode mod Aceasta selecteaza un mod. Utilizai fie numele, fie XID-ul pentru mod. --preferred Aceasta selecteaza acelai mod ca i ,,--auto", dar nu activeaza sau dezactiveaza automat ieirea. --pos xxy Poziioneaza ieirea pe ecran folosind coordonatele pixelilor. In cazul in care se aplica reflexia sau rotaia, translaia se aplica dupa efecte. --rate rata Aceasta marcheaza o preferina pentru rate de reimprospatare apropiate de valoarea specificata; atunci cand mai multe moduri au acelai nume, se va selecta cel cu cea mai apropiata rata de reimprospatare. --reflect reflexia Reflexia poate fi una dintre ,,normale" ,,x", ,,y" sau ,,xy". Acest lucru face ca coninutul de ieire sa fie reflectat pe axele specificate. --rotate rotaie Rotaia poate fi una dintre urmatoarele: ,,normal", ,,left", ,,right" sau ,,inverted". Aceasta determina rotirea coninutului ieirii in direcia specificata. ,,right" specifica o rotaie a imaginii in sensul acelor de ceasornic, iar ,,left" specifica o rotaie in sens invers acelor de ceasornic. --left-of, --right-of, --above, --below, --same-as alta-ieire Utilizai una dintre aceste opiuni pentru a poziiona ieirea in raport cu poziia unei alte ieiri. Acest lucru permite aranjarea comoda a ieirilor pe ecran. Poziia este intotdeauna calculata in raport cu noua poziie a celeilalte ieiri, astfel incat nu este valabil sa se spuna --output a --left-of b --output b --left-of a. --set proprietate valoare Stabilete o proprietate de ieire. Proprietaile de tip intreg pot fi specificate ca o lista valida (a se vedea ,,--prop") de valori zecimale sau hexazecimale (cu un 0x in faa), separate prin virgule. Proprietaile atomice pot fi stabilite la oricare dintre atomii valabili (a se vedea ,,--prop"). Proprietaile de tip ir de caractere pot fi stabilite la orice valoare. --off Dezactiveaza ieirea. --crtc crtc Utilizeaza crtc-ul specificat (fie ca indice in lista de CRTC-uri, fie ca XID). In utilizarea normala, aceasta opiune nu este necesara, deoarece <> incearca sa faca alegeri raionale cu privire la ce crtc sa utilizeze cu fiecare ieire. In cazul in care acest lucru nu reuete din anumite motive, aceasta opiune poate anula selecia normala. --gamma rou[:verde:albastru] Stabilete valorile in virgula mobila specificate ca corecie gamma pe crtc-ul ataat in prezent la aceasta ieire. Daca nu se specifica verdele i albastrul, valoarea roie va fi utilizata pentru toate cele trei componente. Reinei ca nu putei obine doua valori diferite pentru ieirile clonate (adica: care impart acelai crtc) i ca trecerea unei ieiri la un alt crtc nu modifica deloc coreciile gamma ale crtc-ului. --brightness luminozitate Inmulete valorile gamma de pe crtc-ul ataat in prezent la ieire la valoarea flotanta specificata. Utila pentru ieirile prea luminoase sau prea intunecate. Cu toate acestea, aceasta este o modificare exclusiv software; daca hardware-ul dvs. are suport pentru a modifica efectiv luminozitatea, probabil ca vei prefera sa utilizai xbacklight. Opiunile RandR versiunea 1.1 Aceste opiuni sunt disponibile pentru serverele X care accepta RandR versiunea 1.1 sau o versiune mai veche. Ele sunt inca valabile pentru serverele X mai noi, dar nu interacioneaza in mod sensibil cu opiunile versiunii 1.2 de pe aceeai linie de comanda. -s, --size index-dimensiune sau --size laimexinalime Aceasta seteaza dimensiunea ecranului, fie prin potrivire in funcie de dimensiune, fie utilizand indicele din lista de dimensiuni disponibile. -r, --rate, --refresh rata Aceasta stabilete rata de reimprospatare cea mai apropiata de valoarea specificata. -o, --orientation rotaie Aceasta specifica orientarea ecranului i poate fi una dintre urmatoarele: normal, inverted, left sau right. -x Reflecta pe axa X. -y Reflecta pe axa Y. EXEMPLE Stabilete o ieire numita LVDS in modul sau preferat, iar in dreapta sa pune o ieire numita VGA in modul preferat al unui ecran care a fost rotit fizic in sensul acelor de ceasornic: xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS Foreaza utilizarea unui mod 1024x768 pe o ieire numita 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 Activeaza panoramarea pe un desktop de 1600x768 in timp ce afieaza modul 1024x768 pe o ieire numita VGA: xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0 Avei un mic ecran LVDS de 1280x800 care afieaza o versiune mica a unui desktop uria de 3200x2000, iar un ecran VGA mare afieaza imprejurimile mouse-ului la dimensiuni 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 Afieaza ieirea VGA in forma trapezoidala, astfel incat aceasta sa fie corectata trapezoidal atunci cand video proiectorul se afla uor deasupra ecranului: xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1 CONSULTAI I Xrandr(3), cvt(1), xkeystone(1), xbacklight(1) AUTORI Keith Packard, Open Source Technology Center, Intel Corporation i Jim Gettys, Cambridge Research Laboratory, HP Labs, HP. TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . X Versiunea 11 xrandr 1.5.3 XRANDR(1)