GSFTOPK(1) General Commands Manual GSFTOPK(1)

gsftopk - رندر کردن قلم‌های Ghostscript در قالب TeX pk

gsftopk [-i path] [-q] [-t] [--debug=n] [--dosnames] [--interpreter=path] [--mapline=line] [--mapfile=file] [--quiet] [--test] [--help] [--version] font dpi

نام قلمی که باید ایجاد شود.
تفکیک‌پذیری مورد نظر قلم برای ایجاد، بر حسب نقطه در اینچ (dpi). این مقدار می‌تواند یک عدد حقیقی باشد.

gsftopk برنامه‌ای است که برنامه Ghostscript یعنی gs(1) را برای رندر کردن یک قلم معین با یک تفکیک‌پذیری مشخص فراخوانی می‌کند. این برنامه نویسه‌های حاصل را در قالب فایل pk بسته‌بندی کرده و آنها را در فایلی می‌نویسد که نام آن از نام قلم و تفکیک‌پذیری (گرد شده به نزدیک‌ترین عدد صحیح) تشکیل می‌شود. قلم می‌تواند در هر قالبی باشد که برای Ghostscript قابل پذیرش است، از جمله فایل‌های .pfa، .pfb، .gsf و .ttf.

این برنامه معمولاً باید توسط یک اسکریپت، مانند mktexpk، فراخوانی شود تا قلم‌ها را بر حسب تقاضا ایجاد کند.

gsftopk عرض نویسه‌ها را از فایل .tfm که باید در مسیر جستجوی استاندارد موجود باشد، دریافت می‌کند. همچنین باید بتواند قلم را در یک فایل نگاشت (مانند psfonts.map) با قالبی مشابه با آنچه در dvips(1) آمده است پیدا کند، مگر اینکه از گزینه --mapline استفاده شود. مجموعه فایل‌های نگاشت توسط گزینه --mapfile یا در فایل‌های config.ps، $HOME/.dvipsrc و config.gsftopk (مشابه حالتی که توسط dvips -Pgsftopk استفاده می‌شود) مشخص می‌گردد.

موارد ویژه («specials») زیر در قالب pk به انتهای فایل خروجی افزوده می‌شوند تا یک بررسی داخلی روی محتوای فایل فراهم کنند: "jobname=font"، "mag=1"، "mode=modeless" و "pixels_per_inch=dpi". این کار مطابق با استاندارد دایرکتوری TeX (به اختصار TDS) است.

تنظیم پرچم‌های اشکال‌زدایی Kpathsea بر اساس عدد صحیح n.
استفاده از نامی با قالب font.pk به‌جای font.dpipk.
نمایش خلاصه راهنما و خروج.
استفاده از path به‌عنوان مفسر Ghostscript.
استفاده از file برای یافتن اطلاعات نگاشت برای font. این مقدار باید نام کامل فایل باشد (به عبارت دیگر، هیچ الگوریتم جستجوی مسیری اعمال نمی‌شود).
استفاده از line به‌جای جستجو برای یک مدخل در فایل نگاشت. کلمه اول line باید با font مطابقت داشته باشد.
عملکرد بی‌صدا؛ یعنی بدون نوشتن هیچ پیامی در خروجی استاندارد.
اجرای آزمایشی: در صورتی که قلم در فایل(های) نگاشت یافت شود، وضعیت صفر و در غیر این صورت وضعیت غیرصفر برمی‌گرداند. اگر این گزینه مشخص شود، آرگومان dpi اختیاری خواهد بود (زیرا قلم تولید نخواهد شد).
چاپ شماره نسخه و خروج.

