# Создание документов PostScript

# Введение

Модуль позволяет создавать документы в формате PostScript. Он имеет много общего с модулем для создания PDF. На самом деле, API обоих модулей практически одинаковые и в большинстве случаев отличаются только префиксом функций: pdf_ и ps_. Причём, это касается и таких функций, которые, казалось бы, не имеют смысла в документах PostScript (например, добавление гиперссылок), но сработают при конвертации документа в PDF.

Документы, создаваемые этим модулем в некоторых случаях выглядят даже лучше, чем сгенерированные с помощью модуля PDF из-за того, что функции рендеринга библиотеки pslib поддерживают обработку кернинга, переносов и связок, существенно улучшающих вид выводимого текста.

- Установка и настройка
  - Требования
  - Установка
  - Типы ресурсов
- Предопределённые константы
- Функции PS
  - ps_add_bookmark — Добавляет закладку на текущую страницу
  - ps_add_launchlink — Добавляет ссылку, запускающую файл
  - ps_add_locallink — Добавляет ссылку на страницу того же документа
  - ps_add_note — Добавляет примечание к текущей странице
  - ps_add_pdflink — Добавляет ссылку на страницу в другом PDF-документе
  - ps_add_weblink — Добавляет ссылку на веб-страницу
  - ps_arc — Рисует дугу против часовой стрелки
  - ps_arcn — Рисует дугу по часовой стрелке
  - ps_begin_page — Начинает новую страницу
  - ps_begin_pattern — Начинает новый узор
  - ps_begin_template — Начинает новый шаблон
  - ps_circle — Рисует круг
  - ps_clip — Отрисовка клипов по текущему пути
  - ps_close — Закрывает документ PostScript
  - ps_close_image — Закрывает изображение и освобождает память
  - ps_closepath — Замыкает путь
  - ps_closepath_stroke — Замыкает и обводит контур
  - ps_continue_text — Продолжает текст в следующей строке
  - ps_curveto — Рисует кривую
  - ps_delete — Удаляет все ресурсы документа PostScript
  - ps_end_page — Завершает страницу
  - ps_end_pattern — Завершает шаблон
  - ps_end_template — Завершает шаблон
  - ps_fill — Заполняет текущий путь
  - ps_fill_stroke — Заполняет и обводит текущий путь
  - ps_findfont — Загружает шрифт
  - ps_get_buffer — Получает полный буфер, содержащий сгенерированные данные PS
  - ps_get_parameter — Получает определённые параметры
  - ps_get_value — Получает определённые значения
  - ps_hyphenate — Переносит слово
  - ps_include_file — Читает внешний файл с необработанным кодом PostScript
  - ps_lineto — Рисует линию
  - ps_makespotcolor — Создаёт плашечный цвет
  - ps_moveto — Устанавливает текущую точку
  - ps_new — Создаёт новый объект документа PostScript
  - ps_open_file — Открывает файл для вывода
  - ps_open_image — Считывает изображение для последующего размещения
  - ps_open_image_file — Открывает изображение из файла
  - ps_open_memory_image — Берёт изображение GD и возвращает изображение для размещения в документе PS
  - ps_place_image — Размещает изображение на странице
  - ps_rect — Рисует прямоугольник
  - ps_restore — Восстанавливает ранее сохранённый контекст
  - ps_rotate — Устанавливает коэффициент вращения
  - ps_save — Сохраняет текущий контекст
  - ps_scale — Устанавливает коэффициент масштабирования
  - ps_set_border_color — Устанавливает цвет границы аннотаций
  - ps_set_border_dash — Устанавливает длину тире для границы аннотации
  - ps_set_border_style — Устанавливает стиль границы аннотаций
  - ps_set_info — Устанавливает информационные поля документа
  - ps_set_parameter — Устанавливает определённые параметры
  - ps_set_text_pos — Устанавливает позицию для вывода текста
  - ps_set_value — Устанавливает определённые значения
  - ps_setcolor — Устанавливает текущий цвет
  - ps_setdash — Устанавливает внешний вид пунктирной линии
  - ps_setflat — Устанавливает плоскостность
  - ps_setfont — Устанавливает шрифт, который будет использоваться для следующего вывода
  - ps_setgray — Устанавливает значение серого
  - ps_setlinecap — Устанавливает внешний вид окончания линии
  - ps_setlinejoin — Устанавливает способ соединения линий
  - ps_setlinewidth — Устанавливает ширину линии
  - ps_setmiterlimit — Устанавливает предел скоса
  - ps_setoverprintmode — Устанавливает режим наложения
  - ps_setpolydash — Устанавливает внешний вид пунктирной линии
  - ps_shading — Создаёт затенение для последующего использования
  - ps_shading_pattern — Создаёт узор на основе затенения
  - ps_shfill — Заполняет область затенением
  - ps_show — Выводит текст
  - ps_show_boxed — Выводит текст в поле
  - ps_show_xy — Выводит текст в заданной позиции
  - ps_show_xy2 — Выводит текст в заданной позиции
  - ps_show2 — Выводит текст в текущей позиции
  - ps_string_geometry — Получает геометрию строки
  - ps_stringwidth — Получает ширину строки
  - ps_stroke — Рисует текущий путь
  - ps_symbol — Выводит глиф
  - ps_symbol_name — Получает имя глифа
  - ps_symbol_width — Получает ширину глифа
  - ps_translate — Изменяет систему координат

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open