.\" Manpage for mangohud.
.TH mangohud 1 "" "" "mangohud"

.SH "نام (NAME)"
mangohud \- فعال‌سازی MangoHud روی هر برنامه‌ای

.SH "خلاصه دستور (SYNOPSIS)"
\fBmangohud\fR [--dlsym] COMMAND

.SH "توضیحات (DESCRIPTION)"
‏MangoHud یک لایه نمایش وضعیت (overlay) برای Vulkan/OpenGL جهت پایش نرخ فریم (FPS)، دماها، بار کاری CPU/GPU و موارد دیگر است.

.SH "نحوه استفاده (USAGE)"
می‌توان MangoHud را برای برنامه‌های Vulkan با تنظیم متغیر محیطی \fBMANGOHUD=1\fR فعال کرد.
.br
برای بارگذاری MangoHud روی هر برنامه‌ای، از جمله برنامه‌های OpenGL، می‌توان از فایل اجرایی \fBmangohud\fR استفاده کرد. این دستور یک کتابخانه را از طریق ld در برنامه پیش‌بارگذاری می‌کند.
.br
نکته: برخی برنامه‌های OpenGL ممکن است به قلاب‌کردن (hooking) با dlsym نیز نیاز داشته باشند. این کار را می‌توان با ارسال گزینه \fB--dlsym\fR یا با تنظیم متغیر محیطی \fBMANGOHUD_DLSYM=1\fR انجام داد.

.SH "پیکربندی (CONFIG)"
‏MangoHud همراه با یک فایل پیکربندی ارائه می‌شود که می‌توان از آن برای تنظیم گزینه‌های پیکربندی به‌صورت سراسری یا به ازای هر برنامه استفاده کرد. اولویت فایل‌های پیکربندی مختلف به ترتیب زیر است:
.LP
.RS 4
/path/to/application/MangoHud.conf
.br
$XDG_CONFIG_HOME/MangoHud/{application_name}.conf
.br
$XDG_CONFIG_HOME/MangoHud/MangoHud.conf
.RS -4
.LP
یک نمونه فایل پیکربندی شامل تمام گزینه‌های موجود در مسیر /usr/share/doc/mangohud/MangoHud.conf قرار دارد.
.LP
همچنین می‌توان مسیر دلخواه فایل پیکربندی را با استفاده از متغیر محیطی \fBMANGOHUD_CONFIGFILE\fR مشخص کرد.
.br
گزینه‌های پیکربندی را می‌توان با متغیر محیطی \fBMANGOHUD_CONFIG\fR نیز تنظیم کرد. این متغیر بر هر فایل پیکربندی اولویت دارد.

.SH "مثال‌ها (EXAMPLES)"
در OpenGL: \fBmangohud glxgears\fR
.br
در Vulkan: \fBMANGOHUD=1 vkcube\fR
.br
در Steam: گزینه راه‌اندازی (launch option) خود را به \fBmangohud %command%\fR تنظیم کنید
.br
در Lutris: مقدار \fBmangohud\fR را به تنظیمات Command prefix اضافه کنید
.br
در OpenGL همراه با dlsym: \fBmangohud --dlsym glxgears\fR
.br
گزینه‌های پیکربندی سفارشی: \fBMANGOHUD_CONFIG="gpu_stats=0,font_size=12" mangohud glxgears\fR

.SH "درباره (ABOUT)"
توسعه MangoHud در نشانی \fIhttps://github.com/flightlessmango/MangoHud\fR انجام می‌شود.
.br
بنچمارک‌های ثبت‌شده با MangoHud را می‌توان در \fIhttps://flightlessmango.com\fR بارگذاری کرد.