HB-VIEW(1) User Commands HB-VIEW(1) نام (NAME) hb-view - نمایش متن با قلم مشخص‌شده. توضیحات (DESCRIPTION) نحوه استفاده: hb-view [OPTION???] [FONT-FILE] [TEXT] نمایش متن با قلم مشخص‌شده. گزینه‌های راهنما: -h, --help نمایش گزینه‌های راهنما --help-all نمایش همه گزینه‌های راهنما --help-face گزینه‌های مربوط به چهره قلم (font face) --help-font گزینه‌های مربوط به نمونه قلم (font instance) --help-variations گزینه‌های مربوط به متغیرهای قلم مورد استفاده --help-text گزینه‌های متن ورودی --help-text-context گزینه‌های متن بافتار (context) ورودی --help-shape گزینه‌های فرایند شکل‌دهی (shaping) --help-features گزینه‌های ویژگی‌های قلم (font features) مورد استفاده --help-view گزینه‌های رندر خروجی --help-output گزینه‌های مربوط به مقصد و قالب خروجی گزینه‌های چهره قلم (Font-face): --font-file=filename تنظیم نام فایل قلم -y, --face-index=index تنظیم اندیس چهره قلم (پیش‌فرض: 0) --face-loader=loader تنظیم بارگذار چهره قلم مورد استفاده (پیش‌فرض: ot) بارگذارهای چهره قلم پشتیبانی‌شده عبارتند از: ot/ft --list-face-loaders فهرست کردن بارگذارهای چهره قلم موجود و خروج گزینه‌های نمونه قلم (Font-instance): --font-size=1/2 integers or 'upem' اندازه قلم (پیش‌فرض: 256) --font-ppem=1/2 integers تنظیم پیکسل‌های x,y در هر EM (پیش‌فرض: 0؛ غیرفعال) --font-ptem=point-size تنظیم اندازه پوینت قلم (پیش‌فرض: 0؛ غیرفعال) --font-bold=1/2 numbers; eg. 0.05 تنظیم ضخیم‌سازی ساختگی (synthetic bold) (پیش‌فرض: 0) --font-grade=1/2 numbers; eg. 0.05 تنظیم درجه ساختگی (synthetic grade) (پیش‌فرض: 0) --font-slant=slant ratio; eg. 0.2 تنظیم شیب ساختگی (synthetic slant) (پیش‌فرض: 0) --font-funcs=impl تنظیم پیاده‌سازی توابع قلم مورد استفاده (پیش‌فرض: ot) پیاده‌سازی‌های پشتیبانی‌شده برای توابع قلم عبارتند از: ot/ft --list-font-funcs فهرست کردن توابع قلم موجود و خروج --ft-load-flags=integer تنظیم پرچم‌های بارگذاری FreeType (پیش‌فرض: 2) گزینه‌های متغیرها (Variations): --named-instance=index تنظیم اندیس نمونه نام‌گذاری‌شده (named-instance) (پیش‌فرض: none) --variations=list فهرست جداشده با کامای متغیرهای قلم متغیرها به صورت سراسری تنظیم می‌شوند. ساختار مشخص کردن تنظیمات متغیر در ادامه آمده است. تمام مقادیر معتبر CSS font-variation-settings به جز 'normal' و 'inherited' نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. قالب به صورت یک برچسب (tag) است که به طور اختیاری با علامت مساوی و سپس یک عدد دنبال می‌شود. برای مثال: "wght=500" "slnt=-7.5" گزینه‌های متن: اگر هیچ متنی ارائه نشود، ورودی استاندارد (standard input) به عنوان ورودی استفاده می‌شود. --text=string تنظیم متن ورودی --text-file=filename تنظیم نام فایل متن ورودی -u, --unicodes=list of hex numbers تنظیم کدپوینت‌های یونیکد ورودی --single-par رفتار با متن به عنوان یک بند (پاراگراف) واحد گزینه‌های بافتار متنی (Textual context): --text-before=string تنظیم بافتار متنی پیش از هر خط --text-after=string تنظیم بافتار متنی پس از هر خط --unicodes-before=list of hex numbers تنظیم بافتار کدپوینت‌های یونیکد پیش از هر خط --unicodes-after=list of hex numbers تنظیم بافتار کدپوینت‌های یونیکد پس از هر خط گزینه‌های شکل‌دهی (Shape): --shapers=comma-separated list تنظیم شکل‌دهنده‌های (shapers) مورد استفاده (پیش‌فرض: graphite2,ot,fallback) شکل‌دهنده‌های پشتیبانی‌شده عبارتند از: graphite2/ot/fallback --list-shapers فهرست کردن شکل‌دهنده‌های موجود و خروج --direction=ltr/rtl/ttb/btt تنظیم جهت متن (پیش‌فرض: auto) --language=BCP 47 tag تنظیم زبان متن (پیش‌فرض: $LANG) --script=ISO-15924 tag تنظیم خط (script) متن (پیش‌فرض: 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 سطح ادغام خوشه‌ها (پیش‌فرض: 0) --normalize-glyphs بازآرایی خوشه‌های گلیف به ترتیب اسمی --unsafe-to-concat تولید پرچم گلیف unsafe-to-concat --safe-to-insert-tatweel تولید پرچم گلیف safe-to-insert-tatweel --glyphs تفسیر ورودی به عنوان رشته گلیف --verify انجام بررسی‌های صحت‌سنجی (sanity checks) روی نتایج شکل‌دهی گزینه‌های ویژگی‌ها (Features): --features=list فهرست جداشده با کامای ویژگی‌های قلم ویژگی‌ها را می‌توان به صورت سراسری یا محدود به محدوده‌های مشخصی از نویسه‌ها فعال یا غیرفعال کرد. ساختار تعیین تنظیمات ویژگی‌ها در ادامه آمده است. تمام مقادیر معتبر CSS font-feature-settings به جز 'normal' و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. کاراکترهای گریز (escapes) رشته در CSS پشتیبانی نمی‌شوند. اندیس‌های محدوده به موقعیت‌های میان نویسه‌های یونیکد اشاره دارند، مگر آنکه --utf8-clusters ارائه شده باشد که در آن صورت اندیس‌های محدوده به اندیس‌های بایتی UTF-8 اشاره می‌کنند. موقعیت پیش از نخستین نویسه همواره 0 است. قالب شبیه به پایتون است. نحوه کارکرد آن بدین شرح است: Syntax: Value: Start: End: تنظیم مقدار: "kern" 1 0 ??? # فعال‌سازی ویژگی "+kern" 1 0 ??? # فعال‌سازی ویژگی "-kern" 0 0 ??? # غیرفعال‌سازی ویژگی "kern=0" 0 0 ??? # غیرفعال‌سازی ویژگی "kern=1" 1 0 ??? # فعال‌سازی ویژگی "aalt=2" 2 0 ??? # انتخاب دومین جایگزین (alternate) تنظیم اندیس: "kern[]" 1 0 ??? # فعال‌سازی ویژگی "kern[:]" 1 0 ??? # فعال‌سازی ویژگی "kern[5:]" 1 5 ??? # فعال‌سازی ویژگی، جزئی "kern[:5]" 1 0 5 # فعال‌سازی ویژگی، جزئی "kern[3:5]" 1 3 5 # فعال‌سازی ویژگی، محدوده "kern[3]" 1 3 3+1 # فعال‌سازی ویژگی، تک‌نویسه ترکیب همه موارد: "aalt[3:5]=2" 2 3 5 # فعال‌سازی دومین جایگزین برای محدوده گزینه‌های نمایش (View): --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 box) --ink رندر در جعبه مرکب (ink box) به جای اجتماع جعبه‌های منطقی و مرکب --show-extents رسم حدود و ابعاد (extents) گلیف --draw اجبار به استفاده از مسیر رسم تک‌رنگ (تشخیص خودکار را لغو می‌کند) --paint اجبار به استفاده از مسیر رنگ‌آمیزی رنگی (تشخیص خودکار را لغو می‌کند) گزینه‌های مقصد و قالب خروجی: -o, --output-file=filename تنظیم نام فایل خروجی (پیش‌فرض: stdout) -O, --output-format=format تنظیم قالب خروجی (پیش‌فرض: png) قالب‌های خروجی پشتیبانی‌شده عبارتند از: png/svg/pdf/ps/eps/script/ansi گزینه‌های برنامه (Application Options): --version نمایش شماره نسخه -n, --num-iterations=N اجرای N تکرار (پیش‌فرض: 1) نمایش تصویر حاصل از رندر متن با یک قلم مشخص در قالب‌های گوناگون. وضعیت خروج (EXIT STATUS) 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-VIEW(1)