PS2PK(1) General Commands Manual PS2PK(1)

ps2pk - ایجاد یک pkfont برای TeX از یک قلم PostScript نوع type1

ps2pk [ -v ] [ -eenc ] [ -Xxres ] [ -Eexpansion ] [ -Sslant ] [ -Ppointsize ] [ -Rbaseres ] [ -raspectratio ] [ -Yyres ] [ -aAFMfile ] [ -mmodename ] type1 [pkfont]

این برنامه یک قلم PostScript نوع type1 مشخص را در اندازه قلم (pointsize) داده‌شده (پیش‌فرض 10.0 پوینت) و وضوح داده‌شده (پیش‌فرض 300dpi) به یک pkfont برای TeX تبدیل (رندر) می‌کند.

برای تولید pkfont، دستور ps2pk به یک فایل قلم معتبر type1 (برای نمونه Utopia-Regular، Utopia-Regula.pfb یا Utopia-Regula.pfa) و فایل AFM متناظر با آن (Utopia-Regular.afm) حاوی معیارهای متریك قلم (font metrics) نیاز دارد. این برنامه هم قالب باینری type1 (یعنی Utopia-Regula.pfb) و هم معادل ASCII آن (Utopia-Regular یا Utopia-Regula.pfa) را می‌پذیرد. برای یافتن فایل‌ها، ps2pk از کتابخانه kpathsea استفاده می‌کند (صفحه info مربوط به kpathsea را ببینید). علاوه بر این، در صورت تنظیم بودن متغیرهای محیطی، فایل‌های pfb و pfa در دایرکتوری مشخص‌شده در متغیر محیطی T1INPUTS، و فایل‌های afm در AFMFONTS جستجو می‌شوند (پرچم -v گزارش می‌دهد که چه نام‌فایل‌هایی جستجو می‌شوند).

این برنامه یک pkfont تولید خواهد کرد که در آن کدهای نویسه‌ها از مقادیر تعریف‌شده آن‌ها در AFM (مخفف Adobe Font Metrics) مشتق می‌شوند. این رفتار را می‌توان با مشخص کردن یک فایل کدگذاری صریح از طریق گزینه -e لغو و بازنویسی کرد. فایل کدگذاری enc باید حاوی یک کدگذاری معتبر PostScript شامل نام‌های PostScript مانند /hyphen باشد. در اینجا یک نمونه ناقص آورده شده است (برای نحو کامل دستور afm2tfm را ببینید):

% This is the EC encoding.
/ECEncoding [          % now 256 chars follow
% 0x00
  /grave /acute /circumflex /tilde /dieresis /hungarumlaut
  /ring /caron /breve /macron /dotaccent /cedilla
  /ogonek /quotesinglbase /guilsinglleft /guilsinglright
  (Rest of lines omitted.)
% 0xF0
  /eth /ntilde /ograve /oacute /ocircumflex /otilde
  /odieresis /oe /oslash /ugrave /uacute /ucircumflex
  /udieresis /yacute /thorn /germandbls ] def

گزینه‌ها و آرگومان‌ها:

