Руководство по РНР 3.0 - Функции PDF
Вы можете использовать функции PDF для создания pdf файлов, если вы имеете
библиотеку PDF (доступную на
http://www.ifconnection.de/~tm/
) Томаса Мерза. Пожалуйста, используйте документацию для библиотеки pdflib,
поставляемой с исходным кодом или доступной на
http://www.ifconnection.de/~tm/software/pdflib/PDFlib-0.6.pdf
. Так как эта документация является не полной, документация библиотека pdflib
должна быть просмотрена в первую очередь. Функции в бибилотеке pdflib и в php3
имеют одинаковые имена. Параметры также идентичны. Вам следует также понимать некоторые
концепции pdf для еффективного применения этого модуля.
Модуль pdf использует два новых типа переменных. Они называются
pdfdoc
и
pdfinfo
.
PDF_get_info
PDF_get_info -- Возвращает обычную информационную структуру для pdf документа
Описание
info pdf_get_info
(string filename);
Функция
PDF_get_info()
возвращает обычную (принимаемую по умолчанию) информационную структуру для pdf документа.
Эта структура может быть заполнена различной информацией, такой как автор, название и т.д.
Пример 1. PDF_get_info
<?php $info = PDF_get_info();
PDF_set_info_creator($info, "Name of Author") ?>
|
См. также
PDF_set_info_creator()
,
PDF_set_info_subject()
.
PDF_set_info_creator
PDF_set_info_creator -- Заполняет поле создателя информационной структуры
PDF_set_info_title
PDF_set_info_title -- Заполняет поле заголовка информационной структуры
Описание
void pdf_set_info_title
(info info, string title);
Функция
PDF_set_info_title()
устанавливает заголовок pdf документа. Она должна вызываться после
PDF_get_info()
и перед
PDF_open()
. Вызов функции после
PDF_open()
не даст никакого эффекта в документе.
Примечание:
Эта функция не является частью библиотеки pdf.
См. также
PDF_get_info()
,
PDF_set_info_xxxxx()
.
PDF_set_info_subject
PDF_set_info_subject -- заполняет поле темы информационной структуры
Описание
void pdf_set_info_subject
(info info, string subject);
Функция
PDF_set_info_subject()
устанавливает тему pdf документа. Она должна вызываться после
PDF_get_info()
и перед
PDF_open()
. Вызов функции после
PDF_open()
не даст никакого эффекта в документе.
Замечание:
Эта функция не является частью библиотеки pdf.
См. также
PDF_get_info()
,
PDF_set_info_xxxxx()
.
PDF_set_info_keywords
PDF_set_info_keywords -- Заполняет поле ключевых слов информационной структуры
Описание
void pdf_set_info_keywords
(info info, string keywords);
Функция
PDF_set_info_keywords()
устанавливает ключевые слова pdf документа. Она должна вызываться после
PDF_get_info()
и перед
PDF_open()
. Вызов функции после
PDF_open()
не даст никакого эффекта в документе.
Замечание:
Эта функция не является частью библиотеки pdf.
См. также
PDF_get_info()
,
PDF_set_info_xxxxx()
.
PDF_set_info_author
PDF_set_info_author -- Заполняет поле автора информационной структуры
Описание
void pdf_set_info_author
(info info, string author);
Функция
PDF_set_info_author()
устанавливает автора pdf документа. Она должна вызываться после
PDF_get_info()
и перед
PDF_open()
. Вызов функции после
PDF_open()
не даст никакого эффекта в документе.
Замечание:
Эта функция не является частью библиотеки pdf.
См. также
PDF_get_info()
,
PDF_set_info_xxxxx()
.
PDF_open
PDF_open -- Открывает новый pdf документ
Описание
int pdf_open
(int descripterfile, int info);
Функция
PDF_set_info_author()
открывает новый pdf документ. Соответствующий файл должен быть открыт
функцией
fopen()
и дескриптор файла использоваться как аргумент
file
.
info
является информационной структурой, которая должна быть создана функцией
pdf_get_info()
.
Замечание:
Возвращаемое значение необходимо как первый параметр у всех функций
записи в pdf документ.
См. также
fopen()
,
PDF_get_info()
.
PDF_close
PDF_close -- Закрывает pdf документ
Описание
void pdf_close
(int pdf document);
Функция
PDF_close()
закрывает pdf документ
int
.
Замечание:
Функция не закроет файл. Вам неоходимо вызвать отдельно функцию
fclose()
после
pdf_close()
.
См. также
PDF_open()
,
fclose().
PDF_begin_page
PDF_begin_page -- начинает страницу
Описание
void pdf_begin_page
(int pdf document, double height, double width);
Функция
PDF_begin_page()
начинает новую страницу высотой
height
и шириной
width
.
См. также
PDF_end_page().
PDF_end_page
PDF_end_page -- завершает страницу
PDF_show
PDF_show -- выводит текст в текущей позиции
PDF_show
PDF_show -- Выводит текст с определнной позиции
Описание
void pdf_show_xy
(int pdf document, string text, double x-koor, double y-koor);
Функция
PDF_show_xy()
выводит строку
text
в позиции с координатами (
x-koor
,
y-koor
).
См. также
PDF_show()
.
PDF_set_font
PDF_set_font -- Выбирает текущий шрифт и его размер
Описание
void pdf_set_font
(int pdf document, string font name, double size, string encoding);
Функция
PDF_set_font()
устанавливает текущий шрифт, его размер и кодировку. Вам потребуется указать
Adobe Font Metrics (afm-файлы) для шрифта в пути шрифта (по умолчанию ./fonts).
См. также
PDF_info()
.
PDF_set_leading
PDF_set_leading -- Устанавливает промежуток между строками текста
PDF_set_text_rendering
PDF_set_text_rendering -- Определяет, как текст отрисовывается (рендеринг)
Описание
void pdf_set_text_rendering
(int pdf document, int mode);
Функция
PDF_set_text_rendering()
определяет, как текст отрисовывается. Возможные значения для параметра
mode
это 0=заливка текста, 1=контурный текст, 2=контурный текст с заливкой, 3=невидимый текст,
4=заливка текста и добавление его в контур обреза, 5=контурный текст с добалением в контур
обреза, 6=контурный текст с заливкой и с добавлением к контур обреза,
7=добавление текста в контур обреза.
PDF_set_horiz_scaling
PDF_set_horiz_scaling -- Устанавливает горизонтальное масштабирование текста
Описание
void pdf_set_horiz_scaling
(int pdf document, double scale);
Функция
PDF_set_horiz_scaling()
устанавливает горизонтальное масштабирование в
scale
процентов.
PDF_set_text_rise
PDF_set_text_rise -- Устанавливает увеличение текста
Описание
void pdf_set_text_rise
(int pdf document, double value);
Функция
PDF_set_text_rise()
устанавливает увеличение текста на
value
едениц.
PDF_set_text_matrix
PDF_set_text_matrix -- Устанавливает тестовую матрицу
Описание
void pdf_set_text_matrix
(int pdf document, array matrix);
Функция
PDF_set_text_matrix()
уставливает матрицу, которая описывает изменения, применяемые к
текущему шрифту текста.
PDF_set_text_pos
PDF_set_text_pos -- Устанавливает позицию текста
PDF_set_char_spacing
PDF_set_char_spacing -- Устанавливает межсимвольные промежутки
PDF_set_word_spacing
PDF_set_word_spacing -- Устанавливает промежутки между словами
PDF_continue_text
PDF_continue_text -- Выводит текст на следующей строке
PDF_stringwidth
PDF_stringwidth -- Возвращает ширину текста при текущем шрифте
Описание
double pdf_stringwidth
(int pdf document, string text);
Функция
PDF_stringwidth()
возвращает ширину строки в
text
. Этой функции необходим заранее установленный шрифт.
См. также
PDF_set_font()
.
PDF_save
PDF_save -- Сохраняет текущее окружение
Описание
void pdf_save
(int pdf document);
Функция
PDF_save()
сохраняет текущее окружение. Она работает как postscript-команда gsave.
Функция очень полезна при переводе или вращении объекта без затрагивания
других объектов.
См. также
PDF_restore()
.
PDF_restore
PDF_restore -- Восстанавливает сохраненное ранее окружение
Описание
void pdf_restore
(int pdf document);
Функция
PDF_restore()
восстанавливает окружение сохраненное функцией
PDF_save()
. Она работает postscript-команда grestore. Функция очень полезна при переводе или вращении
объекта без затрагивания других объектов.
Example 1. PDF_get_info
<?php PDF_save($pdf);
// делает все виды вращений, трансформаций...
PDF_restore($pdf) ?>
|
См. также
PDF_save()
.
PDF_translate
PDF_translate -- Устанавливает начало системы координат
Описание
void pdf_translate
(int pdf document, double x-koor, double y-koor);
Функция
PDF_translate()
устанавливает начало системы координат в точке (
x-koor
,
y-koor
).
PDF_scale
PDF_scale -- Устанавливает масштабирование
Описание
void pdf_scale
(int pdf document, double x-scale, double y-scale);
Функция
PDF_scale()
устанавливает масштабный коэффициент для обоих осей.
PDF_rotate
PDF_rotate -- Устанавливает вращение
Описание
void pdf_rotate
(int pdf document, double angle);
Функция
PDF_rotate()
Устанавливает вращение в процентах на угол
angle
.
PDF_setflat
PDF_setflat -- Устанавливает плоскость
Описание
void pdf_setflat
(int pdf document, double value);
Функция
PDF_setflat()
устанавливает плоскость на величину от 0 до 100.
PDF_setlinejoin
PDF_setlinejoin -- Устанавливает параметр слияния линий
Описание
void pdf_setlinejoin
(int pdf document, long value);
Функция
PDF_setlinejoin()
устанавливает параметр слияния линий между от 0 до 2.
PDF_setlinecap
PDF_setlinecap -- Устанавливает параметр формата строки
Описание
void pdf_setlinecap
(int pdf document, int value);
Функция
PDF_setlinecap()
устанавливает параметр формата строки от 0 до 2.
PDF_setmiterlimit
PDF_setmiterlimit -- Устанавливает минимальную границу
Описание
void pdf_setmiterlimit
(int pdf document, double value);
Функция
PDF_setmiterlimit()
устанавливает минимальную границу больше или равную 1.
PDF_setlinewidth
PDF_setlinewidth -- Устанавливает ширину линии
Описание
void pdf_setlinewidth
(int pdf document, double width);
Функция
PDF_setlinewidth()
устанавливает ширину
width
линии.
PDF_setdash
PDF_setdash -- Устанавливает шаблон тире
Описание
void pdf_setdash
(int pdf document, double white, double black);
Функция
PDF_setdash()
устанавливает шаблон тире, где
white
- еденицы белого и
black
- еденицы черного. Если они оба равны 0, то устанавливается сплошная линия.
PDF_moveto
PDF_moveto -- Устанавливает текущую точку
Описание
void pdf_moveto
(int pdf document, double x-koor, double y-koor);
Функция
PDF_moveto()
устаналивает текущую точку в координатах
x-koor
и
y-koor
.
PDF_curveto
PDF_curveto -- Рисует кривую
Описание
void pdf_curveto
(int pdf document, double x1, double y1, double x2, double y2, double x3, double y3);
Функция
PDF_curveto()
рисует кривую Безье с текущей тоски до точки с координатами (
x3
,
y3
) используя
(
x1
,
y1
) и
(
x2
,
y2
) как управляющие точки.
См. также
PDF_moveto()
,
PDF_lineto()
.
PDF_lineto
PDF_lineto -- Рисует линию
Описание
void pdf_lineto
(int pdf document, double x-koor, double y-koor);
Функция
PDF_lineto()
рисует линию с текущей точки до точки с координатами
(
x-koor
,
y-koor
).
См. также
PDF_moveto()
,
PDF_curveto()
.
PDF_circle
PDF_circle -- Рисует круг
Описание
void pdf_circle
(int pdf document, double x-koor, double y-koor, double radius);
Функция
PDF_circle()
рисует круг с центром в точке (
x-koor
,
y-koor
) и радиусом
radius
.
См. также
PDF_arc()
.
PDF_arc
PDF_arc -- Рисует дугу
Описание
void pdf_arc
(int pdf document, double x-koor, double y-koor, double radius, double start, double end);
Функция
PDF_arc()
рисует дугу с центром в точке с координатами (
x-koor
,
y-koor
) и радиусом
radius
, начинает с угла
start
и заканчивает углом
end
.
См. также
PDF_circle()
.
PDF_rect
PDF_rect -- Рисует прямоугольник
Описание
void pdf_rect
(int pdf document, double x-koor, double y-koor, double width, double height);
Функция
PDF_rect()
Рисует прямоугольник с нижним левым углом в точке (
x-koor
,
y-koor
). Ширина определяется параметром
widgth
. Высота определяется параметром
height
.
PDF_closepath
PDF_closepath -- Закрывает контур
Описание
void pdf_closepath
(int pdf document);
Функция
PDF_closepath()
закрывает текущий контур.
PDF_stroke
PDF_stroke -- Рисует линию вдоль контура
PDF_closepath_stroke
PDF_closepath_stroke -- Закрывает контур и рисует вдоль него линию
PDF_fill
PDF_fill -- Заполняет текущий контур
PDF_fill_stroke
PDF_fill_stroke -- Заполняет о обрезает текущий контур
PDF_closepath_fill_stroke
PDF_closepath_fill_stroke -- Закрывает, заполняет и обрезает текущий контур
PDF_endpath
PDF_endpath -- Заканчивает текущий контур
Описание
void pdf_endpath
(int pdf document);
Функция
PDF_endpath()
заканчивает текущий контур, но не закрывает его.
См. также
PDF_closepath()
.
PDF_clip
PDF_clip -- Заканчивает текущий контур
Описание
void pdf_clip
(int pdf document);
Функция
PDF_clip()
прекращает рисование в текущем контуре.
PDF_setgray_fill
PDF_setgray_fill -- Устанавливает серый цвет заполнения
PDF_setgray_stroke
PDF_setgray_stroke -- Устанавливает серый цвет рисования
PDF_setgray
PDF_setgray -- Устанавливает серый цвет рисования и заполнения
PDF_setrgbcolor_fill
PDF_setrgbcolor_fill -- Устанавливает RGB значение цвета заполнения
Описание
void pdf_setrgbcolor_fill
(int pdf document, double red value, double green value, double blue value);
Функция
PDF_setrgbcolor_fill()
делает текущим RGB цвет для заполнения контура.
См. также
PDF_setrgbcolor_fill()
.
PDF_setrgbcolor_stroke
PDF_setrgbcolor_stroke -- Устанавливает RGB значение цвета рисования
PDF_setrgbcolor
PDF_setrgbcolor -- Устанавливает RGB цвет рисования и заполнения
PDF_add_outline
PDF_add_outline -- Добавляет закладку для текущей страницы
Описание
void pdf_add_outline
(int pdf document, string text);
Функция
PDF_add_outline()
добавляет закладку с текстом
text
, которая указывает на текущую страницу.
PDF_set_transition
PDF_set_transition -- Устанавливает переход между страницами
Описание
void pdf_set_transition
(int pdf document, int transition);
Функция
PDF_set_transition()
устанавливает переход между указанными следующими страницами. Значения параметра
transition
могут быть 0 для никакого перехода,
1 для двух линий, проходящих через экран, открывая страницу,
2 для нескольких линий, проходящих через экран, открывая страницу,
3 для прямоугльника, открывающего страницу,
4 для одной линии, проходящей через экран, открывая страницу,
5 для растворения старой страницы, открывая новую,
6 для эффекта растворения, перемещяющегося от одного края экрана, к другому,
7 для простой смены старой страницы новой (по умолчанию).
PDF_set_duration
PDF_set_duration -- Устанавливает паузу между страницами
Описание
void pdf_set_duration
(int pdf document, double duration);
Функция
PDF_set_duration()
устанавливает паузу между следующими страницами в секундах.
Содержание
FLASH
