grops - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

grops - драйвер PostScript для groff

СИНТАКСИС

намацки [-glmv] [-b n] [-c n] [-F реж] [-I реж] [-p розмір паперу] [-P пролог] [-w n] [файли
...]

ОПИС

намацки перекладає вихідні дані GNU троф до PostScript. нормально намацки слід викликати
за допомогою команди groff з a -Тпс варіант. (Насправді це типове значення для groff.)
Якщо файли не надано, намацки зчитує стандартний вхід. Ім'я файлу - також причини намацки
для читання стандартного введення. Вихід PostScript записується у стандартний вихід. Коли
намацки знаходиться у веденні groff опції можна передати намацки використання groff's -P варіант.

Зверніть увагу, що намацки не створює дійсної структури документа (відповідає Документу
Structuring Convention), якщо викликається з декількома аргументами файлу. Надрукувати таке
конкатенований вихід необхідно дезактивувати обробку DSC у програмі друку або
попередній перегляд. Дивіться розділ ШРИФТ УСТАНОВКА нижче для інструкції, як встановити шрифти для
намацки.

ВАРІАНТИ

Між параметром командного рядка та його параметром може бути пробіл.

-bn Надайте обхідні шляхи для старих принтерів, несправних спулерів і програм попереднього перегляду. нормально
намацки створює вивід на PostScript LanguageLevel 2, який відповідає документу
Конвенції про структурування версії 3.0. Деякі старіші принтери, спулери та програми попереднього перегляду
не може впоратися з таким виходом. Значення n контролює що намацки робить, щоб зробити його
вихід, прийнятний для таких програм. Значення 0 призводить до того, що групи не використовують жодного
обхідні шляхи.

Додайте 1, якщо ні %%BeginDocumentSetup та %%EndDocumentSetup коментарі повинні бути
породжений; це потрібно для ранніх версій TranScript, які заплутуються
щось між %%EndProlog коментар і перш %% Сторінка коментар.

Додайте 2 рядки if у включені файли, починаючи з %! слід зняти; це
необхідний для попереднього перегляду сторінки Sun.

Додайте 4 якщо %% Сторінка, %%Трейлер та %%EndProlog коментарі повинні бути видалені
включені файли; це потрібно для спулерів, які не розуміють %% Почати-
Документ та %%EndDocument коментарів.

Додайте 8, якщо має бути перший рядок виводу PostScript %!PS-Adobe-2.0 швидше
ніж %!PS-Adobe-3.0; це необхідно під час використання Sun's Newsprint із принтером, який
вимагає розвороту сторінок.

Додайте 16, якщо інформація про розмір носія не повинна міститися в документі (це
ні використання %%DocumentMedia ні setpagedevice команда PostScript). Це було
поведінка groff версії 1.18.1 і раніших; він потрібен для старих принтерів
які не розуміють PostScript LanguageLevel 2. Це також необхідно, якщо
вихідні дані додатково обробляються для отримання інкапсульованого файлу PS (EPS) – див. нижче.

Значення за замовчуванням можна вказати a

зламаний n

у файлі DESC. В іншому випадку стандартним значенням є 0.

-cn друк n копії кожної сторінки.

-Fреж Додати каталог реж/ devім'я до шляху пошуку прологу, шрифту та пристрою
файли опису; ім'я як правило, це назва пристрою ps.

-g Вгадайте довжину сторінки. Це генерує код PostScript, який вгадує сторінку
довжина. Припущення є правильним, лише якщо область зображення розташована вертикально по центру
сторінку. Ця опція дозволяє створювати документи, на яких можна друкувати обидва
лист (8.5×11) та на папері А4 без змін.

-Iреж Цей параметр можна використовувати для додавання каталогу до шляху пошуку файлів на
командний рядок і файли, названі в \X'ps: імпорт та \X'ps: файл' втечі. The
шлях пошуку ініціалізується поточним каталогом. Цей варіант може бути
вказано більше одного разу; потім у каталогах виконується пошук у вказаному порядку
(але перед поточним каталогом). Якщо ви хочете, щоб поточний каталог був
читати перед іншими каталогами, доп -Я. у відповідному місці.

