'\" t
.TH FTBENCH 1 "March 2026" "FreeType 2.14.3"
.
.
.SH "نام (NAME)"
.
ftbench \- ارزیابی کارایی و بنچمارک عملیات متداول FreeType
.
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.B ftbench
.RI [ گزینه‌ها ]
.I نام_فونت
.
.
.SH "توضیحات (DESCRIPTION)"
.
ابزار
.B ftbench
کارایی برخی از عملیات متداول FreeType را ارزیابی و اندازه‌گیری می‌کند.
.
.PP
این برنامه بخشی از بسته نمونه‌های FreeType (demos) است.
.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.BI \-a \ axis1 , axis2 , .\|.\|.
برای فونت‌های متغیر Multiple Master، GX یا OpenType، مختصات طراحی را برای هر محور در زمان راه‌اندازی مشخص می‌کند.
برای سایر قالب‌های فونت نادیده گرفته می‌شود.
.
.TP
.BI \-b \ tests
اجرای آزمون‌های انتخاب‌شده:
.
.RS
.TS
tab (@);
rB l.
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@باز کردن فیس جدید و بارگذاری گلیف‌ها
.TE
.RE
.
.IP
(پیش‌فرض
.BR abcdefghijkl
است، یعنی تمام آزمون‌ها).
.
.IP
تعداد گلیف‌های استفاده‌شده در هر آزمون (درون یک تکرار واحد) با گزینه
.B \-i
مشخص می‌شود.
.
.TP
.B \-C
مقایسه با نسخه ذخیره‌شده در حافظه پنهان (Cache) در صورت وجود.
.
.TP
.BI \-c \ N
استفاده از حداکثر
.I N
تکرار برای هر آزمون (مقدار 0 به معنای محدودیت زمانی است).
.
.TP
.BI \-e \ E
استفاده از نقشه کاراکتر (Charmap) با شاخص
.I E
به جای یونیکد پیش‌فرض.
.
.TP
.BI \-f \ L
استفاده از عدد
.B هگزادسیمال
(نه ده‌دهی)
.I L
به عنوان فلگ‌های بارگذاری (ماکروهای
.RB ` \%FT_\:LOAD_\:XXX '
را در مستندات مرجع FreeType ببینید).
.
.TP
.BI "\-H " name
استفاده از موتور هینتینگ CFF با نام
.IR name .
نسخه‌های موجود بستگی به گزینه‌های کامپایل FreeType دارند؛
برای دریافت فهرست واقعی،
.B ftbench
را بدون آرگومان اجرا کنید.
.
.TP
.BI "\-I " ver
استفاده از نسخه مفسر TrueType به شماره
.IR ver .
نسخه‌های موجود بستگی به گزینه‌های کامپایل FreeType دارند؛
برای دریافت فهرست واقعی،
.B ftbench
را بدون آرگومان اجرا کنید.
.
.TP
.BI \-i \ I-J
محدوده مستقیم یا معکوس شاخص‌های گلیف برای استفاده
(پیش‌فرض از 0 تا تعداد کل گلیف‌ها منهای یک است).
.
.TP
.BI \-m \ M
تنظیم حداکثر اندازه حافظه پنهان بر حسب کیلوبایت (KiByte) روی
.I M
(پیش‌فرض 1024 است).
.
.TP
.B \-p
پیش‌بارگذاری فایل فونت در حافظه رم (یعنی آزمودن
.B \%FT_\:New_\:Memory_\:Face
به جای
.BR \%FT_\:New_\:Face ).
.
.TP
.BI \-r \ R
تنظیم حالت رندر روی
.IR R :
.
.RS
.TS
tab (@);
rB l.
0@عادی (normal)
1@روشن/ملایم (light)
2@تک‌رنگ (mono)
3@نمایشگر LCD افقی
4@نمایشگر LCD عمودی
.TE
.RE
.
.IP
(پیش‌فرض 0 است).
این مقادیر متناظر با مقادیر فلگ‌های
.RB ` \%FT_\:RENDER_\:MODE_\:XXX '
هستند.
.
.TP
.BI \-s \ S
استفاده از
.I S
ppem به عنوان اندازه فیس (پیش‌فرض 10ppem است).
اگر روی صفر تنظیم شود، تابع
.B \%FT_\:Set_\:Pixel_\:Sizes
فراخوانی نمی‌شود.
برای بارگذاری گلیف‌ها به صورت مقیاس‌بندی‌نشده (Unscaled) از مقدار 0 به همراه گزینه
.RB ` "-f\ 1" '
یا مشابه آن استفاده کنید، در غیر این صورت خطا رخ خواهد داد.
.
.TP
.BI \-t \ T
استفاده از حداکثر
.I T
ثانیه برای هر آزمون (پیش‌فرض 2 است).
.
.TP
.B \-v
نمایش نسخه.
.
.\" eof