Tham chiếu Enum
TCPDF-Next dùng PHP 8.1+ backed enum xuyên suốt thư viện để thay thế hằng chuỗi và số nguyên lỏng lẻo. Trang này mô tả mọi enum, case và cách dùng thông thường.
Orientation
Namespace: TcpdfNext\Contracts\Orientation
Hướng trang.
| Case | Mô tả |
|---|---|
Portrait | Cao hơn rộng (mặc định) |
Landscape | Rộng hơn cao |
use TcpdfNext\Contracts\Orientation;
$pdf->addPage(orientation: Orientation::Landscape);Alignment
Namespace: TcpdfNext\Contracts\Alignment
Căn chỉnh ngang text và nội dung.
| Case | Mô tả |
|---|---|
Left | Căn trái theo margin trái |
Center | Căn giữa giữa margin |
Right | Căn phải theo margin phải |
Justified | Kéo giãn text lấp đầy chiều rộng |
use TcpdfNext\Contracts\Alignment;
$pdf->multiCell(width: 0, height: 10, text: $paragraph, align: Alignment::Justified);OutputDestination
Namespace: TcpdfNext\Contracts\OutputDestination
Nơi gửi PDF đã render.
| Case | Mô tả |
|---|---|
Inline | Gửi đến trình duyệt với Content-Disposition: inline |
Download | Gửi đến trình duyệt với Content-Disposition: attachment |
File | Ghi ra file trên ổ đĩa |
String | Trả về nhị phân thô dạng chuỗi |
use TcpdfNext\Contracts\OutputDestination;
$binary = $pdf->output(OutputDestination::String);
$pdf->output(OutputDestination::File, path: '/reports/q4.pdf');SignatureLevel
Namespace: TcpdfNext\Contracts\SignatureLevel
Cấp tuân thủ chữ ký số PAdES theo ETSI EN 319 142.
| Case | Mô tả |
|---|---|
PAdES_B_B | Chữ ký cơ bản với chứng chỉ ký |
PAdES_B_T | Thêm RFC 3161 timestamp đáng tin cậy |
PAdES_B_LT | Thêm dữ liệu validation (DSS, OCSP, CRL) cho xác minh dài hạn |
PAdES_B_LTA | Thêm archive timestamp cho xác minh vô thời hạn |
use TcpdfNext\Contracts\SignatureLevel;
$pdf->security()->sign(
certFile: '/certs/signer.p12',
password: 'secret',
level: SignatureLevel::PAdES_B_LTA,
);BlendMode
Namespace: TcpdfNext\Graphics\BlendMode
Chế độ blend transparency PDF theo ISO 32000-2 Section 11.3.5.
| Case | Mô tả |
|---|---|
Normal | Compositing mặc định |
Multiply | Làm tối bằng nhân màu |
Screen | Làm sáng bằng đảo, nhân và đảo lại |
Overlay | Kết hợp Multiply và Screen dựa trên màu nền |
Darken | Chọn màu tối hơn giữa nền và blend |
Lighten | Chọn màu sáng hơn giữa nền và blend |
ColorDodge | Làm sáng màu nền để phản ánh màu blend |
ColorBurn | Làm tối màu nền để phản ánh màu blend |
HardLight | Kết hợp Multiply và Screen dựa trên màu blend |
SoftLight | Làm tối hoặc sáng tinh tế |
Difference | Trừ màu tối hơn từ màu sáng hơn |
Exclusion | Tương tự Difference với contrast thấp hơn |
use TcpdfNext\Graphics\BlendMode;
$pdf->setAlpha(0.5, blendMode: BlendMode::Multiply);BarcodeType
Namespace: TcpdfNext\Barcode\BarcodeType
Ký hiệu barcode 1D được hỗ trợ.
| Case | Mô tả |
|---|---|
CODE_39 | Code 39 (chữ số) |
CODE_39E | Code 39 Extended (ASCII đầy đủ) |
CODE_93 | Code 93 |
CODE_128 | Code 128 (tự chuyển mode) |
CODE_128A | Code 128 subset A |
CODE_128B | Code 128 subset B |
CODE_128C | Code 128 subset C (cặp số) |
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 (bưu điện Mỹ) |
Barcode2DType
Namespace: TcpdfNext\Barcode\Barcode2DType
Ký hiệu barcode 2D được hỗ trợ.
| Case | Mô tả |
|---|---|
QR_CODE | QR Code (ISO 18004) với error correction tùy chỉnh (L/M/Q/H) |
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
Namespace: TcpdfNext\Form\FormFieldType
Loại trường AcroForm.
| Case | Mô tả |
|---|---|
TEXT | Input text một dòng |
PASSWORD | Input text mật khẩu (che) |
TEXTAREA | Input text nhiều dòng |
CHECKBOX | Checkbox bật/tắt |
RADIO | Radio button (thuộc nhóm) |
LISTBOX | Danh sách cuộn chọn |
COMBOBOX | Dropdown chọn |
BUTTON | Nút bấm với JavaScript action tùy chọn |
PdfAVersion
Namespace: TcpdfNext\Archive\PdfAVersion
Phiên bản tuân thủ PDF/A được TCPDF-Next hỗ trợ.
| Case | Mô tả |
|---|---|
A4 | PDF/A-4 (ISO 19005-4:2020) — tuân thủ cơ bản |
A4f | PDF/A-4f — cho phép file nhúng |
A4e | PDF/A-4e — cho phép nội dung 3D và rich media |
use TcpdfNext\Archive\PdfAVersion;
$pdf->archive()->enablePdfA(PdfAVersion::A4f);FontType
Namespace: TcpdfNext\Typography\FontType
Loại định dạng font được hỗ trợ.
| Case | Mô tả |
|---|---|
TrueType | Font TrueType (.ttf) |
OpenType | Font OpenType (.otf, outline CFF hoặc glyf) |
Type1 | Font PostScript Type 1 (.pfb/.pfm) |
Core | Một trong 14 font PDF chuẩn (Base 14) — không cần nhúng |
ColorSpace
Namespace: TcpdfNext\Graphics\ColorSpace
Định danh không gian màu PDF.
| Case | Mô tả |
|---|---|
DeviceRGB | Red / Green / Blue (màn hình) |
DeviceCMYK | Cyan / Magenta / Yellow / Key (in) |
DeviceGray | Grayscale kênh đơn |
Separation | Kênh spot color có tên |
use TcpdfNext\Graphics\ColorSpace;
$color = Color::fromSpace(ColorSpace::DeviceCMYK, [100, 0, 0, 0]);ObjectEntryType
Namespace: TcpdfNext\Core\ObjectEntryType
Phân loại loại PDF indirect object trong ObjectRegistry.
| Case |
|---|
Catalog |
Pages |
Page |
Font |
FontDescriptor |
Image |
XObject |
ExtGState |
ColorSpace |
Pattern |
Shading |
Annotation |
Bookmark |
AcroField |
Signature |
Metadata |
OutputIntent |
StructElement |
Stream |
Generic |
AnnotationType
Namespace: TcpdfNext\Navigation\AnnotationType
Loại annotation đánh dấu theo ISO 32000-2 Section 12.5.6.
| Case | Mô tả |
|---|---|
Text | Icon sticky note |
Highlight | Đánh dấu highlight text |
Underline | Đánh dấu underline text |
StrikeOut | Đánh dấu strikethrough text |
Squiggly | Đánh dấu squiggly underline text |
FreeText | Callout text inline |
LineCapStyle
Namespace: TcpdfNext\Graphics\LineCapStyle
Style đầu đường theo ISO 32000-2 Section 8.4.3.3.
| Case | Giá trị | Mô tả |
|---|---|---|
Butt | 0 | Đầu vuông ngang điểm kết thúc |
Round | 1 | Đầu bán tròn vượt qua điểm kết thúc |
Square | 2 | Đầu vuông vượt qua điểm kết thúc |
LineJoinStyle
Namespace: TcpdfNext\Graphics\LineJoinStyle
Style nối đường theo ISO 32000-2 Section 8.4.3.4.
| Case | Giá trị | Mô tả |
|---|---|---|
Miter | 0 | Góc nhọn |
Round | 1 | Góc tròn |
Bevel | 2 | Góc phẳng chéo |
TextDirection
Namespace: TcpdfNext\Typography\TextDirection
Hướng text cho render bidirectional (BiDi).
| Case | Mô tả |
|---|---|
LeftToRight | Mặc định (LTR) |
RightToLeft | Phải sang trái (Arabic, Hebrew) |
Auto | Phát hiện từ ký tự strong đầu tiên |
HashAlgorithm
Namespace: TcpdfNext\Security\HashAlgorithm
Thuật toán digest dùng trong chữ ký và mã hóa.
| Case | Mô tả |
|---|---|
SHA256 | SHA-256 (mặc định, khuyên dùng) |
SHA384 | SHA-384 |
SHA512 | SHA-512 |
PermissionFlag
Namespace: TcpdfNext\Security\PermissionFlag
Cờ quyền document cho setProtection().
| Case | Mô tả |
|---|---|
Print | Cho phép in |
PrintHighRes | Cho phép in độ phân giải cao |
Modify | Cho phép sửa đổi document |
Copy | Cho phép trích xuất text và hình ảnh |
AnnotForms | Cho phép annotation và điền form |
FillForms | Chỉ cho phép điền form |
Extract | Cho phép trích xuất text trợ năng |
Assemble | Cho phép chèn, xoay, xóa trang |
ErrorCorrectionLevel
Namespace: TcpdfNext\Barcode\ErrorCorrectionLevel
Cấp error correction QR Code theo ISO 18004.
| Case | Khả năng phục hồi |
|---|---|
Low | ~7% |
Medium | ~15% |
Quartile | ~25% |
High | ~30% |
Xem thêm
- Tổng quan API -- Mọi package một cái nhìn
- Document API -- Method nhận các enum này làm tham số
- Tham chiếu Interface -- Contract tham chiếu các enum này