열거형 레퍼런스
TCPDF-Next는 느슨한 타입의 문자열 및 정수 상수를 대체하기 위해 라이브러리 전체에서 PHP 8.1+ 지원 열거형을 사용합니다. 이 페이지는 모든 열거형, 케이스, 일반적인 사용법을 문서화합니다.
Orientation
네임스페이스: TcpdfNext\Contracts\Orientation
페이지 방향.
| 케이스 | 설명 |
|---|---|
Portrait | 세로가 가로보다 긴 형태 (기본값) |
Landscape | 가로가 세로보다 긴 형태 |
use TcpdfNext\Contracts\Orientation;
$pdf->addPage(orientation: Orientation::Landscape);Alignment
네임스페이스: TcpdfNext\Contracts\Alignment
수평 텍스트 및 콘텐츠 정렬.
| 케이스 | 설명 |
|---|---|
Left | 왼쪽 여백에 정렬 |
Center | 여백 사이 가운데 정렬 |
Right | 오른쪽 여백에 정렬 |
Justified | 텍스트를 전체 너비에 맞춰 늘림 |
use TcpdfNext\Contracts\Alignment;
$pdf->multiCell(width: 0, height: 10, text: $paragraph, align: Alignment::Justified);OutputDestination
네임스페이스: TcpdfNext\Contracts\OutputDestination
렌더링된 PDF를 전송할 위치.
| 케이스 | 설명 |
|---|---|
Inline | Content-Disposition: inline으로 브라우저에 전송 |
Download | Content-Disposition: attachment로 브라우저에 전송 |
File | 디스크의 파일에 쓰기 |
String | 원시 바이너리를 문자열로 반환 |
use TcpdfNext\Contracts\OutputDestination;
$binary = $pdf->output(OutputDestination::String);
$pdf->output(OutputDestination::File, path: '/reports/q4.pdf');SignatureLevel
네임스페이스: TcpdfNext\Contracts\SignatureLevel
ETSI EN 319 142에 따른 PAdES 디지털 서명 적합성 수준.
| 케이스 | 설명 |
|---|---|
PAdES_B_B | 서명 인증서를 포함한 기본 서명 |
PAdES_B_T | 신뢰할 수 있는 RFC 3161 타임스탬프 추가 |
PAdES_B_LT | 장기 검증을 위한 검증 데이터(DSS, OCSP, CRL) 추가 |
PAdES_B_LTA | 무기한 검증을 위한 아카이브 타임스탬프 추가 |
use TcpdfNext\Contracts\SignatureLevel;
$pdf->security()->sign(
certFile: '/certs/signer.p12',
password: 'secret',
level: SignatureLevel::PAdES_B_LTA,
);BlendMode
네임스페이스: TcpdfNext\Graphics\BlendMode
ISO 32000-2 섹션 11.3.5에 따른 PDF 투명도 블렌드 모드.
| 케이스 | 설명 |
|---|---|
Normal | 기본 합성 |
Multiply | 색상을 곱하여 어둡게 |
Screen | 반전, 곱셈, 다시 반전하여 밝게 |
Overlay | 기본 색상에 따라 Multiply와 Screen 결합 |
Darken | 기본과 블렌드 색상 중 더 어두운 색 선택 |
Lighten | 기본과 블렌드 색상 중 더 밝은 색 선택 |
ColorDodge | 블렌드 색상을 반영하여 기본 색상을 밝게 |
ColorBurn | 블렌드 색상을 반영하여 기본 색상을 어둡게 |
HardLight | 블렌드 색상에 따라 Multiply와 Screen 결합 |
SoftLight | 미묘한 어둡게 또는 밝게 |
Difference | 더 밝은 색에서 더 어두운 색을 빼기 |
Exclusion | Difference와 유사하나 대비가 낮음 |
use TcpdfNext\Graphics\BlendMode;
$pdf->setAlpha(0.5, blendMode: BlendMode::Multiply);BarcodeType
네임스페이스: TcpdfNext\Barcode\BarcodeType
지원되는 1D 바코드 심볼로지.
| 케이스 | 설명 |
|---|---|
CODE_39 | Code 39 (영숫자) |
CODE_39E | Code 39 Extended (전체 ASCII) |
CODE_93 | Code 93 |
CODE_128 | Code 128 (자동 모드 전환) |
CODE_128A | Code 128 서브셋 A |
CODE_128B | Code 128 서브셋 B |
CODE_128C | Code 128 서브셋 C (숫자 쌍) |
EAN_8 | EAN-8 |
EAN_13 | EAN-13 |
UPC_A | UPC-A |
UPC_E | UPC-E |
ITF_14 | ITF-14 (Interleaved 2 of 5) |
CODABAR | Codabar |
PHARMACODE | Pharmacode |
MSI | MSI Plessey |
POSTNET | POSTNET (미국 우편) |
Barcode2DType
네임스페이스: TcpdfNext\Barcode\Barcode2DType
지원되는 2D 바코드 심볼로지.
| 케이스 | 설명 |
|---|---|
QR_CODE | 구성 가능한 오류 수정(L/M/Q/H)을 갖춘 QR 코드 (ISO 18004) |
DATAMATRIX | Data Matrix ECC 200 (ISO 16022) |
PDF417 | PDF417 (ISO 15438) |
use TcpdfNext\Barcode\Barcode2DType;
$pdf->barcode2D('https://example.com', Barcode2DType::QR_CODE, w: 30, h: 30);FormFieldType
네임스페이스: TcpdfNext\Form\FormFieldType
AcroForm 필드 유형.
| 케이스 | 설명 |
|---|---|
TEXT | 단일 줄 텍스트 입력 |
PASSWORD | 비밀번호 텍스트 입력 (마스킹) |
TEXTAREA | 여러 줄 텍스트 입력 |
CHECKBOX | 체크박스 토글 |
RADIO | 라디오 버튼 (그룹의 일부) |
LISTBOX | 스크롤 가능한 목록 선택 |
COMBOBOX | 드롭다운 선택 |
BUTTON | 선택적 JavaScript 액션이 있는 푸시 버튼 |
PdfAVersion
네임스페이스: TcpdfNext\Archive\PdfAVersion
TCPDF-Next에서 지원하는 PDF/A 적합성 버전.
| 케이스 | 설명 |
|---|---|
A4 | PDF/A-4 (ISO 19005-4:2020) -- 기본 적합성 |
A4f | PDF/A-4f -- 임베디드 파일 허용 |
A4e | PDF/A-4e -- 3D 및 리치 미디어 콘텐츠 허용 |
use TcpdfNext\Archive\PdfAVersion;
$pdf->archive()->enablePdfA(PdfAVersion::A4f);FontType
네임스페이스: TcpdfNext\Typography\FontType
지원되는 폰트 포맷 유형.
| 케이스 | 설명 |
|---|---|
TrueType | TrueType 폰트 (.ttf) |
OpenType | OpenType 폰트 (.otf, CFF 또는 glyf 아웃라인) |
Type1 | PostScript Type 1 폰트 (.pfb/.pfm) |
Core | 14개 PDF 표준(Base 14) 폰트 중 하나 -- 임베딩 불필요 |
ColorSpace
네임스페이스: TcpdfNext\Graphics\ColorSpace
PDF 색상 공간 식별자.
| 케이스 | 설명 |
|---|---|
DeviceRGB | 빨강 / 초록 / 파랑 (화면) |
DeviceCMYK | 시안 / 마젠타 / 노랑 / 키 (인쇄) |
DeviceGray | 단일 채널 그레이스케일 |
Separation | 명명된 별색 채널 |
use TcpdfNext\Graphics\ColorSpace;
$color = Color::fromSpace(ColorSpace::DeviceCMYK, [100, 0, 0, 0]);ObjectEntryType
네임스페이스: TcpdfNext\Core\ObjectEntryType
ObjectRegistry에서 PDF 간접 객체의 종류를 분류합니다.
| 케이스 |
|---|
Catalog |
Pages |
Page |
Font |
FontDescriptor |
Image |
XObject |
ExtGState |
ColorSpace |
Pattern |
Shading |
Annotation |
Bookmark |
AcroField |
Signature |
Metadata |
OutputIntent |
StructElement |
Stream |
Generic |
AnnotationType
네임스페이스: TcpdfNext\Navigation\AnnotationType
ISO 32000-2 섹션 12.5.6에 따른 마크업 주석 유형.
| 케이스 | 설명 |
|---|---|
Text | 스티키 노트 아이콘 |
Highlight | 텍스트 하이라이트 마크업 |
Underline | 텍스트 밑줄 마크업 |
StrikeOut | 텍스트 취소선 마크업 |
Squiggly | 텍스트 물결 밑줄 마크업 |
FreeText | 인라인 텍스트 콜아웃 |
LineCapStyle
네임스페이스: TcpdfNext\Graphics\LineCapStyle
ISO 32000-2 섹션 8.4.3.3에 따른 선 끝 스타일.
| 케이스 | 값 | 설명 |
|---|---|---|
Butt | 0 | 끝점과 평행한 사각형 캡 |
Round | 1 | 끝점 너머로 확장되는 반원형 캡 |
Square | 2 | 끝점 너머로 확장되는 사각형 캡 |
LineJoinStyle
네임스페이스: TcpdfNext\Graphics\LineJoinStyle
ISO 32000-2 섹션 8.4.3.4에 따른 선 연결 스타일.
| 케이스 | 값 | 설명 |
|---|---|---|
Miter | 0 | 날카로운 모서리 |
Round | 1 | 둥근 모서리 |
Bevel | 2 | 대각선 평면 모서리 |
TextDirection
네임스페이스: TcpdfNext\Typography\TextDirection
양방향(BiDi) 렌더링을 위한 텍스트 방향.
| 케이스 | 설명 |
|---|---|
LeftToRight | 기본값 (LTR) |
RightToLeft | 오른쪽에서 왼쪽 (아랍어, 히브리어) |
Auto | 첫 번째 강한 문자에서 감지 |
HashAlgorithm
네임스페이스: TcpdfNext\Security\HashAlgorithm
서명 및 암호화에 사용되는 다이제스트 알고리즘.
| 케이스 | 설명 |
|---|---|
SHA256 | SHA-256 (기본값, 권장) |
SHA384 | SHA-384 |
SHA512 | SHA-512 |
PermissionFlag
네임스페이스: TcpdfNext\Security\PermissionFlag
setProtection()을 위한 문서 권한 플래그.
| 케이스 | 설명 |
|---|---|
Print | 인쇄 허용 |
PrintHighRes | 고해상도 인쇄 허용 |
Modify | 문서 수정 허용 |
Copy | 텍스트 및 이미지 추출 허용 |
AnnotForms | 주석 및 폼 입력 허용 |
FillForms | 폼 입력만 허용 |
Extract | 접근성 텍스트 추출 허용 |
Assemble | 페이지 삽입, 회전, 삭제 허용 |
ErrorCorrectionLevel
네임스페이스: TcpdfNext\Barcode\ErrorCorrectionLevel
ISO 18004에 따른 QR 코드 오류 수정 수준.
| 케이스 | 복구 용량 |
|---|---|
Low | ~7% |
Medium | ~15% |
Quartile | ~25% |
High | ~30% |
참고
- API 개요 -- 모든 패키지 한눈에 보기
- Document API -- 이 열거형을 파라미터로 받는 메서드
- 인터페이스 레퍼런스 -- 이 열거형을 참조하는 계약