.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. .TH HB-SHAPE "1" "August 2026" "HarfBuzz 14.4.0" "User Commands" .SH "نام (NAME)" hb\-shape \- شکل‌دهی به متن با قلم داده‌شده. .SH "توضیحات (DESCRIPTION)" .SS "کاربرد:" .IP hb\-shape [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 گزینه‌های مربوط به متغیرهای قلم (font variations) مورد استفاده .TP \fB\-\-help\-text\fR گزینه‌های مربوط به متن ورودی .TP \fB\-\-help\-text\-context\fR گزینه‌های مربوط به متن زمینه ورودی (context text) .TP \fB\-\-help\-shape\fR گزینه‌های مربوط به فرایند شکل‌دهی (shaping) .TP \fB\-\-help\-features\fR گزینه‌های مربوط به ویژگی‌های قلم (font features) مورد استفاده .TP \fB\-\-help\-output\fR گزینه‌های مربوط به مقصد و ساختار خروجی .TP \fB\-\-help\-output\-syntax\fR گزینه‌های مربوط به نحو (syntax) خروجی .SS "گزینه‌های چهره قلم (Font-face):" .TP \fB\-\-font\-file\fR=\fI\,filename\/\fR تنظیم نام فایل قلم .TP \fB\-y\fR, \fB\-\-face\-index\fR=\fI\,index\/\fR تنظیم نمایه (index) چهره قلم (پیش‌فرض: 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' اندازه قلم (پیش‌فرض: 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 تنظیم load\-flags مربوط به FreeType (پیش‌فرض: 2).SS "گزینه‌های دگرسانی (Variations options):" .TP \fB\-\-named\-instance\fR=\fI\,index\/\fR تنظیم نمایهٔ named\-instance (پیش‌فرض: none) .TP \fB\-\-variations\fR=\fI\,list\/\fR فهرست جداشده با کاما از دگرسانی‌های قلم .IP دگرسانی‌ها به‌صورت سراسری تنظیم می‌شوند. قالب تعیین تنظیمات دگرسانی در ادامه آمده است. تمام مقادیر معتبر font\-variation\-settings در CSS به جز \(aqnormal\(aq و \(aqinherited\(aq نیز پذیرفته می‌شوند، اگرچه در ادامه مستند نشده‌اند. .IP قالب عبارت است از یک برچسب، که به‌صورت اختیاری با یک علامت مساوی و سپس یک عدد دنبال می‌شود. برای نمونه: .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 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 تنظیم شکل‌دهنده‌ها (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 تنظیم خط متن (پیش‌فرض: 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\-Ignorables .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 بازآرایی خوشه‌های گلیف به ترتیب اسمی (nominal order) .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 "گزینه‌های ویژگی‌ها:" .TP \fB\-\-features\fR=\fI\,list\/\fR فهرستی از ویژگی‌های قلم که با کاما از هم جدا شده‌اند .IP ویژگی‌ها را می‌توان به‌صورت سراسری یا محدود به بازه‌های مشخصی از نویسه‌ها فعال یا غیرفعال کرد. قالب مشخص کردن تنظیمات ویژگی در ادامه آمده است. تمام مقادیر معتبر font\-feature\-settings در CSS به‌جز 'normal' و مقادیر سراسری نیز پذیرفته می‌شوند، هرچند در ادامه مستند نشده‌اند. نویسه‌های گریز (escape) در رشته‌های CSS پشتیبانی نمی‌شوند. اندیس‌های بازه به موقعیت‌های بین نویسه‌های یونیکد اشاره دارند، مگر اینکه \fB\-\-utf8\-clusters\fR مشخص شده باشد که در این صورت اندیس‌های بازه به اندیس‌های بایت UTF\-8 اشاره دارند. موقعیت پیش از اولین نویسه همیشه ۰ است. .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 "گزینه‌های مقصد و قالب خروجی:" .TP \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,filename\/\fR تنظیم نام فایل خروجی (پیش‌فرض: stdout) .TP \fB\-O\fR, \fB\-\-output\-format\fR=\fI\,format\/\fR تنظیم قالب خروجی (پیش‌فرض: text) .IP قالب‌های خروجی پشتیبانی‌شده عبارتند از: text/json .SS "نحو خروجی:" .IP text: [=@,+,|...] json: [{"g": , "ax": , "ay": , "dx": , "dy": , "cl": }, ...] .SS "گزینه‌های نحو خروجی:" .TP \fB\-\-show\-text\fR افزودن متن ورودی متناظر به ابتدای هر خط خروجی .TP \fB\-\-show\-unicode\fR افزودن نقطه‌کد(های) ورودی متناظر به ابتدای هر خط خروجی .TP \fB\-\-show\-line\-num\fR افزودن شماره خط ورودی متناظر به ابتدای هر خط خروجی .TP \fB\-v\fR, \fB\-\-verbose\fR افزودن تمام موارد بالا به ابتدای هر خط خروجی .TP \fB\-\-no\-glyph\-names\fR چاپ اندیس‌های گلیف به‌جای نام‌ها در خروجی .TP \fB\-\-no\-positions\fR عدم نمایش موقعیت‌های گلیف در خروجی .TP \fB\-\-no\-advances\fR عدم نمایش پیشروی‌های گلیف در خروجی .TP \fB\-\-no\-clusters\fR عدم نمایش اندیس‌های خوشه در خروجی .TP \fB\-\-show\-extents\fR نمایش ابعاد گلیف (extents) در خروجی .TP \fB\-\-show\-flags\fR نمایش پرچم‌های گلیف در خروجی .TP \fB\-\-ned\fR بدون داده اضافی (No Extra Data)؛ عدم نمایش خوشه‌ها یا پیشروی‌ها در خروجی .TP \fB\-V\fR, \fB\-\-trace\fR نمایش نتایج شکل‌دهی میانی در خروجی.SS "گزینه‌های برنامه (Application Options):" .TP \fB\-\-version\fR نمایش شماره‌های نسخه .TP \fB\-n\fR, \fB\-\-num\-iterations\fR=\fI\,N\/\fR اجرای \fIN\/\fR تکرار (پیش‌فرض: ۱) .PP نتایج شکل‌دهی متن با یک قلم مشخص‌شده را در قالب متنی یا JSON نمایش می‌دهد. .SH "کدهای خروج (EXIT CODES)" .IP 0: موفقیت‌آمیز. .IP 1: تجزیهٔ گزینه‌ها ناموفق بود. .IP 2: بارگذاری چهرهٔ قلم (font face) با شکست مواجه شد. .IP 3: عملیات با شکست مواجه شد. .IP 4: تنظیم توابع قلم با شکست مواجه شد. .SH "محیط (ENVIRONMENT)" .IP HB_FACE_LOADER=face\-loader؛ بارگذار پیش‌فرض چهرهٔ قلم (face loader) را بازنویسی می‌کند. .IP HB_FONT_FUNCS=font\-funcs؛ توابع پیش‌فرض قلم (font\-funcs) را بازنویسی می‌کند. .IP HB_SHAPER_LIST=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 برای کسب اطلاعات بیشتر یا گزارش باگ‌ها به مراجعه کنید.