grops - Интернет в облаке

ПРОГРАММА:

ИМЯ

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

СИНТАКСИС

нащупывает [-глмв] [-b n] [-c n] [-F директория] [-I директория] [-p размер бумаги] [-P пролог] [-w n] [файлов
...]

ОПИСАНИЕ

нащупывает переводит вывод GNU TROFF в PostScript. Как обычно нащупывает должен быть вызван
используя команду groff с -Тпс вариант. (На самом деле это значение по умолчанию для groff.)
Если файлы не указаны, нащупывает читает стандартный ввод. Имя файла - также вызывает нащупывает
читать стандартный ввод. Вывод PostScript записывается в стандартный вывод. Когда
нащупывает управляется Грофф параметры могут быть переданы нащупывает через Грофф's -P опцию.

Обратите внимание, что нащупывает не создает действительную структуру документа (соответствует Документу
Соглашение о структурировании), если вызывается с несколькими аргументами файла. Распечатать такие
конкатенированный вывод необходимо деактивировать обработку DSC в программе печати или
предварительный просмотр. См. Раздел FONT МОНТАЖ ниже показано, как установить шрифты для
нащупывает.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Между параметром командной строки и его параметром может быть пробел.

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

Добавьте 1, если нет %% BeginDocumentSetup и %% EndDocumentSetup комментарии должны быть
сгенерировано; это необходимо для ранних версий TranScript, которые запутались в
что-нибудь между %% EndProlog комментарий и первый %%Страница комментарий.

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

Добавьте 4, если %%Страница, %% трейлер и %% EndProlog комментарии должны быть удалены из
включенные файлы; это необходимо для диспетчеров очереди печати, которые не понимают %%Начинать-
Документ и %% EndDocument комментариев.

Добавьте 8, если первая строка вывода PostScript должна быть %! PS-Adobe-2.0 скорее
чем %! PS-Adobe-3.0; это необходимо при использовании газетной бумаги Sun с принтером, который
требует переворота страницы.

Добавьте 16, если в документ не следует включать информацию о размере носителя (т. Е.
ни использовать %% DocumentMedia ни установкастраницыустройство Команда PostScript). Это было
поведение groff версии 1.18.1 и ранее; это необходимо для старых принтеров
которые не понимают PostScript LanguageLevel 2. Это также необходимо, если
вывод обрабатывается для получения инкапсулированного файла PS (EPS) - см. ниже.

Значение по умолчанию может быть указано

сломанный n

в файле DESC. В противном случае значение по умолчанию - 0.

-cn Печать n копии каждой страницы.

-Fдиректория Подготовить каталог директория/ DEVимя к пути поиска пролога, шрифта и устройства
файлы описания; имя это имя устройства, обычно ps.

-g Угадай длину страницы. Это генерирует код PostScript, который угадывает страницу
длина. Предположение верное только в том случае, если область изображения расположена вертикально по центру
страница. Эта опция позволяет создавать документы, которые можно распечатать как на
на бумаге формата letter (8.5 × 11) и на бумаге формата А4 без сдачи.

-Iдиректория Эта опция может использоваться для добавления каталога к пути поиска файлов на
командная строка и файлы с именами в \ X'ps: Импортировать' и \ X'ps: файл' убегает. В
путь поиска инициализируется текущим каталогом. Этот вариант может быть
указано более одного раза; затем каталоги ищутся в указанном порядке
(но перед текущим каталогом). Если вы хотите сделать текущий каталог
прочтите перед другими каталогами, добавьте -I. в соответствующем месте.

Поиск в каталогах для файлов с абсолютным именем не выполняется.

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

-m Включите ручную подачу документа.

-pразмер бумаги
Установите физический размер выходного носителя. Это отменяет размер бумаги,
длина бумаги и ширина бумаги команды в По убыванию файл; он принимает то же самое
аргументы как размер бумаги команда. Видеть groff_font (5) для получения информации.

-Pпролог-файл
Используйте файл пролог-файл (в пути к шрифту) в качестве пролога вместо
файл пролога по умолчанию пролог. Этот параметр переопределяет переменную среды
GROPS_ПРОЛОГ.

-wn Линии следует рисовать толщиной n тысячные доли эм. Если этот вариант
не указан, толщина линии по умолчанию составляет 0.04 см.

-v Выведите номер версии.

ИСПОЛЬЗОВАНИЕ

Вход в нащупывает должен быть в формате, выводимом TROFF(1). Это описано в
groff_out(5).

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

В файле описания устройства должен быть указан допустимый размер бумаги; видеть groff_font(5) подробнее
Информация.

Каждый файл описания шрифта должен содержать команду

