Telefondan gelen bir HEIC fotoğraf, Delphi ile üretilmiş bir rapora girer; PDF ekranda doğru görünür ve basılan sayfa kaymış kırmızılarla, kesit logonun düz bir kutunun üzerinde oturduğu haliyle geri gelir. Fotoğraf yolda bir platform bitmap'i üzerinden çözülmüştü; onu PDF Library for Delphi'de AddModernImageFromFile ile yükleyin, AVIF, HEIF ve JPEG XL görüntüleri öntanımlı olarak alfayı, ICC profilini ve 16 bit kanalları korur
Bu biçimler belge iş akışlarına çoğunlukla telefonlar üzerinden geldi. iPhone'lar yıllardır öntanımlı olarak HEIC kaydediyor, Android cihazlar AVIF üretiyor ve JPEG XL arşivleme ile fotoğraf hatlarında belirmeye başladı. JPEG ve PNG etrafında tasarlanmış bir rapor üretecinin biri geldiğinde iki seçeneği vardır: dosyayı reddetmek ya da işletim sisteminin sunduğu hangi kod çözücü varsa onunla açıp düzleştirilmiş bir 8 bit bitmap kabul etmek. Bu yazı üçüncü bir yolu kapsar: kütüphane biçimi kendisi tanır, seçtiğiniz bir kodekle çözer ve sonucu derinlik ile renk verisi sağlam halde gömer
Bir bitmap gidiş-dönüşü neyi kaybeder?
Bir platform bitmap dönüşümü üç şeyi tek adımda kaybeder: saydamlık, gömülü renk profili ve 8 bitin üzerindeki her kanal derinliği. Her birine yaslanan bir iş akışı vardır. Alfa, sayfa içeriğinin üzerine bindirilen logolar ve ürün kesitleri için önemlidir. ICC profili, basılacak ya da bir referansa karşı renk eşlenecek her şey için önemlidir; onsuz görüntüleyici sRGB varsayar ve geniş gamutlu bir kamera görüntüsü yeniden yorumlanır. 16 bit kanallar ise tıbbi, bilimsel ve denetim görüntüleri için önemlidir; 8 bite niceleme, görüntünün tam olarak yakalandığı gradasyonları siler
Bunların hiçbiri hata üretmez. Sayfa işler, fotoğraf tanınır ve sorun, biri baskıyı orijinalle karşılaştırana kadar bekler. Bu yüzden biz korumayı, çağıranın tercihe bağlı eklediği bir şey olarak değil öntanımlı olarak ele alırız: AddModernImageFromFile, AddModernImageFromStream ve AddModernImageFromString öntanımlı değeri 8 olan bir Options parametresi alır ve 8 seçeneği, alfayı, ICC'yi ve 16 bit örnekleri PDF görüntü nesnesine birlikte taşıyan ayar budur
16 bitlik bir görüntü ayrıca ürettiğiniz dosyayı değiştirir. PDF Library for Delphi, bir görüntü 16 bit örnek taşıdığında belgeyi en az PDF 1.5'e yükseltir; bileşen başına 16 bitin görüntü XObject'leri için geçerli olduğu sürüm budur. Akış aşağısındaki bir sistem PDF 1.4'te ısrar ediyorsa o gereksinimle 16 bit fotoğraflar ikisi birden sağlanamaz; bunu tasarım anında öğrenmek daha iyidir
Bir sayfaya görüntü eklemek
Modern görüntü çağrıları başarıda sıfırdan büyük bir görüntü tanımlayıcısı, başarısızlıkta 0 döndürür; tanımlayıcı sonra DrawImageAndRelease'e ya da her zamanki SelectImage / DrawImage çiftine gider. Aşağıdaki taslak, gerçek telefon yüklemelerinin gerektirdiği tek geri düşüşü içerir; hemen ardından açıklanır:
uses
PDFlibrary;
var
Lib: TPDFlib;
ImageID: Integer;
begin
Lib := TPDFlib.Create;
try
Lib.NewDocument;
Lib.SetPageSize('A4'); // NewDocument zaten 1. sayfayı oluşturdu
Lib.SetOrigin(1); // Top üst kenardan ölçülür
// Options öntanımlı 8'dir: alfa, ICC profili ve 16 bit kanallar
ImageID := Lib.AddModernImageFromFile('uploads\pump-housing.heic');
// Uzantı HEIC der ama baytlar sıradan bir JPEG olabilir
if ImageID = 0 then
ImageID := Lib.AddImageFromFile('uploads\pump-housing.heic', 0);
if ImageID > 0 then
Lib.DrawImageAndRelease(ImageID, 40, 40, 515, 340)
else
Lib.DrawText(40, 40, 'Photo could not be decoded');
Lib.SaveToFile('inspection-report.pdf');
finally
Lib.Free;
end;
end;
Geri düşüş, dosya adlarının yalan söylemesinden vardır. Paylaşım sayfaları, mesajlaşma uygulamaları ve yükleme formları, orijinal adı koruyarak yolda HEIC'yi JPEG'e çevirir ya da dosyaları karşılayan formun beklediği her ne ise ona yeniden adlandırır. AddModernImageFromFile uzantıya hiç bakmaz. İlk baytları inceler ve bunlar AVIF, HEIF ya da JPEG XL değilse kod çözücüye dokunmadan 0 döndürür. Bu yüzden .heic soneki takmış bir JPEG modern çağrıda düşer ve genel AddImageFromFile ile başarılı olur; o da içeriği aynı şekilde koklar ve JPEG, PNG, TIFF ile diğer klasik biçimleri ele alır
Neden her şey AddImageFromFile üzerinden gönderilmiyor? Modern biçimleri o da tanır; ama modern çağrılar niyeti açık kılar ve hiçbir şey geçmediğinizde 8 seçeneğini kendisi verir, bu yüzden girdinin bir telefon fotoğrafı beklendiği her yerde onları çağrı noktasında görmeyi tercih ederiz
Kütüphane AVIF ile HEIC'i nasıl ayırt eder?
PDF Library for Delphi biçimi, en fazla 4096 baytlık sınırlı bir başlık okumasından karar verir ve ardından çağıranın akış konumunu bırakıldığı yere geri koyar. JPEG XL kolay durumdur: ham bir kod akışı FF 0A ile başlar, kapsayıcı biçim ise sabit bir 12 baytlık imza kutusuyla. AVIF ile HEIF zordur, çünkü ikisi de ISO temel medya dosya biçiminde — MP4 ile aynı kutu yapısında — yaşar ve yalnızca ftyp kutusunun içinde listelenen markalarla ayrışır
Tuzak, marka listelerinin örtüşmesidir. Bir AVIF dosyası genellikle uyumlu markaları arasında mif1'i de listeler, çünkü AVIF, HEIF ile aynı görüntü dosyası profili üzerine kuruludur. mif1'i görür görmez HEIF döndüren bir dedektör, gerçek AVIF dosyalarının büyük bir bölümünü yanlış etiketler. Kütüphane bu yüzden önce bütün marka listesini tarar ve avif ya da avis'i HEIF ailesi (heic, heix, hevc, hevx, heim, heis, mif1, msf1) karşısında üstün kılar
Tespiti kod çözmeden önce çalıştırmak aynı zamanda bir güvenlik özelliğidir. Bilinmeyen ya da gizlenmiş bir girdi harici kodeğe asla ulaşmaz; yeniden adlandırılmış bir yürütülebilir dosya ya da hatalı biçimli bir yükleme, onu çözümlemek zorunda kalacak büyük bir görüntü kod çözücüsü yerine birkaç düzine bayt karşılaştırmasıyla kapıdan çevrilir
Kod çözmenin gerçekleştiği yer
PDF Library for Delphi içine bir AVIF, HEIF ya da JPEG XL kodeki derlemez. O kodekler büyüktür, sık değişir ve hiç telefon fotoğrafı görmeyecek bir uygulama bunların bedelini ödememelidir. Varsayılan arka uç, ilk kullanımda bir ImageMagick MagickWand modülünü işlem içinde yükler ve onu sabit bir sırada arar: SetModernImageCodecLibrary ile ayarlanan dosya ya da dizin, sonra PDFLIB_MODERN_IMAGE_CODEC ortam değişkeni, sonra yürütülebilir dosyanın dizini, sonra sıradan sistem arama yolu. Windows'ta her konumda CORE_RL_MagickWand_.dll, MagickWand-7.Q16HDRI-10.dll ve MagickWand-7.Q16-10.dll'i dener
İki pratik sonuç izler. Kodeğin bir Q16 derlemesini gönderin; 8 bit nicemli bir derleme, hangi seçeneği geçerseniz geçin 16 bit örnekleri teslim edemez. Kodek dizini bir modules\coders alt dizini içeriyorsa kütüphane MAGICK_HOME, MAGICK_CONFIGURE_PATH ve MAGICK_CODER_MODULE_PATH'i sizin için doldurur; ama yalnızca ana süreç hâlihazırda ayarlamamış olan değişkenleri. Kendi çalışma zamanı düzeni olan bir uygulama onu korur
Tavsiyemiz yolu açıkça ayarlamanız ve sistem arama yoluna güvenmemenizdir. PATH'inde tesadüfen farklı bir ImageMagick olan bir makine, aksi halde rapor üreticinizin hangi kodeği kullanacağına karar verir; bu da yalnızca bir müşterinin sunucusunda beliren türden bir farktır
Hâlihazırda bir kod çözücüyle gelen ya da harici bir modül yüklemesine izin verilmeyen uygulamalar bunun yerine bir callback kaydeder. Callback, kaynak akışı okuyan, çıktı akışına PNG baytları yazan ve yönlendirme bayrağına uyan düz bir fonksiyondur. Kayıt süreç genellidir ve bir kilit altında korunur; belge başına değil başlangıçta bir kez yapın:
uses
Classes, PDFlibModernImage,
AppCodec; // hâlihazırda gönderdiğiniz kodeği saran sizin kendi unit'iniz
function MyModernDecoder(InStream, OutPNG: TStream;
ImageFormat: TPDFlibModernImageFormat;
ApplyOrientation: Boolean): Boolean;
begin
// InStream 0 konumundadır, OutPNG boştur
Result := (ImageFormat <> mifUnknown) and
AppDecodeToPNG(InStream, OutPNG, ApplyOrientation);
end;
initialization
RegisterModernImageDecoderBackend(MyModernDecoder);
finalization
ClearModernImageDecoderBackend; // MagickWand arka ucuna geri dön
Bir görüntü belgeye eklenirken kütüphane daima yönlendirmenin uygulanmasını ister. Telefon kameraları sensör görüntüsünü rutin olarak yan yatırıp amaçlanan döndürmeyi meta veri olarak kaydeder; ApplyOrientation'ı yok sayan bir callback, yan yatmış dikey fotoğraflar üretir. El yapımı bir arka uç bunda kolayca yanılır ve test görüntülerinin hepsi yatay çekilmişse hata fark edilmekten uzaktır
Neden bellek içinde PNG'ye çözülür?
Arka uç, çözülen görüntüyü bellek içi bir PNG'ye çevirir ve o PNG'yi mevcut PNG gömme yoluna verir. Ham bir piksel arabelleği teslim etmeye kıyasla dolambaçlı gibi görünür; yine de daha ucuz olan doğru seçenektir. PNG, hayatta kalması gereken her şeyi ifade edebilir (alfa, renk türü, örnek başına 8 ya da 16 bit ve gömülü bir ICC profili) ve PDF Library for Delphi'nin PNG'den, doğru filtreler, soft mask ve renk uzayıyla bir PDF görüntü nesnesine giden olgun bir yolu hâlihazırda vardır. Modern biçimler, kendi hatalarını bulacağınız paralel bir uygulama almak yerine o çalışmayı devralır. Kod çözücü çıktısı, kaynakta kanal başına 8 bitten fazlası varken 16 bite, aksi halde 8 bite normalize edilir
Hiç geçici dosya yazılmaz, dolayısıyla bir çökmeden sonra temizlenecek bir şey yoktur. Bir pürüz açık ele alma gerektirdi. Geliştirme sırasında kodeğin, bellek içi görüntüyü PNG'ye çevirirken ICC profilini düşürebildiğini gördük; bu, bu yolun var olma amacı olan renk kaymasını tam olarak geri getirirdi. Arka uç artık biçim değişiminden önce kaynak profili okur, onu Flate ile sıkıştırır, yeniden hesaplanmış bir CRC ile geçerli bir iCCP parçasına yazar ve onunla çelişecek her sRGB parçasını kaldırır. Gerçek bir AVIF üzerinde Win64 çalıştırmada çıktı, 16 bit alfa ile 16 bit RGBA'yı korudu ve PDF'den çıkarılan profil, SHA-256'sı kaynak profille aynı olan 60.960 bayttı
Kodeği başlangıçta denetlemek
Kodeği uygulama başlarken, ilk fotoğraf gelmeden yoklayın. ModernImageCodecAvailable, ya kayıtlı bir callback ya da yüklenebilir bir MagickWand modülü mevcutken 1 döndürür; SetModernImageCodecLibrary yükleyiciyi belirli bir dosyaya ya da dizine yönlendirir:
procedure CheckModernImageSupport(Lib: TPDFlib);
var
CodecDir: string;
begin
CodecDir := ExtractFilePath(ParamStr(0)) + 'codecs';
// Bu işlemde bir kodek modülü hâlihazırda yüklüyse 0 döndürür
if Lib.SetModernImageCodecLibrary(CodecDir) = 0 then
Log('Codec already loaded, path change ignored');
if Lib.ModernImageCodecAvailable = 0 then
Log('No AVIF/HEIF/JPEG XL decoder in ' + CodecDir +
' - phone photos will be rejected');
end;
Bunu bir yükleyiciye ya da bir hizmete bağlamadan önce bilinmeye değer iki davranış vardır. Başarısız bir yükleme hatırlanır; kütüphane her görüntü için diski yeniden aramaz. Hizmetiniz, yükleyici kodek klasörünü kopyalamayı bitirmeden önce yoklama yaparsa kodeği kullanılamaz olarak bildirmeyi sürdürür; ta ki SetModernImageCodecLibrary yeniden çağrılana dek — o çağrı hatırlanan başarısızlığı temizler. Tersi de geçerlidir: bir modül bir kez yüklendiğinde SetModernImageCodecLibrary 0 döndürür ve yol, sürecin ömrü boyunca olduğu gibi kalır; süren dönüşümler altında yerel bir kodeği boşaltmayı örtükçe yapmayı tercih etmiyoruz
Çıktının boyutunu da izleyin. Profiliyle bir 16 bit RGBA fotoğraf büyük bir görüntü nesnesidir ve kırk tanesi olan bir rapor hızla ağırlaşır. Yalnızca ekranda okunacak belgeler için gömmeden önce alt örnekleme doğru takastır ve genel boyut kolları PDF dosya boyutu optimizasyonu yazısında ele alınır. Renk ilkesi de bilinçli bir karar hak eder. Her kaynak profili korumak arşivleme ve baskı işi için doğrudur; her şeyi belge geneli tek bir uzaya çevirmek ise yan yana tutarlı görünmesi gereken farklı telefonlardan gelen bir fotoğraf setine uyar; o yol bir belgeyi başka bir renk uzayına yeniden renklendirme yazısında anlatılır. Dosyaya gerçekte neyin indiğini doğrulamak için metin, görüntü ve yazı tipi çıkarma yazısındaki inceleme yolu, bir belgenin taşıdığı görüntü nesnelerini bildirir
AVIF, HEIF ve JPEG XL girdisi, Delphi, C++Builder ve Free Pascal için aynı kütüphanede PNG, JPEG, TIFF ve WebP girdisiyle, renk uzayı dönüşümüyle ve görüntü optimizasyonuyla yan yana durur. Lisanslama, platform desteği ve tam API referansı PDF Library for Delphi ürün sayfasındadır