XRANDR(1)

الاسم
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 التي أبلغ عنها خادوم إكس واخرج.

--verbose
    يجعل xrandr أكثر إسهابًا. عند استخدامه مع -q (أو دون خيارات أخرى)، سيعرض xrandr مزيدًا من المعلومات حول حالة الخادوم. يرجى ملاحظة أن معلومات الغاما والسطوع ليست سوى تقديرات تقريبية لتشكيلة الألوان الكاملة المخزنة في الخادوم. عند استخدامه مع الخيارات التي تعيد ضبط النظام، سيُبلغ عن التقدم أثناء تنفيذ تغييرات الضبط.

-q, --query
    عند وجود هذا الخيار، أو عند عدم طلب أي تغييرات في الضبط، سيعرض xrandr الحالة الحالية للنظام.

--dryrun
    ينفذ جميع الإجراءات المحددة فيما عدا إجراء أي تغييرات.

--nograb
    طبق التعديلات دون الاستحواذ على الشاشة. يتجنب ذلك حظر التطبيقات الأخرى أثناء التحديث ولكنه قد يؤدي أيضًا إلى تلقي بعض التطبيقات التي تكتشف تغيير حجم الشاشة لقيم قديمة.

-d, --display الاسم
    يحدد هذا الخيار عرض إكس المراد استخدامه. لاحظ أن هذا يشير إلى تجريد شاشة إكس، وليس المرقاب (أو المخرج).

--screen رقم_الشاشة
    يحدد هذا الخيار أي شاشة سيتم التلاعب بها. لاحظ أن هذا يشير إلى تجريد شاشة إكس، وليس المرقاب (أو المخرج).

--q1
    يفرض استخدام بروتوكول RandR الإصدارة 1.1، حتى لو توفرت إصدارة أحدث.

--q12
    يفرض استخدام بروتوكول RandR الإصدارة 1.2، حتى لو لم تبلغ شاشة العرض عن دعمها له أو توفرت إصدارة أحدث.

خيارات RandR الإصدارة 1.5

تُستخدم خيارات RandR 1.5 كمجموعة فوقية لخيارات RandR 1.4.

--listmonitors
    أبلغ عن معلومات حول جميع المراقيب المعرفة.

--listactivemonitors
    أبلغ عن معلومات حول المراقيب النشطة حاليًا.

--setmonitor الاسم الهندسة المخرجات
    عرف مرقابًا جديدًا بالهندسة المعطاة ومرتبطًا بالمخرجات المعطاة. قائمة المخرجات هي إما الكلمة المفتاحية none أو قائمة مخرجات مفصولة بفواصل. الهندسة هي إما الكلمة المفتاحية auto، وفي هذه الحالة سيتتبع المرقاب آليًا هندسة المخرجات المرتبطة، أو تحديد يدوي في النموذج w/mmwxh/mmh+x+y حيث w و h و x و y بالبكسل و mmw و mmh هي الأبعاد الفيزيائية للمرقاب.

--delmonitor الاسم
    احذف المرقاب المحدد من قبل المستخدم.

خيارات RandR الإصدارة 1.4

تُستخدم خيارات RandR 1.4 كمجموعة فوقية لخيارات RandR 1.3.

--listproviders
    أبلغ عن معلومات حول المزودين المتاحين.

--setprovideroutputsource المزود المصدر
    اضبط المصدر كمصدر لصور مخرجات العرض لـ المزود. هذا ممكن فقط إذا كان لدى المصدر و المزود إمكانيات Source Output و Sink Output، على التوالي. إذا كان المصدر هو 0x0، فسيُفصل المزود عن مصدر مخرجاته الحالي.

--setprovideroffloadsink المزود البالوعة
    اضبط المزود كجهاز تفريغ تصيير لـ البالوعة. هذا ممكن فقط إذا كان لدى المزود و البالوعة إمكانيات Source Offload و Sink Offload، على التوالي. إذا كانت البالوعة هي 0x0، فسيُفصل المزود عن بالوعة تفريغ التصيير الحالية.

خيارات RandR الإصدارة 1.3

تُستخدم خيارات RandR 1.3 كمجموعة فوقية لخيارات RandR 1.2.

--current
    أعد ضبط الشاشة الحالي، دون استطلاع تغييرات العتاد.

--noprimary
    لا تعرف مخرجًا رئيسًا.

خيارات لكل مخرج

--panning العرضxالارتفاع[+x+y[/عرض_التتبعxارتفاع_التتبع+x_التتبع+y_التتبع[/الحد_الأيسر/الحد_العلوي/الحد_الأيمن/الحد_السفلي]]]
    يضبط هذا الخيار معاملات التحريك. بمجرد تمكين التحريك، يمكن لموضع 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. يمكن أيضًا استخدام المصفوفة للتعبير عن تحويلات أكثر تعقيدًا مثل تصحيح الانحراف (keystone) أو الدوران. لدوران بزاوية T، يمكن استخدام هذه الصيغة:
        cos T -sin T 0
        sin T cos T 0
         0 0 1
    كوسيط خاص، بدلًا من تمرير مصفوفة، يمكن تمرير السلسلة none، وفي هذه الحالة تُستخدم القيم المبدئية (مصفوفة وحدة دون مرشح).

