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) برای کسب اطلاعات بیشتر یا گزارش اشکالات به مراجعه کنید. HarfBuzz 14.4.0 August 2026 HB-SUBSET(1)