HB-RASTER(1) User Commands HB-RASTER(1)

hb-raster - رسترایز کردن و رندر گلیف‌های فونت با HarfBuzz

hb-raster [گزینه‌ها] [فایل-فونت] [متن]

رسترایز کردن متن با فونت داده‌شده.

نمایش گزینه‌های راهنما
نمایش همه گزینه‌های راهنما
گزینه‌های مربوط به چهره قلم (font face)
گزینه‌های مربوط به نمونه قلم (font instance)
گزینه‌های مربوط به متغیرهای فونت (variations) استفاده‌شده
گزینه‌های مربوط به متن ورودی
گزینه‌های مربوط به متن زمینه ورودی
گزینه‌های مربوط به فرآیند شکل‌دهی (shaping)
گزینه‌های مربوط به ویژگی‌های فونت (OpenType features) استفاده‌شده
گزینه‌های مربوط به مقصد و قالب خروجی
گزینه‌های مربوط به رندر و نمایش خروجی

تنظیم نام فایل فونت
تنظیم نمایه چهره قلم (پیش‌فرض: 0)
تنظیم بارگذار چهره قلم برای استفاده (پیش‌فرض: ot)
بارگذارهای پشتیبانی‌شده عبارتند از: ot/ft
فهرست کردن بارگذارهای چهره قلم در دسترس و خروج

اندازه فونت (پیش‌فرض: 256)
تنظیم پیکسل بر EM در راستای x و y (پیش‌فرض: 0؛ غیرفعال)
تنظیم اندازه پوینت فونت (پیش‌فرض: 0؛ غیرفعال)
تنظیم ضخامت مصنوعی (synthetic bold) (پیش‌فرض: 0)
تنظیم درجه مصنوعی (synthetic grade) (پیش‌فرض: 0)
تنظیم شیب مصنوعی (synthetic slant) (پیش‌فرض: 0)
تنظیم پیاده‌سازی توابع فونت برای استفاده (پیش‌فرض: ot)
پیاده‌سازی‌های پشتیبانی‌شده توابع فونت عبارتند از: ot/ft
فهرست کردن توابع فونت در دسترس و خروج
تنظیم پرچم‌های بارگذاری FreeType (پیش‌فرض: 2)

تنظیم نمایه نمونه نام‌گذاری‌شده (پیش‌فرض: none)
فهرست جداشده با کاما از متغیرهای فونت
متغیرها به صورت سراسری تنظیم می‌شوند. قالب مشخص کردن تنظیمات متغیر در ادامه آمده است. تمام مقادیر معتبر font-variation-settings در CSS غیر از 'normal' و 'inherited' نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند.
قالب به صورت یک برچسب، اختیاری به همراه علامت مساوی، و به دنبال آن یک عدد است. برای مثال:
"wght=500" "slnt=-7.5"

اگر متنی ارائه نشود، ورودی استاندارد (stdin) استفاده می‌شود.

تنظیم متن ورودی
تنظیم نام فایل متن ورودی
تنظیم نقاط کد یونیکد ورودی
برخورد با متن به عنوان یک پاراگراف واحد

تنظیم متن زمینه پیش از هر خط
تنظیم متن زمینه پس از هر خط
تنظیم زمینه نقاط کد یونیکد پیش از هر خط
تنظیم زمینه نقاط کد یونیکد پس از هر خط

تنظیم شکل‌دهنده‌ها برای استفاده (پیش‌فرض: graphite2,ot,fallback)
شکل‌دهنده‌های پشتیبانی‌شده عبارتند از: graphite2/ot/fallback
فهرست کردن شکل‌دهنده‌های در دسترس و خروج
تنظیم جهت متن (پیش‌فرض: auto)
تنظیم زبان متن (پیش‌فرض: $LANG)
تنظیم خط/اسکریپت متن (پیش‌فرض: auto)
برخورد با متن به عنوان ابتدای پاراگراف (beginning-of-paragraph)
برخورد با متن به عنوان انتهای پاراگراف (end-of-paragraph)
حفظ نویسه‌های نادیده‌گرفتنی پیش‌فرض (Default-Ignorable)
حذف نویسه‌های نادیده‌گرفتنی پیش‌فرض (Default-Ignorable)
مقدار گلیف برای جایگزینی نویسه‌های Default-Ignorable
مقدار گلیف برای جایگزینی نویسه‌های یافت‌نشده
مقدار گلیف برای جایگزینی نویسه‌های گزینش‌گر متغیر (variation-selector) یافت‌نشده
استفاده از نمایه‌های بایتی UTF8 به جای نمایه‌های نویسه‌ای
سطح ادغام خوشه‌ها (cluster merging level) (پیش‌فرض: 0)
مرتب‌سازی مجدد خوشه‌های گلیف به ترتیب اسمی (nominal order)
تولید پرچم گلیف ناامن برای الحاق (unsafe-to-concat)
تولید پرچم گلیف امن برای درج تطویل/کشش (safe-to-insert-tatweel)
تفسیر ورودی به عنوان رشته گلیف
انجام بررسی‌های صحت‌سنجی روی نتایج شکل‌دهی

