AddImageFromFileOffsetA
Obsługa obrazów
Opis
Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddImageFromFileOffset, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode
Dodaje obraz z części pliku do wybranego dokumentu
Jeśli na przykład wiele obrazów połączono w jeden plik, ta funkcja umożliwia wyodrębnienie poszczególnych obrazów i dodanie ich do 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: BMP, TIFF, JPEG, PNG, GIF, WMF i EMF
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, AddImageFromFileOffset 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 DLAddImageFromFileOffsetA(InstanceID: Integer; FileName: PAnsiChar; Offset, DataLength, Options: Integer): Integer;DLL
int DLAddImageFromFileOffsetA(int InstanceID, const char * FileName, int Offset, int DataLength, int Options);Parametry
| FileName | Nazwa pliku zawierającego obrazy |
|---|---|
| Offset | Przesunięcie w pliku, od którego zaczyna się wymagany obraz. Pierwszy bajt pliku ma przesunięcie 0 |
| DataLength | Długość danych obrazu w bajtach |
| 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. 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 odczytać obrazu z pliku. Może to oznaczać nieprawidłowe dane obrazu lub brak pliku |
|---|---|
| Non-zero | Obraz został odczytany z pliku i pomyślnie dodany do dokumentu. Zwrócona wartość jest identyfikatorem obrazu używanym z funkcjami rysowania obrazów, takimi jak DrawImage |