FlattenTransparency
Управление документом, рендеринг, совместимость PDF
Описание
Заменяет каждую выбранную страницу одним непрозрачным растровым изображением, сохраняя вид после растеризации и убирая прозрачность из достижимого содержимого страницы
Синтаксис
Delphi
Function TPDFlib.FlattenTransparency(Const PageRange: WideString; DPI: Double; BackgroundColor: Cardinal; Options: Integer): Integer;Параметры
| PageRange | Выражение диапазона страниц или пустая строка для всех страниц |
|---|---|
| DPI | Растровое разрешение от 36 до 1200 точек на дюйм |
| BackgroundColor | Непрозрачный растровый фон как значение COLORREF |
| Options | Побитовая комбинация PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS и PDF_FLATTEN_TRANSPARENCY_GARBAGE_COLLECT либо PDF_FLATTEN_TRANSPARENCY_DEFAULT |
Возвращаемые значения
Возвращает число заменённых страниц либо 0, если валидация или растеризация не удались до замены хоть одной
Примечания
Вариант по умолчанию рисует аннотации и поля формы в заменяющее изображение, удаляет их интерактивные объекты и собирает недостижимые объекты, чтобы потом можно было выбрать совместимую более старую версию PDF
PDF_FLATTEN_TRANSPARENCY_KEEP_ANNOTATIONS preserves annotation and form objects and excludes them from the raster pass so they are not drawn twice
Rotated pages are written with their visual dimensions and a zero rotation,
UserUnit is folded into the media-box dimensions, and inherited auxiliary page boxes are removed
Processing is page-streamed to bound peak raster memory, supports progress and cancellation, and may return a partial page count after a later-page failure or cancellation
Сборка мусора делает недействительными ID недостижимых изображений, захватов, графических состояний и других удалённых ресурсов — при включённой опции сборки мусора получайте новые ID после этого вызова
Сборка мусора делает недействительными идентификаторы недостижимых изображений, захватов, графических состояний и других удаленных ресурсов, поэтому получите новые идентификаторы после этого вызова, если используется опция сборки мусора
См. также
RenderPageTileToStream, SetInformation, FlattenAnnotsOnPageRange