Для файлів з абсолютним ім'ям файлів пошук у каталозі не виконується.

-l Роздрукуйте документ в альбомному форматі.

-m Увімкніть для документа ручну подачу.

-pрозмір паперу
Встановити фізичний розмір вихідного середовища. Це перевизначає розмір паперу,
довжина паперу та ширина паперу команди в DESC файл; воно приймає те саме
аргументи як розмір паперу команду. Побачити groff_font (5) for details.

-Pпролог-файл
Використовуйте файл пролог-файл (на шляху шрифту) як пролог замість
файл прологу за замовчуванням пролог. Цей параметр замінює змінну середовища
GROPS_PROLOGUE.

-wn Лінії слід малювати товщиною n тисячні ем. Якщо цей варіант
не задано, товщина лінії за замовчуванням становить 0.04 ем.

-v Надрукуйте номер версії.

ВИКОРИСТАННЯ

Вхід до намацки має бути у форматі, який виводить троф(1). Це описано в
groff_out(5).

Крім того, файли опису пристрою та шрифту для використовуваного пристрою повинні відповідати певним вимогам
вимоги: роздільна здатність має бути ціле число, кратне 72-кратному масштаб,
ps Пристрій використовує роздільну здатність 72000 і масштаб 1000.

Файл опису пристрою має містити дійсний розмір паперу; побачити groff_font(5) більше
інформація.

Кожен файл опису шрифту повинен містити команду

внутрішнє ім'я psname

який говорить, що ім’я шрифту PostScript є psname. Він також може містити команду

кодування enc_file

який говорить, що шрифт PostScript слід перекодувати за допомогою кодування, описаного в
enc_file; цей файл повинен складатися з послідовності рядків виду:

пщар код

де пщар – ім’я персонажа в PostScript та код є його позиція в
кодування, виражене десятковим цілим числом; дійсні значення знаходяться в діапазоні від 0 до 255. Рядки
починаючи з # а порожні рядки ігноруються. Код для кожного символу, наведений у
файл шрифту повинен відповідати коду символу у файлі кодування або коду
у стандартному кодуванні для шрифту, якщо шрифт PostScript не потрібно перекодувати. Це
код можна використовувати з \N вихідна послідовність у троф щоб вибрати символ, навіть якщо
персонаж не має імені грофф. Кожен символ у файлі шрифту має існувати в
Шрифт PostScript, і ширина, наведена у файлі шрифту, має відповідати ширині, використаній у
Шрифт PostScript. намацки припускає, що персонаж з іменем Groff простір порожній
(не робить позначок на сторінці); він може використовувати такий символ, щоб генерувати більше
ефективний і компактний вихід PostScript.

Зверніть увагу, що намацки може відображати всі гліфи шрифтом PostScript, а не лише 256.
enc_file (або стандартне кодування, якщо файл кодування не вказано) просто визначає порядок
гліфи для перших 256 символів; доступ до всіх інших гліфів здійснюється за допомогою додаткових
кодування векторів, які намацки виробляє на льоту.

намацки може автоматично включати завантажувані шрифти, необхідні для друку документа.
Такі шрифти мають бути у форматі PFA. використання pfbtops(1), щоб перетворити шрифт Type 1 у формат PFB.
Будь-які завантажувані шрифти, які за потреби повинні бути включені намацки повинні бути перераховані в
файлу /usr/share/groff/1.22.3/font/devps/download; це повинно складатися з рядків
форма

шрифт ім'я файлу

де шрифт це PostScript-ім’я шрифту, і ім'я файлу це ім'я файлу
містить шрифт; рядки, що починаються з # і порожні рядки ігноруються; поля можуть бути
розділені табуляцією або пробілами; ім'я файлу шукається за допомогою того самого механізму, що й
використовується для метричних файлів шрифту groff. The скачати сам файл також шукається за допомогою
цей механізм; наразі використовується лише перший знайдений файл у шляху до шрифту.

Якщо файл, що містить завантажуваний шрифт або імпортований документ, відповідає Adobe
Отже, угоди про структурування документів намацки інтерпретує будь-які коментарі у файлах
достатньо, щоб переконатися, що його власний вихід відповідає вимогам. Він також постачає все необхідне
ресурси шрифтів, перелічені в скачати файл, а також будь-які необхідні файлові ресурси.
Він також здатний обробляти міжресурсні залежності. Наприклад, припустимо, що у вас є
завантажуваний шрифт під назвою Garamond, а також завантажуваний шрифт під назвою Garamond-Outline
який залежить від Garamond (зазвичай це буде визначено для копіювання шрифту Garamond
словник і змініть PaintType), тоді необхідно, щоб Garamond з’явився раніше
Garamond-Outline у ​​документі PostScript. намацки обробляє це автоматично
що завантажуваний файл шрифту для Garamond-Outline вказує на його залежність від Garamond
за допомогою Угод про структурування документів, наприклад, починаючи з
наступні рядки

%!PS-Adobe-3.0 Ресурс-Шрифт
%%DocumentNeededResources: шрифт Garamond
%%EndComments
%%IncludeResource: шрифт Garamond

У цьому випадку як Garamond, так і Garamond-Outline потрібно буде вказати в списку скачати
файл. Шрифт, який можна завантажити, не повинен містити власну назву в a %%DocumentSupplied-
ресурси коментар.

намацки не інтерпретує %%Шрифти документа коментарі. The %%DocumentNeededResources,
%%DocumentSuppliedResources, %%IncludeResource, %%BeginResource та %%EndResource
коментарі (або, можливо, старі %%DocumentNeededFonts, %%DocumentSuppliedFonts, %%Включати-
шрифт, %%BeginFont та %%EndFont коментарі).

У налаштуваннях за замовчуванням є стилі, які називаються R, I, B та BI встановлюється на позиціях шрифту 1
до 4. Шрифти згруповано в сімейства A, BM, C, H, HN, N, P та T наявність членів у
кожен із цих стилів:

AR Авангард-книга
AI AvantGarde-BookOblique
AB Авангард-Демі
АБІ AvantGarde-DemiOblique
BMR Книжник-Світло
BMI Bookman-LightItalic
BMB Книжник-Демі
BMBI Bookman-DemiItalic
CR Кур'єр
CI Кур'єр-косий
CB Кур'єр-жирний
CBI Кур'єр-BoldOblique
HR Helvetica
HI Гельветика-косий
HB Helvetica-Bold
HBI Helvetica-Bold Oblique
HNR Helvetica-Вузька
ВНН Гельветика-вузько-косий
HNB Гельветика-вузький-жирний
HNBI Helvetica-Narrow-Bold Oblique
NR NewCenturySchlbk-Римський
NI NewCenturySchlbk-курсив
NB NewCenturySchlbk-жирний
НБІ NewCenturySchlbk-жирнийкурсив
PR Палатино-римський
PI Палатино-курсив
PB Палатино-жирний
PBI Палатино-жирний курсив
TR Times-Roman
TI Курсив Times
TB Times-Bold
ТБІ Times-жирний курсив

Існує також такий шрифт, який не є членом сімейства:

ZCMI ZapfChancery-MediumItalic

Існують також спеціальні шрифти, які називаються S для шрифту PS Symbol і SS, що містить
похилі малі грецькі літери, взяті з PS Symbol. Zapf Dingbats доступний як ZD,
і перевернута версія ZapfDingbats (із символами, що вказують у протилежному напрямку)
доступний як ЗДР; більшість символів у цих шрифтах не мають імен і доступ до них потрібно отримати за допомогою
\N.

Колір за замовчуванням для \m та \M чорний; для кольорів, визначених у колірному просторі 'rgb'
setrgbcolor використовується для "cmy" і "cmyk" setcmykcolor, а для "сірого" setgray. Зверніть увагу на це
setcmykcolor є командою PostScript LanguageLevel 2, тому вона недоступна на деяких старіших версіях
принтери.

намацки розуміє різні команди X, створені за допомогою \X escape-послідовність; намацки тільки
інтерпретує команди, які починаються з a ps: бирка.

\X'ps: Exec код'
Це виконує довільні команди PostScript код. PostScript
поточна точка встановлюється на позицію \X команду перед виконанням код,
початок знаходиться у верхньому лівому куті сторінки, а координати y збільшуються вниз
сторінки. Процедура u визначено, що перетворює одиниці groff у систему координат
фактично (за умови, що користувач не змінює масштаб). Наприклад,

