| HB-SUBSET(1) | دستورات کاربر | HB-SUBSET(1) |
نام (NAME)
hb-subset - زیرمجموعهگیری از قلم مطابق با مشخصات تعیینشده
توضیحات (DESCRIPTION)
کاربرد:
- hb-subset [گزینهها...] [فایل-قلم] [متن]
زیرمجموعهگیری از قلم مطابق با مشخصات تعیینشده.
گزینههای راهنما (Help Options):
- -h, --help
- نمایش گزینههای راهنما
- --help-all
- نمایش تمام گزینههای راهنما
- --help-face
- گزینههای مربوط به چهره قلم
- --help-subset-glyphset
- گزینههای زیرمجموعهگیری مجموعه گلیفها
- --help-subset-other
- سایر گزینههای زیرمجموعهگیری
- --help-subset-flags
- گزینههای بولی زیرمجموعهگیری
- --help-output
- گزینههای مربوط به مقصد و قالب خروجی
گزینههای چهره قلم (Font-face options):
- --font-file=نام-فایل
- تنظیم نام فایل قلم
- -y, --face-index=اندیس
- تنظیم اندیس چهره قلم (پیشفرض: 0)
- --face-loader=بارگذار
- تنظیم بارگذار چهره قلم برای استفاده (پیشفرض: ot)
- بارگذارهای پشتیبانیشده چهره قلم عبارتند از: ot/ft
- --list-face-loaders
- فهرست کردن بارگذارهای موجود چهره قلم و خروج
گزینههای مجموعه گلیف برای زیرمجموعهگیری (Subset glyph-set options):
- -g, --gids=فهرست اندیسها/محدودههای گلیف یا *
- مشخص کردن شناسهها یا محدودههای گلیف برای گنجاندن در زیرمجموعه. برای کسر کردن نقطهکدها از مجموعه فعلی، از --gids-=... استفاده کنید.
- --gids-file=نام-فایل
- مشخص کردن فایل برای خواندن شناسهها یا محدودههای گلیف از آن
- --glyphs=فهرست نامهای گلیف یا *
- مشخص کردن نامهای گلیف جهت گنجاندن در زیرمجموعه. برای کسر کردن گلیفها از مجموعه فعلی، از --glyphs-=... استفاده کنید.
- --glyphs-file=نام-فایل
- مشخص کردن فایل برای خواندن نامهای گلیف از آن
- -t, --text=رشته
- مشخص کردن متن جهت گنجاندن در زیرمجموعه. برای کسر کردن نقطهکدها از مجموعه فعلی، از --text-=... استفاده کنید.
- --text-file=نام-فایل
- مشخص کردن فایل برای خواندن متن از آن
- -u, --unicodes=فهرست اعداد/محدودههای هگزادسیمال یا *
- مشخص کردن نقطهکدهای یونیکد یا محدودههای آن جهت گنجاندن در زیرمجموعه. از * برای گنجاندن تمام نقطهکدها استفاده کنید. برای کسر کردن نقطهکدها از مجموعه فعلی، میتوان از --unicodes-=... استفاده کرد. به عنوان مثال: --unicodes=* --unicodes-=41,42,43 زیرمجموعهای با تمام نقطهکدها به جز 41، 42 و 43 ایجاد میکند.
- --unicodes-file=نام-فایل
- مشخص کردن فایل برای خواندن نقطهکدها یا محدودههای یونیکد از آن
سایر گزینههای زیرمجموعهگیری (Subset other options):
- --gid-map=فهرست جفتهای old_gid1:new_gid1,old_gid2:new_gid2,...
- مشخص کردن یک نگاشت گلیف برای استفاده؛ هر gid نگاشتنشده بهطور خودکار تخصیص خواهد یافت.
- --name-IDs=فهرست اعداد صحیح یا *
- زیرمجموعهگیری شناسههای نام (nameID) مشخصشده. برای کسر از مجموعه فعلی، از --name-IDs-=... استفاده کنید.
- --name-languages=فهرست اعداد صحیح یا *
- زیرمجموعهگیری nameRecordها با شناسههای زبان مشخصشده. برای کسر از مجموعه فعلی، از --name-languages-=... استفاده کنید.
- --layout-features=فهرست تگهای جدول رشته یا *
- مشخص کردن مجموعهای از تگهای ویژگی طرحبندی (layout feature) که حفظ خواهند شد. برای کسر از مجموعه فعلی، از --layout-features-=... استفاده کنید.
- --layout-scripts=فهرست تگهای جدول رشته یا *
- مشخص کردن مجموعهای از تگهای اسکریپت طرحبندی (layout script) که حفظ خواهند شد. برای کسر از مجموعه فعلی، از --layout-scripts-=... استفاده کنید.
- --drop-tables=فهرست تگهای جدول رشته یا *
- حذف جداول مشخصشده. برای کسر از مجموعه فعلی، از --drop-tables-=... استفاده کنید.
- --variations=فهرست موقعیتهای محور جداشده با کاما.
- نمونهسازی (جزئی یا کامل) از یک قلم متغیر (variable font). یک موقعیت شامل تگ محور تغییر، به دنبال آن '=' و سپس یک عدد یا رشته متنی 'drop' است. برای مثال: --variations="wdth=100 wght=200" یا --variations="wdth=drop"
گزینههای بولی زیرمجموعهگیری (Subset boolean options):
- --keep-everything
- حفظ همهچیز بهطور پیشفرض. گزینههای بعد از این میتوانند عملیات را بازنویسی کنند.
- --no-hinting
- صرفنظر کردن از هینتها (hints) و حذف آنها.
- --retain-gids
- در صورت تنظیم، شناسههای گلیف (GID) در زیرمجموعه شمارهگذاری مجدد نمیشوند.
- --desubroutinize
- حذف استفاده CFF/CFF2 از زیرروالها (subroutines).
- --downgrade-cff2
- تبدیل قلمهای متغیر نمونهسازیشده از CFF2 به CFF1.
- --cff-identity-charset
- تولید مجموعه نویسه همانی CFF (مقدار CID = new GID) برای CFF دارای کلید CID.
- --name-legacy
- حفظ مدخلهای سنتی و موروثی (غیر یونیکد) جدول 'name'.
- --set-overlaps-flag
- تنظیم پرچم همپوشانی (overlaps) روی هر گلیف.
- --notdef-outline
- حفظ طرح بیرونی (outline) گلیف '.notdef'.
- --no-prune-unicode-ranges
- تغییر ندادن بیتهای 'OS/2 ulUnicodeRange*'.
- --no-layout-closure
- عدم اجرای بستار گلیف (glyph closure) برای جایگزینی طرحبندی (GSUB).
- --no-bidi-closure
- عدم اجرای بستار دوجهته (bidi closure - افزودن گونههای قرینه) برای نقطهکدهای ورودی.
- --glyph-names
- حفظ نامهای گلیف پستاسکریپت (PS) در قلمهای با سبک تروتایپ (TT-flavored).
- --passthrough-tables
- عدم حذف جداولی که ابزار نحوه زیرمجموعهگیری آنها را نمیداند.
- --preprocess
- در صورت تنظیم، پیش از زیرمجموعهگیری واقعی، چهره قلم را با گزینه افزودن شتابدهنده پیشپردازش میکند.
- --optimize
- اجرای بهینهسازی دلتای IUP روی دلتاهای جدول gvar حاصل.
گزینههای مقصد و قالب خروجی (Output destination & format options):
- -o, --output-file=نام-فایل
- تنظیم نام فایل خروجی (پیشفرض: stdout)
گزینههای برنامه (Application Options):
- --version
- نمایش شماره نسخه
- -n, --num-iterations=N
- اجرای N بار ابزار زیرمجموعهگیر (پیشفرض: 1)
فایل قلم را به مجموعه مشخصی از گلیفها، نقطهکدهای یونیکد یا متن کاهش میدهد، فضای طراحی را محدود میکند و سایر کاستنها را اعمال میکند.
کدهای خروج (EXIT CODES)
- 0: موفقیتآمیز.
- 1: تجزیه گزینهها ناموفق بود.
- 2: بارگذاری چهره قلم ناموفق بود.
محیط (ENVIRONMENT)
- HB_FACE_LOADER=face-loader؛ بارگذار پیشفرض چهره قلم را بازنویسی میکند.
همچنین ببینید (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 |