внутреннее имя псевдоним

который говорит, что PostScript-имя шрифта псевдоним. Он также может содержать команду

кодирование enc_file

в котором говорится, что шрифт PostScript следует перекодировать с использованием кодировки, описанной в
enc_file; этот файл должен состоять из последовательности строк вида:

пшар код

в котором пшар - имя персонажа в PostScript, а код его позиция в
кодировка, выраженная в виде десятичного целого числа; допустимые значения находятся в диапазоне от 0 до 255. Строки
начиная с # пустые строки игнорируются. Код для каждого символа, указанный в
файл шрифта должен соответствовать коду символа в файле кодировки или коду
в кодировке по умолчанию для шрифта, если не требуется перекодировать шрифт PostScript. Этот
код можно использовать с \N escape-последовательность в TROFF для выбора персонажа, даже если
у персонажа нет имени groff. Каждый символ в файле шрифта должен существовать в
Шрифт PostScript, а ширина, указанная в файле шрифта, должна соответствовать ширине, используемой в
Шрифт PostScript. нащупывает предполагает, что персонаж с именем groff космосе пусто
(не делает отметок на странице); он может использовать такого персонажа, чтобы генерировать больше
эффективный и компактный вывод PostScript.

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

нащупывает может автоматически включать загружаемые шрифты, необходимые для печати документа.
Такие шрифты должны быть в формате PFA. Использовать пфбтопс(1) для преобразования шрифта Type 1 в формат PFB.
Любые загружаемые шрифты, которые при необходимости должны быть включены нащупывает должен быть указан в
файла /usr/доля/грофф/1.22.3/шрифт/devps/скачать; это должно состоять из строк
форма

шрифт имя файла

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

Если файл, содержащий загружаемый шрифт или импортированный документ, соответствует требованиям Adobe
Document Structuring Conventions, затем нащупывает интерпретирует любые комментарии в файлах
достаточно, чтобы убедиться, что его собственный вывод соответствует требованиям. Он также поставляет все необходимое
ресурсы шрифтов, перечисленные в скачать файл, а также любые необходимые файловые ресурсы.
Он также может обрабатывать зависимости между ресурсами. Например, предположим, что у вас есть
загружаемый шрифт Garamond, а также загружаемый шрифт Garamond-Outline
который зависит от Garamond (обычно определяется копирование шрифта Garamond
словарь и измените PaintType), то необходимо, чтобы Гарамонд появился перед
Garamond-Outline в документе PostScript. нащупывает обрабатывает это автоматически при условии
что загружаемый файл шрифта для Garamond-Outline указывает на его зависимость от Garamond
с помощью соглашений о структурировании документов, например, начиная с
следующие строки

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

В этом случае и Garamond, и Garamond-Outline должны быть указаны в списке скачать
файл. Загружаемый шрифт не должен включать собственное имя в %% DocumentSupplied‐
Ресурсы комментарий.

нащупывает не интерпретирует %% DocumentFonts Комментарии. В %% 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 Авангард-Деми
ABI Авангард-DemiOblique
BMR Книжник-Свет
BMI Bookman-Light, курсив
BMB Книжник-Деми
БМБИ Bookman-полукурсив
CR Курьер
CI Курьер-косой
CB Курьер-жирный
CBI Курьер-BoldOblique
HR Helvetica
HI Helvetica-наклонная
HB Гельветика-полужирный
ГБЖ Helvetica-BoldOblique
ХНР Helvetica-узкий
HNI Helvetica-Узкокосая
HNB Helvetica-Узкий-Жирный
ХНБИ Helvetica-Narrow-BoldOblique
NR NewCenturySchlbk-Роман
NI NewCenturySchlbk-курсив
NB Новый векSchlbk-Bold
ЦКП NewCenturySchlbk-BoldItalic
PR Палатино-римский
PI Палатино-курсив
PB Палатино-Смелый
PBI Палатино-Полужирный
TR Таймс-Роман
TI Times-курсив
TB Раз-жирный
TBI Times-жирный курсив

Также существует следующий шрифт, не входящий в семейство:

ЗКМИ 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-последовательность; нащупывает Важно
интерпретирует команды, начинающиеся с символа пс: тег.

\ X'ps: Exec код'
Это выполняет произвольные команды PostScript в код. PostScript
currentpoint устанавливается в положение \X команда перед выполнением код,
начало координат находится в верхнем левом углу страницы, а координаты y увеличиваются вниз
страница. Процедура u определен, который преобразует единицы groff в систему координат
действует (при условии, что пользователь не меняет масштаб). Например,

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

