.Dd May 18, 2004
.\" ttx is not specific to any OS, but contrary to what groff_mdoc(7)
.\" seems to imply, entirely omitting the .Os macro causes 'BSD' to
.\" be used, so I give a zero-width space as its argument.
.Os \&
.\" The "FontTools Manual" argument apparently has no effect in
.\" groff 1.18.1. I think it is a bug in the -mdoc groff package.
.Dt TTX 1 "FontTools Manual"
.Sh "نام (NAME)"
.Nm ttx
.Nd ابزاری برای دستکاری و ویرایش قلم‌های TrueType و OpenType
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Bk
.Op Ar option ...
.Ek
.Bk
.Ar file ...
.Ek
.Sh "توضیحات (DESCRIPTION)"
.Nm
ابزاری برای کار با قلم‌های TrueType و OpenType و ویرایش آن‌ها است. این برنامه می‌تواند قلم‌های
TrueType و OpenType را به و از یک قالب مبتنی بر
.Tn XML
به نام
.Tn TTX
تبدیل کند. فایل‌های
.Tn TTX
دارای پسوند
.Ql .ttx
هستند.
.Pp
به ازای هر آرگومان
.Ar file
که دریافت می‌کند،
.Nm
تشخیص می‌دهد که آیا یک فایل
.Ql .ttf ،
.Ql .otf
یا
.Ql .ttx
است و بر همان اساس عمل می‌کند: اگر یک فایل
.Ql .ttf
یا
.Ql .otf
باشد، یک فایل
.Ql .ttx
تولید می‌کند؛ و اگر یک فایل
.Ql .ttx
باشد، یک فایل
.Ql .ttf
یا
.Ql .otf
می‌سازد.
.Pp
به‌طور پیش‌فرض، هر فایل خروجی در همان پوشهٔ مربوط به فایل ورودی و با همان نام ساخته می‌شود، به جز پسوند آن که به شکل مناسب جایگزین می‌گردد.
.Nm
هرگز روی فایل‌های موجود بازنویسی نمی‌کند؛ در صورت لزوم، یک پسوند پیش از پسوند اصلی به نام فایل خروجی اضافه می‌کند، مانند
.Pa Arial#1.ttf .
.Ss "گزینه‌های عمومی (General options)"
.Bl -tag -width ".Fl t Ar table"
.It Fl h
نمایش اطلاعات نحوهٔ استفاده از دستور.
.It Fl d Ar dir
نوشتن فایل‌های خروجی در پوشهٔ
.Ar dir
به جای ذخیرهٔ هر فایل خروجی در پوشهٔ فایل ورودی مربوطه.
.It Fl o Ar file
نوشتن خروجی در فایل
.Ar file
به جای ذخیرهٔ آن در پوشهٔ فایل ورودی مربوطه.
.It Fl v
حالت پرگو (verbose). چاپ پیام‌های بیشتر در خروجی استاندارد برای توصیف عملیات در حال انجام.
.It Fl a
مجاز دانستن شناسه‌های گلیف مجازی (virtual glyph IDs) هنگام کامپایل یا دی‌کامپایل.
.El
.Ss "گزینه‌های استخراج (Dump options)"
گزینه‌های زیر روند استخراج (dump) فایل‌های قلم (TrueType یا OpenType) به فایل‌های
.Tn TTX
را کنترل می‌کنند:
.Bl -tag -width ".Fl t Ar table"
.It Fl l
فهرست کردن اطلاعات جدول‌ها. به جای استخراج قلم به یک فایل
.Tn TTX ،
اطلاعات حداقلی دربارهٔ هر جدول را نمایش می‌دهد.
.It Fl t Ar table
استخراج جدول
.Ar table .
این گزینه می‌تواند چندین بار مشخص شود تا چند جدول به طور همزمان استخراج شوند. در صورت عدم تعیین، تمامی جدول‌ها استخراج می‌شوند.
.It Fl x Ar table
مستثنی کردن جدول
.Ar table
از فهرست جدول‌های قابل استخراج. این گزینه را می‌توان چندین بار برای مستثنی کردن چندین جدول از عملیات استخراج به کار برد. گزینه‌های
.Fl t
و
.Fl x
مانعة‌الجمع هستند.
.It Fl s
جداسازی جدول‌ها. هر جدول را در یک فایل
.Tn TTX
جداگانه استخراج کرده و (تحت نامی که در صورت عدم استفاده از گزینهٔ
.Fl s
برای فایل خروجی استفاده می‌شد) یک فایل کوچک
.Tn TTX
شامل ارجاعات به تک‌تک فایل‌های جدول استخراج‌شده ایجاد می‌کند. تا زمانی که فایل‌های ارجاع‌شده در همان پوشه موجود باشند، می‌توان از این فایل به عنوان ورودی برای
.Nm
استفاده کرد.
.It Fl i
.\" XXX: I suppose OpenType programs (exist and) are also affected.
عدم دیس‌اسمبل دستورالعمل‌های TrueType. با تعیین این گزینه، تمام برنامه‌های TrueType (برنامه‌های گلیف، برنامهٔ قلم و پیش‌برنامه) به جای اسمبلی، به صورت داده‌های هگزادسیمال در فایل
.Tn TTX
نوشته می‌شوند. این کار در زمان صرفه‌جویی کرده و موجب کوچک‌تر شدن اندازهٔ فایل‌های
.Tn TTX
می‌شود.
.It Fl y Ar n
هنگام دی‌کامپایل یک فایل مجموعه‌قلم TrueType (یا TTC)، قلم شمارهٔ
.Ar n
(شروع از 0) دی‌کامپایل شود.
.El
.Ss "گزینه‌های کامپایل (Compilation options)"
گزینه‌های زیر روند کامپایل فایل‌های
.Tn TTX
به فایل‌های قلم (TrueType یا OpenType) را کنترل می‌کنند:
.Bl -tag -width ".Fl t Ar table"
.It Fl m Ar fontfile
ادغام فایل ورودی
.Tn TTX
به نام
.Ar file
با فایل قلم
.Ar fontfile .
هنگام استفاده از این گزینه، نمی‌توان بیش از یک آرگومان
.Ar file
مشخص کرد.
.It Fl b
عدم محاسبهٔ مجدد کادرهای مرزی گلیف (glyph bounding boxes). مقادیر موجود در فایل
.Tn TTX
عیناً استفاده می‌شوند.
.El
.Sh "قالب فایل TTX (THE TTX FILE FORMAT)"
می‌توانید اطلاعاتی در مورد قالب پروندهٔ
.Tn TTX
در
.Pa documentation.html
بیابید. به‌ویژه، در آن فایل فهرست جدول‌های قابل پشتیبانی توسط
.Nm
و ارتباط میان GlyphIDهای TrueType و نام‌های گلیفِ مورد استفاده در فایل‌های
.Tn TTX
ذکر شده است.
.Sh "مثال‌ها (EXAMPLES)"
در مثال‌های زیر، تمام فایل‌ها از پوشهٔ جاری خوانده شده و در همان پوشه نوشته می‌شوند. علاوه بر این، نام داده‌شده برای فایل خروجی در تمام موارد با این فرض است که پیش از اجرای
.Nm
وجود نداشته است.
.Pp
استخراج قلم TrueType موجود در
.Pa FreeSans.ttf
به
.Pa FreeSans.ttx :
.Pp
.Dl ttx FreeSans.ttf
.Pp
کامپایل
.Pa MyFont.ttx
به یک فایل قلم TrueType یا OpenType:
.Pp
.Dl ttx MyFont.ttx
.Pp
فهرست کردن جدول‌های موجود در
.Pa FreeSans.ttf
به همراه خلاصه‌ای از اطلاعات:
.Pp
.Dl ttx -l FreeSans.ttf
.Pp
استخراج جدول
.Sq cmap
از
.Pa FreeSans.ttf
به
.Pa FreeSans.ttx :
.Pp
.Dl ttx -t cmap FreeSans.ttf
.Sh "نکات (NOTES)"
در سیستم‌های MS\-Windows و MacOS،
.Nm
به عنوان یک برنامهٔ گرافیکی نیز در دسترس است که می‌توان فایل‌ها را در آن کشید و رها کرد (drag and drop).
.Sh "همچنین ببینید (SEE ALSO)"
.Pa documentation.html
.Pp
.Xr fontforge 1 ,
.Xr ftinfo 1 ,
.Xr gfontview 1 ,
.Xr xmbdfed 1 ,
.Xr Font::TTF 3pm
.Sh "نویسندگان (AUTHORS)"
.Nm
توسط
.An -nosplit
.An "Just van Rossum" Aq just@letterror.com
نوشته شده است.
.Pp
این صفحهٔ راهنما توسط
.An "Florent Rougon" Aq f.rougon@free.fr
برای سیستم دبیان گنو/لینوکس بر اساس مستندات موجود FontTools نگاشته شده است. استفاده، تغییر و بازتوزیع آن بدون هیچ محدودیتی آزاد است.
.\" For Emacs:
.\" Local Variables:
.\" fill-column: 72
.\" sentence-end: "[.?!][]\"')}]*\\($\\| $\\|   \\|  \\)[   \n]*"
.\" sentence-end-double-space: t
.\" End: