AddImageJBIG2FromFileEx
Изображения
Описание
Загружает растровый файл, преобразует его в монохромные данные изображения и сохраняет его как XObject изображения JBIG2, используя именованные параметры параметров
Синтаксис
Delphi
Function TPDFlib.AddImageJBIG2FromFileEx(Const FileName: WideString; Interpolate, SymbolExtract, UseExternalEncoder, SkipBlackDots, BlackDotSize, LossyLevel: Integer): Integer;Параметры
| FileName | Кодируемый файл битмапа |
|---|---|
| Interpolate | Записывает флаг интерполяции изображения, если значение отлично от нуля |
| SymbolExtract | Запрашивает извлечение словаря символов, если активный бэкенд кодировщика поддерживает это |
| UseExternalEncoder | Предпочитает внешний бэкенд кодировщика JBIG2 при его наличии |
| SkipBlackDots | Включает очистку изолированных черных точек перед кодированием, если значение отлично от нуля |
| BlackDotSize | Максимальный размер кластера изолированных черных пикселей, удаляемых при очистке |
| LossyLevel | Указание агрессивности очистки от 0 до 9 для сканированного монохромного ввода |
Возвращаемые значения
Возвращает новый ImageID, 0 — если файл не читается или не кодируется
Примечания
Функция сопоставляет именованные параметры с тем же путем кодирования, который используется в AddImageJBIG2FromFile, что сохраняет совместимость с существующими битовыми масками опций
Регистрация бэкендов JBIG2
Кодировщик, стоящий за семейством AddImageJBIG2*, и декодер, используемый для изображений JBIG2 в импортируемых документах, подключаемые. Модуль PDFlibJBIG2Enc предоставляет поверхность регистрации в виде автономных функций:
RegisterJBIG2EncoderBackend | Устанавливает TJBIG2EncodeCallback, который получает строки развертки, ширину, высоту и запись TJBIG2EncodeOptions, а возвращает сжатые данные изображения и необязательные данные глобального сегмента; обслуживает запрос UseExternalEncoder, передаваемый через описанную ниже опцию |
|---|---|
RegisterJBIG2DecoderBackend | Устанавливает основной TJBIG2DecodeCallback, который получает байты изображения и глобальные данные и заполняет запись TJBIG2DecodeResult |
RegisterJBIG2ExternalDecoderBackend | Регистрирует внешний декодирующий бэкенд (C-декодер jbig2dec на Win64). Если он зарегистрирован и переключатель предпочтения внешнего декодера включен (по умолчанию), путь загрузки /JBIG2Decode идет через него, а основной декодер остается запасным |
ClearJBIG2Backends | Удаляет все зарегистрированные callback-и кодировщиков и декодеров |
IsJBIG2EncoderBackendAvailable / IsJBIG2DecoderBackendAvailable / IsJBIG2ExternalDecoderBackendAvailable | Сообщают, зарегистрирован ли соответствующий callback в данный момент |
SetPreferExternalJBIG2Decoder / GetPreferExternalJBIG2Decoder | Глобальный переключатель, выбирающий внешний декодер вместо встроенного декодера на Pascal, когда доступны оба; по умолчанию True, задайте False, чтобы принудительно использовать штатный запасной вариант |
DefaultJBIG2EncodeOptions | Возвращает запись TJBIG2EncodeOptions, инициализированную значениями по умолчанию, от которых стартуют вызовы AddImageJBIG2* (без потерь, словарь символов включен, глобальные сегменты выключены, предпочитается внешний кодировщик) |
ClearJBIG2DecodeResult | Освобождает память строк развертки, принадлежащую записи TJBIG2DecodeResult, и сбрасывает её поля |