X. Функции ClibPDF

Введение

Библиотека ClibPDF даёт возможность создавать PDF-документы с помощью PHP. Её можно загрузить с FastIO, но необходимо приобрести лицензию для коммерческого использования. Функциональность и API ClibPDF аналогичны PDFlib.

Этот документ необходимо читать вместе с учебником ClibPDF, поскольку там библиотека рассматривается более детально.

Многие функции в модулях ClibPDF и PHP, а также в PDFlib, называются одинаково. Все функции, за исключением cpdf_open(), принимают в качестве первого параметра дескриптор документа.

В настоящее время этот дескриптор не используется внутренне, поскольку ClibPDF не поддерживает одновременное создание нескольких PDF-документов. И даже не пытайтесь сделать это - результат будет непредсказуем. Невозможно предсказать, какие последствия этого могут быть во многопоточной среде. По соглашению с автором ClibPDF мы изменим это в одном из последующих релизов (на момент написания имелась версия 1.10). Если вам нужна эта функциональность, используйте модуль pdflib.

Прекрасной возможностью ClibPDF (и PDFlib) является способность создавать pdf-документ полностью в памяти без использования временных файлов. Имеется также возможность передавать координаты в предопределённых единицах измерения. (Эта возможность симулируется также функцией pdf_translate() при использовании PDFlib -функций.)

Другим важным свойством ClibPDF является то, что любая страница может быть модифицирована в любое время, даже если уже открыта новая страница. Функция cpdf_set_current_page() позволяет оставить текущую страницу и продолжить модификацию другой страницы.

Большинство функций использовать довольно легко. Возможно, самое сложное - это создание самого простого PDF-документа. Следующий пример должен помочь вам начать. Он создаёт документ из одной страницы. Эта страница содержит текст "Times-Roman", выведенный шрифтом в 30pt. Текст подчёркнут.

Предопределённые константы

Эти константы определены данным расширением и будут доступны только в том случае, если либо вкомпилированы в РНР, либо динамически загружены на этапе прогона.

CPDF_PM_NONE (integer)

CPDF_PM_OUTLINES (integer)

CPDF_PM_THUMBS (integer)

CPDF_PM_FULLSCREEN (integer)

CPDF_PL_SINGLE (integer)

CPDF_PL_1COLUMN (integer)

CPDF_PL_2LCOLUMN (integer)

CPDF_PL_2RCOLUMN (integer)

Примеры

<?php
$cpdf = cpdf_open(0);
cpdf_page_init($cpdf, 1, 0, 595, 842, 1.0);
cpdf_add_outline($cpdf, 0, 0, 0, 1, "Page 1");
cpdf_begin_text($cpdf);
cpdf_set_font($cpdf, "Times-Roman", 30, "WinAnsiEncoding");
cpdf_set_text_rendering($cpdf, 1);
cpdf_text($cpdf, "Times Roman outlined", 50, 750);
cpdf_end_text($cpdf);
cpdf_moveto($cpdf, 50, 740);
cpdf_lineto($cpdf, 330, 740);
cpdf_stroke($cpdf);
cpdf_finalize($cpdf);
Header("Content-type: application/pdf");
cpdf_output_buffer($cpdf);
cpdf_close($cpdf);
?>

Дистрибутив pdflib содержит   более сложный пример, в котором создаются серии страниц с аналоговыми часами. Здесь приведён пример, конвертированный в PHP с использованием расширения ClibPDF:

<?php
$radius = 200;
$margin = 20;
$pagecount = 40;

$pdf = cpdf_open(0);
cpdf_set_creator($pdf, "pdf_clock.php3");
cpdf_set_title($pdf, "Analog Clock");
  
while($pagecount-- > 0) {
  cpdf_page_init($pdf, $pagecount+1, 0, 2 * ($radius + $margin), 2 * ($radius + $margin), 1.0);
  
  cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0);  /* wipe */
  
  cpdf_translate($pdf, $radius + $margin, $radius + $margin);
  cpdf_save($pdf);
  cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0);
  
  /* отсчёт минут */
  cpdf_setlinewidth($pdf, 2.0);
  for ($alpha = 0; $alpha < 360; $alpha += 6)
    {
    cpdf_rotate($pdf, 6.0);
    cpdf_moveto($pdf, $radius, 0.0);
    cpdf_lineto($pdf, $radius-$margin/3, 0.0);
    cpdf_stroke($pdf);
    }
  
  cpdf_restore($pdf);
  cpdf_save($pdf);
 
  /* отсчёт пятиминуток */
  cpdf_setlinewidth($pdf, 3.0);
  for ($alpha = 0; $alpha < 360; $alpha += 30)
  {
    cpdf_rotate($pdf, 30.0);
    cpdf_moveto($pdf, $radius, 0.0);
    cpdf_lineto($pdf, $radius-$margin, 0.0);
    cpdf_stroke($pdf);
  }

  $ltime = getdate();

  /* прорисовка часовой стрелки */
  cpdf_save($pdf);
  cpdf_rotate($pdf, -(($ltime[’minutes’]/60.0) + $ltime[’hours’] - 3.0) * 30.0);
  cpdf_moveto($pdf, -$radius/10, -$radius/20);
  cpdf_lineto($pdf, $radius/2, 0.0);
  cpdf_lineto($pdf, -$radius/10, $radius/20);
  cpdf_closepath($pdf);
  cpdf_fill($pdf);
  cpdf_restore($pdf);

  /* прорисовка минутной стрелки */
  cpdf_save($pdf);
  cpdf_rotate($pdf, -(($ltime[’seconds’]/60.0) + $ltime[’minutes’] - 15.0) * 6.0);
  cpdf_moveto($pdf, -$radius/10, -$radius/20);
  cpdf_lineto($pdf, $radius * 0.8, 0.0);
  cpdf_lineto($pdf, -$radius/10, $radius/20);
  cpdf_closepath($pdf);
  cpdf_fill($pdf);
  cpdf_restore($pdf);

  /* прорисовка секундой стрелки */
  cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0);
  cpdf_setlinewidth($pdf, 2);
  cpdf_save($pdf);
  cpdf_rotate($pdf, -(($ltime[’seconds’] - 15.0) * 6.0));
  cpdf_moveto($pdf, -$radius/5, 0.0);
  cpdf_lineto($pdf, $radius, 0.0);
  cpdf_stroke($pdf);
  cpdf_restore($pdf);

  /* прорисовка небольшого кружка в центре */
  cpdf_circle($pdf, 0, 0, $radius/30);
  cpdf_fill($pdf);

  cpdf_restore($pdf);

  cpdf_finalize_page($pdf, $pagecount+1);
}

