AddAlternateImage

Görüntü işleme, isteğe bağlı içerik

Açıklama

ISO 32000-1 §8.9.5.4 içinde tanımlandığı biçimde bir temel görüntü XObject öğesinin alternatif gösterimini ekler veya günceller

Alternatif görüntüler, sayfa içeriğini çoğaltmadan yüksek çözünürlüklü bir yazdırma gösterimi veya isteğe bağlı içerikle denetlenen bir ekran gösterimi sağlayabilir

Sözdizimi

Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;

Parametreler

BaseImageID	Sayfa kaynakları ve içerik akışı `Do` işleçleri tarafından kullanılan görüntü
AlternateImageID	Çeşit olarak eklenecek görüntü XObject'i
DefaultForPrinting	Bu varyantı tercih edilen yazdırma görüntüsü olarak işaretler ve aynı temel görüntünün diğer varyantlarındaki bu bayrağı temizler
OptionalContentID	Bu çeşidin seçimini denetleyen isteğe bağlı OCG veya OCMD tanıtıcısı ya da isteğe bağlı içerik koşulu olmaması için 0

Dönüş değeri

Aynı görüntü güncellendiğinde mevcut dizin dâhil olmak üzere 1 tabanlı alternatif dizini; doğrulama başarısız olduğunda 0 döndürür

Açıklamalar

Temel ve alternatif, seçili belgede farklı görüntü nesneleri olmalıdır

Zaten alternatif olarak kullanılan bir görüntü kendi /Alternates dizisine sahip olamaz ve alternatiflere sahip bir görüntü başka bir alternatif olarak bağlanamaz

Bir OCG veya OCMD geçirilmesi en düşük PDF sürümünü 1.5'e yükseltir; aksi durumda en düşük sürüm PDF 1.3'tür

ISO 19005, görüntü sözlüklerinde /Alternates kullanımını yasakladığı için tüm PDF/A modları işlemi reddeder

Temel görüntünün bir /OC girdisi varsa yerleşik işleyici, temel görüntüyü görünür olduğu sürece gösterir; aksi hâlde girdisinde /OC bulunan görünür ilk alternatifi seçer

Örnek

BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);

Ayrıca bkz

AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo