نام (NAME)

grolbp - درایور خروجی groff برای چاپگرهای Canon CaPSL

خلاصه دستور (SYNOPSIS)

grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation] [-p paper-format] [-w width] [file ...]

grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape] [--linewidth=width] [--orientation=orientation] [--papersize=paper-format] [file ...]

grolbp -h

grolbp --help

grolbp -v

grolbp --version

توضیحات (DESCRIPTION)

این راه‌انداز خروجی GNU roff خروجیِ troff(1) را به یک قالب CaPSL و VDM که برای چاپگرهای Canon LBP-4 و LBP-8 مناسب است ترجمه می‌کند. به‌طور معمول، grolbp توسط groff(1) فراخوانی می‌شود، هنگامی که گزینه “-T lbp” به آن داده شده باشد. (در این نصب، ps دستگاه خروجی پیش‌فرض است.) برای ارسال هر یک از گزینه‌های نشان داده‌شده در بالا به grolbp، از گزینه -P در groff استفاده کنید. اگر هیچ آرگومان file (فایل) داده نشود، یا اگر file برابر با “-” باشد، grolbp جریان ورودی استاندارد را می‌خواند. این برنامه در جریان خروجی استاندارد می‌نویسد.

قلم‌ها (Typefaces)

این راه‌انداز از قلم‌های مقیاس‌پذیر Dutch، Swiss و Swiss-Narrow پشتیبانی می‌کند که هرکدام در سبک‌های معمولی (regular)، توپر (bold)، مورب (italic) و توپر-مورب (bold-italic) در دسترس هستند. علاوه بر این، قلم‌های بیت‌مپی و تک‌فاصله (monospaced) با نام‌های Courier و Elite در سبک‌های معمولی، توپر و مورب در دسترس هستند؛ قلم Courier در اندازه‌های ۸ و ۱۲ پوینت، و قلم Elite در اندازه‌های ۸ و ۱۰ پوینت. جدول زیر نام‌های قلم groff را که برای دسترسی به آن‌ها استفاده می‌شود خلاصه می‌کند.

Typeface	Roman	Bold	Italic	Bold-Italic
Dutch	TR	TB	TI	TBI
Swiss	HR	HB	HI	HBI
Swiss Narrow	HNR	HNB	HNI	HNBI
Courier	CR	CB	CI
Elite	ER	EB	EI

قالب کاغذ، جهت‌گیری و فایل توصیف دستگاه (Paper format, orientation, and device description file)

grolbp از قالب‌های کاغذ “A4”، “letter”، “legal” و “executive” پشتیبانی می‌کند. این مقادیر بدون توجه به بزرگی یا کوچکی حروف مطابقت داده می‌شوند. گزینه -p، --papersize هرگونه تنظیم موجود در فایل توصیف دستگاه DESC را بازنویسی می‌کند. اگر هیچ‌کدام قالب کاغذ را مشخص نکنند، A4 فرض می‌شود.

در فایل DESC، برنامه grolbp (بدون حساسیت به حروف بزرگ و کوچک) دستورالعمل orientation را شناسایی می‌کند که یک آرگومان اجباری می‌پذیرد: portrait (عمودی) یا landscape (افقی). اولین دستورالعمل معتبر جهت‌گیری (orientation) که با آن برخورد شود اعمال خواهد شد. گزینه‌های خط فرمان -l، -o و --orientation هرگونه تنظیم موجود در DESC را بازنویسی می‌کنند. اگر هیچ‌یک از موارد یادشده جهت‌گیری را مشخص نکنند، حالت عمودی (portrait) فرض می‌شود.

فایل‌های توصیف قلم (Font description files)

علاوه بر دستورالعمل‌های فایل توصیف قلم که در groff_font(5) مستند شده‌اند، grolbp دستورالعمل lbpname را شناسایی می‌کند که نام قلم groff را به نام قلمی که به‌طور داخلی توسط چاپگر استفاده می‌شود نگاشت می‌کند. نحو آن به صورت زیر است:

lbpname printer-font-name

آرگومان lbpname به بزرگی و کوچکی حروف حساس است. نام‌های قلم چاپگر به صورت زیر کدگذاری می‌شوند.

