AddImageFromFileOffsetA

Görüntü işleme

Açıklama

Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış AddImageFromFileOffset ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır

Bir dosyanın bir bölümündeki görüntüyü seçili belgeye ekler

Örneğin çok sayıda görüntü tek bir dosyada art arda birleştirilmişse bu işlev ayrı görüntülerin çıkarılıp belgeye eklenmesini sağlar

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 şunlardır: BMP, TIFF, JPEG, PNG, GIF, WMF ve EMF

PDF sürümü davranışı: bileşen başına 16 bit görüntü verilerini içe aktarmak PDF 1.5 gerektirir. Belge PDF 1.4 veya daha düşük bir sürüme ayarlanmışsa ve kaydetme sürümü kilitli değilse AddImageFromFileOffset belgeyi otomatik olarak PDF 1.5'e yükseltir ve 16-bit image samples değerini AutoBumpedFeatures içine kaydeder. Çağıran daha düşük bir kaydetme 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 DLAddImageFromFileOffsetA(InstanceID: Integer; FileName: PAnsiChar; Offset, DataLength, Options: Integer): Integer;

DLL

int DLAddImageFromFileOffsetA(int InstanceID, const char * FileName, int Offset, int DataLength, int Options);

Parametreler

FileName	Görüntüleri içeren dosyanın adı
Offset	Gerekli görüntünün başladığı dosya uzaklığı. Dosyadaki ilk baytın uzaklığı 0'dır
DataLength	Görüntü verilerinin bayt cinsinden uzunluğu
Options	Çok sayfalı TIFF görüntüleri için bu parametre yüklenecek sayfa numarasını belirtir. PNG görüntüleri için: 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 bit ile sınırla) 3 = Görüntüyü yükle (görüntüyü kanal başına 8 bit ile sınırla) 4 = Alfa kanalını yükle (kanal başına 8 bit ile sınırla) 5 = Görüntüyü alfa kanalıyla yükle (ikisini de kanal başına 8 bit ile 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 Diğer görüntü türleri için bu parametre 0 olarak ayarlanmalıdır. Options değerini -1 yapmak TIFF, EMF ve WMF görüntülerini GDI+ grafik kütüphanesiyle yüklemeye zorlar. Çok sayfalı TIFF görüntüleri, Options parametresi -PageNumber yapılarak da GDI+ ile yüklenebilir (örneğin 3. sayfa için -3)

Dönüş değerleri

0	Görüntü dosyadan okunamadı. Bu, görüntü verilerinin geçersiz olduğunu veya dosyanın bulunamadığını gösterebilir
Non-zero	Görüntü dosyadan okundu ve belgeye başarıyla eklendi. Döndürülen değer, DrawImage gibi görüntü çizim işlevleriyle kullanılabilen görüntü kimliğidir