AddImageDirectFromString
Obsługa obrazów
Opis
Tworzy obraz XObject bezpośrednio z już zakodowanych bajtów próbek obrazu zamiast wykrywać format kontenera, taki jak PNG, TIFF lub JPEG
Zachowanie wersji PDF: filtr obrazu JBIG2Decode wymaga PDF 1.4, natomiast JPXDecode, Crypt oraz próbki obrazu z BitsPerComponent = 16 wymagają PDF 1.5. Gdy dokument ma wersję niższą od wymaganej, a wersja zapisu nie jest zablokowana, AddImageDirectFromString automatycznie podnosi wersję dokumentu i zapisuje JBIG2Decode filter, JPXDecode filter, Crypt filter lub 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
Składnia
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;Parametry
| Source | Surowe lub zakodowane dane obrazu zapisywane w strumieniu obrazu |
|---|---|
| Width | Szerokość obrazu w pikselach |
| Height | Wysokość obrazu w pikselach |
| BitsPerComponent | Liczba bitów na składową próbki. Słowniki obrazów PDF we wcześniejszych wersjach dopuszczają 1, 2, 4 i 8; próbki 16-bitowe należą do PDF 1.5 |
| ColorSpace | Nazwa przestrzeni kolorów PDF lub tekst tablicy dla słownika obrazu, na przykład /DeviceGray, /DeviceRGB albo tablica indeksowanej przestrzeni kolorów |
| Filter | Nazwa filtru strumienia PDF, na przykład FlateDecode, DCTDecode lub JPXDecode. Dla danych bez filtru użyj pustego ciągu |
| Decode | Opcjonalny tekst tablicy PDF Decode. Przekaż pusty ciąg, gdy wpis Decode nie jest potrzebny |
| Interpolate | Wartość niezerowa zapisuje flagę /Interpolate true |
Wartości zwracane
| 0 | Nie można utworzyć obrazu albo bieżący tryb PDF/A zabrania żądanego filtru |
|---|---|
| Non-zero | Nowy ImageID. Utworzony obraz zostaje wybrany do kolejnych operacji na obrazach |
Uwagi
Tryb PDF/A odrzuca LZWDecode we wszystkich częściach oraz JBIG2Decode / JPXDecode w PDF/A-1. Kod wywołujący odpowiada za zgodność bajtów Source z zadeklarowanymi wartościami ColorSpace, Filter, Decode, wymiarami i głębią próbek
Zobacz również
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage