TTF2PK(1) General Commands Manual TTF2PK(1)

ttf2pk - تبدیل فونت TrueType به قالب PK متعلق به TeX

ttf2pk [-q] [-n] font-name resolution
ttf2pk -t [-q] font-name
ttf2pk --version | --help

این برنامه یک فونت TrueType را به یک فایل PK تبدیل می‌کند؛ سپس می‌توان از فونت ایجادشده با TeX یا LaTeX استفاده کرد.

زیرفونت‌های CJKV (چینی/ژاپنی/کره‌ای/ویتنامی باستان) ایجادشده توسط ttf2tfm نیز پشتیبانی می‌شوند.

دستور ttf2pk همواره مقدار 10pt را به عنوان اندازه طراحی (design size) برای فونت TeX نوشته‌شده در نظر می‌گیرد.

این سوییچ اختیاری ttf2pk را بی‌صدا می‌کند. این گزینه از نمایش هرگونه خروجی اطلاعاتی به جز پیام‌های هشدار و خطا جلوگیری می‌کند.
تنها از `.pk' به‌عنوان پسوند استفاده می‌کند، به جای `.<resolution>pk'.
وجود font-name را بررسی می‌کند. در صورت موفقیت، 0 را بازمی‌گرداند و در صورتی که سوییچ -q تنظیم نشده باشد، سطر متناظر در یک فایل نگاشت (پیش‌فرض: ttfonts.map) را چاپ می‌کند.
نام TeX فونت. دستور ttf2pk این نام را در یک فایل نگاشت (پایین‌تر را ببینید) جستجو می‌کند تا اطلاعات بیشتری درباره نحوه پردازش فونت به دست آورد.
میزان تفکیک‌پذیری (وضوح)، که بر حسب نقطه در اینچ (DPI) داده می‌شود. در حال حاضر تفکیک‌پذیری افقی برابر با تفکیک‌پذیری عمودی است. اندازه طراحی همواره 10pt فرض می‌شود.
نسخه فعلی ttf2pk و کتابخانه مورد استفاده برای جستجوی فایل (مانند kpathsea) را نشان می‌دهد.
اطلاعات نحوه استفاده را نشان می‌دهد.

متغیرهای محیطی برای جستجوی فایل در صفحه راهنمای ttf2tfm شرح داده شده‌اند.

دستور ttf2pk از یک فایل پیکربندی کوچک به نام ttf2pk.cfg استفاده می‌کند؛ در هر سطر آن یک کلمه کلیدی به همراه مقدارش قرار دارد که با نویسه فاصله (whitespace) جدا شده‌اند. سطرهای توضیح می‌توانند با هر یک از نویسه‌های زیر آغاز شوند: `*'، `#'، `;' و `%'. فاصله‌های خالی ابتدای سطر نادیده گرفته می‌شوند.

در حال حاضر، تنها یک کلمه کلیدی به نام `map' در این فایل شناخته می‌شود؛ این کلمه کلیدی نام یک فایل نگاشت را به عنوان پارامتر دریافت می‌کند. اگر هیچ پسوندی برای نام فایل نگاشت داده نشود، .map به انتهای آن افزوده می‌شود. استفاده از فاصله خالی در نام فایل نگاشت مجاز نیست. کلمه کلیدی `map' را می‌توان چندین بار برای تعیین چند فایل نگاشت مشخص کرد؛ اگر نام فایل نگاشت با یک علامت مثبت آغاز شود، به فهرست فایل‌های نگاشت مورد استفاده افزوده خواهد شد. مثال:


map foo
map +bar

این کار باعث می‌شود ttf2pk ابتدا foo.map و سپس bar.map را بخواند.

اگر فایل پیکربندی پیدا نشود، ttf2pk تلاش می‌کند به جای آن از ttfonts.map استفاده کند.

پارامترهای مشخص‌شده برای ttf2tfm در فایل‌های نگاشت برای ttf2pk حفظ می‌شوند—ttf2tfm به عنوان آخرین سطر، یک ورودی مناسب برای فایل نگاشت در خروجی استاندارد می‌نویسد.

