AddImageFromString

Görüntü işleme

Açıklama

Bellekteki bir görüntüyü seçili belgeye 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ü verilerini içe aktarmak PDF 1.5 gerektirir. Bir belge PDF 1.4 veya daha düşük bir sürüme ayarlandığında ve kayıt sürümü kilitli olmadığında AddImageFromString, belgeyi otomatik olarak PDF 1.5'e yükseltir ve 16-bit image samples değerini AutoBumpedFeatures içinde kaydeder. Çağıran daha düşük bir kayıt sürümünü kilitlerse uyumluluk kapısı kaydı 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

Parametreler

Source	Görüntü verilerini içeren bir dize. Kitaplığın ActiveX sürümünde bu dize 16 bitlik karakterler içermelidir; her karakterin yalnızca düşük 8 biti kullanılır
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)

Source

Görüntü verilerini içeren bir dize. Kitaplığın ActiveX sürümünde bu dize 16 bitlik karakterler içermelidir; her karakterin yalnızca düşük 8 biti kullanılır

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	Görüntü verileri geçersizdi veya görüntü desteklenmeyen biçimdeydi Görüntü başarıyla eklendi. Döndürülen değer SelectImage ve DrawImage gibi işlevlerle kullanılabilen ImageID değeridir
1