Главная » Как конвертировать HTML в PDF » Опции для генерации PDF

Опции для генерации PDF

Дополнительные параметры API для конвертации HTML в PDF

Основные опции

• MarginLeft
  <double>
  Отступ от левого края в мм, по умолчанию 0 (мм)
• MarginRight
  <double>
  Отступ от правого края, по умолчанию 0 (мм)
• MarginTop
  <double>
  Отступ от верхнего края, по умолчанию 0 (мм)
• MarginBottom
  <double>
  Отступ от нижнего края, по умолчанию 0 (мм)
• UseGrayscale
  <boolean>
  true - установить черно-белую палитру генерируемого PDF, по умолчанию - false (цветная)
• UseLandscape
  <boolean>
  true - задать ланшафтную ориентацию документа, по умолчанию - false (портретная)
• EnableForms
  <boolean>
  true - преобразовать поля форм HTML в поля форм PDF, по умолчнию - false
• LowQuality
  <boolean>
  true - понизить качество генерируемого PDF, например для экономии трафика, по умолчанию - false
• DisableShrinking
  <boolean>
  true - отключить автоматическое "умное" изменение размера элементов, по умолчанию - false
• DisableJavascript
  <boolean>
  true - отключить выполнение JavaScript на странице HTML, по умолчанию - false
• JavascriptDelay
  <integer>
  Отложить выполнение JavaScript на определенное количествое миллисекунд, по умолчанию - 200
• UsePrintStylesheet
  <boolean>
  true - использовать определенный на странице тип медиа (@media) CSS, по умолчанию - false
• HeaderSpacing
  <double>
  Расстояние между верхним колонтитулом (header) и основным содержанием, по умолчанию 0 (мм)
• FooterSpacing
  <double>
  Расстояние между нижним колонтитулом (footer) и основным содержанием, по умолчанию 0 (мм)
• PageSize
  <размер страницы>
  Размер страницы, например A0, A2, A3, A5, Letter и т.п. по умолчанию размер страницы - A4
• PageWidth
  <double>
  Ширина страницы. Если вы используете этот параметр, необходимо использовать PageHeight
• PageHeight
  <double>
  Высота страницы. Если вы используете этот параметр, необходимо использовать PageWidth
• ViewPort
  <viewport>
  По умолчанию размер экрана 1280x1024. Для мобильной версии используйте, например, 600x800.
• Dpi
  <ineger>
  Значение DPI, по умолчанию DPI 96 Также смотрите настройки Zoom
• Zoom
  <double>
  Масштаб, любое число с плавающей запятой, например: 0.5, 1.10, 3 ..., по умолчанию масштаб 1
• FileName
  <имя файла>
  Имя результирующего файла, например мой-файл.pdf, по умолчанию result.pdf
• Username
  <логин>
  Имя пользователя при HTTP авторизации на сервере, отдающего HTML страницу по URL
• Password
  <пароль>
  Пароль пользователя при HTTP авторизации на сервере, отдающего HTML страницу по URL
• Cookie
  <имя>|||<значение>
  Cookies, передаются в формате: NAME|||VALUE|||NAME|||VALUE...



Опции отображения верхних и нижних колонтитулов

• Включение в генерируемый документ верхних и нижние колонтитулов (блоки header and footer), включая автоматическую нумерацию страниц, может быть реализовано передачей в URL значений параметров HeaderUrl или FooterUrl, или в небольших фрагментах текстов, передаваемых при помощи параметров HeaderLeft, HeaderRight, FooterLeft или FooterRight. Обратите внимание на то, что если вы хотите использовать верхние и нижныие колонтитулы, необходимо также использовать параметры MarginTop или MarginBottom для обеспечения места под эти области.
• HeaderUrl
  <URL>
  Адрес страницы, начиная с http://, содержащий HTML для верхнего колонтитула каждой страницы
• FooterUrl
  <URL>
  Адрес страницы, начиная с http://, содержащий HTML для нижнего колонтитула каждой страницы
• HeaderLeft
  <текст>
  Текст верхнего колонтитула, выровненный по левому краю
• HeaderRight
  <текст>
  Текст верхнего колонтитула, выровненный по правому краю
• FooterLeft
  <текст>
  Текст нижнего колонтитула, выровненный по левому краю
• FooterRight
  <текст>
  Текст нижнего колонтитула, выровненный по правому краю
• HeaderFontName
  <имя шрифта>
  Имя шрифта текста верхнего колонтитула, по умолчанию Arial
• FooterFontName
  <имя шрифта>
  Имя шрифта нижнего верхнего колонтитула, по умолчанию Arial
• HeaderFontSize
  <размер шрифта>
  Размер шрифта верхнего колонтитула (используйте только число без pt и px), по умолчанию 12
• FooterFontSize
  <размер шрифта>
  Размер шрифта нижнего колонтитула (используйте только число без pt и px), по умолчанию 12



Теги для нумерации страниц

• Ниже представлены теги, для нумерации страниц. Например, можно использовать параметр FooterRight со значением Страница [page] из [topage]. В данном примере желательно добавить параметр MarginBottom со значением 20. Пример передачи параметров методом $_GET https://api.pdf4b.ru/pdf?apikey=ВАШ-КЛЮЧ&value=текст-HTML&MarginRight=20&MarginBottom=20&FooterRight=Page [page] of [toPage]. В результате в нижней части страницы будет выведен, текст "Страница X из Y" где Х - номер текущей страницы, а Y - номер последней.
• [page]
  Вместо данного тега автоматически подставляется номер текущей страницы
• [frompage]
  Вместо данного тега автоматически подставляется номер первой страницы
• [topage]
  Вместо данного тега автоматически подставляется номер последней страницы