کاربرد:

hb-vector [OPTION...] [FONT-FILE] [TEXT]

ترسیم متن با قلم مشخص‌شده.

گزینه‌های راهنما (Help Options):

-h, --help

نمایش گزینه‌های راهنما

--help-all

نمایش همه گزینه‌های راهنما

--help-face

گزینه‌های مربوط به چهره قلم (font face)

--help-font

گزینه‌های مربوط به نمونه قلم (font instance)

--help-variations

گزینه‌های مربوط به متغیرهای قلم مورد استفاده

--help-text

گزینه‌های مربوط به متن ورودی

--help-text-context

گزینه‌های مربوط به زمینه متن ورودی

--help-shape

گزینه‌های مربوط به فرآیند شکل‌دهی متن (shaping)

--help-features

گزینه‌های مربوط به ویژگی‌های قلم مورد استفاده

--help-output

گزینه‌های مربوط به مقصد و قالب خروجی

--help-view

گزینه‌های مربوط به رندر و نمایش خروجی

--help-vector

گزینه‌های مربوط به خروجی برداری

گزینه‌های چهره قلم (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 integers or 'upem'

اندازه قلم (پیش‌فرض: upem)

--font-ppem=1/2 integers

تنظیم پیکسل بر EM در محور x و y (پیش‌فرض: 0؛ غیرفعال)

--font-ptem=point-size

تنظیم اندازه نقطه (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 options):

--named-instance=index

تنظیم نمایه نمونه نام‌گذاری‌شده (پیش‌فرض: none)

--variations=list

فهرست جداشده با کاما از متغیرهای قلم

متغیرها به صورت سراسری تنظیم می‌شوند. قالب تعیین تنظیمات متغیرها در ادامه آمده است. تمامی مقادیر معتبر font-variation-settings در CSS به جز 'normal' و 'inherited' نیز پذیرفته می‌شوند، هرچند در ادامه مستند نشده‌اند.

قالب به صورت یک برچسب (tag)، به همراه یک علامت مساوی اختیاری، و در ادامه یک عدد است؛ برای نمونه:

"wght=500" "slnt=-7.5"

گزینه‌های متن:

اگر هیچ متنی مشخص نشود، از ورودی استاندارد (stdin) استفاده می‌شود.

--text=string

تنظیم متن ورودی

--text-file=filename

تنظیم نام فایل متن ورودی

-u, --unicodes=list of hex numbers

تنظیم نقاط کد یونیکد ورودی

--single-par

در نظر گرفتن متن به صورت یک بند (پاراگراف) تکی

گزینه‌های زمینه متنی (Textual context options):

--text-before=string

تنظیم متن زمینه پیش از هر خط

--text-after=string

تنظیم متن زمینه پس از هر خط

--unicodes-before=list of hex numbers

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

--unicodes-after=list of hex numbers

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

گزینه‌های شکل‌دهی (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

مقدار گلیف برای جایگزینی با نویسه‌های نادیده‌گرفتنی پیش‌فرض

--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

انجام بررسی‌های صحت‌سنجی بر روی نتایج شکل‌دهی

گزینه‌های ویژگی‌ها (Features options):

--features=list

فهرست جداشده با کاما از ویژگی‌های قلم

ویژگی‌ها را می‌توان به صورت سراسری یا محدود به محدوده‌های نویسه‌ای خاص فعال یا غیرفعال کرد. قالب تعیین تنظیمات ویژگی‌ها به صورت زیر است. تمامی مقادیر معتبر font-feature-settings در CSS به جز 'normal' و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در ادامه مستند نشده‌اند. اسکیپ‌های رشته‌ای 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 ... # انتخاب جایگزین دوم

تنظیم نمایه:

"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 # روشن کردن جایگزین دوم برای بازه

گزینه‌های مقصد و قالب خروجی (Output destination & format options):

-o, --output-file=filename

تنظیم نام فایل خروجی (پیش‌فرض: stdout)

-O, --output-format=format

تنظیم قالب خروجی (پیش‌فرض: svg)

قالب‌های خروجی پشتیبانی‌شده عبارتند از: svg/pdf

گزینه‌های نمایش (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

رندر به کادر منطقی به جای اجتماع کادرهای منطقی و جوهری

--ink

رندر به کادر جوهری به جای اجتماع کادرهای منطقی و جوهری

--show-extents

ترسیم حدود (extents) گلیف

--draw

اجبار به مسیر ترسیم تک‌رنگ (نادیده‌گرفتن تشخیص خودکار)

--paint

اجبار به مسیر رنگ‌آمیزی رنگی (نادیده‌گرفتن تشخیص خودکار)

گزینه‌های برداری (Vector options):

--precision=N

دقت اعشار (پیش‌فرض: 2)

گزینه‌های برنامه (Application Options):

--version

نمایش شماره نسخه

-n, --num-iterations=N

اجرای N تکرار (پیش‌فرض: 1)

خطوط پیرامونی گلیف‌های شکل‌گرفته را به صورت SVG یا PDF نمایش می‌دهد.