CapCut'ta Brand Kit font yükleme hatası, tahmini sebebi ve çözümü

Kısa cevap: pek bir şey söylemiyor. Hata mesajı jenerik ve CapCut, Brand Kit'in font dosyalarını hangi kritere göre kabul ya da reddettiğini herhangi bir resmi teknik dokümantasyonda açıklamıyor — kendi taramamızda böyle bir belgeye rastlamadık. Yani bu bir 'bilinen, dokümante edilmiş kural ihlali' hatası değil, uygulamanın iç yükleme/parse mantığının bir yerde takıldığı bir durum.

İlk şüphemiz dosyanın bozuk ya da lisans açısından kısıtlı olmasıydı. Reddedilen Allura-Regular.ttf dosyasını `fontTools` kütüphanesiyle açıp kontrol ettik: geçerli bir TrueType dosyası, 15 tablo içeriyor, `OS/2` tablosundaki `fsType` alanı 0 — yani gömme/kurulum kısıtlaması yok, dosya sağlam ve yüklenebilir olmalı. Sorun dosyanın 'geçerliliğinde' değil, CapCut'ın onu nasıl işlediğindeydi.

İkisi de aynı OpenType konteyner formatının (sfnt) farklı 'lehçeleri'. Microsoft'un OpenType spesifikasyonuna göre, TrueType anahat verisi içeren fontlar dosya başında 0x00010000 sürüm imzası taşır; CFF (Compact Font Format / PostScript) anahat verisi içerenler ise 'OTTO' imzasını kullanır. Bir font dosyası bu ikisinden yalnızca birini taşıyabilir — glyph şekilleri ya `glyf` tablosunda (TrueType) ya `CFF` tablosunda (PostScript) tutulur, ikisi aynı anda bulunmaz.

Asıl fark harflerin nasıl çizildiğinde. TrueType (`glyf`) harfleri kuadratik Bézier eğrileriyle tanımlar; CFF ise kübik Bézier eğrileri kullanır. Adobe'nin Typekit blogu bu farkı somutlaştırıyor: kübik eğriler daha az kontrol noktasıyla aynı kavisi tarif edebildiği ve CFF, tekrar eden path segmentlerini ortak bir rutine indirgeyen 'subroutinization' adında bir sıkıştırma sürecinden geçtiği için, OpenType/CFF fontlar karşılaştırılabilir TrueType fontlardan ortalama %20-50 daha küçük dosya boyutuna sahip.

• TTF (`glyf`): kuadratik eğriler, genelde daha çok nokta, ekran hinting'i için tarihsel olarak daha güçlü destek.
• OTF (`CFF`): kübik eğriler, daha az nokta, subroutinization sayesinde daha küçük dosya.
• İkisi de aynı OpenType katmanlarını (GSUB, GPOS, GDEF — ligatür ve konumlandırma kuralları) taşıyabilir; fark yalnızca anahat matematiğinde ve buna bağlı tablo setinde.

Bir dosyayı FontForge ya da bir online dönüştürücüyle TTF'den OTF'ye çevirmek, sadece uzantıyı değiştirmiyor — dosyayı sıfırdan yeniden inşa ediyor: yeni bir tablo dizini, yeni checksum değerleri ve CFF anahatlarına dönüştürülmüş glyph verisi. Bunun önemli bir yan etkisi var: OpenType spesifikasyonuna göre `fpgm`, `prep`, `cvt` ve `gasp` tabloları yalnızca TrueType anahatlı fontlarda tanımlıdır — CFF anahatlı bir OTF dosyasının yapısında bu tablolara zaten yer yok. Bu tablolar, fontun küçük punto boyutlarında ekranda nasıl 'hint'leneceğini (piksel ızgarasına nasıl oturtulacağını) tarif eden bytecode talimatları taşır.

