'\" t .\" Title: fvwm3 .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-06-28 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" .TH "FVWM3" "1" "2026-06-28" "\ \&" "\ \&" .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)" fvwm3 \- مدیر پنجره مجازی F? برای X11 .SH "خلاصه دستور (SYNOPSIS)" .sp \fBfvwm3\fP [\fB\-c\fP \fIconfig\-command\fP] [\fB\-d\fP \fIdisplayname\fP] [\fB\-f\fP \fIconfig\-file\fP] [\fB\-o\fP \fIlogfile\fP] [\fB\-v\fP] .SH "توضیحات (DESCRIPTION)" .sp برنامه Fvwm یک مدیر پنجره برای X11 است که برای سرعت بهینه‌سازی شده است. .sp برنامه Fvwm طوری طراحی شده است که اشغال حافظه پایینی داشته باشد و فوق‌العاده سفارشی‌پذیر و توسعه‌پذیر است. یک \fIمیزکار مجازی\fP بزرگ و \fIچندین میزکار مجزا\fP می‌توانند به صورت جداگانه یا همراه با یکدیگر استفاده شوند. میزکار مجازی چنین وانمود می‌کند که صفحه نمایش ویدئویی در واقع بسیار بزرگ است، و شما می‌توانید درون میزکار پیمایش کنید. چندین میزکار مجزا وانمود می‌کنند که واقعاً چندین صفحه نمایش مختلف برای کار وجود دارد، اما هر صفحه نمایش کاملاً از دیگری مستقل و بی‌ارتباط است. .sp برنامه Fvwm امکان \fIشتاب‌دهنده‌های صفحه‌کلید\fP را فراهم می‌کند که اجازه می‌دهند عملاً تمامی عملکردهای مدیر پنجره، از جمله جابجایی و تغییر اندازه پنجره‌ها و کار با منوها، با استفاده از میانبرهای صفحه‌کلید انجام شوند. .sp برنامه Fvwm تمایزی بین دستورهای پیکربندی و دستورهای عملیاتی قائل نمی‌شود. دستورهای پیکربندی معمولاً قلم‌ها، رنگ‌ها، محتوای منو و انتساب‌های عملکردهای کلید و موشواره را تعیین می‌کنند، در حالی که دستورهای عملیاتی کارهایی نظیر بالا آوردن و پایین بردن پنجره‌ها را انجام می‌دهند. Fvwm هیچ تمایزی قائل نیست و اجازه می‌دهد هر چیزی در هر زمانی تغییر داده شود. .SH "گزینه‌ها (OPTIONS)" .sp گزینه‌های خط فرمانی که توسط fvwm شناسایی می‌شوند عبارتند از: .sp \fB\-i\fP | \fB\-\-clientid\fP \fIid\fP .RS 4 این گزینه زمانی استفاده می‌شود که fvwm توسط یک مدیر نشست راه‌اندازی شده باشد. کاربر نباید از آن استفاده کند. .RE .sp \fB\-c\fP | \fB\-\-cmd\fP \fIconfig\-command\fP .RS 4 باعث می‌شود fvwm به جای \*(Aq\fBRead\fP \fIconfig\fP\*(Aq (یا \*(Aq\fBRead\fP \fI.fvwm2rc\fP\*(Aq) از \fIconfig\-command\fP به عنوان دستور مقداردهی اولیه خود استفاده کند. (توجه داشته باشید که حداکثر تا ۱۰ پارامتر \fB\-f\fP و \fB\-c\fP می‌توان مشخص کرد، و آن‌ها به ترتیبی که تعیین شده‌اند اجرا می‌شوند.) .sp فرض می‌شود هر ماژولی که با آرگومان‌های خط فرمان راه‌اندازی می‌شود، ماژولی است که دستورهای پیکربندی را پس می‌فرستد. تمام ماژول‌های خط فرمان باید پیش از اینکه fvwm به سراغ StartFunction و تنظیم تزیینات و سبک‌های حاشیه برود، خاتمه یابند. اگر ماژولی غیر از \fBFvwmPerl\fP را اجرا کنید بن‌بست احتمالی رخ می‌دهد، اما یک مهلت زمانی وجود دارد تا در نهایت fvwm به کار خود ادامه دهد. .sp به عنوان مثال، راه‌اندازی صفحه‌بند (pager) از این طریق fvwm را تا زمان سرآمدن مهلت متوقف می‌کند، اما دستور زیر به خوبی کار خواهد کرد: .RE .sp .if n .RS 4 .nf .fam C fvwm \-c "AddToFunc StartFunction I Module FvwmPager" .fam .fi .if n .RE .sp \fB\-d\fP | \fB\-\-display\fP \fIdisplayname\fP .RS 4 نمایشگری با نام \fIdisplayname\fP را به جای نام به‌دست‌آمده از متغیر محیطی \fI$DISPLAY\fP مدیریت می‌کند. .RE .sp \fB\-f\fP \fIconfig\-file\fP .RS 4 باعث می‌شود fvwm به جای \fI~/.fvwm/config\fP، فایل \fIconfig\-file\fP را به عنوان فایل مقداردهی اولیه خود بخواند. متغیر محیطی \fI$FVWM_USERDIR\fP نیز می‌تواند برای تغییر مکان دایرکتوری پیش‌فرض کاربر یعنی \fI~/.fvwm\fP استفاده شود. .RE .sp \fB\-o\fP \fIlogfile\fP .RS 4 پیام‌های ثبت گزارش را در \fIlogfile\fP می‌نویسد. اگر \fIlogfile\fP برابر \*(Aq\-\*(Aq باشد، گزارش‌ها در کنسول نوشته می‌شوند. (ثبت گزارش را فعال نمی‌کند؛ گزینه \fB\-v\fP را ببینید.) .RE .sp \fB\-h\fP | \fB\-\-help\fP .RS 4 توضیحات کوتاهی درباره نحوه استفاده چاپ می‌شود. .RE .sp \fB\-r\fP | \fB\-\-replace\fP .RS 4 تلاش برای تحویل گرفتن مدیریت پنجره از یک wm در حال اجرای قبلی. این کار تنها در صورتی عمل می‌کند که مدیر پنجره دیگر با ICCCM2 2.0 سازگار باشد. .RE .sp \fB\-F\fP | \fB\-\-restore\fP \fIstate\-file\fP .RS 4 این گزینه زمانی استفاده می‌شود که fvwm توسط یک مدیر نشست راه‌اندازی شده باشد. کاربر نباید از آن استفاده کند. .RE .sp \fB\-V\fP | \fB\-\-version\fP .RS 4 نسخه fvwm را در \fIstderr\fP چاپ می‌کند. همچنین اطلاعاتی در مورد ویژگی‌های گنجانده‌شده در حین کامپایل که در زمان ساخت مشخص شده‌اند چاپ می‌کند. .RE .sp \fB\-C\fP | \fB\-\-visual\fP \fIvisual\-class\fP .RS 4 باعث می‌شود fvwm از \fIvisual\-class\fP برای حاشیه‌ها و منوهای پنجره استفاده کند. مقدار \fIvisual\-class\fP می‌تواند یکی از موارد "StaticGray"، "GrayScale"، "StaticColor"، "PseudoColor"، "TrueColor" یا "DirectColor" باشد. .RE .sp \fB\-I\fP | \fB\-\-visualid\fP \fIid\fP .RS 4 باعث می‌شود fvwm از \fIid\fP به عنوان visual id برای حاشیه‌ها و منوهای پنجره استفاده کند. مقدار \fIid\fP می‌تواند به صورت ده‌دهی N یا مبنای ۱۶ به صورت 0xN مشخص شود. برای مشاهده فهرستی از visualهای پشتیبانی‌شده، صفحه راهنمای xdpyinfo را ببینید. .RE .sp \fB\-l\fP | \fB\-\-color\-limit\fP \fIlimit\fP .RS 4 یک سقف (\fIlimit\fP) برای رنگ‌های استفاده‌شده در تصویر، گرادیان و احتمالاً رنگ‌های ساده استفاده‌شده توسط fvwm مشخص می‌کند. در واقع، fvwm (و تمام ماژول‌ها) از یک پالت با حداکثر \fIlimit\fP رنگ استفاده می‌کند. این گزینه فقط برای صفحه‌نمایش‌هایی کاربرد دارد که ۲۵۶ رنگ (یا کمتر) را با یک visual پویا (مانند PseudoColor، GrayScale یا DirectColor) نمایش می‌دهند. مقدار پیش‌فرض به کارگزار X شما و نحوه اجرای fvwm بستگی دارد. در بیشتر موارد این پیش‌فرض معقول است. گزینه \fB\-l\fP تنها در صورتی باید استفاده شود که با رنگ‌ها با مشکل مواجه شوید. به‌طور پیش‌فرض، fvwm تلاش می‌کند پالت‌های بزرگ از پیش تخصیص‌یافته را شناسایی کند. اگر چنین پالتی شناسایی شود fvwm از آن استفاده می‌کند و منطقاً نباید از \fB\-l\fP استفاده شود. علاوه بر این، در این حالت گزینه‌های \fB\-A\fP و \fB\-S\fP تحمیل می‌شوند. توجه داشته باشید که XFree\-4.2 تعداد ۲۴۴ رنگ را از پیش تخصیص می‌دهد (اگر از درایوری با پشتیبانی Render استفاده کنید) و تنها چند رنگ آزاد باقی می‌گذارد. این ممکن است منجر به بروز برخی مشکلات رنگی شود (و کاری نمی‌توان کرد). XFree\-4.3 یا نسخه‌های بالاتر تنها ۸۵ رنگ را از پیش تخصیص می‌دهند. اگر هیچ پالت از پیش تخصیص‌یافته‌ای به طور خودکار شناسایی نشود، مقادیر پیش‌فرض به شرح زیر خواهند بود: .sp عمق رنگ صفحه نمایش ۸ (۲۵۶ رنگ) .sp .if n .RS 4 .nf .fam C PseudoColor: 68 (4x4x4 color cube + 4 grey) GrayScale: 64 regular grey DirectColor: 32 (3x3x3 color cube + 5 grey) .fam .fi .if n .RE .sp عمق رنگ صفحه نمایش ۴ (۱۶ رنگ) .sp .if n .RS 4 .nf .fam C PseudoColor: 10 (2x2x2 color cube + 2 grey) GrayScale: 8 regular grey DirectColor: 10 (2x2x2 color cube + 2 grey) .fam .fi .if n .RE .sp توجه داشته باشید که اگر از یک نقشه رنگ اختصاصی استفاده کنید (یعنی fvwm با گزینه‌های \fB\-C\fP یا \fB\-I\fP راه‌اندازی شده باشد)، از مقادیر پیش‌فرض دیگری استفاده خواهد شد. .sp اکنون اگر با رنگ‌ها با مشکل مواجه شدید چه باید کرد؟ نخستین کار این است که بررسی کنید آیا واقعاً نمی‌توانید کارگزار X خود را با عمق رنگ ۱۵، ۱۶ یا بهتر اجرا کنید یا خیر. مستندات کارگزار X خود را بررسی کنید. توجه داشته باشید که برخی سخت‌افزارها می‌توانند از دو عمق رنگ مختلف روی یک صفحه نمایش پشتیبانی کنند (معمولاً عمق ۸ و عمق ۲۴). اگر عمق ۸ پیش‌فرض است، می‌توانید با استفاده از گزینه \fB\-C\fP با آرگومان \fITrueColor\fP، برنامه fvwm را وادار به استفاده از بهترین عمق کنید. بنابراین اکنون فرض می‌کنیم شما مجبورید در عمق ۸ با یک visual پویا کار کنید چون سخت‌افزار/درایور شما نمی‌تواند بهتر عمل کند یا به این دلیل که نیاز به استفاده از برنامه‌ای دارید که باید در این حالت اجرا شود (برای مثال، چون این برنامه به رنگ‌های خواندنی\-نوشتنی نیاز دارد). آنچه باید درک شود این است که شما فقط ۲۵۶ رنگ در اختیار دارید و تمام برنامه‌هایی که از نقشه رنگ پیش‌فرض استفاده می‌کنند باید این رنگ‌ها را به اشتراک بگذارند. مشکل اصلی این است که برنامه‌هایی وجود دارند که از رنگ‌های زیاد یا حتی تمام رنگ‌ها استفاده می‌کنند. اگر از چنین برنامه‌ای استفاده کنید، ممکن است دیگر رنگ آزادی نداشته باشید و برخی برنامه‌ها (که فقط از چند رنگ استفاده می‌کردند) ممکن است در راه‌اندازی شکست بخورند یا غیرقابل استفاده شوند. سه کار می‌توان انجام داد (و fvwm واقعاً نقش خاصی ایفا نمی‌کند، بلکه همه برنامه‌ها درگیر هستند). نخستین کار این است که برنامه‌هایی را که نقشه رنگ (پیش‌فرض) شما را هدر می‌دهند با یک نقشه رنگ اختصاصی اجرا کنید. برای مثال، netscape را با گزینه \-install اجرا کنید، برنامه‌های KDE یا QT را با گزینه \-\-cmap اجرا کنید، یا از گزینه \fB\-C\fP برای fvwm استفاده کنید. عیب این روش این است که از نظر بصری ناخوشایند است (برای کنترل بهترِ تعویض نقشه‌های رنگ، دستور \fBColormapFocus\fP را ببینید). روش دوم محدود کردن تعداد رنگ‌هایی است که برنامه‌ها استفاده می‌کنند. مجدداً، برخی برنامه‌ها گزینه‌هایی برای تعیین یک سقف رنگ مشخص دارند. با fvwm می‌توانید مقادیر مختلفی را امتحان کنید: ۶۱ (یک پالت «بصری» ویژه)، ۵۶ (یک مکعب رنگی ۴x۴x۳ به اضافه ۶ رنگ خاکستری)، ۲۹ (یک مکعب رنگی ۳x۳x۳ به اضافه ۲ رنگ خاکستری)، ۱۰ یا ۹. همچنین، می‌توانید از گزینه \fB\-L\fP استفاده کنید. با این حال، محدود کردن تعداد رنگ‌ها راه‌حل قطعی نیست. راه‌حل نهایی این است که سعی کنید کاری کنید برنامه‌هایی که از رنگ‌های زیادی استفاده می‌کنند، همگی از رنگ‌های یکسانی استفاده کنند. این یک کار دشوار است چرا که استانداردهای رسمی برای این هدف وجود ندارد. با این حال، برخی جعبه‌ابزارها مانند QT و GTK از مکعب‌های رنگی به عنوان پالت استفاده می‌کنند. بنابراین، ایده این است که برنامه‌ها/جعبه‌ابزارهای خود را طوری پیکربندی کنید که همگی از یک مکعب رنگی یکسان استفاده کنند. علاوه بر این، می‌توانید از رنگ‌های موجود در این مکعب رنگی در فایل‌های پیکربندی منابع X خود و/یا به عنوان آرگومان برای گزینه‌های رنگ استفاده کنید. برنامه Fvwm می‌تواند از هر مکعب رنگی به فرم RxGxB با ۲ <= R <= ۶، R = G، R\-1 =< B <= R و B >= ۲ استفاده کند. برای به‌دست آوردن یک مکعب رنگی RxGxB، به عنوان آرگومان به \fB\-l\fP یک عدد صحیح c بدهید به طوری که c >= R*G*B و در صورتی که B=R باشد c < (R+1)\fB(G+1)*B و در صورتی که B < R باشد c < R*G\fP(B+1) باشد (و متمایز از ۶۱). اگر c > R*G*B باشد، ممکن است مقداری رنگ خاکستری به مکعب رنگی افزوده شود. می‌توانید از دستور \fBPrintInfo\fP \fIColors\fP [\fI1\fP] برای دریافت اطلاعات درباره تنظیمات رنگ fvwm خود استفاده کنید. به‌ویژه، این دستور پالت استفاده‌شده توسط fvwm را در قالب rgb چاپ می‌کند (آخرین عدد صحیح تعداد دفعاتی را نشان می‌دهد که fvwm آن رنگ‌ها را تخصیص داده است). .RE .sp \fB\-L\fP | \fB\-\-strict\-color\-limit\fP .RS 4 اگر صفحه نمایش ۲۵۶ رنگ (یا کمتر) را نمایش می‌دهد و دارای visual پویا است، باعث می‌شود fvwm از پالت خود برای تمامی رنگ‌ها استفاده کند. به‌طور پیش‌فرض، پالت فقط برای تصاویر و گرادیان‌ها استفاده می‌شود. .RE .sp \fB\-P\fP | \fB\-\-visual\-palette\fP .RS 4 اگر صفحه نمایش ۲۵۶ رنگ (یا کمتر) را نمایش می‌دهد و دارای visual پویا است، این گزینه باعث می‌شود fvwm از پالتی استفاده کند که برای محدود کردن فاصله رنگ «بصری» میان نقاط پالت طراحی شده است. علاوه بر این، برای اشتراک‌گذاری بهتر رنگ‌ها، در صورت امکان از رنگ‌هایی با نام در پایگاه داده rgb مربوط به X برای تعریف رنگ‌ها استفاده می‌شود (به این امید که برنامه‌ها و تصاویر، ترجیح دهند از رنگ‌های دارای نام استفاده کنند). اگر از گزینه \fB\-l\fP استفاده نشود، این پالت دارای ۶۱ رنگ است. همچنین اگر عدد ۶۱ یا ۹ به عنوان آرگومان به گزینه \fB\-l\fP داده شود، این پالت به‌طور خودکار انتخاب می‌شود. .RE .sp \fB\-A\fP | \fB\-\-allocate\-palette\fP .RS 4 اگر صفحه نمایش ۲۵۶ رنگ (یا کمتر) را نمایش می‌دهد و دارای visual پویا است، این گزینه باعث می‌شود fvwm تمام رنگ‌های پالت خود را هنگام راه‌اندازی برای رزرو این رنگ‌ها جهت استفاده در آینده تخصیص دهد. این گزینه، گزینه \fB\-static\-palette\fP را تحمیل می‌کند. به‌طور پیش‌فرض، fvwm یک رنگ را در پالت خود تنها در صورتی تخصیص می‌دهد (رزرو می‌کند) که به آن رنگ نیاز داشته باشد. .RE .sp \fB\-S\fP | \fB\-\-static\-palette\fP .RS 4 اگر صفحه نمایش ۲۵۶ رنگ (یا کمتر) را نمایش می‌دهد و دارای visual پویا است، این گزینه باعث می‌شود fvwm هرگز رنگ‌های پالت خود را آزاد نکند. به‌طور پیش‌فرض، هنگامی که fvwm دیگر به رنگی نیاز ندارد، آن رنگ را آزاد می‌کند تا بتوان از رنگ جدیدی استفاده کرد. این گزینه ممکن است بارگذاری تصاویر را سرعت بخشد و چند بیت در حافظه صرفه‌جویی کند. .RE .sp \fB\-\-debug\-stack\-ring\fP .RS 4 اشکال‌زدایی حلقه پشته (stack ring) را فعال می‌کند. این گزینه صرفاً برای اشکال‌زدایی داخلی در نظر گرفته شده و فقط باید توسط توسعه‌دهندگان استفاده شود. .RE .sp \fB\-v\fP | \fB\-\-verbose\fP .RS 4 ثبت گزارش‌های اشکال‌زدایی را فعال می‌کند. پیام‌ها در حالت الحاق (append mode) در فایل گزارش fvwm نوشته می‌شوند، که به صورت پیش‌فرض ~/.fvwm/fvwm3\-output.log است. بخش ENVIRONMENT را ببینید تا با نحوه بازتعریف این مکان در هنگام راه‌اندازی fvwm3 با استفاده از \fI$FVWM_USERDIR\fP یا \fI$FVWM3_LOGFILE\fP آشنا شوید. .sp همچنین ثبت گزارش می‌تواند با استفاده از سیگنال‌ها به صورت پویا روشن و خاموش شود: .sp .if n .RS 4 .nf .fam C SIGUSR1 : used as a signal to restart Fvwm SIGUSR2 : used as a signal to toggle opening/closing debug log file .fam .fi .if n .RE .RE.SH "کالبدشناسی پنجره (ANATOMY OF A WINDOW)" .sp Fvwm یک حاشیه تزئینی در اطراف بیشتر پنجره‌ها قرار می‌دهد. این حاشیه شامل یک نوار در هر طرف و یک بخش کوچک L\-شکل در هر گوشه است. یک نوار بالایی اضافی نیز به نام title\-bar وجود دارد که برای نمایش نام پنجره به کار می‌رود. علاوه بر این، حداکثر تا ۱۰ دکمه در title\-bar می‌توانند وجود داشته باشند. نوارهای بالایی، کناری و پایینی در مجموع به عنوان side\-bars شناخته می‌شوند. قطعات گوشه، frame نامیده می‌شوند. .sp با پیکربندی کمینهٔ توکار، کشیدن کلید ۱ ماوس روی frame یا side\-bars عملیات تغییر اندازهٔ پنجره را آغاز می‌کند. کشیدن کلید ۲ ماوس روی frame یا side\-bars عملیات جابه‌جایی را آغاز می‌کند. عملیات بالا آوردن/پایین بردن (raise/lower) به یک بار کلیک روی حاشیه‌ها مقید شده است. همین وضعیت برای عنوان پنجره نیز برقرار است. .sp حداکثر تا ده دکمهٔ title\-bar می‌تواند وجود داشته باشد. کاربرد آن‌ها کاملاً توسط کاربر قابل تعریف است. یک پیکربندی پرطرفدار از یک دکمه در سمت چپ برای باز کردن فهرستی از گزینه‌های پنجره و دو دکمه در سمت راست برای نمادین کردن (iconify) و بیشینه‌سازی (maximize) پنجره استفاده می‌کند. یک پیکربندی محبوب دیگر یک دکمهٔ بستن (close) را به سمت راست اضافه می‌کند. تعداد دکمه‌های title\-bar مورد استفاده به این بستگی دارد که برای کدام‌یک از آن‌ها کنش‌های ماوس مقید شده باشد. دستور \fBMouse\fP را ببینید. .SH "میزکار مجازی (THE VIRTUAL DESKTOP)" .sp Fvwm برای کاربرانی که مایل به استفاده از میزکارهای مجازی هستند، چندین میزکار مجازی فراهم می‌کند. صفحه‌نمایش یک درگاه دید (viewport) بر روی یک \fIdesktop\fP است که ممکن است بزرگ‌تر از صفحه‌نمایش باشد. به چندین میزکار متمایز می‌توان دسترسی داشت (مفهوم: یک میزکار برای هر پروژه، یا یک میزکار برای هر برنامه، هنگامی که دید برنامه‌ها مجزا است). از آنجا که هر میزکار می‌تواند بزرگ‌تر از صفحه‌نمایش فیزیکی باشد، و به m در n \fIصفحه (pages)\fP تقسیم شود که هر یک به اندازه صفحه‌نمایش فیزیکی هستند، پنجره‌هایی که بزرگ‌تر از صفحه‌نمایش هستند یا گروه‌های بزرگی از پنجره‌های مرتبط را می‌توان به‌سادگی مشاهده کرد. .sp اندازه (m در n) (یعنی تعداد صفحه‌ها) میزکارهای مجازی را می‌توان در هر زمان با استفاده از دستور \fBDesktopSize\fP تغییر داد. تمام میزکارهای مجازی باید دارای اندازه یکسان باشند (هستند). نیازی به تعیین تعداد کل میزکارهای مجزا نیست، اما در کل به حدود ۴ میلیارد محدود شده است. همهٔ پنجره‌ها در محدوده‌ای از میزکارها را می‌توان در \fBFvwmPager\fP، نمای مینیاتوری از میزکارها، مشاهده کرد. ابزار pager یک برنامهٔ جانبی است که ماژول نامیده می‌شود و برای کارکرد مدیر پنجره ضروری نیست. همچنین پنجره‌ها را می‌توان با استفاده از دستور \fBWindowList\fP یا ماژول \fBFvwmIconMan\fP فهرست کرد. .sp Fvwm پنجره‌های روی میزکار را در یک چیدمان پشته‌ای لایه‌بندی‌شده نگه می‌دارد؛ پنجره‌ای در لایهٔ پایین‌تر هرگز پنجره‌ای در لایهٔ بالاتر را نمی‌پوشاند. لایهٔ یک پنجره را می‌توان با استفاده از دستور \fBLayer\fP تغییر داد. مفهوم لایه‌ها تعمیمی از پرچم \fIStaysOnTop\fP در نسخه‌های قدیمی‌تر fvwm است. گزینه‌های \fBStyle\fP به نام‌های \fIStaysOnTop\fP و \fIStaysPut\fP اکنون با قرار دادن پنجره‌ها در لایه‌های مناسب پیاده‌سازی شده‌اند و گزینهٔ \fBStyle\fP که پیش‌تر وجود نداشت، یعنی \fIStaysOnBottom\fP، اضافه شده است. .sp پنجره‌های \fISticky\fP پنجره‌هایی هستند که با «چسبیدن به شیشهٔ صفحه‌نمایش» از میزکار مجازی فراتر می‌روند. آن‌ها همیشه روی صفحه ثابت باقی می‌مانند. این ویژگی برای مواردی مانند ساعت‌ها و xbiffها بسیار راحت است، بنابراین تنها کافی است یک ابزارک از این دست را اجرا کنید و همیشه همراه شما خواهد ماند. در صورت تمایل می‌توان آیکون‌ها را نیز به شیشه چسباند. .sp مختصات و ابعاد پنجره (geometries) نسبت به درگاه دید (viewport) کنونی تعیین می‌شوند. بدین معنی که: .sp .if n .RS 4 .nf .fam C xterm \-geometry +0+0 .fam .fi .if n .RE .sp پنجره‌ای را در گوشهٔ بالا و چپ بخش قابل مشاهدهٔ صفحه‌نمایش ایجاد می‌کند. تعیین مختصاتی که پنجره‌ها را روی میزکار مجازی، اما خارج از صفحه‌نمایش قرار دهد مجاز است. برای نمونه، اگر صفحه‌نمایش قابل مشاهده ۱۰۰۰ در ۱۰۰۰ پیکسل باشد، و اندازه میزکار 3x3 باشد، و درگاه دید فعلی در گوشهٔ بالا و چپ میزکار قرار داشته باشد، اجرای: .sp .if n .RS 4 .nf .fam C xterm \-geometry +1000+1000 .fam .fi .if n .RE .sp پنجره‌ای را دقیقاً بیرون از گوشهٔ پایین و راست صفحه‌نمایش قرار می‌دهد. این پنجره را می‌توان با بردن ماوس به گوشهٔ پایین و راست صفحه‌نمایش و منتظر ماندن برای پیمایش آن به داخل نما پیدا کرد. مختصاتی که به صورت زیر تعیین شود: .sp .if n .RS 4 .nf .fam C xterm \-geometry \-5\-5 .fam .fi .if n .RE .sp گوشهٔ پایین و راست پنجره را در فاصلهٔ ۵ پیکسلی از گوشهٔ پایین و راست بخش مرئی صفحه‌نمایش قرار می‌دهد. همه برنامه‌ها از مختصات پنجره با آفست‌های منفی پشتیبانی نمی‌کنند. برخی برنامه‌ها گوشهٔ بالا و راست پنجره را ۵ پیکسل بالاتر و به سمت چپِ گوشهٔ بالا و چپ صفحه‌نمایش قرار می‌دهند؛ دیگر برنامه‌ها ممکن است رفتارهای کاملاً عجیبی نشان دهند. .sp یک افزونهٔ ویژهٔ fvwm برای رشته‌های مختصات (geometry) وجود دارد که می‌تواند تعیین مختصات را نسبت به صفحه‌نمایش داده‌شده نیز اعمال کند. برای نمونه: .sp .if n .RS 4 .nf .fam C xterm \-geometry +0+0@n .fam .fi .if n .RE .sp که در آن \*(Aqn\*(Aq می‌تواند نام یک مانیتور RandR یا شماره مانیتور تخصیص‌یافته باشد. برای جزئیات بیشتر، بخش RANDR SUPPORT را ببینید. .sp راه‌های مختلفی وجود دارد تا پنجره‌ای روی میزکار یا صفحه‌ای غیر از میزکار یا صفحهٔ فعال فعلی نگاشت (map) شود. با این حال، روش مختصات که در بالا ذکر شد (تعیین مختصات x,y بزرگ‌تر از اندازه صفحه‌نمایش فیزیکی)، از این محدودیت رنج می‌برد که نسبت به درگاه دید فعلی تفسیر می‌شود: پنجره ممکن است به‌طور پایدار روی یک صفحهٔ خاص ظاهر نشود، مگر اینکه همیشه برنامه را از همان صفحه فراخوانی کنید. .sp روش بهتر برای قرار دادن پنجره‌ها روی یک صفحه، صفحه‌نمایش یا میزکار (desk) متفاوت از درگاه دید نگاشت‌شدهٔ فعلی، استفاده از مشخصهٔ سبک \fIStartsOnPage\fP یا \fIStartsOnScreen\fP (جانشین‌های سبک قدیمی‌تر \fIStartsOnDesk\fP) در فایل \fIconfig\fP شما است. این جای‌گذاری پایدار است: به موقعیت فعلی شما روی میزکار مجازی وابسته نیست. .sp برخی از برنامه‌ها که آرگومان‌های خط فرمان استاندارد Xt و X resources را درک می‌کنند، مانند xterm و xfontsel، به کاربر اجازه می‌دهند میزکار (desk) یا صفحهٔ راه‌اندازی را در خط فرمان مشخص کند: .sp .if n .RS 4 .nf .fam C xterm \-xrm "*Desk:1" .fam .fi .if n .RE .sp یک xterm را در میزکار شماره ۱ اجرا می‌کند؛ .sp .if n .RS 4 .nf .fam C xterm \-xrm "*Page:3 2 1" .fam .fi .if n .RE .sp یک xterm را در دو صفحه به سمت راست و یک صفحه به سمت پایین از صفحهٔ بالا و چپ میزکار شماره ۳ اجرا می‌کند. با این حال، همهٔ برنامه‌ها کاربرد این گزینه‌ها را درک نمی‌کنند. می‌توانید با خطوط زیر در فایل \fI.Xdefaults\fP خود به همان نتایج دست یابید: .sp .if n .RS 4 .nf .fam C XTerm*Desk: 1 .fam .fi .if n .RE .sp یا .sp .if n .RS 4 .nf .fam C XTerm*Page: 3 2 1 .fam .fi .if n .RE.SH "پشتیبانی از چندنمایشگر RANDR (RANDR MULTI\-SCREEN SUPPORT)" .sp برنامه Fvwm با استفاده از پروتکل RandR سامانه X11، به بهترین نحو از چندین نمایشگر پشتیبانی می‌کند. اگر fvwm بدون پشتیبانی از پروتکل RandR کامپایل شده باشد، پشتیبانی از چند نمایشگر بسیار محدود خواهد بود و پیشنهاد می‌شود برنامه را مجدداً با RandR بازسازی (rebuild) کنید. همچنین توصیه می‌شود در نمایشگرهای چندگانه از \*(AqEdgeScroll 0 0\*(Aq استفاده کنید تا هنگام حرکت نشانگر موشواره بین نمایشگرها از تعویض صفحات جلوگیری شود. .sp اگر Fvwm با پشتیبانی از RandR کامپایل شده باشد، خروجی‌هایی (نمایشگرهایی) را که می‌یابد ردگیری می‌کند. این خروجی‌ها با نام ذخیره می‌شوند که می‌توان نام آن‌ها را با اجرای دستور xrandr(1) یافت. .sp هنگامی که Fvwm نمایشگرها را شناسایی می‌کند، آن‌ها را با ترتیبی مشخص به یک ساختار درختی اضافه کرده و به هر نمایشگر یک شماره اختصاص می‌دهد. این ترتیب از بالا به پایین و از چپ به راست است؛ به عنوان مثال، نمودار زیر چینش چند نمایشگر و شماره‌های اختصاص‌یافته به آن‌ها را نشان می‌دهد. .sp .if n .RS 4 .nf .fam C A (0) B (1)\& C (2)\& D (3) .fam .fi .if n .RE .sp بنابراین می‌توان به نمایشگر دوم ارجاع داد و نام آن را از طریق متغیرهای بسط به صورت زیر چاپ کرد: .sp .if n .RS 4 .nf .fam C $[monitor.1.name] .fam .fi .if n .RE .sp که نام \fBB\fP را چاپ خواهد کرد. .sp با این اقدام، Fvwm رویدادهای ارسالی از RandR را ردگیری می‌کند؛ مانند زمانی که اندازه یک خروجی مشخص تغییر می‌کند، یا خروجی جدیدی افزوده یا برداشته می‌شود. .sp این موارد توسط \fBFvwmEvent\fP کنترل می‌شوند. .SH "رفتار میزکار (DESKTOP BEHAVIOUR)" .sp از آنجا که Fvwm قابلیت ردگیری خروجی‌ها را دارد، می‌توان نحوه مدیریت آن‌ها را به Fvwm اعلام کرد. این سازوکار از طریق دستور \fBDesktopConfiguration\fP کنترل می‌شود. به‌طور پیش‌فرض، Fvwm تمام خروجی‌های یافت‌شده را به عنوان یک صفحهٔ بزرگ در نظر می‌گیرد، اگرچه می‌توان به Fvwm دستور داد که با هر نمایشگر مستقل از دیگری رفتار کند. .SH "راه‌اندازی اولیه (INITIALIZATION)" .sp در حین راه‌اندازی اولیه، fvwm به دنبال یک فایل پیکربندی می‌گردد که تعریف کلیدها، دکمه‌های موشواره و بسیاری از موارد دیگر را شامل می‌شود. قالب این فایل‌ها در ادامه شرح داده شده است. Fvwm ابتدا با استفاده از دستور زیر به دنبال فایل‌های پیکربندی می‌گردد: .sp .if n .RS 4 .nf .fam C Read config .fam .fi .if n .RE .sp این دستور همان‌گونه که در \fBRead\fP شرح داده شده، به دنبال فایل \fIconfig\fP در دایرکتوری‌های \fI$FVWM_USERDIR\fP و \fI$FVWM_DATADIR\fP می‌گردد. در صورت عدم موفقیت، برای حفظ سازگاری با نسخه‌های قدیمی‌تر، فایل‌های بیشتری مورد بررسی قرار می‌گیرند. فهرست کامل تمام مسیرهای فایلی که در نصب پیش‌فرض بررسی می‌شوند به شرح زیر است (تنها از نخستین فایل یافت‌شده استفاده خواهد شد): .sp .if n .RS 4 .nf .fam C $HOME/.fvwm/config /usr/local/share/fvwm/config $HOME/.fvwm/.fvwm2rc $HOME/.fvwm2rc /usr/local/share/fvwm/.fvwm2rc /usr/local/share/fvwm/system.fvwm2rc /etc/system.fvwm2rc .fam .fi .if n .RE .sp لطفاً توجه داشته باشید، تضمینی نیست که از ۵ مسیر آخر در آینده نیز پشتیبانی شود. .sp اگر هیچ فایل پیکربندی‌ای یافت نشود، دکمه سمت چپ موشواره، یا .sp یا .sp کلیدهای روی پنجره ریشه (root window)، منوها و فرم‌هایی را باز می‌کنند که امکان ایجاد یک فایل پیکربندی ابتدایی را فراهم می‌سازند. .sp برنامه Fvwm دو متغیر محیطی تنظیم می‌کند که توسط فرآیندهای فرزند آن به ارث برده می‌شوند. این متغیرها عبارتند از \fI$DISPLAY\fP که نمایشگری را که fvwm روی آن در حال اجراست توصیف می‌کند. مقدار \fI$DISPLAY\fP ممکن است \fIunix:0.0\fP یا \fI:0.0\fP باشد که در صورت هدایت از طریق ssh به دستگاهی دیگر عملکرد چندان خوبی نخواهد داشت، بنابراین \fI$HOSTDISPLAY\fP روی یک توصیف آمادهٔ شبکه از نمایشگر تنظیم می‌شود. \fI$HOSTDISPLAY\fP همیشه از پروتکل انتقال TCP/IP (حتی برای اتصالات محلی) استفاده می‌کند؛ از این رو برای اتصالات محلی بهتر است از \fI$DISPLAY\fP استفاده شود، زیرا می‌تواند از سوکت‌های دامنه یونیکس (Unix-domain sockets) بهره ببرد که سریع‌تر هستند. .sp اگر تمایل دارید برخی برنامه‌ها یا ماژول‌ها همزمان با fvwm اجرا شوند، می‌توانید به سادگی خطوط زیر را .sp .if n .RS 4 .nf .fam C Exec app .fam .fi .if n .RE .sp یا .sp .if n .RS 4 .nf .fam C Module FvwmXxx .fam .fi .if n .RE .sp در فایل \fIconfig\fP خود قرار دهید؛ اما این کار توصیه نمی‌شود و تنها در صورتی باید انجام شود که کاملاً از عملکرد آن آگاه باشید. معمولاً آغاز به کار برنامه‌ها یا ماژول‌ها پس از خوانده شدن کامل فایل پیکربندی اهمیت دارد، زیرا این فایل دربردارنده سبک‌ها یا تنظیماتی است که می‌توانند بر ظاهر و عملکرد پنجره‌ها تأثیر بگذارند. .sp روش استاندارد برای اجرای برنامه‌ها یا ماژول‌ها در هنگام راه‌اندازی fvwm، اضافه کردن آن‌ها به یک تابع راه‌اندازی اولیه است (معمولاً \fBStartFunction\fP یا \fBInitFunction\fP). بدین ترتیب، آن‌ها تنها پس از اتمام فرایند خواندن و اجرای فایل \fIconfig\fP توسط fvwm راه‌اندازی خواهند شد. .sp برنامه Fvwm دارای سه تابع ویژه برای راه‌اندازی اولیه است: \fBStartFunction\fP، که هنگام آغاز به کار و راه‌اندازی‌های مجدد (restart) اجرا می‌شود؛ و توابع \fBInitFunction\fP و \fBRestartFunction\fP، که به ترتیب در حین راه‌اندازی اولیه و راه‌اندازی مجدد، درست پس از StartFunction فراخوانی می‌شوند. این توابع را می‌توان در فایل \fIconfig\fP کاربر و با استفاده از دستور \fBAddToFunc\fP (که در ادامه شرح داده شده) سفارشی کرد تا ماژول‌ها، xtermها، یا هر برنامه‌ای که می‌خواهید توسط fvwm شروع شود به اجرا درآیند. .sp همچنین Fvwm دارای یک تابع خروج ویژه است: \fBExitFunction\fP، که پیش از بسته شدن نهایی، در زمان خروج یا راه‌اندازی مجدد اجرا می‌شود. از این تابع می‌توان برای متوقف کردن صریح ماژول‌ها و موارد دیگر استفاده کرد. .sp اگر fvwm تحت یک مدیر نشست (session manager) اجرا شود، توابع \fBSessionInitFunction\fP و \fBSessionRestartFunction\fP به جای InitFunction و RestartFunction فراخوانی می‌شوند. این امر کمک می‌کند تا فایل \fIconfig\fP کاربر به نحوی تنظیم شود که هم برای اجرا تحت یک مدیر نشست و هم بدون آن مناسب باشد. به‌طور کلی اجرای xtermها یا سایر برنامه‌ها در توابع "*Session" ایده مناسبی نیست. همچنین کاربر می‌تواند تصمیم بگیرد که در صورت اجرا تحت مدیر نشست یا عدم اجرای آن، ماژول‌های متفاوتی را راه‌اندازی کند. برای اهداف مشابه، تابع \fBSessionExitFunction\fP به جای ExitFunction مورد استفاده قرار می‌گیرد. .sp .if n .RS 4 .nf .fam C DestroyFunc StartFunction AddToFunc StartFunction + I Module FvwmPager * * + I Module FvwmButtons DestroyFunc InitFunction AddToFunc InitFunction + I Module FvwmBanner + I Module FvwmIconMan + I Exec xsetroot \-solid cyan + I Exec xterm + I Exec netscape DestroyFunc RestartFunction AddToFunc RestartFunction + I Module FvwmIconMan DestroyFunc SessionInitFunction AddToFunc SessionInitFunction + I Module FvwmBanner DestroyFunc SessionRestartFunction AddToFunc SessionRestartFunction + I Nop .fam .fi .if n .RE .sp اگر نیازی به تعریف برخی از توابع خاص نباشد و خالی بمانند، الزامی به تعریف آن‌ها نیست. همچنین دقت داشته باشید که اکنون می‌توان تمام این توابع ویژه را با استفاده از \fBStartFunction\fP و \fBExitFunction\fP به این صورت شبیه‌سازی کرد: .sp .if n .RS 4 .nf .fam C DestroyFunc StartFunction AddToFunc StartFunction + I Test (Init) Module FvwmBanner + I Module FvwmPager * * + I Test (Restart) Beep DestroyFunc ExitFunction AddToFunc ExitFunction + I Test (Quit) Echo Bye\-bye + I KillModule MyBuggyModule + I Test (ToRestart) Beep .fam .fi .if n .RE.SH "گزینه‌های زمان کامپایل (COMPILATION OPTIONS)" .sp برنامه Fvwm دارای تعدادی گزینه زمان کامپایل است. اگر در استفاده از دستور یا قابلیتی خاص با مشکل مواجه شدید، بررسی کنید که آیا پشتیبانی از آن در زمان کامپایل گنجانده شده است یا خیر. قابلیت‌های اختیاری در فایل \fIconfig.h\fP که هنگام کامپایل تولید می‌شود شرح داده شده‌اند. .SH "آیکون‌ها و تصاویر (ICONS AND IMAGES)" .sp برنامه Fvwm می‌تواند تصاویر \fB.xbm،\fP \fB.xpm،\fP \fB.png\fP و \fB.svg\fP را بارگذاری کند. تصاویر \fBXBM\fP تک‌رنگ (سیاه و سفید) هستند. Fvwm همیشه می‌تواند فایل‌های \fBXBM\fP را نمایش دهد. قالب‌های \fBXPM\fP و \fBPNG\fP تصاویر رنگی هستند. SVG یک فرمت گرافیک برداری است. گزینه‌های زمان کامپایل تعیین می‌کنند که آیا fvwm می‌تواند آیکون‌ها و تصاویر \fBXPM\fP، \fBPNG\fP یا \fBSVG\fP را نمایش دهد یا خیر. برای اطلاعات بیشتر فایل \fIINSTALL.fvwm\fP را ببینید. .sp گزینه مرتبط زمان کامپایل \fBSHAPE\fP می‌تواند کاری کند که fvwm آیکون‌های شکل‌دار شکیل و زیبایی را نمایش دهد. .SS "گزینه‌های رندر SVG (SVG rendering options)" .sp تصاویر SVG از فایل‌های متنی (XML) تولید می‌شوند. یک فایل SVG واقعاً ساده ممکن است چیزی شبیه به این باشد: .sp .if n .RS 4 .nf .fam C .fam .fi .if n .RE .sp به‌طور پیش‌فرض، تصاویر SVG به همان شکلی رندر می‌شوند که سازنده تصویر مد نظر داشته است. اما از آنجا که SVG یک قالب گرافیک برداری است، تصاویر را می‌توان در هر اندازه و چرخش دلخواهی رندر کرد؛ به عنوان مثال این امکان فراهم می‌شود که از یک فایل آیکون یکسان، با رندر در اندازه‌های متفاوت، برای سبک‌های \fIIcon\fP و \fIMiniIcon\fP استفاده شود. .sp گزینه‌های رندر به عنوان یک رشته که به انتهای نام فایل SVG پیوست می‌شود، به شرح زیر مشخص می‌گردند: .sp .if n .RS 4 .nf .fam C _image.svg_:[!] [(1) _size_] [(2) _position_] [(3) _rotation_] [(4) _scale_] ... {empty}(1) [\-]_width_{x}[\-]_height_ {empty}(2) {\- | +}_xpos_{\- | +}_ypos_ {empty}(3) @[\-]_angle_ {empty}(4) {* | }[\-]_factor_[x | y] .fam .fi .if n .RE .sp رشته گزینه همواره با یک دونقطه (\*(Aq:\*(Aq) آغاز می‌شود تا از نام فایل جدا گردد. یک رشته گزینه خالی می‌تواند این دونقطه را نادیده بگیرد، اما در صورتی که نام فایل شامل دونقطه باشد، همچنان بهتر است برای جلوگیری از ابهام آن را درج کنید. .sp .if n .RS 4 .nf .fam C filename_without_colon.svg filename:with:colon.svg: .fam .fi .if n .RE .sp علامت تعجب (\*(Aq!\*(Aq) کل تصویر نهایی (شامل ناحیه رندر) را ترانهاده (transpose) می‌کند؛ یعنی تمام مختصات‌های افقی و تمام مختصات‌های عمودی با یکدیگر جابه‌جا می‌شوند. .sp .if n .RS 4 .nf .fam C image.svg:! .fam .fi .if n .RE .sp مقادیر \fIwidth\fP و \fIheight\fP ابعاد ناحیه رندر را بر حسب پیکسل مشخص می‌کنند، یعنی ابعاد تصویر حاصل. تصویر واقعی طوری تنظیم می‌شود که کل ناحیه رندر را پر کند. .sp .if n .RS 4 .nf .fam C image.svg:60x60 .fam .fi .if n .RE .sp برای حفظ نسبت ابعاد (aspect ratio)، مقدار \fIwidth\fP یا \fIheight\fP را برابر با 0 قرار دهید. .sp .if n .RS 4 .nf .fam C image.svg:0x60 image.svg:60x0 .fam .fi .if n .RE .sp یک \*(Aq\-\*(Aq قبل از \fIwidth\fP، ناحیه رندر را به صورت افقی آینه‌ای (معکوس) می‌کند. .sp .if n .RS 4 .nf .fam C image.svg:\-0x0 .fam .fi .if n .RE .sp یک \*(Aq\-\*(Aq قبل از \fIheight\fP، ناحیه رندر را به صورت عمودی آینه‌ای (معکوس) می‌کند. .sp .if n .RS 4 .nf .fam C image.svg:0x\-0 .fam .fi .if n .RE .sp مقادیر \fIxpos\fP و \fIypos\fP جابه‌جایی (انتقال) تصویر را بر حسب پیکسل مشخص می‌کنند. مقدار مثبت \fIxpos\fP تصویر را به سمت راست حرکت می‌دهد. مقدار مثبت \fIypos\fP آن را به سمت پایین می‌برد. حرکت دادن بخشی از آن به خارج از ناحیه رندر منجر به بریده شدن (crop) تصویر می‌شود. .sp .if n .RS 4 .nf .fam C image.svg:\-30\-0 image.svg:\-0+10 image.svg:\-30+10 .fam .fi .if n .RE .sp مقدار \fIangle\fP یک چرخش حول مرکز تصویر واقعی را بر حسب درجه مشخص می‌کند. این کار ممکن است منجر به بریده شدن تصویر شود. مقدار مثبت، تصویر را در جهت عقربه‌های ساعت می‌چرخاند. مقادیر ممیز شناور پشتیبانی می‌شوند. .sp .if n .RS 4 .nf .fam C image.svg:@180 image.svg:@\-90 image.svg:@30 image.svg:@57.3 .fam .fi .if n .RE .sp مقدار \fIfactor\fP مقیاس‌بندی تصویر واقعی را مشخص می‌کند (نه ناحیه رندر). بزرگ‌نمایی تصویر منجر به بریده شدن آن می‌شود. مقادیر ممیز شناور شناسایی و پذیرفته می‌شوند. تقسیم بر صفر نادیده گرفته می‌شود. اگر بلافاصله پس از \fIfactor\fP یک \*(Aqx\*(Aq یا یک \*(Aqy\*(Aq بیاید، مقیاس‌بندی به ترتیب به صورت افقی یا عمودی خواهد بود. در غیر این صورت، مقیاس‌بندی یکنواخت است. .sp .if n .RS 4 .nf .fam C image.svg:*2 image.svg:/2 image.svg:/3x image.svg:/2y .fam .fi .if n .RE .sp کوچک‌نمایی تصویری که جابه‌جا شده یا چرخیده است، می‌تواند از بریده شدن آن جلوگیری کند. .sp .if n .RS 4 .nf .fam C image.svg:@30*0.6 .fam .fi .if n .RE .sp استفاده مکرر از جابه‌جایی، چرخش و مقیاس‌بندی مجاز است. جابه‌جایی و چرخش جمع‌پذیر هستند. مقیاس‌بندی ضرب‌پذیر است. .sp .if n .RS 4 .nf .fam C image.svg:*2/3 image.svg:/3x/2y .fam .fi .if n .RE .sp هنگام ترکیب تبدیلات آفین (affine transformations)، مقیاس‌بندی همیشه ابتدا انجام می‌شود، سپس چرخش و در نهایت جابه‌جایی. .sp .if n .RS 4 .nf .fam C image.svg:\-30+10@30/3x/2y .fam .fi .if n .RE .sp برای آینه‌ای/معکوس کردن تصویر واقعی، از یک \fIfactor\fP مقیاس منفی استفاده کنید. .sp .if n .RS 4 .nf .fam C image.svg:\-30+10@30/\-3x/2y .fam .fi .if n .RE .sp آینه‌ای کردن ناحیه رندر پس از هرگونه مقیاس‌بندی، چرخش یا جابه‌جایی تصویر انجام می‌شود. .sp .if n .RS 4 .nf .fam C image.svg:\-0x0\-30+10@30/3x/2y .fam .fi .if n .RE .sp ترانهادن در آخرین مرحله و پس از هر کار دیگری انجام می‌شود. .sp .if n .RS 4 .nf .fam C image.svg:!\-0x0\-30+10@30/3x/2y .fam .fi .if n .RE.SH "ماژول‌ها (MODULES)" .sp یک ماژول برنامه‌ای جداگانه است که به عنوان یک فرایند مستقل یونیکس (Unix) اجرا می‌شود اما دستورها را برای اجرا به fvwm ارسال می‌کند. کاربران می‌توانند ماژول‌های اختصاصی خود را بنویسند تا بدون حجیم‌کردن یا تأثیر منفی بر یکپارچگی خودِ fvwm، هرگونه دستکاری خاص یا نامتعارفی را انجام دهند. .sp ماژول‌ها باید توسط fvwm ایجاد (spawn) شوند تا بتواند دو لوله (pipe) را برای برقراری ارتباط میان fvwm و ماژول برپا کند. این لوله‌ها هنگام شروع ماژول از پیش باز هستند و توصیف‌کننده‌های فایل (file descriptors) لوله‌ها به عنوان آرگومان‌های خط فرمان در اختیار آن قرار می‌گیرند. .sp ماژول‌ها می‌توانند در هر زمان از نشست X با استفاده از دستور \fBModule\fP توسط fvwm فراخوانی شوند. ماژول‌ها می‌توانند در تمام طول نشست X فعال بمانند، یا یک وظیفه منفرد را به پایان رسانده و خارج شوند. اگر هنگام فرمان خروج به fvwm، ماژول همچنان فعال باشد، fvwm لوله‌های ارتباطی را می‌بندد و منتظر دریافت سیگنال SIGCHLD از ماژول می‌ماند، که نشان می‌دهد ماژول بسته‌شدن لوله را تشخیص داده و خارج شده است. در صورتی که ماژول‌ها موفق به تشخیص بسته‌شدن لوله نشوند، fvwm در هر صورت پس از حدود ۳۰ ثانیه خارج می‌شود. تعداد ماژول‌های در حال اجرای هم‌زمان با حداکثر تعداد فایل‌های باز هم‌زمان در سیستم‌عامل محدود می‌شود که معمولاً بین ۶۰ تا ۲۵۶ است. .sp ماژول‌ها صرفاً دستورها را به موتور دستورات fvwm مخابره می‌کنند. قالب‌بندی دستورها دقیقاً مانند پیوند کلیدهای ماوس در فایل پیکربندی \fIconfig\fP است. اطلاعات کمکی مشخصی نیز ارسال می‌شوند، مانند آنچه در ماژول نمونهٔ \fBFvwmButtons\fP دیده می‌شود. .sp لطفاً برای جزئیات بیشتر به بخش \fBModule Commands\fP مراجعه کنید. .SH "سازگاری با ICCCM (ICCCM COMPLIANCE)" .sp fvwm تلاش می‌کند با ICCCM 2.0 سازگار باشد. برای اطلاعات بیشتر .URL "http://tronche.com/gui/x/icccm" "" "" را بررسی کنید. علاوه بر این، ICCCM بیان می‌کند که برنامه‌ها باید قادر به دریافت هر کلید فشرده‌شده‌ای باشند، که این امر با رویکرد میانبرهای صفحه‌کلید استفاده‌شده در fvwm و اکثر دیگر مدیرهای پنجره همخوانی ندارد. به طور خاص، شما نمی‌توانید میانبرهای صفحه‌کلید یکسانی داشته باشید که هم‌زمان در fvwm اصلی شما و یک fvwm دیگر که درون Xnest (یک کارساز X تودرتو که در یک پنجره اجرا می‌شود) کار کنند. همین مشکل در مورد پیوندهای ماوس نیز وجود دارد. .sp ‏ICCCM مشخص می‌کند پنجره‌هایی که دارای ویژگی زیر هستند: .sp .if n .RS 4 .nf .fam C WM_HINTS(WM_HINTS): Client accepts input or input focus: False .fam .fi .if n .RE .sp نباید توسط مدیر پنجره، فوکوس ورودی صفحه‌کلید را دریافت کنند. با این حال، این پنجره‌ها خودشان می‌توانند فوکوس ورودی را به دست آورند. تعدادی از برنامه‌ها این ویژگی را تنظیم می‌کنند و با این وجود انتظار دارند که مدیر پنجره به آن‌ها فوکوس صفحه‌کلید را بدهد؛ بنابراین fvwm سبک پنجره‌ای به نام \fILenience\fP ارائه می‌دهد که به fvwm اجازه می‌دهد این قانون ICCCM را نادیده بگیرد. حتی با اعمال این سبک پنجره نیز تضمین نمی‌شود که برنامه فوکوس را بپذیرد. .sp تفاوت‌های میان ICCCM 1.1 و 2.0 شامل قابلیت جایگزینی و در دست گرفتن کنترل از یک مدیر پنجره سازگار با ICCCM 2.0 در حال اجرا است؛ بنابراین دستور .sp .if n .RS 4 .nf .fam C fvwm; vi ~/.fvwm/config; fvwm \-replace .fam .fi .if n .RE .sp مشابه دستور \fBRestart\fP عمل می‌کند. البته کاملاً یکسان نیست، چرا که اگر مدیر پنجره قبلی به عنوان آخرین کلاینت در فایل \fI.Xclients\fP یا \fI.Xsession\fP شما اجرا شده باشد، بستن آن ممکن است نشست X شما را خاتمه دهد. .sp قابلیت‌های افزوده‌شدهٔ دیگر عبارتند از پشتیبانی از نصب جدول رنگ (colormap) در سمت کلاینت (برای جزئیات به ICCCM مراجعه کنید) و نشانهٔ فوریت (urgency hint). کلاینت‌ها می‌توانند این نشانه را در ویژگی WM_HINTS پنجره‌شان تنظیم کنند و انتظار داشته باشند مدیر پنجره توجه کاربر را به پنجره جلب کند. fvwm برای این منظور دو تابع قابل بازتعریف به نام‌های «UrgencyFunc» و «UrgencyDoneFunc» دارد که هنگام تنظیم یا پاک‌شدن پرچم اجرا می‌شوند. تعاریف پیش‌فرض آن‌ها عبارتند از: .sp .if n .RS 4 .nf .fam C AddToFunc UrgencyFunc + I Iconify off + I FlipFocus + I Raise + I WarpToWindow !raise 5p 5p AddToFunc UrgencyDoneFunc + I Nop .fam .fi .if n .RE .SH "اشارات توسعه‌یافته مدیر پنجره (EXTENDED WINDOW MANAGER HINTS)" .sp ‏fvwm تلاش می‌کند مشخصات اشارات توسعه‌یافته مدیر پنجره (به اختصار ewmh یا EWMH): .URL "https://specifications.freedesktop.org/wm\-spec/wm\-spec\-1.3.html" "" "" و برخی افزونه‌های این مشخصات را رعایت کند. .sp این پشتیبانی از طریق سبک‌ها و دستورها قابل پیکربندی است. این سبک‌ها و دستورها دارای پیشوند EWMH هستند (تا بتوانید آن‌ها را به راحتی در این صفحه راهنما پیدا کنید). .sp یک بافتار (Context) جدید \*(AqD\*(Aq برای دستورهای \fBKey\fP، \fBPointerKey\fP و \fBMouse\fP در نظر گرفته شده است. این بافتار برای برنامه‌های میزکار (مانند kdesktop و میزکار Nautilus) کاربرد دارد. .sp هنگامی که یک نوار وظیفه (taskbar) سازگار از fvwm می‌خواهد پنجره‌ای را فعال کند (معمولاً زمانی که روی دکمه‌ای که نمایانگر پنجره در نوار وظیفه است کلیک می‌کنید)، fvwm تابع پیچیدهٔ \fBEWMHActivateWindowFunc\fP را فراخوانی می‌کند که به طور پیش‌فرض Iconify Off، Focus و Raise است. شما می‌توانید این تابع را بازتعریف کنید. برای مثال: .sp .if n .RS 4 .nf .fam C DestroyFunc EWMHActivateWindowFunc AddToFunc EWMHActivateWindowFunc I Iconify Off + I Focus + I Raise + I WarpToWindow 50 50 .fam .fi .if n .RE .sp علاوه بر این، نشانگر ماوس را به مرکز پنجره منتقل می‌کند. .sp مشخصات EWMH مفهوم ناحیه کاری (Working Area) را معرفی می‌کند. بدون پشتیبانی ewmh، ناحیه کاری همان کل صفحه نمایش قابل مشاهده است (یا تمام نمایشگرهای شما در صورتی که پیکربندی چندنمایشگره با RandR داشته باشید). با این حال، برنامه‌های سازگار (مانند یک پنل) می‌توانند درخواست رزرو فضا در لبه صفحه را داشته باشند. در این صورت، ناحیه کاری برابر است با کل صفحه نمایش قابل مشاهده منهای این فضاهای رزروشده. اگر بتوان پنلی را با کلیک روی یک دکمه پنهان کرد، ناحیه کاری تغییر نمی‌کند (چرا که می‌توانید در هر زمان پنل را آشکار کنید)، اما «ناحیه کاری پویا» (Dynamic Working Area) به‌روزرسانی می‌شود: فضای رزروشده توسط پنل برداشته می‌شود (و اگر مجدداً پنل را باز کنید، اضافه می‌شود). ناحیه کاری پویا ممکن است زمانی که fvwm پنجره‌ای را جای‌گذاری کرده یا بیشینه (maximize) می‌کند مورد استفاده قرار گیرد. برای دانستن اینکه آیا برنامه‌ای فضا رزرو کرده است، می‌توانید دستور «xprop | grep _NET_WM_STRUT» را در ترمینال وارد کرده و برنامه را انتخاب کنید. اگر چهار عدد ظاهر شدند، این اعداد فضای رزروشده را همان‌طور که در دستور \fBEwmhBaseStruts\fP توضیح داده شده تعریف می‌کنند..SH "پیکربندی (CONFIGURATION)" .SS "فایل‌های پیکربندی" .sp فایل پیکربندی برای توصیف پیوندهای موشواره و کلیدها، رنگ‌ها، اندازهٔ نمایشگر مجازی، و موارد مرتبط به کار می‌رود. فایل پیکربندی راه‌اندازی معمولاً \fIconfig\fP (یا \fI.fvwm2rc\fP) نامیده می‌شود. با استفاده از دستور \fBRead\fP، خواندن فایل‌های پیکربندی جدید در حین کار بسیار آسان است. .sp خطوطی که با \*(Aq#\*(Aq آغاز می‌شوند توسط fvwm نادیده گرفته می‌شوند. انتظار می‌رود خطوطی که با \*(Aq*\*(Aq شروع می‌شوند شامل دستورهای پیکربندی پودمان باشند (به‌جای دستورهای پیکربندی برای خود fvwm). همانند اسکریپت‌های شل، خطوط جدید تعبیه‌شده در یک خط از فایل پیکربندی را می‌توان با قرار دادن یک بک‌اسلش در پیش از آن‌ها نقل‌قول (quote) کرد. تمامی خطوطی که به این شیوه متصل می‌شوند، به‌عنوان یک خط واحد در نظر گرفته می‌شوند. خود نویسهٔ خط جدید نادیده گرفته می‌شود. .sp نرم‌افزار Fvwm هیچ تمایزی میان دستورهای پیکربندی و دستورهای عملیاتی قائل نمی‌شود، بنابراین هر موردی که در بخش دستورهای fvwm ذکر شده است را می‌توان روی یک خط جداگانه قرار داد تا fvwm هنگام خواندن فایل پیکربندی آن را اجرا کند، یا می‌توان آن را به‌عنوان یک دستور اجرایی در یک منو قرار داد یا به یک کلید موشواره یا کلیدی از صفحه‌کلید متصل کرد. تصمیم‌گیری در این باره که کدام توابع برای راه‌اندازی اولیه و کدام‌ها برای زمان اجرا مناسب هستند، به عهدهٔ کاربر گذاشته شده است. .SS "پیکربندی ارائه‌شده" .sp یک نمونه فایل پیکربندی، همراه با توزیع fvwm ارائه شده است. این فایل دارای توضیحات مناسبی است و می‌تواند به‌عنوان منبعی از مثال‌ها برای پیکربندی fvwm استفاده شود. می‌توان آن را از فایل \fI/usr/local/share/fvwm/config\fP کپی کرد. .sp همچنین، منوی پیش‌ساخته (که در صورت پیدا نشدن هیچ فایل پیکربندی در دسترس است) گزینه‌هایی برای ایجاد یک فایل پیکربندی اولیه برای کاربر دارد. .SH "قلم‌ها (FONTS)" .SS "نام‌های قلم و بارگذاری قلم" .sp قلم‌های مورد استفاده برای متن عنوان پنجره، عنوان‌های آیکون، منوها و پنجرهٔ ابعاد و مکان (geometry window) را می‌توان با استفاده از دستورهای Font و IconFont در \fBStyle\fP، دستور Font در \fBMenuStyle\fP و دستور \fBDefaultFont\fP مشخص کرد. همچنین، تمام پودمان‌هایی که از متن استفاده می‌کنند دارای دستور(های) پیکربندی برای مشخص کردن قلم(ها) هستند. همهٔ این سبک‌ها و دستورها یک نام قلم را به‌عنوان آرگومان می‌پذیرند. این بخش توضیح می‌دهد که یک نام قلم برای fvwm چیست و fvwm چه قلم‌هایی را بارگذاری می‌کند. .sp نخست، می‌توانید از چیزی که می‌توان آن را یک نام قلم معمول نامید استفاده کنید، برای مثال: .sp .if n .RS 4 .nf .fam C \-adobe\-courier\-bold\-r\-normal\-\-10\-100\-75\-75\-m\-60\-ISO8859\-1 \-adobe\-courier\-bold\-r\-normal\-\-10\-* \-*\-fixed\-medium\-o\-normal\-\-14\-*\-ISO8859\-15 .fam .fi .if n .RE .sp به این معنا که می‌توانید از یک X Logical Font Description (به‌اختصار XLFD) استفاده کنید. سپس «اولین» قلمی که با این توصیف مطابقت داشته باشد بارگذاری شده و استفاده می‌شود. این «اولین» قلم به مسیر قلم شما و همچنین محیط محلی (locale) شما بستگی دارد. قلم‌هایی که با مجموعه نویسهٔ locale مطابقت دارند به ترتیب اولویت بارگذاری می‌شوند. برای مثال با .sp .if n .RS 4 .nf .fam C \-adobe\-courier\-bold\-r\-normal\-\-10\-* .fam .fi .if n .RE .sp اگر مجموعه نویسهٔ locale برابر با ISO8859\-1 باشد، آن‌گاه fvwm تلاش می‌کند قلمی را بارگذاری کند که با .sp .if n .RS 4 .nf .fam C \-adobe\-courier\-bold\-r\-normal\-\-10\-*\-ISO8859\-1 .fam .fi .if n .RE .sp مطابقت داشته باشد؛ با مجموعه نویسهٔ locale برابر با ISO8859\-15 نرم‌افزار fvwm تلاش می‌کند .sp .if n .RS 4 .nf .fam C \-adobe\-courier\-bold\-r\-normal\-\-10\-*\-ISO8859\-15. .fam .fi .if n .RE .sp را بارگذاری کند. .sp یک نام قلم را می‌توان به‌صورت یک XLFD گسترش‌یافته مشخص کرد. این یک فهرست جداشده با کاما از نام‌های قلم XLFD (ساده) است، برای مثال: .sp .if n .RS 4 .nf .fam C \-adobe\-courier\-bold\-r\-normal\-\-14\-*,\-*\-courier\-medium\-r\-normal\-\-14\-* .fam .fi .if n .RE .sp هر نام قلم ساده تا زمانی که قلمی منطبق با مجموعه نویسهٔ locale یافت شود آزموده می‌شود و اگر این کار ناموفق بود، هر نام قلم ساده بدون محدودیت روی مجموعه نویسه امتحان می‌شود. .sp جزئیات بیشتر دربارهٔ XLFD را می‌توان در صفحهٔ راهنمای X، سند X Logical Font Description Conventions (با نام xlfd) و صفحات راهنمای XLoadFont و XCreateFontSet یافت. برخی از ابزارهای کمکی مفید قلم عبارتند از: xlsfonts، xfontsel، xfd و xset. .sp اگر از پشتیبانی Xft برخوردارید، می‌توانید نام قلم (توصیف) Xft یک قلم true type (یا Type1) را با پیشوند "xft:" مشخص کنید، برای مثال: .sp .if n .RS 4 .nf .fam C "xft:Luxi Mono" "xft:Luxi Mono:Medium:Roman:size=14:encoding=iso8859\-1" .fam .fi .if n .RE .sp «اولین» قلمی که با این توصیف مطابقت داشته باشد بارگذاری می‌شود. این اولین قلم با Xft1 به فایل پیکربندی XftConfig و با Xft2 به فایل /etc/fonts/fonts.conf بستگی دارد. می‌توان صفحهٔ راهنمای Xft و صفحهٔ راهنمای fontconfig را همراه با Xft2 مطالعه کرد. نخستین رشته‌ای که پس از "xft:" می‌آید همواره به‌عنوان خانواده (family) در نظر گرفته می‌شود. در مثال دوم، Luxi Mono خانواده قلم است (سایر خانواده‌های TTF در XFree عبارتند از: "Luxi Serif"،‏ "Luxi Sans")، مقدار Medium نشان‌دهندهٔ وزن (Weight) است (سایر وزن‌های ممکن: Light،‏ DemiBold، Bold،‏ Black)، مقدار Roman بیانگر زاویه یا سبک (slant یا style) است (سایر حالت‌های ممکن: Regular،‏ Oblique،‏ Italic)، پارامتر size اندازه قلم بر حسب نقطه (point size) را مشخص می‌کند (برای اندازه بر حسب پیکسل از pixelsize= استفاده کنید)، پارامتر encoding امکان اجبار یک مجموعه نویسه را فراهم می‌کند (فقط iso8859\-1 یا iso10646\-1؛ اگر هیچ انکودینگی مشخص نشود، مجموعه نویسهٔ locale فرض می‌شود). یک پارامتر مهم "minspace=bool" است که در آن bool برابر با True یا False می‌باشد. اگر bool برابر با False باشد (حالت پیش‌فرض؟)، Xft ارتفاع قلم بیشتری را نسبت به حالتی که bool برابر با True باشد به fvwm اختصاص می‌دهد. این ممکن است چینش متن، ارتفاع عنوان آیکون و پنجره، فاصلهٔ خطوط در منوها و \fBFvwmIdent\fP، ارتفاع دکمه در برخی پودمان‌های fvwm و .\|.\|. غیره را تغییر دهد. با یک نمایشگر LCD می‌توانید افزودن "rgba=mode" را امتحان کنید که در آن mode یکی از مقادیر rgb،‏ bgr،‏ vrgb یا vbgr برای فعال‌سازی رندر زیرپیکسلی (subpixel rendering) است. بهترین حالت به نحوهٔ چیدمان سلول‌های LCD شما بستگی دارد. می‌توانید مشخصات دیگری را نیز در میان ":" ارسال کنید، از قبیل "foundry=foundry_name"،‏ "spacing=type" که در آن type می‌تواند monospace،‏ proportional یا charcell باشد، "charwidth=integer"،‏ "charheight=integer" یا "antialias=bool" که در آن bool برابر با True یا False است. به نظر می‌رسد که این پارامترها همیشه اعمال نمی‌شوند. .sp برای تعیین این‌که کدام قلم‌های Xft واقعاً بارگذاری شده‌اند، می‌توانید مقدار XFT_DEBUG=1 را پیش از اجرای fvwm صادر (export) کنید و نگاهی به لاگ خطاها بیندازید. با Xft2 می‌توانید از fc\-list برای فهرست کردن قلم‌های موجود استفاده کنید. به هر حال، پشتیبانی از Xft (از دیدگاه X و fvwm) آزمایشی است و کیفیت رندر به تعداد زیادی از پارامترها بستگی دارد (نسخه‌های XFree و freetype و کارت(های) گرافیک شما). .sp پس از نام قلم Xft می‌توانید بعد از یک نویسهٔ ";" یک نام قلم XLFD (ساده یا گسترش‌یافته) بیفزایید، مانند: .sp .if n .RS 4 .nf .fam C xft:Verdana:pixelsize=14;\-adobe\-courier\-bold\-r\-normal\-\-14\-* .fam .fi .if n .RE .sp سپس، اگر بارگذاری قلم Xft با شکست مواجه شود یا fvwm فاقد پشتیبانی Xft باشد، fvwm قلم "\-adobe\-courier\-bold\-r\-normal\(em14\-*" را بارگذاری می‌کند. این ویژگی امکان نوشتن فایل‌های پیکربندی سازگار و قابل‌حمل (portable) را فراهم می‌آورد..SS "کدگذاری قلم و رشته (Font and string encoding)" .sp به‌محض بارگذاری یک قلم، fvwm کدگذاری (یا مجموعه‌نویسه) آن را با استفاده از نام قلم (دو فیلد آخر نام) پیدا می‌کند. fvwm فرض می‌کند رشته‌هایی که با این قلم نمایش داده می‌شوند از این کدگذاری استفاده می‌کنند (یک استثنا این است که اگر یک قلم iso10646\-1 بارگذاری شود، آن‌گاه UTF\-8 برای کدگذاری رشته‌ها فرض می‌شود). در وضعیت عادی، (i) یک قلم با دادن نام قلم بدون مشخص کردن کدگذاری بارگذاری می‌شود، (ii) کدگذاری قلم بارگذاری‌شده همان کدگذاری محلی (locale) است، و سپس (iii) رشته‌ها در فایل‌های پیکربندی fvwm و همچنین نام پنجره و آیکون باید از کدگذاری محلی استفاده کنند. با Xft وضعیت کمی متفاوت است، زیرا Xft تنها از iso10646\-1 و iso8859\-1 پشتیبانی می‌کند. اگر یکی از این کدگذاری‌ها را در نام قلم Xft مشخص نکنید، fvwm تبدیل رشته‌ها را طبق (iii) انجام می‌دهد. توجه داشته باشید که در قلم‌های چندبایتی (به‌ویژه قلم‌های «CJK») برای رندر مناسب متن، کدگذاری محلی باید با مجموعه‌نویسه قلم یکسان باشد. .sp برای نادیده‌گرفتن قواعد پیشین، می‌توان کدگذاری رشته را در ابتدای توصیف قلم به صورت زیر مشخص کرد: .sp .if n .RS 4 .nf .fam C StringEncoding=enc:_full_font_name_ .fam .fi .if n .RE .sp که در آن \fIenc\fP کدگذاری پشتیبانی‌شده توسط fvwm است (معمولاً مجموعه‌نویسه نام قلم به‌همراه چند کدگذاری یونیکد: UTF\-8،‏ USC\-2،‏ USC\-4 و UTF\-16). .sp برای نمونه، ممکن است از مجموعه‌نویسه محلی iso8859\-1 استفاده کنید و یک \fBFvwmForm\fP به زبان روسی با کدگذاری koi8\-r داشته باشید. در این حالت، کافی است با مشخص کردن کدگذاری در نام قلم، از \fBFvwmForm\fP بخواهید قلم koi8\-r را بارگذاری کند. در یک زبان چندبایتی (از آنجا که قلم چندبایتی تنها زمانی به‌خوبی کار می‌کند که کدگذاری محلی، همان مجموعه‌نویسه قلم باشد)، باید از یک قلم iso10646\-1 استفاده کنید: .sp .if n .RS 4 .nf .fam C StringEncoding=jisx0208.1983\-0:\-*\-fixed\-medium\-r\-*\-ja\-*\-iso10646\-1 .fam .fi .if n .RE .sp یا .sp .if n .RS 4 .nf .fam C "StringEncoding=jisx0208.1983\-0:xft:Bitstream Cyberbit" .fam .fi .if n .RE .sp اگر پیکربندی \fBFvwmForm\fP شما از کدگذاری jisx0208.1983\-0 استفاده می‌کند. امکان دیگر، استفاده از کدگذاری UTF\-8 برای پیکربندی \fBFvwmForm\fP و استفاده از یک قلم iso10646\-1 است: .sp .if n .RS 4 .nf .fam C \-*\-fixed\-medium\-r\-*\-ja\-*\-iso10646\-1 .fam .fi .if n .RE .sp یا .sp .if n .RS 4 .nf .fam C "StringEncoding=UTF\-8:xft:Bitstream Cyberbit" .fam .fi .if n .RE .sp یا به‌طور معادل .sp .if n .RS 4 .nf .fam C "xft:Bitstream Cyberbit:encoding=iso10646\-1" .fam .fi .if n .RE .sp به‌طور کلی قلم‌های iso10646\-1 همراه با کدگذاری رشته‌ای UTF\-8 امکان نمایش هر نویسه‌ای را در یک منوی مشخص، \fBFvwmForm\fP و غیره فراهم می‌سازند. .sp امروزه یونیکد روزبه‌روز بیشتر استفاده می‌شود و فایل‌های متنی از کدگذاری UTF\-8 بهره می‌برند. با این وجود، در عمل نویسه‌های مورد استفاده در محدوده مجموعه‌نویسه محلی شما هستند. برای صرفه‌جویی در حافظه (یک قلم iso10646\-1 ممکن است تعداد بسیار زیادی نویسه داشته باشد) یا به این دلیل که قلم زیبایی بدون مجموعه‌نویسه iso10646\-1 دارید، می‌توانید کدگذاری رشته را روی UTF\-8 تنظیم کرده و از قلمی با مجموعه‌نویسه محلی استفاده کنید: .sp .if n .RS 4 .nf .fam C StringEncoding=UTF\-8:\-*\-pretty_font\-*\-12\-* .fam .fi .if n .RE .sp در بیشتر موارد، fvwm کدگذاری قلم را به‌درستی تشخیص می‌دهد. با این حال، نام برخی از قلم‌ها به نام‌های کدگذاری معتبر ختم نمی‌شود. هنگامی که نام قلم عادی نیست، برای نمونه: .sp .if n .RS 4 .nf .fam C \-misc\-fixed\-*\-\-20\-*\-my_utf8\-36 .fam .fi .if n .RE .sp باید کدگذاری را پس از نام قلم و با استفاده از یک اسلش به عنوان جداکننده اضافه کنید. برای نمونه: .sp .if n .RS 4 .nf .fam C MenuStyle * Font \-misc\-fixed\-*\-\-20\-*\-my_utf8\-36/iso10646\-1 .fam .fi .if n .RE .sp اگر fvwm کدگذاری را پیدا کند، از توابع سیستمی iconv برای انجام تبدیل میان کدگذاری‌ها استفاده می‌کند. متأسفانه استاندارد ثابتی وجود ندارد. برای تبدیل بین iso8859\-1 و UTF\-8: یک سیستم GNU از «ISO\-8859\-1» و سیستم‌های دیگر از «iso881» برای تعریف مبدل‌ها استفاده می‌کنند (هر دوی این نام‌ها توسط fvwm پشتیبانی می‌شوند). افزون بر این، در برخی موارد ممکن است استفاده از مبدل‌های مختص ماشین ضروری باشد. بنابراین، در صورت مواجهه با مشکل می‌توانید اطلاعات مربوط به پیاده‌سازی iconv سیستم خود را به دست آورید (دستور «man iconv» ممکن است مفید باشد) و نامی را که مبدل بین کدگذاری قلم و UTF\-8 را تعریف می‌کند، در انتهای نام قلم پس از راهنمای کدگذاری و یک / قرار دهید (راهکار ممکن دیگر استفاده از GNU libiconv است). برای نمونه از این ساختار استفاده کنید: .sp .if n .RS 4 .nf .fam C Style * Font \-misc\-fixed\-*\-\-14\-*\-iso8859\-1/*/latin1 .fam .fi .if n .RE .sp تا از latin1 برای تعریف مبدل برای کدگذاری iso8859\-1 استفاده شود. نویسه «*» در میان «/»ها به fvwm اعلام می‌کند که کدگذاری را از انتهای نام قلم تشخیص دهد. از این ساختار استفاده کنید: .sp .if n .RS 4 .nf .fam C Style * Font \(rs \-misc\-fixed\-*\-\-14\-*\-local8859\-6/iso8859\-6/local_iso8859_6_iconv .fam .fi .if n .RE .sp تا fvwm وادار به استفاده از قلم با کدگذاری iso8859\-6 شود (این مورد برای پشتیبانی از متون دوجهته یا bi\-directionality سودمند است) و از local_iso8859_6_iconv برای تعریف مبدل‌ها استفاده کند..SS "جلوه‌های سایه قلم (Font Shadow Effects)" .sp می‌توان به قلم‌ها جلوه‌های سه‌بعدی داد. در ابتدای نام قلم (یا دقیقاً پس از مشخصه احتمالی StringEncoding) عبارت زیر را اضافه کنید: .sp .if n .RS 4 .nf .fam C Shadow=size [offset] [directions]]: .fam .fi .if n .RE .sp \fIsize\fP یک عدد صحیح مثبت است که تعداد پیکسل‌های سایه را مشخص می‌کند. \fIoffset\fP یک عدد صحیح مثبت اختیاری است که میزان فاصله (آفست) سایه از لبه نویسه را بر حسب پیکسل تعیین می‌کند. مقدار پیش‌فرض offset صفر است. \fIdirections\fP مجموعه‌ای اختیاری از جهت‌هایی است که سایه از نویسه به سمت آن‌ها کشیده می‌شود. مقادیر \fIdirections\fP فهرستی از جهت‌های fvwm هستند که با فاصله از هم جدا می‌شوند: .sp \fIN\fP, \fINorth\fP, \fITop\fP, \fIt\fP, \fIUp\fP, \fIu\fP, \fI\-\fP .sp \fIE\fP, \fIEast\fP, \fIRight\fP, \fIr\fP, \fIRight\fP, \fIr\fP, \fI]\fP .sp \fIS\fP, \fISouth\fP, \fIBottom\fP, \fIb\fP, \fIDown\fP, \fId\fP, \fI_\fP .sp \fIW\fP, \fIWest\fP, \fILeft\fP, \fIl\fP, \fILeft\fP, \fIl\fP, \fI[\fP .sp \fINE\fP, \fINorthEast\fP, \fITopRight\fP, \fItr\fP, \fIUpRight\fP, \fIur\fP, \fI^\fP .sp \fISE\fP, \fISouthEast\fP, \fIBottomRight\fP, \fIbr\fP, \fIDownRight\fP, \fIdr\fP, \fI>\fP .sp \fISW\fP, \fISouthWest\fP, \fIBottomLeft\fP, \fIbl\fP, \fIDownLeft\fP, \fIdl\fP, \fIv\fP .sp \fINW\fP, \fINorthWest\fP, \fITopLeft\fP, \fItl\fP, \fIUpLeft\fP, \fIul\fP, \fI<\fP .sp \fIC\fP, \fICenter\fP, \fICentre\fP, \fI.\fP .sp در هر یک از جهت‌های ارائه‌شده یک سایه نمایش داده می‌شود. مقدار \fIAll\fP معادل تمامی جهت‌ها است. مقدار پیش‌فرض \fIdirection\fP برابر \fIBottomRight\fP است. با انتخاب جهت \fICenter\fP، سایه کل رشته را احاطه می‌کند. از آنجا که این حالت یک ابرمجموعه از تمامی جهت‌های دیگر است، مشخص کردن آن به همراه هر جهت دیگری بیهوده خواهد بود. .sp جلوه سایه تنها با colorsetها کار می‌کند. رنگ سایه با استفاده از گزینه \fIfgsh\fP در دستور \fBColorset\fP تعیین می‌شود. لطفاً برای جزئیات بیشتر درباره colorsetها، به بخش \fBColorsets\fP مراجعه کنید. .sp نکته: یافتن قلم و ترکیب مناسب رنگ‌های \fIfg\fP، \fIfgsh\fP و \fIbg\fP برای اینکه این جلوه زیبا به نظر برسد ممکن است دشوار باشد، اما می‌تواند جلوه بسیار زیبایی خلق کند. .SH "متن دوجهته (BI\-DIRECTIONAL TEXT)" .sp متون عربی و عبری برای نمایش صحیح به پشتیبانی از متن دوجهته (bi\-directional) نیاز دارند؛ بدین معنا که رشته‌های منطقی پیش از نمایش بصری باید تبدیل شوند تا زیررشته‌های چپ‌به‌راست و راست‌به‌چپ مشخص گردیده و بازآرایی شوند. در fvwm، اگر قلم‌های استفاده‌شده برای نمایش متن متعلق به مجموعه‌نویسه‌هایی باشند که به پشتیبانی از \fIbidi\fP (دوجهته) نیاز دارند، این کار به صورت خودکار در عنوان پنجره‌ها، منوها، برچسب‌های ماژول‌ها و سایر بخش‌ها انجام می‌گیرد. به عنوان مثال، این شامل iso8859\-6، iso8859\-8 و iso10646\-1 (یونیکد) می‌شود، اما دیگر قلم‌های *\-iso8859 را شامل نمی‌گردد. .sp این پشتیبانی از متن دوجهته با استفاده از گزینه زمان کامپایل کتابخانه \fIfribidi\fP انجام می‌شود، \fIINSTALL.fvwm\fP را ببینید. .SH "میانبرهای صفحه‌کلید (KEYBOARD SHORTCUTS)" .sp تقریباً تمامی عملیات‌های مدیر پنجره را می‌توان از طریق صفحه‌کلید انجام داد، بنابراین کاربری بدون موش نیز امکان‌پذیر است. علاوه بر پیمایش در میزکار مجازی از طریق پیوند دادن دستور \fBScroll\fP به کلیدهای مناسب، می‌توان دستورهای \fBPopup\fP، \fBMove\fP، \fBResize\fP و هر دستور دیگری را نیز به کلیدها پیوند داد. پس از آغاز یک دستور، نشانگر با استفاده از کلیدهای جهت‌نمای بالا، پایین، چپ و راست حرکت داده می‌شود و با فشردن کلید return عمل پایان می‌یابد. نگه داشتن کلید Shift باعث می‌شود نشانگر با گام‌های بزرگ‌تری حرکت کند و نگه داشتن کلید control حرکت نشانگر را در گام‌های کوچک‌تری قرار می‌دهد. به جای کلیدهای جهت‌نما می‌توان از کنترل‌های استاندارد حرکت مکان‌نما در emacs و vi نیز استفاده کرد. .SH "مدیریت نشست (SESSION MANAGEMENT)" .sp برنامه fvwm از مدیریت نشست مطابق با پروتکل X Session Management Protocol پشتیبانی می‌کند. این ویژگی موقعیت، اندازه، ترتیب چیدمان (stacking order)، میزکار (desk)، چسبندگی (stickiness)، جمع‌شدگی (shadiness)، بیشینه‌بودن (maximizedness) و وضعیت نمادین (iconifiedness) را برای تمام پنجره‌ها ذخیره و بازیابی می‌کند. علاوه بر این، برخی از وضعیت‌های سراسری نیز ذخیره می‌شوند. .sp برنامه fvwm هیچ اطلاعاتی را در رابطه با سبک‌ها (styles)، تزئینات (decors)، توابع (functions) یا منوها ذخیره نمی‌کند. اگر در طول یک نشست هر یک از این منابع را تغییر دهید (مثلاً با اجرای دستورات \fBStyle\fP یا استفاده از ماژول‌های گوناگون)، این تغییرات پس از ذخیره و راه‌اندازی مجدد نشست از بین خواهند رفت. برای دائمی شدن، این‌گونه تغییرات باید به فایل پیکربندی افزوده شوند. .SH "آرگومان‌های بولی (BOOLEAN ARGUMENTS)" .sp تعدادی از دستورها یک یا چند آرگومان بولی می‌گیرند. این آرگومان‌ها چند ورودی معادل را می‌پذیرند: مقادیر "yes" ،"on" ،"true" ،"t" و "y" همگی به عنوان درست (true) ارزیابی می‌شوند، در حالی که "no" ،"off" ،"false" ،"f" و "n" به عنوان نادرست (false) ارزیابی می‌گردند. برخی دستورها "toggle" را نیز می‌پذیرند که به این معناست که اگر قابلیت در حال حاضر فعال باشد غیرفعال می‌شود و بالعکس. .SH "پیوندهای داخلی کلید و موش (BUILTIN KEY AND MOUSE BINDINGS)" .sp دستورهای زیر به صورت توکار و داخلی در fvwm تعبیه شده‌اند: .sp .if n .RS 4 .nf .fam C Key Help R A Popup MenuFvwmRoot Key F1 R A Popup MenuFvwmRoot Key Tab A M WindowList Root c c NoDeskSort Key Escape A MC EscapeFunc Mouse 1 R A Menu MenuFvwmRoot Mouse 1 T\& A FuncFvwmRaiseLowerX Move Mouse 1 FS\& A FuncFvwmRaiseLowerX Resize Mouse 2 FST A FuncFvwmRaiseLowerX Move AddToFunc FuncFvwmRaiseLowerX + I Raise + M $0 + D Lower .fam .fi .if n .RE .sp کلیدهای Help و F1 یک منوی توکار را که fvwm ایجاد می‌کند فرامی‌خوانند. این قابلیت در درجه اول برای کاربران جدیدی است که هنوز فایل پیکربندی اختصاصی خود را نساخته‌اند. فشردن هر یک از این دو کلید بر روی پنجره ریشه (پس‌زمینه)، منویی را برای کمک به شروع کار باز می‌کند. .sp فشردن کلید Tab در هر مکان به همراه پایین نگه داشتن کلید Alt (مشابه همان کلید در صفحه‌کلیدهای رایانه‌های شخصی)، فهرستی از پنجره‌ها را باز می‌کند. .sp دکمه ۱ موش بر روی نوار عنوان یا قاب جانبی می‌تواند پنجره را جابه‌جا کند، بالا بیاورد یا پایین ببرد. .sp دکمه ۱ موش بر روی گوشه‌های پنجره می‌تواند اندازه پنجره را تغییر دهد، آن را بالا بیاورد یا پایین ببرد. .sp می‌توانید این پیوندها را بازنویسی یا حذف کنید. برای حذف پیوند فهرست پنجره‌ها، از این دستور استفاده کنید: .sp .if n .RS 4 .nf .fam C Key Tab A M \- .fam .fi .if n .RE.SH "اجرای دستورات (COMMAND EXECUTION)" .SS "دستورات ماژول و تابع (Module and Function Commands)" .sp اگر fvwm با دستوری مواجه شود که آن را تشخیص نمی‌دهد، بررسی می‌کند که آیا دستور مشخص‌شده باید .sp .if n .RS 4 .nf .fam C Function (rest of command) .fam .fi .if n .RE .sp یا .sp .if n .RS 4 .nf .fam C Module (rest of command) .fam .fi .if n .RE .sp می‌بوده است یا خیر. این سازوکار اجازه می‌دهد توابع پیچیده یا ماژول‌ها به شیوه‌ای فراخوانی شوند که برای فایل پیکربندی کاملاً شفاف باشد. .sp مثال: فایل \fIconfig\fP شامل این خط است: .sp .if n .RS 4 .nf .fam C HelpMe .fam .fi .if n .RE .sp برنامه fvwm ابتدا به دنبال یک دستور fvwm به نام "HelpMe" می‌گردد و شکست می‌خورد. سپس به دنبال یک تابع پیچیدهٔ تعریف‌شده توسط کاربر به نام "HelpMe" می‌گردد. اگر چنین تابعی وجود نداشته باشد، fvwm تلاش می‌کند ماژولی به نام "HelpMe" را اجرا کند. .SS "اجرای با تأخیر دستورات (Delayed Execution of Commands)" .sp \fBنکته\fP: دستورات بسیاری وجود دارند که بر ظاهر و رفتار (look and feel) پنجره‌های خاص، برخی پنجره‌ها یا همهٔ آن‌ها اثر می‌گذارند، مانند \fBStyle\fP، \fBMouse\fP، \fBColorset\fP، \fBTitleStyle\fP و بسیاری موارد دیگر. به دلایل کارایی، چنین تغییراتی بلافاصله اعمال نمی‌شوند، بلکه تنها زمانی اعمال می‌گردند که fvwm بیکار (idle) باشد؛ یعنی هیچ تعامل کاربری یا ورودی ماژولی در حال انتظار نباشد. به‌طور خاص، گزینه‌های جدید \fBStyle\fP که درون یک تابع تنظیم می‌شوند، تا پس از پایان تابع اعمال نمی‌شوند. این موضوع گاهی اوقات می‌تواند منجر به اثرات ناخواسته شود. .sp برای اجبار به اعمال فوری تمام تغییرات معلق، از دستورات \fBUpdateStyles\fP، \fBRefresh\fP یا \fBRefreshWindow\fP استفاده کنید. .SH "نقل‌قول (QUOTING)" .sp نقل‌قول‌ها فقط زمانی لازم هستند که لازم باشد fvwm دو یا چند کلمه را یک آرگومان واحد در نظر بگیرد. نقل‌قول‌های غیرضروری نیز مجازند. اگر می‌خواهید نویسهٔ نقل‌قول در متن شما وجود داشته باشد، باید با استفاده از نویسهٔ بک‌اسلش آن را گریزدهی (escape) کنید. به عنوان مثال، اگر یک منوی جهنده (pop\-up) به نام "Window\-Ops" داشته باشید، نیازی به نقل‌قول ندارید: .sp .if n .RS 4 .nf .fam C Popup Window\-Ops .fam .fi .if n .RE .sp اما اگر خط تیره را با یک فاصله جایگزین کنید، به نقل‌قول نیاز خواهید داشت: .sp .if n .RS 4 .nf .fam C Popup "Window Ops" .fam .fi .if n .RE .sp نویسه‌های نقل‌قول پشتیبانی‌شده عبارتند از نقل‌قول دوتایی (double quote)، نقل‌قول تکی (single quote) و نقل‌قول تکی معکوس (reverse single quote یا backtick). با هر سه نوع نقل‌قول به شیوهٔ یکسانی برخورد می‌شود. نویسه‌های تکی را می‌توان با یک بک‌اسلشِ پیشین نقل‌قول کرد. نقل‌قول نویسه‌های تکی حتی درون دیگر انواع نقل‌قول‌ها نیز کار می‌کند. .SH "بسط دستورات (COMMAND EXPANSION)" .sp هر زمان که یک خط فرمان fvwm اجرا می‌شود، fvwm بسط پارامتر (parameter expansion) را انجام می‌دهد. یک پارامتر شامل یک \*(Aq$\*(Aq است که به دنبال آن کلمه‌ای محصور در براکت‌ها ($[.\|.\|.]) یا یک نویسهٔ خاص تکی می‌آید. اگر fvwm با پارامتری بدون نقل‌قول در خط فرمان مواجه شود، آن را به رشته‌ای که توسط نام پارامتر مشخص شده بسط می‌دهد. پارامترهای ناشناخته دست‌نخورده باقی می‌مانند. بسط پارامتر پیش از بررسی نقل‌قول انجام می‌شود. برای استفاده از یک \*(Aq$\*(Aq واقعی (تحت‌اللفظی) از "$$" استفاده کنید. .sp اگر ابتدای یک دستور پیشوند \*(Aq\-\*(Aq قرار گیرد، بسط پارامتر انجام نمی‌شود. این قاعده برای دستوری اعمال می‌شود که بلافاصله پس از \*(Aq\-\*(Aq قرار دارد و بسط معمولاً در آن رخ می‌داد. هنگام استفاده هم‌زمان با سایر دستورات پیشوندی، باید قبل از پیشوند دیگر اضافه شود. .sp مثال: .sp .if n .RS 4 .nf .fam C Pick \-Exec exec xmessage \*(Aq$[w.name]\*(Aq .fam .fi .if n .RE .sp یک کادر گفتگوی xmessage را با "$[w.name]" بدون بسط باز می‌کند. .sp متغیرهای طولانی‌تر ممکن است حاوی متغیرهای دیگری در داخل نام خود باشند که پیش از متغیر بیرونی بسط می‌یابند. .sp در نسخه‌های پیشین fvwm، برخی متغیرهای تک‌حرفی پشتیبانی می‌شدند. اکنون استفاده از آن‌ها منسوخ شده است، زیرا مشکلات متعددی ایجاد می‌کنند. باید به جای آن‌ها از جایگزین‌های طولانی‌تر استفاده کنید. .sp مثال: .sp .if n .RS 4 .nf .fam C # Print the current desk number, horizontal page number # and the window\*(Aqs class (unexpanded here, no window). Echo $[desk.n] $[page.nx] $[w.class] .fam .fi .if n .RE .sp نکته: اگر دستور خارج از بافت یک پنجره فراخوانی شود، به جای نام کلاس، مقدار "$[w.class]" را چاپ می‌کند. معمولاً قرار گرفتن اشاره‌گر روی یک پنجره برای داشتن بافت پنجره کافی نیست. برای اجبار به استفاده از پنجره‌ای که فوکوس دارد، می‌توان از دستور \fBCurrent\fP استفاده کرد: .sp .if n .RS 4 .nf .fam C Current Echo $[desk.n] $[page.nx] $[w.class] .fam .fi .if n .RE .sp پارامترهای شناخته‌شده توسط fvwm عبارتند از: .sp $$ .RS 4 یک \*(Aq$\*(Aq واقعی (تحت‌اللفظی). .RE .sp $. .RS 4 دایرکتوری مطلق فایلی که در حال حاضر با Read خوانده می‌شود. برای ایجاد درخت‌های پیکربندی نسبی و قابل‌انتقال در نظر گرفته شده است. در صورت استفاده در خارج از هر فایل خوانده‌شده، مقدار بازگردانده‌شده \*(Aq.\*(Aq خواهد بود. .RE .sp $0 to $9 .RS 4 پارامترهای موضعی ارائه‌شده به یک تابع پیچیده (تابعی که با دستور \fBAddToFunc\fP تعریف شده است). مقدار "$0" با اولین پارامتر، "$1" با دومین پارامتر و به همین ترتیب جایگزین می‌شود. اگر پارامتر متناظر تعریف نشده باشد، عبارت "$.\|.\|." از خط فرمان حذف می‌شود. .RE .sp $* .RS 4 تمام پارامترهای موضعی داده‌شده به یک تابع پیچیده. این متغیر شامل پارامترهایی که بعد از "$9" می‌آیند نیز می‌شود. .RE .sp $[\fIn\fP] .RS 4 پارامتر موضعی \fIn\fP‌ام داده‌شده به یک تابع پیچیده، با شمارش از 0. اگر پارامتر متناظر تعریف نشده باشد، عبارت "$[\fIn\fP]" از خط فرمان حذف می‌شود. پارامتر بدون نقل‌قول بسط می‌یابد. .RE .sp $[\fIn\fP\-\fIm\fP] .RS 4 پارامترهای موضعی داده‌شده به یک تابع پیچیده، با شروع از پارامتر \fIn\fP و پایان با پارامتر \fIm\fP. اگر تمام پارامترهای متناظر تعریف نشده باشند، عبارت "$[.\|.\|.]" از خط فرمان حذف می‌شود. اگر تنها برخی از پارامترها تعریف شده باشند، همهٔ پارامترهای تعریف‌شده بسط می‌یابند و مابقی بدون اخطار نادیده گرفته می‌شوند. همهٔ پارامترها بدون نقل‌قول بسط داده می‌شوند. .RE .sp $[\fIn\fP\-] .RS 4 تمام پارامترهای موضعی داده‌شده به یک تابع پیچیده، با شروع از پارامتر \fIn\fP. اگر تمام پارامترهای متناظر تعریف نشده باشند، عبارت "$[.\|.\|.]" از خط فرمان حذف می‌شود. همهٔ پارامترها بدون نقل‌قول بسط می‌یابند. .RE .sp $[*] .RS 4 تمام پارامترهای موضعی داده‌شده به یک تابع پیچیده. این معادل $[0\-] است. .RE .sp $[version.num] .RS 4 شماره نسخه، مانند "2.6.0". .RE .sp $[version.info] .RS 4 اطلاعات نسخه، که شامل شناسهٔ SHA از آخرین کامیت (در صورت کامپایل از git) یا "(relesaed)" در صورت کامپایل از تاربال انتشار است. .RE .sp $[version.line] .RS 4 اولین خط چاپ‌شده توسط گزینه خط فرمان \-\-version. .RE .sp $[vp.x] $[vp.y] $[vp.width] $[vp.height] .RS 4 مختصات یا عرض یا ارتفاع درگاه دید (viewport) فعلی. .RE .sp $[wa.x] $[wa.y] $[wa.width] $[wa.height] .RS 4 مختصات یا عرض یا ارتفاع ناحیه کاری EWMH. .RE .sp $[dwa.x] $[dwa.y] $[dwa.width] $[dwa.height] .RS 4 مختصات یا عرض یا ارتفاع ناحیه کاری پویای EWMH. .RE .sp $[desk.count] .RS 4 تعداد میزکارهای تعریف‌شده با دستور \fBDesktopName\fP. .RE .sp $[desk.n] .RS 4 شماره میزکار فعلی. .RE .sp $[desk.name] .RS 4 این پارامترها با نام میزکار شماره که با دستور \fBDesktopName\fP تعریف شده است جایگزین می‌شوند. اگر نامی تعریف نشده باشد، نام پیش‌فرض بازگردانده می‌شود. .RE .sp $[desk.width] $[desk.height] .RS 4 عرض یا ارتفاع کل میزکار؛ یعنی عرض یا ارتفاع ضرب در تعداد صفحات در جهت x یا y. .RE .sp $[desk.pagesx] $[desk.pagesy] .RS 4 تعداد کل صفحات در یک میزکار در جهت x یا y. این مقدار همان مقادیر تنظیم‌شده توسط \fBDesktopSize\fP است. .RE .sp $[page.nx] $[page.ny] .RS 4 شماره صفحات فعلی بر اساس محورهای X و Y، با شروع از 0. اصطلاح \fIpage\fP در اصطلاحات GNOME معادل \fIarea\fP است. .RE .sp $[w.id] .RS 4 شناسه پنجره (window\-id که در مبنای ۱۶ بیان می‌شود، مثلاً 0x10023c) برای پنجره‌ای که دستور برای آن فراخوانی شده است، یا عبارت "$[w.id]" در صورتی که هیچ پنجره‌ای با دستور مرتبط نباشد. .RE .sp $[w.name] $[w.iconname] $[w.class] $[w.resource] $[w.visiblename] $[w.iconfile] $[w.miniiconfile] $[w.iconfile.svgopts] $[w.miniiconfile.svgopts] .RS 4 نام پنجره، نام آیکون، کلاس منبع و نام منبع، نام مرئی، نام فایل آیکون یا مینی‌آیکون آن که با سبک \fIIcon\fP یا \fIMiniIcon\fP تعریف شده است (شامل مسیر کامل در صورت پیدا شدن فایل روی دیسک)، و (اگر fvwm با پشتیبانی از SVG کامپایل شده باشد) گزینه‌های رندر svg آیکون یا مینی‌آیکون (شامل دونقطهٔ ابتدایی)، یا رشتهٔ بسط‌نیافتهٔ "$[w.]" در صورتی که هیچ پنجره‌ای با دستور مرتبط نباشد. .sp توجه: ۵ متغیر اول ممکن است شامل هر نوع نویسه‌ای باشند، بنابراین این متغیرها نقل‌قول می‌شوند. این بدان معناست که مقدار در نویسه‌های نقل‌قول تکی محصور شده و هر نقل‌قول تکیِ موجود در آن، با یک بک‌اسلش پیشوند می‌گیرد. این امر تضمین می‌کند که دستوراتی مانند: .sp .if n .RS 4 .nf .fam C Style $[w.resource] Icon norm/network.png .fam .fi .if n .RE .sp صرف‌نظر از هرگونه نماد خاصی که مقدار ممکن است شامل آن باشد (مانند فاصله‌ها و انواع مختلف نقل‌قول‌ها)، به درستی کار کنند. .sp در مورد نام مرئی پنجره، این مقداری است که از عنوان تحت‌اللفظی پنجره که در نوار عنوان نمایش داده می‌شود بازگردانده می‌شود. معمولاً این مقدار پس از بسط مشابه $[w.name] خواهد بود، هرچند در صورت استفاده از \fIIndexedWindowName\fP این تمایز مفیدتر است و اجازه می‌دهد برای مواردی مانند دستورات \fBStyle\fP، با استفاده از نام مرئی به پنجرهٔ خاصی ارجاع داده شود. .RE .sp $[w.x] $[w.y] $[w.width] $[w.height] .RS 4 مختصات یا عرض یا ارتفاع پنجرهٔ فعلی در صورتی که آیکون‌نشده (iconified) باشد. اگر هیچ پنجره‌ای با دستور مرتبط نباشد یا پنجره آیکون شده باشد، رشته دست‌نخورده باقی می‌ماند. .RE .sp $[w.pagex] $[w.pagey] .RS 4 صفحهٔ X یا Y که پنجره در آن قرار دارد. .RE .sp $[w.desk] .RS 4 شماره میزکاری که پنجره در آن نمایش داده می‌شود. اگر پنجره چسبان (sticky) باشد از شماره میزکار فعلی استفاده می‌شود. .RE .sp $[w.layer] .RS 4 لایهٔ پنجره. .RE .sp $[w.screen] .RS 4 نام صفحه‌نمایشی که پنجره در آن قرار دارد. .RE .sp $[cw.x] $[cw.y] $[cw.width] $[cw.height] .RS 4 این متغیرها شبیه $[w.…] کار می‌کنند اما هندسهٔ بخش کلاینت پنجره را بازمی‌گردانند. به بیان دیگر: حاشیه و عنوان پنجره در نظر گرفته نمی‌شوند. .RE .sp $[i.x], $[it.x], $[ip.x] $[i.y], $[it.y], $[ip.y] $[i.width], $[it.width], $[ip.width] $[i.height], $[it.height], $[ip.height] .RS 4 این متغیرها شبیه $[w.…] کار می‌کنند اما هندسهٔ آیکون ($[i.…])، عنوان آیکون ($[it.…]) یا تصویر آیکون ($[ip.…]) را بازمی‌گردانند. .RE .sp $[pointer.x] $[pointer.y] .RS 4 این متغیرها موقعیت اشاره‌گر را روی صفحه‌نمایش بازمی‌گردانند. اگر اشاره‌گر روی صفحه‌نمایش نباشد، این متغیرها بسط داده نمی‌شوند. .RE .sp $[pointer.wx] $[pointer.wy] .RS 4 این متغیرها موقعیت اشاره‌گر را در پنجرهٔ انتخاب‌شده بازمی‌گردانند. اگر اشاره‌گر روی صفحه‌نمایش نباشد، پنجره آیکون شده باشد یا پنجره‌ای انتخاب نشده باشد، این متغیرها بسط داده نمی‌شوند. .RE .sp $[pointer.cx] $[pointer.cy] .RS 4 این متغیرها موقعیت اشاره‌گر را در بخش کلاینت پنجرهٔ انتخاب‌شده بازمی‌گردانند. اگر اشاره‌گر روی صفحه‌نمایش نباشد، پنجره سایه‌دار (shaded) یا آیکون شده باشد یا پنجره‌ای انتخاب نشده باشد، این متغیرها بسط داده نمی‌شوند. .RE .sp $[pointer.screen] .RS 4 نام صفحه‌نمایشی که اشاره‌گر در حال حاضر روی آن قرار دارد. .sp این متغیر منسوخ شده است؛ به جای آن از $[monitor.current] استفاده کنید. .RE .sp $[monitor..x], $[monitor..y], $[monitor..width], $[monitor..height], $[monitor..desk], $[monitor..pagex], $[monitor..pagey] $[monitor.primary], $[monitor.prev_primary], $[monitor.current], $[monitor.prev] $[monitor.output], $[monitor.number] $[monitor.count], $[monitor..prev_desk], $[monitor..prev_pagex], $[monitor..prev_pagey] .RS 4 اطلاعات مربوط به مانیتور انتخاب‌شده را بازمی‌گرداند. این موارد می‌توانند تودرتو باشند، برای مثال: $[monitor.$[monitor.primary].width] .sp مقدار باید یک نام خروجی معتبر xrandr(1) باشد. .sp مقدار "x" موقعیت افقی (x) مانیتور را بازمی‌گرداند؛ "y" موقعیت عمودی (y) مانیتور را بازمی‌گرداند؛ "width" عرض مانیتور (به پیکسل) را بازمی‌گرداند؛ "height" ارتفاع مانیتور (به پیکسل) را بازمی‌گرداند. .sp مقدار "number" موقعیت مانیتور را در ساختار درختی بازمی‌گرداند. بخش RANDR SUPPORT را ببینید. .sp مقدار "current" همانند متغیر منسوخ‌شدهٔ $[screen.pointer] است؛ مانیتوری که اشاره‌گر ماوس روی آن قرار دارد. .sp مقدار "prev" مانیتور دارای فوکوس قبلی را بازمی‌گرداند، یا اگر وجود نداشته باشد یک رشته خالی بازمی‌گرداند. .sp مقدار "count" تعداد مانیتورهای فعال را بازمی‌گرداند. .sp مقدار "desk" میزکار فعلی نمایش‌داده‌شده روی مانیتور ارجاع‌شده را بازمی‌گرداند. .sp مقدار "pagex" صفحهٔ X روی مانیتور ارجاع‌شده را بازمی‌گرداند. .sp مقدار "pagey" صفحهٔ Y روی مانیتور ارجاع‌شده را بازمی‌گرداند. .sp مقدار "primary" نام خروجی‌ای است که از طریق xrandr(1) به عنوان مانیتور اصلی تنظیم شده است. .sp مقدار "prev_primary" نام خروجی‌ای است که مانیتور اصلی پیشین بوده است. .sp مقدار "prev_desk" میزکار قبلی روی مانیتور ارجاع‌شده را بازمی‌گرداند. .sp مقدار "prev_pagex" صفحهٔ X قبلی روی مانیتور ارجاع‌شده را بازمی‌گرداند. .sp مقدار "prev_pagey" صفحهٔ Y قبلی روی مانیتور ارجاع‌شده را بازمی‌گرداند. .RE .sp $[screen] .RS 4 شماره صفحه‌نمایشی که fvwm روی آن اجرا می‌شود. برای پیکربندی‌های چند صفحه‌نمایشی کاربرد دارد. .RE .sp $[screen.count] .RS 4 تعداد کل صفحه‌نمایش‌های شناسایی‌شده. .sp این متغیر منسوخ شده است؛ به جای آن از $[monitor.count] استفاده کنید. .RE .sp $[fg.cs] $[bg.cs] $[hilight.cs] $[shadow.cs] $[fgsh.cs] .RS 4 این پارامترها با نام رنگ پیش‌زمینه (fg)، پس‌زمینه (bg)، هایلایت (hilight)، سایه (shadow) یا سایهٔ قلم (fgsh) که در مجموعه‌رنگ تعریف شده است جایگزین می‌شوند (مقدار را با صفر یا یک عدد صحیح مثبت جایگزین کنید). برای مثال "$[fg.cs3]" به نام رنگ پیش‌زمینهٔ مجموعه‌رنگ ۳ (در قالب rgb:rrrr/gggg/bbbb) بسط می‌یابد. .sp اگر .lighten

