phoc()                                                                  phoc()

نام (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

                                                                        phoc()