نام (NAME)

FvwmBacker - ماژول تغییر پس‌زمینه برای fvwm

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

Module FvwmBacker

تنها fvwm می‌تواند FvwmBacker را فراخوانی کند. فراخوانی ماژول FvwmBacker از خط فرمان کار نخواهد کرد.

توضیحات (DESCRIPTION)

ماژول FvwmBacker قابلیتی برای تغییر پس‌زمینه هنگام جابه‌جایی بین میزکارها فراهم می‌کند. هر دستوری می‌تواند برای تغییر پس‌زمینه‌ها اجرا شود. در واقع، هر دستور دلخواهی را می‌توان برای اجرا به fvwm فرستاد؛ بنابراین می‌توانید کارهایی مانند تغییر رنگ حاشیهٔ پنجره‌ها و غیره را نیز انجام دهید.

کپی‌رایت و تکثیر (COPYRIGHT)

ماژول FvwmBacker اثر اصلی Mike Finger است.

حق تکثیر ۱۹۹۴، Mike Finger. نویسنده هیچ‌گونه ضمانت یا تعهدی از هر نوع در قبال استفاده از این ماژول ارائه نمی‌دهد. مسئولیت استفاده از این ماژول بر عهدهٔ خود شماست. شما می‌توانید آزادانه از این ماژول یا هر بخشی از آن برای هر مقصودی استفاده کنید مادامی که کپی‌رایت دست‌نخورده باقی بماند.

راه‌اندازی اولیه (INITIALIZATION)

در طول راه‌اندازی اولیه، FvwmBacker اطلاعات پیکربندی را از پایگاه دادهٔ پیکربندی ماژول‌های fvwm دریافت می‌کند (بخش MODULE COMMANDS در fvwm(1) را ببینید). گزینه‌های موجود در بخشی جلوتر بررسی می‌شوند.

نحوه فراخوانی (INVOCATION)

ماژول FvwmBacker می‌تواند در زمان راه‌اندازی اولیه توسط fvwm با درج خط

AddToFunc StartFunction I Module FvwmBacker

در فایل .fvwm2rc فراخوانی شود.

همچنین FvwmBacker می‌تواند در هر زمان هنگام اجرای fvwm، با استفاده از دستور 'Module FvwmBacker' اجرا یا با استفاده از دستور 'KillModule FvwmBacker' متوقف شود.

برای اینکه FvwmBacker توسط fvwm اجرا شود، باید در دایرکتوری‌ای قرار داشته باشد که در گزینهٔ ModulePath در fvwm فهرست شده است.

گزینه‌های پیکربندی (CONFIGURATION OPTIONS)

گزینه‌های زیر می‌توانند در فایل .fvwm2rc قرار گیرند:

*FvwmBacker: Command (Desk d, Page x y) command

دستور (command) را برای اجرا مشخص می‌کند هنگامی که درگاه دید (viewport) با آرگومان‌های مربوط به میزکار d و مختصات x و y صفحه (page) مطابقت داشته باشد. هر کدام یا همهٔ این سه آرگومان عددی را می‌توان با یک ستاره (*) جایگزین کرد تا نشان دهد هر مقداری مطابقت دارد؛ در این حالت بخش‌های Desk یا Page را می‌توان نادیده گرفت.

اگر هر یک از بخش‌های Desk یا Page حذف شوند، در صورتی که فقط میزکار یا فقط صفحه تغییر کند، دستور اجرا نمی‌شود. اگر هیچ‌کدام مشخص نشوند، دستور تنها یک بار در زمان آغاز به کار ماژول اجرا خواهد شد. این رفتار مشابه استفاده از ستاره برای آرگومان‌های عددی نیست: اگر از ستاره استفاده شود، هر بار که فقط میزکار یا صفحه تغییر کند دستور همواره اجرا می‌شود؛ اما اگر بخش مربوطه حذف شده باشد، با تغییر تنها میزکار یا صفحه، دستور هرگز اجرا نخواهد شد.

اگر command برابر -solid باشد، FvwmBacker از آرگومان بعدی به عنوان یک رنگ در پایگاه دادهٔ X استفاده می‌کند و بدون ایجاد یک فراخوانی سیستمی به xsetroot پس‌زمینه را روی آن رنگ تنظیم می‌کند (تنها نام‌های رنگی تک‌کلمه‌ای مجاز هستند).

