Layout Visual Diagnostics

HotPDF có thể giữ các quyết định bố cục có giới hạn, phát hiện các phần tử đặt chồng lên nhau, vẽ overlay vector gốc, gắn vị trí nguồn do caller cung cấp, và xuất bản thông báo xem trước đồng bộ

Safe defaults

THPDFLayoutDiagnosticOptions.Default giữ các đường dẫn phần tử, trong khi chụp vị trí nguồn, phát hiện chồng lấn, overlay PDF, và callback trực tiếp bị vô hiệu hóa theo mặc định

Không có tên tệp nguồn hoặc nội dung overlay nào đi vào PDF được tạo trừ khi tùy chọn tương ứng được bật một cách tường minh

Enable visual diagnostics

Options := THPDFLayoutDiagnosticOptions.Default;
Options.CaptureSourceLocation := True;
Options.DetectOverlaps := True;
Options.DrawOverlays := True;
Options.LivePreview := True;
PDF.LayoutDiagnosticOptions := Options;
PDF.OnLayoutDiagnostic := HandleLayoutDiagnostic;

Element.SetDiagnosticSource('invoice_layout.pas', 73, 9);

SetDiagnosticSource lưu một tệp, dòng, và cột tùy chọn trên một THPDFLayoutElement; ClearDiagnosticSource loại bỏ ánh xạ

Các continuation bố cục khai báo sao chép ánh xạ để giữ một vị trí gọi ổn định qua các lần tách trang

Diagnostic records

THPDFLayoutDiagnostic bao gồm ElementPath, RelatedElementPath, SourceFile, SourceLine, và SourceColumn ngoài trang, hình chữ nhật, số dòng, loại, và lý do của nó

ldkOverlap nhận diện một giao điểm giữa hai phần tử được đặt thành công, trong khi ldkOverflow nhận diện một phần tử không thể vừa các giới hạn được cung cấp

Vector overlays and live preview

Hình chữ nhật tràn dùng nét đỏ và hình chữ nhật chồng lấn dùng nét cam, với các nhãn tùy chọn do ShowOverlayLabels điều khiển

Overlay là path và văn bản PDF gốc thay vì ảnh raster

THPDFLayoutDiagnosticEvent nhận từng chẩn đoán được giữ một cách đồng bộ sau khi vẽ overlay tùy chọn khi LivePreview được bật

Budgets and statistics

MaxTrackedBounds giới hạn các hình chữ nhật vị trí được giữ và MaxOverlapComparisons giới hạn công việc giao điểm trong khoảng chẩn đoán

THPDFLayoutDiagnosticStatistics báo cáo chẩn đoán được giữ và bị loại, giới hạn được theo dõi và bị loại, so sánh và phát hiện chồng lấn, overlay đã vẽ, và thông báo trực tiếp