TrimPageContentToCropBox

Редактирование потоков содержимого

Описание

Переписывает каждый слой содержимого на запрошенной странице и удаляет целые верхнеуровневые текстовые прогоны, нарисованные контуры, размещения изображений и вызовы Form XObject, чьи консервативно рассчитанные трансформированные границы полностью лежат вне действующего CropBox. Если у страницы нет явного CropBox, используется унаследованный MediaBox

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

Синтаксис

Delphi

Function TPDFlib.TrimPageContentToCropBox(Page: Integer; Margin: Double= 0): Integer;

ActiveX

Function PDFlib::TrimPageContentToCropBox(Page As Long, Margin As Double) As Long

DLL

int DLTrimPageContentToCropBox(int InstanceID, int Page, double Margin);

Параметры

PageНомер перезаписываемой страницы, нумерация с 1
MarginОтступ в текущих единицах измерения; положительные значения сжимают удерживаемый блок, отрицательные расширяют

Возвращаемые значения

Ноль и болееЧисло удаленных полных объектов рисования. Ноль также означает, что подходящий объект не найден либо страница или поле недопустимы

Пример

Removed := PDF.TrimPageContentToCropBox(1, 0);
PDF.SaveToFile('trimmed.pdf');