--filter طور_الترشيح
    يختار طريقة مرشح القياس التي سيتم تطبيقها عند قياس الشاشة أو تحويلها. يمكن أن تكون إما 'bilinear' أو 'nearest'.

--scale x[xy]
    يغير أبعاد صورة المخرج. إذا حُذفت قيمة y، فستُستخدم قيمة x لكلا البعدين. تؤدي القيم الأكبر من 1 إلى شاشة مضغوطة (أبعاد الشاشة أكبر من أبعاد طور المخرج)، وتؤدي القيم الأقل من 1 إلى التكبير في المخرج. هذا الخيار هو في الواقع نسخة مختصرة من خيار --transform.

--scale-from wxh
    يحدد الحجم بالبكسل لمنطقة مخزن الإطارات المؤقت التي سيتم عرضها على هذا المخرج. هذا الخيار هو في الواقع نسخة مختصرة من خيار --transform.

--primary
    اجعل المخرج رئيسًا. سيتم فرزه أولًا في طلبات هندسة Xinerama و RANDR.

خيارات RandR الإصدارة 1.2
هذه الخيارات متاحة فقط لخادوم إكس الذي يدعم RandR الإصدارة 1.2 أو أحدث.

--prop, --properties
    يؤدي هذا الخيار إلى قيام xrandr بعرض محتويات الخصائص لكل مخرج. يُمكّن --verbose أيضًا --prop.

--fb العرضxالارتفاع
    يعيد ضبط الشاشة للحجم المحدد. يجب أن تتناسب جميع المراقيب المضبوطة مع هذا الحجم. عند عدم توفير هذا الخيار، يحسب xrandr أصغر حجم شاشة يستوعب مجموعة المخرجات المضبوطة؛ يوفر هذا الخيار طريقة لتجاوز هذا السلوك.

--fbmm العرضxالارتفاع
    يضبط القيمة المبلغ عنها كحجم فيزيائي لشاشة إكس ككل (اتحاد جميع المراقيب المضبوطة). في التشكيلات التي تحتوي على مراقيب متعددة ذات DPIs مختلفة، لا يكون للقيمة أي معنى فيزيائي، ولكن قد يستخدمها بعض العملاء القدامى الذين لا يدعمون RandR الإصدارة 1.2 لحساب مقياس خط مرجعي. عادة، يعيد xrandr ضبط قيم الحجم الفيزيائي المبلغ عنها للحفاظ على ثابت DPI. هذا يتجاوز ذلك الحساب. القيمة المبدئية لـ DPI هي 96.

--dpi dpi

--dpi من_المخرج
    يضبط هذا أيضًا القيمة المبلغ عنها كحجم فيزيائي لشاشة إكس ككل (اتحاد جميع المراقيب المضبوطة). في التشكيلات التي تحتوي على مراقيب متعددة ذات DPIs مختلفة، لا يكون للقيمة أي معنى فيزيائي، ولكن قد يستخدمها بعض العملاء القدامى الذين لا يدعمون RandR الإصدارة 1.2 لحساب مقياس خط مرجعي. يستخدم هذا الخيار إما قيمة DPI المحددة، أو DPI للمخرج المعطى، لحساب حجم فيزيائي مناسب باستخدام أي حجم بكسل سيتم ضبطه. القيم النموذجية هي المبدئية (96 DPI)، أو DPI للمرقاب الوحيد في تشكيلات المرقاب الواحد، أو DPI للمرقاب الرئيس في تشكيلات المراقيب المتعددة.

--newmode الاسم الطور
    يمكن إضافة سطور الوضع (modelines) جديدة إلى الخادوم ثم ربطها بالمخرجات. يقوم هذا الخيار بالأمر الأول. يُحدد الطور باستخدام بناء جملة ModeLine لـ xorg.conf: clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal الأعلام. يمكن أن تكون الأعلام صفرًا أو أكثر من +HSync، -HSync، +VSync، -VSync، Interlace، DoubleScan، CSync، +CSync، -CSync. تتيح أدوات عديدة حساب سطر الطور المعتاد من الارتفاع والعرض ومعدل التحديث، على سبيل المثال يمكنك استخدام cvt.

--rmmode الاسم
    يزيل هذا طورًا من الخادوم إذا كان غير مستخدم.

--addmode المخرج الاسم
    أضف طورًا إلى مجموعة الأطوار الصالحة للمخرج.

--delmode المخرج الاسم
    أزل طورًا من مجموعة الأطوار الصالحة للمخرج.

خيارات لكل مخرج

--output المخرج
    يحدد مخرجًا لإعادة ضبطه. استخدم إما اسم المخرج أو XID.

--auto
    بالنسبة للمخرجات المتصلة ولكن المعطلة، سيؤدي هذا إلى تمكينها باستخدام طورها المفضل الأول (أو شيء قريب من 96dpi إذا لم يكن لديها طور مفضل). بالنسبة للمخرجات غير المتصلة ولكن الممكنة، سيؤدي هذا إلى تعطيلها.

