VintaSoft Barcode .NET SDK 16.0: Документация для Веб разработчика
Vintasoft.Barcode Namespace / WebBarcodeReaderJS type / readBarcodes Property
Синтаксис Exceptions Совместимость с браузерами Смотрите также
В этом разделе
    readBarcodes Метод
    В этом разделе
    Отправляет асинхронный запрос на сервер для распознавания штрих-кодов с веб изображения.
    Синтаксис
    var instance = new Vintasoft.Barcode.WebBarcodeReaderJS(service);
    
    var value; // Type: any
    
    // Parameters
    var image; // Type: WebImageJS
    var successFunc; // Type: function
    var errorFunc; // Type: function
    
    value = instance.readBarcodes(image, successFunc, errorFunc);
    
    
    function readBarcodes(
    image
    Экземпляр класса WebImageJS.
    : WebImageJS,
    successFunc
    Функция, которая будет выполнена в случае успешного выполнения запроса.
    Вот прототип функции "function __success(data)".
    Параметр data имеет следующие свойства:
    • results (object): Массив результатов распознавания штрих-кодов.
      Результат распознавания представляет собой объект со следующими свойствами:
      • barcodeType (string): Тип штрих-кода.
      • value (string): Значение штрих-кода.
      • hexValue (string): Значение штрих-кода в шестнадцатеричном представлении.
      • confidence (string): Уверенность в результате распознавания штрих-кода.
      • readingQuality (number): Качество распознавания штрих-кода.
      • threshold (number): Порог, который был применен к изображению во время распознавания штрих-кодов.
      • region (object): Область изображения, где обнаружен штрих-код. Область изображения имеет следующие свойства:
        • angle (число): Угол в градусах относительно вектора (1,0).
        • leftTop (object): Координата левой-верхней точки ограничивающего прямоугольника.
        • leftBottom (object): Координата левой-нижней точки ограничивающего прямоугольника.
        • rightTop (object): Координата правой-верхней точки ограничивающего прямоугольника.
        • rightBottom (object): Координата правой-нижней точки ограничивающего прямоугольника.
      • additionalInfo (object): Ассоциативный массив, содержащий имена и значения пользовательских свойств штрих-кода.
      • test (object): Результат теста качества печати штрих-кода.
        Это может быть тест качества печати штрих-кода по стандарту ISO15415:
        • decode (object): Значение и оценка декодирования.
        • maxReflectance (object): Максимальный коэффициент отражения в процентах от значения и оценки.
        • minReflectance (object): Минимальный коэффициент отражения в процентах от значения и оценки.
        • symbolContrast (object): Значение и оценка контрастности символов.
        • modulation (object): Значение и оценка модуляции.
        • scanGrade (object): Оценка и значение сканирования.
        • axialNonuniformity (object): Значение и оценка осевой неравномерности.
        • gridNonuniformity (object): Значение и оценка неравномерности сетки.
        • unusedErrorCorrection (object): Неиспользуемое значение и оценка коррекции ошибок.
        • reflectanceMargin (object): Значение и оценка запаса отражательной способности.
        • quietZone (object): Тихая зона, значение в процентах, требующая указания символики штрих-кода и оценки.
        • distortionAngle (object): Угол искажения значения матрицы штрих-кода и оценка.
        • additionalGrades (object): Массив дополнительных оценок, зависящих от символики штрих-кода.
        • fixedPatternDamage (object): Значение и оценка повреждения фиксированного шаблона.
        • codewordYield (object): Эффективность, с которой линейное сканирование может восстанавливать данные из двухмерного многострочного символа, значение и оценка.
        • codewordPrintQualityModulation (object): Значение и оценка качества печати кодового слова на основе модуляции кодового слова для двухмерного многострочного символа.
        • codewordPrintQualityDefects (object): Значение и оценка качества печати кодового слова на основе дефектов кодового слова для двухмерного многострочного символа.
        • codewordPrintQualityDecodability (object): Значение и оценка качества печати кодового слова на основе возможности декодирования кодового слова для двухмерного многострочного символа.
        • codewordPrintQuality (object): Значение и оценка качества печати кодового слова для двухмерного многострочного символа.
        • startPattern (object): Результат теста шаблона Start/RAP по стандарту ISO15516 для многострочных символик (PDF417/MicroPDF417).
        • centerPattern (object): Результат теста шаблона Center/RAP по стандарту ISO15516 для многострочных символик (MicroPDF417).
        • stopPattern (object): Результат теста шаблона Stop/RAP по стандарту ISO15516 для многострочные символики (PDF417/MicroPDF417).
        ИЛИ это может быть:
        • tests (object): Массив тестов качества печати штрих-кодов ISO15416.
          Тесты качества печати штрих-кодов ISO15416 содержат:
          • decode (object): Значение и оценка декодирования.
          • maxReflectance (object): Максимальное значение отражательной способности в процентах от значения и оценки отражательной способности.
          • minReflectance (object): Минимальное значение отражательной способности в процентах от значения и оценки отражательной способности.
          • globalThreshold (object): Глобальный порог (GT) в процентах от значения и оценки отражательной способности.
          • symbolContrast (object): Значение и оценка контраста символов.
          • minEdgeContrast (object): Минимальный контраст края (ECmin) в процентах от значения и оценки отражательной способности.
          • modulation (object): Значение и оценка модуляции.
          • defects (object): Значение и оценка дефектов.
          • decodability (object): Значение и оценка декодируемости.
          • scanGrade (object): Оценка и значение сканирования.
      Для одномерного штрих-кода имеются следующие свойства:
      • narrowBarCount (number): Количество узких полос.
      • narrowBarSize (number): Размер узкой полосы в пикселях.
      Для двумерного штрих-кода имеются следующие свойства:
      • matrixSize (object): Размер матрицы штрих-кода в модулях (ячейках).
      • cellSize (object): Размер ячейки матрицы штрих-кода в пикселях.
      • bulleyeCenter (object): Центр Шаблон поиска "Bulleye" для ацтекского штрих-кода.
    • recognitionTime (число): Время распознавания штрих-кодов в миллисекундах.
    : Function,
    errorFunc
    Функция, которая будет выполнена в случае неудачного запроса.
    Вот прототип функции "function __error(data)".
    Параметр 'data' может быть:
    1. Объект с следующими свойствами:
      • errorMessage (string): Сообщение о ошибке.
      • blocked (boolean): Указывает, что запрошенное действие заблокировано другим запросом.
      , если исключение перехватывается внутри веб сервиса.
    2. В противном случае объект jqXHR.
    : Function
    ) : any;

    Parameters

    image
    Экземпляр класса WebImageJS.
    successFunc
    Функция, которая будет выполнена в случае успешного выполнения запроса.
    Вот прототип функции "function __success(data)".
    Параметр data имеет следующие свойства:
    • results (object): Массив результатов распознавания штрих-кодов.
      Результат распознавания представляет собой объект со следующими свойствами:
      • barcodeType (string): Тип штрих-кода.
      • value (string): Значение штрих-кода.
      • hexValue (string): Значение штрих-кода в шестнадцатеричном представлении.
      • confidence (string): Уверенность в результате распознавания штрих-кода.
      • readingQuality (number): Качество распознавания штрих-кода.
      • threshold (number): Порог, который был применен к изображению во время распознавания штрих-кодов.
      • region (object): Область изображения, где обнаружен штрих-код. Область изображения имеет следующие свойства:
        • angle (число): Угол в градусах относительно вектора (1,0).
        • leftTop (object): Координата левой-верхней точки ограничивающего прямоугольника.
        • leftBottom (object): Координата левой-нижней точки ограничивающего прямоугольника.
        • rightTop (object): Координата правой-верхней точки ограничивающего прямоугольника.
        • rightBottom (object): Координата правой-нижней точки ограничивающего прямоугольника.
      • additionalInfo (object): Ассоциативный массив, содержащий имена и значения пользовательских свойств штрих-кода.
      • test (object): Результат теста качества печати штрих-кода.
        Это может быть тест качества печати штрих-кода по стандарту ISO15415:
        • decode (object): Значение и оценка декодирования.
        • maxReflectance (object): Максимальный коэффициент отражения в процентах от значения и оценки.
        • minReflectance (object): Минимальный коэффициент отражения в процентах от значения и оценки.
        • symbolContrast (object): Значение и оценка контрастности символов.
        • modulation (object): Значение и оценка модуляции.
        • scanGrade (object): Оценка и значение сканирования.
        • axialNonuniformity (object): Значение и оценка осевой неравномерности.
        • gridNonuniformity (object): Значение и оценка неравномерности сетки.
        • unusedErrorCorrection (object): Неиспользуемое значение и оценка коррекции ошибок.
        • reflectanceMargin (object): Значение и оценка запаса отражательной способности.
        • quietZone (object): Тихая зона, значение в процентах, требующая указания символики штрих-кода и оценки.
        • distortionAngle (object): Угол искажения значения матрицы штрих-кода и оценка.
        • additionalGrades (object): Массив дополнительных оценок, зависящих от символики штрих-кода.
        • fixedPatternDamage (object): Значение и оценка повреждения фиксированного шаблона.
        • codewordYield (object): Эффективность, с которой линейное сканирование может восстанавливать данные из двухмерного многострочного символа, значение и оценка.
        • codewordPrintQualityModulation (object): Значение и оценка качества печати кодового слова на основе модуляции кодового слова для двухмерного многострочного символа.
        • codewordPrintQualityDefects (object): Значение и оценка качества печати кодового слова на основе дефектов кодового слова для двухмерного многострочного символа.
        • codewordPrintQualityDecodability (object): Значение и оценка качества печати кодового слова на основе возможности декодирования кодового слова для двухмерного многострочного символа.
        • codewordPrintQuality (object): Значение и оценка качества печати кодового слова для двухмерного многострочного символа.
        • startPattern (object): Результат теста шаблона Start/RAP по стандарту ISO15516 для многострочных символик (PDF417/MicroPDF417).
        • centerPattern (object): Результат теста шаблона Center/RAP по стандарту ISO15516 для многострочных символик (MicroPDF417).
        • stopPattern (object): Результат теста шаблона Stop/RAP по стандарту ISO15516 для многострочные символики (PDF417/MicroPDF417).
        ИЛИ это может быть:
        • tests (object): Массив тестов качества печати штрих-кодов ISO15416.
          Тесты качества печати штрих-кодов ISO15416 содержат:
          • decode (object): Значение и оценка декодирования.
          • maxReflectance (object): Максимальное значение отражательной способности в процентах от значения и оценки отражательной способности.
          • minReflectance (object): Минимальное значение отражательной способности в процентах от значения и оценки отражательной способности.
          • globalThreshold (object): Глобальный порог (GT) в процентах от значения и оценки отражательной способности.
          • symbolContrast (object): Значение и оценка контраста символов.
          • minEdgeContrast (object): Минимальный контраст края (ECmin) в процентах от значения и оценки отражательной способности.
          • modulation (object): Значение и оценка модуляции.
          • defects (object): Значение и оценка дефектов.
          • decodability (object): Значение и оценка декодируемости.
          • scanGrade (object): Оценка и значение сканирования.
      Для одномерного штрих-кода имеются следующие свойства:
      • narrowBarCount (number): Количество узких полос.
      • narrowBarSize (number): Размер узкой полосы в пикселях.
      Для двумерного штрих-кода имеются следующие свойства:
      • matrixSize (object): Размер матрицы штрих-кода в модулях (ячейках).
      • cellSize (object): Размер ячейки матрицы штрих-кода в пикселях.
      • bulleyeCenter (object): Центр Шаблон поиска "Bulleye" для ацтекского штрих-кода.
    • recognitionTime (число): Время распознавания штрих-кодов в миллисекундах.
    errorFunc
    Функция, которая будет выполнена в случае неудачного запроса.
    Вот прототип функции "function __error(data)".
    Параметр 'data' может быть:
    1. Объект с следующими свойствами:
      • errorMessage (string): Сообщение о ошибке.
      • blocked (boolean): Указывает, что запрошенное действие заблокировано другим запросом.
      , если исключение перехватывается внутри веб сервиса.
    2. В противном случае объект jqXHR.
    Исключения
    ИсключениеОписание
    Выбрасывается, если аргументы имеют неверные типы.
    Совместимость с веб браузерами
    9
    5
    11
    5
    Смотрите также