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	应用 `RenderScale` 后介于 24 到 2400 的渲染分辨率，零选择 300 DPI
Formats	由 `PDF_BARCODE_FORMAT_*` 常量组成的掩码；零会选择 `PDF_BARCODE_FORMAT_ANY`
Options	由 `PDF_BARCODE_TRY_HARDER`、`PDF_BARCODE_PURE`、`PDF_BARCODE_RETURN_ERRORS`、`PDF_BARCODE_DISABLE_ROTATE`、`PDF_BARCODE_DISABLE_INVERT` 和 `PDF_BARCODE_DISABLE_DOWNSCALE` 组成的掩码
MaxResults	结果数量上限，范围为 1 至 255

返回值

返回一个 JSON 对象，其中包含页面、有效 DPI、请求区域、结果数量，以及带有 formatName、text、内容类型、符号体系标识符、纠错级别、方向、有效性标志、四个页面空间角点和边界的结果对象

验证、渲染、后端加载或识别失败时返回空字符串

备注

该方法仅将请求区域渲染为受限的自上而下 BGR 位图，并在返回前恢复此前选定的页面

根据进程架构，将 PDFlibBarcode32.dll 或 PDFlibBarcode64.dll 部署在主机可执行文件、PDFlib DLL 或 ActiveX 模块旁；PDFLIB_BARCODE_READER 可指定替代的绝对后端路径

页面、几何参数、蒙版、分辨率或限制无效时，LastErrorCode 为 115；渲染、后端或识别失败时为 519

另请参阅

RenderPageRegionToFile, DrawBarcode, LastErrorCode