losLab PDF Library は、Delphi/C++Builder チーム向けにソース提供の PDF エンジンを提供します。デスクトップ、サーバー、DLL、ActiveX、Dylib ワークフローで使え、PDF/A・PDF/UA チェック、PAdES 署名、複数レンダラーを外部 PDF サービスなしで利用できます。
この記事は teams building print-preview, hard-copy approval, label, or controlled-output workflows in Delphi 向けです。print preview and device-context output を単なるコンポーネント呼び出しではなく、本番向けのドキュメントエンジニアリングとして扱います。
実務上のリスクは print output can differ from preview when device margins, scaling, rotation, duplex settings, and driver behavior are not modeled explicitly です。そのため、明確な契約、観測可能な診断、実際の顧客ファイルに近い回帰サンプルが必要です。
アーキテクチャ上の判断
Separate PDF page geometry from printer geometry. fit, actual size, shrink-only, center, rotation, and crop rules / paper selection, printable margins, tray, duplex, and color mode policy
- fit, actual size, shrink-only, center, rotation, and crop rules
- paper selection, printable margins, tray, duplex, and color mode policy
- preview fidelity requirements compared with printer-driver output
- whether annotations, form fields, watermarks, and backgrounds are printed
実装フロー
Preview with the same print contract used for output. The order below keeps the workflow reviewable for Delphi and C++Builder teams.
- read page size and rotation before asking the printer for device capabilities
- compute the target rectangle from paper, printable area, and scaling policy
- render preview using the same geometry contract as the print job
- record driver and device context details when output is generated
- test high-value documents on the printer families customers actually use
検証エビデンス
Print evidence that helps support reproduce issues. Keep these fields with the output or support record.
- printer name, driver version, paper size, printable area, scaling, and rotation
- PDF page box, page number, rendered rectangle, and DPI
- annotation and form-field print policy
- operator selection and print result or driver error
A device context is a target, not a neutral canvas
A production print workflow should know the PDF page box, target paper size, printable area, scaling rule, rotation decision, and driver settings before rendering to a device context.
Operational metrics to watch
The first release should expose enough metrics to prove the workflow is healthy under real files, not only under curated samples.
- count and rate for printer name, driver version, paper size, printable area, scaling, and rotation
- warning trend for printer drivers can change printable margins after paper selection
- latency of the stage that must read page size and rotation before asking the printer for device capabilities
- profile usage for fit, actual size, shrink-only, center, rotation, and crop rules
Engineering review notes for print preview and device-context output
Use these review notes to make sure the feature has moved beyond a demo and can be defended during release, support, and customer escalation.
- Decision: fit, actual size, shrink-only, center, rotation, and crop rules. Implementation pressure point: compute the target rectangle from paper, printable area, and scaling policy. Acceptance evidence: annotation and form-field print policy. Regression trigger: preview should disclose when it cannot match a driver-specific feature
- Decision: paper selection, printable margins, tray, duplex, and color mode policy. Implementation pressure point: render preview using the same geometry contract as the print job. Acceptance evidence: operator selection and print result or driver error. Regression trigger: printer drivers can change printable margins after paper selection
- Decision: preview fidelity requirements compared with printer-driver output. Implementation pressure point: record driver and device context details when output is generated. Acceptance evidence: printer name, driver version, paper size, printable area, scaling, and rotation. Regression trigger: landscape pages need a clear auto-rotation policy
- Decision: whether annotations, form fields, watermarks, and backgrounds are printed. Implementation pressure point: test high-value documents on the printer families customers actually use. Acceptance evidence: PDF page box, page number, rendered rectangle, and DPI. Regression trigger: duplex output can expose odd-page and blank-page assumptions
- Decision: fit, actual size, shrink-only, center, rotation, and crop rules. Implementation pressure point: read page size and rotation before asking the printer for device capabilities. Acceptance evidence: annotation and form-field print policy. Regression trigger: preview should disclose when it cannot match a driver-specific feature
境界ケース
- printer drivers can change printable margins after paper selection
- landscape pages need a clear auto-rotation policy
- duplex output can expose odd-page and blank-page assumptions
- preview should disclose when it cannot match a driver-specific feature
Delphi / C++Builder notes
PDFlibPas should sit behind a small service boundary that receives files, streams, profiles, and credentials, then returns output paths, warnings, metrics, and validation status. Important terms include device context, print preview, DPI, printable area, scaling, duplex.
Delphi コード例
次の Delphi スケッチは、このテーマに対する実用的なサービス境界を示します。ポリシー確認、ログ記録、検証を製品呼び出しの狭い部分の外側に置くと、ワークフローをテストしやすくなります。
procedure PaintPreviewPage(Canvas: TCanvas; const FileName: string; PageRef: Integer; Dpi: Double);
var
Pdf: TPDFlib;
FileHandle: Integer;
begin
Pdf := TPDFlib.Create;
try
FileHandle := Pdf.DAOpenFileReadOnly(FileName, '');
try
Pdf.DARenderPageToDC(FileHandle, PageRef, Dpi, Canvas.Handle);
DrawPreviewOverlay(Canvas, PageRef, Dpi);
finally
Pdf.DACloseFile(FileHandle);
end;
finally
Pdf.Free;
end;
end;本番チェックリスト
- Run the workflow on an empty file, a normal customer file, and a worst-case file
- Open the generated PDF with the target viewer, validator, printer, or downstream application
- Log product version, profile version, input hash, output path, elapsed time, and warning count
- Keep passwords, certificates, temporary files, and customer data under explicit retention rules
- Add regression documents when a customer file exposes a new edge case