xrandr - واجهة سطر أوامر بدائية لملحق RandR
ملخص
xrandr [--help] [--display display] [-q] [-v] [--verbose] [--dryrun] [--screen snum] [--q1]
[--q12] [--current] [--noprimary] [--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]] [--scale
x[xy]] [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb widthxheight] [--fbmm widthxheight] [--dpi dpi] [--dpi from-output] [--newmode name mode] [--rmmode
name] [--addmode output name] [--delmode output name] [--output output] [--auto] [--mode mode]
[--preferred] [--pos xxy] [--rate rate] [--reflect reflection] [--rotate orientation] [--left-of
output] [--right-of output] [--above output] [--below output] [--same-as output] [--set property
value] [--off] [--crtc crtc] [--gamma red[:green:blue]] [--brightness brightness] [-o orientation] [-s size] [-r rate] [-x] [-y] [--listproviders] [--setprovideroutputsource provider source]
[--setprovideroffloadsink provider sink] [--listmonitors] [--listactivemonitors] [--setmonitor
name geometry outputs] [--delmonitor name]
وصف
يُستخدم Xrandr لتعيين حجم أو اتجاه أو انعكاس المخرجات لشاشة. يمكنه أيضًا تعيين حجم الشاشة.
إذا تم استدعاؤه بدون أي خيار، فسيقوم بإخراج حالة المخرجات، مع عرض الأوضاع الموجودة لكل منها، مع علامة "+" بعد الأوضاع المفضلة وعلامة "*" بعد الوضع الحالي.
هناك بعض الخيارات العامة. تعمل الخيارات الأخرى على تعديل آخر مخرج تم تحديده في المعلمات السابقة في سطر الأوامر. يمكن تعديل مخرجات متعددة في نفس الوقت عن طريق تمرير خيارات --output متعددة متبوعة مباشرة بخيارات التعديل الخاصة بها.
--help اطبع ملخصًا للاستخدام واخرج.
-v، --version
اطبع إصدار RandR الذي أبلغ عنه خادم X واخرج.
--verbose
يجعل xrandr أكثر تفصيلاً. عند استخدامه مع -q (أو بدون خيارات أخرى)، سيعرض xrandr المزيد من المعلومات حول حالة الخادم. يرجى ملاحظة أن معلومات جاما والسطوع هي مجرد تقريب لملف تعريف الألوان الكامل المخزن في الخادم. عند استخدامه جنبًا إلى جنب مع الخيارات التي تعيد تكوين النظام، سيتم الإبلاغ عن التقدم أثناء تنفيذ تغييرات التكوين.
-q، --query
عند وجود هذا الخيار، أو عند عدم طلب أي تغييرات في التكوين، سيعرض xrandr الحالة الحالية للنظام.
--dryrun
ينفذ جميع الإجراءات المحددة باستثناء عدم إجراء أي تغييرات.
--nograb
طبّق التعديلات دون التقاط الشاشة. يتجنب هذا حظر التطبيقات الأخرى أثناء التحديث، ولكنه قد يتسبب أيضًا في حصول بعض التطبيقات التي تكتشف تغيير حجم الشاشة على قيم قديمة.
-d, --display name
يحدد هذا الخيار شاشة X المراد استخدامها. لاحظ أن هذا يشير إلى تجريد شاشة X، وليس الشاشة (أو الإخراج).
--screen snum
يحدد هذا الخيار الشاشة المراد التعامل معها. لاحظ أن هذا يشير إلى تجريد شاشة X، وليس الشاشة (أو الإخراج).
--q1
يجبر استخدام بروتوكول RandR الإصدار 1.1، حتى إذا كان إصدار أحدث متاحًا.
--q12
يجبر استخدام بروتوكول RandR الإصدار 1.2، حتى إذا لم يتم الإبلاغ عن دعمه بواسطة الشاشة أو كان إصدار أحدث متاحًا.
خيارات إصدار RandR 1.5
تُستخدم خيارات RandR 1.5 كمجموعة فائقة للخيارات الخاصة بـ RandR 1.4.
--listmonitors
أبلغ عن معلومات حول جميع الشاشات المعرفة.
--listactivemonitors
أبلغ عن معلومات حول الشاشات النشطة الحالية.
--setmonitor name geometry outputs
حدد شاشة جديدة بالهندسة المحددة المرتبطة بالمخرجات المحددة. تكون قائمة الإخراج إما الكلمة الأساسية "none" أو قائمة مفصولة بفواصل من المخرجات. تكون الهندسة إما الكلمة الأساسية "auto"، وفي هذه الحالة ستتبع الشاشة تلقائيًا هندسة المخرجات المرتبطة بها، أو تحديد يدوي في شكل w/mmwxh/mmh+x+y حيث تكون w و h و x و y بالبكسل، و mmw و mmh هما الأبعاد المادية للشاشة.
--delmonitor name
احذف الشاشة المعرفة من قبل بالاسم المحدد.
خيارات إصدار RandR 1.4
تُستخدم خيارات RandR 1.4 كمجموعة فائقة للخيارات الخاصة بـ RandR 1.3.
--listproviders
أبلغ عن معلومات حول مقدمي الخدمة المتاحين.
--setprovideroutputsource provider source
عيّن "source" كمصدر لإخراج صور العرض لمقدم الخدمة "provider". هذا ممكن فقط إذا كان لكل من "source" و "provider" إمكانيات "Source Output" و "Sink Output" على التوالي. إذا كانت "source" هي 0x0، فسيتم فصل "provider" عن مصدر إخراج العرض الحالي.
--setprovideroffloadsink provider sink
عيّن "provider" كجهاز تفريغ عرض لـ "sink". هذا ممكن فقط إذا كان لكل من "provider" و "sink" إمكانيات "Source Offload" و "Sink Offload" على التوالي. إذا كانت "sink" هي 0x0، فسيتم فصل "provider" عن جهاز تفريغ العرض الحالي.
خيارات إصدار RandR 1.3
تُستخدم خيارات RandR 1.3 كمجموعة فائقة للخيارات الخاصة بـ RandR 1.2.
--current
أرجع التكوين الحالي للشاشة، دون إجراء استطلاع للتغييرات في الأجهزة.
--noprimary
لا تحدد مخرجًا أساسيًا.
خيارات خاصة بالمخرج
--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]
يحدد هذا الخيار معلمات التمرير. بمجرد تمكين التمرير، يمكن أن يتغير موضع CRTC مع كل حركة للمؤشر. تحدد المعلمات الأربعة الأولى منطقة التمرير الإجمالية، وتحدد المعلمات الأربعة التالية منطقة تتبع المؤشر (والتي تكون افتراضيًا نفس المنطقة). تحدد المعلمات الأربعة الأخيرة الحدود وتكون افتراضيًا 0. يؤدي تعيين العرض أو الارتفاع إلى صفر إلى تعطيل التمرير على المحور المقابل. عادةً ما يتعين عليك تعيين حجم الشاشة باستخدام --fb في نفس الوقت.
--transform a,b,c,d,e,f,g,h,i
يحدد مصفوفة تحويل لتطبيقها على الإخراج. يتم تحديد مرشح ثنائي الخط تلقائيًا ما لم يتم تحديد معلمة --filter أيضًا. يتوافق الشكل الرياضي مع:
a b c
d e f
g h i
يعتمد التحويل على الإحداثيات المتجانسة. مصفوفة مضروبة في متجه إحداثيات بكسل الإخراج تعطي متجه الإحداثيات المحول لبكسل في المخزن المؤقت للرسومات. على وجه التحديد، يتم توسيع المتجه (x y) لبكسل الإخراج إلى 3 قيم (x y w)، مع 1 كإحداثي w، ويتم ضربه في المصفوفة. ثم يتم حساب إحداثيات الجهاز النهائية للبكسل باستخدام ما يسمى بالقسمة المتجانسة على إحداثي w المحول. بمعنى آخر، إحداثيات الجهاز (x' y') للبكسل المحول هي:
x' = (ax + by + c) / w' و
y' = (dx + ey + f) / w' ،
حيث w' = (gx + hy + i).
عادةً، يمثل a و e التحجيم على المحورين X و Y، ويمثل c و f الإزاحة على هذه المحاور، وتمثل g و h و i على التوالي 0 و 0 و 1. يمكن أيضًا استخدام المصفوفة للتعبير عن تحويلات أكثر تعقيدًا مثل تصحيح الانحراف أو الدوران. لتدوير بزاوية T، يمكن استخدام هذه الصيغة:
cos T -sin T 0
sin T cos T 0
0 0 1
كحجة خاصة، بدلاً من تمرير مصفوفة، يمكن تمرير السلسلة "none"، وفي هذه الحالة يتم استخدام القيم الافتراضية (مصفوفة وحدة بدون مرشح).
--filter filtermode
يختار طريقة تصفية التحجيم المراد تطبيقها عند تحجيم الشاشة أو تحويلها. يمكن أن تكون إما "bilinear" أو "nearest".
--scale x[xy]
يغير أبعاد صورة الإخراج. إذا تم حذف القيمة y، فسيتم استخدام القيمة x لكل من الأبعاد. تؤدي القيم الأكبر من 1 إلى شاشة مضغوطة (بعد الشاشة أكبر من بعد وضع الإخراج)، والقيم الأقل من 1 تؤدي إلى تكبير الإخراج. هذا الخيار هو في الواقع نسخة مختصرة من خيار --transform.
--scale-from wxh
يحدد حجم البكسل للمنطقة من المخزن المؤقت للإطار التي سيتم عرضها على هذا الإخراج. هذا الخيار هو في الواقع نسخة مختصرة من خيار --transform.
--primary
يعين الإخراج كإخراج أساسي. سيتم ترتيبه أولاً في طلبات هندسة Xinerama و RANDR.
خيارات الإصدار 1.2 من RandR
هذه الخيارات متاحة فقط لخادم X الذي يدعم الإصدار 1.2 أو أحدث من RandR.
--prop, --properties
يتسبب هذا الخيار في عرض xrandr لمحتويات الخصائص لكل إخراج. يؤدي خيار --verbose أيضًا إلى تمكين --prop.
--fb widthxheight
يعيد تكوين الشاشة إلى الحجم المحدد. يجب أن تتناسب جميع الشاشات التي تم تكوينها داخل هذا الحجم. عندما لا يتم توفير هذا الخيار، يقوم xrandr بحساب أصغر حجم شاشة يمكن أن يحتوي على مجموعة الإخراجات التي تم تكوينها؛ يوفر هذا الخيار طريقة لتجاوز هذا السلوك.
--fbmm widthxheight
يحدد القيمة التي يتم الإبلاغ عنها كحجم فعلي لشاشة X ككل (اتحاد جميع الشاشات المكونة). في التكوينات التي تحتوي على شاشات متعددة مع قيم DPI مختلفة، لا يكون لهذه القيمة أي معنى مادي، ولكن قد تستخدمها بعض التطبيقات القديمة التي لا تدعم إصدار RandR 1.2 لحساب قياس خط مرجعي. عادةً، يقوم xrandr بإعادة تعيين القيم المبلغ عنها للحجم الفعلي للحفاظ على قيمة DPI ثابتة. هذا الخيار يتجاوز هذا الحساب.
--dpi dpi
--dpi from-output
يحدد هذا أيضًا القيمة التي يتم الإبلاغ عنها كحجم فعلي لشاشة X ككل (اتحاد جميع الشاشات المكونة). في التكوينات التي تحتوي على شاشات متعددة مع قيم DPI مختلفة، لا يكون لهذه القيمة أي معنى مادي، ولكن قد تستخدمها بعض التطبيقات القديمة التي لا تدعم إصدار RandR 1.2 لحساب قياس خط مرجعي. يستخدم هذا الخيار إما قيمة DPI المحددة، أو قيمة DPI للشاشة المحددة، لحساب حجم فعلي مناسب باستخدام أي حجم بكسل سيتم تعيينه. القيم النموذجية هي القيمة الافتراضية (96 DPI)، أو قيمة DPI للشاشة الوحيدة في تكوينات الشاشة الواحدة، أو قيمة DPI للشاشة الرئيسية في تكوينات الشاشات المتعددة.
--newmode name mode
يمكن إضافة نماذج جديدة إلى الخادم ثم ربطها بالمخرجات. يقوم هذا الخيار بتنفيذ الجزء الأول. يتم تحديد النموذج باستخدام صيغة ModeLine لـ xorg.conf: clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. يمكن أن تكون العلامات صفرًا أو أكثر من +HSync، -HSync، +VSync، -VSync، Interlace، DoubleScan، CSync، +CSync، -CSync. تسمح العديد من الأدوات بحساب النموذج القياسي من الارتفاع والعرض ومعدل التحديث، على سبيل المثال، يمكنك استخدام cvt.
--rmmode name
يزيل هذا الخيار نموذجًا من الخادم إذا لم يتم استخدامه.
--addmode output name
يضيف هذا الخيار نموذجًا إلى مجموعة النماذج الصالحة للمخرج.
--delmode output name
يزيل هذا الخيار نموذجًا من مجموعة النماذج الصالحة للمخرج.
خيارات خاصة بكل مخرج
--output output
يحدد هذا الخيار مخرجًا لإعادة تكوينه. استخدم إما اسم المخرج أو XID.
--auto
بالنسبة للمخرجات المتصلة ولكن المعطلة، سيؤدي هذا إلى تمكينها باستخدام النموذج المفضل الأول (أو، شيء قريب من 96 DPI إذا لم يكن لديهم نموذج مفضل). بالنسبة للمخرجات غير المتصلة ولكن الممكنة، سيؤدي هذا إلى تعطيلها.
--mode mode
يحدد هذا الخيار نموذجًا. استخدم إما الاسم أو XID للنموذج.
--preferred
يحدد هذا الخيار نفس النموذج الذي يحدده الخيار --auto، ولكنه لا يمكّن أو يعطل المخرج تلقائيًا.
--pos xxy
يضع هذا الخيار المخرج داخل الشاشة باستخدام إحداثيات البكسل. في حالة تطبيق الانعكاس أو الدوران، يتم تطبيق الترجمة بعد التأثيرات.
--rate rate
يشير هذا الخيار إلى تفضيل معدلات التحديث القريبة من القيمة المحددة، عندما تحتوي نماذج متعددة على نفس الاسم، فسيقوم هذا الخيار بتحديد النموذج الذي يحتوي على أقرب معدل تحديث.
--reflect reflection
يمكن أن يكون الانعكاس أحد الخيارات 'normal' أو 'x' أو 'y' أو 'xy'. يؤدي هذا إلى عكس محتويات الإخراج على المحاور المحددة.
--rotate rotation
يمكن أن يكون التدوير أحد الخيارات 'normal' أو 'left' أو 'right' أو 'inverted'. يؤدي هذا إلى تدوير محتويات الإخراج في الاتجاه المحدد. يشير 'right' إلى تدوير عقارب الساعة للصورة، ويشير 'left' إلى تدوير عكس اتجاه عقارب الساعة.
--left-of، --right-of، --above، --below، --same-as another-output
استخدم أحد هذه الخيارات لوضع الإخراج بالنسبة لموضع إخراج آخر. يسمح هذا بترتيب الإخراجات بسهولة داخل الشاشة. يتم دائمًا حساب الموضع بالنسبة للموضع الجديد للإخراج الآخر، لذلك لا يجوز تحديد --output a --left-of b --output b --left-of a.
--set property value
يضبط خاصية الإخراج. يمكن تحديد الخصائص العددية على أنها قائمة صالحة من القيم العشرية أو الست عشرية (تبدأ بـ 0x) مفصولة بفواصل (انظر --prop). يمكن تعيين الخصائص الذرية إلى أي من الذرات الصالحة (انظر --prop). يمكن تعيين الخصائص النصية إلى أي قيمة.
--off
يعطل الإخراج.
--crtc crtc
يستخدم وحدة التحكم في الأشعة المهبطية (crtc) المحددة (إما كمؤشر في قائمة وحدات التحكم في الأشعة المهبطية أو معرف XID). في الاستخدام العادي، لا تكون هذه الخيار مطلوبة حيث يحاول xrandr اتخاذ خيارات معقولة حول وحدة التحكم في الأشعة المهبطية التي سيتم استخدامها مع كل إخراج. عندما يفشل ذلك لسبب ما، يمكن استخدام هذا الخيار لتجاوز التحديد العادي.
--gamma red[:green:blue]
يضبط القيم النقطية العائمة المحددة كتصحيح جاما على وحدة التحكم في الأشعة المهبطية المتصلة حاليًا بهذا الإخراج. إذا لم يتم تحديد اللونين الأخضر والأزرق، فسيتم استخدام قيمة اللون الأحمر لجميع المكونات الثلاثة. لاحظ أنه لا يمكنك الحصول على قيمتين مختلفتين للإخراجات المستنسخة (أي التي تشترك في نفس وحدة التحكم في الأشعة المهبطية)، وأن تغيير إخراج إلى وحدة تحكم في الأشعة المهبطية أخرى لا يغير تصحيحات جاما الخاصة بوحدة التحكم في الأشعة المهبطية على الإطلاق.
--brightness brightness
اضرب قيم جاما الموجودة على وحدة التحكم في الأشعة المهبطية المتصلة بالإخراج بالقيمة العائمة المحددة. مفيد للإخراجات الساطعة جدًا أو الخافتة جدًا. ومع ذلك، هذا تعديل برمجي فقط، إذا كان جهازك يدعم تغيير السطوع، فمن المحتمل أن تفضل استخدام xbacklight.
خيارات إصدار RandR 1.1
تتوفر هذه الخيارات لخوادم X التي تدعم إصدار RandR 1.1 أو إصدارات أقدم. لا تزال صالحة لخوادم X الأحدث، ولكنها لا تتفاعل بشكل صحيح مع خيارات الإصدار 1.2 على نفس سطر الأوامر.
-s، --size size-index أو --size widthxheight
يضبط حجم الشاشة، إما عن طريق المطابقة حسب الحجم أو باستخدام الفهرس في قائمة الأحجام المتاحة.
-r، --rate، --refresh rate
يضبط معدل التحديث الأقرب إلى القيمة المحددة.
-o، --orientation rotation
يحدد اتجاه الشاشة، ويمكن أن يكون أحد الخيارات: normal أو inverted أو left أو right.
-x
يعكس على المحور X.
-y
يعكس على المحور Y.
أمثلة
يضبط إخراجًا يسمى LVDS على الوضع المفضل، وعلى يمينه يضع إخراجًا يسمى VGA على وضع الشاشة المفضل التي تم تدويرها فعليًا في اتجاه عقارب الساعة: xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
يجبر على استخدام وضع 1024x768 على مخرج يسمى 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
يمكّن التمرير على سطح مكتب 1600x768 مع عرض وضع 1024x768 على مخرج يسمى VGA: xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
لدينا شاشة LVDS صغيرة بحجم 1280x800 تعرض نسخة صغيرة من سطح مكتب كبير بحجم 3200x2000، وشاشة VGA كبيرة تعرض المنطقة المحيطة بالماوس بحجمها الطبيعي. xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA --pos 0x0 --panning 32002000+0+0/3200x2000+0+0/64/64/64/64
يعرض مخرج VGA في شكل شبه منحرف بحيث يتم تصحيح التشوه عند وضع جهاز العرض أعلى الشاشة قليلاً: xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
انظر أيضاً
Xrandr(3)، cvt(1)، xkeystone(1)، xbacklight(1)
المؤلفون
كيث باكارد، مركز التكنولوجيا مفتوحة المصدر، شركة إنتل. وجيم جيتي، مختبر كامبريدج للأبحاث، مختبرات HP، HP.