THPDFLayoutDiagnosticOptions Record

레이아웃 diagnostics의 스위치와 예산입니다. element path·소스 위치 캡처, overlap 탐지, overlay 그리기와 레이블, 라이브 프리뷰 알림, 추적 한도를 다룹니다

선언

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`	각 diagnostic의 `ElementPath` 문자열을 기록. 기본값 `True`
`CaptureSourceLocation`	요소에 붙은 소스 파일·줄·컬럼을 기록. 기본값 `False`
`DetectOverlaps`	배치된 사각형을 추적해 overlap 여부를 쌍별로 비교. 기본값 `False`
`DrawOverlays`	렌더링 중 페이지 위에 diagnostic 사각형을 그립니다. 기본값 `False`
`ShowOverlayLabels`	그려진 overlay에 사유 텍스트를 덧붙입니다. 기본값 `True`
`LivePreview`	대화형 편집 중 diagnostic 알림을 내보냅니다. 기본값 `False`
`MaxTrackedBounds`	추적과 overlap 검사를 위해 유지하는 최대 사각형 수. 기본값 `4096`
`MaxOverlapComparisons`	탐지가 멈추기 전까지 실행별로 허용되는 최대 쌍별 사각형 비교 수. 기본값 `1000000`
`Default`	위에 나열한 값을 돌려주는 클래스 함수

사용 참고 사항

THPDFLayoutDiagnosticOptions.Default에서 시작해 필요한 스위치만 바꾸고, THotPDF.SetLayoutDiagnosticOptions나 LayoutDiagnosticOptions 속성으로 할당합니다
DetectOverlaps는 필요한 레이아웃 실행 구간에만 켭니다. 비교는 MaxOverlapComparisons로 제한되지만 큰 문서에서는 여전히 시간이 듭니다
시각 디버깅에는 DrawOverlays와 ShowOverlayLabels를 짝지어 쓰고, 무엇을 추적·비교·그렸는지는 THPDFLayoutDiagnosticStatistics에서 확인합니다

THPDFLayoutDiagnosticOptions Record

선언

유닛

필드

사용 참고 사항

관련 API