اگر command برابر colorset باشد، FvwmBacker از پس‌زمینهٔ مشخص‌شده در مجموعه رنگ n برای میزکار داده‌شده استفاده می‌کند. لطفاً برای جزئیات دربارهٔ مجموعه‌های رنگ به صفحهٔ راهنمای fvwm مراجعه کنید.

در غیر این صورت، دستور برای اجرا به fvwm ارسال می‌شود.

*FvwmBacker: RetainPixmap

باعث می‌شود FvwmBacker تصویر شطرنجی (Pixmap) که پس‌زمینه با آن تنظیم شده است را نگه‌داری و منتشر کند. این مورد فقط برای دستورهای -solid یا colorset کار می‌کند. این قابلیت برای برنامه‌هایی مفید است که می‌خواهند از Pixmap ریشه روی پس‌زمینه برای شبیه‌سازی شفافیت استفاده کنند (به عنوان مثال، Eterm و Aterm از این روش استفاده می‌کنند). این گزینه همچنین باید برای گزینهٔ RootTransparent در مجموعه رنگ استفاده شود. نکته: در مورد پس‌زمینهٔ مجموعه رنگ، این دستور ممکن است حافظهٔ زیادی به کارساز X اضافه کند. برای نمونه، این کار به اندازهٔ حاصل‌ضرب عرض در ارتفاع به بایت برای تصویر TiledPixmap، حاصل‌ضرب screen_width در screen_height به بایت برای تصویر Pixmap یا گرادیان‌های C، B، D، R، S یا Y، و screen_width بایت برای VGradient یا screen_height بایت برای HGradient حافظه اضافه می‌کند.

*FvwmBacker: DoNotRetainPixmap

اثر گزینهٔ قبلی را لغو می‌کند. این حالت پیش‌فرض است.

پیکربندی زمان اجرا (RUN-TIME CONFIGURATION)

امکان جایگزینی پیکربندی FvwmBacker در زمان اجرا وجود دارد، هرچند هنوز امکان حذف خطوط پیکربندی فعلی وجود ندارد. این کار به‌سادگی با حذف پیکربندی قدیمی از درون fvwm و سپس خواندن پیکربندی جدید انجام می‌شود. این عمل از راه‌های متعددی امکان‌پذیر است؛ برای نمونه با استفاده از یک تابع fvwm یا یکی از ماژول‌های FvwmCommand.

مثال:

DestroyModuleConfig FvwmBacker*
*FvwmBacker: Command (Desk 0) -solid black
*FvwmBacker: Command (Desk 1) -solid blue

گزینه‌های سبک قدیمی (OLD-STYLE OPTIONS)

پشتیبانی از گزینهٔ منسوخ‌شدهٔ زیر همچنان ادامه دارد:

*FvwmBacker: Desk d command

این گزینه از نظر عملکردی معادل حذف مختصات صفحه با *FvwmBacker: Command است:

*FvwmBacker: Command (Desk Id) command

نمونه پیکربندی (SAMPLE CONFIGURATION)

موارد زیر بخش‌هایی از یک فایل .fvwm2rc هستند که دستورهای راه‌اندازی FvwmBacker را شرح می‌دهند:

####
# Set Up Backgrounds for different desktop pages (2 desks, 3x2 pages).
####
*FvwmBacker: Command (Page 2 *) -solid steelblue
*FvwmBacker: Command (Desk 0, Page 0 0) Exec fvwm-root $[HOME]/bg2.xpm
*FvwmBacker: Command (Desk 0, Page 0 1) -solid midnightblue
*FvwmBacker: Command (Desk 0, Page 1 *) -solid yellow
*FvwmBacker: Command (Desk 1, Page * 0) -solid navy
*FvwmBacker: Command (Desk 1, Page * 1) Colorset 5

نویسندگان (AUTHORS)

Mike Finger ( <mfinger@mermaid.micro.umn.edu>)

تغییریافته توسط (MODIFIED BY)

Andrew Davison ( <davison@cs.monash.edu.au>)

Michael Han ( <mikehan@best.com>)

Mikhael Goikhman ( <migo@homemail.com>)