.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. .TH HB-VECTOR "1" "August 2026" "HarfBuzz 14.4.0" "User Commands" .SH "نام (NAME)" hb-vector \- ترسیم متن با قلم مشخص‌شده .SH "توضیحات (DESCRIPTION)" .SS "کاربرد:" .IP hb\-vector [OPTION...] [FONT\-FILE] [TEXT] .PP ترسیم متن با قلم مشخص‌شده. .SS "گزینه‌های راهنما (Help Options):" .TP \fB\-h\fR, \fB\-\-help\fR نمایش گزینه‌های راهنما .TP \fB\-\-help\-all\fR نمایش همه گزینه‌های راهنما .TP \fB\-\-help\-face\fR گزینه‌های مربوط به چهره قلم (font face) .TP \fB\-\-help\-font\fR گزینه‌های مربوط به نمونه قلم (font instance) .TP \fB\-\-help\-variations\fR گزینه‌های مربوط به متغیرهای قلم مورد استفاده .TP \fB\-\-help\-text\fR گزینه‌های مربوط به متن ورودی .TP \fB\-\-help\-text\-context\fR گزینه‌های مربوط به زمینه متن ورودی .TP \fB\-\-help\-shape\fR گزینه‌های مربوط به فرآیند شکل‌دهی متن (shaping) .TP \fB\-\-help\-features\fR گزینه‌های مربوط به ویژگی‌های قلم مورد استفاده .TP \fB\-\-help\-output\fR گزینه‌های مربوط به مقصد و قالب خروجی .TP \fB\-\-help\-view\fR گزینه‌های مربوط به رندر و نمایش خروجی .TP \fB\-\-help\-vector\fR گزینه‌های مربوط به خروجی برداری .SS "گزینه‌های چهره قلم (Font-face options):" .TP \fB\-\-font\-file\fR=\fI\,filename\/\fR تنظیم نام فایل قلم .TP \fB\-y\fR, \fB\-\-face\-index\fR=\fI\,index\/\fR تنظیم نمایه چهره قلم (پیش‌فرض: 0) .TP \fB\-\-face\-loader\fR=\fI\,loader\/\fR تنظیم بارگذار چهره قلم برای استفاده (پیش‌فرض: ot) .IP بارگذارهای چهره قلم پشتیبانی‌شده عبارتند از: ot/ft .TP \fB\-\-list\-face\-loaders\fR فهرست کردن بارگذارهای چهره قلم موجود و خروج .SS "گزینه‌های نمونه قلم (Font-instance options):" .TP \fB\-\-font\-size\fR=\fI\,1\/\fR/2 integers or 'upem' اندازه قلم (پیش‌فرض: upem) .TP \fB\-\-font\-ppem\fR=\fI\,1\/\fR/2 integers تنظیم پیکسل بر EM در محور x و y (پیش‌فرض: 0؛ غیرفعال) .TP \fB\-\-font\-ptem\fR=\fI\,point\-size\/\fR تنظیم اندازه نقطه (point-size) قلم (پیش‌فرض: 0؛ غیرفعال) .TP \fB\-\-font\-bold\fR=\fI\,1\/\fR/2 numbers; eg. 0.05 تنظیم ضخامت ترکیبی (synthetic bold) (پیش‌فرض: 0) .TP \fB\-\-font\-grade\fR=\fI\,1\/\fR/2 numbers; eg. 0.05 تنظیم درجه ترکیبی (synthetic grade) (پیش‌فرض: 0) .TP \fB\-\-font\-slant\fR=\fI\,slant\/\fR ratio; eg. 0.2 تنظیم شیب ترکیبی (synthetic slant) (پیش‌فرض: 0) .TP \fB\-\-font\-funcs\fR=\fI\,impl\/\fR تنظیم پیاده‌سازی توابع قلم جهت استفاده (پیش‌فرض: ot) .IP پیاده‌سازی‌های پشتیبانی‌شده از توابع قلم عبارتند از: ot/ft .TP \fB\-\-list\-font\-funcs\fR فهرست کردن توابع قلم موجود و خروج .TP \fB\-\-ft\-load\-flags\fR=\fI\,integer\/\fR تنظیم فلگ‌های بارگذاری FreeType (پیش‌فرض: 2) .SS "گزینه‌های متغیرها (Variations options):" .TP \fB\-\-named\-instance\fR=\fI\,index\/\fR تنظیم نمایه نمونه نام‌گذاری‌شده (پیش‌فرض: none) .TP \fB\-\-variations\fR=\fI\,list\/\fR فهرست جداشده با کاما از متغیرهای قلم .IP متغیرها به صورت سراسری تنظیم می‌شوند. قالب تعیین تنظیمات متغیرها در ادامه آمده است. تمامی مقادیر معتبر font\-variation\-settings در CSS به جز 'normal' و 'inherited' نیز پذیرفته می‌شوند، هرچند در ادامه مستند نشده‌اند. .IP قالب به صورت یک برچسب (tag)، به همراه یک علامت مساوی اختیاری، و در ادامه یک عدد است؛ برای نمونه: .IP "wght=500" "slnt=\-7.5" .PP گزینه‌های متن: .PP اگر هیچ متنی مشخص نشود، از ورودی استاندارد (stdin) استفاده می‌شود. .TP \fB\-\-text\fR=\fI\,string\/\fR تنظیم متن ورودی .TP \fB\-\-text\-file\fR=\fI\,filename\/\fR تنظیم نام فایل متن ورودی .TP \fB\-u\fR, \fB\-\-unicodes\fR=\fI\,list\/\fR of hex numbers تنظیم نقاط کد یونیکد ورودی .TP \fB\-\-single\-par\fR در نظر گرفتن متن به صورت یک بند (پاراگراف) تکی .SS "گزینه‌های زمینه متنی (Textual context options):" .TP \fB\-\-text\-before\fR=\fI\,string\/\fR تنظیم متن زمینه پیش از هر خط .TP \fB\-\-text\-after\fR=\fI\,string\/\fR تنظیم متن زمینه پس از هر خط .TP \fB\-\-unicodes\-before\fR=\fI\,list\/\fR of hex numbers تنظیم نقاط کد یونیکد زمینه پیش از هر خط .TP \fB\-\-unicodes\-after\fR=\fI\,list\/\fR of hex numbers تنظیم نقاط کد یونیکد زمینه پس از هر خط .SS "گزینه‌های شکل‌دهی (Shape options):" .TP \fB\-\-shapers\fR=\fI\,comma\-separated\/\fR list تنظیم شکل‌دهنده‌ها برای استفاده (پیش‌فرض: graphite2,ot,fallback) .IP شکل‌دهنده‌های پشتیبانی‌شده عبارتند از: graphite2/ot/fallback .TP \fB\-\-list\-shapers\fR فهرست کردن شکل‌دهنده‌های موجود و خروج .TP \fB\-\-direction\fR=\fI\,ltr\/\fR/rtl/ttb/btt تنظیم جهت متن (پیش‌فرض: auto) .TP \fB\-\-language\fR=\fI\,BCP\/\fR 47 tag تنظیم زبان متن (پیش‌فرض: $LANG) .TP \fB\-\-script\fR=\fI\,ISO\-15924\/\fR tag تنظیم خط/سامانه نوشتاری متن (پیش‌فرض: auto) .TP \fB\-\-bot\fR در نظر گرفتن متن به عنوان آغاز بند (beginning-of-paragraph) .TP \fB\-\-eot\fR در نظر گرفتن متن به عنوان پایان بند (end-of-paragraph) .TP \fB\-\-preserve\-default\-ignorables\fR حفظ نویسه‌های نادیده‌گرفتنی پیش‌فرض (Default-Ignorable) .TP \fB\-\-remove\-default\-ignorables\fR حذف نویسه‌های نادیده‌گرفتنی پیش‌فرض (Default-Ignorable) .TP \fB\-\-invisible\-glyph\fR مقدار گلیف برای جایگزینی با نویسه‌های نادیده‌گرفتنی پیش‌فرض .TP \fB\-\-not\-found\-glyph\fR مقدار گلیف برای جایگزینی با نویسه‌های یافت‌نشده .TP \fB\-\-not\-found\-variation\-selector\-glyph\fR مقدار گلیف برای جایگزینی با گزینش‌گرهای متغیرِ (variation-selector) یافت‌نشده .TP \fB\-\-utf8\-clusters\fR استفاده از نمایه‌های بایتی UTF8 به جای نمایه‌های نویسه‌ای .TP \fB\-\-cluster\-level\fR=\fI\,0\/\fR/1/2/3 سطح ادغام خوشه (پیش‌فرض: 0) .TP \fB\-\-normalize\-glyphs\fR بازتولید خوشه‌های گلیف به ترتیب اسمی .TP \fB\-\-unsafe\-to\-concat\fR تولید فلگ گلیف unsafe-to-concat .TP \fB\-\-safe\-to\-insert\-tatweel\fR تولید فلگ گلیف safe-to-insert-tatweel (امکان کشیده یا تطویل) .TP \fB\-\-glyphs\fR تفسیر ورودی به عنوان رشته گلیف .TP \fB\-\-verify\fR انجام بررسی‌های صحت‌سنجی بر روی نتایج شکل‌دهی .SS "گزینه‌های ویژگی‌ها (Features options):" .TP \fB\-\-features\fR=\fI\,list\/\fR فهرست جداشده با کاما از ویژگی‌های قلم .IP ویژگی‌ها را می‌توان به صورت سراسری یا محدود به محدوده‌های نویسه‌ای خاص فعال یا غیرفعال کرد. قالب تعیین تنظیمات ویژگی‌ها به صورت زیر است. تمامی مقادیر معتبر font\-feature\-settings در CSS به جز 'normal' و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در ادامه مستند نشده‌اند. اسکیپ‌های رشته‌ای CSS پشتیبانی نمی‌شوند. نمایه‌های بازه به موقعیت‌های بین نویسه‌های یونیکد اشاره دارند، مگر اینکه \fB\-\-utf8\-clusters\fR ارائه شده باشد که در آن صورت به نمایه‌های بایتی UTF\-8 اشاره دارند. موقعیت قبل از اولین نویسه همواره 0 است. .TP قالب شبیه به پایتون است. نحوه عملکرد به صورت زیر است: .TP Syntax: Value: Start: End: .IP تنظیم مقدار: .TP "kern" 1 0 ... # روشن کردن ویژگی .TP "+kern" 1 0 ... # روشن کردن ویژگی .TP "\-kern" 0 0 ... # خاموش کردن ویژگی .TP "kern=0" 0 0 ... # خاموش کردن ویژگی .TP "kern=1" 1 0 ... # روشن کردن ویژگی .TP "aalt=2" 2 0 ... # انتخاب جایگزین دوم .IP تنظیم نمایه: .TP "kern[]" 1 0 ... # روشن کردن ویژگی .TP "kern[:]" 1 0 ... # روشن کردن ویژگی .TP "kern[5:]" 1 5 ... # روشن کردن ویژگی، جزئی .TP "kern[:5]" 1 0 5 # روشن کردن ویژگی، جزئی .TP "kern[3:5]" 1 3 5 # روشن کردن ویژگی، بازه .TP "kern[3]" 1 3 3+1 # روشن کردن ویژگی، تک‌نویسه .IP ترکیب همه موارد: .TP "aalt[3:5]=2" 2 3 5 # روشن کردن جایگزین دوم برای بازه .SS "گزینه‌های مقصد و قالب خروجی (Output destination & format options):" .TP \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,filename\/\fR تنظیم نام فایل خروجی (پیش‌فرض: stdout) .TP \fB\-O\fR, \fB\-\-output\-format\fR=\fI\,format\/\fR تنظیم قالب خروجی (پیش‌فرض: svg) .IP قالب‌های خروجی پشتیبانی‌شده عبارتند از: svg/pdf .SS "گزینه‌های نمایش (View options):" .TP \fB\-\-background\fR=\fI\,rrggbb\/\fR/rrggbbaa/none تنظیم رنگ پس‌زمینه (پیش‌فرض: #FFFFFF)؛ برای حالت شفاف از "none" استفاده کنید .TP \fB\-\-foreground\fR=\fI\,rrggbb\/\fR/rrggbbaa[,...] تنظیم رنگ پیش‌زمینه (پیش‌فرض: #000000) .TP \fB\-\-rainbow\fR چرخش رنگ پیش‌زمینه گلیف‌ها در یک پالت پیش‌فرض .TP \fB\-\-font\-palette\fR=\fI\,index\/\fR تنظیم پالت قلم (پیش‌فرض: 0) .TP \fB\-\-custom\-palette\fR=\fI\,comma\-separated\/\fR colors پالت سفارشی .TP \fB\-\-line\-space\fR=\fI\,units\/\fR تنظیم فاصله بین خطوط (پیش‌فرض: 0) .TP \fB\-\-font\-extents\fR=\fI\,one\/\fR to three numbers تنظیم صعود/فرود/فاصله‌سطر قلم (ascent/descent/line\-gap) (پیش‌فرض: auto) .TP \fB\-\-margin\fR=\fI\,one\/\fR to four numbers حاشیه در اطراف خروجی (پیش‌فرض: 16) .TP \fB\-\-logical\fR رندر به کادر منطقی به جای اجتماع کادرهای منطقی و جوهری .TP \fB\-\-ink\fR رندر به کادر جوهری به جای اجتماع کادرهای منطقی و جوهری .TP \fB\-\-show\-extents\fR ترسیم حدود (extents) گلیف .TP \fB\-\-draw\fR اجبار به مسیر ترسیم تک‌رنگ (نادیده‌گرفتن تشخیص خودکار) .TP \fB\-\-paint\fR اجبار به مسیر رنگ‌آمیزی رنگی (نادیده‌گرفتن تشخیص خودکار) .SS "گزینه‌های برداری (Vector options):" .TP \fB\-\-precision\fR=\fI\,N\/\fR دقت اعشار (پیش‌فرض: 2) .SS "گزینه‌های برنامه (Application Options):" .TP \fB\-\-version\fR نمایش شماره نسخه .TP \fB\-n\fR, \fB\-\-num\-iterations\fR=\fI\,N\/\fR اجرای N تکرار (پیش‌فرض: 1) .PP خطوط پیرامونی گلیف‌های شکل‌گرفته را به صورت SVG یا PDF نمایش می‌دهد. .SH "کدهای خروج (EXIT CODES)" .IP 0: موفقیت. .IP 1: تجزیه گزینه‌ها با شکست مواجه شد. .IP 2: بارگذاری چهره قلم ناموفق بود. .IP 3: عملیات با شکست مواجه شد. .IP 4: تنظیم توابع قلم ناموفق بود. .SH "محیط (ENVIRONMENT)" .IP HB_FACE_LOADER=face\-loader؛ بارگذار چهره قلم پیش‌فرض را لغو می‌کند. .IP HB_FONT_FUNCS=font\-funcs؛ توابع قلم پیش‌فرض را لغو می‌کند. .IP HB_SHAPER_LIST=shaper\-list؛ فهرست شکل‌دهنده‌های پیش‌فرض را لغو می‌کند. .SH "همچنین ببینید (SEE ALSO)" .IP hb\-view(1), hb\-shape(1), hb\-raster(1), hb\-vector(1), hb\-subset(1), hb\-info(1) .PP یافتن اطلاعات بیشتر یا گزارش اشکالات در