AddImageFromStream

Görüntü işleme

Açıklama

Bir TStream'den seçili belgeye görüntü ekler

Bir görüntü belgeye eklendikten sonra PDF dosyasının boyutunu daha fazla artırmadan herhangi bir sayfada birden çok kez çizilebilir

Desteklenen görüntü dosyası türleri BMP, TIFF, JPEG, PNG, GIF, WMF, EMF ve WebP'dir; modern görüntü kod çözücüsü kullanılabildiğinde AVIF, HEIF, HEIC ve JPEG XL de desteklenir

PDF sürümü davranışı: bileşen başına 16 bit görüntü verilerinin içe aktarılması PDF 1.5 gerektirir. Belge PDF 1.4 veya altına ayarlandığında ve kaydetme sürümü kilitli olmadığında AddImageFromStream belgeyi otomatik olarak PDF 1.5 sürümüne yükseltir, 16-bit image samples kaydını AutoBumpedFeatures içine yazar. Çağıran daha düşük bir kaydetme sürümünü kilitlerse uyumluluk geçidi kaydetmeyi LastErrorCode 602 ile reddeder

BMP ve TIFF görüntülerinde, görüntü verilerini sıkıştırmak için bu işlev çağrılmadan önce CompressImages işlevi çağrılabilir. Diğer görüntü türleri otomatik olarak sıkıştırılır

Sözdizimi

Delphi

Function TPDFlib.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametreler

InStream	Görüntü verilerini içeren TStream nesnesi. Akıştaki geçerli konum yok sayılır; görüntü verileri akışın 0 konumundan okunur
Options	Çok sayfalı TIFF görüntülerinde bu parametre yüklenecek sayfa numarasını belirtir. PNG görüntülerinde: 0 = Görüntüyü olağan biçimde yükle 1 = Alfa kanalını gri tonlamalı görüntü olarak yükle 2 = Görüntüyü ve alfa kanalını yükle (alfayı 8 bitle sınırla) 3 = Görüntüyü yükle (görüntüyü kanal başına 8 bitle sınırla) 4 = Alfa kanalını yükle (kanal başına 8 bitle sınırla) 5 = Görüntüyü alfa kanalıyla yükle (ikisini de kanal başına 8 bitle sınırla) 6 = Görüntüyü ve alfa kanalını yükle 7 = Görüntüyü ve ICC renk profilini yükle 8 = Yüksek bit derinliğini koruyarak görüntüyü, alfa kanalını ve ICC renk profilini yükle Diğer görüntü türlerinde bu parametre 0 olarak ayarlanmalıdır. Options değerini -1 yapmak TIFF, EMF ve WMF görüntülerinin GDI+ grafik kitaplığıyla yüklenmesini zorlar. Çok sayfalı TIFF görüntüleri Options parametresi -PageNumber yapılarak da GDI+ ile yüklenebilir (örneğin sayfa 3 için -3)

InStream

Görüntü verilerini içeren TStream nesnesi. Akıştaki geçerli konum yok sayılır; görüntü verileri akışın 0 konumundan okunur

Options

Çok sayfalı TIFF görüntülerinde bu parametre yüklenecek sayfa numarasını belirtir. PNG görüntülerinde: 0 = Görüntüyü olağan biçimde yükle 1 = Alfa kanalını gri tonlamalı görüntü olarak yükle 2 = Görüntüyü ve alfa kanalını yükle (alfayı 8 bitle sınırla) 3 = Görüntüyü yükle (görüntüyü kanal başına 8 bitle sınırla) 4 = Alfa kanalını yükle (kanal başına 8 bitle sınırla) 5 = Görüntüyü alfa kanalıyla yükle (ikisini de kanal başına 8 bitle sınırla) 6 = Görüntüyü ve alfa kanalını yükle 7 = Görüntüyü ve ICC renk profilini yükle 8 = Yüksek bit derinliğini koruyarak görüntüyü, alfa kanalını ve ICC renk profilini yükle Diğer görüntü türlerinde bu parametre 0 olarak ayarlanmalıdır. Options değerini -1 yapmak TIFF, EMF ve WMF görüntülerinin GDI+ grafik kitaplığıyla yüklenmesini zorlar. Çok sayfalı TIFF görüntüleri Options parametresi -PageNumber yapılarak da GDI+ ile yüklenebilir (örneğin sayfa 3 için -3)

Dönüş değerleri

0	Akıştan geçerli görüntü verileri okunurken hata oluştu Görüntü belgeye başarıyla eklendi. Döndürülen değer, DrawImage gibi görüntü çizim işlevleriyle kullanılabilecek görüntü kimliğidir
Non-zero