cpdf_finalize($pdf);
Header("Content-type: application/pdf");
cpdf_output_buffer($pdf);
cpdf_close($pdf);
?>

См. также

документацию расширения PDFlib.

Содержание

cpdf_add_annotation - добавляет аннотацию

cpdf_add_outline - добавляет закладку на текущей странице

cpdf_arc - прорисовывает дугу

cpdf_begin_text - начинает текстовый раздел

cpdf_circle - прорисовывает круг

cpdf_clip - обрезает текущий путь

cpdf_close - закрывает pdf-документ

cpdf_closepath_fill_stroke - закрывает, заполняет и выравнивает текущий путь/path

cpdf_closepath_stroke - закрывает путь и прорисовывает линию вдоль пути

cpdf_closepath - закрывает путь

cpdf_continue_text - выводит текст в следующей строчке

cpdf_curveto - прорисовывает кривую

cpdf_end_text - заканчивает текстовый раздел

cpdf_fill_stroke - заполняет и выравнивает текущий путь

cpdf_fill - заполняет текущий путь

cpdf_finalize_page - заканчивает страницу

cpdf_finalize - заканчивает документ

cpdf_global_set_document_limits - устанавливает границы для любого pdf-документа

cpdf_import_jpeg - открывает JPEG-изображение

cpdf_lineto - прорисовывает линию

cpdf_moveto - устанавливает текущую точку

cpdf_newpath - начинает новый путь

cpdf_open - открывает pdf-документ

cpdf_output_buffer - выводит pdf-документ в буфере памяти

cpdf_page_init - начинает новую страницу

cpdf_place_inline_image - помещает изображение на страницу

cpdf_rect - прорисовывает прямоугольник

cpdf_restore - восстанавливает ранее сохранённое окружение

cpdf_rlineto - прорисовывает линию

cpdf_rmoveto - устанавливает текущую точку

cpdf_rotate_text - устанавливает угол поворота текста

cpdf_rotate - устанавливает поворот

cpdf_save_to_file - записывает pdf-документ в файл

cpdf_save - сохраняет текущее окружение

cpdf_scale - устанавливает масштабирование

cpdf_set_action_url - устанавливает гиперссылку

cpdf_set_char_spacing - устанавливает расстояние между символами/character spacing

cpdf_set_creator - устанавливает поле автора/creator в pdf-документе

cpdf_set_current_page - устанавливает текущую страницу

cpdf_set_font_directories - устанавливает директории для поиска при использовании внешних шрифтов

cpdf_set_font_map_file - устанавливает fontname в filename карты отображения при использовании внешних шрифтов

cpdf_set_font - выбирает текущий шрифт и его размер

cpdf_set_horiz_scaling - устанавливает масштабирование текста по горизонтали

cpdf_set_keywords - устанавливает поле keywords в pdf-документе

cpdf_set_leading - устанавливает расстояние между строчками текста

cpdf_set_page_animation - устанавливает интервал между страницами

cpdf_set_subject - устанавливает поле subject в pdf-документе

cpdf_set_text_matrix - устанавливает текстовую матрицу

cpdf_set_text_pos - устанавливает позицию текста

cpdf_set_text_rendering - определяет отображение текста

cpdf_set_text_rise - устанавливает возвышение текста

cpdf_set_title - устанавливает поле title в pdf-документе

cpdf_set_viewer_preferences - как показывать документ в просмотрщике/viewer

cpdf_set_word_spacing - устанавливает расстояние между словами

cpdf_setdash - устанавливает патэрн из тире

cpdf_setflat - устанавливает ровность

cpdf_setgray_fill - устанавливает цвет заполнения - значение gray

cpdf_setgray_stroke — устанавливает цвет прорисовки - значение gray

cpdf_setgray — устанавливает цвет прорисовки и заполнения - значение gray

cpdf_setlinecap - устанавливает параметр linecap

cpdf_setlinejoin - устанавливает параметр linejoin

cpdf_setlinewidth - устанавливает ширину линии

cpdf_setmiterlimit - устанавливает miter-границу

cpdf_setrgbcolor_fill - устанавливает цвет заполнения - значение rgb

cpdf_setrgbcolor_stroke — устанавливает цвет прорисовки - значение rgb

cpdf_setrgbcolor — устанавливает цвет прорисовки и заполнения - значение rgb

cpdf_show_xy - выводит текст в данной позиции

cpdf_show - выводит текст в текущей позиции

cpdf_stringwidth - Возвращает ширину текста при текущем шрифте

cpdf_stroke - прорисовывает линию вдоль пути

cpdf_text - выводит текст с параметрами

cpdf_translate - устанавливает исходную току системы координат