.\" shorthand for double quote that works everywhere. .ds q \N'34' .TH weston.ini 5 "2026-01-30" "Weston 15.0.1" .\"--------------------------------------------------------------------- .SH "نام (NAME)" weston.ini \- فایل پیکربندی برای .B Weston \- یک کامپوزیتور Wayland .\"--------------------------------------------------------------------- .SH "مقدمه (INTRODUCTION)" .B Weston پیکربندی خود را از پارامترهای خط فرمان و فایل پیکربندی شرح داده‌شده در اینجا دریافت می‌کند. .\"--------------------------------------------------------------------- .SH "توضیحات (DESCRIPTION)" .B Weston برای راه‌اندازی و برپایی خود از یک فایل پیکربندی به نام .I weston.ini استفاده می‌کند. هنگام راه‌اندازی سرور، فایل پیکربندی .I weston.ini در یکی از مکان‌های زیر جستجو می‌شود: .PP .RS 4 .nf .BR "$XDG_CONFIG_HOME/weston.ini " "(در صورت تنظیم بودن $XDG_CONFIG_HOME)" .BR "$HOME/.config/weston.ini " "(در صورت تنظیم بودن $HOME)" .B "weston/weston.ini در هر یک از" .BR "\ \ \ \ $XDG_CONFIG_DIR " "(در صورت تنظیم بودن $XDG_CONFIG_DIRS)" .BR "/etc/xdg/weston/weston.ini " "(در صورت تنظیم نبودن $XDG_CONFIG_DIRS)" .fi .RE .PP که در آن، متغیر محیطی .B $HOME دایرکتوری خانگی کاربر است، .B $XDG_CONFIG_HOME دایرکتوری پیکربندی مخصوص کاربر است، و .B $XDG_CONFIG_DIRS فهرستی از دایرکتوری‌های پایه پیکربندی جداشده با دونقطه .B ':' است، مانند .BR /etc/xdg-foo:/etc/xdg . .PP فایل .I weston.ini از چندین بخش تشکیل شده است که ممکن است به هر ترتیبی حضور داشته باشند، یا برای استفاده از مقادیر پیکربندی پیش‌فرض حذف شوند. هر بخش ساختاری به شکل زیر دارد: .PP .RS 4 .nf .BI [ SectionHeader ] .RI Key1=Value1 .RI Key2=Value2 ... .fi .RE .PP فاصله‌ها مهم هستند و در نظر گرفته می‌شوند. خطوط توضیحات (کامنت) نادیده گرفته می‌شوند: .PP .RS 4 .nf .IR "#comment" .fi .RE .PP سرآیندهای بخش‌ها عبارتند از: .PP .RS 4 .nf .BR "core " "ماژول‌ها و گزینه‌های اصلی" .BR "libinput " "پیکربندی دستگاه ورودی" .BR "shell " "سفارشی‌سازی میزکار" .BR "launcher " "افزودن راه‌انداز به پنل" .BR "output " "پیکربندی خروجی" .BR "input-method " "ورودی صفحه‌کلید روی صفحه" .BR "keyboard " "چیدمان‌های صفحه‌کلید" .BR "terminal " "گزینه‌های برنامه ترمینال" .BR "xwayland " "گزینه‌های XWayland" .BR "screen-share " "گزینه‌های اشتراک‌گذاری صفحه (منسوخ‌شده)" .BR "autolaunch " "گزینه‌های اجرای خودکار" .fi .RE .PP انواع مقادیر ممکن عبارتند از رشته (string)، عدد صحیح ۳۲ بیتی علامت‌دار و بدون علامت (signed and unsigned 32-bit integer)، و بولی (boolean). رشته‌ها نباید درون نقل‌قول قرار گیرند، از هیچ توالی گریزی پشتیبانی نمی‌کنند و تا انتهای خط ادامه می‌یابند. اعداد صحیح می‌توانند در قالب‌های ده‌دهی (مانند 123)، هشت‌هشتی (مانند 0173) و شانزده‌شانزدهی (مانند 0x7b) مشخص شوند. مقادیر بولی تنها می‌توانند .B 'true' یا .B 'false' باشند. .\"--------------------------------------------------------------------- .SH "بخش هسته (CORE SECTION)" بخش .B core برای انتخاب ماژول‌های کامپوزیتور در زمان راه‌اندازی و گزینه‌های عمومی به کار می‌رود. .TP 7 .BI "shell=" desktop پوستهٔ بارگذاری‌شونده را مشخص می‌کند (رشته). این گزینه می‌تواند برای بارگذاری پوستهٔ پیاده‌سازی‌شده توسط خودتان یا یکی از پوسته‌های پیش‌فرض وستون به کار رود. پوسته‌های موجود در دایرکتوری .IR "/usr/lib/weston" عبارتند از: .PP .RS 10 .nf .BR desktop .BR fullscreen " (منسوخ‌شده)" .BR ivi .BR kiosk .BR lua .fi .RE .TP 7 .BI "xwayland=" true از وستون می‌خواهد که ماژول XWayland را بارگذاری کند (بولی). .TP 7 .BI "modules=" screen-share.so ماژول‌های مورد نظر برای بارگذاری را مشخص می‌کند (رشته، جداشده با کاما). ماژول‌های موجود در دایرکتوری .IR "/usr/lib/weston" عبارتند از: .PP .RS 10 .nf .BR screen-share.so " (منسوخ‌شده)" .fi .RE .TP 7 .BI "backend=" headless بک‌اند پیش‌فرض را لغو و جایگزین می‌کند. بک‌اندهای موجود عبارتند از: .PP .RS 10 .nf .BR drm .BR headless .BR rdp .BR pipewire .BR vnc .BR wayland .BR x11 .fi .RE .TP 7 .BI "repaint-window=" N طول تقریبی پنجرهٔ بازطراحی را بر حسب میلی‌ثانیه تنظیم می‌کند. پنجرهٔ بازطراحی برای کنترل و کاهش تأخیر خروجی کلاینت‌ها استفاده می‌شود. اگر طول پنجره از دورهٔ نوسازی خروجی طولانی‌تر باشد، بازطراحی بلافاصله پس از پایان بازطراحی قبلی انجام خواهد شد و در این بین درخواست‌های کلاینت پردازش نمی‌شوند. اگر پنجرهٔ بازطراحی بیش از حد کوتاه باشد، ممکن است کامپوزیتور بازهٔ محوشدگی عمودی هدف را از دست بدهد که موجب افزایش تأخیر خروجی می‌شود. مقدار پیش‌فرض ۷ میلی‌ثانیه است. بازهٔ مجاز از ۱ تا ۱۰۰۰ میلی‌ثانیه است، اما کامپوزیتور مقادیر بزرگ را به ۱ میلی‌ثانیه کمتر از نرخ نوسازی جاری کاهش می‌دهد. .TP 7 .BI "idle-time="seconds زمان وقفهٔ بیکاری وستون را بر حسب ثانیه تنظیم می‌کند. این زمان وقفه، مدتی است که پس از آن وستون وارد حالت «غیرفعال» شده و صفحه به سیاهی می‌رود. مقدار ۰ این وقفه را غیرفعال می‌کند. .PP .IR "مهم" : این گزینه را می‌توان از طریق گزینهٔ خط فرمان .B \-i وستون نیز تنظیم کرد و نسبت به گزینهٔ فایل ‎.ini فعلی اولویت خواهد داشت. بدین معنا که اگر هم در weston.ini و هم در خط فرمان این زمان وقفهٔ بیکاری تعریف شده باشد، مقدار مشخص‌شده در خط فرمان اعمال خواهد شد. از سوی دیگر، چنانچه هیچ‌یک از آن‌ها مقداری تعیین نکنند، وقفهٔ بیکاری پیش‌فرض روی ۳۰۰ ثانیه تنظیم می‌شود. .TP 7 .BI "require-input=" true برای راه‌اندازی نیازمند یک دستگاه ورودی است. .TP 7 .BI "require-outputs=" any رفتار وستون را در صورتی که نتواند خروجی‌ها را پیکربندی و فعال کند، تعیین می‌نماید. .PP بسته به مورد استفاده، ممکن است ترجیح داده شود اطمینان حاصل شود که وستون تنها در صورتی شروع به کار می‌کند که بتواند تمام خروجی‌های موجود را فعال کند، یا این‌که خروجی‌های ناموفق را نادیده بگیرد. گزینه‌های ممکن عبارتند از: .PP .RS 10 .nf .BR "all-found " "تمام خروجی‌های موجود باید فعال شوند" .BR "any " "در صورت امکان فعال‌سازی هر یک از خروجی‌ها شروع شود" .BR "none " "حتی اگر هیچ خروجی فعال نشد شروع شود" .fi .RE .TP 7 .BI "wait-for-debugger=" true پیش از مقداردهی اولیهٔ کامپوزیتور، سیگنال SIGSTOP ارسال می‌کند. این کار به کاربر اجازه می‌دهد دیباگر را متصل کرده و با ارسال SIGCONT به اجرای برنامه ادامه دهد. این امکان برای اشکال‌زدایی کرش در هنگام راه‌اندازی، زمانی که اجرای مستقیم وستون از درون دیباگر دشوار یا نامناسب است، مفید خواهد بود. مقدار بولی، پیش‌فرض .BR false است. گزینهٔ خط فرمانی نیز برای انجام همین کار وجود دارد. .TP 7 .BI "remoting="remoting-plugin.so پلاگینی را برای خروجی از راه دور جهت بارگذاری مشخص می‌کند (رشته). این گزینه می‌تواند برای بارگذاری پلاگین ریموت پیاده‌سازی‌شده توسط خودتان یا یکی از پلاگین‌های پیش‌فرض وستون به کار رود. پلاگین‌های ریموت موجود در دایرکتوری .IR "__libweston_modules_dir__" عبارتند از: .PP .RS 10 .nf .BR remoting-plugin.so .fi .RE .TP 7 .BI "renderer=" auto رندرر مورد استفاده برای ترکیب‌بندی داخلی (composition) را در صورت نیاز انتخاب می‌کند، یا .BI auto را برای برگزیدن مناسب‌ترین رندرر تعیین می‌نماید. رندررهای موجود عبارتند از: .PP .RS 10 .nf .BR auto .BR gl .BR noop .BR pixman .fi .RE همهٔ بک‌اندها از تمام رندررها پشتیبانی نمی‌کنند. .TP 7 .BI "use-pixman=" true به نفع گزینهٔ .BI "renderer=" منسوخ شده است. رندرینگ مبتنی بر pixman را برای تمام خروجی‌ها در بک‌اندهایی که از آن پشتیبانی می‌کنند، فعال می‌سازد. بولی، مقدار پیش‌فرض .BR false است. گزینهٔ خط فرمانی نیز برای انجام همین کار وجود دارد. .TP 7 .BI "color-management=" true مدیریت رنگ را فعال می‌کند و نیازمند استفاده از GL-renderer است. بولی، مقدار پیش‌فرض .BR false است. .PP .I "موقتی، آزمایشی و در دست توسعه:" مدیریت رنگ استفاده از فایل‌های ICC را برای توصیف رفتار رنگی مانیتور، افزونه‌های پروتکل ویلند را برای کلاینت‌ها جهت توصیف فضاهای رنگی خود و انجام پروفایل‌بندی مانیتور، و نگاشت تن (tone mapping) مورد نیاز برای فعال‌سازی حالت‌های ویدیویی HDR ممکن می‌سازد. این قابلیت‌های گسترش‌یافته به بهای پردازش تصویر سنگین‌تر و در مواردی از دست رفتن برخی ویژگی‌های تخلیه بار سخت‌افزاری (hardware off-loading) مانند composite-bypass تمام می‌شود. .TP 7 .BI "output-decorations=" true فقط برای headless-backend به همراه GL-renderer: تزئینات پنجرهٔ خروجی را رسم می‌کند، مشابه کاری که wayland-backend برای پنجره‌های خروجی شناور انجام می‌دهد. بولی، مقدار پیش‌فرض .BR false است. معمولاً نمی‌توان از این تزئینات اسکرین‌شات گرفت. این گزینه تنها برای مجموعه آزمون‌های وستون مفید است. .TP 7 .BI "placeholder-color=" 0xRRGGBB رنگ جای‌نگهدار (placeholder) را تنظیم می‌کند (عدد صحیح بدون علامت). جفت‌رقم‌های هگزادسیمال به ترتیب قرمز، سبز و آبی هستند. این جای‌نگهدار برای حفاظت از محتوا (content-protection) یا هنگامی که قادر به انتقال سطح/نما در صفحهٔ سخت‌افزاری (HW plane) نیستیم اما به اسکن مستقیم (direct scan-out) بافرها نیاز داریم، استفاده می‌شود. مقدار پیش‌فرض 0x660000 (قرمز گرنادیر) است. .\"--------------------------------------------------------------------- .SH "بخش LIBINPUT (LIBINPUT SECTION)" بخش .B libinput برای پیکربندی دستگاه‌های ورودی هنگام استفاده از بک‌اند دستگاه ورودی libinput به کار می‌رود. مقادیر پیش‌فرض توسط libinput تعیین می‌شوند و بسته به منطقی‌ترین حالت برای هر دستگاه داده‌شده، متغیر هستند. .PP پیکربندی‌های موجود عبارتند از: .TP 7 .BI "enable\-tap=" false زدن روی صفحه (تپ) برای کلیک کردن روی دستگاه‌های تاچ‌پد را فعال می‌کند. .TP 7 .BI "tap\-and\-drag=" false برای دستگاه‌های تاچ‌پد با \fBenable\-tap\fR فعال. اگر کاربر تپ کند و سپس بار دوم تپ کرده و نگه دارد، دکمه مجازی ماوس تا زمانی که کاربر انگشت خود را روی تاچ‌پد نگه دارد فشرده می‌ماند و امکان کلیک و کشیدن را تنها با تپ فراهم می‌سازد. .TP 7 .BI "tap\-and\-drag\-lock=" false برای دستگاه‌های تاچ‌پد با \fBenable\-tap\fR و \fBtap\-and\-drag\fR فعال. در حین یک عمل کلیک و کشیدن با تپ، اگر کاربر تاچ‌پد را کمتر از تعداد معینی میلی‌ثانیه رها کرده و سپس مجدداً لمس کند، دکمه مجازی ماوس فشرده باقی می‌ماند و کشیدن می‌تواند ادامه یابد. .TP 7 .BI "disable\-while\-typing=" true برای دستگاه‌هایی که ممکن است هنگام تایپ با صفحه‌کلید به‌طور تصادفی فعال شوند و موجب اختلال در تایپ گردند. این دستگاه‌ها را در حین استفاده از صفحه‌کلید غیرفعال می‌کند. .TP 7 .BI "middle\-button\-emulation=" false برای دستگاه‌های اشاره‌گر با دکمه‌های چپ و راست، اما بدون دکمه میانی. در صورت فعال بودن، با فشرده شدن هم‌زمان دکمه‌های چپ و راست، یک رویداد دکمه میانی صادر می‌شود. .TP 7 .BI "left\-handed=" false دستگاه را برای استفاده افراد چپ‌دست پیکربندی می‌کند. عملکرد دقیق این گزینه به دستگاه بستگی دارد. برای اشاره‌گرهای دارای دکمه چپ و راست، جای دکمه‌ها جا‌به‌جا می‌شود. در تبلت‌ها، تبلت از نظر منطقی وارونه می‌شود، زیرا از نظر فیزیکی وارونه خواهد شد. .TP 7 .BI "rotation=" n جهت شمال منطقی را تغییر می‌دهد و آن را به‌میزان \fIn\fR درجه در جهت عقربه‌های ساعت از جهت‌گیری پیش‌فرض می‌چرخاند؛ که در آن \fIn\fR یک عدد صحیح بین 0 تا 359 (شامل هر دو) است. عمدتاً برای ترک‌بال‌ها (trackballs) مورد نیاز است. برای مثال به کاربر اجازه می‌دهد ترک‌بال را به پهلو جهت‌دهی کند. .TP 7 .BI "accel\-profile=" "{flat,adaptive}" پروفایل شتاب اشاره‌گر را تنظیم می‌کند. سرعت اشاره‌گر روی صفحه متناسب با سرعت فیزیکی با یک ضریب تناسب ثابت است. آن ضریب ثابت را آلفا (alpha) در نظر بگیرید. مقدار \fIflat\fR آلفا را ثابت نگه می‌دارد. گزینه \fBaccel\-speed\fR را ببینید. مقدار \fIadaptive\fR باعث می‌شود آلفا با سرعت فیزیکی افزایش یابد و هنگام سرعت پایین، کنترل بیشتر و هنگام سرعت بالا، پیمایش و دسترسی بیشتری در اختیار کاربر بگذارد. مقدار پیش‌فرض \fIadaptive\fR است. .TP 7 .BI "accel\-speed=" v اگر \fBaccel\-profile\fR بر روی \fIflat\fR تنظیم شده باشد، صرفاً مقدار آلفا را تعیین می‌کند. اگر \fBaccel\-profile\fR روی \fIadaptive\fR تنظیم شده باشد، اثر آن پیچیده‌تر است، اما به‌طور کلی سرعت اشاره‌گر را تغییر می‌دهد. \fIv\fR نرمال‌سازی شده است و باید در بازه [\-1, 1] قرار داشته باشد. نگاشت دقیق میان \fIv\fR و آلفا به سخت‌افزار وابسته است، اما مقادیر بزرگ‌تر موجب سرعت‌های بالاتر مکان‌نما می‌شوند. .TP 7 .BI "natural\-scroll=" false پیمایش طبیعی را فعال می‌کند و رفتار پیمایش صفحه لمسی را شبیه‌سازی می‌نماید. یعنی اگر چرخ ماوس، انگشت یا انگشتان به سمت پایین حرکت داده شوند، صفحه به‌جای پایین به بالا پیمایش می‌شود، مثل اینکه انگشت یا انگشتان با صفحه‌ای که پیمایش می‌شود در تماس مستقیم باشند. .TP 7 .BI "scroll\-method=" {two\-finger,edge,button,none} روش پیمایش را تعیین می‌کند. مقدار \fItwo\-finger\fR با دو انگشت روی تاچ‌پد پیمایش می‌کند. مقدار \fIedge\fR با یک انگشت روی لبه سمت راست تاچ‌پد پیمایش می‌کند. مقدار \fIbutton\fR زمانی پیمایش می‌کند که با نگه داشتن یک دکمه معین، اشاره‌گر حرکت داده شود. گزینه \fBscroll\-button\fR را ببینید. مقدار \fInone\fR پیمایش را به‌طور کامل غیرفعال می‌کند. .TP 7 .BI "scroll\-button=" {BTN_LEFT,BTN_RIGHT,BTN_MIDDLE,...} برای دستگاه‌هایی که \fBscroll\-method\fR آن‌ها روی \fIbutton\fR تنظیم شده است. دکمه‌ای که پیمایش را فعال می‌کند مشخص می‌سازد. برای فهرست کامل مقادیر ممکن، فایل .B /usr/include/linux/input\-event\-codes.h را ببینید. .TP 7 .BI "disable\-input=" false نادیده گرفتن تمام دستگاه‌های ورودی مبتنی بر libinput. .TP 7 .BI "touchscreen_calibrator=" true اعلان واسط کالیبراتور صفحه لمسی به همه کلاینت‌ها. این یک بردار احتمالی برای حمله محروم‌سازی از سرویس (DoS) است، بنابراین فقط باید در فضای کاربری قابل‌اعتماد فعال شود. بولی، پیش‌فرض .BR false . این واسط برای اجرای برنامه‌های کالیبراتور صفحه لمسی مورد نیاز است. رویدادهای خام لمسی را در اختیار برنامه می‌گذارد و پردازش عادی لمس را دور می‌زند. همچنین به برنامه اجازه می‌دهد کالیبراسیون جدیدی را در کامپوزیتور بارگذاری کند. اگرچه این گزینه در بخش libinput فهرست شده است، اما بر تمام پیکربندی‌های وستون صرف‌نظر از بک‌اند مورد استفاده اثر می‌گذارد. اگر بک‌اند از libinput استفاده نکند، واسط همچنان می‌تواند اعلان شود، اما هیچ دستگاهی را فهرست نخواهد کرد. .TP 7 .BI "calibration_helper=" /bin/echo یک برنامه کمکی کالیبراسیون اختیاری برای ذخیره دائمی کالیبراسیون جدید صفحه لمسی. رشته، پیش‌فرض تنظیم‌نشده (unset). برنامه داده‌شده با هفت آرگومان اجرا خواهد شد هنگامی که یک برنامه کالیبراتور از سرور بخواهد ماتریس کالیبراسیون جدیدی را به کار گیرد. برنامه به‌صورت همگام اجرا می‌شود و بنابراین در طول مدت خود وستون را مسدود خواهد کرد. اگر وضعیت خروج برنامه غیرصفر باشد، وستون کالیبراسیون جدید را اعمال نخواهد کرد. اگر این برنامه کمکی تنظیم نشده باشد یا وضعیت خروج برنامه صفر باشد، وستون کالیبراسیون جدید را بلافاصله استفاده خواهد کرد. این برنامه به این صورت فراخوانی می‌شود: .PP .RS 10 .nf .I calibration_helper syspath m1 m2 m3 m4 m5 m6 .fi .RE .IP .RI "که در آن " syspath مسیر sys در udev برای دستگاه است و .IR m1 " تا " m6 عناصر ماتریس کالیبراسیون در قالب ویژگی udev با عنوان .BR LIBINPUT_CALIBRATION_MATRIX در libinput هستند. مسیر sys یک مسیر مطلق است و با نقطه اتصال sys آغاز می‌شود. .\"--------------------------------------------------------------------- .SH "بخش پوسته (SHELL SECTION)" بخش .B shell برای سفارشی‌سازی کامپوزیتور استفاده می‌شود. برخی از کلیدها ممکن است توسط افزونه‌های پوسته مختلف پشتیبانی یا پردازش نشوند. .PP ورودی‌هایی که می‌توانند در این بخش قرار گیرند عبارتند از: .TP 7 .BI "client=" "/usr/lib/weston/weston-desktop-shell" مسیر کلاینت پوسته را برای اجرا مشخص می‌کند. امکان ارسال آرگومان‌ها و متغیرهای محیطی به برنامه وجود دارد، برای مثال: \(aqENVFOO=bar ENVBAR=baz /path/to/program \-\-arg anotherarg\(aq که ورودی‌ها با فاصله جدا می‌شوند اما از نقل‌قول (quoting) پشتیبانی نمی‌شود. اگر هیچ کلاینتی مشخص نشده باشد، .I weston-desktop-shell اجرا می‌شود (رشته). .TP 7 .BI "background-image=" file مسیر فایل تصویر پس‌زمینه را مشخص می‌کند (رشته). .TP 7 .BI "background-type=" tile نحوه ترسیم تصویر پس‌زمینه را تعیین می‌کند (رشته). می‌تواند شامل .BR centered "، " scale "، " scale-crop "، " scale-fit یا .BR tile " (پیش‌فرض) باشد." حالت .B centered تصویر را یک‌بار در مرکز نمایش می‌دهد. اگر تصویر از خروجی کوچک‌تر باشد، باقی سطح به رنگ پس‌زمینه خواهد بود. اگر اندازه تصویر متناسب با خروجی نباشد (بزرگ‌تر باشد)، از چپ و راست یا بالا و پایین بریده می‌شود. حالت .B scale تصویر را برای جا گرفتن دقیق در خروجی مقیاس‌بندی می‌کند، بدون حفظ نسبت ابعاد. حالت .B scale-crop نسبت ابعاد را حفظ می‌کند، تصویر پس‌زمینه را به اندازه‌ای بزرگ می‌کند که تمام خروجی را بپوشاند و آن را در مرکز قرار می‌دهد. اگر نسبت ابعاد با خروجی همخوانی نداشته باشد، تصویر از چپ و راست یا بالا و پایین بریده می‌شود. حالت .B scale-fit مشابه .B scale-crop است اما اندازه تصویر را طوری با خروجی تطبیق می‌دهد که بریده نشود. حالت .B tile تصویر پس‌زمینه را برای پر کردن خروجی تکرار می‌کند. .TP 7 .BI "background-color=" 0xRRGGBB رنگ پس‌زمینه را مشخص می‌کند (عدد صحیح بدون علامت). جفت ارقام شانزده‌شانزدهی (هگزادسیمال) به ترتیب قرمز، سبز و آبی هستند. جهت حفظ سازگاری با نسخه‌های گذشته، مقادیر در قالب .B 0xAARRGGBB نیز مجاز هستند، اما .B AA نادیده گرفته می‌شود و پس‌زمینه همیشه یکدست و توپر است. از آنجا که رنگ پس‌زمینه 0 به معنی نبود رنگ پس‌زمینه است، یک پس‌زمینه سیاه را می‌توان به صورت .BR "0xff000000" مشخص کرد. .TP 7 .BI "clock-format=" format قالب ساعت پنل را مشخص می‌کند (رشته). می‌تواند شامل .BR "none" "،" .BR "minutes" "،" .BR "seconds" "،" .BR "minutes-24h" "،" .BR "seconds-24h" باشد. به‌طور پیش‌فرض، از قالب .B minutes استفاده می‌شود. .TP 7 .BI "panel-color=" 0xAARRGGBB رنگ پنل را مشخص می‌کند (عدد صحیح بدون علامت). جفت ارقام شانزده‌شانزدهی به ترتیب شفافیت، قرمز، سبز و آبی هستند. مثال‌ها: .PP .RS 10 .nf .BR "0xffff0000 " "قرمز" .BR "0xff00ff00 " "سبز" .BR "0xff0000ff " "آبی" .BR "0x00ffffff " "کاملاً شفاف" .fi .RE .TP 7 .BI "panel-position=" top موقعیت پنل را تنظیم می‌کند (رشته). می‌تواند شامل .BR top ، .BR bottom ، .BR left ، .BR right یا .B none باشد. .TP 7 .BI "locking=" true قفل شدن صفحه را فعال می‌کند (بولی). .TP 7 .BI "animation=" zoom جلوه (انیمیشن) مورد استفاده برای باز کردن پنجره‌های جدید را تعیین می‌کند (رشته). می‌تواند شامل .BR zoom ، .BR fade یا .B none باشد. به‌طور پیش‌فرض، هیچ جلوه‌ای استفاده نمی‌شود. .TP 7 .BI "close-animation=" fade جلوه مورد استفاده هنگام بستن پنجره‌ها را تعیین می‌کند (رشته). می‌تواند شامل .B fade یا .B none باشد. به‌طور پیش‌فرض، از جلوه .B fade استفاده می‌شود. .TP 7 .BI "startup-animation=" fade جلوه مورد استفاده توسط .B desktop-shell هنگام راه‌اندازی را تعیین می‌کند (رشته). می‌تواند شامل .B fade یا .B none باشد. به‌طور پیش‌فرض، از جلوه .B fade استفاده می‌شود. .TP 7 .BI "focus-animation=" dim-layer جلوه مورد استفاده برای پنجره‌های فوکوس‌شده و بدون فوکوس را تعیین می‌کند. می‌تواند شامل .B dim-layer یا .B none باشد. به‌طور پیش‌فرض، هیچ جلوه‌ای استفاده نمی‌شود. .TP 7 .BI "allow-zap=" true مشخص می‌کند که آیا با فشردن ترکیب کلیدهای .B Ctrl-Alt-Backspace پوسته باید خارج شود یا خیر. .TP 7 .BI "disallow-output-changed-move=" false مشخص می‌کند که آیا پوسته باید پنجره کلاینت را به خروجی متفاوتی نسبت به آنچه در ابتدا تخصیص داده شده و دیگر در دسترس/فعال/متصل نیست منتقل کند یا خیر. .TP 7 .BI "binding-modifier=" ctrl کلید تبدیل‌کننده (modifier) مورد استفاده برای کلیدهای میانبر رایج را تعیین می‌کند (رشته)، مانند جابه‌جایی سطوح، تغییر اندازه، چرخش، جابه‌جایی بین پنجره‌ها، بستن پنجره‌ها، تنظیم شفافیت پنجره‌ها، کنترل نور پس‌زمینه و بزرگ‌نمایی میزکار. به .BR weston-bindings (7) مراجعه کنید. مقادیر ممکن: .BR none "، " ctrl "، " alt "، " super (پیش‌فرض). .TP 7 .BI "cursor-theme=" theme تم مکان‌نما (نشانگر ماوس) را تعیین می‌کند (رشته). .TP 7 .BI "cursor-size=" 24 اندازه مکان‌نما را مشخص می‌کند (عدد صحیح بدون علامت). .TP 7 .BI "lua-script=" script اسکریپت .B Lua را که هنگام راه‌اندازی .B lua-shell تفسیر و اجرا خواهد شد مشخص می‌کند. مسیر می‌تواند به صورت مطلق یا نسبی با استفاده از دایرکتوری کاری جاری باشد. .\"--------------------------------------------------------------------- .SH "بخش راه‌انداز (LAUNCHER SECTION)" می‌توان چندین بخش راه‌انداز داشت، یکی برای هر راه‌انداز. .TP 7 .BI "icon=" icon مسیر تصویر آیکون را مشخص می‌کند (رشته). تصاویر .B Svg در حال حاضر پشتیبانی نمی‌شوند. .TP 7 .BI "displayname=" displayname نام نمایشی راه‌انداز را که در تول‌تیپ (tooltip) ظاهر می‌شود مشخص می‌کند. .TP 7 .BI "path=" program مسیر برنامه‌ای را که با کلیک روی این راه‌انداز اجرا می‌شود مشخص می‌کند (رشته). امکان ارسال آرگومان‌ها و متغیرهای محیطی به برنامه وجود دارد. برای مثال: .nf .in +4n path=GDK_BACKEND=wayland gnome-terminal \-\-full-screen .in .fi .\"--------------------------------------------------------------------- .SH "بخش خروجی (OUTPUT SECTION)" می‌تواند چندین بخش خروجی وجود داشته باشد که هر کدام متناظر با یک خروجی است. این بخش در حال حاضر فقط توسط بک‌اند‌های .BR drm " و " x11 شناخته می‌شود. .TP 7 .BI "name=" name نامی را برای خروجی تعیین می‌کند (رشته). بک‌اند از این نام برای شناسایی خروجی استفاده می‌کند. تمامی نام‌های خروجی X11 با حرف X آغاز می‌شوند. تمامی نام‌های خروجی Wayland با حروف WL آغاز می‌شوند. مثال‌هایی از کاربرد: .PP .RS 10 .nf .BR "LVDS1 " "بک‌اند DRM، پنل داخلی لپ‌تاپ شماره ۱" .BR "VGA1 " "بک‌اند DRM، رابط VGA شماره ۱" .BR "X1 " "بک‌اند X11، پنجره X شماره ۱" .BR "WL1 " "بک‌اند Wayland، پنجره Wayland شماره ۱" .fi .RE .IP برای جزئیات بیشتر به .B "weston-drm(7)" مراجعه کنید. .TP 7 .BI "mode=" mode حالت خروجی را تعیین می‌کند (رشته). پارامتر حالت بسته به بک‌اند به‌طور متفاوتی مدیریت می‌شود. در بک‌اند X11، فقط مقدار WIDTHxHEIGHT پنجره weston را تنظیم می‌کند. بک‌اند DRM حالت‌های مختلفی را به همراه گزینه‌ای برای رشته modeline می‌پذیرد. برای نمونه‌هایی از قالب‌های حالت پشتیبانی‌شده توسط بک‌اند DRM به .B "weston-drm(7)" مراجعه کنید. .TP 7 .BI "transform=" normal نحوه چرخش مانیتور نسبت به جهت عادی آن (رشته). کلید transform می‌تواند یکی از ۸ رشته زیر باشد: .PP .RS 10 .nf .BR "normal " "خروجی عادی." .BR "rotate-90 " "۹۰ درجه در جهت عقربه‌های ساعت." .BR "rotate-180 " "وارونه." .BR "rotate-270 " "۹۰ درجه خلاف جهت عقربه‌های ساعت." .BR "flipped " "معکوس‌شده افقی." .BR "flipped-rotate-90 " "معکوس‌شده و ۹۰ درجه در جهت عقربه‌های ساعت." .BR "flipped-rotate-180 " "معکوس‌شده و وارونه." .BR "flipped-rotate-270 " "معکوس‌شده و ۹۰ درجه خلاف جهت عقربه‌های ساعت." .fi .RE .TP 7 .BI "scale=" factor ضریب مقیاس‌بندی اعمال‌شده به کل خروجی، برای پشتیبانی از نمایشگرهای با وضوح بالا («HiDPI» یا «رتینا»)، که تقریباً با نسبت پیکسلی وضوح فیزیکی نمایشگر به وضوح منطقی مطابقت دارد. برنامه‌هایی که از نمایشگرهای با وضوح بالا پشتیبانی نمی‌کنند معمولاً بسیار ریز و ناخوانا به نظر می‌رسند. وستون خروجی چنین برنامه‌هایی را با این ضریب مقیاس‌بندی می‌کند تا خوانا شوند. برنامه‌هایی که خود از مقیاس‌بندی خروجی پشتیبانی می‌کنند می‌توانند محتوای خود را با وضوح بالا ترسیم کنند، که در این حالت از مقیاس‌بندی کامپوزیتور اجتناب می‌کنند. وستون خروجی چنین برنامه‌هایی را مقیاس‌بندی نخواهد کرد و آن‌ها تحت تأثیر این ضریب قرار نمی‌گیرند. .IP یک عدد صحیح، به‌طور پیش‌فرض ۱، که در صورت نیاز معمولاً ۲ یا بالاتر پیکربندی می‌شود و نشان‌دهنده ضریب مقیاس‌بندی برای خروجی است. .TP 7 .BI "icc_profile=" file اگر گزینه .B color\-management برابر با true باشد، فایل ICC داده‌شده را به عنوان نمایه رنگی خروجی بارگذاری می‌کند. این گزینه فقط در بک‌اند‌های DRM، headless، wayland و x11، و برای خروجی‌های remoting و pipewire کار می‌کند. .TP 7 .BI "color-profile=" name .B "نکته (NOTE):" این ویژگی هنوز به طور کامل پیاده‌سازی نشده است و بنابراین انتظار نمی‌رود کار کند. نمایه‌های رنگی چگونگی رفتار فرضی نمایشگر را توصیف می‌کنند. وستون با آگاهی از رفتار رنگی نمایشگر، می‌تواند محتوای پنجره‌ها را برای ایجاد ظاهر فرضی مورد انتظار تطبیق دهد. گزینه .B color\-management برای کارکرد این قابلیت باید روی true تنظیم شده باشد. این قابلیت فقط در بک‌اند‌های DRM، headless، wayland و x11، و برای خروجی‌های remoting و pipewire کار می‌کند. اگر .B icc_profile نیز تنظیم شده باشد، به جای آن استفاده می‌شود. این کلید یک نمایه پارامتری ایجاد می‌کند تا به عنوان نمایه رنگی خروجی استفاده شود. نمایه می‌تواند از پارامترهای ثبت‌شده در یک بخش .B color\-profile با ارجاع به مقدار .B name آن ایجاد شود. متناوباً این کلید می‌تواند از یکی از نام‌های ویژه نمایه که شامل دونقطه (:) هستند استفاده کند. مقدار پیش‌فرض، پس از پیاده‌سازی، .BR "color\-profile=auto:" خواهد بود. نام‌های ویژه زیر پذیرفته می‌شوند: .RS 11 .TP .B "srgb:" یک نمایه رنگی پارامتری sRGB (گاما ۲.۲) ایجاد می‌کند. .TP .BI "auto:" "[flags...]" یک نمایه رنگی پارامتری خودکار ایجاد می‌کند. .RE .IP نمایه‌های رنگی پارامتری خودکار بر اساس کلیدهای پیکربندی .BR eotf\-mode " و " colorimetry\-mode در بخش .B output مربوطه، و به صورت اختیاری با استفاده از EDID گزارش‌شده توسط مانیتور ایجاد می‌شوند (فقط بک‌اند DRM). چندین فلگ باید با فاصله از یکدیگر جدا شوند. فلگ‌های موجود عبارتند از: .RS 11 .TP .B edid\-primaries دریافت رنگ‌های اولیه و نقطه سفید از EDID در صورتی که .BR colorimetry\-mode " برابر با " default باشد. اگر EDID تمام آن‌ها را ارائه نکند، نادیده گرفته می‌شود. .TP .B edid\-tf دریافت تابع انتقال از EDID در صورتی که .BR eotf\-mode " برابر با " sdr " یا " hdr\-gamma باشد. تابع انتقال، منحنی قانون توان با توان مشخص‌شده در EDID است. .TP .B edid\-dr دریافت اطلاعات دامنه دینامیکی از EDID در صورتی که .BR eotf\-mode " برابر با " st2084 باشد. .RE .IP مثال‌ها: .RS 11 .EX .B color-profile=srgb: .B color-profile=auto: .B color-profile=auto:edid-tf edid-dr .B color-profile=auto: edid-primaries .B color-profile=my-awesome-display .EE .RE .IP مثال آخر باعث می‌شود وستون بخش .B color\-profile را بخواند که دارای .BR name=my-awesome-display است. .IP به طور ویژه، تنظیم .RS 11 .EX .B eotf-mode=sdr .B colorimetry-mode=default .B color-profile=auto: .EE .RE .IP همان نمایه رنگی .BR color\-profile=srgb: را تولید می‌کند. .TP 7 .BI "color-effect=" name اعمال جلوه رنگ مشخص‌شده برای خروجی. در حال حاضر فقط جلوه‌های رنگی برای اختلالات بینایی رنگ (CVD) ارائه شده است. تنها زمانی کار می‌کند که گزینه .B color\-management برابر false باشد. جلوه می‌تواند یکی از رشته‌های زیر باشد: .RS 11 .TP .B inversion معکوس‌سازی رنگ .TP .B deuteranopia اصلاح رنگ (نه شبیه‌سازی) برای دئوترانوپیا (سبزکوری) .TP .B protanopia اصلاح رنگ (نه شبیه‌سازی) برای پروتانوپیا (سرخ‌کوری) .TP .B tritanopia اصلاح رنگ (نه شبیه‌سازی) برای تریتانوپیا (آبی‌کوری) .RE .TP 7 .BI "seat=" name نام سیت (seat) منطقی که این خروجی باید با آن مرتبط شود. اگر این مقدار تنظیم شود، ورودی‌های سیت به خروجی‌ای که سیت روی آن تنظیم شده محدود خواهد شد. انتظار می‌رود این قابلیت در یک محیط چندنمایشگره با یک کامپوزیتور واحد برای پیکربندی‌های خروجی و ورودی چندگانه استفاده شود. سیت پیش‌فرض "default" نامیده می‌شود و همیشه وجود خواهد داشت. این سیت را نیز می‌توان مانند هر سیت دیگری محدود کرد. .TP 7 .BI "allow_hdcp=" true پشتیبانی از HDCP را برای این خروجی مجاز می‌سازد. اگر روی true تنظیم شود، می‌توان از قابلیت HDCP ارائه‌شده توسط بک‌اندها برای حفاظت از محتوا (content-protection) روی این خروجی استفاده کرد. به طور پیش‌فرض، پشتیبانی از HDCP همیشه برای یک خروجی مجاز است. حفاظت از محتوا تنها در صورتی عملاً محقق می‌شود که سخت‌افزار (منبع و نمایشگر مقصد) از HDCP پشتیبانی کرده و بک‌اند نیز پیاده‌سازی پروتکل حفاظت از محتوا را داشته باشد. در حال حاضر، HDCP توسط drm-backend پشتیبانی می‌شود. .TP 7 .BI "content-type=" content_type نوع محتوایی که عمدتاً روی این خروجی نمایش داده می‌شود. می‌تواند .BR \(dqno data\(dq " (پیش‌فرض)، " .BR \(dqgraphics\(dq "، " .BR \(dqphoto\(dq "، " .B \(dqcinema\(dq یا .B \(dqgame\(dq باشد. .TP 7 .BI "app-ids=" app-id[,app_id]* فهرستی جداشده با کاما از شناسه‌های برنامه‌ها برای قرار دادن روی این خروجی. این شناسه‌ها باید با شناسه‌های برنامه‌ای که از طریق درخواست .B xdg_shell.set_app_id تنظیم شده‌اند مطابقت داشته باشند. در حال حاضر، این گزینه توسط kiosk-shell پشتیبانی می‌شود. .TP 7 .BI "colorimetry-mode=" default حالت کالریمتری (سنجش رنگ) را روی خروجی تنظیم می‌کند. حالت کالریمتری همراه با حالت EOTF در زیر، کدگذاری رنگ مورداستفاده در سیگنال ویدیویی را مشخص می‌کنند. حالت کالریمتری برای انتخاب میان کالریمتری پیش‌فرض تعریف‌شده توسط نمایشگر مقصد (که معمولاً توسط EDID توصیف می‌شود) و سایر کدگذاری‌های استاندارد با پشتیبانی از گستره رنگ گسترده (WCG) استفاده می‌شود. درایور نمایشگر، کارت گرافیک و دریافت‌کننده ویدیو (نمایشگر) باید از حالت انتخابی پشتیبانی کنند، در غیر این صورت نتیجه نامشخص است یا با شکست مواجه می‌شود. این حالت می‌تواند یکی از رشته‌های زیر باشد: .PP .RS 10 .nf .BR "default " "کالریمتری پیش‌فرض (RGB)، وابسته به دریافت‌کننده ویدیو" .BR "bt2020cycc " "درخشندگی ثابت YCbCr بر اساس Rec. ITU-R BT.2020" .BR "bt2020ycc " "درخشندگی غیرثابت YCbCr بر اساس Rec. ITU-R BT.2020" .BR "bt2020rgb " "Rec. ITU-R BT.2020 RGB" .BR "p3d65 " "SMPTE ST 2113 DCI-P3 RGB D65" .BR "p3dci " "SMPTE ST 2113 DCI-P3 RGB Theater" .BR "ictcp " "Rec. ITU-R BT.2100 ICtCp" .fi .RE .IP پیش‌فرض .B default است. حالت‌های غیرپیش‌فرض به .B color\-management=true نیاز دارند. نکته: ممکن است سیستم‌عامل انتخاب میان RGB و YCbCr را رعایت نکند؛ این انتخاب ممکن است به صورت خودکار توسط درایور نمایشگر لینوکس تعیین شود. .TP 7 .BI "eotf-mode=" sdr حالت EOTF را روی خروجی تنظیم می‌کند. این گزینه برای انتخاب میان حالت دامنه دینامیکی استاندارد (SDR) و حالت‌های گوناگون دامنه دینامیکی بالا (HDR) استفاده می‌شود. درایور نمایشگر، کارت گرافیک و دریافت‌کننده ویدیو (نمایشگر) باید از حالت انتخابی پشتیبانی کنند، در غیر این صورت نتیجه تعریف‌نشده خواهد بود. این حالت می‌تواند یکی از رشته‌های زیر باشد: .PP .RS 10 .nf .BR "sdr " "گامای سنتی، SDR" .BR "hdr-gamma " "گامای سنتی، HDR" .BR "st2084 " "SMPTE ST 2084، معروف به Perceptual Quantizer" .BR "hlg " "Hybrid Log-Gamma (ITU-R BT.2100)" .fi .RE .IP پیش‌فرض .B sdr است. حالت‌های غیر SDR به .B color\-management=true نیاز دارند. .TP 7 .BI "color_characteristics=" name ویژگی‌های رنگی پایه‌ای خروجی را با بارگذاری پارامترها از بخش .B color_characteristics با کلید .BI "name=" name تنظیم می‌کند. اگر نمایه ICC نیز تنظیم شده باشد، نمایه ICC اولویت خواهد داشت. .TP 7 .BI "mirror-of=" ouput_name باعث همپوشانی (آینه‌کاری / mirror) خروجی ریموت با خروجی محلیِ (native) مشخص‌شده با مقدار mirror-of می‌شود. این قابلیت برای اشتراک‌گذاری یا آینه‌کاری یک خروجی محلی DRM کاربرد دارد. خروجی‌ای که خروجی محلی DRM را آینه‌کاری می‌کند، همان modeline ویدیویی خروجی محلی DRM را به ارث خواهد برد، شامل نرخ نوسازی و مقیاس خروجی محلی. توجه داشته باشید که بسته به بک‌اند ریموت، در صورت فعال بودن آینه‌کاری، تغییر اندازه خودکار خروجی غیرفعال خواهد شد. آینه‌کاری یک خروجی محلی DRM روی یک خروجی محلی DRM دیگر هنوز پشتیبانی نمی‌شود و تنها برای خروجی‌های ریموت در نظر گرفته شده است. نکته: خروجی‌های محلی ایجادشده توسط بک‌اند DRM با استفاده از .B clone-of برای کلون کردن خروجی‌ها هستند و نه اشتراک‌گذاری یا آینه‌کاری. همچنین ببینید: .BR weston-drm (7). .TP 7 .BI "vrr-mode=" mode حالت نرخ نوسازی متغیر (VRR) نمایشگر را تنظیم می‌کند. این حالت می‌تواند یکی از رشته‌های زیر باشد: .PP .RS 10 .nf .BR "none " "نرخ نوسازی متغیر غیرفعال است" .BR "game " "نرخ نوسازی متغیر بازی (game)" .fi .RE .IP پیش‌فرض .B \(dqnone\(dq است. .\"--------------------------------------------------------------------- .SH "بخش روش ورودی (INPUT-METHOD SECTION)" .TP 7 .BI "path=" "/usr/lib/weston/weston-keyboard" مسیر روش ورودی صفحه‌کلید مجازی (روی صفحه) را تعیین می‌کند (رشته). امکان ارسال آرگومان‌ها و متغیرهای محیطی به برنامه وجود دارد، برای مثال: 'ENVFOO=bar ENVBAR=baz /path/to/program \-\-arg anotherarg'، با مدخل‌هایی که با فاصله از هم جدا شده‌اند اما بدون پشتیبانی از نقل‌قول (کوتیشن). .TP 7 .BI "overlay-keyboard=" false برنامهٔ .B weston-keyboard را به عنوان یک پنل روکش (overlay) تنظیم می‌کند. .\"--------------------------------------------------------------------- .SH "بخش صفحه‌کلید (KEYBOARD SECTION)" این بخش شامل کلیدهای زیر است: .TP 7 .BI "keymap_rules=" "evdev" فایل قواعد نگاشت کلید را تعیین می‌کند (رشته). برای نگاشت چیدمان و مدل به دستگاه ورودی استفاده می‌شود. .TP 7 .BI "keymap_model=" "pc105" مدل نگاشت کلید را تعیین می‌کند (رشته). بخش Models را در .B "xkeyboard-config(7)" ببینید. .TP 7 .BI "keymap_layout=" "us,de,gb" فهرست جداشده با کاما از کدهای چیدمان صفحه‌کلید را تعیین می‌کند (رشته). بخش Layouts را در .B "xkeyboard-config(7)" ببینید. .TP 7 .BI "keymap_variant=" "euro,,intl" فهرست جداشده با کاما از گونه‌های چیدمان صفحه‌کلید را تعیین می‌کند (رشته). تعداد گونه‌ها باید با تعداد چیدمان‌های بالا یکسان باشد. بخش Layouts را در .B "xkeyboard-config(7)" ببینید. .TP 7 .BI "keymap_options=" "grp:alt_shift_toggle,grp_led:scroll" گزینه‌های نگاشت کلید را تعیین می‌کند (رشته). بخش Options را در .B "xkeyboard-config(7)" ببینید. .TP 7 .BI "repeat-rate=" "40" نرخ تکرار کلیدها را بر حسب نویسه در ثانیه تعیین می‌کند (عدد صحیح بدون علامت). .TP 7 .BI "repeat-delay=" "400" تأخیر بر حسب میلی‌ثانیه از زمان فشرده شدن کلید تا آغاز تکرار را تعیین می‌کند (عدد صحیح بدون علامت). .TP 7 .BI "numlock-on=" "false" وضعیت پیش‌فرض numlock را هنگام راه‌اندازی وستون برای بک‌اندهایی که از آن پشتیبانی می‌کنند، تعیین می‌کند. .TP 7 .BI "vt-switching=" "true" تعیین می‌کند که آیا استفاده از کلیدهای ترکیبی .B Ctrl+Alt+Fn برای سوییچ کردن از کنسول مجازی کامپوزیتور مجاز باشد یا خیر. .\"--------------------------------------------------------------------- .SH "بخش ترمینال (TERMINAL SECTION)" شامل تنظیمات برنامهٔ ترمینال وستون .RI ( weston-terminal ) است. این بخش امکان سفارشی‌سازی فونت و پوستهٔ رابط خط فرمان را فراهم می‌کند. .TP 7 .BI "font=" "DejaVu Sans Mono" فونت ترمینال را تعیین می‌کند (رشته). برای یک تجربهٔ خوب توصیه می‌شود از فونت‌های تک‌فاصله (monospace) استفاده شود. در صورتی که فونت پیدا نشود، از فونت پیش‌فرض استفاده می‌شود. .TP 7 .BI "font-size=" "14" اندازهٔ فونت ترمینال را تعیین می‌کند (عدد صحیح بدون علامت). .TP 7 .BI "term=" "xterm-256color" پوستهٔ ترمینال (رشته). متغیر محیطی .B $TERM را تنظیم می‌کند. .\"--------------------------------------------------------------------- .SH "بخش XWAYLAND (XWAYLAND SECTION)" .TP 7 .BI "path=" "/usr/bin/Xwayland" مسیر فایل اجرایی xserver را برای اجرا تعیین می‌کند (رشته). .\"--------------------------------------------------------------------- .SH "بخش اشتراک صفحه (SCREEN-SHARE SECTION)" .TP 7 .SH "منسوخ‌شده: ماژول screen-share به صورت پیش‌فرض ساخته نمی‌شود و منسوخ شده است (DEPRECATED)" برای ساخت آن از گزینهٔ .B deprecated\-screenshare=true استفاده کنید. توجه داشته باشید که قابلیت آینه‌سازی (mirroring) برای جایگزینی این ماژول منسوخ‌شدهٔ اشتراک صفحه اضافه شده است. برای نحوهٔ پیکربندی آن، مدخل کلید .B mirror\-of را در بخش خروجی (output) ببینید. .TP 7 .BI "command=" "/usr/bin/weston --backend=rdp \ --shell=fullscreen --no-resizeable --no-config" دستور لازم برای راه‌اندازی سرور fullscreen-shell جهت اشتراک‌گذاری صفحه را تعیین می‌کند (رشته). .TP 7 .BI "start-on-startup=" "false" در صورت تنظیم روی .BR true ، اشتراک‌گذاری تمامی خروجی‌های موجود را هنگام راه‌اندازی وستون آغاز می‌کند. به صورت پیش‌فرض روی .B false تنظیم شده است. .\"--------------------------------------------------------------------- به صورت پیش‌فرض روی .B false تنظیم شده است. هنگام استفاده از این گزینه، مطمئن شوید که .B \-\-no\-config را فعال کرده‌اید تا از بارگذاری مجدد ماژول .B screen\-share و راه‌اندازی ضمنی اشتراک صفحه برای خروجی RDP که از قبل در حال انجام اشتراک صفحه است، جلوگیری شود. به عنوان راهکار جایگزین، می‌توانید یک فایل پیکربندی متفاوت را با استفاده از .B \-\-config /path/to/config/file ارائه دهید و مطمئن شوید که آن فایل پیکربندی، ماژول .B screen\-share را بارگذاری نمی‌کند. .RE .RE .SH "بخش راه‌اندازی خودکار (AUTOLAUNCH SECTION)" .TP 7 .BI "path=" "/usr/bin/echo" مسیر یک فایل اجرایی برای اجرا پس از راه‌اندازی. این فایل به صورت موازی با وستون اجرا می‌شود، بنابراین نیازی به خروج فوری آن نیست. مقدار پیش‌فرض خالی است. .TP 7 .BI "watch=" "false" در صورت تنظیم روی .BR true ، پس از خروج فایل اجرایی راه‌اندازی‌شده به صورت خودکار، وستون خارج می‌شود (خاتمه می‌یابد). به صورت پیش‌فرض روی .B false تنظیم شده است. .\"--------------------------------------------------------------------- .SH "بخش مشخصات رنگ (COLOR_CHARACTERISTICS SECTION)" هر بخش .B color_characteristics یک مجموعه از پارامترهای پایه‌ای مشخصات رنگ نمایشگر یا مانیتور را ثبت می‌کند. این پارامترها در مشخصات CTA-861-H تحت عنوان Static Metadata Type 1 تعریف شده‌اند و همچنین در EDID نیز یافت می‌شوند. پارامترها به چندین گروه تقسیم شده‌اند. هر گروه باید یا به‌طور کامل تعیین شود یا اصلاً مشخص نگردد. .PP هر بخش باید با کلید .B name نام‌گذاری شود که از طریق آن بتوان از سایر بخش‌ها به آن ارجاع داد. یک بخش متاداده صرفاً مجموعه‌ای از مقادیر پارامترها است و به خودی خود کاری انجام نمی‌دهد؛ تنها زمانی تأثیرگذار خواهد بود که از جای دیگری به آن ارجاع داده شود. .PP کلید .B color_characteristics در بخش .BR output را ببینید. .TP 7 .BI "name=" name نامی دلخواه برای این بخش. تا زمانی که نام شامل نویسهٔ دونقطه .RB ( : ) نباشد، می‌توانید هر نامی را انتخاب کنید. نام‌هایی که حداقل یک دونقطه دارند، رزرو شده‌اند. .SS "گروه رنگ‌های اصلی (Primaries group)" .TP 7 .BI "red_x=" x .TQ .BI "red_y=" y .TQ .BI "green_x=" x .TQ .BI "green_y=" y .TQ .BI "blue_x=" x .TQ .BI "blue_y=" y مختصات فام‌داری (chromaticity) استاندارد CIE 1931 xy برای رنگ‌های اصلی نمایشگر. این مقادیر ممیز شناور باید بین 0.0 و 1.0 (شامل هر دو مقدار) باشند. .SS "گروه نقطه سفید (White point group)" .TP 7 .BI "white_x=" x .TQ .BI "white_y=" y مختصات فام‌داری استاندارد CIE 1931 xy برای نقطه سفید نمایشگر. این مقادیر ممیز شناور باید بین 0.0 و 1.0 (شامل هر دو مقدار) باشند. .SS "پارامترهای مستقل (Independent parameters)" هر یک از پارامترهای فهرست‌شده در اینجا گروه اختصاصی خود را دارند و بنابراین می‌توانند به تنهایی ارائه شوند. .TP 7 .BI "max_L=" L روشنایی (درخشندگی) اوج محتوای مورد نظر برای نمایشگر به صورت .IR L "\~cd/m²،" یک مقدار ممیز شناور در بازهٔ 0.0\(en100000.0. .TP 7 .BI "min_L=" L روشنایی (درخشندگی) کمینهٔ محتوای مورد نظر برای نمایشگر به صورت .IR L "\~cd/m²،" یک مقدار ممیز شناور در بازهٔ 0.0\(en100000.0. .TP 7 .BI "maxFALL=" L بیشینهٔ میانگین سطح روشنایی فریم (frame-average light level) مورد نظر برای نمایشگر به صورت .IR L "\~cd/m²،" یک مقدار ممیز شناور در بازهٔ 0.0\(en100000.0. .\"--------------------------------------------------------------------- .SH "بخش پروفایل رنگ (COLOR-PROFILE SECTION)" هر بخش .B color\-profile مجموعه‌ای از پارامترهای پایه‌ای توصیف مشخصات رنگ نمایشگر را ثبت می‌کند. برخی از پارامترها در قالب گروه‌ها گردآوری شده‌اند. هر گروه باید یا به‌طور کامل مشخص شود یا اصلاً مشخص نشود. یک بخش قابل استفاده باید دست‌کم شامل رنگ‌های اصلی سیگنال‌دهی .RB ( "Signaling primaries group" " یا " prim_named ) و تابع انتقال .RB ( tf_named " یا " tf_power ) باشد. .PP هر بخش باید با کلید .B name نام‌گذاری شود که از طریق آن بتوان از سایر بخش‌ها به آن ارجاع داد. یک بخش .B color\-profile تنها مجموعه‌ای از مقادیر پارامترها است و به‌خودی‌خود کاری انجام نمی‌دهد. این بخش تنها هنگامی تأثیرگذار خواهد بود که از جای دیگری به آن ارجاع داده شود. .PP کلید .B color\-profile در بخش .B output را ببینید. .TP 7 .BI "name=" name یک نام دلخواه برای این بخش. تا زمانی که نام شامل نویسهٔ دونقطه .RB ( : ) نباشد، می‌توانید هر نامی را که می‌خواهید انتخاب کنید. نام‌های دارای دست‌کم یک دونقطه رزرو شده‌اند. .TP 7 .BI "prim_named=" name مجموعه‌ای استاندارد از رنگ‌های اصلی و نقطهٔ سفید برای سیگنال‌دهی. نام‌های زیر شناخته‌شده هستند: .RS 11 .TP .B srgb sRGB (IEC 61966-2-1) و ITU-R BT.709 .TP .B pal_m PAL-M (ITU-R BT.470-6) .TP .B pal PAL (ITU-R BT.470-6)، ITU-R BT.601-7 625-line .TP .B ntsc NTSC (SMPTE 170M-2004)، ITU-R BT.601-7 525-line .TP .B generic_film فیلم عمومی با فیلترهای رنگی با استفاده از Illuminant C (ITU-T H.273) .TP .B bt2020 ITU-R BT.2020 و BT.2100 .TP .B cie1931_xyz CIE 1931 XYZ (ITU-T H.273) .TP .B dci_p3 DCI P3 (SMPTE RP 431-2) .TP .B display_p3 Apple Display P3، SMPTE EG 432-1 .TP .B adobe_rgb Adobe RGB (ISO 12640) .RE .IP با گروه .B Signaling primaries group که می‌توان با آن رنگ‌های اصلی و نقطهٔ سفید سفارشی را تعریف کرد، ناسازگار است (همزمان قابل استفاده نیستند). .TP 7 .BI "target_named=" name مجموعه‌ای استاندارد از رنگ‌های اصلی و نقطهٔ سفید برای حجم رنگ هدف. همان نام‌های معرفی‌شده برای .B prim_named شناخته‌شده هستند. .IP با گروه .B Target primaries group که می‌توان با آن رنگ‌های اصلی و نقطهٔ سفید سفارشی را تعریف کرد، ناسازگار است (همزمان قابل استفاده نیستند). .TP 7 .BI "tf_named=" name یک تابع یا مشخصهٔ انتقال استاندارد. نام‌های زیر شناخته‌شده هستند: .PP .RS 11 .TP .B bt1886 مشخصهٔ انتقال نمایشگر Rec. ITU-R BT.1886. مقادیر پیش‌فرض عبارتند از: min_lum=0.01، ref_lum=100، max_lum=100. .TP .B gamma22 تابع انتقال فرضی گامای ۲٫۲ نمایشگر. یک نمایشگر sRGB (IEC 61966-2-1) از این تابع انتقال استفاده می‌کند. .TP .B gamma28 تابع انتقال فرضی گامای ۲٫۸ نمایشگر. .TP .B st240 SMPTE ST 240 (1999) .TP .B st428 SMPTE ST 428-1 (2019) .TP .B st2084 مشخصهٔ انتقال کوانتایزر ادراکی SMPTE ST 2084 Perceptual Quantizer (PQ). مقادیر پیش‌فرض عبارتند از: min_lum=0.005، ref_lum=203. .TP .B linear تابع انتقال خطی تعریف‌شده روی تمام اعداد حقیقی. مقادیر الکتریکی نرمال‌شده برابر با مقادیر نوری نرمال‌شده هستند. .TP .B log100 مشخصهٔ انتقال لگاریتمی (محدودهٔ ۱۰۰:۱). .TP .B log316 مشخصهٔ انتقال لگاریتمی (محدودهٔ 100 * Sqrt(10) : 1). .TP .B xvycc IEC 61966-2-4 .TP .B hlg مشخصهٔ انتقال Rec. ITU-R BT.2100 HLG. مقادیر پیش‌فرض عبارتند از: min_lum=0.005، ref_lum=203، max_lum=1000. .RE .IP مگر در مواردی که در بالا به‌گونهٔ دیگری ذکر شده باشد، مقادیر پیش‌فرض درخشندگی سیگنال‌دهی عبارتند از: min_lum=0.2، ref_lum=80، max_lum=80. گروه .B Signaling luminances group را ببینید. .IP با .B tf_power ناسازگار است (همزمان قابل استفاده نیستند). .TP 7 .BI "tf_power=" E با .B tf_named ناسازگار است (همزمان قابل استفاده نیستند). تابع انتقال را به‌صورت منحنی قانون توان با توان داده‌شدهٔ .IR E تنظیم می‌کند؛ یک عدد حقیقی در محدودهٔ [1.0, 10.0]. مقادیر پیش‌فرض عبارتند از: min_lum=0.2، ref_lum=80، max_lum=80. .TP 7 .BI "max_fall=" L حداکثر سطح روشنایی میانگین فریم (Frame-Average Light Level) مورد نظر نمایشگر .IR L " cd/m²." در صورت تنظیم نشدن، تعریف‌نشده است. .TP 7 .BI "max_cll=" L حداکثر سطح روشنایی محتوا (Content Light Level) برای نمایشگر .IR L " cd/m²." در صورت تنظیم نشدن، تعریف‌نشده است. .SS "گروه رنگ‌های اصلی سیگنال‌دهی (Signaling primaries group)" .TP 7 .BI "prim_red=" "x y" .TQ .BI "prim_green=" "x y" .TQ .BI "prim_blue=" "x y" .TQ .BI "prim_white=" "x y" گروه رنگ‌های اصلی سیگنال‌دهی، رنگ‌های اصلی و نقطه سفید مورد استفاده برای کدگذاری سه‌محرکی (tristimulus) به مقادیر RGB را تعریف می‌کند که با عنوان حجم رنگ اصلی (primary color volume) نیز شناخته می‌شود. .IR x " و " y مختصات فام‌داری (chromaticity) ناظر ۲ درجه CIE 1931 هستند. این مقادیر باید در محدوده [-1.0, 2.0] باشند. .PP برای روشی ساده‌تر جهت تعریف رنگ‌های اصلی استاندارد، به .B prim_named مراجعه کنید که با گروه رنگ‌های اصلی سیگنال‌دهی مانعةالجمع است. .SS "گروه درخشندگی‌های سیگنال‌دهی (Signaling luminances group)" .TP 7 .BI "min_lum=" Lmin .TQ .BI "ref_lum=" Lref .TQ .BI "max_lum=" Lmax .IR Lmin \(en Lmax محدوده دینامیکی نمایشگر متناظر با سطوح سیگنال 0%\(en100% است. برای تنظیم .B tf_named=st2084 مقدار .I Lmax با مقدار 10'000 + .IR Lmin بازنویسی می‌شود. .I Lref سطح درخشندگی مرجع است که تمام محتوای برنامه‌ها با آن مطابقت داده می‌شود؛ همچنین با عنوان درخشندگی سفید گرافیک (graphics white luminance) یا اوج درخشندگی محدوده دینامیکی استاندارد (SDR) شناخته می‌شود. تمام مقادیر، اعداد حقیقی مثبت بر حسب cd/m² هستند. .I Lmin می‌تواند صفر نیز باشد. .I Lmin باید کمتر از .I Lref و .I Lmax باشد. .PP در صورت عدم تنظیم، مقادیر پیش‌فرض به تابع تبدیل یا مشخصه انتخاب‌شده بستگی دارند. .SS "گروه رنگ‌های اصلی هدف (Target primaries group)" .TP 7 .BI "target_red=" "x y" .TQ .BI "target_green=" "x y" .TQ .BI "target_blue=" "x y" .TQ .BI "target_white=" "x y" حجم رنگ هدف شبیه به «حجم رنگ نمایشگر مرجع مسترینگ» (Mastering Display Color Volume یا MDCV) است، از این نظر که هر محرک کدگذاری‌شده در خارج از آن نمایشی تعریف‌نشده دارد. این ویژگی به‌ویژه برای نمایشگری مفید است که از کدگذاری سیگنال گستره رنگ وسیع (مانند BT.2020) استفاده می‌کند اما فقط می‌تواند زیرمجموعه‌ای از آن گستره رنگ را تولید کند. .IR x " و " y مختصات فام‌داری ناظر ۲ درجه CIE 1931 هستند. این مقادیر باید در محدوده [-1.0, 2.0] باشند. .PP در صورت عدم تنظیم، به صورت پیش‌فرض حجم رنگ اصلی در نظر گرفته می‌شود. .PP برای روشی ساده‌تر جهت تعریف رنگ‌های هدف استاندارد، به .B target_named مراجعه کنید که با گروه رنگ‌های اصلی هدف مانعةالجمع است. .SS "گروه درخشندگی‌های هدف (Target luminances group)" .TP 7 .BI "target_min_lum=" Lmin .TQ .BI "target_max_lum=" Lmax محدوده درخشندگی حجم رنگ هدف. .IR Lmin " و " Lmax اعداد حقیقی مثبت بر حسب cd/m² هستند. .I Lmin می‌تواند صفر نیز باشد، و باید کمتر از .IR Lmax باشد. .PP در صورت عدم تنظیم، به صورت پیش‌فرض محدوده درخشندگی سیگنال‌دهی در نظر گرفته می‌شود. .\"--------------------------------------------------------------------- .SH "همچنین ببینید (SEE ALSO)" .BR weston (1), .BR weston-bindings (7), .BR weston-drm (7), .BR xkeyboard-config (7)