نام (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: اجبار به استفاده از مسیر رنگ‌آمیزی رنگی (تشخیص خودکار را لغو می‌کند)