DetectPageBarcodesJSON

Распознавание штрихкодов, инспекция документов, рендеринг

Описание

Распознает поддерживаемые одномерные и двумерные штрихкоды на всей странице или в ограниченной области и возвращает детерминированный JSON с декодированным содержимым и геометрией в координатах страницы

Синтаксис

Delphi

Function TPDFlib.DetectPageBarcodesJSON(Page: Integer;
  Left, Top, Width, Height, DPI: Double; Formats: Integer= 0;
  Options: Integer= 0; MaxResults: Integer= 32): WideString;

ActiveX

Function PDFlib::DetectPageBarcodesJSON(Page As Long,
  Left As Double, Top As Double, Width As Double, Height As Double,
  DPI As Double, Formats As Long, Options As Long,
  MaxResults As Long) As String

DLL

const wchar_t* DLDetectPageBarcodesJSON(int InstanceID, int Page,
  double Left, double Top, double Width, double Height, double DPI,
  int Formats, int Options, int MaxResults);
const char* DLDetectPageBarcodesJSONA(int InstanceID, int Page,
  double Left, double Top, double Width, double Height, double DPI,
  int Formats, int Options, int MaxResults);

Параметры

Page	Номер страницы, начиная с 1
Left, Top	Начало области в пунктах пользовательского пространства страницы от левого верхнего угла
Width, Height	Размер области в пунктах пользовательского пространства страницы; нули во всех четырёх значениях сканируют всю страницу
DPI	Разрешение рендеринга от 24 до 2400 после применения `RenderScale`; ноль выбирает 300 DPI
Formats	Маска констант `PDF_BARCODE_FORMAT_*`: `PDF_BARCODE_FORMAT_AZTEC`, `PDF_BARCODE_FORMAT_CODABAR`, `PDF_BARCODE_FORMAT_CODE39`, `PDF_BARCODE_FORMAT_CODE93`, `PDF_BARCODE_FORMAT_CODE128`, `PDF_BARCODE_FORMAT_DATABAR`, `PDF_BARCODE_FORMAT_DATABAR_LIMITED`, `PDF_BARCODE_FORMAT_DATABAR_EXPANDED`, `PDF_BARCODE_FORMAT_DATAMATRIX`, `PDF_BARCODE_FORMAT_EAN8`, `PDF_BARCODE_FORMAT_EAN13`, `PDF_BARCODE_FORMAT_ITF`, `PDF_BARCODE_FORMAT_MAXICODE`, `PDF_BARCODE_FORMAT_PDF417`, `PDF_BARCODE_FORMAT_QRCODE`, `PDF_BARCODE_FORMAT_MICRO_QRCODE`, `PDF_BARCODE_FORMAT_RM_QRCODE`, `PDF_BARCODE_FORMAT_UPCA`, `PDF_BARCODE_FORMAT_UPCE` и `PDF_BARCODE_FORMAT_DX_FILM_EDGE`; ноль выбирает `PDF_BARCODE_FORMAT_ANY` (все форматы)
Options	A mask of `PDF_BARCODE_TRY_HARDER`, `PDF_BARCODE_PURE`, `PDF_BARCODE_RETURN_ERRORS`, `PDF_BARCODE_DISABLE_ROTATE`, `PDF_BARCODE_DISABLE_INVERT`, and `PDF_BARCODE_DISABLE_DOWNSCALE`
MaxResults	Максимальное число результатов от 1 до 255

Возвращаемые значения

Возвращает JSON-объект со страницей, эффективным DPI, запрошенной областью, числом результатов и объектами результатов с formatName, text, типом содержимого, идентификатором символики, уровнем коррекции ошибок, ориентацией, флагами валидности, четырьмя угловыми точками в системе страницы и границами. При сбое валидации, растеризации, загрузки бэкенда или распознавания возвращает пустую строку

Возвращает пустую строку, если не удались проверка, рендеринг, загрузка серверной части или распознавание

Примечания

Метод рендерит только запрошенную область в ограниченный битмап BGR сверху вниз и восстанавливает ранее выбранную страницу перед возвратом

Метод растеризует только запрошенную область в ограниченный BGR-битмап с направлением сверху вниз и восстанавливает ранее выбранную страницу перед возвратом. Разверните PDFlibBarcode32.dll или PDFlibBarcode64.dll рядом с исполняемым файлом хоста, DLL PDFlib или модулем ActiveX согласно разрядности процесса; PDFLIB_BARCODE_READER может задать альтернативный абсолютный путь к бэкенду

LastErrorCode возвращает 115 при некорректных странице, геометрии, масках, разрешении или лимитах и 519 при сбоях рендеринга, движка или распознавания

См. также

RenderPageRegionToFile, DrawBarcode, LastErrorCode