.nr x 1i
\X'ps: Exec \nx u 0 rlineto інсульт'

малює горизонтальну лінію завдовжки один дюйм. код може вносити зміни в графіку
стан, але будь-які зміни зберігаються лише до кінця сторінки. Словник
містить визначення, зазначені в захист та mdef знаходиться на вершині
словниковий стек. Якщо ваш код додає визначення до цього словника, ви повинні
виділіть місце для їх використання \X'ps mdef n'. Будь-які визначення зберігаються лише до
кінець сторінки. Якщо ви використовуєте \Y escape-послідовність з аргументом, який іменує
макрос, код може поширюватися на кілька рядків. Наприклад,

.nr x 1i
. De y
ps: Exec
\nx u 0 rlineto
хід
..
\Yy

це ще один спосіб намалювати горизонтальну лінію завдовжки один дюйм. Зверніть увагу на один зворотний слеш
перед 'nx' – єдина причина використовувати числовий регістр під час визначення макросу 'y'
полягає в тому, щоб перетворити визначений користувачем розмір «1i» на внутрішні одиниці groff, які знаходяться в
черга, перетворена в одиниці PS з u процедури.

намацки загортає вказаний користувачем код PostScript у словник, нічого більше. в
Зокрема, він не починає і не закінчує вставлений код економити та відновлення,
відповідно. За потреби це має надати користувач.

\X'ps: файл ім'я'
Це те саме, що Exec за винятком того, що зчитується код PostScript
файл ім'я.

\X'ps: захист код'
Розмістіть визначення PostScript, що міститься в код в пролозі. Там повинно бути
щонайбільше одне визначення на \X команда. Довгі визначення можна розділити на кілька
\X команди; всі код аргументи просто об'єднуються, розділені
нові рядки. Визначення поміщаються в словник, який автоматично надсилається
у стеку словників, коли an Exec команда виконується. Якщо ви використовуєте \Y бігти
послідовність з аргументом, який іменує макрос, код може поширюватися на кілька рядків.

\X'ps: mdef n код'
Люблю захист, крім цього код може містити до n визначення. намацки потрібно знати
скільки визначень код містить так, щоб він міг створити відповідний розмір
Словник PostScript, який їх містить.

\X'ps: імпорт файл llx lly urx ури ширина [ висота ]'
Імпортувати графіку PostScript із файл. Аргументи llx, lly, urx та ури дати
обмежувальна рамка графіки в системі координат PostScript за замовчуванням; Вони
усі мають бути цілими числами; llx та lly є координатами x і y нижнього лівого кута
кут графіки; urx та ури є координатами x і y у верхньому правому куті
кут графіки; ширина та висота є цілими числами, які дають бажану ширину
і висота в графічних одиницях.

Графічний малюнок масштабується таким чином, щоб мати цю ширину та висоту, і перекладається таким чином
нижній лівий кут графіки розташований у місці, пов’язаному з \X
команда. Якщо аргумент висоти опущено, він рівномірно масштабується в x і
y напрямках так, щоб він мав задану ширину.

Зверніть увагу, що вміст \X команди не інтерпретуються троф; так вертикально
місце для графіки не додається автоматично, і ширина та висота
аргументи не можуть мати прикріплені індикатори масштабування.

Якщо файл PostScript відповідає Угодам про структурування документів Adobe та
містить a %%BoundingBox коментар, то обмежувальна рамка може бути автоматично
витягнуто з groff за допомогою psbb запит

Читати groff_tmac(5) для опису PSPIC макрос, який забезпечує зручн
інтерфейс високого рівня для включення графіки PostScript.

\X'ps: invis'
\X'ps: endinvis'
Для тексту та команд малювання, які взяті в дужки з ними, вихідні дані не генеруються
\X команди. Ці команди призначені для використання під час виведення з троф is
попередньо переглянути перед обробкою намацки; якщо програма попереднього перегляду не може відобразити
певні символи чи інші конструкції, потім інші символи-замінники або
конструкції можна використовувати для попереднього перегляду, закріпивши їх за допомогою цих \X команди.