рисует горизонтальную линию длиной один дюйм. код может вносить изменения в графику
состояние, но любые изменения сохраняются только до конца страницы. Словарь
содержащие определения, указанные в защиту и мдеф находится на вершине
стек словарей. Если ваш код добавляет определения в этот словарь, вам следует
выделить для них место, используя \ X'ps мдеф n'. Любые определения сохраняются только до тех пор, пока
конец страницы. Если вы используете \Y escape-последовательность с аргументом, который называет
макрос, код может занимать несколько строк. Например,

.nr x 1i
.de y
пс: Exec
\ nx u 0 Rlineto
ход
..
\ Yy

- еще один способ нарисовать горизонтальную линию длиной в один дюйм. Обратите внимание на одиночную обратную косую черту
перед 'nx' - единственная причина использовать числовой регистр при определении макроса 'y'
заключается в преобразовании заданного пользователем размера '1i' во внутренние единицы groff, которые находятся в
поверните преобразованные в единицы PS с u процедуры.

нащупывает помещает указанный пользователем код PostScript в словарь, не более того. В
в частности, он не начинается и не завершает вставленный код с сэкономь и восстановление,
соответственно. При необходимости это должно быть предоставлено пользователем.

\ X'ps: файл имя'
Это так же, как Exec команда, за исключением того, что код PostScript считывается из
файл имя.

\ X'ps: защиту код'
Поместите определение PostScript, содержащееся в код в прологе. Там должен быть
не более одного определения на \X команда. Длинные определения можно разделить на несколько
\X команды; все код аргументы просто объединяются, разделенные
новые строки. Определения помещаются в словарь, который автоматически добавляется.
в стеке словарей, когда Exec команда выполняется. Если вы используете \Y бежать
последовательность с аргументом, который называет макрос, код может занимать несколько строк.

\ X'ps: мдеф n код'
Подобно защиту, Кроме этого код может содержать до n определения. нащупывает нужно знать
сколько определений код содержит так, чтобы он мог создать соответствующий размер
Словарь PostScript, чтобы содержать их.

\ X'ps: Импортировать файл LLX LLY URL-адрес URY ширина [ высота ]'
Импортировать графику PostScript из файл. Аргументы LLX, LLY, URL-адрес и URY давать
ограничивающая рамка изображения в системе координат PostScript по умолчанию; Oни
все должны быть целыми числами; LLX и LLY координаты x и y левого нижнего
угол рисунка; URL-адрес и URY координаты x и y верхнего правого
угол рисунка; ширина и высота целые числа, которые дают желаемую ширину
и высота в единицах groff изображения.

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

Обратите внимание, что содержимое \X команда не интерпретируется TROFF; так вертикально
пространство для графики не добавляется автоматически, и ширина и высота
аргументы не могут иметь прикрепленные индикаторы масштабирования.

Если файл PostScript соответствует правилам структурирования документов Adobe и
содержит %%Ограничительная рамка комментарий, то ограничивающая рамка может быть автоматически
извлекается из groff с помощью псбб запрос.

Посмотреть groff_tmac(5) для описания ПСПИК макрос, обеспечивающий удобный
высокоуровневый интерфейс для включения графики PostScript.

\ X'ps: invis '
\ X'ps: endinvis '
Для текстовых команд и команд рисования, заключенных в скобки с этими
\X команды. Эти команды предназначены для использования при выводе из TROFF 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 Крючок был определен через 'пс: защиту' или 'пс: мдеф' устройство
команда, она выполняется в начале каждой страницы (до того, как что-либо будет нарисовано или
написано groff). Например, чтобы подложить под содержание страницы слово "ЧЕРНОВИК" в
светло-серый, вы можете использовать

.de XX
пс: защиту
/ BPhook
{ gsave .9 Setgray вырезка путьbbox обменять 2 копия
.5 мул обменять .5 мул переведите загар вращать поп поп
/ NewCenturySchlbk-Roman находка 200 масштаб установить шрифт
(ПРОЕКТ) дубликат ширина строки поп -. 5 мул -70 двигаться по оценкам,
Grestore }
защиту
..
.devicem XX

Или, чтобы линии и многоугольники рисовались с помощью квадратных заглавных букв и скошенных стыков.
вместо круглых заглушек и переходов, обычно используемых нащупывает, Используйте

.de XX
пс: защиту
/ BPhook { 2 Setlinecap 0 установить } защиту
..
.devicem XX

(квадратные заглушки, в отличие от стыковых заглушек (0 setlinecap), дают истинные углы в рамке
таблицы, даже если линии нарисованы не связанными).

Герметичная PostScript
нащупывает сам по себе не выдает информацию об ограничивающей рамке. С помощью Ghostscript
следующий простой скрипт, groff2eps, создает инкапсулированный файл PS.

