AddImageFromStream

Obsługa obrazów

Opis

Dodaje obraz ze strumienia TStream 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, AddImageFromStream 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.AddImageFromStream(InStream: TStream; Options: Integer): Integer;

Parametry

InStream	Obiekt TStream zawierający dane obrazu. Bieżąca pozycja w strumieniu zostanie zignorowana; dane obrazu będą odczytywane od pozycji 0
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)

InStream

Obiekt TStream zawierający dane obrazu. Bieżąca pozycja w strumieniu zostanie zignorowana; dane obrazu będą odczytywane od pozycji 0

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	Wystąpił błąd podczas odczytywania prawidłowych danych obrazu ze strumienia Obraz został pomyślnie dodany do dokumentu. Zwrócona wartość jest identyfikatorem obrazu używanym z funkcjami rysowania obrazów, takimi jak DrawImage
Non-zero