'\" t
.\"     Title: FvwmAnimate
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-28
.\"    Manual: Fvwm Modules
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "FVWMANIMATE" "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)"
FvwmAnimate \- ماژول متحرک‌سازی و پویانمایی پنجره‌ها در fvwm
.SH "خلاصه دستور (SYNOPSIS)"
.sp
Module FvwmAnimate [ModuleAlias]
.sp
\fBFvwmAnimate\fP فقط می‌تواند توسط fvwm فراخوانی شود. اجرای ماژول FvwmAnimate از خط فرمان کار نخواهد کرد.
.sp
از درون فایل .fvwm2rc، ماژول \fBFvwmAnimate\fP به صورت زیر اجرا می‌شود:
.sp
.if n .RS 4
.nf
.fam C
Module FvwmAnimate
.fam
.fi
.if n .RE
.sp
یا از درون یک منوی جهنده (pop\-up) در fvwm:
.sp
.if n .RS 4
.nf
.fam C
DestroyMenu Module\-Popup
AddToMenu\&   Module\-Popup "Modules" Title
+ "Fvwm Animate Icons" Module FvwmAnimate ModuleAlias
.fam
.fi
.if n .RE
.SH "توضیحات (DESCRIPTION)"
.sp
ماژول \fBFvwmAnimate\fP عمل تبدیل به آیکون (کوچک‌سازی) و بازگشت از آیکون (بزرگ‌سازی) پنجره‌ها یا پویانمایی بر اساس دستور را متحرک‌سازی می‌کند. در حال حاضر ۶ جلوه پویانمایی مختلف وجود دارد.
.SH "نحوه فراخوانی (INVOCATION)"
.sp
\fBFvwmAnimate\fP باید توسط مدیر پنجره \fBfvwm\fP فراخوانی شود. هنگامی که با آرگومان \fIOptionalName\fP فراخوانی شود، از \fIModuleAlias\fP به جای "FvwmAnimate" برای یافتن دستورات پیکربندی، فایل‌های پیکربندی و نام‌گذاری منوها و فرم‌های تولیدشده داخلی استفاده می‌شود. در هنگام راه‌اندازی، FvwmAnimate منوها و فرم‌هایی را برای پیکربندی و کنترل FvwmAnimate تعریف می‌کند. نام پیش‌فرض منو "MenuFvwmAnimate" و نام فرم "FormFvwmAnimate" است. اگر نام اختیاری استفاده شود، منو "Menu<ModuleAlias>" و فرم "Form<ModuleAlias>" خواهد بود.
.sp
با فرض اینکه از قبل یک منوی توکار به نام "Module\-Popup" داشته‌اید، می‌توانید FvwmAnimate را با پیکربندی زیر استفاده کنید:
.sp
.if n .RS 4
.nf
.fam C
AddToFunc "StartFunction" "I" Module FvwmAnimate
AddToMenu "Module\-Popup" "Control Animation" Popup MenuFvwmAnimate
.fam
.fi
.if n .RE
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.sp
از آنجا که منوی جهنده "MenuFvwmAnimate" امکان کنترل کامل ماژول \fBFvwmAnimate\fP را فراهم می‌کند، واقعاً نیازی نیست بدانید که هر یک از دستورات پیکربندی چه هستند. با این حال، این بخش آن‌ها را شرح می‌دهد.
.sp
ماژول \fBFvwmAnimate\fP اطلاعات پیکربندی را از پایگاه داده پیکربندی ماژول‌های \fBfvwm\fP دریافت می‌کند (به \fIfvwm\fP(1)، بخش \fBدستورات ماژول (MODULE COMMANDS)\fP مراجعه کنید). علاوه بر این، \fBFvwmAnimate\fP فایل $HOME/.FvwmAnimate را می‌خواند و در حین اجرا، دستورات fvwm و ماژول‌های آن را می‌پذیرد.
.sp
اگر از \fIModuleAlias\fP برای راه‌اندازی FvwmAnimate استفاده شود، نام اختیاری در تمام دستورات، پیام‌ها، منوها و فرم‌های تولیدشده توسط FvwmAnimate و در نام فایل پیکربندی استفاده می‌شود. برخلاف سایر ماژول‌های fvwm، دلیل چندانی برای استفاده از نام اختیاری وجود ندارد.
.sp
*FvwmAnimate: Color color
.RS 4
به \fBFvwmAnimate\fP می‌گوید با چه رنگی رسم کند. رنگ روی پس‌زمینه به‌صورت "XOR" (یا انحصاری) اعمال می‌شود. بسته به نوع نمایشگری که استفاده می‌کنید، جلوه‌ای که ایجاد می‌شود متفاوت خواهد بود. به‌ویژه در نمایشگرهای ۸ بیتی، یکدست بودن رنگ پس‌زمینه کمک می‌کند. باید با این گزینه آزمایش کنید تا نحوه عملکرد آن را ببینید.
.sp
رنگ پیش‌فرض یک رنگ واقعی نیست و می‌تواند به صورت "Black^White" یا به شکل ساده‌تر "None" وارد شود. این همان ماسک XOR پیش‌فرضی است که fvwm برای کادرهای جابه‌جایی و تغییر اندازه استفاده می‌کند.
.sp
سایر رنگ‌ها را می‌توان با استفاده از نمادگذاری استاندارد رنگ در X مشخص کرد؛ یعنی نام‌های رنگ مانند "LightBlue" یا مقادیر RGB مانند "#FFFFFF".
.RE
.sp
*FvwmAnimate: Pixmap pixmap
.RS 4
به \fBFvwmAnimate\fP می‌گوید از \fBpixmap\fP برای رسم استفاده کند. این گزینه در صورتی که \fB*FvwmAnimate: Color\fP نتایج ضعیفی بدهد می‌تواند مفید باشد.
.RE
.sp
*FvwmAnimate: Delay msecs
.RS 4
به \fBFvwmAnimate\fP می‌گوید چند میلی‌ثانیه بین فریم‌های پویانمایی مکث کند.
.RE
.sp
*FvwmAnimate: Iterations iterations
.RS 4
به \fBFvwmAnimate\fP می‌گوید پویانمایی را به چند مرحله بشکند.
.RE
.sp
*FvwmAnimate: Twist twist
.RS 4
به \fBFvwmAnimate\fP می‌گوید کادر آیکون‌سازی را چند دور بتاباند (بچرخاند).
.RE
.sp
*FvwmAnimate: Width width
.RS 4
به \fBFvwmAnimate\fP می‌گوید خطوط را با چه ضخامتی رسم کند. ضخامت پیش‌فرض 0 (صفر) یک خط سریع با ضخامت ۱ است.
.RE
.sp
*FvwmAnimate: Effect mode
.RS 4
به \fBFvwmAnimate\fP می‌گوید از کدام جلوه پویانمایی استفاده کند. در حال حاضر جلوه‌ها عبارتند از: \fIFrame\fP، \fILines\fP، \fIFlip\fP، \fITurn\fP، \fIZoom3D\fP، \fITwist\fP، \fIRandom\fP و \fINone\fP. مقدار \fINone\fP معمولاً در فایل پیکربندی تنظیم می‌شود، برای مواقعی که FvwmAnimate به طور خودکار راه‌اندازی می‌شود اما یک کاربر خاص نمی‌خواهد آن را اجرا کند.
.RE
.sp
*FvwmAnimate: Stop
.RS 4
به \fBFvwmAnimate\fP دستور توقف می‌دهد.
.RE
.sp
*FvwmAnimate: Save
.RS 4
به \fBFvwmAnimate\fP می‌گوید پیکربندی فعلی را در فایلی به نام ".FvwmAnimate" در دایرکتوری خانگی کاربر ذخیره کند. همین فایل هنگام راه‌اندازی FvwmAnimate به طور خودکار خوانده می‌شود.
.RE
.SH "دستورات (COMMANDS)"
.sp
می‌توان از طریق دستور "SendToModule" از \fBFvwmAnimate\fP خواست تا یک پویانمایی ایجاد کند. قالب این دستور به صورت زیر است:
.sp
.if n .RS 4
.nf
.fam C
SendToModule FvwmAnimate animate sx sy sw sh dx dy dw dh
.fam
.fi
.if n .RE
.sp
کلمه دوم باید با نامی که \fBFvwmAnimate\fP با آن راه‌اندازی شده مطابقت داشته باشد. ۸ فیلد پس از \fIanimate\fP باید عدد باشند. ۴ عدد اول برای موقعیت مبدأ (یا نقطه شروع) پویانمایی هستند. ۴ عدد آخر برای مقصد پویانمایی هستند. این ۲ جفت عدد ۴تایی، نمایانگر مستطیل‌ها هستند. ۲ عدد اول، موقعیت x و y گوشه بالا-راست هستند. ۲ عدد بعدی، عرض و ارتفاع هستند. یک یا چند فاصله می‌توانند فیلدها را در دستور از یکدیگر جدا کنند.
.sp
ماژول‌ها می‌توانند از دستور "SendToModule" برای متحرک‌سازی پنجره‌های بدون آیکون ("NoIcon") استفاده کنند، یا می‌توانید روش‌های دلخواه خود را برای بهره‌گیری متنوع از این دستور بیابید.
.sp
دستورات اضافی موجود عبارتند از: \fIpause\fP، \fIplay\fP، \fIpush\fP، \fIpop\fP و \fIreset\fP. این دستورات ممکن است با فاصله از هم جدا شوند.
.sp
دستور \fIpause\fP باعث می‌شود ماژول موقتاً هیچ پویانمایی تولید نکند. \fIplay\fP باعث می‌شود ماژول مجدداً پویانمایی ایجاد کند. \fIpush\fP وضعیت پخش فعلی را برای آینده ذخیره می‌کند و \fIpop\fP آن را بازیابی می‌نماید. \fIreset\fP تمام وضعیت‌های ذخیره‌شده را حذف کرده و پخش را فعال می‌کند.
.sp
فرض کنید نمی‌خواهیم منتظر بمانیم تا تمام ۴۰ پنجره xterm متحرک‌سازی شوند:
.sp
.if n .RS 4
.nf
.fam C
SendToModule FvwmAnimate pause
All (XTerm) Iconify on
.fam
.fi
.if n .RE
.sp
و اگر نخواهیم به وضعیت پخش فعلی آسیبی برسد:
.sp
.if n .RS 4
.nf
.fam C
SendToModule FvwmAnimate push pause
All (XTerm) Iconify on
SendToModule FvwmAnimate pop
.fam
.fi
.if n .RE
.SH "خاستگاه (ORIGIN)"
.sp
ماژول \fBFvwmAnimate\fP بر پایه ماژول \fBAnimate\fP از Afterstep 1.5pre6 توسعه یافته است. پورت کردن به \fBfvwm\fP و بسیاری تغییرات دیگر توسط \fIDan Espen\fP
\c
.MTO "despen\(attelcordia.com" "" "."
انجام شد. در ادامه نویسنده اصلی و قدردانی‌ها آمده است.
.SH "نویسنده (AUTHOR)"
.sp
\fIAlfredo Kengi Kojima\fP \c
.MTO "kojima\(atinf.ufrgs.br" "" ""
.SH "قدردانی‌ها (ACKNOWLEDGMENTS)"
.sp
افراد زیر در توسعه \fBFvwmAnimate\fP مشارکت داشته‌اند:
.sp
Kaj Groner \c
.MTO "kajg\(atmindspring.com" "" ""
.RS 4
پویانمایی چرخشی، تجزیه فایل پیکربندی، صفحه راهنما.
.RE
.sp
Frank Scheelen \c
.MTO "scheelen\(atworldonline.nl" "" ""
.RS 4
.RE