.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH HB-SUBSET "1" "August 2026" "HarfBuzz 14.4.0" "دستورات کاربر"
.SH "نام (NAME)"
hb-subset \- زیرمجموعه‌گیری از قلم مطابق با مشخصات تعیین‌شده
.SH "توضیحات (DESCRIPTION)"
.SS "کاربرد:"
.IP
\fBhb\-subset\fR [\fIگزینه‌ها\fR...] [\fIفایل\-قلم\fR] [\fIمتن\fR]
.PP
زیرمجموعه‌گیری از قلم مطابق با مشخصات تعیین‌شده.
.SS "گزینه‌های راهنما (Help Options):"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش گزینه‌های راهنما
.TP
\fB\-\-help\-all\fR
نمایش تمام گزینه‌های راهنما
.TP
\fB\-\-help\-face\fR
گزینه‌های مربوط به چهره قلم
.TP
\fB\-\-help\-subset\-glyphset\fR
گزینه‌های زیرمجموعه‌گیری مجموعه گلیف‌ها
.TP
\fB\-\-help\-subset\-other\fR
سایر گزینه‌های زیرمجموعه‌گیری
.TP
\fB\-\-help\-subset\-flags\fR
گزینه‌های بولی زیرمجموعه‌گیری
.TP
\fB\-\-help\-output\fR
گزینه‌های مربوط به مقصد و قالب خروجی
.SS "گزینه‌های چهره قلم (Font-face options):"
.TP
\fB\-\-font\-file\fR=\fI\,نام\-فایل\/\fR
تنظیم نام فایل قلم
.TP
\fB\-y\fR, \fB\-\-face\-index\fR=\fI\,اندیس\/\fR
تنظیم اندیس چهره قلم (پیش‌فرض: 0)
.TP
\fB\-\-face\-loader\fR=\fI\,بارگذار\/\fR
تنظیم بارگذار چهره قلم برای استفاده (پیش‌فرض: ot)
.IP
بارگذارهای پشتیبانی‌شده چهره قلم عبارتند از: ot/ft
.TP
\fB\-\-list\-face\-loaders\fR
فهرست کردن بارگذارهای موجود چهره قلم و خروج
.SS "گزینه‌های مجموعه گلیف برای زیرمجموعه‌گیری (Subset glyph-set options):"
.TP
\fB\-g\fR, \fB\-\-gids\fR=\fI\,فهرست\/\fR اندیس‌ها/محدوده‌های گلیف یا *
مشخص کردن شناسه‌ها یا محدوده‌های گلیف برای گنجاندن در زیرمجموعه.
برای کسر کردن نقطه‌کدها از مجموعه فعلی، از
\fB\-\-gids\-=\fR...
استفاده کنید.
.TP
\fB\-\-gids\-file\fR=\fI\,نام\-فایل\/\fR
مشخص کردن فایل برای خواندن شناسه‌ها یا محدوده‌های گلیف از آن
.TP
\fB\-\-glyphs\fR=\fI\,فهرست\/\fR نام‌های گلیف یا *
مشخص کردن نام‌های گلیف جهت گنجاندن در زیرمجموعه. برای کسر کردن گلیف‌ها از مجموعه فعلی، از
\fB\-\-glyphs\-=\fR...
استفاده کنید.
.TP
\fB\-\-glyphs\-file\fR=\fI\,نام\-فایل\/\fR
مشخص کردن فایل برای خواندن نام‌های گلیف از آن
.TP
\fB\-t\fR, \fB\-\-text\fR=\fI\,رشته\/\fR
مشخص کردن متن جهت گنجاندن در زیرمجموعه. برای کسر کردن نقطه‌کدها از مجموعه فعلی، از
\fB\-\-text\-=\fR...
استفاده کنید.
.TP
\fB\-\-text\-file\fR=\fI\,نام\-فایل\/\fR
مشخص کردن فایل برای خواندن متن از آن
.TP
\fB\-u\fR, \fB\-\-unicodes\fR=\fI\,فهرست\/\fR اعداد/محدوده‌های هگزادسیمال یا *
مشخص کردن نقطه‌کدهای یونیکد یا محدوده‌های آن جهت گنجاندن در زیرمجموعه. از * برای گنجاندن تمام نقطه‌کدها استفاده کنید.
برای کسر کردن نقطه‌کدها از مجموعه فعلی، می‌توان از
\fB\-\-unicodes\-=\fR...
استفاده کرد.
به عنوان مثال:
\fB\-\-unicodes=\fR* \fB\-\-unicodes\-\fR=\fI\,41\/\fR,42,43
زیرمجموعه‌ای با تمام نقطه‌کدها به جز 41، 42 و 43 ایجاد می‌کند.
.TP
\fB\-\-unicodes\-file\fR=\fI\,نام\-فایل\/\fR
مشخص کردن فایل برای خواندن نقطه‌کدها یا محدوده‌های یونیکد از آن
.SS "سایر گزینه‌های زیرمجموعه‌گیری (Subset other options):"
.TP
\fB\-\-gid\-map\fR=\fI\,فهرست\/\fR جفت‌های old_gid1:new_gid1,old_gid2:new_gid2,...
مشخص کردن یک نگاشت گلیف برای استفاده؛ هر gid نگاشت‌نشده به‌طور خودکار تخصیص خواهد یافت.
.TP
\fB\-\-name\-IDs\fR=\fI\,فهرست\/\fR اعداد صحیح یا *
زیرمجموعه‌گیری شناسه‌های نام (nameID) مشخص‌شده. برای کسر از مجموعه فعلی، از
\fB\-\-name\-IDs\-=\fR...
استفاده کنید.
.TP
\fB\-\-name\-languages\fR=\fI\,فهرست\/\fR اعداد صحیح یا *
زیرمجموعه‌گیری nameRecordها با شناسه‌های زبان مشخص‌شده. برای کسر از مجموعه فعلی، از
\fB\-\-name\-languages\-=\fR...
استفاده کنید.
.TP
\fB\-\-layout\-features\fR=\fI\,فهرست\/\fR تگ‌های جدول رشته یا *
مشخص کردن مجموعه‌ای از تگ‌های ویژگی طرح‌بندی (layout feature) که حفظ خواهند شد. برای کسر از مجموعه فعلی، از
\fB\-\-layout\-features\-=\fR...
استفاده کنید.
.TP
\fB\-\-layout\-scripts\fR=\fI\,فهرست\/\fR تگ‌های جدول رشته یا *
مشخص کردن مجموعه‌ای از تگ‌های اسکریپت طرح‌بندی (layout script) که حفظ خواهند شد. برای کسر از مجموعه فعلی، از
\fB\-\-layout\-scripts\-=\fR...
استفاده کنید.
.TP
\fB\-\-drop\-tables\fR=\fI\,فهرست\/\fR تگ‌های جدول رشته یا *
حذف جداول مشخص‌شده. برای کسر از مجموعه فعلی، از
\fB\-\-drop\-tables\-=\fR...
استفاده کنید.
.TP
\fB\-\-variations\fR=\fI\,فهرست\/\fR موقعیت‌های محور جداشده با کاما.
نمونه‌سازی (جزئی یا کامل) از یک قلم متغیر (variable font). یک موقعیت شامل تگ محور تغییر، به دنبال آن '=' و سپس یک عدد یا رشته متنی 'drop' است. برای مثال:
\fB\-\-variations=\fR"wdth=100 wght=200"
یا
\fB\-\-variations=\fR"wdth=drop"
.SS "گزینه‌های بولی زیرمجموعه‌گیری (Subset boolean options):"
.TP
\fB\-\-keep\-everything\fR
حفظ همه‌چیز به‌طور پیش‌فرض. گزینه‌های بعد از این می‌توانند عملیات را بازنویسی کنند.
.TP
\fB\-\-no\-hinting\fR
صرف‌نظر کردن از هینت‌ها (hints) و حذف آن‌ها.
.TP
\fB\-\-retain\-gids\fR
در صورت تنظیم، شناسه‌های گلیف (GID) در زیرمجموعه شماره‌گذاری مجدد نمی‌شوند.
.TP
\fB\-\-desubroutinize\fR
حذف استفاده CFF/CFF2 از زیرروال‌ها (subroutines).
.TP
\fB\-\-downgrade\-cff2\fR
تبدیل قلم‌های متغیر نمونه‌سازی‌شده از CFF2 به CFF1.
.TP
\fB\-\-cff\-identity\-charset\fR
تولید مجموعه نویسه همانی CFF (مقدار CID = new GID) برای CFF دارای کلید CID.
.TP
\fB\-\-name\-legacy\fR
حفظ مدخل‌های سنتی و موروثی (غیر یونیکد) جدول 'name'.
.TP
\fB\-\-set\-overlaps\-flag\fR
تنظیم پرچم هم‌پوشانی (overlaps) روی هر گلیف.
.TP
\fB\-\-notdef\-outline\fR
حفظ طرح بیرونی (outline) گلیف '.notdef'.
.TP
\fB\-\-no\-prune\-unicode\-ranges\fR
تغییر ندادن بیت‌های 'OS/2 ulUnicodeRange*'.
.TP
\fB\-\-no\-layout\-closure\fR
عدم اجرای بستار گلیف (glyph closure) برای جایگزینی طرح‌بندی (GSUB).
.TP
\fB\-\-no\-bidi\-closure\fR
عدم اجرای بستار دوجهته (bidi closure - افزودن گونه‌های قرینه) برای نقطه‌کدهای ورودی.
.TP
\fB\-\-glyph\-names\fR
حفظ نام‌های گلیف پست‌اسکریپت (PS) در قلم‌های با سبک تروتایپ (TT-flavored).
.TP
\fB\-\-passthrough\-tables\fR
عدم حذف جداولی که ابزار نحوه زیرمجموعه‌گیری آن‌ها را نمی‌داند.
.TP
\fB\-\-preprocess\fR
در صورت تنظیم، پیش از زیرمجموعه‌گیری واقعی، چهره قلم را با گزینه افزودن شتاب‌دهنده پیش‌پردازش می‌کند.
.TP
\fB\-\-optimize\fR
اجرای بهینه‌سازی دلتای IUP روی دلتاهای جدول gvar حاصل.
.SS "گزینه‌های مقصد و قالب خروجی (Output destination & format options):"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,نام\-فایل\/\fR
تنظیم نام فایل خروجی (پیش‌فرض: stdout)
.SS "گزینه‌های برنامه (Application Options):"
.TP
\fB\-\-version\fR
نمایش شماره نسخه
.TP
\fB\-n\fR, \fB\-\-num\-iterations\fR=\fI\,N\/\fR
اجرای N بار ابزار زیرمجموعه‌گیر (پیش‌فرض: 1)
.PP
فایل قلم را به مجموعه مشخصی از گلیف‌ها، نقطه‌کدهای یونیکد یا متن کاهش می‌دهد، فضای طراحی را محدود می‌کند و سایر کاستن‌ها را اعمال می‌کند.
.SH "کدهای خروج (EXIT CODES)"
.IP
0: موفقیت‌آمیز.
.IP
1: تجزیه گزینه‌ها ناموفق بود.
.IP
2: بارگذاری چهره قلم ناموفق بود.
.SH "محیط (ENVIRONMENT)"
.IP
\fBHB_FACE_LOADER\fR=\fIface\-loader\fR؛ بارگذار پیش‌فرض چهره قلم را بازنویسی می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.IP
hb\-view(1), hb\-shape(1), hb\-raster(1), hb\-vector(1), hb\-subset(1), hb\-info(1)
.PP
برای کسب اطلاعات بیشتر یا گزارش اشکالات به <https://github.com/harfbuzz/harfbuzz> مراجعه کنید.