نام مورد استفاده برای مکان‌یابی فایل AFM را لغو و بازنویسی می‌کند.
نام فایلی شامل یک طرح کدگذاری (پیش‌فرض - کدگذاری نام‌برده‌شده در فایل AFM استفاده می‌شود). نام واقعی طرح کدگذاری در PostScript به‌صورت یک "ویژه" (special) در انتهای pkfont نوشته می‌شود.
ضریب بسط یا کشیدگی (مقدار حقیقی، پیش‌فرض 1.0).
نام یک حالت (modename) نظیر آنچه توسط METAFONT استفاده می‌شود (پیش‌فرض "Unknown mode").
اندازه قلم (pointsize) مورد نظر (مقدار حقیقی، پیش‌فرض 10.0 پوینت).
وضوح پایه مورد نظر (مقدار صحیح، پیش‌فرض 300 dpi). اگر این مقدار با مقدار xres تفاوت داشته باشد، بزرگ‌نمایی مناسب در "specials" انتهای pkfont نمایش داده خواهد شد. در صورت امکان، این مقدار به‌صورت یک magstep و در غیر این صورت به‌صورت یک عدد حقیقی بیان می‌شود. برای نمونه، یک pkfont با xres برابر 329 با استفاده از وضوح پایه پیش‌فرض 300، شامل متن ویژه "mag=magstep(0.5)" در انتهای قلم خواهد بود.
نسبت ابعاد مورد نظر (عبارت، integerY/integerX، پیش‌فرض 300/300). این مقدار در "specials" در انتهای pkfont نشان داده خواهد شد. تعیین نسبت ابعاد، مقداری برای yres ایجاد می‌کند، اما یک مقدار صریح برای yres اولویت خواهد داشت. اگر در اطراف '/' فاصله وجود داشته باشد، آرگومان باید در "" قرار گیرد.
میزان کجی یا شیب (مقدار حقیقی، پیش‌فرض 0.0).
وضوح در راستای X (مقدار صحیح، پیش‌فرض 300 dpi).
وضوح در راستای Y (مقدار صحیح، پیش‌فرض مقدار xres است). اگر yres با xres متفاوت باشد، یک متن "special" که نسبت ابعاد را مشخص می‌کند در انتهای pkfont نوشته خواهد شد.
پرچم پرگویی (نمایش می‌دهد که برنامه در حال انجام چه کاری است).
نام قلم PostScript type1. نام فایل AFM از روی این نام با حذف پسوند (در صورت وجود) و افزودن ".afm" ساخته خواهد شد. ویژگی "FontName" مربوط به PostScript از فایل AFM استخراج شده و در یک "special" در انتهای pkfont نوشته می‌شود.
[pkfont]
نام pkfont حاصل را می‌توان با این نام بازنویسی کرد. نام پیش‌فرض pkfont از نام پایه قلم type1، اندازه قلم (pointsize) و xres مشتق می‌شود. برای نمونه `ps2pk -P17.28 Utopia-Regular` خروجی `Utopia-Regular17.300pk` را تولید خواهد کرد. وقتی نام قلم type1 خود اندازه قلم را نشان می‌دهد، تعیین یک مقدار صریح برای نام pkfont ضروری است؛ در غیر این صورت مقدار pointsize به انتهای نام پایه pkfont الحاق می‌شود که معمولاً مطلوب نیست.

دستورهای ویژه "specials" زیر در PK، بررسی درونی ویژگی‌های pkfont را مطابق با توصیه‌های گروه کاری TeX درباره استاندارد دایرکتوری TeX (به اختصار TWG-TDS) ارائه می‌دهند:
"fontid=FontName"، "codingscheme=Encoding"، "fontfacebyte"، "mag"، "mode=(ps2pk)modename"، "pixels-per-inch"، و "aspect-ratio" در صورتی که مقداری جز یک داشته باشد.

این برنامه از نرم‌افزار راهنمایی (hinting) و رندر قلم Type1 که IBM به کنسرسیوم X اهدا کرده است، استفاده می‌کند.

`METAFONT: The Program', Donald Knuth.
`The GFtoPK processor', belonging to the METAFONTware.
`Adobe Font Metric Files', Version 3.0, PostScript Developer
Support Group.
afm2tfm(1)
pk2bm(1)
kpsewhich(1)
info kpathsea

1.4 (ژانویه 1994)

Piet Tutelaers، اصلاح‌شده برای ps2pkm توسط Pierre A. Mackay. این صفحه راهنما توسط Frank Kuester برای teTeX سازگار شد.

در TeX Live نگه‌داری می‌شود؛ لطفاً گزارش باگ‌ها یا سایر مکاتبات را به tex-k@tug.org (https://lists.tug.org/tex-k) ارسال کنید.

30 August 2022