.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. .TH HB-VIEW "1" "August 2026" "HarfBuzz 14.4.0" "User Commands" .SH "نام (NAME)" hb\-view \- نمایش متن با قلم مشخص‌شده. .SH "توضیحات (DESCRIPTION)" .SS "نحوه استفاده:" .IP hb\-view [OPTION???] [FONT\-FILE] [TEXT] .PP نمایش متن با قلم مشخص‌شده. .SS "گزینه‌های راهنما:" .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 گزینه‌های متن بافتار (context) ورودی .TP \fB\-\-help\-shape\fR گزینه‌های فرایند شکل‌دهی (shaping) .TP \fB\-\-help\-features\fR گزینه‌های ویژگی‌های قلم (font features) مورد استفاده .TP \fB\-\-help\-view\fR گزینه‌های رندر خروجی .TP \fB\-\-help\-output\fR گزینه‌های مربوط به مقصد و قالب خروجی .SS "گزینه‌های چهره قلم (Font-face):" .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):" .TP \fB\-\-font\-size\fR=\fI\,1\/\fR/2 integers or 'upem' اندازه قلم (پیش‌فرض: 256) .TP \fB\-\-font\-ppem\fR=\fI\,1\/\fR/2 integers تنظیم پیکسل‌های x,y در هر EM (پیش‌فرض: 0؛ غیرفعال) .TP \fB\-\-font\-ptem\fR=\fI\,point\-size\/\fR تنظیم اندازه پوینت قلم (پیش‌فرض: 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):" .TP \fB\-\-named\-instance\fR=\fI\,index\/\fR تنظیم اندیس نمونه نام‌گذاری‌شده (named-instance) (پیش‌فرض: none) .TP \fB\-\-variations\fR=\fI\,list\/\fR فهرست جداشده با کامای متغیرهای قلم .IP متغیرها به صورت سراسری تنظیم می‌شوند. ساختار مشخص کردن تنظیمات متغیر در ادامه آمده است. تمام مقادیر معتبر CSS font\-variation\-settings به جز \(aqnormal\(aq و \(aqinherited\(aq نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. .IP قالب به صورت یک برچسب (tag) است که به طور اختیاری با علامت مساوی و سپس یک عدد دنبال می‌شود. برای مثال: .IP "wght=500" "slnt=\-7.5" .PP گزینه‌های متن: .PP اگر هیچ متنی ارائه نشود، ورودی استاندارد (standard input) به عنوان ورودی استفاده می‌شود. .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):" .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):" .TP \fB\-\-shapers\fR=\fI\,comma\-separated\/\fR list تنظیم شکل‌دهنده‌های (shapers) مورد استفاده (پیش‌فرض: 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 تنظیم خط (script) متن (پیش‌فرض: 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 مقدار گلیف برای جایگزینی نویسه‌های Default\-Ignorable .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 انجام بررسی‌های صحت‌سنجی (sanity checks) روی نتایج شکل‌دهی .SS "گزینه‌های ویژگی‌ها (Features):" .TP \fB\-\-features\fR=\fI\,list\/\fR فهرست جداشده با کامای ویژگی‌های قلم .IP ویژگی‌ها را می‌توان به صورت سراسری یا محدود به محدوده‌های مشخصی از نویسه‌ها فعال یا غیرفعال کرد. ساختار تعیین تنظیمات ویژگی‌ها در ادامه آمده است. تمام مقادیر معتبر CSS font\-feature\-settings به جز \(aqnormal\(aq و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در زیر مستند نشده‌اند. کاراکترهای گریز (escapes) رشته در 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 ??? # انتخاب دومین جایگزین (alternate) .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 "گزینه‌های نمایش (View):" .TP \fB\-\-background\fR=\fI\,rrggbb\/\fR/rrggbbaa/none تنظیم رنگ پس‌زمینه (پیش‌فرض: #FFFFFF)؛ برای حالت شفاف از \(lqnone\(rq استفاده کنید .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 رندر در جعبه منطقی (logical box) به جای اجتماع جعبه‌های منطقی و مرکب (ink box) .TP \fB\-\-ink\fR رندر در جعبه مرکب (ink box) به جای اجتماع جعبه‌های منطقی و مرکب .TP \fB\-\-show\-extents\fR رسم حدود و ابعاد (extents) گلیف .TP \fB\-\-draw\fR اجبار به استفاده از مسیر رسم تک‌رنگ (تشخیص خودکار را لغو می‌کند) .TP \fB\-\-paint\fR اجبار به استفاده از مسیر رنگ‌آمیزی رنگی (تشخیص خودکار را لغو می‌کند) .SS "گزینه‌های مقصد و قالب خروجی:" .TP \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,filename\/\fR تنظیم نام فایل خروجی (پیش‌فرض: stdout) .TP \fB\-O\fR, \fB\-\-output\-format\fR=\fI\,format\/\fR تنظیم قالب خروجی (پیش‌فرض: png) .IP قالب‌های خروجی پشتیبانی‌شده عبارتند از: png/svg/pdf/ps/eps/script/ansi .SS "گزینه‌های برنامه (Application Options):" .TP \fB\-\-version\fR نمایش شماره نسخه .TP \fB\-n\fR, \fB\-\-num\-iterations\fR=\fI\,N\/\fR اجرای N تکرار (پیش‌فرض: 1) .PP نمایش تصویر حاصل از رندر متن با یک قلم مشخص در قالب‌های گوناگون. .SH "وضعیت خروج (EXIT STATUS)" .IP 0: موفقیت‌آمیز. .IP 1: تجزیه گزینه‌ها با شکست مواجه شد. .IP 2: بارگذاری چهره قلم (font face) ناموفق بود. .IP 3: عملیات با شکست مواجه شد. .IP 4: تنظیم توابع قلم ناموفق بود. .SH "محیط (ENVIRONMENT)" .IP HB_FACE_LOADER=face\-loader؛ جایگزین بارگذار پیش‌فرض چهره قلم می‌شود. .IP HB_FONT_FUNCS=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 یافتن اطلاعات بیشتر یا گزارش باگ‌ها در