--mode الطور
    يحدد هذا طورًا. استخدم إما الاسم أو XID لـ الطور

--preferred
    يحدد هذا نفس الطور الذي يحدده --auto، ولكنه لا يقوم بتمكين أو تعطيل المخرج آليًا.

--pos xxy
    ضع المخرج داخل الشاشة باستخدام إحداثيات البكسل. في حالة تطبيق الانعكاس أو الدوران، يتم تطبيق الإزاحة بعد التأثيرات.

--rate المعدل
    يميز هذا تفضيلًا لمعدلات التحديث القريبة من القيمة المحددة، عندما يكون لعدة أطوار نفس الاسم، سيؤدي هذا إلى تحديد الطور الذي يحتوي على أقرب معدل تحديث.

--reflect الانعكاس
    يمكن أن يكون الانعكاس واحدًا من 'normal' أو 'x' أو 'y' أو 'xy'. يؤدي هذا إلى عكس محتويات المخرج عبر المحاور المحددة.

--rotate الدوران
    يمكن أن يكون الدوران واحدًا من 'normal' أو 'left' أو 'right' أو 'inverted'. يؤدي هذا إلى تدوير محتويات المخرج في الاتجاه المحدد. يحدد 'right' دورانًا في اتجاه عقارب الساعة للصورة ويحدد 'left' دورانًا عكس اتجاه عقارب الساعة.

--left-of, --right-of, --above, --below, --same-as مخرج_آخر
    استخدم أحد هذه الخيارات لوضع المخرج بالنسبة لموضع مخرج آخر. يتيح ذلك ترتيب المخرجات بشكل ملائم داخل الشاشة. يتم حساب الموضع دائمًا بالنسبة للموضع الجديد للمخرج الآخر، لذا ليس من الصحيح قول --output a --left-of b --output b --left-of a.

--set الخاصية القيمة
    يضبط خاصية المخرج. يمكن تحديد الخصائص العددية كقائمة صالحة (انظر --prop) مفصولة بفواصل من القيم العشرية أو الست عشرية (مع بادئة 0x). يمكن ضبط خصائص الذرة (Atom) على أي من الذرات الصالحة (انظر --prop). يمكن ضبط خصائص السلسلة على أي قيمة.

--off
    يعطل المخرج.

--crtc crtc
    يستخدم crtc المحدد (إما كفهرس في قائمة CRTCs أو XID). في الاستخدام العادي، لا يكون هذا الخيار مطلوبًا لأن xrandr يحاول اتخاذ خيارات معقولة حول أي crtc سيستخدم مع كل مخرج. عندما يفشل ذلك لسبب ما، يمكن لهذا الخيار تجاوز الاختيار العادي.

--gamma الأحمر[:الأخضر:الأزرق]
    اضبط قيم الفاصلة العائمة المحددة كتصحيح غاما على crtc المرتبط حاليًا بهذا المخرج. إذا لم يُحدد الأخضر والأزرق، فستُستخدم القيمة الحمراء لجميع المكونات الثلاثة. لاحظ أنه لا يمكنك الحصول على قيمتين مختلفتين للمخرجات المستنسخة (أي التي تشترك في نفس crtc) وأن تبديل مخرج إلى crtc آخر لا يغير تصحيحات غاما crtc على الإطلاق.

--brightness السطوع
    اضرب قيم غاما على crtc المرتبط حاليًا بالمخرج في قيمة عائمة محددة. مفيد للمخرجات الساطعة جدًا أو المعتمة جدًا. ومع ذلك، هذا تعديل برمجى فقط، إذا كان عتادك يدعم تغيير السطوع فعليًا، فستفضل على الأرجح استخدام xbacklight.

خيارات RandR الإصدارة 1.1
هذه الخيارات متاحة لخواديم إكس التي تدعم RandR الإصدارة 1.1 أو أقدم. لا تزال صالحة لخواديم إكس الأحدث، لكنها لا تتفاعل بشكل معقول مع خيارات الإصدارة 1.2 في نفس سطر الأوامر.

-s, --size فهرس_الحجم أو --size العرضxالارتفاع
    يضبط هذا حجم الشاشة، إما عن طريق مطابقة الحجم أو استخدام الفهرس في قائمة الأحجام المتاحة.

-r, --rate, --refresh المعدل
    يضبط هذا معدل التحديث الأقرب للقيمة المحددة.

-o, --orientation الدوران
    يحدد هذا اتجاه الشاشة، ويمكن أن يكون واحدًا من 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 3200x2000+0+0/3200x2000+0+0/64/64/64/64

يعرض مخرج VGA بشكل شبه منحرف بحيث يتم تصحيح الانحراف (keystone) عندما يكون جهاز العرض فوق الشاشة قليلًا:
    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)

المؤلفون
كيث باكارد، مركز تكنولوجيا المصدر المفتوح، شركة إنتل. وجيم جيتيس، مختبر كامبريدج للأبحاث، مختبرات إتش بي، إتش بي.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.