(NAME)'>نام (NAME)

phoc - کامپوزیتور Wayland برای دستگاه‌های تلفن همراه

خلاصه دستور (SYNOPSIS)

phoc [OPTIONS...]

توضیحات (DESCRIPTION)

دستور phoc یک کامپوزیتور Wayland برای دستگاه‌های تلفن همراه است که از کتابخانه wlroots استفاده می‌کند. این ابزار اغلب با پوسته موبایل phosh به‌کار می‌رود، اما به‌تنهایی نیز کاملاً کار می‌کند.

گزینه‌ها (OPTIONS)

-h, --help: نمایش راهنما و خروج
-C, --config FILE: مسیر فایل پیکربندی (پیش‌فرض: phoc.ini).
-E, --exec EXECUTABLE: برنامه اجرایی (نشست) که در هنگام راه‌اندازی اجرا می‌شود
--socket: سوکت Wayland برای شنود اتصالات کلاینت
-S, --shell: انتظار برای متصل شدن یک پوسته
-X, --xwayland: راه‌اندازی XWayland
--no-xwayland: غیرفعال‌سازی XWayland
--version: نمایش اطلاعات نسخه

پیکربندی (CONFIGURATION)

پیکربندی از phoc.ini، hwdb، gsettings و $XDG_STATE_HOME/outputs.gvdb خوانده می‌شود. برای جزئیات بیشتر در مورد پیکربندی خروجی به phoc.ini(5)، برای جزئیات پیکربندی کلید بیدارباش از طریق hwdb به gmobile.udev(5)، برای جزئیات تنظیمات gsettings که توسط phoc مدیریت می‌شوند به phoc.gsettings(5) و برای جزئیات وضعیت‌های خروجی به phoc-outputs-states مراجعه کنید.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

دستور phoc از متغیرهای محیطی زیر پیروی می‌کند:

WLR_BACKENDS: بک‌اندهایی که کتابخانه wlroots باید هنگام راه‌اندازی phoc استفاده کند. ببینید: https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md
WLR_RENDERER: رندررکننده‌ای که کتابخانه wlroots باید هنگام راه‌اندازی phoc استفاده کند. ببینید: https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md
G_MESSAGES_DEBUG، G_DEBUG و سایر متغیرهای محیطی پشتیبانی‌شده توسط glib. https://docs.gtk.org/glib/running.html
PHOC_DEBUG: فهرستی از گزینه‌های اشکال‌زدایی جداشده با کاما. برخی از آن‌ها در زمان اجرا نیز قابل تغییر هستند؛ بخش رابط دی‌باس (DBUS INTERFACE) را در ادامه ببینید.

help: نمایش فهرستی از گزینه‌های اشکال‌زدایی در دسترس
auto-maximize: بیشینه‌سازی پنجره‌های سطح بالا (toplevels)
damage-tracking: اشکال‌زدایی رهگیری آسیب (قابل تغییر در زمان اجرا)
damage-whole: اعمال آسیب به کل خروجی در هر فریم (قابل تغییر در زمان اجرا)
fake-builtin: مدیریت خروجی‌های مجازی مانند نمایشگرهای داخلی
no-quit: عدم خروج هنگام پایان نشست
touch-points: اشکال‌زدایی نقاط لمسی (قابل تغییر در زمان اجرا)
layer-shell: اشکال‌زدایی لایه پوسته (layer shell)
cutouts: اشکال‌زدایی بریدگی‌ها و ناچ‌های نمایشگر (قابل تغییر در زمان اجرا)
disable-animations: غیرفعال‌سازی پویانمایی‌ها
force-shell-reveal: آشکارسازی همیشگی پوسته روی برنامه‌های تمام‌صفحه
ignore-state: نادیده گرفتن هرگونه وضعیت ذخیره‌شده خروجی

ویژگی‌های UDEV (UDEV PROPERTIES)

علاوه بر ویژگی‌های udev برای کلیدهای بیدارباش که در gmobile.udev(5) مستند شده است، phoc از ID_INPUT_KEYBOARD برای شناسایی صفحه‌کلیدهای سخت‌افزاری استفاده می‌کند. می‌توانید از hwdb برای جایگزینی این مقادیر استفاده کنید.

رابط دی‌باس (DBUS INTERFACE)

دستور phoc امکان فعال و غیرفعال کردن برخی گزینه‌های اشکال‌زدایی را در زمان اجرا از طریق DBus فراهم می‌کند. برای مشاهده فهرستی از گزینه‌های موجود از این دستور استفاده کنید:

busctl --user introspect mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl

برای تغییر مقادیر مجزا:

busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl TouchPoints b true
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl DamageTracking b true
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl LogDomains as 1 all
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl LogDomains as 2 phoc-seat phoc-layer-surface

توجه داشته باشید که این گزینه‌ها یک API پایدار در نظر گرفته نمی‌شوند و ممکن است بین نسخه‌های مختلف تغییر کنند.

همچنین ببینید (SEE ALSO)

phoc.ini(5) phoc.gsettings(5) phoc-outputs-states(1) gmobile.udev(5) phosh(1) busctl