.\" man page for ttf2pk
.
.TH TTF2PK 1 04-May-2011 "FreeType2 version"
.SH "نام (NAME)"
ttf2pk \- تبدیل فونت TrueType به قالب PK متعلق به TeX
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nh
.B ttf2pk
.RB [ \-q ]
.RB [ \-n ]
.I "\%font-name \%resolution"
.br
.B ttf2pk
.B \-t
.RB [ \-q ]
.I \%font-name
.br
.B "ttf2pk \-\^\-version"
|
.B \-\^\-help
.ad
.hy
.
.
.
.\" ====
.\" ==== macro definitions
.\" ====
.
.\" here we define \TeX for troff and nroff
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.
.\" and here the same for \LaTeX
.if t \{\
.ie '\*(.T'dvi' \
.ds LX \fRL\h'-0.36m'\v'-0.15v'\s-3A\s0\h'-0.15m'\v'0.15v'\fP\*(TX
.el .ds LX \fRL\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\fP\*(TX
.\}
.if n .ds LX LaTeX
.
.\" \LaTeXe
.\" note that we need \vareps for TeX instead of \eps which can only be
.\" accessed with the \N escape sequence (in the Math Italic font)
.if t \{\
.ie '\*(.T'dvi' .ds LE \*(LX\h'0.15m'2\v'0.20v'\f(MI\N'34'\fP\v'-0.20v'
.el .ds LE \*(LX\h'0.15m'2\v'0.20v'\(*e\v'-0.20v'
.\}
.if n .ds LE LaTeX\ 2e
.
.\" a typewriter font
.if t \{\
.de C
\fC\\$1\fP\\$2
..
.\}
.if n \{\
.de C
\\$1\\$2
..
.\}
.
.\" ====
.\" ==== end of macro definitions
.\" ====
.
.
.
.SH "توضیحات (DESCRIPTION)"
این برنامه یک فونت TrueType را به یک فایل
.C PK
تبدیل می‌کند؛ سپس می‌توان از فونت ایجادشده با \*(TX
یا \*(LX
استفاده کرد.
.PP
زیرفونت‌های CJKV (چینی/ژاپنی/کره‌ای/ویتنامی باستان) ایجادشده توسط
.B ttf2tfm
نیز پشتیبانی می‌شوند.
.PP
دستور
.B ttf2pk
همواره مقدار 10pt را به عنوان اندازه طراحی (design size) برای فونت \*(TX
نوشته‌شده در نظر می‌گیرد.
.
.
.SH "پارامترها (PARAMETERS)"
.TP
.B \-q
این سوییچ اختیاری
.B ttf2pk
را بی‌صدا می‌کند.
این گزینه از نمایش هرگونه خروجی اطلاعاتی به جز پیام‌های هشدار و خطا جلوگیری می‌کند.
.TP
.B \-n
تنها از `\c
.C \&.pk '
به‌عنوان پسوند استفاده می‌کند، به جای `\c
.C \&. \c
.RI < \%resolution >\c
.C pk '.
.TP
.B \-t
وجود
.IR \%font-name
را بررسی می‌کند.
در صورت موفقیت، 0 را بازمی‌گرداند و در صورتی که سوییچ
.B \-q
تنظیم نشده باشد، سطر متناظر در یک فایل نگاشت (پیش‌فرض:
.C \%ttfonts.map )
را چاپ می‌کند.
.TP
.I font-name
نام \*(TX
فونت.
دستور
.B ttf2pk
این نام را در یک فایل نگاشت (پایین‌تر را ببینید) جستجو می‌کند تا اطلاعات بیشتری درباره نحوه پردازش فونت به دست آورد.
.TP
.I resolution
میزان تفکیک‌پذیری (وضوح)، که بر حسب نقطه در اینچ (DPI) داده می‌شود.
در حال حاضر تفکیک‌پذیری افقی برابر با تفکیک‌پذیری عمودی است.
اندازه طراحی همواره 10pt فرض می‌شود.
.TP
.B \-\^\-version
نسخه فعلی
.B ttf2pk
و کتابخانه مورد استفاده برای جستجوی فایل (مانند\ \c
.BR kpathsea )
را نشان می‌دهد.
.TP
.B \-\^\-help
اطلاعات نحوه استفاده را نشان می‌دهد.
.PP
متغیرهای محیطی برای جستجوی فایل در صفحه راهنمای
.BR ttf2tfm
شرح داده شده‌اند.
.
.
.SH "فایل پیکربندی (THE CONFIGURATION FILE)"
دستور
.B ttf2pk
از یک فایل پیکربندی کوچک به نام
.C ttf2pk.cfg
استفاده می‌کند؛ در هر سطر آن یک کلمه کلیدی به همراه مقدارش قرار دارد که با نویسه فاصله (whitespace) جدا شده‌اند.
سطرهای توضیح می‌توانند با هر یک از نویسه‌های زیر آغاز شوند: `*'، `#'، `;' و `%'.
فاصله‌های خالی ابتدای سطر نادیده گرفته می‌شوند.
.PP
در حال حاضر، تنها یک کلمه کلیدی به نام `map' در این فایل شناخته می‌شود؛ این کلمه کلیدی نام یک فایل نگاشت را به عنوان پارامتر دریافت می‌کند.
اگر هیچ پسوندی برای نام فایل نگاشت داده نشود،
.C \&.map
به انتهای آن افزوده می‌شود.
استفاده از فاصله خالی در نام فایل نگاشت مجاز نیست.
کلمه کلیدی `map' را می‌توان چندین بار برای تعیین چند فایل نگاشت مشخص کرد؛ اگر نام فایل نگاشت با یک علامت مثبت آغاز شود، به فهرست فایل‌های نگاشت مورد استفاده افزوده خواهد شد.
مثال:
.PP
.in +2m
.C "map  foo"
.br
.C "map +bar"
.PP
این کار باعث می‌شود
.B ttf2pk
ابتدا
.C foo.map
و سپس
.C bar.map
را بخواند.
.PP
اگر فایل پیکربندی پیدا نشود،
.B ttf2pk
تلاش می‌کند به جای آن از
.C \%ttfonts.map
استفاده کند.
.
.
.SH "فایل‌های نگاشت (MAP FILES)"
پارامترهای مشخص‌شده برای
.B ttf2tfm
در فایل‌های نگاشت برای
.B ttf2pk
حفظ می‌شوند\(em\c
.B ttf2tfm
به عنوان آخرین سطر، یک ورودی مناسب برای فایل نگاشت در خروجی استاندارد می‌نویسد.
.PP
به عنوان مثال، فراخوانی
.PP
.in +2m
.C "ttf2tfm arial -p T1.enc -s 0.25 -P 1 -E 0 arials"
.PP
سطر زیر را تولید خواهد کرد:
.PP
.in +2m
.C "arials   arial Slant=0.25 Pid=1 Eid=0 Encoding=T1.enc"
.PP
برای شرح مفصل فایل‌های کدگذاری (encoding)،
.BR ttf2tfm (1)
و
.BR afm2tfm (1)
از بسته
.B dvips
را ببینید.
.PP
در ادامه، جدولی شامل پارامترهای گوناگون
.B ttf2tfm
و ورودی‌های متناظر آنها در یک فایل نگاشت آمده است:
.PP
.in +4m
.ta 2i
-s	Slant
.br
-e	Extend
.br
-p	Encoding
.br
-f	Fontindex
.br
-P	Pid
.br
-E	Eid
.br
-n	PS=Yes
.br
-N	PS=Only
.br
-R	Replacement
.br
-x	Rotate=Yes
.br
-y	Y-Offset
.PP
نام‌های گلیف جایگزین تکی داده‌شده به
.B ttf2tfm
با `\c
.BI \-r \ old-glyphname\ new-glyphname\c
\&'
مستقیماً با `\c
.IR old-glyphname = new-glyphname '
مشخص می‌شوند.
اگر در حالت زیرفونت (subfont) باشد یا هیچ فایل کدگذاری مشخص نشده باشد، این موارد نادیده گرفته خواهند شد.
.PP
یک پارامتر اضافی در فایل نگاشت وجود دارد که مختص
.BR ttf2pk
است:
`Hinting'، که می‌تواند مقادیر `On' یا `Off' را بپذیرد.
برخی فونت‌ها (مانند بخش CJK از
.C \%cyberbit.ttf )
در صورت فعال بودن hinting به درستی رندر نمی‌شوند.
مقدار پیش‌فرض `On' است (همچنین می‌توانید از `Yes'، `No'، `1' و `0' استفاده کنید).
.PP
برای شرح زیرفونت‌ها (یعنی ورودی‌هایی به شکل `\c
.I <namestem>\c
.C @\c
.I <sfd-filename>\c
.C @ ')
لطفاً به
.BR ttf2tfm (1)
مراجعه کنید.
.PP
قالب یک فایل نگاشت ساده است.
هر سطر یک فونت را تعریف می‌کند؛ ابتدا نام فونت \*(TX
می‌آید، سپس نام فایل فونت TrueType آن، و پس از آن پارامترها با هر ترتیبی قرار می‌گیرند.
بزرگی و کوچکی حروف اهمیت دارد (حتی برای نام پارامترها)؛ پارامترها با یک علامت مساوی از مقادیر خود جدا می‌شوند، و فاصله‌های خالی احتمالی در اطراف آن مجاز است.
دستور
.B ttf2pk
تمام فایل‌های نگاشت را سطر به سطر با ترتیبی که در فایل پیکربندی آمده می‌خواند و این کار را تا زمانی که فونت \*(TX
مشخص‌شده در خط فرمان پیدا شود ادامه می‌دهد؛ در غیر این صورت، برنامه با کد خطای\ 2 خارج می‌شود.
بنابراین می‌توانید از هر نویسه‌ای که در نام فونت \*(TX
نامعتبر است برای شروع یک سطر توضیح استفاده کنید.
.PP
می‌توانید از `\\' به عنوان نویسه انتهایی یک سطر استفاده کنید تا مشخص شود که ورودی در سطر بعدی ادامه دارد.
بک‌اسلش و نویسه خط جدیدِ پس از آن حذف خواهند شد.
.PP
اگر
.B ttf2pk
نتواند فایل معیارهای قلم (metrics) فونت \*(TX
مربوط به نام فونت \*(TX
داده‌شده را پیدا کند یا بخواند، متوقف خواهد شد.
.
.
.SH "مقدار بازگشتی (RETURN VALUE)"
اگر فراخوانی موفقیت‌آمیز باشد، مقدار 0\ بازگردانده خواهد شد.
در صورت بروز خطا، مقدار بازگشتی 1\ است.
در نهایت، اگر فونت در فایل‌های نگاشت پیدا نشود، مقدار 2\ بازگردانده می‌شود.
این امر گنجاندن
.B ttf2pk
را در اسکریپت‌هایی مانند
.B mktexpk
جهت تولید خودکار فونت آسان می‌سازد.
.
.
.SH "همچنین ببینید (SEE ALSO)"
.BR ttf2tfm (1),
.BR afm2tfm (1)
.
.
.SH "در دسترس بودن (AVAILABILITY)"
دستور
.B ttf2pk
بخشی از بسته FreeType\ 1 است؛ یک کتابخانه رندر TrueType با کیفیت بالا.
.
.
.SH "نویسندگان (AUTHORS)"
Werner LEMBERG
.C <wl@gnu.org>
.br
Fr\('ed\('eric LOYER
.C <loyer@ensta.fr>