AddImageFromFile

Görüntü işleme

Açıklama

Seçilen belgeye bir dosyadan 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ü 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 AddImageFromFile, 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.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

Parametreler

FileName	Eklenecek görüntünün dosya adı
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)

FileName

Eklenecek görüntünün dosya adı

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ü eklenemedi. Bulunamamış veya desteklenmeyen bir biçimde olabilir
Non-zero	Görüntü başarıyla eklendi. SelectImage ve DrawImage gibi işlevlere geçirilebilen ImageID döndürülür