نام (NAME)

ttx — ابزاری برای دستکاری و ویرایش قلم‌های TrueType و OpenType

خلاصه دستور (SYNOPSIS)

ttx [option ...] file ...

توضیحات (DESCRIPTION)

ttx ابزاری برای کار با قلم‌های TrueType و OpenType و ویرایش آن‌ها است. این برنامه می‌تواند قلم‌های TrueType و OpenType را به و از یک قالب مبتنی بر XML به نام TTX تبدیل کند. فایل‌های TTX دارای پسوند ‘.ttx’ هستند.

به ازای هر آرگومان file که دریافت می‌کند، ttx تشخیص می‌دهد که آیا یک فایل ‘.ttf ،’ ‘.otf’ یا ‘.ttx’ است و بر همان اساس عمل می‌کند: اگر یک فایل ‘.ttf’ یا ‘.otf’ باشد، یک فایل ‘.ttx’ تولید می‌کند؛ و اگر یک فایل ‘.ttx’ باشد، یک فایل ‘.ttf’ یا ‘.otf’ می‌سازد.

به‌طور پیش‌فرض، هر فایل خروجی در همان پوشهٔ مربوط به فایل ورودی و با همان نام ساخته می‌شود، به جز پسوند آن که به شکل مناسب جایگزین می‌گردد. ttx هرگز روی فایل‌های موجود بازنویسی نمی‌کند؛ در صورت لزوم، یک پسوند پیش از پسوند اصلی به نام فایل خروجی اضافه می‌کند، مانند Arial#1.ttf.

گزینه‌های عمومی (General options)

-h: نمایش اطلاعات نحوهٔ استفاده از دستور.
-d dir: نوشتن فایل‌های خروجی در پوشهٔ dir به جای ذخیرهٔ هر فایل خروجی در پوشهٔ فایل ورودی مربوطه.
-o file: نوشتن خروجی در فایل file به جای ذخیرهٔ آن در پوشهٔ فایل ورودی مربوطه.
-v: حالت پرگو (verbose). چاپ پیام‌های بیشتر در خروجی استاندارد برای توصیف عملیات در حال انجام.
-a: مجاز دانستن شناسه‌های گلیف مجازی (virtual glyph IDs) هنگام کامپایل یا دی‌کامپایل.

گزینه‌های استخراج (Dump options)

گزینه‌های زیر روند استخراج (dump) فایل‌های قلم (TrueType یا OpenType) به فایل‌های TTX را کنترل می‌کنند:

-l: فهرست کردن اطلاعات جدول‌ها. به جای استخراج قلم به یک فایل TTX ، اطلاعات حداقلی دربارهٔ هر جدول را نمایش می‌دهد.
-t table: استخراج جدول table. این گزینه می‌تواند چندین بار مشخص شود تا چند جدول به طور همزمان استخراج شوند. در صورت عدم تعیین، تمامی جدول‌ها استخراج می‌شوند.
-x table: مستثنی کردن جدول table از فهرست جدول‌های قابل استخراج. این گزینه را می‌توان چندین بار برای مستثنی کردن چندین جدول از عملیات استخراج به کار برد. گزینه‌های -t و -x مانعة‌الجمع هستند.
-s: جداسازی جدول‌ها. هر جدول را در یک فایل TTX جداگانه استخراج کرده و (تحت نامی که در صورت عدم استفاده از گزینهٔ -s برای فایل خروجی استفاده می‌شد) یک فایل کوچک TTX شامل ارجاعات به تک‌تک فایل‌های جدول استخراج‌شده ایجاد می‌کند. تا زمانی که فایل‌های ارجاع‌شده در همان پوشه موجود باشند، می‌توان از این فایل به عنوان ورودی برای ttx استفاده کرد.
-i: عدم دیس‌اسمبل دستورالعمل‌های TrueType. با تعیین این گزینه، تمام برنامه‌های TrueType (برنامه‌های گلیف، برنامهٔ قلم و پیش‌برنامه) به جای اسمبلی، به صورت داده‌های هگزادسیمال در فایل TTX نوشته می‌شوند. این کار در زمان صرفه‌جویی کرده و موجب کوچک‌تر شدن اندازهٔ فایل‌های TTX می‌شود.
-y n: هنگام دی‌کامپایل یک فایل مجموعه‌قلم TrueType (یا TTC)، قلم شمارهٔ n (شروع از 0) دی‌کامپایل شود.

گزینه‌های کامپایل (Compilation options)

گزینه‌های زیر روند کامپایل فایل‌های TTX به فایل‌های قلم (TrueType یا OpenType) را کنترل می‌کنند:

-m fontfile: ادغام فایل ورودی TTX به نام file با فایل قلم fontfile. هنگام استفاده از این گزینه، نمی‌توان بیش از یک آرگومان file مشخص کرد.
-b: عدم محاسبهٔ مجدد کادرهای مرزی گلیف (glyph bounding boxes). مقادیر موجود در فایل TTX عیناً استفاده می‌شوند.

قالب فایل TTX (THE TTX FILE FORMAT)

می‌توانید اطلاعاتی در مورد قالب پروندهٔ TTX در documentation.html بیابید. به‌ویژه، در آن فایل فهرست جدول‌های قابل پشتیبانی توسط ttx و ارتباط میان GlyphIDهای TrueType و نام‌های گلیفِ مورد استفاده در فایل‌های TTX ذکر شده است.

مثال‌ها (EXAMPLES)

در مثال‌های زیر، تمام فایل‌ها از پوشهٔ جاری خوانده شده و در همان پوشه نوشته می‌شوند. علاوه بر این، نام داده‌شده برای فایل خروجی در تمام موارد با این فرض است که پیش از اجرای ttx وجود نداشته است.

استخراج قلم TrueType موجود در FreeSans.ttf به FreeSans.ttx:

ttx FreeSans.ttf

کامپایل MyFont.ttx به یک فایل قلم TrueType یا OpenType:

ttx MyFont.ttx

فهرست کردن جدول‌های موجود در FreeSans.ttf به همراه خلاصه‌ای از اطلاعات:

ttx -l FreeSans.ttf

استخراج جدول ‘cmap’ از FreeSans.ttf به FreeSans.ttx:

ttx -t cmap FreeSans.ttf

نکات (NOTES)

در سیستم‌های MS-Windows و MacOS، ttx به عنوان یک برنامهٔ گرافیکی نیز در دسترس است که می‌توان فایل‌ها را در آن کشید و رها کرد (drag and drop).

همچنین ببینید (SEE ALSO)

documentation.html

fontforge(1), ftinfo(1), gfontview(1), xmbdfed(1), Font::TTF(3pm)

نویسندگان (AUTHORS)

ttx توسط Just van Rossum ⟨just@letterror.com⟩ نوشته شده است.

این صفحهٔ راهنما توسط Florent Rougon ⟨f.rougon@free.fr⟩ برای سیستم دبیان گنو/لینوکس بر اساس مستندات موجود FontTools نگاشته شده است. استفاده، تغییر و بازتوزیع آن بدون هیچ محدودیتی آزاد است.