Укажите параметры рендеринга при преобразовании в PDF

Формат PDF - это формат с фиксированной страницей, который очень популярен среди пользователей и широко поддерживается различными приложениями, поскольку документ PDF выглядит одинаково на любом устройстве. По этой причине преобразование в PDF является важной особенностью Aspose.Words.

PDF - сложный формат. В процессе преобразования документа в формат PDF требуется выполнить несколько этапов вычислений, включая расчет макета. Поскольку эти этапы включают сложные вычисления, они отнимают много времени. Кроме того, формат PDF сам по себе довольно сложен. Он имеет определенную файловую структуру, графическую модель и встроенные шрифты. Кроме того, он обладает некоторыми сложными функциями вывода, такими как теги структуры документа, шифрование, цифровые подписи и редактируемые формы.

Aspose.Words механизм верстки имитирует работу механизма верстки страниц в Microsoft Word. Таким образом, Aspose.Words позволяет сделать так, чтобы выходные документы PDF выглядели как можно ближе к тому, что вы можете увидеть в Microsoft Word. Иногда необходимо указать дополнительные параметры, которые могут повлиять на результат сохранения документа в формате PDF. Эти параметры можно задать с помощью класса PdfSaveOptions, содержащего свойства, которые определяют, как будут отображаться выходные данные PDF.

Ниже приведены некоторые примеры использования PdfSaveOptions.

В настоящее время вы также можете сохранять файлы в форматах PDF/A-1 и PDF/A-2. Обратите внимание, что при использовании формата PDF/A размер выходного файла больше, чем при использовании обычного формата PDF.

PdfCompliance.PDF_A1A и PdfCompliance.PDF_A1B помечены как устаревшие.

Для получения дополнительной информации о PDF/A смотрите следующую статью “Изучите особенности преобразования в PDF/A”.

Создание документа PDF с заполняемыми формами

Также можно экспортировать заполняемые формы из документа Microsoft Word в выходные данные PDF, которые содержат заполняемые формы вместо обычного текста. Используйте свойство preserve_form_fields, чтобы сохранить документ как PDF с заполняемыми формами.

Обратите внимание, что в отличие от Microsoft Word, формат PDF имеет ограниченное количество опций для редактируемых форм, таких как текстовое поле, combobox и checkbox. Microsoft Word содержит больше типов форм, например, средство выбора даты календаря. Как правило, невозможно полностью имитировать поведение Microsoft Word в PDF. Поэтому в некоторых сложных случаях выходные данные PDF могут отличаться от того, что вы видите в Microsoft Word.

В приведенном ниже примере кода показано, как сохранить документ как PDF с заполняемыми формами с заданным сжатием и качеством Jpeg:

Экспорт структуры документа и пользовательских свойств

Свойство export_document_structure позволяет экспортировать структуру документа в выходные данные PDF.

PDF средства логической структуры предоставляют механизм для включения информации, касающейся структуры содержимого документа, в файл PDF. Aspose.Words сохраняет информацию о структуре из документа Microsoft Word, такую как абзацы, списки, таблицы, сноски/концевые сноски и т.д.

В следующем примере показано, как сохранить документ в формате PDF, сохранив структуру документа:

Aspose.Words также позволяет экспортировать пользовательские свойства документа в PDF, что продемонстрировано в следующем примере:

Экспорт контуров из закладок и заголовков в выводе PDF

Если вы хотите экспортировать закладки в виде контуров в выходных данных PDF, вы можете использовать свойство default_bookmarks_outline_level. Это свойство определяет уровень по умолчанию в структуре документа, на котором отображаются закладки Microsoft Word. Если документ содержит закладки в верхнем/нижнем колонтитуле документа, вы можете задать свойству header_footer_bookmarks_export_mode значение HeaderFooterBookmarksExportMode.FIRST или HeaderFooterBookmarksExportMode.ALL, чтобы указать, как они экспортируются в выводе PDF. Закладки в верхних и нижних колонтитулах не экспортируются, если значение header_footer_bookmarks_export_mode равно HeaderFooterBookmarksExportMode.NONE.

В приведенном ниже примере кода показано, как экспортировать закладки из первого верхнего/нижнего колонтитула раздела:

Результат PDF этого примера показан ниже:

Если для параметра header_footer_bookmarks_export_mode задано значение HeaderFooterBookmarksExportMode.FIRST и документ содержит четные и нечетные верхние и нижние колонтитулы или другой верхний и нижний колонтитул первой страницы, закладки экспортируются для первых уникальных верхних и нижних колонтитулов в разделе.

Вы также можете экспортировать заголовки в выходных данных PDF, используя свойство headings_outline_levels. Это свойство определяет, сколько уровней заголовков включено в структуру документа.

В приведенном ниже примере кода показано, как экспортировать заголовки с тремя уровнями:

Результат PDF этого примера показан ниже:

Закладка или навигация по заголовкам могут по-разному отображаться в различных программах просмотра PDF. Более того, в некоторых приложениях закладки и навигация по заголовкам недоступны в UI.

Уменьшение размера изображений для уменьшения размера документа

Aspose.Words предоставляет возможность уменьшить размер изображений, чтобы уменьшить размер выходных данных PDF, используя свойство downsample_options. Уменьшение размера изображений включено по умолчанию в свойстве downsample_images.

Обратите внимание, что также можно задать конкретное разрешение в свойстве resolution или пороговое значение разрешения в свойстве resolution_threshold. Во втором случае, если разрешение изображения меньше порогового значения, понижающая дискретизация применяться не будет.