نام فایلی که باید به‌جای $HOME/.dvipsrc خوانده شود. این باید نام کامل فایل باشد (به عبارت دیگر، هیچ الگوریتم جستجوی مسیری اعمال نمی‌شود).
به TFMFONTS مراجعه کنید.
به TEXPSHEADERS مراجعه کنید.
به TEXPSHEADERS مراجعه کنید.
فهرستی از مسیرها که با دونقطه از هم جدا شده‌اند، برای جستجوی فایل‌های نگاشت. یک دونقطه اضافی در فهرست، مسیرهای پیش‌فرض کامپایل‌شده داخلی را در آن نقطه اضافه می‌کند. یک اسلش دوگانه (//) جستجوی بازگشتی در زیردایرکتوری‌ها را در آن نقطه از مسیر فعال می‌کند.
فهرستی از مسیرها که با دونقطه از هم جدا شده‌اند، برای جستجوی فایل .tfm مرتبط با قلم. اسلش‌های دوگانه و دونقطه‌های اضافی رفتاری مشابه با TEXCONFIG دارند. این اطلاعات همچنین می‌توانند با استفاده از متغیرهای محیطی TFMFONTS یا GSFTOPKFONTS فراهم شوند. این متغیرهای محیطی به ترتیب GSFTOPKFONTS ، TFMFONTS و TFMFONTS بررسی می‌شوند؛ اولین موردی که (در صورت وجود) دارای مقدار باشد استفاده می‌شود.
فهرستی از مسیرها که با دونقطه از هم جدا شده‌اند، برای جستجوی فایل راه‌انداز Ghostscript با نام render.ps و برای هرگونه فایل سرایند یا قلم PostScript (فایل‌های .enc، .pfa، .pfb، .gsf یا .ttf). اسلش‌های دوگانه و دونقطه‌های اضافی رفتاری مشابه با TEXCONFIG دارند. این اطلاعات همچنین می‌توانند با استفاده از متغیرهای محیطی PSHEADERS یا GSFTOPKHEADERS فراهم شوند. این متغیرهای محیطی به ترتیب GSFTOPKHEADERS ، TEXPSHEADERS و PSHEADERS بررسی می‌شوند؛ اولین موردی که (در صورت وجود) دارای مقدار باشد استفاده می‌شود.
به TFMFONTS مراجعه کنید.

برای تعیین مجموعه فایل‌های نگاشت مورد استفاده و مسیر یافتن فایل‌های PostScript، gsftopk به ترتیب فایل‌های config.ps، .dvipsrc و config.gsftopk را می‌خواند. فایل‌های config.ps و config.gsftopk با استفاده از متغیر محیطی TEXCONFIG ، فایل پیکربندی Kpathsea یا مسیرهای پیش‌فرض کامپایل‌شده داخلی جستجو می‌شوند. فایل .dvipsrc در دایرکتوری خانگی کاربر جستجو می‌شود.

این فایل‌ها در همان قالب فایل‌های dvips هستند (و همچنین در همان مکان‌ها قرار دارند). مدخل‌های مورد استفاده توسط gsftopk به شرح زیر هستند.

H path
نشان می‌دهد که فایل راه‌انداز Ghostscript یعنی render.ps و فایل‌های سرایند و قلم PostScript باید با استفاده از path جستجو شوند.
p file
نشان می‌دهد که فهرست فایل‌های نگاشت باید پاک شده و با file جایگزین شود.
p +file
نشان می‌دهد که file باید به فهرست فایل‌های نگاشت افزوده شود.

تمام مدخل‌های دیگر نادیده گرفته می‌شوند.

این مورد شبیه به مدیریت این گزینه‌ها هنگام اجرای dvips -Pgsftopk است. برای جزئیات بیشتر، راهنمای Kpathsea را ببینید.

gsftopk گاهی با قلم‌هایی که نویسه‌های بسیار پیچیده‌ای دارند دچار مشکل می‌شود (مانند نشان دانشگاه کالیفرنیا). این امر به این دلیل است که gsftopk از عملگر charpath برای تعیین کادر محدودکننده (bounding box) هر نویسه استفاده می‌کند. اگر نویسه بیش از حد پیچیده باشد، نسخه‌های قدیمی Ghostscript شکست می‌خورند و باعث می‌شوند که gsftopk با یک پیام خطا خاتمه یابد:

Call to gs stopped by signal 10

(این شماره ممکن است در سیستم‌های مختلف متفاوت باشد؛ این خطا مربوط به خطای گذرگاه یا یک خطای دسترسی به حافظه است.) بهترین راه برای رفع این باگ، نصب یک نسخه به‌روز از Ghostscript است. به‌عنوان یک جایگزین، می‌توان به gsftopk دستور داد تا از کادر محدودکننده ارائه‌شده همراه با قلم (در صورت وجود) به‌جای یافتن یک کادر محدودکننده برای هر نویسه استفاده کند. برای انجام این کار، رشته

/usefontbbox true def

را در فایل نگاشت قلم قرار دهید؛ مثلاً:

ucseal "/usefontbbox true def"

این کار تأثیری بر استفاده از قلم توسط dvips نخواهد گذاشت.

gs(1), gftopk(1), tex(1), xdvi(1), dvips(1)

نوشته‌شده توسط Paul Vojta. این برنامه با الهام از gsrenderfont اثر Karl Berry طراحی شده است.

توسط Yves Arrouye برای استفاده از کتابخانه Kpathsea اثر Karl Berry تغییر یافته است.

28 November 1998