AddImageJBIG2FromFileEx

Obrazy

Opis

Wczytuje plik bitmapy, konwertuje go na monochromatyczne dane obrazu i zapisuje jako obraz XObject JBIG2 przy użyciu nazwanych parametrów opcji

Składnia

Delphi

Function TPDFlib.AddImageJBIG2FromFileEx(Const FileName: WideString; Interpolate, SymbolExtract, UseExternalEncoder, SkipBlackDots, BlackDotSize, LossyLevel: Integer): Integer;

Parametry

FileName	Plik bitmapy do zakodowania
Interpolate	Zapisuje flagę interpolacji obrazu, gdy wartość jest niezerowa
SymbolExtract	Żąda wyodrębnienia słownika symboli, gdy aktywny mechanizm kodujący je obsługuje
UseExternalEncoder	Preferuje zewnętrzny mechanizm kodujący JBIG2, gdy jest dostępny
SkipBlackDots	Włącza usuwanie odizolowanych czarnych kropek przed kodowaniem, gdy wartość jest niezerowa
BlackDotSize	Maksymalny rozmiar odizolowanego skupiska czarnych pikseli usuwanego podczas oczyszczania
LossyLevel	Wskazówka intensywności oczyszczania od 0 do 9 dla zeskanowanych danych monochromatycznych

Wartości zwracane

Zwraca nowy ImageID albo 0, gdy nie można odczytać lub zakodować pliku

Uwagi

Funkcja odwzorowuje nazwane parametry na tę samą ścieżkę kodowania, której używa AddImageJBIG2FromFile, zachowując zgodność z istniejącymi maskami bitowymi opcji

Rejestracja backendów JBIG2

Koder stojący za rodziną AddImageJBIG2* i dekoder używany dla obrazów JBIG2 w importowanych dokumentach są wymienne. Moduł PDFlibJBIG2Enc udostępnia powierzchnię rejestracji jako samodzielne funkcje:

`RegisterJBIG2EncoderBackend`	Instaluje `TJBIG2EncodeCallback`, który otrzymuje linie skanowania, szerokość, wysokość i rekord `TJBIG2EncodeOptions`, a zwraca skompresowane dane obrazu i opcjonalne dane segmentu globalnego; obsługuje żądanie `UseExternalEncoder` przekazywane przez opisaną poniżej opcję
`RegisterJBIG2DecoderBackend`	Instaluje podstawowy `TJBIG2DecodeCallback`, który otrzymuje bajty obrazu i dane globalne oraz wypełnia rekord `TJBIG2DecodeResult`
`RegisterJBIG2ExternalDecoderBackend`	Rejestruje zewnętrzny backend dekodowania (dekoder C jbig2dec na Win64). Gdy jest zarejestrowany, a przełącznik preferencji zewnętrznego dekodera jest włączony (domyślnie), ścieżka wczytywania `/JBIG2Decode` przechodzi przez niego, a podstawowy dekoder pozostaje rezerwowy
`ClearJBIG2Backends`	Usuwa wszystkie zarejestrowane callbacki koderów i dekoderów
`IsJBIG2EncoderBackendAvailable` / `IsJBIG2DecoderBackendAvailable` / `IsJBIG2ExternalDecoderBackendAvailable`	Raportują, czy odpowiedni callback jest obecnie zarejestrowany
`SetPreferExternalJBIG2Decoder` / `GetPreferExternalJBIG2Decoder`	Globalny przełącznik wybierający zewnętrzny dekoder zamiast wbudowanego dekodera w Pascalu, gdy oba są dostępne; domyślnie `True`, ustaw `False`, aby wymusić natywny wariant rezerwowy
`DefaultJBIG2EncodeOptions`	Zwraca rekord `TJBIG2EncodeOptions` zainicjowany wartościami domyślnymi, od których startują wywołania `AddImageJBIG2*` (bezstratnie, słownik symboli włączony, segmenty globalne wyłączone, preferowany koder zewnętrzny)
`ClearJBIG2DecodeResult`	Zwalnia pamięć linii skanowania należącą do rekordu `TJBIG2DecodeResult` i resetuje jego pola