NextPDF Connect üzerinden yazı tiplerini ve metin biçimlendirmesini denetleyin

Bir bakışta

Metin blokları arasında yazı tiplerini değiştirerek birden fazla metin stiline sahip bir belge oluşturun. set_font etkin yazı tipini, stilini ve boyutunu ayarlar. Bu durum, siz değiştirene kadar sonraki her add_text çağrısı için geçerlidir. Bu tarif için create_pdf, set_font, add_text ve output_pdf gerekir — bunların tümü Core araçlarıdır. Metin durumu parametreleri gliflerin işlenmesini yönetir (ISO 32000-2 §9).

Kurulum

composer require nextpdf/server

Bir taşıma katmanı bağlayın. Yazı tipi dosyası eklemeden yerleşik üç yazı tipi ailesini kullanabilirsiniz: helvetica, times ve courier.

Kavramsal genel bakış

set_font, family, style ("", "B", "I", "BI", "U") ve size değerlerini alır. Ayarladığınız yazı tipi, sonraki her add_text çağrısı için, siz yeniden set_font çağırana kadar geçerlidir. Otomatik bir sıfırlama yoktur. add_text bir font_size içerdiğinde, bu değer etkin boyutu yalnızca o tek çağrı için geçersiz kılar. Sonraki çağrıda set_font ile ayarlanan boyut yeniden geçerli olur. Metin, içerik akışı sırasına göre metin gösterme işleçleri tarafından üretilir (ISO 32000-2 §9.4). add_text bir renk parametresine sahip değildir. Metin rengi, belgenin grafik durumundaki mürekkep renginden gelir.

API yüzeyi

Araç	Rol	Risk düzeyi
`create_pdf`	Oturumu başlatır	Güvenli
`set_font`	Etkin typeface/style/size değerlerini ayarlar	Dikkat
`add_text`	Etkin yazı tipiyle metin yazar	Dikkat
`output_pdf`	PDF’yi işler ve döndürür	Onay gerekli / inceleme (base64)

Resmi katalog araç kataloğu sayfasıdır. Kullanabileceğiniz araçlar, kurulu sürüm düzeyine bağlıdır.

Kod örneği — hızlı başlangıç

create_pdf (A4 dikey) → document_id.
set_font (helvetica, B, 24), ardından add_text (başlık, ortalanmış).
set_font (helvetica, "", 12), ardından add_text (iki yana yaslanmış gövde).
set_font (courier, I, 10), ardından add_text (bir kod parçası).
output_pdf.

Kod örneği — üretim

Tipografinin önemli olduğu her bloktan önce yazı tipini açıkça ayarlayın. Mantıksal bölümler arasında devralınan duruma asla güvenmeyin. Çağrı başına font_size ile yapılan geçersiz kılmayı yalnızca tek seferlik vurgu için kullanın, çünkü kalıcı olmaz. Belgeyi bölüm bölüm oluşturun ve her add_text çağrısının bir position döndürdüğünü doğrulayın.

Uç durumlar ve püf noktaları

Bilinmeyen aile. helvetica/times/courier dışındaki herhangi bir değer (örneğin arial) reddedilir.
Boş aile. family boş olmayan bir dize olmalıdır.
Geçersiz stil. Büyük harfli kodları kullanın. "bold" reddedilir.
Pozitif olmayan boyut. size pozitif bir sayı olmalıdır.
Çağrı başına verilen boyut geçicidir. set_font durumunu değiştirmez.

Performans

Yerleşik yazı tipleri ihmal edilebilir düzeyde yük ekler ve çıktı birkaç KB’dir. Profil structural türündedir.

Güvenlik notları

Base64 modunun dosya sistemi üzerinde herhangi bir yan etkisi yoktur. Yerleşik yazı tipleri dış yazı tipi dosyalarını almaz; dolayısıyla bu tarifin yazı tipi ayrıştırmaya yönelik saldırı yüzeyi yoktur.

Uyumluluk

İfade	Belirtim	Madde	reference_id
Metin, akış sırasına göre metin gösterme işleçleri tarafından gösterilir.	ISO 32000-2	§9.4
Metin durumu parametreleri gliflerin işlenmesini yönetir.	ISO 32000-2	§9

Ticari bağlam

Geçerli değil — tüm araçlar Core’dur.

Taşıma katmanı kullanılabilirliği

Taşıma katmanı	Kullanılabilir	Notlar
MCP (stdio)	Evet	`tools/call`, her araç için.
REST	Evet	Araç başına bir işlem.
gRPC	Evet	Araç başına unary.

HITL risk düzeyi

create_pdf güvenli; set_font/add_text dikkat; output_pdf onay gerekli, base64 modunda inceleme düzeyine düşürülür (HITL risk düzeyleri).

Onay kapısı JSON zarfı

Base64 çıktısı:

{ "allowed": true }