mangohud(1) mangohud mangohud(1)

mangohud - فعال‌سازی MangoHud روی هر برنامه‌ای

mangohud [--dlsym] COMMAND

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

می‌توان MangoHud را برای برنامه‌های Vulkan با تنظیم متغیر محیطی MANGOHUD=1 فعال کرد.
برای بارگذاری MangoHud روی هر برنامه‌ای، از جمله برنامه‌های OpenGL، می‌توان از فایل اجرایی mangohud استفاده کرد. این دستور یک کتابخانه را از طریق ld در برنامه پیش‌بارگذاری می‌کند.
نکته: برخی برنامه‌های OpenGL ممکن است به قلاب‌کردن (hooking) با dlsym نیز نیاز داشته باشند. این کار را می‌توان با ارسال گزینه --dlsym یا با تنظیم متغیر محیطی MANGOHUD_DLSYM=1 انجام داد.

‏MangoHud همراه با یک فایل پیکربندی ارائه می‌شود که می‌توان از آن برای تنظیم گزینه‌های پیکربندی به‌صورت سراسری یا به ازای هر برنامه استفاده کرد. اولویت فایل‌های پیکربندی مختلف به ترتیب زیر است:

/path/to/application/MangoHud.conf
$XDG_CONFIG_HOME/MangoHud/{application_name}.conf
$XDG_CONFIG_HOME/MangoHud/MangoHud.conf

یک نمونه فایل پیکربندی شامل تمام گزینه‌های موجود در مسیر /usr/share/doc/mangohud/MangoHud.conf قرار دارد.

همچنین می‌توان مسیر دلخواه فایل پیکربندی را با استفاده از متغیر محیطی MANGOHUD_CONFIGFILE مشخص کرد.
گزینه‌های پیکربندی را می‌توان با متغیر محیطی MANGOHUD_CONFIG نیز تنظیم کرد. این متغیر بر هر فایل پیکربندی اولویت دارد.

در OpenGL: mangohud glxgears
در Vulkan: MANGOHUD=1 vkcube
در Steam: گزینه راه‌اندازی (launch option) خود را به mangohud %command% تنظیم کنید
در Lutris: مقدار mangohud را به تنظیمات Command prefix اضافه کنید
در OpenGL همراه با dlsym: mangohud --dlsym glxgears
گزینه‌های پیکربندی سفارشی: MANGOHUD_CONFIG="gpu_stats=0,font_size=12" mangohud glxgears

توسعه MangoHud در نشانی https://github.com/flightlessmango/MangoHud انجام می‌شود.
بنچمارک‌های ثبت‌شده با MangoHud را می‌توان در https://flightlessmango.com بارگذاری کرد.