| 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)
اطلاعات بیشتر یا گزارش خطاها در https://github.com/harfbuzz/harfbuzz
| August 2026 | HarfBuzz 14.4.0 |