'\" t
.\"     Title: FvwmBacker
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-28
.\"    Manual: Fvwm Modules
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "FVWMBACKER" "1" "2026-06-28" "\ \&" "Fvwm Modules"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
FvwmBacker \- ماژول تغییر پس‌زمینه برای fvwm
.SH "خلاصه دستور (SYNOPSIS)"
.sp
Module FvwmBacker
.sp
تنها fvwm می‌تواند \fIFvwmBacker\fP را فراخوانی کند. فراخوانی ماژول
\fIFvwmBacker\fP از خط فرمان کار نخواهد کرد.
.SH "توضیحات (DESCRIPTION)"
.sp
ماژول FvwmBacker قابلیتی برای تغییر پس‌زمینه هنگام جابه‌جایی بین میزکارها
فراهم می‌کند. هر دستوری می‌تواند برای تغییر پس‌زمینه‌ها اجرا شود.
در واقع، هر دستور دلخواهی را می‌توان برای اجرا به fvwm فرستاد؛ بنابراین
می‌توانید کارهایی مانند تغییر رنگ حاشیهٔ پنجره‌ها و غیره را نیز انجام دهید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
ماژول FvwmBacker اثر اصلی Mike Finger است.
.sp
حق تکثیر ۱۹۹۴، Mike Finger. نویسنده هیچ‌گونه ضمانت یا تعهدی از هر نوع
در قبال استفاده از این ماژول ارائه نمی‌دهد. مسئولیت استفاده از این ماژول
بر عهدهٔ خود شماست. شما می‌توانید آزادانه از این ماژول یا هر بخشی از آن برای
هر مقصودی استفاده کنید مادامی که کپی‌رایت دست‌نخورده باقی بماند.
.SH "راه‌اندازی اولیه (INITIALIZATION)"
.sp
در طول راه‌اندازی اولیه، \fIFvwmBacker\fP اطلاعات پیکربندی را از پایگاه دادهٔ
پیکربندی ماژول‌های \fBfvwm\fP دریافت می‌کند (بخش \fBMODULE
COMMANDS\fP در \fIfvwm\fP(1) را ببینید). گزینه‌های موجود در بخشی جلوتر
بررسی می‌شوند.
.SH "نحوه فراخوانی (INVOCATION)"
.sp
ماژول FvwmBacker می‌تواند در زمان راه‌اندازی اولیه توسط fvwm با درج خط
.sp
.if n .RS 4
.nf
.fam C
AddToFunc StartFunction I Module FvwmBacker
.fam
.fi
.if n .RE
.sp
در فایل .fvwm2rc فراخوانی شود.
.sp
همچنین FvwmBacker می‌تواند در هر زمان هنگام اجرای fvwm، با استفاده از دستور
\*(AqModule FvwmBacker\*(Aq اجرا یا با استفاده از دستور \*(AqKillModule FvwmBacker\*(Aq
متوقف شود.
.sp
برای اینکه FvwmBacker توسط fvwm اجرا شود، باید در دایرکتوری‌ای قرار داشته باشد
که در گزینهٔ ModulePath در fvwm فهرست شده است.
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.sp
گزینه‌های زیر می‌توانند در فایل .fvwm2rc قرار گیرند:
.sp
*FvwmBacker: Command (Desk d, Page x y) command
.RS 4
دستور (\fIcommand\fP) را برای اجرا مشخص می‌کند هنگامی که درگاه دید (viewport) با
آرگومان‌های مربوط به میزکار d و مختصات x و y صفحه (page) مطابقت داشته باشد.
هر کدام یا همهٔ این سه آرگومان عددی را می‌توان با یک ستاره (*) جایگزین کرد
تا نشان دهد هر مقداری مطابقت دارد؛ در این حالت بخش‌های Desk یا Page
را می‌توان نادیده گرفت.
.sp
اگر هر یک از بخش‌های \fIDesk\fP یا \fIPage\fP حذف شوند، در صورتی که فقط میزکار
یا فقط صفحه تغییر کند، دستور اجرا نمی‌شود. اگر هیچ‌کدام مشخص نشوند، دستور
تنها یک بار در زمان آغاز به کار ماژول اجرا خواهد شد. این رفتار مشابه استفاده
از ستاره برای آرگومان‌های عددی نیست: اگر از ستاره استفاده شود، هر بار که فقط
میزکار یا صفحه تغییر کند دستور همواره اجرا می‌شود؛ اما اگر بخش مربوطه حذف
شده باشد، با تغییر تنها میزکار یا صفحه، دستور هرگز اجرا نخواهد شد.
.sp
اگر \fIcommand\fP برابر \fI\-solid\fP باشد، FvwmBacker از آرگومان بعدی به عنوان
یک رنگ در پایگاه دادهٔ X استفاده می‌کند و بدون ایجاد یک فراخوانی سیستمی به
xsetroot پس‌زمینه را روی آن رنگ تنظیم می‌کند (تنها نام‌های رنگی تک‌کلمه‌ای
مجاز هستند).
.sp
اگر \fIcommand\fP برابر \fIcolorset\fP باشد، FvwmBacker از پس‌زمینهٔ مشخص‌شده در
مجموعه رنگ \fIn\fP برای میزکار داده‌شده استفاده می‌کند. لطفاً برای جزئیات
دربارهٔ مجموعه‌های رنگ به صفحهٔ راهنمای fvwm مراجعه کنید.
.sp
در غیر این صورت، دستور برای اجرا به fvwm ارسال می‌شود.
.RE
.sp
*FvwmBacker: RetainPixmap
.RS 4
باعث می‌شود FvwmBacker تصویر شطرنجی (Pixmap) که پس‌زمینه با آن تنظیم شده است را
نگه‌داری و منتشر کند. این مورد فقط برای دستورهای \fI\-solid\fP یا
\fIcolorset\fP کار می‌کند. این قابلیت برای برنامه‌هایی مفید است که می‌خواهند
از Pixmap ریشه روی پس‌زمینه برای شبیه‌سازی شفافیت استفاده کنند (به عنوان مثال،
Eterm و Aterm از این روش استفاده می‌کنند). این گزینه همچنین باید برای گزینهٔ
RootTransparent در مجموعه رنگ استفاده شود. نکته: در مورد پس‌زمینهٔ مجموعه رنگ،
این دستور ممکن است حافظهٔ زیادی به کارساز X اضافه کند. برای نمونه، این کار
به اندازهٔ حاصل‌ضرب عرض در ارتفاع به بایت برای تصویر TiledPixmap، حاصل‌ضرب
screen_width در screen_height به بایت برای تصویر Pixmap یا گرادیان‌های
C، B، D، R، S یا Y، و screen_width بایت برای VGradient یا screen_height
بایت برای HGradient حافظه اضافه می‌کند.
.RE
.sp
*FvwmBacker: DoNotRetainPixmap
.RS 4
اثر گزینهٔ قبلی را لغو می‌کند. این حالت پیش‌فرض است.
.RE
.SH "پیکربندی زمان اجرا (RUN\-TIME CONFIGURATION)"
.sp
امکان جایگزینی پیکربندی FvwmBacker در زمان اجرا وجود دارد، هرچند هنوز
امکان حذف خطوط پیکربندی فعلی وجود ندارد. این کار به‌سادگی با حذف پیکربندی
قدیمی از درون fvwm و سپس خواندن پیکربندی جدید انجام می‌شود. این عمل از راه‌های
متعددی امکان‌پذیر است؛ برای نمونه با استفاده از یک تابع fvwm یا یکی از
ماژول‌های \fBFvwmCommand\fP.
.sp
مثال:
.sp
.if n .RS 4
.nf
.fam C
DestroyModuleConfig FvwmBacker*
*FvwmBacker: Command (Desk 0) \-solid black
*FvwmBacker: Command (Desk 1) \-solid blue
.fam
.fi
.if n .RE
.SH "گزینه‌های سبک قدیمی (OLD\-STYLE OPTIONS)"
.sp
پشتیبانی از گزینهٔ منسوخ‌شدهٔ زیر همچنان ادامه دارد:
.sp
*FvwmBacker: Desk d command
.RS 4
این گزینه از نظر عملکردی معادل حذف مختصات صفحه با
\fI*FvwmBacker: Command\fP است:
.RE
.sp
.if n .RS 4
.nf
.fam C
*FvwmBacker: Command (Desk Id) command
.fam
.fi
.if n .RE
.SH "نمونه پیکربندی (SAMPLE CONFIGURATION)"
.sp
موارد زیر بخش‌هایی از یک فایل .fvwm2rc هستند که دستورهای راه‌اندازی
FvwmBacker را شرح می‌دهند:
.sp
.if n .RS 4
.nf
.fam C
####
# 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
.fam
.fi
.if n .RE
.SH "نویسندگان (AUTHORS)"
.sp
Mike Finger (\c
.MTO "mfinger\(atmermaid.micro.umn.edu" "" ")"
.SH "تغییریافته توسط (MODIFIED BY)"
.sp
Andrew Davison (\c
.MTO "davison\(atcs.monash.edu.au" "" ")"
.sp
Michael Han (\c
.MTO "mikehan\(atbest.com" "" ")"
.sp
Mikhael Goikhman (\c
.MTO "migo\(athomemail.com" "" ")"