AddImageFromFile

Obsługa obrazów

Opis

Dodaje obraz z pliku do wybranego dokumentu

Po dodaniu obrazu do dokumentu można go wielokrotnie rysować na dowolnej stronie bez dalszego zwiększania rozmiaru pliku PDF

Obsługiwane typy plików obrazów to BMP, TIFF, JPEG, PNG, GIF, WMF, EMF i WebP, a także AVIF, HEIF, HEIC i JPEG XL, gdy dostępny jest nowoczesny dekoder obrazów

Zachowanie wersji PDF: importowanie danych obrazu z 16 bitami na składową wymaga PDF 1.5. Gdy dokument ma ustawione PDF 1.4 lub starsze, a wersja zapisu nie jest zablokowana, AddImageFromFile automatycznie podnosi dokument do PDF 1.5 i zapisuje 16-bit image samples w AutoBumpedFeatures. Jeśli kod wywołujący zablokuje niższą wersję zapisu, kontrola zgodności odrzuci zapis z LastErrorCode 602

W przypadku obrazów BMP i TIFF przed wywołaniem tej funkcji można wywołać CompressImages, aby skompresować dane obrazu. Obrazy innych typów są kompresowane automatycznie

Składnia

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);

Parametry

FileName	Nazwa pliku obrazu do dodania
Options	Dla wielostronicowych obrazów TIFF parametr określa numer strony do wczytania. Dla obrazów PNG: 0 = wczytaj obraz normalnie 1 = wczytaj kanał alfa jako obraz w skali szarości 2 = wczytaj obraz i kanał alfa (ogranicz alfa do 8 bitów) 3 = wczytaj obraz (ogranicz obraz do 8 bitów/kanał) 4 = wczytaj kanał alfa (ogranicz do 8 bitów/kanał) 5 = wczytaj obraz z kanałem alfa (ogranicz oba do 8 bitów/kanał) 6 = wczytaj obraz i kanał alfa 7 = wczytaj obraz oraz profil kolorów ICC 8 = wczytaj obraz, kanał alfa i profil ICC z zachowaniem dużej głębi bitowej. Dla innych typów obrazów parametr powinien mieć wartość 0. Ustawienie Options na -1 wymusza wczytanie obrazów TIFF, EMF i WMF za pomocą biblioteki graficznej GDI+. Wielostronicowe obrazy TIFF można również wczytywać przez GDI+, ustawiając Options na -PageNumber (na przykład -3 dla strony 3)

FileName

Nazwa pliku obrazu do dodania

Options

Dla wielostronicowych obrazów TIFF parametr określa numer strony do wczytania. Dla obrazów PNG: 0 = wczytaj obraz normalnie 1 = wczytaj kanał alfa jako obraz w skali szarości 2 = wczytaj obraz i kanał alfa (ogranicz alfa do 8 bitów) 3 = wczytaj obraz (ogranicz obraz do 8 bitów/kanał) 4 = wczytaj kanał alfa (ogranicz do 8 bitów/kanał) 5 = wczytaj obraz z kanałem alfa (ogranicz oba do 8 bitów/kanał) 6 = wczytaj obraz i kanał alfa 7 = wczytaj obraz oraz profil kolorów ICC 8 = wczytaj obraz, kanał alfa i profil ICC z zachowaniem dużej głębi bitowej. Dla innych typów obrazów parametr powinien mieć wartość 0. Ustawienie Options na -1 wymusza wczytanie obrazów TIFF, EMF i WMF za pomocą biblioteki graficznej GDI+. Wielostronicowe obrazy TIFF można również wczytywać przez GDI+, ustawiając Options na -PageNumber (na przykład -3 dla strony 3)

Wartości zwracane

0	Nie można dodać obrazu. Nie znaleziono go albo ma nieobsługiwany format
Non-zero	Obraz został pomyślnie dodany. Zwrócony ImageID można przekazać do funkcji takich jak SelectImage i DrawImage