API 레퍼런스
TCPDF-Next 에코시스템의 모든 패키지에 대한 완전한 API 레퍼런스입니다. 각 패키지는 주요 클래스 및 인터페이스와 함께 아래에 나열되어 있습니다. 메서드 시그니처, 파라미터, 사용 예제는 전용 페이지를 클릭하여 확인하세요.
Core
패키지: tcpdf-next/core
| 클래스 | 설명 |
|---|---|
Document | 중앙 진입점 -- 12개의 trait에 위임하는 플루언트 파사드 |
ObjectRegistry | 모든 PDF 간접 객체를 추적하고 고유 객체 번호를 할당 |
TransactionManager | 복잡한 레이아웃 작업을 위한 세이브포인트 / 롤백 시맨틱 |
CrossReferenceStream | PDF 2.0 바이너리 교차 참조 스트림 구성 |
Contracts
패키지: tcpdf-next/contracts
| 인터페이스 / Enum | 종류 | 설명 |
|---|---|---|
PdfDocumentInterface | 인터페이스 | 모든 PDF 문서 구현을 위한 기본 API 계약 |
FontManagerInterface | 인터페이스 | 폰트 로딩, 등록, 서브셋팅 계약 |
SignerInterface | 인터페이스 | 디지털 서명 제공자 추상화 |
HsmSignerInterface | 인터페이스 | 하드웨어 보안 모듈을 위한 확장 서명자 |
Orientation | Enum | 페이지 방향 (세로, 가로) |
Alignment | Enum | 텍스트 정렬 (왼쪽, 가운데, 오른쪽, 양쪽 맞춤) |
OutputDestination | Enum | 출력 대상 (인라인, 다운로드, 파일, 문자열) |
SignatureLevel | Enum | PAdES 적합성 수준 (B-B부터 B-LTA) |
값 객체
패키지: tcpdf-next/value-objects
| 클래스 | 설명 |
|---|---|
PageSize | 이름 또는 커스텀 페이지 크기, 프리셋 팩토리 (A0 -- A6, Letter, Legal, Tabloid) |
Margin | 4면 페이지 여백 (상, 우, 하, 좌) |
Position | 불변 x--y 좌표 |
Dimension | 불변 너비--높이 쌍 |
Unit | 단위 변환 헬퍼 (mm, pt, cm, in) |
Graphics
패키지: tcpdf-next/graphics
| 클래스 | 설명 |
|---|---|
Color | 불변 색상 표현 (RGB, CMYK, Gray, Spot) |
ColorSpace | DeviceRGB, DeviceCMYK, DeviceGray, Separation용 Enum |
BlendMode | 투명도 블렌드 모드 enum (Normal, Multiply, Screen, Overlay, ...) |
LayerManager | 선택적 콘텐츠 그룹(OCG) 관리 |
GradientManager | 선형 및 방사형 그래디언트 생성 |
Typography
패키지: tcpdf-next/typography
| 클래스 | 설명 |
|---|---|
FontManager | 폰트 로딩 및 관리를 위한 중앙 레지스트리 |
FontSubsetter | 사용된 글리프만 포함하는 최소 폰트 서브셋 생성 |
FontInfo | 글리프 메트릭, 어센더, 디센더를 노출하는 읽기 전용 데이터 객체 |
BiDiResolver | 유니코드 양방향 알고리즘(UAX #9) 구현 |
Content
패키지: tcpdf-next/content
| 클래스 | 설명 |
|---|---|
TextRenderer | 그림자 및 효과가 있는 고수준 텍스트 렌더링 |
JavaScriptManager | 문서 수준 JavaScript 액션 임베딩 |
Layout
패키지: tcpdf-next/layout
| 클래스 | 설명 |
|---|---|
PageManager | 페이지 추적, 페이지 나누기 처리, 현재 페이지 상태 관리 |
HeaderFooterManager | 반복되는 머리글/바닥글 콘텐츠 관리 |
ColumnManager | 멀티 컬럼 콘텐츠 플로우 |
BookletManager | 중철 제본 소책자 인쇄를 위한 페이지 배치 |
Html
패키지: tcpdf-next/html
| 클래스 | 설명 |
|---|---|
HtmlParser | 렌더링을 위해 HTML 마크업을 DOM 트리로 파싱 |
CssRule | 특이도를 가진 단일 해석된 CSS 규칙 표현 |
TableParser | HTML 테이블 레이아웃을 위한 전문 파서 |
Form
패키지: tcpdf-next/form
| 클래스 | 설명 |
|---|---|
FormFieldManager | AcroForm 필드 생성 및 관리 |
FormFieldType | 필드 유형 Enum (Text, Password, Textarea, Checkbox, Radio, Listbox, Combobox, Button) |
Navigation
패키지: tcpdf-next/navigation
| 클래스 | 설명 |
|---|---|
BookmarkManager | 문서 아웃라인 항목 생성 및 중첩 |
AnnotationManager | 마크업 주석 추가 (강조, 메모, 밑줄) |
FileAttachment | 문서에 파일 첨부 임베딩 |
TocManager | 자동 목차 생성 |
Barcode
패키지: tcpdf-next/barcode
| 클래스 | 설명 |
|---|---|
BarcodeGenerator | 모든 바코드 유형을 위한 통합 팩토리 |
BarcodeType | 1D 바코드 Enum (CODE_39, CODE_128, EAN_13, ...) |
Barcode2DType | 2D 바코드 Enum (QR_CODE, DATAMATRIX, PDF417) |
Security
패키지: tcpdf-next/security
| 클래스 | 설명 |
|---|---|
Aes256Encryptor | AESV3 핸들러를 사용한 AES-256 암호화 |
DigitalSigner | PAdES 디지털 서명 생성 |
TsaClient | RFC 3161 타임스탬프 기관 클라이언트 |
LtvManager | DSS, OCSP 스테이플링, CRL 임베딩을 통한 장기 검증 |
DssBuilder | 문서 보안 저장소 딕셔너리 구성 |
Archive
패키지: tcpdf-next/archive
| 클래스 | 설명 |
|---|---|
PdfAManager | PDF/A-4 적합성 적용 및 검증 |
XmpMetadata | XMP 메타데이터 패킷 생성 (ISO 16684) |
OutputIntent | ICC 출력 인텐트 프로파일 관리 |
Accessibility
패키지: tcpdf-next/accessibility
| 클래스 | 설명 |
|---|---|
StructureTreeManager | 태그 PDF 구조 트리 관리 |
RoleMap | 커스텀 태그를 표준 PDF 구조 유형에 매핑 |
Writer
패키지: tcpdf-next/writer
| 클래스 | 설명 |
|---|---|
PdfWriter | 객체 레지스트리에서 바이너리 PDF 출력을 조율 |
Linearizer | 선형화된(웹 최적화) PDF 출력 생성 |
Laravel
패키지: tcpdf-next/laravel
| 클래스 | 설명 |
|---|---|
TcpdfServiceProvider | 바인딩 등록 및 설정 퍼블리시 |
Pdf (Facade) | Document::create()를 위한 정적 파사드 |
PdfResponse | PDF를 Laravel HTTP 응답으로 반환 |
GeneratePdfJob | 백그라운드 PDF 생성을 위한 큐 가능한 잡 |
Artisan
패키지: tcpdf-next/artisan
| 클래스 | 설명 |
|---|---|
HtmlRenderer | CLI를 통해 Blade / HTML 템플릿을 PDF로 렌더링 |
ChromeBridge | 픽셀 퍼펙트 렌더링을 위한 헤드리스 Chrome 통합 |
RenderOptions | Artisan 렌더 명령을 위한 구성 DTO |
더 읽을거리
- Document API --
Document클래스의 모든 퍼블릭 메서드 - 열거형 레퍼런스 -- 값과 사용법을 포함한 모든 22개 열거형
- 인터페이스 레퍼런스 -- DI 및 테스트를 위한 계약 인터페이스
- 값 객체 API -- 팩토리 메서드, 속성, 변환