| FTBENCH(1) | General Commands Manual | FTBENCH(1) |
نام (NAME)
ftbench - ارزیابی کارایی و بنچمارک عملیات متداول FreeType
خلاصه دستور (SYNOPSIS)
ftbench [گزینه‌ها] نام_فونت
توضیحات (DESCRIPTION)
ابزار ftbench کارایی برخی از عملیات متداول FreeType را ارزیابی و اندازه‌گیری می‌کند.
این برنامه بخشی از بسته نمونه‌های FreeType (demos) است.
گزینه‌ها (OPTIONS)
- -a axis1,axis2,...
- برای فونت‌های متغیر Multiple Master، GX یا OpenType، مختصات طراحی را برای هر محور در زمان راه‌اندازی مشخص می‌کند. برای سایر قالب‌های فونت نادیده گرفته می‌شود.
- -b tests
- اجرای آزمون‌های انتخاب‌شده:
| a | بارگذاری گلیف‌ها (FT_Load_Glyph) |
| b | بارگذاری عرض‌های پیشروی (FT_Get_Advances) |
| c | رندر گلیف‌ها (FT_Render_Glyph) |
| d | بارگذاری گلیف‌ها (FT_Get_Glyph) |
| e | دریافت شاخص‌های گلیف (FT_Get_Char_Index) |
| f | پیمایش CMap (FT_Get_{First,Next}_Char) |
| g | باز کردن فیس جدید (FT_New_Face یا FT_New_Memory_Face) |
| h | پررنگ کردن گلیف‌ها (FT_GlyphSlot_Embolden) |
| i | خط‌کشی/استروک گلیف‌ها (FT_Glyph_Stroke) |
| j | دریافت کادرهای احاطه‌کننده گلیف (FT_Outline_Get_BBox) |
| k | دریافت جعبه‌های کنترل گلیف (FT_Glyph_Get_CBox) |
| l | باز کردن فیس جدید و بارگذاری گلیف‌ها |
- (پیش‌فرض abcdefghijkl است، یعنی تمام آزمون‌ها).
- تعداد گلیف‌های استفاده‌شده در هر آزمون (درون یک تکرار واحد) با گزینه -i مشخص می‌شود.
- -C
- مقایسه با نسخه ذخیره‌شده در حافظه پنهان (Cache) در صورت وجود.
- -c N
- استفاده از حداکثر N تکرار برای هر آزمون (مقدار 0 به معنای محدودیت زمانی است).
- -e E
- استفاده از نقشه کاراکتر (Charmap) با شاخص E به جای یونیکد پیش‌فرض.
- -f L
- استفاده از عدد هگزادسیمال (نه ده‌دهی) L به عنوان فلگ‌های بارگذاری (ماکروهای `FT_LOAD_XXX' را در مستندات مرجع FreeType ببینید).
- -H name
- استفاده از موتور هینتینگ CFF با نام name. نسخه‌های موجود بستگی به گزینه‌های کامپایل FreeType دارند؛ برای دریافت فهرست واقعی، ftbench را بدون آرگومان اجرا کنید.
- -I ver
- استفاده از نسخه مفسر TrueType به شماره ver. نسخه‌های موجود بستگی به گزینه‌های کامپایل FreeType دارند؛ برای دریافت فهرست واقعی، ftbench را بدون آرگومان اجرا کنید.
- -i I-J
- محدوده مستقیم یا معکوس شاخص‌های گلیف برای استفاده (پیش‌فرض از 0 تا تعداد کل گلیف‌ها منهای یک است).
- -m M
- تنظیم حداکثر اندازه حافظه پنهان بر حسب کیلوبایت (KiByte) روی M (پیش‌فرض 1024 است).
- -p
- پیش‌بارگذاری فایل فونت در حافظه رم (یعنی آزمودن FT_New_Memory_Face به جای FT_New_Face).
- -r R
- تنظیم حالت رندر روی R:
| 0 | عادی (normal) |
| 1 | روشن/ملایم (light) |
| 2 | تک‌رنگ (mono) |
| 3 | نمایشگر LCD افقی |
| 4 | نمایشگر LCD عمودی |
- (پیش‌فرض 0 است). این مقادیر متناظر با مقادیر فلگ‌های `FT_RENDER_MODE_XXX' هستند.
- -s S
- استفاده از S ppem به عنوان اندازه فیس (پیش‌فرض 10ppem است). اگر روی صفر تنظیم شود، تابع FT_Set_Pixel_Sizes فراخوانی نمی‌شود. برای بارگذاری گلیف‌ها به صورت مقیاس‌بندی‌نشده (Unscaled) از مقدار 0 به همراه گزینه `-f 1' یا مشابه آن استفاده کنید، در غیر این صورت خطا رخ خواهد داد.
- -t T
- استفاده از حداکثر T ثانیه برای هر آزمون (پیش‌فرض 2 است).
- -v
- نمایش نسخه.
| March 2026 | FreeType 2.14.3 |