Запись THPDFLayoutDiagnosticOptions
Переключатели и бюджеты диагностики layout: фиксация путей элементов и координат в исходниках, обнаружение перекрытий, отрисовка overlay и подписей, уведомления live-предпросмотра и лимиты отслеживания
Объявление
THPDFLayoutDiagnosticOptions= record
CaptureElementPath: boolean;
CaptureSourceLocation: boolean;
DetectOverlaps: boolean;
DrawOverlays: boolean;
ShowOverlayLabels: boolean;
LivePreview: boolean;
MaxTrackedBounds: Integer;
MaxOverlapComparisons: Int64;
class function Default: THPDFLayoutDiagnosticOptions; static;
end;Модуль
HPDFDoc
Поля
| Поле | Назначение |
|---|---|
CaptureElementPath | Записывать строку ElementPath каждой диагностики; по умолчанию True |
CaptureSourceLocation | Записывать исходный файл, строку и столбец, привязанные к элементу; по умолчанию False |
DetectOverlaps | Отслеживать размещённые прямоугольники и попарно сравнивать их на перекрытия; по умолчанию False |
DrawOverlays | Рисовать диагностические прямоугольники на странице при отрисовке; по умолчанию False |
ShowOverlayLabels | Снабжать нарисованные overlay текстом причины; по умолчанию True |
LivePreview | Рассылать диагностические уведомления при интерактивном редактировании; по умолчанию False |
MaxTrackedBounds | Максимум прямоугольников, удерживаемых для отслеживания и проверок перекрытий; по умолчанию 4096 |
MaxOverlapComparisons | Максимум попарных сравнений прямоугольников за прогон до остановки обнаружения; по умолчанию 1000000 |
Default | Классовый метод, возвращающий перечисленные выше значения |
Примечания по использованию
- Начинайте с
THPDFLayoutDiagnosticOptions.Default, меняйте только нужные переключатели и присваивайте запись черезTHotPDF.SetLayoutDiagnosticOptionsили свойствоLayoutDiagnosticOptions - Включайте
DetectOverlapsтолько вокруг нужных вам прогонов layout: сравнения ограниченыMaxOverlapComparisons, но на больших документах всё равно стоят времени - Сочетайте
DrawOverlaysсShowOverlayLabelsдля визуальной отладки и читайтеTHPDFLayoutDiagnosticStatistics, чтобы увидеть, что отслежено, сравнено и нарисовано