Connect üzerinden CJK dikey yazımı

Bir bakışta

Bu tarif, Connect aktarımları üzerinden dikey yazım ölçülerine sahip bir Çince, Japonca ve Korece (CJK) CIDFont’u gömer. Motor, PDF 2.0 dikey ölçü girişlerini (glif başına /W2 ve varsayılan /DW2) CIDFont sözlüğüne yayar ve yukarıdan aşağıya doğru bir glif yığını oluşturur. CJK yazı tipi gömme işlemi Enterprise katmanındadır. CJK yazı tipi araçları class_exists() yoklamalarıyla keşfedilir ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur. Motor, dikey ölçüleri yalnızca etkin CID kodlaması dikey Identity kodlaması olduğunda yayar. Yatay diziler bundan etkilenmez.

Kurulum

composer require nextpdf/server

Enterprise CJK yazı tipi araçlarının mevcut olduğunu bir tools/list çağrısıyla doğrulayın. Bkz. /connect/tool-catalog/.

Kavramsal genel bakış

Dikey yazım modundaki bir CIDFont, /W2 (glif başına) ve /DW2 (varsayılan) dikey ölçüleri kullanır (ISO 32000-2 §9.7). CMap, yatay veya dikey yazım modunu seçer (ISO 32000-2 §9.7). Dikey yazım modu, glif ilerlemesini dikey eksene taşır (ISO 32000-2 §9.7). Yazı tipini kaydettiğinizde, işlem hattı yazı tipinin dikey ölçü tablolarını ayrıştırır. Sözlük girişlerini yalnızca dikey CID kodlamasını seçtikten sonra yayar.

API yüzeyi

Araç adlarını, çalışan kayıt defterine göre tools/list ile doğrulayın. Resmi katalog için bkz. /connect/tool-catalog/. Bu tarifte araç sayısı yinelenmez.

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

Belgeyi oluşturun, CJK yazı tipini kaydedin ve dikey kodlamayı seçin:

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "add_cjk_font",
    "arguments": {
      "document_id": "<id>",
      "family": "NotoSansCJKjp",
      "source": "/usr/share/fonts/opentype/noto/NotoSansCJKjp-Regular.otf",
      "subset": true
    }
  }
}

Kod örneği — üretim

Dikey kodlamayı seçin, yazı tipini ayarlayın, dikey bir dizi yazın ve ardından CIDFont sözlüğünü çıktılayıp inceleyin:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "set_cid_encoding",
    "arguments": { "document_id": "<id>", "font_key": "NotoSansCJKjp", "encoding": "/Identity-V" }
  }
}

Çıktıdaki CIDFont sözlüğü /W2 ve /DW2 içerir. Aynı kaynak yatay kodlamayla işlendiğinde her ikisini de atlar. Tek fark, kodlama geçididir; bu da structural yeniden üretilebilirlik profilini burada doğru tutar.

Uç durumlar ve dikkat edilecek noktalar

Yazı tipinde dikey ölçü tabloları yok. Yazı tipi aracı uyarır. Bunları içeren bir CJK yazı tipi seçin; yalnızca Latin içeren bir yazı tipinde hiçbiri bulunmaz.
Dikey ölçüleri olmayan bir yazı tipinde dikey kodlamanın seçilmesi bir hatadır. Yatay kodlamaya geri dönün veya başka bir yazı tipi seçin.
Yatay kodlama etkinken dikey metnin istenmesi bir hatadır. Dikey kodlamayı ilk dikey metin yayımından önce seçin.
İlk metin yayımından sonra kodlamanın değiştirilmesi bir donmuş kodlama hatasıyla reddedilir. Kodlamayı, yazı tipini kaydettikten hemen sonra ayarlayın.
Araç yok. nextpdf/premium olmadan Enterprise CJK yazı tipi araçları kaydedilmez ve çağrı bilinmeyen araç hatasıyla başarısız olur.

Performans

Frontmatter bütçesi, belgeleme için bir üst sınırdır. Alt küme oluşturma, glif başına ölçü dizisinin boyutunu sınırlar. Alt küme oluşturmayı yalnızca dikey bir dizi, alt kümenin dışarıda bırakacağı gliflere ihtiyaç duyduğunda devre dışı bırakın.

Güvenlik notları

Genel Connect aktarım kılavuzuna ek bir not yoktur.

Uygunluk

İddia	Madde	reference_id
Dikey CIDFont, `/W2` ve `/DW2` ölçülerini kullanır	ISO 32000-2 §9.7
CMap, yatay ve dikey yazım modları arasında seçim yapar	ISO 32000-2 §9.7
Dikey yazım modu glifleri dikey eksende ilerletir	ISO 32000-2 §9.7

Dikey ölçü girişlerinin yayılması, atıfta bulunulan maddelerin gereklerini uygular. Bu, kapsayıcı bir uygunluk iddiası değildir. Belgenin tümünün uygun olup olmadığını bir doğrulayıcı belirler.

Ticari bağlam

CJK yazı tipi gömme işlemi Enterprise katmanındadır. CJK yazı tipi araçları yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur.

Connect ayrıntıları

Aktarım kullanılabilirliği (MCP / REST / gRPC)

Bunu MCP tools/call, REST araç uç noktası ve gRPC hizmeti üzerinden aynı şekilde çağırın. Üçü de paylaşılan araç yürütücüsü üzerinden yönlendirilir.

HITL risk katmanı

Yazı tipi kaydı, kodlama seçimi ve metin yayımı dikkat düzeyindedir. Çıktı bir dosya yazdığında onay gerektirir; base64 modu gerektirmez. Bkz. /connect/hitl-risk-tiers/.

Onay geçidi JSON zarfı

Dosyaya yazma çıktı yolu geçit kapsamındayken, geçit bir doğrulama zarfı ve araç adına, bir nonce’a ve 300 saniyelik bir TTL’ye bağlı tek kullanımlık bir belirteç döndürür. arguments._confirmation_token ile yeniden çağırın. Bkz. /connect/hitl-risk-tiers/.

Ayrıca bkz.

/cookbook/connect/font-typography/ — yatay metin ve yazı tipi seçiminin temelleri.
/cookbook/connect/conformance-mode/ — dikey CJK dizileri PDF/UA-2 için yine de etiketleme gerektirir.
/connect/tool-catalog/ — katman başına araç kümesinin hesaplanması.
/connect/hitl-risk-tiers/ — risk modeli ve geçit.