یا .darken

به انتهای پارامترها اضافه شود، آن‌ها در عوض با رنگی جایگزین می‌شوند که به اندازهٔ یک مقدار درصدی

(بین 0 تا 100) نسبت به رنگ تعریف‌شده در مجموعه‌رنگ روشن‌تر یا تیره‌تر است. برای مثال "$[bg.cs3.lighten15]" به رنگ پس‌زمینهٔ مجموعه‌رنگ ۳ بسط داده شده و سپس ۱۵٪ روشن‌تر می‌شود (در قالب rgb:rrrr/gggg/bbbb). .sp اگر .hash به انتها افزوده شود، خروجی رنگ از قالب #rrggbb استفاده خواهد کرد (به جای rgb:rrrr/gggg/bbbb). برای مثال، $[bg.cs3.hash] یا $[bg.cs3.lighten15.hash]. .sp لطفاً برای جزئیات مربوط به مجموعه‌رنگ‌ها به بخش \fBColorsets\fP مراجعه کنید. .RE .sp $[math.+.,] $[math.\-.,] $[math.*.,] $[math./.,] $[math.%.,] $[math.^.,] $[math.<.,] $[math.>.,] .RS 4 متغیرهای بسط ریاضی را می‌توان برای انجام برخی محاسبات حسابی پایه روی اعداد صحیح و به کار برد. این عبارات می‌توانند برای جمع (+)، تفریق (\-)، ضرب (*)، تقسیم (/)، باقیمانده (%) و توان‌رسانی (^) استفاده شوند. بیشینه (>) مقدار بزرگ‌تر از دو مقدار، و کمینه (<) مقدار کوچک‌تر را بازمی‌گرداند. این قابلیت می‌تواند هنگام محاسبه اندازهٔ پانل‌ها یا مکان پنجره‌ها نسبت به یک مانیتور مفید باشد؛ برای مثال $[math.\-.$[monitor.$[monitor.primary].height],200] مقدار ۲۰۰ پیکسل را از ارتفاع مانیتور اصلی کم می‌کند. این عبارات همچنین می‌توانند برای عملیات‌های پیچیده‌تر به صورت تودرتو استفاده شوند، به عنوان نمونه $[math.+.$[math.*.3,5],$[math.\-.4,\-2]] با 21 جایگزین می‌شود. .sp ویرگول در "," برای فراهم کردن امکان استفاده از اعداد اعشاری در آینده است. تمام عملیات‌ها از محاسبات اعداد صحیح زبان C استفاده می‌کنند. حاصل تقسیم اعداد صحیح برابر با خارج‌قسمت است. از عملگر باقیمانده می‌توان برای به دست آوردن باقیماندهٔ تقسیم اعداد صحیح استفاده کرد. توجه داشته باشید که عملگر باقیمانده در C برای مقادیر منفی، باقیمانده‌های منفی بازمی‌گرداند. در نهایت، در صورتی که منفی باشد، عملیات توان مقدار 1 را برمی‌گرداند. .RE .sp $[schedule.last] .RS 4 این متغیر با شناسهٔ آخرین دستوری که توسط دستور \fBSchedule\fP زمان‌بندی شده بود جایگزین می‌شود، حتی اگر این دستور پیش‌تر اجرا شده باشد. .RE .sp $[schedule.next] .RS 4 این متغیر با شناسه‌ای جایگزین می‌شود که دستور بعدیِ استفاده‌شده با \fBSchedule\fP دریافت خواهد کرد (مگر اینکه شناسهٔ متفاوتی صراحتاً مشخص شده باشد). .RE .sp $[cond.rc] .RS 4 کد بازگشتی آخرین دستور شرطی. این متغیر فقط درون یک تابع معتبر است و نمی‌تواند درون یک دستور شرطی استفاده شود. لطفاً به بخش \fBConditional Commands\fP در فهرست دستورات مراجعه کنید. .RE .sp $[func.context] .RS 4 نویسهٔ بافت (context) دستور در حال اجرا، همان‌طور که در دستورهای \fBMouse\fP، \fBKey\fP یا \fBPointerKey\fP به کار می‌رود. این مقدار برای مثال در مورد زیر مفید است: .sp .if n .RS 4 .nf .fam C Mouse 3 FS N WindowShade $$[func.context] .fam .fi .if n .RE .RE .sp $[debuglog.state] .RS 4 یا \fI0\fP (گزارش اشکال‌زدایی بسته است) یا \fI1\fP. نشان‌دهندهٔ وضعیت فعلی سامانهٔ اشکال‌زدایی و گزارش‌گیری است. .RE .sp $[gt.\fIstr\fP] .RS 4 ترجمهٔ \fIstr\fP را با جستجو در کاتالوگ‌های محلی‌سازی (locale) فعلی بازمی‌گرداند. اگر ترجمه‌ای یافت نشود، \fIstr\fP به همان صورت اولیه بازگردانده می‌شود. دستور \fBLocalePath\fP را ببینید. .RE .sp $[infostore.\fIkey\fP] .RS 4 مقدار عنصر ذخیره‌شده در InfoStore را برای \fIkey\fP داده‌شده بازمی‌گرداند. اگر چنین کلیدی وجود نداشته باشد، رشتهٔ بسط‌نیافته بازگردانده می‌شود. .RE .sp $[.\|.\|.] .RS 4 اگر رشتهٔ درون براکت‌ها هیچ‌یک از موارد بالا نباشد، fvwm تلاش می‌کند تا متغیر محیطی‌ای با این نام پیدا کند و در صورت یافتن، مقدار آن را جایگزین می‌کند (مثلاً "$[PAGER]" می‌تواند با "more" جایگزین شود). در غیر این صورت رشته به همان شکل اولیه باقی می‌ماند. .sp چندین مثال را می‌توان در بخش توضیحات دستور \fBAddToFunc\fP یافت. .RE.SH "اسکریپت‌نویسی و توابع پیچیده (SCRIPTING AND COMPLEX FUNCTIONS)" .sp برای دستیابی به جلوه‌های پیچیده‌تر، fvwm دارای چندین دستور است که توانایی‌های اسکریپت‌نویسی آن را بهبود می‌بخشند. اسکریپت‌ها را می‌توان با \fBRead\fP از یک فایل، با \fBPipeRead\fP از خروجی یک دستور، یا با دستور \fBAddToFunc\fP به صورت یک تابع پیچیده خواند یا نوشت. برای علاقه‌مندان، بخش ۷ از FAQ مربوط به fvwm برخی از کاربردهای واقعی اسکریپت‌نویسی را نشان می‌دهد. لطفاً برای جزئیات به بخش‌های \fBUser Functions and Shell Commands\fP و \fBConditional Commands\fP مراجعه کنید. یک هشدار: در حین اجرای توابع پیچیده، fvwm نیاز دارد تمام ورودی‌ها را از اشاره‌گر ماوس دریافت کند (به اصطلاح سامانهٔ X، اشاره‌گر «grab» یا تسخیر می‌شود). در زمان اجرای یک تابع، هیچ برنامهٔ دیگری نمی‌تواند ورودی‌ای از اشاره‌گر دریافت کند. این امر ممکن است موجب سردرگمی برخی برنامه‌ها شود. برای مثال، برنامهٔ xwd در صورت اجرا از طریق یک تابع پیچیده، از گرفتن تصویر صفحه خودداری می‌کند. برای دستیابی به عملکردی مشابه، می‌توانید در عوض از دستورهای \fBRead\fP یا \fBPipeRead\fP استفاده کنید. .SH "مفاهیم و دستورهای منو (MENU CONCEPTS AND COMMANDS)" .sp لطفاً به صفحهٔ راهنمای fvwm3menus مراجعه کنید. .SH "فهرست دستورهای FVWM (LIST OF FVWM COMMANDS)" .sp لطفاً به صفحات راهنمای fvwm3commands و fvwm3styles مراجعه کنید. .SH "محیط (ENVIRONMENT)" .sp متغیرهای محیطی که بر نحوهٔ عملکرد fvwm تأثیر می‌گذارند عبارت‌اند از: .sp \fIDISPLAY\fP .RS 4 fvwm روی این نمایشگر اجرا می‌شود مگر آنکه گزینهٔ \fB\-display\fP مشخص شده باشد. .RE .sp \fIFVWM_USERDIR\fP .RS 4 برای تعیین دایرکتوری داده‌های کاربر جهت خواندن و نوشتن فایل‌ها به کار می‌رود. اگر این متغیر از پیش تنظیم نشده باشد، توسط fvwm روی \fI$HOME/.fvwm\fP تنظیم می‌شود که دایرکتوری پیش‌فرض داده‌های کاربر است. .RE .sp \fIFVWM3_LOGFILE\fP .RS 4 برای تعیین مسیر و نام فایل جهت ثبت گزارش اطلاعات اشکال‌زدایی از fvwm3 استفاده می‌شود. به‌طور پیش‌فرض، گزارش اشکال‌زدایی در \fI$FVWM_USERDIR\fP/fvwm3\-output.log نوشته می‌شود. اگر یک مسیر مطلق مشخص شده باشد (که با / آغاز می‌شود)، آنگاه \fI$FVWM_USERDIR\fP نادیده گرفته می‌شود؛ در غیر این صورت گزارش در \fI$FVWM_USERDIR\fP/\fI$FVWM3_LOGFILE\fP نوشته خواهد شد. .RE .sp \fIFVWM_DATADIR\fP .RS 4 توسط fvwm روی دایرکتوری حاوی داده‌های پیکربندی و ماژول‌های fvwm تنظیم می‌شود. .RE .sp \fIFVWM_MODULEDIR\fP .RS 4 توسط fvwm روی دایرکتوری حاوی ماژول‌های استاندارد fvwm تنظیم می‌شود. .RE .sp \fISESSION_MANAGER\fP .RS 4 fvwm تلاش می‌کند با این مدیر نشست ارتباط برقرار کند. .RE .sp \fISESSION_MANAGER_NAME\fP .RS 4 این متغیر عمدتاً برای تشخیص اجرای xsm جهت دور زدن باگ آن به کار می‌رود. اگر این متغیر روی "xsm" تنظیم شده باشد، DiscardCommand آن‌گونه که xsm انتظار دارد تنظیم می‌شود و نه آن‌طور که XSMP نیاز دارد. اگر fvwm را تحت xsm اجرا می‌کنید، باید این متغیر را روی "xsm" قرار دهید، در غیر این صورت فایل‌های وضعیت قدیمی حذف نمی‌شوند. .RE .sp \fISM_SAVE_DIR\fP .RS 4 در صورت تنظیم بودن، fvwm داده‌های نشست خود را در این دایرکتوری ذخیره می‌کند. در غیر این صورت از \fI$HOME\fP استفاده خواهد کرد. توجه داشته باشید که نام فایل‌های وضعیت به‌صورت \fI.fs\-??????\fP است و معمولاً هنگامی که دیگر کاربردی نداشته باشند، به‌طور خودکار حذف می‌شوند. .RE .SH "نویسندگان (AUTHORS)" .sp Robert Nation با کمک افراد بسیار، بر پایهٔ کد twm که توسط Tom LaStrange نوشته شده بود. پس از Robert Nation نوبت به Charles Hines رسید و سپس Brady Montz. در حال حاضر fvwm توسط تعدادی از افراد در فهرست پستی fvwm\-workers توسعه می‌یابد. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .sp نرم‌افزار fvwm و تمامی ماژول‌ها، اسکریپت‌ها و فایل‌های دیگر ارائه‌شده همراه با این توزیع، تحت مجوز عمومی همگانی گنو (GPL) منتشر می‌شوند. لطفاً برای جزئیات به فایل COPYING ارائه‌شده همراه fvwm مراجعه کنید. .SH "گزارش باگ‌ها (BUGS)" .sp گزارش‌های اشکال را می‌توان به فهرست پستی fvwm\-workers به نشانی زیر ارسال کرد: \c .MTO "fvwm\-workers\(atfvwm.org" "" "" .sp صفحهٔ خانگی رسمی fvwm: \c .URL "http://fvwm.org" "" ""