فهرست جداشده با کاما از ویژگی‌های فونت
ویژگی‌ها را می‌توان به صورت سراسری یا محدود به محدوده‌های نویسه‌ای خاص فعال یا غیرفعال کرد. قالب مشخص کردن تنظیمات ویژگی در ادامه آمده است. تمام مقادیر معتبر font-feature-settings در CSS غیر از 'normal' و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. توالی‌های گریز رشته‌ای CSS پشتیبانی نمی‌شوند. نمایه‌های محدوده به موقعیت‌های بین نویسه‌های یونیکد اشاره دارند، مگر اینکه --utf8-clusters ارائه شده باشد که در این صورت نمایه‌های محدوده به نمایه‌های بایتی UTF-8 اشاره می‌کنند. موقعیت پیش از نخستین نویسه همواره 0 است.
قالب مشابه پایتون (Python-esque) است.
نحوه کار به شرح زیر است:
Value: Start: End:
Setting value:
"kern"
1 0 ??? # Turn feature on
"+kern"
1 0 ??? # Turn feature on
"-kern"
0 0 ??? # Turn feature off
"kern=0"
0 0 ??? # Turn feature off
"kern=1"
1 0 ??? # Turn feature on
"aalt=2"
2 0 ??? # Choose 2nd alternate
Setting index:
"kern[]"
1 0 ??? # Turn feature on
"kern[:]"
1 0 ??? # Turn feature on
"kern[5:]"
1 5 ??? # Turn feature on, partial
"kern[:5]"
1 0 5 # Turn feature on, partial
"kern[3:5]"
1 3 5 # Turn feature on, range
"kern[3]"
1 3 3+1 # Turn feature on, single char
Mixing it all:
"aalt[3:5]=2" 2
3 5 # Turn 2nd alternate on for range

تنظیم نام فایل خروجی (پیش‌فرض: stdout)
تنظیم قالب خروجی (پیش‌فرض: png)
قالب‌های خروجی پشتیبانی‌شده عبارتند از: png/ppm/ansi

تنظیم رنگ پس‌زمینه (پیش‌فرض: #FFFFFF)؛ از "none" برای شفاف استفاده کنید
تنظیم رنگ پیش‌زمینه (پیش‌فرض: #000000)
چرخش رنگ‌های پیش‌زمینه گلیف میان یک پالت پیش‌فرض
تنظیم پالت فونت (پیش‌فرض: 0)
پالت سفارشی
تنظیم فاصله میان خطوط (پیش‌فرض: 0)
تنظیم فراز/فرود/فاصله خطوط فونت (ascent/descent/line-gap) (پیش‌فرض: auto)
حاشیه پیرامون خروجی (پیش‌فرض: 16)
رندر در کادر منطقی (logical box) به جای اجتماع کادرهای منطقی و جوهری
رندر در کادر جوهری (ink box) به جای اجتماع کادرهای منطقی و جوهری
رسم حدود و وسعت گلیف‌ها (glyph extents)
اجبار به مسیر ترسیم تک‌رنگ (monochrome draw path) (لغو تشخیص خودکار)
اجبار به مسیر رنگ‌آمیزی رنگی (color paint path) (لغو تشخیص خودکار)

نمایش شماره نسخه
اجرای N بار تکرار (پیش‌فرض: 1)

متن شکل‌دهی‌شده را به صورت تصویر شطرنجی (raster image) رندر می‌کند.

0: موفقیت.
1: تجزیه گزینه‌ها ناموفق بود.
2: بارگذاری چهره قلم (font face) ناموفق بود.
3: عملیات با شکست مواجه شد.
4: تنظیم توابع فونت ناموفق بود.

HB_FACE_LOADER=face-loader; بارگذار چهره قلم پیش‌فرض را لغو و جایگزین می‌کند.
HB_FONT_FUNCS=font-funcs; پیاده‌سازی پیش‌فرض font-funcs را لغو و جایگزین می‌کند.
HB_SHAPER_LIST=shaper-list; فهرست شکل‌دهنده‌های پیش‌فرض را لغو و جایگزین می‌کند.

hb-view(1), hb-shape(1), hb-raster(1), hb-vector(1), hb-subset(1), hb-info(1)

اطلاعات بیشتر یا گزارش خطاها در https://github.com/harfbuzz/harfbuzz

August 2026 HarfBuzz 14.4.0