.\" Copyright (c) 1993-1998  Paul Vojta
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining a copy
.\" of this software and associated documentation files (the "Software"), to
.\" deal in the Software without restriction, including without limitation the
.\" rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
.\" sell copies of the Software, and to permit persons to whom the Software is
.\" furnished to do so, subject to the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included in
.\" all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
.\" PAUL VOJTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
.\" IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
.\" CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\"

.\" small and boldface (not all -man's provide it)
.de SB
\&\fB\s-1\&\\$1 \\$2\s0\fR
..
.TH GSFTOPK 1 "28 November 1998"
.SH "نام (NAME)"
gsftopk \- رندر کردن قلم‌های Ghostscript در قالب TeX pk
.SH "خلاصه دستور (SYNOPSIS)"
.B gsftopk
[\-i \fIpath\fP]
[\-q]
[\-t]
[\-\-debug=\fIn\fP]
[\-\-dosnames]
[\-\-interpreter=\fIpath\fP]
[\-\-mapline=\fIline\fP]
[\-\-mapfile=\fIfile\fP]
[\-\-quiet]
[\-\-test]
[\-\-help]
[\-\-version]
.I font
.I dpi
.SH "آرگومان‌ها (ARGUMENTS)"
.IP \fIfont\fP \w'\fIfont\fP'u+2m
نام قلمی که باید ایجاد شود.
.IP \fIdpi\fP
تفکیک‌پذیری مورد نظر قلم برای ایجاد، بر حسب نقطه در اینچ (dpi). این مقدار می‌تواند یک عدد حقیقی باشد.
.SH "توضیحات (DESCRIPTION)"
.B gsftopk
برنامه‌ای است که برنامه Ghostscript یعنی
.BR gs (1)
را برای رندر کردن یک قلم معین با یک تفکیک‌پذیری مشخص فراخوانی می‌کند. این برنامه نویسه‌های حاصل را در قالب فایل
.B pk
بسته‌بندی کرده و آنها را در فایلی می‌نویسد که نام آن از نام قلم و تفکیک‌پذیری (گرد شده به نزدیک‌ترین عدد صحیح) تشکیل می‌شود. قلم می‌تواند در هر قالبی باشد که برای Ghostscript قابل پذیرش است، از جمله فایل‌های
.RI . pfa ،
.RI . pfb ،
.RI . gsf
و
.RI . ttf .
.PP
این برنامه معمولاً باید توسط یک اسکریپت، مانند
.BR mktexpk ،
فراخوانی شود تا قلم‌ها را بر حسب تقاضا ایجاد کند.
.PP
.B gsftopk
عرض نویسه‌ها را از فایل
.RI . tfm
که باید در مسیر جستجوی استاندارد موجود باشد، دریافت می‌کند. همچنین باید بتواند قلم را در یک فایل نگاشت (مانند
.BR psfonts.map )
با قالبی مشابه با آنچه در
.BR dvips (1)
آمده است پیدا کند، مگر اینکه از گزینه
.B \-\-mapline
استفاده شود. مجموعه فایل‌های نگاشت توسط گزینه
.B \-\-mapfile
یا در فایل‌های
.BR config.ps ،
.BR $HOME/.dvipsrc
و
.B config.gsftopk
(مشابه حالتی که توسط
.BR "dvips -Pgsftopk"
استفاده می‌شود) مشخص می‌گردد.
.PP
موارد ویژه («specials») زیر در قالب
.B pk
به انتهای فایل خروجی افزوده می‌شوند تا یک بررسی داخلی روی محتوای فایل فراهم کنند:
"\fBjobname=\fP\fIfont\fP"،
"\fBmag=1\fP"،
"\fBmode=modeless\fP" و
"\fBpixels_per_inch=\fP\fIdpi\fP".
این کار مطابق با استاندارد دایرکتوری TeX (به اختصار TDS) است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-debug=\fIn\fP
تنظیم پرچم‌های اشکال‌زدایی
.B Kpathsea
بر اساس عدد صحیح
.IR n .
.TP
.B \-\-dosnames
استفاده از نامی با قالب
.IB font .pk
به‌جای
.IB font . dpi pk\fR.\fP
.TP
.B \-h\fR,\fP \-\-help
نمایش خلاصه راهنما و خروج.
.TP
.B \-i \fIpath\fP\fR,\fP \-\-interpreter=\fIpath\fP
استفاده از
.I path
به‌عنوان مفسر Ghostscript.
.TP
.B \-\-mapfile=\fIfile\fP
استفاده از
.I file
برای یافتن اطلاعات نگاشت برای
.IR font .
این مقدار باید نام کامل فایل باشد (به عبارت دیگر، هیچ الگوریتم جستجوی مسیری اعمال نمی‌شود).
.TP
.B \-\-mapline=\fIline\fP
استفاده از
.I line
به‌جای جستجو برای یک مدخل در فایل نگاشت.
کلمه اول
.I line
باید با
.I font
مطابقت داشته باشد.
.TP
.B \-q\fR,\fP \-\-quiet
عملکرد بی‌صدا؛ یعنی بدون نوشتن هیچ پیامی در خروجی استاندارد.
.TP
.B \-t\fR,\fP \-\-test
اجرای آزمایشی: در صورتی که قلم در فایل(های) نگاشت یافت شود، وضعیت صفر و در غیر این صورت وضعیت غیرصفر برمی‌گرداند. اگر این گزینه مشخص شود، آرگومان
.I dpi
اختیاری خواهد بود (زیرا قلم تولید نخواهد شد).
.TP
.B \-v\fR,\fP \-\-version
چاپ شماره نسخه و خروج.
.SH "محیط (ENVIRONMENT)"
.IP \fBDVIPSRC\fP \w'\fBGSFTOPKHEADERS\fP'u+2m
نام فایلی که باید به‌جای
.BR $HOME/.dvipsrc
خوانده شود. این باید نام کامل فایل باشد (به عبارت دیگر، هیچ الگوریتم جستجوی مسیری اعمال نمی‌شود).
.IP \fBGSFTOPKFONTS\fP
به
.SB TFMFONTS
مراجعه کنید.
.IP \fBGSFTOPKHEADERS\fP
به
.SB TEXPSHEADERS
مراجعه کنید.
.IP \fBPSHEADERS\fP
به
.SB TEXPSHEADERS
مراجعه کنید.
.IP \fBTEXCONFIG\fP
فهرستی از مسیرها که با دونقطه از هم جدا شده‌اند، برای جستجوی فایل‌های نگاشت.
یک دونقطه اضافی در فهرست، مسیرهای پیش‌فرض کامپایل‌شده داخلی را در آن نقطه اضافه می‌کند. یک اسلش دوگانه (//) جستجوی بازگشتی در زیردایرکتوری‌ها را در آن نقطه از مسیر فعال می‌کند.
.IP \fBTFMFONTS\fP
فهرستی از مسیرها که با دونقطه از هم جدا شده‌اند، برای جستجوی فایل
.RI . tfm
مرتبط با قلم. اسلش‌های دوگانه و دونقطه‌های اضافی رفتاری مشابه با
.SB TEXCONFIG
دارند. این اطلاعات همچنین می‌توانند با استفاده از متغیرهای محیطی
.SB TFMFONTS
یا
.SB GSFTOPKFONTS
فراهم شوند. این متغیرهای محیطی به ترتیب
.SB GSFTOPKFONTS ،
.SB TFMFONTS
و
.SB TFMFONTS
بررسی می‌شوند؛ اولین موردی که (در صورت وجود) دارای مقدار باشد استفاده می‌شود.
.IP \fBTEXPSHEADERS\fP
فهرستی از مسیرها که با دونقطه از هم جدا شده‌اند، برای جستجوی فایل راه‌انداز Ghostscript با نام
.B render.ps
و برای هرگونه فایل سرایند یا قلم PostScript (فایل‌های
.RI . enc ،
.RI . pfa ،
.RI . pfb ،
.RI . gsf
یا
.RI . ttf ).
اسلش‌های دوگانه و دونقطه‌های اضافی رفتاری مشابه با
.SB TEXCONFIG
دارند. این اطلاعات همچنین می‌توانند با استفاده از متغیرهای محیطی
.SB PSHEADERS
یا
.SB GSFTOPKHEADERS
فراهم شوند. این متغیرهای محیطی به ترتیب
.SB GSFTOPKHEADERS ،
.SB TEXPSHEADERS
و
.SB PSHEADERS
بررسی می‌شوند؛ اولین موردی که (در صورت وجود) دارای مقدار باشد استفاده می‌شود.
.IP \fBTFMFONTS\fP
به
.SB TFMFONTS
مراجعه کنید.
.SH "پیکربندی (CONFIGURATION)"
برای تعیین مجموعه فایل‌های نگاشت مورد استفاده و مسیر یافتن فایل‌های PostScript،
.B gsftopk
به ترتیب فایل‌های
.BR config.ps ،
.BR .dvipsrc
و
.BR config.gsftopk
را می‌خواند. فایل‌های
.B config.ps
و
.B config.gsftopk
با استفاده از متغیر محیطی
.SB TEXCONFIG ،
فایل پیکربندی
.B Kpathsea
یا مسیرهای پیش‌فرض کامپایل‌شده داخلی جستجو می‌شوند. فایل
.B .dvipsrc
در دایرکتوری خانگی کاربر جستجو می‌شود.
.PP
این فایل‌ها در همان قالب فایل‌های
.B dvips
هستند (و همچنین در همان مکان‌ها قرار دارند). مدخل‌های مورد استفاده توسط
.B gsftopk
به شرح زیر هستند.
.TP
.RI "H " path
نشان می‌دهد که فایل راه‌انداز Ghostscript یعنی
.B render.ps
و فایل‌های سرایند و قلم PostScript باید با استفاده از
.I path
جستجو شوند.
.TP
.RI "p " file
نشان می‌دهد که فهرست فایل‌های نگاشت باید پاک شده و با
.I file
جایگزین شود.
.TP
.RI "p +" file
نشان می‌دهد که
.I file
باید به فهرست فایل‌های نگاشت افزوده شود.
.PP
تمام مدخل‌های دیگر نادیده گرفته می‌شوند.
.PP
این مورد شبیه به مدیریت این گزینه‌ها هنگام اجرای
.BR "dvips -Pgsftopk"
است. برای جزئیات بیشتر، راهنمای
.B Kpathsea
را ببینید.
.SH "گزارش باگ‌ها (BUGS)"
.B gsftopk
گاهی با قلم‌هایی که نویسه‌های بسیار پیچیده‌ای دارند دچار مشکل می‌شود (مانند نشان دانشگاه کالیفرنیا). این امر به این دلیل است که
.B gsftopk
از عملگر
.B charpath
برای تعیین کادر محدودکننده (bounding box) هر نویسه استفاده می‌کند. اگر نویسه بیش از حد پیچیده باشد، نسخه‌های قدیمی Ghostscript شکست می‌خورند و باعث می‌شوند که
.B gsftopk
با یک پیام خطا خاتمه یابد:
.IP
.B "Call to gs stopped by signal 10"
.LP
(این شماره ممکن است در سیستم‌های مختلف متفاوت باشد؛ این خطا مربوط به خطای گذرگاه یا یک خطای دسترسی به حافظه است.) بهترین راه برای رفع این باگ، نصب یک نسخه به‌روز از Ghostscript است. به‌عنوان یک جایگزین، می‌توان به
.B gsftopk
دستور داد تا از کادر محدودکننده ارائه‌شده همراه با قلم (در صورت وجود) به‌جای یافتن یک کادر محدودکننده برای هر نویسه استفاده کند. برای انجام این کار، رشته
.IP
.B /usefontbbox true def
.LP
را در فایل نگاشت قلم قرار دهید؛
.IR مثلاً :
.IP
.B ucseal """/usefontbbox true def"""
.LP
این کار تأثیری بر استفاده از قلم توسط
.BR dvips
نخواهد گذاشت.
.SH "همچنین ببینید (SEE ALSO)"
.BR gs (1),
.BR gftopk (1),
.BR tex (1),
.BR xdvi (1),
.BR dvips (1)
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Paul Vojta. این برنامه با الهام از
.B gsrenderfont
اثر Karl Berry طراحی شده است.
.SH "تغییرات (MODIFICATIONS)"
توسط Yves Arrouye برای استفاده از کتابخانه
.B Kpathsea
اثر Karl Berry تغییر یافته است.