HB-RASTER(1) User Commands HB-RASTER(1) نام (NAME) hb-raster - رسترایز کردن و رندر گلیف‌های فونت با HarfBuzz خلاصه دستور (SYNOPSIS) hb-raster [گزینه‌ها] [فایل-فونت] [متن] توضیحات (DESCRIPTION) رسترایز کردن متن با فونت داده‌شده. گزینه‌ها (OPTIONS) گزینه‌های راهنما: -h, --help نمایش گزینه‌های راهنما --help-all نمایش همه گزینه‌های راهنما --help-face گزینه‌های مربوط به چهره قلم (font face) --help-font گزینه‌های مربوط به نمونه قلم (font instance) --help-variations گزینه‌های مربوط به متغیرهای فونت (variations) استفاده‌شده --help-text گزینه‌های مربوط به متن ورودی --help-text-context گزینه‌های مربوط به متن زمینه ورودی --help-shape گزینه‌های مربوط به فرآیند شکل‌دهی (shaping) --help-features گزینه‌های مربوط به ویژگی‌های فونت (OpenType features) استفاده‌شده --help-output گزینه‌های مربوط به مقصد و قالب خروجی --help-view گزینه‌های مربوط به رندر و نمایش خروجی گزینه‌های چهره قلم (Font-face options): --font-file=filename تنظیم نام فایل فونت -y, --face-index=index تنظیم نمایه چهره قلم (پیش‌فرض: 0) --face-loader=loader تنظیم بارگذار چهره قلم برای استفاده (پیش‌فرض: ot) بارگذارهای پشتیبانی‌شده عبارتند از: ot/ft --list-face-loaders فهرست کردن بارگذارهای چهره قلم در دسترس و خروج گزینه‌های نمونه قلم (Font-instance options): --font-size=1/2 عدد صحیح یا 'upem' اندازه فونت (پیش‌فرض: 256) --font-ppem=1/2 عدد صحیح تنظیم پیکسل بر EM در راستای x و y (پیش‌فرض: 0؛ غیرفعال) --font-ptem=point-size تنظیم اندازه پوینت فونت (پیش‌فرض: 0؛ غیرفعال) --font-bold=1/2 عدد؛ مثلاً 0.05 تنظیم ضخامت مصنوعی (synthetic bold) (پیش‌فرض: 0) --font-grade=1/2 عدد؛ مثلاً 0.05 تنظیم درجه مصنوعی (synthetic grade) (پیش‌فرض: 0) --font-slant=slant نسبت؛ مثلاً 0.2 تنظیم شیب مصنوعی (synthetic slant) (پیش‌فرض: 0) --font-funcs=impl تنظیم پیاده‌سازی توابع فونت برای استفاده (پیش‌فرض: ot) پیاده‌سازی‌های پشتیبانی‌شده توابع فونت عبارتند از: ot/ft --list-font-funcs فهرست کردن توابع فونت در دسترس و خروج --ft-load-flags=integer تنظیم پرچم‌های بارگذاری FreeType (پیش‌فرض: 2) گزینه‌های متغیرها (Variations options): --named-instance=index تنظیم نمایه نمونه نام‌گذاری‌شده (پیش‌فرض: none) --variations=list فهرست جداشده با کاما از متغیرهای فونت متغیرها به صورت سراسری تنظیم می‌شوند. قالب مشخص کردن تنظیمات متغیر در ادامه آمده است. تمام مقادیر معتبر font-variation-settings در CSS غیر از 'normal' و 'inherited' نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. قالب به صورت یک برچسب، اختیاری به همراه علامت مساوی، و به دنبال آن یک عدد است. برای مثال: "wght=500" "slnt=-7.5" گزینه‌های متن (Text options): اگر متنی ارائه نشود، ورودی استاندارد (stdin) استفاده می‌شود. --text=string تنظیم متن ورودی --text-file=filename تنظیم نام فایل متن ورودی -u, --unicodes=list از اعداد هگز تنظیم نقاط کد یونیکد ورودی --single-par برخورد با متن به عنوان یک پاراگراف واحد گزینه‌های زمینه متنی (Textual context options): --text-before=string تنظیم متن زمینه پیش از هر خط --text-after=string تنظیم متن زمینه پس از هر خط --unicodes-before=list از اعداد هگز تنظیم زمینه نقاط کد یونیکد پیش از هر خط --unicodes-after=list از اعداد هگز تنظیم زمینه نقاط کد یونیکد پس از هر خط گزینه‌های شکل‌دهی (Shape options): --shapers=comma-separated list تنظیم شکل‌دهنده‌ها برای استفاده (پیش‌فرض: graphite2,ot,fallback) شکل‌دهنده‌های پشتیبانی‌شده عبارتند از: graphite2/ot/fallback --list-shapers فهرست کردن شکل‌دهنده‌های در دسترس و خروج --direction=ltr/rtl/ttb/btt تنظیم جهت متن (پیش‌فرض: auto) --language=BCP 47 tag تنظیم زبان متن (پیش‌فرض: $LANG) --script=ISO-15924 tag تنظیم خط/اسکریپت متن (پیش‌فرض: auto) --bot برخورد با متن به عنوان ابتدای پاراگراف (beginning-of-paragraph) --eot برخورد با متن به عنوان انتهای پاراگراف (end-of-paragraph) --preserve-default-ignorables حفظ نویسه‌های نادیده‌گرفتنی پیش‌فرض (Default-Ignorable) --remove-default-ignorables حذف نویسه‌های نادیده‌گرفتنی پیش‌فرض (Default-Ignorable) --invisible-glyph مقدار گلیف برای جایگزینی نویسه‌های Default-Ignorable --not-found-glyph مقدار گلیف برای جایگزینی نویسه‌های یافت‌نشده --not-found-variation-selector-glyph مقدار گلیف برای جایگزینی نویسه‌های گزینش‌گر متغیر (variation-selector) یافت‌نشده --utf8-clusters استفاده از نمایه‌های بایتی UTF8 به جای نمایه‌های نویسه‌ای --cluster-level=0/1/2/3 سطح ادغام خوشه‌ها (cluster merging level) (پیش‌فرض: 0) --normalize-glyphs مرتب‌سازی مجدد خوشه‌های گلیف به ترتیب اسمی (nominal order) --unsafe-to-concat تولید پرچم گلیف ناامن برای الحاق (unsafe-to-concat) --safe-to-insert-tatweel تولید پرچم گلیف امن برای درج تطویل/کشش (safe-to-insert-tatweel) --glyphs تفسیر ورودی به عنوان رشته گلیف --verify انجام بررسی‌های صحت‌سنجی روی نتایج شکل‌دهی گزینه‌های ویژگی‌ها (Features options): --features=list فهرست جداشده با کاما از ویژگی‌های فونت ویژگی‌ها را می‌توان به صورت سراسری یا محدود به محدوده‌های نویسه‌ای خاص فعال یا غیرفعال کرد. قالب مشخص کردن تنظیمات ویژگی در ادامه آمده است. تمام مقادیر معتبر font-feature-settings در CSS غیر از 'normal' و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. توالی‌های گریز رشته‌ای CSS پشتیبانی نمی‌شوند. نمایه‌های محدوده به موقعیت‌های بین نویسه‌های یونیکد اشاره دارند، مگر اینکه --utf8-clusters ارائه شده باشد که در این صورت نمایه‌های محدوده به نمایه‌های بایتی UTF-8 اشاره می‌کنند. موقعیت پیش از نخستین نویسه همواره 0 است. قالب مشابه پایتون (Python-esque) است. نحوه کار به شرح زیر است: Syntax: 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 گزینه‌های مقصد و قالب خروجی (Output destination & format options): -o, --output-file=filename تنظیم نام فایل خروجی (پیش‌فرض: stdout) -O, --output-format=format تنظیم قالب خروجی (پیش‌فرض: png) قالب‌های خروجی پشتیبانی‌شده عبارتند از: png/ppm/ansi گزینه‌های نمایش و رندر (View options): --background=rrggbb/rrggbbaa/none تنظیم رنگ پس‌زمینه (پیش‌فرض: #FFFFFF)؛ از "none" برای شفاف استفاده کنید --foreground=rrggbb/rrggbbaa[,...] تنظیم رنگ پیش‌زمینه (پیش‌فرض: #000000) --rainbow چرخش رنگ‌های پیش‌زمینه گلیف میان یک پالت پیش‌فرض --font-palette=index تنظیم پالت فونت (پیش‌فرض: 0) --custom-palette=comma-separated colors پالت سفارشی --line-space=units تنظیم فاصله میان خطوط (پیش‌فرض: 0) --font-extents=one to three numbers تنظیم فراز/فرود/فاصله خطوط فونت (ascent/descent/line-gap) (پیش‌فرض: auto) --margin=one to four numbers حاشیه پیرامون خروجی (پیش‌فرض: 16) --logical رندر در کادر منطقی (logical box) به جای اجتماع کادرهای منطقی و جوهری --ink رندر در کادر جوهری (ink box) به جای اجتماع کادرهای منطقی و جوهری --show-extents رسم حدود و وسعت گلیف‌ها (glyph extents) --draw اجبار به مسیر ترسیم تک‌رنگ (monochrome draw path) (لغو تشخیص خودکار) --paint اجبار به مسیر رنگ‌آمیزی رنگی (color paint path) (لغو تشخیص خودکار) گزینه‌های برنامه (Application Options): --version نمایش شماره نسخه -n, --num-iterations=N اجرای N بار تکرار (پیش‌فرض: 1) متن شکل‌دهی‌شده را به صورت تصویر شطرنجی (raster image) رندر می‌کند. کدهای خروج (EXIT CODES) 0: موفقیت. 1: تجزیه گزینه‌ها ناموفق بود. 2: بارگذاری چهره قلم (font face) ناموفق بود. 3: عملیات با شکست مواجه شد. 4: تنظیم توابع فونت ناموفق بود. محیط (ENVIRONMENT) HB_FACE_LOADER=face-loader; بارگذار چهره قلم پیش‌فرض را لغو و جایگزین می‌کند. HB_FONT_FUNCS=font-funcs; پیاده‌سازی پیش‌فرض font-funcs را لغو و جایگزین می‌کند. HB_SHAPER_LIST=shaper-list; فهرست شکل‌دهنده‌های پیش‌فرض را لغو و جایگزین می‌کند. همچنین ببینید (SEE ALSO) hb-view(1), hb-shape(1), hb-raster(1), hb-vector(1), hb-subset(1), hb-info(1) اطلاعات بیشتر یا گزارش خطاها در HarfBuzz 14.4.0 August 2026 HB-RASTER(1)