Библиотека

Описание библиотеки

Библиотеку можно взять отсюда. и файл, подключающий шрифты, fontmap.ps.

В библиотеки собраны часто употребляемые функции, позволяющие упростить работу. Библиотека имеет несколько особенностей:

Русскоязычные названия функций

Большинство функций библиотеки имеют русские имена. Спецификация языка это допускает, а интерпретатор Ghostscript их обрабатывает. Это повышает читабельность программ, делает, насколько это возможно их самодокументироваными.

Имена присваиваются по правилам:

Все функции объединены в группы по предметной области, организуя что-то вроде объектов (точнее, методов).
Вначале каждого имени пишется название группы (область примения) функции. Например:
Далее, через точку, действие функции.
```
Шрифт.Применить
```
где, Шрифт - группа;
Применить - функция.
Если функция, требует скрытых глобальных переменных, то они записываются через две точки от названия группы. Например:
```
Шрифт..Размерность
```
где, Шрифт - группа;
Размерность - внутрення переменная группы.
Доступ к внутренним переменным группы осуществляется только через функции.
Функции группы, устанавливающие значение внутренней переменной, пишутся в конце со знаком !. Например:
```
Шрифт.Высота!
```
где, Шрифт - группа;
Высота! - функция, задающая новую высоту шрифта, в отличии от Шрифт.Высота, которая возвращает высоту текущего шрифта.

Состояние стека

Новшеством является и описание состояние стека ДО выполнения оператора и ПОСЛЕ. Офрмление построено на следующих принципах:

Вершина стека располагается слева, указываются 8 верхних ячеек стека. Все они пронумерованы от 0 до 7.
Верхняя строчка обозначает состояние стека ДО выполнения оператора. Там указывается что и в какой ячейке ожидает увидеть оператор.
В нижней строчке находится название оператора и состояние стека ПОСЛЕ выполнения этого оператора. Там указывается какие и куда он кладет результаты.

Ниже дается расшифровка обозначений.

Пример оформление оператора:

0 1 2 3 4 5 6 7
град
tang tg

град угол в градусах
tg его тангенс
Возвращает тангенс указанного угла. Угол задается в градусах.

Комментарии в библиотеке

Насколько смог я документировал и текст библиотеки и функции, в ней описанные. Оформленный исходный текст повышает понимание алгоритмов работы, но и комментарии также важны для понимания работы библиотеки.

Подключение библиотеки

Чтобы подключить библиотеку в начало файла необходимо вставить строку:

 (c:/aaa/bbb/lib-2.ps) run

где c:/aaa/bbb полный путь к библитеке lib-2.ps

ВАЖНО Путь записывается с обратным слешем (как в UNIX)!

Описание функций

Описание операторов функций приведено по группам. Но также проведен индекс и по алфавиту для названий ВСЕХ функций библиотеки.

Структура директорий

Библиотека настроена на следующую структуру директорий:

 C:\-- aaa
        +---bbb
        +---font

В папке C:/aaa/bbb храниться сама библиотека, а в папке C:\aaa\font лежат фонты, которые доступны через библиотеку. Подключаемые шрифты описываются в файле fontmap.ps.

Создайте такую же структуру директорий у себя и загрузите в папку C:/aaa/bbb библиотеку отсюда.

24.02.2002

Хостинг от uCoz