برای قلم‌های بیت‌مپی، printer-font_name دارای ساختار N⟨base-font-name⟩⟨font-style⟩ است. base-font-name نام قلم همان‌گونه است که در فهرست قلم‌های چاپگر بدون حرف اول، تا (اما نه شامل) اندازه قلم ظاهر می‌شود. font-style می‌تواند یکی از حروف R، I یا B باشد که به ترتیب نشان‌دهنده سبک‌های معمولی (roman)، مورب (italic) و توپر (bold) هستند. به‌عنوان مثال، اگر “فهرست قلم A” در چاپگر “Nelite12I.ISO_USA” را نشان دهد، مدخل متناظر در فایل توصیف قلم groff برابر با “lbpname NeliteI” خواهد بود. ممکن است برای افزودن پشتیبانی از قلم‌های بیت‌مپی جدید، لازم باشد grolbp را ویرایش کنید، زیرا نام‌ها و اندازه‌های در دسترس قلم‌های بیت‌مپی (همان‌گونه که در بالا مستند شد) در داخل برنامه به صورت ثابت (hard-coded) تعریف شده‌اند.

برای قلم‌های مقیاس‌پذیر، printer-font-name دقیقاً مشابه نام قلم است همان‌گونه که در “فهرست قلم A” چاپگر ظاهر می‌شود. به‌عنوان مثال، برای انتخاب قلم “Swiss” در سبک توپر-مورب (bold-italic)، که در فهرست قلم به صورت “Swiss-BoldOblique” ظاهر می‌شود، دستورالعمل مورد نیاز “lbpname Swiss-BoldOblique” است، و این همان چیزی است که در فایل توصیف قلم groff با نام HBI برای دستگاه lbp می‌یابیم.

دستورات رسم (Drawing commands)

برای سازگاری با grolj4(1)، یک دستور رسم اضافی در دسترس است.

\D'R dh dv': یک خط‌کش/مستطیل (مستطیل سیاه توپر) با یک گوشه در موقعیت رسم، و گوشه مقابل قطری آن در موقعیت رسم +(dh,dv) رسم می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های -h و --help پیام راهنمای نحوه استفاده را نمایش می‌دهند، در حالی که -v و --version اطلاعات نسخه را نشان می‌دهند؛ همگی پس از آن خارج می‌شوند.

-c num-copies
--copies=num-copies: تعداد num-copies نسخه از هر صفحه تولید می‌کند.
-F font-directory
--fontdir=font-directory: دایرکتوری font-directory/devname را به ابتدای مسیر جستجو برای فایل‌های توصیف قلم و دستگاه اضافه می‌کند؛ name نام دستگاه است که معمولاً lbp می‌باشد.
-l
--landscape: سند را در جهت افقی (landscape) قالب‌بندی می‌کند.
-o orientation
--orientation=orientation: سند را در جهت orientation داده‌شده قالب‌بندی می‌کند، که باید “portrait” یا “landscape” باشد.
-p paper-format
--papersize=paper-format: قالب کاغذ را بر روی paper-format تنظیم می‌کند، که باید یک قالب کاغذ معتبر همان‌طور که در بالا توضیح داده شد باشد.
-w width
--linewidth=width: ضخامت پیش‌فرض خط را بر روی width هزارم یک em تنظیم می‌کند؛ مقدار پیش‌فرض 40 (0.04 em) است.

وضعیت خروج (EXIT STATUS)

برنامه grolbp در صورت اجرای موفق با وضعیت 0، اگر نتواند آرگومان‌های خط فرمان خود را تفسیر کند با وضعیت 2، و در صورت برخورد با یک خطا در حین عملیات با وضعیت 1 خارج می‌شود.

محیط (ENVIRONMENT)

GROFF_FONT_PATH: فهرستی از دایرکتوری‌ها را مشخص می‌کند که در آن‌ها باید به دنبال دایرکتوری فایل‌های توصیف دستگاه و قلم دستگاه خروجی انتخاب‌شده گشت. troff(1) و groff_font(5) را ببینید.

فایل‌ها (FILES)

/usr/share/groff/1.24.1/font/devlbp/DESC: دستگاه خروجی lbp را توصیف می‌کند.
/usr/share/groff/1.24.1/font/devlbp/F: قلم شناخته‌شده با نام F را بر روی دستگاه lbp توصیف می‌کند.
/usr/share/groff/1.24.1/tmac/lbp.tmac: ماکروهایی را برای استفاده با دستگاه خروجی lbp تعریف می‌کند. این فایل هنگام انتخاب دستگاه خروجی lbp به‌طور خودکار توسط troffrc بارگذاری می‌شود.

همچنین ببینید (SEE ALSO)

groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7)