به عنوان مثال، فراخوانی


ttf2tfm arial -p T1.enc -s 0.25 -P 1 -E 0 arials

سطر زیر را تولید خواهد کرد:


arials arial Slant=0.25 Pid=1 Eid=0 Encoding=T1.enc

برای شرح مفصل فایل‌های کدگذاری (encoding)، ttf2tfm(1) و afm2tfm(1) از بسته dvips را ببینید.

در ادامه، جدولی شامل پارامترهای گوناگون ttf2tfm و ورودی‌های متناظر آنها در یک فایل نگاشت آمده است:


-s Slant
-e Extend
-p Encoding
-f Fontindex
-P Pid
-E Eid
-n PS=Yes
-N PS=Only
-R Replacement
-x Rotate=Yes
-y Y-Offset

نام‌های گلیف جایگزین تکی داده‌شده به ttf2tfm با `-r old-glyphname new-glyphname' مستقیماً با `old-glyphname=new-glyphname' مشخص می‌شوند. اگر در حالت زیرفونت (subfont) باشد یا هیچ فایل کدگذاری مشخص نشده باشد، این موارد نادیده گرفته خواهند شد.

یک پارامتر اضافی در فایل نگاشت وجود دارد که مختص ttf2pk است: `Hinting'، که می‌تواند مقادیر `On' یا `Off' را بپذیرد. برخی فونت‌ها (مانند بخش CJK از cyberbit.ttf) در صورت فعال بودن hinting به درستی رندر نمی‌شوند. مقدار پیش‌فرض `On' است (همچنین می‌توانید از `Yes'، `No'، `1' و `0' استفاده کنید).

برای شرح زیرفونت‌ها (یعنی ورودی‌هایی به شکل `<namestem>@<sfd-filename>@') لطفاً به ttf2tfm(1) مراجعه کنید.

قالب یک فایل نگاشت ساده است. هر سطر یک فونت را تعریف می‌کند؛ ابتدا نام فونت TeX می‌آید، سپس نام فایل فونت TrueType آن، و پس از آن پارامترها با هر ترتیبی قرار می‌گیرند. بزرگی و کوچکی حروف اهمیت دارد (حتی برای نام پارامترها)؛ پارامترها با یک علامت مساوی از مقادیر خود جدا می‌شوند، و فاصله‌های خالی احتمالی در اطراف آن مجاز است. دستور ttf2pk تمام فایل‌های نگاشت را سطر به سطر با ترتیبی که در فایل پیکربندی آمده می‌خواند و این کار را تا زمانی که فونت TeX مشخص‌شده در خط فرمان پیدا شود ادامه می‌دهد؛ در غیر این صورت، برنامه با کد خطای 2 خارج می‌شود. بنابراین می‌توانید از هر نویسه‌ای که در نام فونت TeX نامعتبر است برای شروع یک سطر توضیح استفاده کنید.

می‌توانید از `\' به عنوان نویسه انتهایی یک سطر استفاده کنید تا مشخص شود که ورودی در سطر بعدی ادامه دارد. بک‌اسلش و نویسه خط جدیدِ پس از آن حذف خواهند شد.

اگر ttf2pk نتواند فایل معیارهای قلم (metrics) فونت TeX مربوط به نام فونت TeX داده‌شده را پیدا کند یا بخواند، متوقف خواهد شد.

اگر فراخوانی موفقیت‌آمیز باشد، مقدار 0 بازگردانده خواهد شد. در صورت بروز خطا، مقدار بازگشتی 1 است. در نهایت، اگر فونت در فایل‌های نگاشت پیدا نشود، مقدار 2 بازگردانده می‌شود. این امر گنجاندن ttf2pk را در اسکریپت‌هایی مانند mktexpk جهت تولید خودکار فونت آسان می‌سازد.

ttf2tfm(1), afm2tfm(1)

دستور ttf2pk بخشی از بسته FreeType 1 است؛ یک کتابخانه رندر TrueType با کیفیت بالا.

Werner LEMBERG <wl@gnu.org>
Frédéric LOYER <loyer@ensta.fr>

04-May-2011 FreeType2 version