phoc.ini() phoc.ini()

phoc.ini - فایل پیکربندی برای phoc

بیشتر پیکربندی‌های phoc از GSettings خوانده می‌شوند. تنظیمات خروجی و هسته (core) از phoc.ini خوانده می‌شوند. فایل پیکربندی در دایرکتوری کاری فعلی phoc جستجو می‌شود. همچنین مسیر آن می‌تواند از طریق گزینهٔ -C در خط فرمان مشخص شود.

فایل phoc.ini از چندین بخش تشکیل شده است که می‌توانند به هر ترتیبی قرار گیرند. در صورتی که مقادیر مشخص نشوند، از پیش‌فرض‌های توکار استفاده می‌شود. هدف اصلی phoc.ini تعیین پیکربندی و چینش خروجی‌ها است. هر بخش دارای قالب زیر است:

[SectionHeader]
key1 = value1
key2 = value2

خطوطی که با # شروع می‌شوند به عنوان کامنت در نظر گرفته شده و نادیده گرفته می‌شوند. سرآیند بخش‌ها ممکن است حاوی دونقطه (:) باشد که در این حالت، بخش پس از دونقطه آیتم پیکربندی را مشخص می‌کند؛ برای مثال:

[output:DSI-1]

بخش پیکربندی برای خروجی DSI-1 است.

سرآیندهای بخش موجود عبارتند از:

  • core: گزینه‌های هسته و اصلی
  • output: پیکربندی خروجی

برای اعمال تغییرات این فایل، راه‌اندازی مجدد کامپوزیتور (compositor) لازم است.

بخش core تنها یک بار می‌تواند ظاهر شود و دارای یک گزینه است:

•
xwayland=[true|immediate|false]: فعال بودن یا نبودن XWayland را مشخص می‌کند. با مقدار true، سرویس XWayland هنگام نیاز فعال می‌شود. مقدار immediate آن را فوراً اجرا می‌کند و false آن را غیرفعال می‌سازد.

بخش خروجی (output) می‌تواند چندین بار با آیتم‌های پیکربندی مختلف ظاهر شود:

[output:ITEM]

ITEM می‌تواند نام کانکتور DRM مانند DSI-1 یا DP-2 یا سازنده، مدل و شماره‌سریال به‌دست‌آمده از EDID باشد که با % از هم جدا شده‌اند: [output:A Vendor%The Model%Serial]. سازنده، مدل و شماره‌سریال می‌توانند به صورت * مشخص شوند تا با هر مقداری مطابقت داشته باشند. گزینه‌های پیکربندی عبارتند از:

  • enable=[true|false]: فعال بودن یا نبودن خروجی را مشخص می‌کند.
  • x، y: موقعیت x و y در چینش خروجی. این گزینه‌ها برای مرتب‌سازی خروجی‌ها به کار می‌روند. حالت پیش‌فرض استفاده از چینش خودکار است (خروجی‌های جدید به سمت راست چینش فعلی اضافه می‌شوند).
  • scale: مقیاس (بزرگ‌نمایی) خروجی. مقدار پیش‌فرض auto مقیاس را بر اساس اندازه صفحه نمایش محاسبه می‌کند.
  • rotate: چرخش صفحه. مقادیر معتبر عبارتند از normal، 90، 180، 270، flipped، flipped-90، flipped-180 و flipped-270. پیش‌فرض جهت‌گیری normal است.
  • mode: حالت ویدیویی (رزولوشن و نرخ نوسازی) مورد استفاده. این حالت باید برای این خروجی معتبر باشد. برای نمونه خروجی دستور wlr-randr را ببینید. حالت پیش‌فرض استفاده از حالت ترجیحی خروجی است.
  • modeline: یک حالت ویدیویی سفارشی. این گزینه فقط برای بک‌اند DRM معتبر است.
  • scale-filter: فیلتر مورد استفاده برای کوچک‌نمایی بافت‌ها (textures). مقادیر معتبر عبارتند از bilinear، nearest و auto. مورد آخر به طور خودکار برای مقیاس‌های کسری مقدار bilinear و برای مقیاس‌های صحیح مقدار nearest را انتخاب می‌کند. در صورت عدم تعیین، auto در نظر گرفته می‌شود.
  • drm-panel-orientation: در صورت تنظیم روی true، جهت‌گیری پنل خوانده‌شده از کانکتور DRM (در صورت موجود بودن) اعمال می‌شود. پیش‌فرض true است.
  • phys_width، phys_height: ابعاد فیزیکی نمایشگر بر حسب میلی‌متر (mm).
  • adaptive-sync: در صورت تنظیم روی enabled، نرخ نوسازی متغیر (VRR) را فعال می‌کند؛ مقدار disabled یا نبود آن، این ویژگی را غیرفعال می‌سازد.

مثال:

[output:DSI-1]
scale = 2
[output:Some Vendor%Some Model%*]
scale = 1
rotate = 90
x = 300

phoc(1) wlr-randr(1)