AddImageFromString

Obsługa obrazów

Opis

Dodaje obraz z pamięci 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, AddImageFromString 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.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

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

Parametry

Source	Ciąg zawierający dane obrazu. W wersji ActiveX biblioteki ciąg musi zawierać znaki 16-bitowe; używane jest tylko dolne 8 bitów każdego znaku
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)

Source

Ciąg zawierający dane obrazu. W wersji ActiveX biblioteki ciąg musi zawierać znaki 16-bitowe; używane jest tylko dolne 8 bitów każdego znaku

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	Dane obrazu były nieprawidłowe lub obraz miał nieobsługiwany format Obraz został pomyślnie dodany. Zwrócona wartość to ImageID używany z funkcjami takimi jak SelectImage i DrawImage
1