Kendalikan fon dan gaya teks dengan NextPDF Connect

Sekilas pandang

Buat dokumen dengan beragam gaya teks dengan mengganti fon antarblok teks. set_font menetapkan typeface, gaya, dan ukuran yang aktif. Status tersebut berlaku untuk setiap panggilan add_text berikutnya hingga Anda mengubahnya. Anda memerlukan create_pdf, set_font, add_text, dan output_pdf — semuanya merupakan alat Core. Parameter status teks mengendalikan proses render glif (ISO 32000-2 §9).

Pemasangan

composer require nextpdf/server

Ikat salah satu transport. Anda dapat menggunakan tiga keluarga fon bawaan tanpa menambahkan berkas fon: helvetica, times, dan courier.

Gambaran konseptual

set_font menerima family, style ("", "B", "I", "BI", "U"), dan size. Fon yang Anda tetapkan berlaku untuk setiap panggilan add_text berikutnya hingga Anda memanggil set_font lagi. Tidak ada reset otomatis. Saat add_text menyertakan font_size, nilai tersebut mengganti ukuran yang aktif hanya untuk satu panggilan itu saja. Ukuran set_font kembali berlaku untuk panggilan berikutnya. Teks ditampilkan oleh operator penampil teks dalam urutan content stream (ISO 32000-2 §9.4). add_text tidak memiliki parameter warna. Warna teks berasal dari warna tinta pada status grafis dokumen.

Permukaan API

Alat	Peran	Tingkat risiko
`create_pdf`	Membuka sesi	Aman
`set_font`	Menetapkan typeface/style/ukuran aktif	Perhatian
`add_text`	Menulis teks dengan fon aktif	Perhatian
`output_pdf`	Merender dan mengembalikan PDF	Persetujuan Diperlukan / Tinjauan (base64)

Katalog alat adalah katalog resmi. Alat yang dapat Anda gunakan bergantung pada tingkat edisi yang terpasang.

Contoh kode — Mulai cepat

create_pdf (A4 portrait) → document_id.
set_font (helvetica, B, 24) lalu add_text (judul, rata tengah).
set_font (helvetica, "", 12) lalu add_text (badan teks, rata kanan-kiri).
set_font (courier, I, 10) lalu add_text (cuplikan kode).
output_pdf.

Contoh kode — Produksi

Tetapkan fon secara eksplisit sebelum setiap blok yang tipografinya penting. Jangan pernah mengandalkan status yang diwariskan antarbagian logis. Gunakan penggantian font_size per panggilan hanya untuk penekanan sekali saja, karena nilainya tidak dipertahankan. Susun dokumen bagian demi bagian, dan verifikasi bahwa setiap add_text mengembalikan position.

Kasus tepi & jebakan

Keluarga fon tidak dikenal. Apa pun di luar helvetica/times/courier (misalnya arial) akan ditolak.
Keluarga fon kosong. family harus berupa string yang tidak kosong.
Gaya tidak valid. Gunakan kode huruf besar. "bold" akan ditolak.
Ukuran tidak positif. size harus berupa angka positif.
Ukuran per panggilan bersifat sementara. Ukuran tersebut tidak mengubah status set_font.

Kinerja

Fon bawaan hanya menambah beban yang dapat diabaikan, dan keluarannya hanya beberapa KB. Profilnya adalah structural.

Catatan keamanan

Mode base64 tidak memiliki efek samping pada sistem berkas. Fon bawaan tidak memuat berkas fon eksternal, sehingga resep ini tidak memiliki permukaan serangan dari penguraian fon.

Kesesuaian

Pernyataan	Spesifikasi	Klausa	reference_id
Teks ditampilkan oleh operator penampil teks dalam urutan content stream.	ISO 32000-2	§9.4
Parameter status teks mengatur proses render glif.	ISO 32000-2	§9

Konteks komersial

Tidak berlaku — semua alat merupakan Core.

Ketersediaan transport

Transport	Tersedia	Catatan
MCP (stdio)	Ya	`tools/call` per alat.
REST	Ya	Satu operasi per alat.
gRPC	Ya	Unary per alat.

Tingkat risiko HITL

create_pdf Aman; set_font/add_text Perhatian; output_pdf Persetujuan Diperlukan, diturunkan menjadi Tinjauan pada mode base64 (tingkat risiko HITL).

Amplop JSON untuk gerbang konfirmasi

Keluaran base64:

{ "allowed": true }