#! / Бен / ш
Грофф -P-b16 $1 > 1 доллар США
gs -дНОПАУЗА -sDEVICE = bbox -- 1 доллар США 2> $ 1.bbox
СЕПГ -e "/ ^ %% Ориентация / r $ 1.bbox " \
-e "/^%!PS-Adobe-3.0/s/$/ ЭПСФ-3.0 / " 1 доллар США > 1 доллар США
rm 1 доллар США $ 1.bbox

Просто скажи

groff2eps Foo

конвертировать файл Foo в foo.eps.

TrueType и другими шрифт Форматы
Шрифты TrueType можно использовать с нащупывает если сначала преобразовать в Тип 42 формат, специальный
Оболочка PostScript, эквивалентная формату PFA, упомянутому в пфбтопс(1). Есть
несколько различных методов для создания оболочки type42, и большинство из них включают использование
интерпретатор PostScript, такой как Ghostscript - см. gs(1).

Но самый простой способ предполагает использование приложения. ttftot42(1). Эта программа
использования свободный тип(3) (версия 1.3.1) для создания оболочки шрифта type42 и правильно сформированного AFM
файлы, которые можно передать в афмтодит(1) сценарий для создания соответствующих файлов метрик. В
получившиеся оболочки шрифтов следует добавить в скачать . 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⟩. Этот редактор шрифтов может преобразовать большинство контуров
форматы шрифтов.

FONT МОНТАЖ

В этом разделе дается краткое изложение приведенных выше объяснений; он может служить пошаговым
руководство по установке шрифтов для нащупывает.

· Преобразуйте свой шрифт в то, что понимает groff. Это либо PostScript Type 1
шрифт в формате PFA или шрифт PostScript Type 42 вместе с файлом AFM.

Самые первые символы в файле PFA выглядят так:

%! PS-AdobeFont-1.0:

В файле PFB это тоже есть в первой строке, но перед строкой стоит какой-то
двоичные байты.

Самые первые символы в файле шрифта Type 42 выглядят так:

%! PS-TrueTypeFont

Это формат оболочки для шрифтов TrueType. Старые принтеры PS могут не поддерживать его
(то есть у них нет встроенного интерпретатора шрифтов TrueType).

Если ваш шрифт имеет формат PFB (такие шрифты обычно имеют расширение файла .pfb),
вы можете использовать groff's пфбтопс(1) программа для преобразования его в PFA. Для шрифтов TrueType
стараться ttftot42 or шрифтфорж. Для всех других форматов шрифтов используйте шрифтфорж который может конвертировать
большинство форматов контурных шрифтов.

· Преобразуйте файл AFM в файл описания шрифта groff с афмтодит(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,
и TBI.

· Установите файлы описания шрифтов groff и шрифты в подкаталог devps.
пути шрифта, который находит groff. Увидеть ОКРУЖАЮЩАЯ СРЕДА в TROFF(1) мужчина
страница, на которой указано фактическое значение пути к шрифту. Обратите внимание, что groff не использует
Файлы AFM (но в любом случае лучше их сохранить).

· Зарегистрируйте все шрифты, которые должны быть загружены на принтер, в папке devps / download
файл. Считывается только первое вхождение этого файла в путь к шрифту. Это означает
что вы должны скопировать файл загрузки по умолчанию в первый каталог в вашем шрифте
path и добавьте туда свои шрифты. Чтобы продолжить приведенный выше пример, мы предполагаем, что PS
имя шрифта для Foo-Bar-Bold.pfa - 'XY-Foo-Bar-Bold' (имя шрифта PS хранится в
внутреннее имя поле в файле 'FBB'), поэтому в
'скачать'.

XY-Foo-Bar-Жирный Foo-Bar-Bold.pfa

OLD ШРИФТЫ

groff версии 1.19.2 и более ранние содержат немного другой набор ядра Adobe 35.
шрифты; разница в основном заключается в отсутствии символа «евро» и сокращенном наборе кернинга.
пары. Для обратной совместимости эти старые шрифты также устанавливаются в

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

каталог.

Чтобы использовать их, убедитесь, что нащупывает находит шрифты перед системными шрифтами по умолчанию (с
те же имена): либо добавить параметр командной строки -F в нащупывает

Грофф -Тпс -ПФ -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имя каталог в дополнение к
стандартные. Видеть TROFF(1) и groff_font(5) для получения более подробной информации.

SOURCE_DATE_EPOCH
Отметка времени (выраженная в секундах с эпохи Unix) для использования в качестве создания
отметка времени вместо текущего времени.

Используйте grops онлайн с помощью сервисов onworks.net