Наприклад, gxditview не може відобразити належне \(ем характер, тому що
стандартні шрифти X11 цього не забезпечують; цю проблему можна подолати, виконавши
наступний запит

.char \(ем \X'ps: invis'\
\Z'\v'-.25m'\h'.05m'\D'l .9м 0'\h'.05m''\
\X'ps: endinvis'\(em

В цьому випадку, gxditview не може відобразити \(ем характер і малює лінію,
в той час як намацки друкує \(ем і ігнорує рядок (цей код уже є
у файлі Xps.tmac який завантажується, якщо документ призначений для намацки попередньо переглядається за допомогою
gxditview).

Якщо процедура PostScript BPhook було визначено через 'ps: захист"або"ps: mdef' пристрій
вона виконується на початку кожної сторінки (перед тим, як щось буде намальовано або
написаний groff). Наприклад, підкласти під вміст сторінки слово «ЧЕРНЕТКА».
світло-сірий, можна використовувати

. De XX
ps: захист
/BPhook
{ gsave .9 setgray шлях відсікання pathbbox бірж 2 скопіювати
.5 мул бірж .5 мул переводити атан обертати поп поп
/NewCenturySchlbk-Roman знайти шрифт 200 масштабний шрифт встановити шрифт
(ЧЕРНЕТКА) dup ширина рядка поп -. 5 мул -70 Ідіть до Показувати
grestore }
захист
..
.devicem XX

Або, щоб лінії та багатокутники малювалися за допомогою квадратних ліній і скошених з’єднань ліній
замість круглих заголовків і з’єднань ліній, які зазвичай використовуються намацки, Використовуйте

. De XX
ps: захист
/BPhook { 2 setlinecap 0 setlinejoin } захист
..
.devicem XX

(квадратні лінії, на відміну від стикових ліній (0 setlinecap), дають справжні кути в рамці
таблиці, навіть якщо лінії намальовані не з’єднаними).

Інкапсульований PostScript
намацки сам по собі не випромінює інформацію обмежувальної рамки. За допомогою Ghostscript
за простим сценарієм, groff2eps, створює інкапсульований файл PS.

#! / Бен / ш
groff -P-b16 $1 > $1.ps
gs -dНОПАУЗА -sDEVICE=bbox -- $1.ps 2> $1.bbox
sed -e "/^%%Орієнтація/п $1.bbox" \
-e "/^%!PS-Adobe-3.0/s/$/ EPSF-3.0/" $1.ps > $1.eps
rm $1.ps $1.bbox

Просто сказати

groff2eps Foo

щоб конвертувати файл Foo до foo.eps.

Істинний тип та інший шрифт Формати
Можна використовувати шрифти TrueType намацки якщо спочатку перетворити на тип 42 форматі, спец
Обгортка PostScript, еквівалентна формату PFA, згаданому в pfbtops(1). Існує
кілька різних методів генерації обгортки type42, і більшість із них передбачає використання
інтерпретатор PostScript, наприклад Ghostscript – див gs(1).

Але найпростіший спосіб – це використання програми ttftot42(1). Ця програма
використовує вільний тип(3) (версія 1.3.1) для створення обгорток шрифтів type42 і добре сформованого AFM
файли, які можна передати в afmtodit(1) сценарій для створення відповідних файлів метрик. The
отримані обгортки шрифтів слід додати до скачати файлу. ttftot42 вихідний код може бути
завантажено з ftp://www.giga.or.at/pub/nih/ttftot42/ ⟨ftp://www.giga.or.at/pub/nih/
ttftot42/⟩.

Іншим рішенням для створення обгорток type42 є використання FontForge, доступного за адресою http://
fontforge.sf.net ⟨http://fontforge.sf.net⟩. Цей редактор шрифтів може конвертувати більшість контурів
формати шрифтів.

ШРИФТ УСТАНОВКА

У цьому розділі наведено короткий виклад наведених вище пояснень; він може служити поетапним
Посібник зі встановлення шрифтів для намацки.

· Перетворіть свій шрифт на те, що розуміє Groff. Це або PostScript Тип 1
шрифт у форматі PFA або шрифт PostScript Type 42 разом із файлом AFM.

Найперші символи у файлі PFA виглядають так:

%!PS-AdobeFont-1.0:

Файл PFB також містить це в першому рядку, але рядку передує деякі
двійкові байти.

Найперші символи у файлі шрифту Type 42 виглядають так:

%!PS-TrueTypeFont

Це формат оболонки для шрифтів TrueType. Старі принтери PS можуть не підтримувати його
(це вони не мають вбудованого інтерпретатора шрифтів TrueType).

Якщо ваш шрифт у форматі PFB (такі шрифти зазвичай мають розширення файлу «.pfb»),
Ви можете використовувати Groff's pfbtops(1) програма для перетворення його на PFA. Для шрифтів TrueType
намагатися ttftot42 or fontforge. Для всіх інших форматів шрифтів використовуйте fontforge які можуть конвертувати
більшість форматів контурних шрифтів.

· Перетворіть файл AFM у файл опису шрифту groff за допомогою afmtodit(1) програма.
Приклад дзвінка

afmtodit Foo-Bar-Bold.afm текстова карта FBB

який перетворює файл метрики "Foo-Bar-Bold.afm" у шрифт groff "FBB". Якщо ви
мати сімейство шрифтів, яке має звичайний, напівжирний, курсив і жирний курсив, це
рекомендується використовувати букви R, B, I та BI, відповідно, як постфікси в
назви шрифтів groff, щоб запит Groff '.fam' працював. Прикладом є вбудована програма Groff
Шрифт Times-Roman: назва сімейства шрифту T, а назви шрифтів groff є TR, TB, TI,
та ТБІ.

· Встановіть як файли опису шрифту groff, так і шрифти в підкаталозі 'devps'
шлях до шрифту, який знайшов Groff. Див НАВКОЛИШНЄ СЕРЕДОВИЩЕ розділ в троф(1) чоловік
сторінку, яка перераховує фактичне значення шляху шрифту. Зауважте, що groff не використовує
Файли AFM (але все одно їх краще зберігати).

· Зареєструйте всі шрифти, які потрібно завантажити на принтер, у «devps/download»
файл. Читається лише перше входження цього файлу в шлях до шрифту. Це означає
що вам слід скопіювати файл «завантаження» за замовчуванням у перший каталог у вашому шрифті
шлях і додайте туди свої шрифти. Щоб продовжити наведений вище приклад, припустимо, що PS
назва шрифту для Foo-Bar-Bold.pfa — «XY-Foo-Bar-Bold» (назва шрифту PS зберігається в
внутрішнє ім'я у файлі «FBB», тому слід додати наступний рядок
"завантажити".

XY-Foo-Bar-Bold Foo-Bar-Bold.pfa

OLD ШРИФТИ

groff версії 1.19.2 і раніші містять дещо інший набір із 35 ядер Adobe
шрифти; різниця в основному полягає у відсутності гліфа «Євро» та зменшеному наборі кернінгу
пари. Для зворотної сумісності ці старі шрифти також встановлено в

/usr/share/groff/1.22.3/oldfont/devps

каталог.

Щоб використовувати їх, переконайтеся, що намацки знаходить шрифти перед стандартними системними шрифтами (з
однакові імена): Або додайте параметр командного рядка -F до намацки

groff -Тпс -ПФ -P/usr/share/groff/1.22.3/oldfont ...

або додайте каталог до змінної середовища Groff

GROFF_FONT_PATH=/usr/share/groff/1.22.3/oldfont

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

GROPS_PROLOGUE
Якщо це встановлено на Foo, То намацки використовує файл Foo (у шляху шрифту) замість
файл прологу за замовчуванням пролог. Варіант -P перекриває це середовище
змінна.

GROFF_FONT_PATH
Список каталогів, у яких потрібно шукати DEVім'я каталог на додаток до
за замовчуванням. Побачити троф(1) і groff_font(5) для більш детальної інформації.

SOURCE_DATE_EPOCH
Позначка часу (виражається в секундах з епохи Unix) для створення
мітка часу замість поточного часу.

Використовуйте grops онлайн за допомогою сервісів onworks.net