procedure AddText(const Text, Font: WString; FontSize: Single; X, Y: Double; Color: TColor = clBlack; Alpha: Byte = $FF; Angle: Double = 0.0);
| FontSize | Single. 포인트 단위 폰트 크기입니다(예: 12 pt 텍스트면 12.0) |
| Color | TColor. 텍스트 채우기 색입니다. 기본값은 clBlack |
| Alpha | Byte. 텍스트 불투명도입니다. $00이 완전 투명, $FF가 완전 불투명이며 기본값은 $FF |
| Angle | Double. 도 단위 회전 각도로, 양의 X축에서 반시계 방향으로 셉니다. 기본값은 0.0(수평) |
AddText는 지정한 폰트와 크기로 Unicode 텍스트 문자열을 현재 PDF 페이지에 렌더링합니다. 위치 (X, Y)는 첫 글자의 베이스라인 원점이며 페이지 왼쪽 아래 모서리에서 PDF 사용자 단위로 잽니다(원점은 왼쪽 아래, Y는 위로 증가)
폰트는 PostScript 이름이나 패밀리 이름(예: 'Arial', 'Times New Roman')으로 식별합니다. 폰트는 시스템에 있거나 문서에 임베드되어 있어야 하고, PDFium이 요청한 폰트를 찾지 못하면 기본 폰트로 대체합니다
텍스트 채우기 모양은 Color와 Alpha 파라미터로 조절합니다. Alpha를 $FF보다 작게 하면 반투명 텍스트가 됩니다. Angle 파라미터는 텍스트 문자열 전체를 베이스라인 원점 주위로 반시계 방향으로 회전시킵니다
이 메서드는 텍스트를 새 페이지 객체로 추가합니다. 이미 추가한 텍스트 객체의 내용을 바꾸려면 SetText를 사용하세요
시스템 폰트는 document당 한 번씩 코드 포인트를 키로 하는 CID 폰트로 임베드됩니다. 폰트가 커버하는 모든 Unicode 문자가 고유한 CID를 배정받고 명시적인 CIDToGIDMap과 일대일 ToUnicode 항목을 갖기 때문에, 같은 글리프를 공유하는 문자들(공백과 U+00A0, 하이픈과 U+00AD, Omega와 옴 기호)도 열기(open) 문서와 저장된 파일 양쪽에서 작성된 문자 그대로 추출됩니다. Unicode cmap 서브테이블이 없는 폰트는 기존의 글리프 키 방식 임베딩으로 폴백합니다
네이티브 Free Pascal/LCL 빌드는 Linux에서는 fontconfig, macOS에서는 CoreText로 시스템 글꼴 파일을 찾으며, 글꼴 파일 크기는 64 MiB로 제한됩니다. 요청한 패밀리가 없으면 플랫폼 대체 글꼴이 선택될 수 있습니다. 글꼴을 찾았다는 사실만으로 모든 Unicode 문자를 지원한다고 판단할 수는 없습니다
// Add a title string near the top of an A4 page
// A4 page height = 841.89 pt; place text 50 pt from the top
Pdf1.NewPage(595, 842);
Pdf1.AddText('Hello, PDFium Delphi Component!', 'Arial', 24, 72, 768);
// Red text at 45 degrees with 50% opacity
Pdf1.AddText('Rotated', 'Arial', 18, 200, 400, clRed, $80, 45);