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     نمایش نسخه.

FreeType 2.14.3                   March 2026                        FTBENCH(1)