В приведенном ниже примере кода показано, как изменить разрешение изображений в выходном документе PDF:

Разрешение рассчитывается в соответствии с реальным размером изображения на странице.

Встраивание шрифтов в формат Adobe PDF

Aspose.Words также позволяет управлять способом встраивания шрифтов в результирующие документы PDF. Шрифты необходимо встраивать в любой документ Adobe PDF, чтобы документ можно было корректно отобразить на любом компьютере (более подробную информацию о рендеринге шрифтов смотрите в разделе Использование шрифтов TrueType). По умолчанию Aspose.Words вставляет подмножество шрифтов, используемых в документе, в созданный PDF. В этом случае в PDF сохраняются только глифы (символы), используемые в документе.

Когда следует использовать полные шрифты, а когда - подмножества

Существует способ указать параметр для Aspose.Words для встраивания полных шрифтов. Более подробная информация, а также некоторые преимущества и недостатки каждой настройки описаны в таблице ниже.

Режим встраивания шрифтов	Преимущества	Недостатки
Full	Полезно, если вы хотите отредактировать полученный результат PDF позже, добавив или изменив текст. Включены все шрифты, следовательно, присутствуют все глифы.	Поскольку некоторые шрифты имеют большой размер (несколько мегабайт), их встраивание без подстановки может привести к получению больших выходных файлов.
Subset	Поднабор полезен, если вы хотите уменьшить размер выходного файла.	Пользователь не может полностью добавить или отредактировать текст, используя выбранный шрифт в выходном документе PDF. Это связано с тем, что в нем присутствуют не все символы шрифта. Если несколько PDFs сохранены с поднаборами шрифтов и собраны вместе, то объединенный документ PDF может содержать шрифт, содержащий много ненужных поднаборов.

Встраивание полных шрифтов в PDF

Свойство embed_full_fonts позволяет указать, как Aspose.Words вставляет шрифты в выходной документ PDF.

• Чтобы вставить полные шрифты в выходной документ PDF, установите для параметра embed_full_fonts значение True
• Чтобы изменить шрифты при сохранении в PDF, установите для параметра embed_full_fonts значение False

В следующем примере показано, как полностью внедрить шрифты в выходной документ PDF:

В следующем примере показано, как установить значение Aspose.Words для подмножества шрифтов в выходных данных PDF:

Вы можете скачать файл шаблона для этих примеров по адресу Aspose.Words GitHub.

Как управлять внедрением основных шрифтов и Windows Стандартных шрифтов

Базовые шрифты и Windows Стандартные шрифты - это “стандартные” наборы шрифтов, которые обычно присутствуют на целевом компьютере или предоставляются средством чтения документов, поэтому их не нужно встраивать в выходные данные PDF. Отказавшись от внедрения этих шрифтов, вы можете уменьшить размер отображаемых документов PDF и при этом сохранить переносимость.

Aspose.Words предоставляет опции для выбора способа экспорта шрифтов в PDF. Вы можете либо встроить основные и стандартные шрифты в выходные данные PDF, либо пропустить их внедрение и вместо этого использовать стандартные шрифты core PDF или системные шрифты на целевом компьютере. Использование любого из этих параметров обычно приводит к значительному уменьшению размера файла для документов PDF, созданных с помощью Aspose.Words.

• Поскольку эти варианты являются взаимоисключающими, вам следует выбирать только один за раз.
• При сохранении с соблюдением PDF/A-1 все используемые шрифты должны быть встроены в документ PDF. При сохранении с соблюдением этого требования для свойства use_core_fonts должно быть установлено значение False, а для свойства font_embedding_mode - значение PdfFontEmbeddingMode.EMBED_ALL.

Встраивание основных шрифтов

Возможность встраивания основных шрифтов может быть включена или отключена с помощью свойства use_core_fonts. Если для него установлено значение true, следующие наиболее популярные шрифты “True Type” (базовые 14 шрифтов) не встраиваются в выходной документ PDF.:

• Arial
• Times New Roman
• Courier New
• Symbol

Эти шрифты заменяются соответствующими шрифтами core Type 1, которые предоставляются читателем при открытии PDF.

В приведенном ниже примере показано, как установить Aspose.Words, чтобы избежать встраивания основных шрифтов и позволить читателю заменить их шрифтами PDF Type 1:

Вы можете скачать файл шаблона для этого примера с сайта Aspose.Words GitHub.

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

Этот параметр работает только для текста в кодировке ANSI (Windows-1252). Для записи текста, отличного от ANSI, в кодировку PDF всегда требуется использовать соответствующие шрифты.

Встраивание системных шрифтов

Эту опцию можно включить или отключить с помощью font_embedding_mode. Если для этого свойства задано значение PdfFontEmbeddingMode.EMBED_NONSTANDARD, шрифты true type “Arial” и “Times New Roman” не будут встроены в документ PDF. В этом случае клиентская программа просмотра использует шрифты, установленные в операционной системе клиента. Если для свойства font_embedding_mode задано значение PdfFontEmbeddingMode.EMBED_NONE, Aspose.Words не вставляйте никакие шрифты.

В приведенном ниже примере показано, как установить значение Aspose.Words, чтобы не вставлять шрифты Arial и Times New Roman в документ PDF.:

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

Этот параметр работает только для текста в кодировке ANSI (Windows-1252). Для преобразования текста, отличного от ANSI, в PDF, требуется использовать соответствующий шрифт.