Tabel Pemetaan API
Halaman ini menyediakan pemetaan komprehensif dari setiap method TCPDF yang umum digunakan ke padanan TCPDF-Next-nya. Gunakan ini sebagai referensi saat melakukan migrasi kode yang ada.
Pengaturan Dokumen
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
new TCPDF($orientation, $unit, $format) | PdfDocument::create()->setOrientation(...)->setPageFormat(...)->build() | Named param, fluent builder |
SetCreator($creator) | ->setCreator($creator) | |
SetAuthor($author) | ->setAuthor($author) | |
SetTitle($title) | ->setTitle($title) | |
SetSubject($subject) | ->setSubject($subject) | |
SetKeywords($keywords) | ->setKeywords([...]) | Array alih-alih string dipisahkan koma |
SetMargins($left, $top, $right) | ->setMargins(new Margins($left, $right, $top, $bottom)) | Value object |
SetCellMargins($l, $t, $r, $b) | TextBlock::create()->setPadding(...) | Padding per-elemen |
SetAutoPageBreak($auto, $margin) | ->setAutoPageBreak($auto, bottomMargin: $margin) | Named parameter |
setLanguageArray($lang) | ->setLocale($locale) | String locale standar |
setFontSubsetting($enable) | ->getFontManager()->setSubsetting($enable) | |
SetDefaultMonospacedFont($font) | $renderer->setDefaultMonoFont($font) | |
SetDisplayMode($zoom, $layout) | ->setViewerPreferences(zoom: $zoom, layout: $layout) | |
setImageScale($scale) | Tidak diperlukan | Sizing berbasis DPI |
SetHeaderMargin($margin) | ->setMargins(new Margins(..., header: $margin)) | |
SetFooterMargin($margin) | ->setMargins(new Margins(..., footer: $margin)) | |
setPrintHeader($enable) | Hilangkan callback onPageHeader() | |
setPrintFooter($enable) | Hilangkan callback onPageFooter() |
Manajemen Halaman
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
AddPage($orientation, $format) | $pdf->addPage($format, $orientation) | |
endPage() | Otomatis | Implisit saat addPage() berikutnya |
getPage() | $pdf->getCurrentPageNumber() | |
setPage($page) | $pdf->getPage($pageNumber) | |
getNumPages() | $pdf->getPageCount() | |
deletePage($page) | $pdf->removePage($pageNumber) | |
movePage($from, $to) | $pdf->movePage($from, $to) | |
copyPage($page) | $pdf->duplicatePage($pageNumber) | |
lastPage() | $pdf->getPage($pdf->getPageCount()) | |
getPageWidth() | $page->getWidth() | |
getPageHeight() | $page->getHeight() | |
SetXY($x, $y) | ->setPosition($x, $y) | Posisi per-elemen |
GetX() / GetY() | $page->getCursorX() / $page->getCursorY() | |
SetX($x) / SetY($y) | $page->setCursor($x, $y) | |
getBreakMargin() | $page->getBottomMargin() |
Operasi Font
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
SetFont($family, $style, $size) | $page->setFont($family, size: $size, style: FontStyle::BOLD) | Enum untuk style |
SetFontSize($size) | $page->setFont(..., size: $size) | |
addTTFfont($fontfile) | $pdf->getFontManager()->registerFont($path, $name) | TTF/OTF standar |
getFontFamilyName() | $page->getCurrentFont()->getFamily() | |
getFontSize() | $page->getCurrentFont()->getSize() | |
getFontSizePt() | $page->getCurrentFont()->getSizeInPoints() | |
isCharDefined($char) | $font->hasGlyph($char) | |
GetStringWidth($string) | $font->measureText($string, $size)->getWidth() | |
GetCharWidth($char) | $font->getGlyphWidth($char, $size) | |
getNumLines($text, $width) | $font->calculateLines($text, $width, $size) |
Output Teks
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
Cell($w, $h, $txt, $border, $ln, $align) | $page->addText($txt)->setSize($w, $h)->setAlignment(...) | Fluent API |
MultiCell($w, $h, $txt, $border, $align) | $page->addParagraph($txt)->setWidth($w)->setAlignment(...) | |
Write($h, $txt, $link) | $page->addText($txt)->setLineHeight($h)->setLink($link) | |
writeHTML($html) | $renderer->writeHtml($html) | Parser berbasis DOM |
writeHTMLCell($w, $h, $x, $y, $html) | $renderer->writeHtml($html, position: [$x, $y], width: $w) | |
Text($x, $y, $txt) | $page->addText($txt)->setPosition($x, $y) | |
Ln($h) | $page->advanceCursor($h) | |
SetTextColor($r, $g, $b) | ->setColor(Color::rgb($r, $g, $b)) | Value object |
SetTextColorArray($color) | ->setColor(Color::fromArray($color)) |
Gambar
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
Image($file, $x, $y, $w, $h, $type) | $page->addImage($file)->setPosition($x,$y)->setSize($w,$h) | Deteksi format otomatis |
ImageEps($file, $x, $y, $w, $h) | $page->addImage($file)->setPosition($x,$y)->setSize($w,$h) | API terpadu |
ImageSVG($file, $x, $y, $w, $h) | $page->addImage($file)->setPosition($x,$y)->setSize($w,$h) | API terpadu |
setImageBuffer($image, $data) | $page->addImage($binaryData, format: $fmt) | |
setJPEGQuality($quality) | ImagePolicy::create()->setJpegQuality($quality) |
Gambar dan Grafik
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
Line($x1, $y1, $x2, $y2) | $canvas->drawLine($x1, $y1, $x2, $y2)->stroke() | |
Rect($x, $y, $w, $h, $style) | $canvas->drawRect($x, $y, $w, $h)->fill() atau ->stroke() | |
RoundedRect($x, $y, $w, $h, $r) | $canvas->drawRoundedRect($x, $y, $w, $h, $r) | |
Circle($x, $y, $r) | $canvas->drawCircle($x, $y, $r) | |
Ellipse($x, $y, $rx, $ry) | $canvas->drawEllipse($x, $y, $rx, $ry) | |
Curve($x0,$y0,$x1,$y1,$x2,$y2,$x3,$y3) | $canvas->moveTo($x0,$y0)->curveTo($x1,$y1,$x2,$y2,$x3,$y3) | |
Polygon($points) | $canvas->drawPolygon($points) | |
RegularPolygon($x, $y, $r, $sides) | $canvas->drawRegularPolygon($x, $y, $r, $sides) | |
Arrow($x0, $y0, $x1, $y1) | $canvas->drawArrow($x0, $y0, $x1, $y1) | |
SetDrawColor($r, $g, $b) | $canvas->setStrokeColor(Color::rgb($r, $g, $b)) | |
SetFillColor($r, $g, $b) | $canvas->setFillColor(Color::rgb($r, $g, $b)) | |
SetDrawColorArray($color) | $canvas->setStrokeColor(Color::fromArray($color)) | |
SetFillColorArray($color) | $canvas->setFillColor(Color::fromArray($color)) | |
SetLineWidth($width) | $canvas->setLineWidth($width) | |
SetLineStyle($style) | $canvas->setLineStyle(LineStyle::from($style)) | |
SetAlpha($alpha, $blend) | $canvas->setOpacity($alpha)->setBlendMode($blend) |
Transformasi
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
StartTransform() | $canvas->saveState() | |
StopTransform() | $canvas->restoreState() | |
Translate($tx, $ty) | $canvas->translate($tx, $ty) | |
Rotate($angle, $x, $y) | $canvas->rotate($angle, $x, $y) | |
Scale($sx, $sy, $x, $y) | $canvas->scale($sx, $sy, $x, $y) | |
MirrorH($x) | $canvas->scale(-1, 1, $x, 0) | |
MirrorV($y) | $canvas->scale(1, -1, 0, $y) | |
Skew($xAngle, $yAngle) | $canvas->skew($xAngle, $yAngle) |
Link dan Bookmark
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
SetLink($link, $y, $page) | $pdf->createInternalLink($page, $y) | |
AddLink() | $pdf->createLink() | |
Link($x, $y, $w, $h, $link) | $page->addLink($url)->setRect($x, $y, $w, $h) | |
Annotation($x, $y, $w, $h, $text) | $page->addAnnotation($text)->setRect($x, $y, $w, $h) | |
Bookmark($txt, $level) | $pdf->addBookmark($txt, level: $level) |
Barcode
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
write1DBarcode($code, $type, ...) | $page->addBarcode(BarcodeFactory::$type($code))->setPosition(...) | Factory type-safe |
write2DBarcode($code, 'QRCODE', ...) | $page->addBarcode(BarcodeFactory::qrCode($code))->setPosition(...) | |
write2DBarcode($code, 'DATAMATRIX', ...) | $page->addBarcode(BarcodeFactory::dataMatrix($code))->setPosition(...) | |
write2DBarcode($code, 'PDF417', ...) | $page->addBarcode(BarcodeFactory::pdf417($code))->setPosition(...) |
Enkripsi dan Keamanan
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
SetProtection($perms, $uPass, $oPass, $mode) | $pdf->setEncryption()->setPermissions(...)->apply() | AES-256 saja |
setSignature($cert, $key, $pass, $extra) | $signer = new PdfSigner($pdf); $signer->setCertificate(...) | Dukungan PAdES penuh |
setSignatureAppearance($x, $y, $w, $h) | $signer->setSignatureField(new SignatureField(...)) |
TIP
setSignature() TCPDF hanya membuat tanda tangan PKCS#7 dasar. TCPDF-Next mendukung PAdES B-B hingga B-LTA penuh dengan integrasi timestamp, embedding OCSP, dan Document Security Store. Lihat PAdES B-LTA.
Output
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
Output($name, 'F') | $pdf->save($path) | Simpan ke file |
Output($name, 'D') | Respons framework dengan Content-Disposition: attachment | |
Output($name, 'I') | Respons framework dengan Content-Disposition: inline | |
Output($name, 'S') | $pdf->toString() | Kembalikan sebagai string biner |
Output($name, 'FI') | $pdf->save($path) + respons inline | |
Output($name, 'FD') | $pdf->save($path) + respons download | |
Output($name, 'E') | base64_encode($pdf->toString()) |
PDF/A dan Metadata
| Legacy TCPDF | TCPDF-Next | Catatan |
|---|---|---|
setPDFVersion($version) | Selalu PDF 2.0 | Tidak dapat dikonfigurasi |
| Tidak tersedia | ->setPdfALevel(PdfALevel::PDF_A_4) | Fitur baru |
| Tidak tersedia | ->setPdfALevel(PdfALevel::PDF_A_4F) | Fitur baru |
setExtraXMP($xmp) | $pdf->getMetadata()->setXmpProperty(...) |
Method Tanpa Padanan Langsung
Method legacy TCPDF ini ditangani secara berbeda di TCPDF-Next:
| Legacy TCPDF | Catatan |
|---|---|
setRTL($enable) | Otomatis via algoritma Unicode BiDi (UAX #9) |
setTempPath($path) | PdfDocument::create()->setTempDir(...) |
setCellHeightRatio($ratio) | Gunakan tinggi baris eksplisit di text block |
setListIndentWidth($width) | CSS padding-left pada list |
setOpenCell($isopen) | Tidak berlaku (model cell berbeda) |
getHTMLUnitToUnits() | Tidak berlaku (konversi unit otomatis) |
pixelsToUnits($px) | Units::pixelsToMm($px, $dpi) |
unhtmlentities($text) | htmlspecialchars_decode() (PHP built-in) |
Bacaan Lanjutan
- Migrasi dari TCPDF -- Panduan migrasi langkah demi langkah
- Referensi API -- Dokumentasi API TCPDF-Next lengkap
- FAQ -- Pertanyaan umum migrasi