Yani OTF'ye çevirdiğinde elde ettiğin dosya, 'aynı fontun farklı uzantılı hâli' değil; TrueType'a özgü hinting bytecode'unun barınamayacağı, sıfırdan derlenmiş, yapısal olarak daha sade bir dosya. Bunu netleştirmek gerekiyor: CapCut hangi tabloyu ya da alanı reddettiğini yayınlamıyor, dolayısıyla 'tam olarak şu tablo CapCut'ın parser'ını kırıyor' demek mümkün değil — bu doğrulanamayan bir iddia olur. Doğrulayabildiğimiz şey, yeniden oluşturulan dosyanın orijinalinden yapısal olarak gerçekten farklı olduğu ve bu farkın, uygulamanın yükleyicisi için 'daha az sürpriz içeren' bir girdi anlamına gelebileceği.

İki fontun karakteri çok farklı. Anton kalın, bağlantısız harflerden oluşan bir başlık fontu; Allura ise harfleri birbirine bağlayan bir el yazısı (script) fontu. Bizim incelediğimiz Allura dosyası 1048 glyph ve harfleri bağlamak için gereken `GSUB`/`GPOS`/`GDEF` (bitişik alternatif/ligatür) tablolarını içeriyordu — bir script fontun akıcı görünmesi için gereken, ama basit bir sans-serif fontta genelde bulunmayan katman.

ttfautohint often struggles to hint display or handwritten typefaces.

— Google Fonts Guide, Static fonts specifics

Bunun bir nedeni de kaynağında olabilir: Google Fonts'un resmi derleme rehberine göre, statik TTF dosyaları otomatik olarak `ttfautohint` aracıyla hinting'lenir — ama bu araç, tam da display ve el yazısı fontlarda hinting üretirken zorlanıyor. Yani Allura gibi bir script fontun TTF'si, Anton gibi sade bir sans fonta kıyasla daha karmaşık ya da alışılmadık hinting/layout verisiyle paketlenmiş olabilir. Bunu kesin bir nedensellik olarak sunmuyoruz — CapCut'ın kendi doğrulama mantığını bilmiyoruz — ama gözlemlediğimiz örüntüyle (basit font geçti, karmaşık script font geçmedi) tutarlı bir açıklama.

• Önce dosyanın sağlam olduğunu doğrula: macOS'ta Font Book'ta, Windows'ta çift tıklayarak önizlemesi açılıyorsa dosya bozuk değildir.
• Klasik yeniden başlatma adımlarını atlama: CapCut masaüstü uygulamasını tamamen kapat (Cmd+Q / Alt+F4) ve yeniden aç — birçok yükleme hatası, uygulama yeni bir oturumla başladığında kendiliğinden düzeliyor.
• Platformu değiştir: masaüstünde başarısız olan bir yükleme web.capcut.com üzerinden bazen sorunsuz geçiyor; tam tersi de doğru. İkisi ayrı yükleme uçları kullanıyor, biri takılırsa diğerini dene.
• CapCut'ı güncelle (masaüstünde Ayarlar → Güncellemeleri Kontrol Et) ya da uygulamayı kaldırıp yeniden kur; bilinen yükleme bug'ları sürüm güncellemeleriyle giderilebiliyor.
• Farklı bir tarayıcı ya da tarayıcı önbelleğini temizlemiş bir oturum dene — web yükleyicisinde bazen eski önbellek/uzantı çakışması hataya neden oluyor.
• Bunların hiçbiri işe yaramazsa TTF'yi ücretsiz FontForge ile aç, File → Generate Fonts'tan 'OpenType (CFF)' formatını seçip .otf olarak dışa aktar. Masaüstü uygulama kurmak istemiyorsan CloudConvert gibi bir online dönüştürücü de aynı işi görür.
• OTF dosyasını CapCut'a yeniden yükle.
• Hâlâ olmuyorsa Brand Kit yükleyicisini tamamen atla: fontu doğrudan işletim sistemine kur (Font Book / Windows Yazı Tipleri), CapCut'ı kapatıp yeniden aç — font 'System Fonts' listesinde otomatik görünür.
• Not: OTF'ye çevirince fontun ince hinting ayarları gidebilir; bu genelde yalnızca çok küçük punto boyutlarında, piksel düzeyinde fark eder — Reels/TikTok başlıklarında kullandığın büyük puntolarda pratikte görünmez.