From aa99d700400a75fcbc22c4007dc36fcc42f3fb56 Mon Sep 17 00:00:00 2001 From: Shijin V Date: Mon, 8 Jan 2024 17:26:35 +0530 Subject: [PATCH] Jan 08: [ADD] Initial Commit 'pos_receipt_extend' --- pos_receipt_extend/README.rst | 45 + pos_receipt_extend/__init__.py | 22 + pos_receipt_extend/__manifest__.py | 46 + pos_receipt_extend/doc/RELEASE_NOTES.md | 7 + pos_receipt_extend/models/__init__.py | 25 + pos_receipt_extend/models/account_move.py | 102 + pos_receipt_extend/models/pos_config.py | 58 + pos_receipt_extend/models/pos_order.py | 52 + pos_receipt_extend/models/pos_session.py | 62 + .../static/description/assets/icons/check.png | Bin 0 -> 3676 bytes .../description/assets/icons/chevron.png | Bin 0 -> 310 bytes .../static/description/assets/icons/cogs.png | Bin 0 -> 1377 bytes .../description/assets/icons/consultation.png | Bin 0 -> 1458 bytes .../description/assets/icons/ecom-black.png | Bin 0 -> 576 bytes .../assets/icons/education-black.png | Bin 0 -> 733 bytes .../description/assets/icons/hotel-black.png | Bin 0 -> 911 bytes .../description/assets/icons/license.png | Bin 0 -> 1095 bytes .../description/assets/icons/lifebuoy.png | Bin 0 -> 1199 bytes .../assets/icons/manufacturing-black.png | Bin 0 -> 673 bytes .../description/assets/icons/pos-black.png | Bin 0 -> 878 bytes .../description/assets/icons/puzzle.png | Bin 0 -> 653 bytes .../assets/icons/restaurant-black.png | Bin 0 -> 905 bytes .../assets/icons/service-black.png | Bin 0 -> 839 bytes .../assets/icons/trading-black.png | Bin 0 -> 427 bytes .../description/assets/icons/training.png | Bin 0 -> 627 bytes .../description/assets/icons/update.png | Bin 0 -> 1225 bytes .../static/description/assets/icons/user.png | Bin 0 -> 988 bytes .../description/assets/icons/wrench.png | Bin 0 -> 1205 bytes .../description/assets/misc/categories.png | Bin 0 -> 1532 bytes .../description/assets/misc/check-box.png | Bin 0 -> 1118 bytes .../description/assets/misc/compass.png | Bin 0 -> 1931 bytes .../description/assets/misc/corporate.png | Bin 0 -> 1177 bytes .../assets/misc/customer-support.png | Bin 0 -> 2136 bytes .../description/assets/misc/cybrosys-logo.png | Bin 0 -> 4496 bytes .../description/assets/misc/features.png | Bin 0 -> 589 bytes .../static/description/assets/misc/logo.png | Bin 0 -> 3452 bytes .../description/assets/misc/pictures.png | Bin 0 -> 1692 bytes .../description/assets/misc/pie-chart.png | Bin 0 -> 2338 bytes .../description/assets/misc/right-arrow.png | Bin 0 -> 967 bytes .../static/description/assets/misc/star.png | Bin 0 -> 1642 bytes .../description/assets/misc/support.png | Bin 0 -> 3892 bytes .../description/assets/misc/whatsapp.png | Bin 0 -> 5097 bytes .../static/description/assets/modules/1.png | Bin 0 -> 58469 bytes .../static/description/assets/modules/2.png | Bin 0 -> 59649 bytes .../static/description/assets/modules/3.png | Bin 0 -> 61221 bytes .../static/description/assets/modules/4.png | Bin 0 -> 58986 bytes .../static/description/assets/modules/5.png | Bin 0 -> 56919 bytes .../static/description/assets/modules/6.png | Bin 0 -> 59590 bytes .../description/assets/screenshots/hero.gif | Bin 0 -> 187618 bytes .../assets/screenshots/pos_receipt_06.png | Bin 0 -> 56112 bytes .../assets/screenshots/pos_receipt_07.png | Bin 0 -> 54978 bytes .../assets/screenshots/pos_receipt_08.png | Bin 0 -> 55425 bytes .../assets/screenshots/receipt1.png | Bin 0 -> 142770 bytes .../assets/screenshots/receipt2.png | Bin 0 -> 141592 bytes .../assets/screenshots/receipt3.png | Bin 0 -> 141697 bytes .../static/description/banner.png | Bin 0 -> 82238 bytes .../static/description/icon.png | Bin 0 -> 8025 bytes .../static/description/index.html | 696 + pos_receipt_extend/static/src/js/payment.js | 70 + pos_receipt_extend/static/src/lib/zxing.js | 24234 ++++++++++++++++ .../static/src/xml/OrderReceipt.xml | 42 + pos_receipt_extend/views/assets.xml | 10 + pos_receipt_extend/views/pos_config_views.xml | 104 + .../views/pos_receipt_template.xml | 22 + 64 files changed, 25597 insertions(+) create mode 100755 pos_receipt_extend/README.rst create mode 100755 pos_receipt_extend/__init__.py create mode 100755 pos_receipt_extend/__manifest__.py create mode 100755 pos_receipt_extend/doc/RELEASE_NOTES.md create mode 100755 pos_receipt_extend/models/__init__.py create mode 100644 pos_receipt_extend/models/account_move.py create mode 100755 pos_receipt_extend/models/pos_config.py create mode 100644 pos_receipt_extend/models/pos_order.py create mode 100755 pos_receipt_extend/models/pos_session.py create mode 100755 pos_receipt_extend/static/description/assets/icons/check.png create mode 100755 pos_receipt_extend/static/description/assets/icons/chevron.png create mode 100755 pos_receipt_extend/static/description/assets/icons/cogs.png create mode 100755 pos_receipt_extend/static/description/assets/icons/consultation.png create mode 100755 pos_receipt_extend/static/description/assets/icons/ecom-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/education-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/hotel-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/license.png create mode 100755 pos_receipt_extend/static/description/assets/icons/lifebuoy.png create mode 100755 pos_receipt_extend/static/description/assets/icons/manufacturing-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/pos-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/puzzle.png create mode 100755 pos_receipt_extend/static/description/assets/icons/restaurant-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/service-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/trading-black.png create mode 100755 pos_receipt_extend/static/description/assets/icons/training.png create mode 100755 pos_receipt_extend/static/description/assets/icons/update.png create mode 100755 pos_receipt_extend/static/description/assets/icons/user.png create mode 100755 pos_receipt_extend/static/description/assets/icons/wrench.png create mode 100755 pos_receipt_extend/static/description/assets/misc/categories.png create mode 100755 pos_receipt_extend/static/description/assets/misc/check-box.png create mode 100755 pos_receipt_extend/static/description/assets/misc/compass.png create mode 100755 pos_receipt_extend/static/description/assets/misc/corporate.png create mode 100755 pos_receipt_extend/static/description/assets/misc/customer-support.png create mode 100755 pos_receipt_extend/static/description/assets/misc/cybrosys-logo.png create mode 100755 pos_receipt_extend/static/description/assets/misc/features.png create mode 100755 pos_receipt_extend/static/description/assets/misc/logo.png create mode 100755 pos_receipt_extend/static/description/assets/misc/pictures.png create mode 100755 pos_receipt_extend/static/description/assets/misc/pie-chart.png create mode 100755 pos_receipt_extend/static/description/assets/misc/right-arrow.png create mode 100755 pos_receipt_extend/static/description/assets/misc/star.png create mode 100755 pos_receipt_extend/static/description/assets/misc/support.png create mode 100755 pos_receipt_extend/static/description/assets/misc/whatsapp.png create mode 100644 pos_receipt_extend/static/description/assets/modules/1.png create mode 100644 pos_receipt_extend/static/description/assets/modules/2.png create mode 100644 pos_receipt_extend/static/description/assets/modules/3.png create mode 100644 pos_receipt_extend/static/description/assets/modules/4.png create mode 100644 pos_receipt_extend/static/description/assets/modules/5.png create mode 100644 pos_receipt_extend/static/description/assets/modules/6.png create mode 100644 pos_receipt_extend/static/description/assets/screenshots/hero.gif create mode 100644 pos_receipt_extend/static/description/assets/screenshots/pos_receipt_06.png create mode 100644 pos_receipt_extend/static/description/assets/screenshots/pos_receipt_07.png create mode 100644 pos_receipt_extend/static/description/assets/screenshots/pos_receipt_08.png create mode 100644 pos_receipt_extend/static/description/assets/screenshots/receipt1.png create mode 100644 pos_receipt_extend/static/description/assets/screenshots/receipt2.png create mode 100644 pos_receipt_extend/static/description/assets/screenshots/receipt3.png create mode 100644 pos_receipt_extend/static/description/banner.png create mode 100644 pos_receipt_extend/static/description/icon.png create mode 100755 pos_receipt_extend/static/description/index.html create mode 100755 pos_receipt_extend/static/src/js/payment.js create mode 100644 pos_receipt_extend/static/src/lib/zxing.js create mode 100755 pos_receipt_extend/static/src/xml/OrderReceipt.xml create mode 100644 pos_receipt_extend/views/assets.xml create mode 100755 pos_receipt_extend/views/pos_config_views.xml create mode 100755 pos_receipt_extend/views/pos_receipt_template.xml diff --git a/pos_receipt_extend/README.rst b/pos_receipt_extend/README.rst new file mode 100755 index 000000000..06ece1640 --- /dev/null +++ b/pos_receipt_extend/README.rst @@ -0,0 +1,45 @@ +.. image:: https://img.shields.io/badge/licence-LGPL--3-blue.svg + :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html + :alt: License: LGPL-3 + +Advanced POS Receipt +======================= +Enhance pos receipt by adding more details. + +Configuration +============= +No configuration + +Company +------- +* `Cybrosys Techno Solutions `__ + +License +------- +General Public License, Version 3 (LGPL v3). +(http://www.gnu.org/licenses/lgpl-3.0-standalone.html) + +Credits +------- +Developers: (V14) Mruthul Raj @cybrosys +Contact: odoo@cybrosys.com + +Contacts +-------- +* Mail Contact : odoo@cybrosys.com +* Website : https://cybrosys.com + +Bug Tracker +----------- +Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. + +Maintainer +========== +.. image:: https://cybrosys.com/images/logo.png + :target: https://cybrosys.com +This module is maintained by Cybrosys Technologies. +For support and more information, please visit `Our Website `__ + +Further information +=================== +HTML Description: ``__ \ No newline at end of file diff --git a/pos_receipt_extend/__init__.py b/pos_receipt_extend/__init__.py new file mode 100755 index 000000000..7b2c59c1c --- /dev/null +++ b/pos_receipt_extend/__init__.py @@ -0,0 +1,22 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +from . import models diff --git a/pos_receipt_extend/__manifest__.py b/pos_receipt_extend/__manifest__.py new file mode 100755 index 000000000..4cabee4cb --- /dev/null +++ b/pos_receipt_extend/__manifest__.py @@ -0,0 +1,46 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +{ + 'name': 'Advanced POS Receipt', + 'version': '14.0.1.0.0', + 'category': 'Point of Sale', + 'summary': 'Enhance pos receipt by adding more details.', + 'description': 'Advanced POS Receipt with Customer Details, Invoice Details ' + 'and QR Code', + 'author': 'Cybrosys Techno Solutions', + 'company': 'Cybrosys Techno Solutions', + 'maintainer': 'Cybrosys Techno Solutions', + 'website': 'https://www.cybrosys.com', + 'depends': ['point_of_sale'], + 'data': [ + 'views/pos_config_views.xml', + 'views/assets.xml', + ], + 'qweb': [ + 'static/src/xml/OrderReceipt.xml', + ], + 'images': ['static/description/banner.png'], + 'license': 'LGPL-3', + 'installable': True, + 'application': False, + 'auto_install': False, +} diff --git a/pos_receipt_extend/doc/RELEASE_NOTES.md b/pos_receipt_extend/doc/RELEASE_NOTES.md new file mode 100755 index 000000000..49fdb1991 --- /dev/null +++ b/pos_receipt_extend/doc/RELEASE_NOTES.md @@ -0,0 +1,7 @@ +## Module + +#### 08.01.2024 +#### Version 14.0.1.0.0 +#### ADD +- Initial commit for Advanced POS Receipt + \ No newline at end of file diff --git a/pos_receipt_extend/models/__init__.py b/pos_receipt_extend/models/__init__.py new file mode 100755 index 000000000..8d54c6977 --- /dev/null +++ b/pos_receipt_extend/models/__init__.py @@ -0,0 +1,25 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +from . import account_move +from . import pos_config +from . import pos_order +from . import pos_session diff --git a/pos_receipt_extend/models/account_move.py b/pos_receipt_extend/models/account_move.py new file mode 100644 index 000000000..e29a89a0c --- /dev/null +++ b/pos_receipt_extend/models/account_move.py @@ -0,0 +1,102 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +import math +import re +from odoo import api, fields, models + + +class AccountMove(models.Model): + """ + Extends 'account.move' model to add custom fields and methods related to + EAN generation and validation. + """ + _inherit = "account.move" + + account_barcode = fields.Char( + string='Account Barcode', + help='Barcode associated with the account move.') + + @api.model + def create(self, vals): + """ + Overrides the 'create' method to generate and assign a valid EAN13 + barcode to the account move. + vals: Dictionary of field values for creating the account move. + return: Created account move record with the assigned EAN13 barcode. + """ + res = super(AccountMove, self).create(vals) + ean = self.generate_ean(str(res.id)) + res.account_barcode = ean + return res + + def ean_checksum(self, eancode): + """ + Calculates the checksum digit of an EAN13 string. + eancode: EAN13 string without the last digit. + return: Checksum digit. + """ + if len(eancode) != 13: + return -1 + oddsum = 0 + evensum = 0 + eanvalue = eancode + reversevalue = eanvalue[::-1] + finalean = reversevalue[1:] + for i in range(len(finalean)): + if i % 2 == 0: + oddsum += int(finalean[i]) + else: + evensum += int(finalean[i]) + total = (oddsum * 3) + evensum + check = int(10 - math.ceil(total % 10.0)) % 10 + return check + + def check_ean(self, eancode): + """ + Checks if an EAN13 string is valid. + eancode: EAN13 string to be validated. + return: True if the EAN13 string is valid, False otherwise. + """ + if not eancode: + return True + if len(eancode) != 13: + return False + try: + int(eancode) + except: + return False + return eancode.ean_checksum(eancode) == int(eancode[-1]) + + def generate_ean(self, ean): + """ + Generates a valid EAN13 barcode from an input string. + ean: Input string for generating the EAN13 barcode. + return: Valid EAN13 barcode. + """ + if not ean: + return "0000000000000" + ean = re.sub("[A-Za-z]", "0", ean) + ean = re.sub("[^0-9]", "", ean) + ean = ean[:13] + if len(ean) < 13: + ean = ean + '0' * (13 - len(ean)) + return ean[:-1] + str(self.ean_checksum(ean)) diff --git a/pos_receipt_extend/models/pos_config.py b/pos_receipt_extend/models/pos_config.py new file mode 100755 index 000000000..607a580b7 --- /dev/null +++ b/pos_receipt_extend/models/pos_config.py @@ -0,0 +1,58 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +from odoo import fields, models + + +class PosConfig(models.Model): + """ + Extends the Point of Sale Configuration to add custom options. + """ + _inherit = "pos.config" + + is_qr_code = fields.Boolean(string='Order QRCode', + help='Enable this option to generate QR code ' + 'for orders.') + is_invoice_number = fields.Boolean(string='Invoice Number', + help='Enable this option to show ' + 'invoice number in the POS ' + 'interface.') + is_customer_details = fields.Boolean(string='Customer Details', + help='Enable this option to show ' + 'customer details section.') + is_customer_name = fields.Boolean(string='Customer Name', + help='Enable this option to show ' + 'customer name field.') + is_customer_address = fields.Boolean(string='Customer Address', + help='Enable this option to show ' + 'customer address field.') + is_customer_mobile = fields.Boolean(string='Customer Mobile', + help='Enable this option to show ' + 'customer mobile number field.') + is_customer_phone = fields.Boolean(string='Customer Phone', + help='Enable this option to show ' + 'customer phone number field.') + is_customer_email = fields.Boolean(string='Customer Email', + help='Enable this option to show ' + 'customer email field.') + is_customer_vat = fields.Boolean(string='Customer VAT', + help='Enable this option to show customer' + ' VAT number field.') diff --git a/pos_receipt_extend/models/pos_order.py b/pos_receipt_extend/models/pos_order.py new file mode 100644 index 000000000..050b0a67e --- /dev/null +++ b/pos_receipt_extend/models/pos_order.py @@ -0,0 +1,52 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +from odoo import api, fields, models + + +class PosOrder(models.Model): + """ + Extends 'pos.order' model to add custom fields and methods for invoice + generation. + """ + _inherit = 'pos.order' + + sale_barcode = fields.Char(string='Sale Barcode', + help='Barcode associated with the sale.') + + @api.model + def get_invoice(self, id): + """ + Get invoice details for a POS order. + id: POS order reference ID. + return: Invoice details including ID, name, base URL, and QR code. + """ + pos_id = self.search([('pos_reference', '=', id)]) + pos_id.action_pos_order_invoice() + base_url = self.env['ir.config_parameter'].get_param('web.base.url') + invoice_id = self.env['account.move'].search( + [('ref', '=', pos_id.name)]) + return { + 'invoice_id': invoice_id.id, + 'invoice_name': invoice_id.name, + 'base_url': base_url, + 'qr_code': invoice_id.account_barcode, + } diff --git a/pos_receipt_extend/models/pos_session.py b/pos_receipt_extend/models/pos_session.py new file mode 100755 index 000000000..df808d46a --- /dev/null +++ b/pos_receipt_extend/models/pos_session.py @@ -0,0 +1,62 @@ +# -*- coding: utf-8 -*- +############################################################################# +# +# Cybrosys Technologies Pvt. Ltd. +# +# Copyright (C) 2023-TODAY Cybrosys Technologies() +# Author: Cybrosys Techno Solutions() +# +# You can modify it under the terms of the GNU LESSER +# GENERAL PUBLIC LICENSE (LGPL v3), Version 3. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU LESSER GENERAL PUBLIC LICENSE (LGPL v3) for more details. +# +# You should have received a copy of the GNU LESSER GENERAL PUBLIC LICENSE +# (LGPL v3) along with this program. +# If not, see . +# +############################################################################# +from odoo import models + + +class PosSessionLoadFields(models.Model): + """ + Extends 'pos.session' model to load additional POS UI models and fields. + """ + _inherit = 'pos.session' + + def _pos_ui_models_to_load(self): + """ + Get the list of POS UI models to be loaded. + return: List of POS UI models to load. + """ + result = super()._pos_ui_models_to_load() + result += ['pos.config'] + return result + + def _loader_params_res_config_settings(self): + """ + Get the loader parameters for res.config.settings. + return: Loader parameters for res.config.settings. + """ + return { + 'search_params': { + 'fields': ['is_qr_code', 'is_invoice_number', + 'is_customer_name', + 'is_customer_address', 'is_customer_mobile', + 'is_customer_phone', 'is_customer_email', + 'is_customer_vat'], + }, + } + + def _get_pos_ui_pos_config(self, params): + """ + Get POS UI data for pos.config. + params: Loader parameters. + return: POS UI data for pos.config. + """ + return self.env['pos.config'].search_read( + **params['search_params']) diff --git a/pos_receipt_extend/static/description/assets/icons/check.png b/pos_receipt_extend/static/description/assets/icons/check.png new file mode 100755 index 0000000000000000000000000000000000000000..c8e85f51d612c626d167e4def7bccdbe1d6d17bd GIT binary patch literal 3676 zcmcgvdsGuw8jpg4iY%zK;)6~HwPkUVnaO)JDiRS~W01#+Tdm%CgiJ{?ab|#k+GElB zs)m`Fq^5i_*c#09+YQPFKr}nwM5Uo-TAL;V~rhtuFtx>&0g#C#25Hk&m#sUb-WA~31MBLg4ikrG=iSUHIid9Tb1 z9z?MSXrWNHppa=`3T|)6tVasU1O?OhfLBAPab-$=Aj^bs-a^skcg`{z&c(Sok1Rnf z5yC>1Y_<@*U9)a?2rbEDiXfxl+}cG;IVE0Blf_9wp~!G!ilE2DR$`Kz#XXhg1%^X- zXt38Q$b#e)IuIe${frbc@94mx((??I^YI-(m7WmPOQnh&kOeVE5L~UXliA7*Aqh2! zygrHdutKqvq)a?GfU^Rbv!F1L2n;u3q&9~jDV>4R8gLYj5g8$Gdf5;PM8e91VHO}tH2a0L8XijPj4WT@OfXUAT zJnhf*@K9tDMU;r4{0y>T@q!c#dc9U3Y|rFt)F2wJDdXk4$u2;9M#3=B({jWE?ZT8AH% zg#Ynm7{OD-iERSQ3q%07QcjdCs6!Oo2=IDcJmb$VO_7HU?ogqWL}USZT7WtfjpanX zO$@a45~6_o7yUgq;$EyC{@)i#qZ|N_R=_bJvw}bMOMXYUaeIWvk1PbW5LY2pwz5%~)8GxdCY^PssXRx5eoz zoO^~fem~r``@rOd6TkZU8il$gE8}Oz-;cgl{mIK`Pdv;QZ%-|s z|GM{J*isd7WKnONICtpgNp#AiUeQbceyF&&T9d++kK5LH+xFP3BM=)2;)S)A$sTiU6of)b*Y#j{o#0g@7kQ@$&^?Xwd#C) z*?`OMhxblls7-52Hx9e<G~?b~~OYW?LWQyXXH zri{BfJ2omM>(N5CCh8@jy!2dILd_cwrrn5}-u1H`e?0w$}WEW5P9XVW2;W}-E(N#mKb@>!_?9;7EcMc z{$}01S5Kra9GY1>s2abs9zQ>M^!2#Wa|ZgdtCP$7HxD_{=b{ky&9Q_CH6!ldap(T* zf}8Jcd_*M`3GY@f|5wb3WaRUu4KwLk^ZH)Cx@g9Gqrd$0VaEMIzioWH^;l}xdpp8T z8}{xXW=4I#;LY(#$DH;dANHu-yZ<(gnNzG17ONUnb$vS3 zb*fD2Tp8xe4);ae*%)~z`kF2F+Q6#SXw|Se#$N^e?zR2i*OIq99+Iy7|H~LN!Mc6) H^s@f|!zCx= literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/chevron.png b/pos_receipt_extend/static/description/assets/icons/chevron.png new file mode 100755 index 0000000000000000000000000000000000000000..2089293d6ad94cfc015cc0a8c07bb03efd4a689e GIT binary patch literal 310 zcmV-60m=S}P)fLA$g5CzAh99{FF(tp zz^tD4))$4c^0SZV9_X~njUYum@4i`~v!i=obU%PG(6q`OMK>{HG>r}*tHKc2@w+qg z7|l>B76qkX(U2E&K_1Nf!JbCtpGzwGSJ~CkU>QcDY&q>lnbwQm<|2>>iH5vL6qJIP zp;W{K-Snrb@Z2gLMVZAQQ5jU>DXT)0mtk@hpq-Sb{2q6{0V4Z;tNXT3P5=M^07*qo IM6N<$f_?6Y+W-In literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/cogs.png b/pos_receipt_extend/static/description/assets/icons/cogs.png new file mode 100755 index 0000000000000000000000000000000000000000..95d0bad62cf22361b148e1d6cefe2ceab605955d GIT binary patch literal 1377 zcmV-n1)lneP)lH5n~Zj$eiG;8wLI!*reT1_VfljL=sA}=JrOptsX2RfC&)+l61t|6JPeb$mZ z6v1wNClWXiLSlOh+mR64U7bjvhva*zJ0HRRaDbgl@(q$*^PYf*$fE&7)c&&!Rfm?&yLyFbQ?2&R6W6v@rWu!;bZU9|_! z4Je^Q5$r!vH2{)*ok-wK1%Wz7TG;LgvHhtN39JtxLC&_yAzs|bhFaWtFLrukMR}l_ zP~>z0rF26#(W+H@aXx?6lf(f454Uv()R+QrlZafX3t}g5wp6-Blj;u$XaE#h->+xC z005Fp0GtMpYoBiuo)VG0UP0_GltOix%1(%-bKgbA0o1pB3&6VoRs+}%fFWUi1MmQV zmjH~{WZwYT7ng4njIz1iD4PuYIM&NvU6NVO4kNuj`IZ(nzL#XTM^~@uFGT>-aT6dh zAgaP68%9MDu}+cu7uohT0RHqW9d8lhD-kJqd^i9;Rw)OT!X*D$Y?MvID9;=%I@23T z$~m4}V3f^0BG}d<_%@?#emG&81LI_NvTQ!T$gzGzil=|K?VCM%e*mZ`d`!0R--N(> zX_T!|fX{f;z6ZDfz>JL{bFu7UqLI0BExN7c!HmOYg;$V?QB4==-_|4!R<1p=W!b zXM0?cbrc+q5buUe#ZpdV?VzCxk-Rm+);3(wb8q`(#{e8FI_3z8RwJLQk>}&nRHK0| zNhvzkFo4$qbT=sr4i@y>Bdr`7j(HfwmH^uc7xH9%r%nnDB_ty3>&opGxGMoP9kf;< zd%_$N;{SC3V62>WZcCaxpx6frT|FlOj5R5zGbh3vrqY>j1H`{Bkt_d-PcIzGcOeS& z0OimpMB04AZ5M$FkksHx)9_uX*rDTKrDER^Aij2r>}i8vD4G(OFwKFYV|^yVP5w23 z`asH~GaMjZ={ojt!?Lb#lcy352^1ZBLpqIV|5 zLfz5N09ce%03XI(J-h5`5#>QuTr`wWt<}xj9|=Odm?U{1pyiQF6&>pYfaOUB0`PfX zSMHvKeKvO?5vfw7-bq{v4vAnDh^?3%L|Q@w6Pmd9iD(;0IfB{ww?bB5NS1mno@&9c zXC4%!P8Bklxq~Ew%%g071mXR`&iMY{dhWR!JtLt}njRD_-Cxi%N0X&qj~Nq_rI}Yn za8e0TJ(H#J00000NkvXXu0mjfE=YKA literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/consultation.png b/pos_receipt_extend/static/description/assets/icons/consultation.png new file mode 100755 index 0000000000000000000000000000000000000000..8319d4baa09d6afac9362dff318f63a0f96f555e GIT binary patch literal 1458 zcmV;j1x@;iP)fo-7eN@Nx;}%h)9e^5-C?E zsEH&b3Z#%2B-}L7v^LRRD&QZ8A<7MshM0yxF7rU)x4)gW;*vW;3 z#hX3&)M|C@Hzy`0dbVF71Cp#6E*?;(1E5ZgN|t#IpsRseZTS;fmL2OZ%G1F2%+iN5 z?1unK-3Ni+4&6W$B|ic7=Z$mSG;E8PyRX^_00(R zZhUjoBfjtdy_aS#1FePDP8??a5dOFCh z*MWRv)G@zc9y@oAQ6L5)gF{}MFZh1tt%7=2kn>q6`mgJDye)VpNyeX>nXy(;k)8%5c~P{u8)+YKOVK2Ka7pM_X}a`O zk#~c24MYp^y)u3b+*+!2>R#%t}=?wy_< zpYKn-%7CQNC`x``VuKC^f_Kx@zC4JDHDk0HCO^O4#RC{@^;{j6<{9 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/ecom-black.png b/pos_receipt_extend/static/description/assets/icons/ecom-black.png new file mode 100755 index 0000000000000000000000000000000000000000..a9385ff13f696e96d517a56ce2b2ff7d282c748a GIT binary patch literal 576 zcmV-G0>Ax5}Z)a!cc0ra5uqqg5lnhXD zTbP_`oKdQ!!sJxrjN&KdC#M>hn6H53Z@_@W06J)|I<5r7bODP7TpFfK@D$$y9ro1J z_#n7|3NU9+Eg3t67i6kk1G7mAm}&y~>LPq;59$DNz9rz_PKFAe2JQYcbvs+lNHw^F+;#7cCP*z(AJ2&$C0H1W+ddn*~CoC?@7snGmV!9 z<==r}6|tyA>`?)>6k{b=2d<=(_5rWxzxsKgUs~Q{+du)!y5s>SG|Pu>T2kaR7OcV&-NYURtom{p?~^a9V+ z7O-a3C?=EC%HIJ!R*hUb72^tZzf-`AuuDDSkJJnF?!xs=oN3JbnbTGPz&Os^S>dl1 z(84w;APbb-b_k@KC|~4YkNmz@^KPH*e34{*2J>2yF9_24A}NIoShST-^{Ye_(vLmm zd~pgm3F$kIkw;g)NYXe9tbV#5fWaonr$h>8ffe1h+u&f*`C7F2cl-b`l5Ye!`u+O= O0000##3Xw+{I#MbTYoZ-I?3FUBiCh!QRfyd*8S0 zzBhAFP*6~?-lzdrfLY+Hwprk^9?LDGz;$2=SdFk>z#U*LBaI?QQKD9e7VcUbxCb21 zK<^(;Xc0+8N7+;0G_au`qDwm1ixh;r_7XS;lzSn3Ks%r7fpFK}0T+SIX$T+G&OY=( zxNCJ_5*Q8nGpO{QD=gKm=?w>jvsI4EeCbfxmVgL)==l)8DLS{4AE!e?Z8#kPQdt|>qP=~ z0Jlc(3Gg?f*M1lL)`j_1YkWB%UdQh2b66h*ZnCzsy7n_B0ckvzW`}^r+Q1XwyiR6N z+Zb>`kF^u{kzSF3ZWCxE2%MHJ3h_5t<4fjdNthVL50AOsk~o%60t*2`LXkdVyV0$h z3!el&2Fvm1lW@sw^on`m-Vx`wwB6`P4R}rO zE6^)ow-A5YnfJ&y0Ye!WLUqzpz$M^$fY4`p?Mdxxh|Yg2?gAd7ipc|DXJ`UZ90Kkq z5IzMQOgng*oJH-CT;UDiOoqC=IL6w|-va-Bgt_N1s&c*2*98Ry1?!OCgV~htO4sqyP_dDm_d+wti*Wu|Jegr#e_!#{@68vYp!)bLlu6Zk`LG>4b) zEtVJfV|c&7EyFk1UEqgt9*;Njw1VZ>g|{(-Ih??2*p8dxr0-%j^2hNC#&IhqaU^nc z@$+Ql#-r}>$jwGuyQA&xajp}QpNYQgQvRX3un9j@9GJrg7>xWw!mm^1U#(2=6#lMo z|KQokEyJGV*$a3$^4H^V!vBQLO`Y#xXJTY1;rCX!>CE#}6@DtiPgnT82{)9?y|d)x z(wYD^;79DoMQqIQU*HgKi6iBw;@FUI9sNVmM#^uDbMB8mr2J(psR`f_e2lfYQ^?Pc zD*O(-j!VKyGmVpx8^nFlK|*>Q!@2nVHmt#iLfSnlYCO2 zdFMZq-%%fsUm+%4DcBAM@nlB#OJUtlu?=@5vKyk0-(~c{nEb2TSI|FD&|jC)U02XO zP_VtPpg&ess@n%zfz}7m^l)@9-pa_g6!iB9hqNkI7IY^HwJpfkw1vjiEIS#Wpt0?`HcKIp}DC=(*S1hNk)FAp#M3(Ph`2hp<^Rwd!~tF ztxuuW2aq1-#_&}}?@!(9I-!5fU3;7r`rs;-;>L{bUqXMKVkK5&4iq?1871GE)(+iE(2hg+zdgWT>s_5?n3yszX(6k07r<#7z+xi};Iw>y+AElqG*-EPDTmCjr_EtL l9oc+vR{1Wfk3Rkj{so);rk=IPI$i((002ovPDHLkV1j5u&D{V1 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/license.png b/pos_receipt_extend/static/description/assets/icons/license.png new file mode 100755 index 0000000000000000000000000000000000000000..a5869797ecaa7583c552c3bb7c9bce5910df78e0 GIT binary patch literal 1095 zcmV-N1i1T&P)?DLX z+1Y*BO%2WWvTu05Ki}`p`@J{sJ=nx1)&%L)P@|a%i#deKSU(9Ndee~mRtn|o9hqkt zsH)g_?j-1Oz*{rH&X9nd_6n5~S%#SclCXXhkhBHYOR<={+%T9HHm_+Rj=iH!?az_sX`LfziH+4|52SPxCd(lFQ#& zy}6O4ybXVUJ6qGPGqH9kZO+TqO1)ZNXdyA~iK zjU@8F177OZcQq)~$=N9vU#B7D6{_#K`1J!DzKA!x0H-08MD^1m@!Cu1^1Ay68A9JiW%_ zS;VTfBGKSzreWdMUn09>mmHnKrHDNn2a^cnnZ|MXDzMjuSf_9uLfT_HXSmEliE3?k zXG5qm?Zm1JIMsm2cnJK_V=hkE@UzgSfJcoDFQBI%WSu~xnTe+6cI1o%43w{m$eK<( z*6j^w>_69x>X$9vq!B%D)n2i2Fx3eCH`fw(T?A+}`>a(i3QK#4M*6$U2tPE#;4RnK z>mxwS8DJZNZzlfX70^76^jmNLyX*lJ7YEWlH{ zcu!SGBHwAI5D}|zA|-av#xj{i{y7^5SAdUFv(H6FZ!P*Haqu>f2gqsj_qOq~2-w*F zS(Vp;I|v^e^)8@E=esPmmg4ZVjs4>wpR8c|FGJSOYN$8)|IM@rI3xAI#QT>#L{?m_|*Crlo{0DLwqmu7G?&JUf N002ovPDHLkV1nf|8?OKW literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/lifebuoy.png b/pos_receipt_extend/static/description/assets/icons/lifebuoy.png new file mode 100755 index 0000000000000000000000000000000000000000..658d56cccfbc0e46060ad4850b9fc60c656baf18 GIT binary patch literal 1199 zcmV;g1W@~lP)K~!jg?OD%n8$}d;Z#;H3_Ux`{Y$>IOhC`GK2Z&mUBGl%91P8y|S)kfJ7y@Fv(h8fJTCuS1y-dl~V3Bn@u?h-V-e;5wUK!dy#X#2mo{Oe@Ws202*N! zUYebq1*Oz(7=|0J>pn(AT~tHi06fpT5Cp+8=UfzYF~>QdlTyCudEUcDqp?-Q3ClZy zh`8_jS1ilAN<>A)|0jSkVOiEy-}kQ++2pw<5YcQ91S^cOdS0R|Fvb>wAgB}3_lVdx zo@Z(pi+`PnCN6%2qaJh2n$9r_fQWby1S^wxWem84@B1sJuai*#Qp(HIeDX(8DwXO| z%F8CUnE~{Az4MH*g_Fz52gcZf=Xn=0?a~H`hylQ*oZNq<_}k0ls8Xpc6H#iiO$}f$ z7+lQz-Xr3jB4gvg7!%!YH+A(>1Bjw%(UgpcwAQ*+tJSUpz&ZeoCZ;U_SQA3r;GDOJ z$T;)HSw0bo%R@wVuh)CagoKDRBK{zR*fFtJO3f3|HAFNzMEd>yw@I~AqJ#bY{dp7T z002bv$W%N4fDmGbh<-J-uT(0DT8^y%5pku|M*#3XBv+M(*h9qcYPH&RL>!t5ih0Vt zUhhjHdIJES%P?;Pz-K~;bwmtD2ac^kEdHi}cmRNNMD(sw>ZYmi5uOi;=pD!w4*<{v zfK{c`>d}E?De;q!JM+w*2G6)Xkk{#{&dFU)|KBh!fb9Z)o)nlf5uR}Y zd|trusm)0`Mppsg1Ndk6r(q8O?g$}n6g)=1h>y{88Rl&O_*4k-$x*rHnJTQfhuU9KK{~ ze{gV+s3kFgxc1mJAwWb%MAv-ZUm~J%N@uP-7z~#3)Ik8So7O{0t+hLy&I_FLR}6^` z@phbH$Kh*4{3egHFbsdG*XzG0ji){Z*L5FjtyLbvcvB|f%{;ykQM#_XnP!t303zyA zsq`QZDWumnCUwuh==b}N5RuYsGT*~mt@c!Fo%$4}0j>3>Nw>~uBiXinKZ>Hx$z_=# zilR=d)w*wDYuue4X>6r_BNNeAsf38{WsIw8wR+FAJ7-+XA!5H;t=^mFN<>lA$s-;h zXEln5eaCU`PGe7Ktv4OVxtm8kK!NspT#NkddEOtDN@bZbcA|D8B1!;w=r~T1>a_U% zK%>#vBBJeXx4STU!I1-p7aW^eM`ao&dc|bh_WW=-{0Wl3r~lMizvej3Q$);_Ad@h$ zFS2H{DJ{#|0D#*mX186}-I$d4sUW^)U5g92(PHl7XX2Xm3}<-8@HhS0PsfeRnq&X~ N002ovPDHLkV1i;vH)8+* literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/manufacturing-black.png b/pos_receipt_extend/static/description/assets/icons/manufacturing-black.png new file mode 100755 index 0000000000000000000000000000000000000000..697eb0e9f2c06e40c9c720df7b80b8f6fac63b34 GIT binary patch literal 673 zcmV;S0$%-zP)xK~!jg?U=D^6hRope;$f(2!dRQAe>DQQeT=B*H{T+6R=CPGo?i; zwb3GCV`G=p7B(h-MB0d*S1Kujl2}+MniNSfJM7zGW^Qgb$r_ypLnbqCci)@+?wfB1 zGBPqU+Qfwk`Okp9XM78I>x?Y|Ll1WcSarsR1>c9|Nd%6=HgM!=YaZ@efV=JCJ_>M; z#tG_7>fmofHqbV*fwqwi6!_g1x2b_In2ly7f%_eJ0o+aC9sujWOnqs7*p2KnX7jli z;o6OCA9xO2jd1No_NTb+#z~0v;T`Z0zwl|`n*9F~cmiDUaJy7Xk_W&W{K7lHtvX^; z(Zj6p4`48cdl|FZyT#uaI>0^PBmPpQF;uv%TS5j@xaEcnsPI^=RU1CxAp>3Du_HWW zz$g4f4a9`I24ccp10CQ#@F~J=WS|GU0)9pwVB0W3xNXY`!W$Ww23{u$x9zmJwG4zl zNZM#Y1GyGz8>t31fw`hBIdgN;Ml!xCHr9#=MoC1iB|&YhBqA8G zu?X7OSOnBURJ8DgX)FXmEY-qi6Qc+|;sZf^#TXGy#8}J>ckeKJckY?{hP0VaJzj0X8RhK^60Y~Xz{&a9?$@^ z`*!wmV5Zy_F}!tF1}J$Bj0DI7)BwvuZXk8w60j{qaRkSJJyKzx5OU#xRG|a+LWHFb zOd6COC^gCslp0b8n(}BvP?neGfxW0~`7uN}P!H_L!mj|jfWyE~sgms!uaGmXN9#VL z&o{&wH`(XFRQ($pDUuL+1@xib4Gb0l2lVkR;3DeD8LS7k>f__UV1%mzx>4a$5ZEDf zFs9!N;)lCQb0feM2j7i5gwE^pjd8|FLg;tGbr&DyCbIB3L*hWI<61T88h);WH`i)_ z#w>i!kj#Nyz$P-ET7zx?XMsbOOtb!-1`Gk8B3ufXFR%lU=Ye?%_gs{PuhlItkT`G~ z*iYsNGy_*qE6PdWv?bF996`l@7wT=!Aca~OHVbSKIdC1d{b6GWSPEPQ9$MUMlmo*+ zzeDyaLI);$B1?p11lFKJCR&>;B)yV!00U$$m*(l#18adt5v~eYC$PgCrL2V#6Pa`s z8YOcQ*O0DT0KSqr0(GRrbsYE};VKANl_YcE0xA?5BdrDarup5doDk*PG&c?`vA8VaO=C>m4%I|X)lqm$yVLT0P+oIdY}GtOrO29vww9VSooqbBNnh zcu(I|YQ)0zb`*zp)aRe-TomMhG1NxyHQX;fPUPZ16kAXwMG|^ZYrnxPV4v0J8EW^T zsOZBl9Hv`x%N>1ggc$PASEFSIN{zAurN)2jfOsd(fgd5lQU?Y?lv>E=CtGh+0(VGG zWW%UGZ@o!Njc1h3(oB}@JmzAS!6!o=#PN)%o0h~rfH{E-AX#fBK07*qoM6N<$ Eg49ZXX8-^I literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/puzzle.png b/pos_receipt_extend/static/description/assets/icons/puzzle.png new file mode 100755 index 0000000000000000000000000000000000000000..65cf854e7ea72e36142ffc1a407bf2b8355cc85c GIT binary patch literal 653 zcmV;80&@L{P)9a`;n_Do>R91)@YfrZ;WIBYI)WE@w%y z7IC%30~nX`B(&|Bi6!}ZGuBf8IAM^ zQA&SX2=P2@*<+`kI7+k$-1A&gaYV-{Ks?g2#0TH?II!as;HNYK-X1sS_e0Z#CLzvF_5wZZ}7k)9y#mQhdC00000NkvXXu0mjfog*sX literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/restaurant-black.png b/pos_receipt_extend/static/description/assets/icons/restaurant-black.png new file mode 100755 index 0000000000000000000000000000000000000000..4a35eb939cf065c6f8cf83781a15f357348769da GIT binary patch literal 905 zcmV;419tq0P)?`PC*pLe{WG*jTWtl`Uu)I!h(oI7q&uZZ6pM-kw|Ur zMPftz3s_jOvBN@wkko<{5h@lmjYJTFNYSdk7WZDgxt))5&f8mkk}hV>Idh-qo-=c2 z<}K*Z0h|JE0{hdxYd{s)k+v@ZXMrAIo@0zw;4N@F7c(R11%8u|tpdl>{-S`voX=~= zI9qe}3E(2Iz)Gr4;kyl(s~mqF&>XN=fMdX2piMb8pcAmd@&I7Dz-K#&h$ije8Ud@c zgQt)P0N6-UPAX^wv}*@XAr$~{fXT%{gxOL;d7J^}NS&nu>IqNA5SA(ZHvoI3&Qbww zBrApmt%jI`Qb(zPr3MliEX(6AgxqFAfF%PhK$pZ(DxlHPm#x|JJ?#vOh0iFWL*gX; zvNkySP6D04&a{0VI7IUG&7=5n`XhX%X!6%0pdIMTwKt`IMHB^02%jlh^`s@_+Eq$X zUua7+@KNF<74Svq=fdYgTbhAkiIY^oW1*i5PYP{`fFHnsWN@i~VW3~=Tf~(@TO!~V ziHK=MH!#NJVMOxR&(xQ+UJ$o$y2)oaLNW;@b@MoYxa>1*DRX}LjYb1P&7s^nlmWWk=>z*h>g|NU{%5MtF5CHx% zsv|6})E_wVDBiwF?G1#>YfMYTD&SYd?mLjjCb;?_Zxs-Gkk1|~y%8;uG6am{&rq!N z-f4+g1^f)yLT_-QuCw0J!G4)Cg3XY f0eA)+t%bl}x(3Cqe?`Zc00000NkvXXu0mjfu`-q5 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/service-black.png b/pos_receipt_extend/static/description/assets/icons/service-black.png new file mode 100755 index 0000000000000000000000000000000000000000..301ab51cb1363cb8a0063c4f9f7cb9cf73c91e10 GIT binary patch literal 839 zcmV-N1GxN&P)wG}3wsU*IR)z|Z&+>zafrqJwCq*x@FjvNVI2F^z|C zN%{bO#A+2K9mjI&psYL^8b1O*HWO0*iAfK zwBzye?BGqTEZN2s-YR-iRRhR^{{@@H!rmxCX)mp)h^Mf|a7g;p*wW?ud=J0RL?CEP zkEcMj#QI2Tc@Mv*2kEq`DKw7vdi=Jb&-aer)!-Z0qjz+QFK@N1&aRXO}`izA!9+A#$97UmLtKG(#D$V@JG;R0Xua%1u4_kNMazOP^ayYznp(_+pa zmHp&*7l9|T=r9&<9@|?Ko;a_$GXn6R3= z-_eWeE8>!NN6sWQh>p|@{|B~~h0NN}OyO(k|0o{Eevvy?ir79Q%G}xZ=i2u5tSHu2 zwf(N(bFnYJT6O^a^n}=lCZF8Nx;w2}uUkB4XPd5v`7Z>im~HzdJMCK7trz|-8@38>5jc3xX@h`{ zh@iEj_%)@#V~J@-!i)2n-XCy!_SC5Qyigi**PVuC+h<}!~>FElyR+PxP0svs|A}^vKikR z#>I0>S!0;4UyI{*IK1PzbOF;IshL(A_k5A?+#7WY^+>e^YX;p z=xW)DcRQbIOIo!~v-$kABZfD^J?Ag~CjG!0N_ye{SWo@7I2vn7n(V-R~kb-3M9=yBBG68O-n8v2ber%t!Zu Pq0ivy>gTe~DWM4f&Ev8V literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/training.png b/pos_receipt_extend/static/description/assets/icons/training.png new file mode 100755 index 0000000000000000000000000000000000000000..884ca024d71ca9127a5393134632ee92a61b07c4 GIT binary patch literal 627 zcmV-(0*w8MP)Ji_yZ6G zgCi9sC+SZOF3B?A-3o?c9a^B`5B^xi{atdGlsx zfu5coC)9d9*W)+29w+CYx6HE5(7FIXTmz`}IuU&auvT&%3np6<$3JExZ8|Qv1`yF6 z{uK`ZBO-bN;C9iN>oGlP1At#74phASP()5l1Dq?6>v00$qR~ktYISg_G~Q>PN9l*Pyjm+=0joaxS5K;Rj(=Ddy)iyD^P2j9tz7$MRPPN-6X6Ic< zC{O?T4(yVQo5t(DjmAqa0UQ-9Bj}SmO~ZA+0wO7a=S3S8?~`nFrw($EDaoG!IQ?TF zt|2?U(I}QLQFZXyQiDB8SX$~v-8kVA@YGU+KFk?f>fJUiwWsHQ*BQQneoi* zIdjgY7w2;~&-47A-}lQiGr#AVfgU}2^thi$w2V8gP8xe`iYA|^nQ(?HLC@=`7Uk<}) zLeWEQiU$yZ^@<(}ZFDXOrZ=@2KTECwL3TGYp{o5;VR!&Zenfb(Y~lunk>o@WhF_@a z!ghmmZ=oQx3ZUrTMV_|@z*@URl_LrpnuMspmx02LayE1`&DBGH7 zIB$fJR!y{I;6E2v5gyA7yJ&>%uIrAsk}Qk0c3q+z1eRyI&Umi#qKMSynj`laxQDEG z$>9=BWqAjWxCde)_&ZYtQ_uHfppNAb)C&iMgDG4Yayz-APl492qWnZ z+2s4qPerk;Qd zRTxgcUKCf(0QEW%Si8S$d^23v9Y;Bm$|Jh7D5kUlU|v?DQjz!5DcCSIHI;o!&C;0x zy1x?jTA~w;DMb2S$s6C7*Wr6^*LJGyqHt8;>Dg;xBk)zTu^q3#d?0F4bwS{Xys;0Y z0b}%PxF6sy{*u>yU@TD!7kg>wn=-H#OA+vz;H27KSYpwM_&kp%X2ny`^Yp0@|(y-wyRtOEu) zkZMr2S!>sIk}ylBD^a-LQPoOlqjSJ;L-U^%BWoPTxn4GDGXiV(qm1VDmv{z1L}Jvu zn`vGi$NH_RE@&E5g2~Cr0o8JExjDBIzCUyV^vhJEFcOB*@hFO_Ws){xtzG=^;Lve_ zQnzMHdm+ztcL8TpjlxKr=$THQiK!@hAyIz4N4%2V3+2+10THPgVGEG`aJ3>)#)7~e zj-qI|S!^?IMA7OXjJ}pce+C{;_v(adyt>r~yRAcuwRTCOd=IQ`K0+rHj*6O7#^_|N zR=ZNIR{yzq^QL#_j;<2XwFs{P&o>X}q=;_wJnsh7KQIfj8}c9GwohHEy0HGyN#1EU zwtz&CPhEFtR77q!cFdS4^%iP|h}3+~+kwg^h2P66zKc$%k(WHr*_9O!^)V)55l)iG=bkroSVWSt8oK?9X|oC&>t|S94mi~JQz6J@L4Q+~({Wt+ nVe#UD%iYS|qeqV(_m6)8sc^)gW+q6200000NkvXXu0mjfv*t}m literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/icons/user.png b/pos_receipt_extend/static/description/assets/icons/user.png new file mode 100755 index 0000000000000000000000000000000000000000..6ffb23d9f036834a32954f83bcfeca00790ee443 GIT binary patch literal 988 zcmV<210(#2P)cAU zg%n1_!UO~hi=Zajq!7VI@CUR>p`!Rx*a$&o3k`~bXb@RtC1&nyR*WQ@xp&s=+|MHZ z%qBDA%sD6P7W>?P9RqF}kWv6&A-zOAepFK7 zn%moe*=$Tc@)I0INT*#4Q(tpt!c>;Iw0DH*Nr(MZj6)>|hd7}=D`NRPh zXvGuSy!q^~M868;^;_^453rHAwcCa0XTYMJUi@XTxY>o~XCPvW7k?SF)lGsQoZDZQ zP)=G_j{)g77n-L5oA={)hSIDH&Cfs)ee1>VM9F4cXnqDNc7ia=s32eb!iDI$gsOi4 zLvKEpLvw7Jbc*9=pw+k^81;$)fYoTt-RZ*gtblIt<9DK%bYb~+p`ZNt9gylSG|w)y z^f7S3E5=1EFtYA*7owK|ZMZhYc+MxrUpVY~%?xuR%hGp%`<%$)6(zO(uDSg$G#5pD z;K6<0FLeNz{gRNEPQuWq)1OJI*Gp=<<_=N;X(Gq;tOM~GAMp_MS;a)29s}JqVCIjM z)b8=k8|EJXBpK4+2QuS_5P5?c0HB~e#B8sn^Ebj8h&ak%8{2szdo@hTfKXDKM!FmH zW1nf?P!ziqZws=70=&$bXf^g?93W~xqS9P$i-O)xkbdQkw>_W_=3j zHL&MZ+4h#Vli`J@6>FxCSeAZmS!$N0X3g}h<>^5?bLOg^ymRRmYovK~+eD>9insPXvj3+6Gb@v&hmf9xq1t2!EP|dQ8Gk{Nb(_%F zfZ2)l~DhpZ1%x!dRjm zO=;u!cb$X1D_}gv>Jbl6rqq7)(!s6*&8$S;I1dcnm#;8RsZyKh9Ozzw#ra8ApLl@n zmu`~X4VYcGB63`?zPU_W_r4w%$5|}xSP?5ge^6@en%S9MO4}qmpBLGc z+0FjUY-Um~^1{NNbKdiv_nq_2d}juhaAqNAYGGAPQ!by+?CdIx=|Q!EF@IoLzlew* zHqN3N&|>jiL`D#~5!H3TiYBy2#kO~cjhT*5UTf&o)WxJyJAvB(gK7(+j!7;TT0A7Y z1FE_V&)W$+3}iZx$0V2A6?Kio3}~@vBQg$L-C2d~l5BRYn{^UNAuSXJ5cvdH*O{zi zV%uGb2Qb}EY>Q0hdBTeCB5i_*J%!Y9hB4-|&cua_ha`5unC%@oF^Pv{Qs|lv<4<)f zUXLH|SJ!zQN!xgltnuI zA*#cGrK&x(v3Ly_Q|`zSxko)OA2y^qPL@<^KO#f_bvjN$1}w`3PIqAS3hH^A zP<=n*vz)54C3ehdJM0g+#tCDPU9e*A9n+;vw!rRxEBni5 z)-Ry*UUp(jA$8sBfPFx3TrnGPh-`L9MCxAWV%Y)pyc>XbNlyG}DwX>i#X}4RsyFRk zVEIC0wZTI&IM}qlEXaTsi?^UUPIBUXU{q}T#a4t=w~?!r^mSlaglPrljv8T7?RP}( z65D>Q9jU9ESY3A%*b`~K>IAlZtB6c%p|F}v<_biHP`wm58|VX$0ly;h9+vfvh)j11 z8_9sG3ZAzI7>zOy_>^pRvxuCEIIkl@7qaR%o>zf8Bd&3X>FJx35Dy`DKpiKGG2_6- zi1EL|_pg8qr_|L-ofg+klMsFq4s0+U^c|Cvl? zW76WGjRAGt5q$puurgxIe=ugV^!5FI`VHxE7Je0$oQCSazOkXL=HEJ@iy7)<8ccM zi$(+ef&T;QIOo)jsy2Ql_>yw@-e%|Y#X_Tj-|AYa)EhMu>Nvyr{xgBmKbe`?Dr?r9 zOju)E)IDj`^R}b-mDwQojt1IgQcl=+(LyKais%c845mdJTs}XVW{eu|uie$6SB5Pd25|YHf6OMZB Tt+q0v00000NkvXXu0mjf(ZE2? literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/categories.png b/pos_receipt_extend/static/description/assets/misc/categories.png new file mode 100755 index 0000000000000000000000000000000000000000..bedf1e0b189ab85a0800d2bf16f8907ae0f9b225 GIT binary patch literal 1532 zcmZ{keKgZ+9Kav<&g)v_b;hk!gv>VTU}Ro~txRZnf7vk1>ts^0E+H?ytaOVCAAtJwqh7z>jo|))?0E=;^I0L}r!q@1EP`)*ij%*d2<}K;)isHiUuO(K8sRsh z-Pis3{YvV^@OQmmNs&NQU=)KXv{AlE^1MknPJ@r9OQ`&Nj0POs^TNY&qa1m>k$^h9D8PU8DqJ&&5k(K{sH@ z>V&X6c_01q(%2SvYvLlvZnd>@@hKBUnCj~2ChNaWzfP;#&qp?|WQ{%Kh@)Q3?|Ni0 z=(zu3N5auKDLJw+J9M|2X2;&ImwC4Jf<@^EEM+385H^D2h1?zJ3CZs;Z5fLh)hk%5 z92LCeycC`uoi_YZVuu}XVj@bJ4%>5%sl%Pd2NlL!H`UvThTU6LJEXe^gn}6qo&D*^ zm^{E}_)%2m+Lg7mTKSD%vkXWsw?3^(z8CV2X1=Ih+$)FISZ`Q1W>#&(U;Pf3754az zInOwxDLL*iQ+nNfq^Y+ffJ{jKv)@>P_0P3jxYZ!D3cFG&Z(+^{gBw2KslvLZ6k9pp zcav^CwSZWm8XpNq>1*NKY-M4jgw>z=OfFMf(-%Ced^p_UI?=L>ul247laA={vAc40 z&MbkA zQp*daY+?&xt97XHt%JJN_4~;wCD(^h2BpL1xp@X^wlU;+cG@IQw(58Lm3j6ZZ+dn9) zlL|m@Tzt8QBUiJiT2oW)3o_`6!%f0b4fhFzCeI?t)lB#3@yOj}Mt_vsQ;lPFV#O6{ z#%pHl7`Xv@3G+~0gf4=9HDk7006U7#X5b?aGavvftd$iSYlF73p<;LAaeMIAHoLG` zJQn*_0WSNWkeD3Bj6U{lp)90@1PP}9O<*$<8L4b~BJ10ZkX&2>Ie_fuMQn7To%{z~ C2BR$i literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/check-box.png b/pos_receipt_extend/static/description/assets/misc/check-box.png new file mode 100755 index 0000000000000000000000000000000000000000..42caf24b98062c6ea6bb4a636808964262e04e64 GIT binary patch literal 1118 zcmeAS@N?(olHy`uVBq!ia0vp^3Lq@N1|*eVE!z&HSkfJR9T^xl_H+M9WCckkdj$D1 zFjT2AFf_Cwy$! zfk$L9kWK*O57|!VfeiK%PhVH|XY8`f{5%sry}!V~z%1$M;uw-~@9oTZkKjO=CD^jHr2-Ky_r{i?)~S7_ckB4oN(g5tYF>c zecgT2?!-)3&U=-W^}*{P+mk1&m|2o@3`DB-E~qm~>F;-*yYrll;YLQry_@%LUb%8X zSjE+IehQ%>T3iJ@vm@Fq_A2$CQg(Ju_%mzI0*!##akKYr_)x8V`IhX8_~|jz^_hE> zd;=LayyV?Fk7K&Tx^-+XW2{W<-~V5`@89>ZwyFGC>#fe-*%zH$M9~KbEpB%kplhyQx`MYlUcye6W&9GPaJX2i3?bob^ z=exg^9ZxCxM3D_VHl^jeHY`!8c)H5wMZp^0bDUnQR~=%Q|1hPlj^%al zjs`O?=kPw+Mb0anZ@pqaf4bYWLWeaYbK%J(#?C)E8yU{u zTrOT_@NtibABP9W1^0$+d-vQ_D(lYg?oQ;m@a?L(Z{C9mLOf|(k3Z&gc6i`$@X)`5 zj(b<%uQ*aR(a3;d>&tK7gM$+}IPUzKI3?xtd={Saa$y6>?~&_*ZG>w7{#DSM$re73 zo#ji*{q@_{ugldxe*4`p0=f4`+#~FJYD@<);T3K0RTVZ(~IOI{J%W8*u9*WnXM%N#3}+n;w=F9$v#T_3ILHv09f$= z0PI5mfQA&b*x=X~-2b*97_-TaA4aVSZ19GdIft|9@!#C?$B(cJPz2G^1hfc}=H!$h z9#k8!MN^`&p}kYjYbSq_s3S!GnwCdX;-6K?>A^MlW~@W+hr1_WWGxPgd2V{r)k%}8 z`@Nt`HpQ1%gw>PhZxP~)DeN26sL+QQU{ z8=X<#AL%T$&gkq?(a0b{u))BWK7;|3><4RK5J@RX$ z(S}Z}XkyR`Cl$7Nme&@zL{?CO(=SFeS?(Ug7^y~jPwq$Bhw-+z)>A7RpO*1e4MwGS z!?tam!3yiN^P^z==2Ymif^Sn_MMZt9@54&BgyW9J6EEZ>7oa+7Fgzx|yzbw307XYE*cD0uWM1t?sq(m z9jBP~NW{6Df?8;77_ai$)T`wdKc0X%#E)|{;eJcBhe@f@T)URJue+whDml1xN zmNk61-cbkNU1R|d;RSR}>Pp7Y?F>1OlNfN&=47KVbsz1e6&y8Bh{?cg&1Ig3W01Gv zC7=XiEH4Ov!QLP$LC5WJ9~lk#6lZ-T{B=vW=D7F#K=!-_N+yGmza~Cwnx=Xj)mX7z zOsJg`XhOIrpF3Ee5$Y!;&7`H-MHfA>{W(gimR9q3_d@AdIN>y^r~!^0L3@6yh{FJA z>EzuGB&7WeZtLNXZwe!lM@J>y-=h7@#@G- zXgt!HYgpi<3cuG<_PM-k4z6eGo;5Ik&8_$?xGvg!@iwHsU`34@

a z(_>eoHv$BXzpXj*;mu^oFsud6dmu+nts~s0GR4&i8>u2*lJ&g^edi)~L&fHF`xcb0 zRlm0+k!#^FXzcS(1Dbo z$w>yEMeASDt3M;-pnjYJ>FFYMSz%vE_BlG&wtWOzk0YpLW_ylg*ur|DWJUI- zU)0fQZnn~}h6#n}$U_9+RPq(KPbG9#r((|D*X_Q+&VaPaRJWHX1B2uOm}D=-pSeA| zhR@8Pilur$blSs}?7K9JcXk=E*Z4~AQ7G7zH%im$c?x$uW#moLkeS4Kfc<^9^U;isYM_8gVGaIzUR9D~IL)2H9n;n!s9NnmY0<<$#aIf_ z`1IjLOIEqGlv~ty7hQ-3Ebo$wPp@<3xx1PBd|)vPllIi*+^yybG1)n4@Mow`iQ~Uk zy<3a?txUP6(@-+g^=ESCVr9z5h=VmQOtWOqo((UBFr%t!*&o7(FaJV_`3sQ{TRiTD zv`Pd(%Ff8mjsBE)?T$<2r4-GI#KuNn z(2Sl_&rj`XC@hfYH=O_Gj$UEV6uRI@`+_7??vmT^vIq4!;eH_XsW&`FAcf z`)trP=Z9;=n-^8BSaF~wXW^FzvVoq?r#GnVowU%m=ET&lgZHZWw2N0vw*Sn&eTUcO)m2MAyUGU) ztFN@bO4u;(?)s-!+S+EmdX?6&T~StD&SpW3(ZPHZrVnT1&5b^#`sbL5DCkYz*86jB zTvlL>)4dlOc`p}BZ*`X8(>k6L5`JOJ`M4{*9F8`Q`;IQs3le9Rlw|nuve2pN+to)= z^Wt{x%3WyHzdL^0)hh>>(={sIEEiFKP{6>DQ?>Hnp@zL4K9i4xuiwC__DVwH!Xuf6 z(66(7JX&T?x|63{w?un&XjWFHqmbl<9R&+NIq8NMadAC*^gO5kv~tkdc->WBAG!Xp z>^SuOz5nw2TTZfCT1MHjCZyKquKhbnLrl88-MRNm(v0ovVj|yXy`Ok{x=!bfnSbZb zP+0r^#SE$cm#=5+u&c9fT&ZzCDOPoBSlBAYZJX?^t6#Aw)jl|68*z(e-|H<~Tem&Q z7ud+yyFn+gMyoLY{rBvYqN7v1s&sp1oMmEgD=)X*I@xEk@TIUQM#qMmJnS4MnGM1Z zmo4e)vg)6m5}lsDq}H{D`)0LE{Kg%{%P(+izkBw~ElRvlS$NN^zISXbhra~+%1Jb^ zv+p$J`mZItCu{zu>3QG3zs`GbMfp41^w&3yziO0C`14`my}#Lec-!+T&-eeVnRu-= z&P6@{VU3vtQ|;&W=epXuOUvFo4)jz~Z@8*AecJKw3>HB_512Emy|`pqEWVzbTktX9 zE^EWP^t2?_1J~KvGmRTw9XtpWj1_HI?&_-Zi0kO-qDQyb!h4Ys2yS-RmR&eE-4bEi!Md z#`oePV3t!Yag8WRNi0dVN-jzTQVd20Mn<{@=DJ4aAqFN^MwV8FCfWuDRt5&LLK9}A yXvob^$xN%nts%!>Lmj9=18ze}W^QV6Nn&mRZavmfoIiki7(8A5T-G@yGywnv4>=zge+s5Ox9s!oiLUVG4_2M+cCB?%1$wM z35BAREmKO#J|*5c?}zug-Vf)#uKW4j&;4A#>-ls)PqLMTF&Fzeb^rjlOic`J=oI=V z!7TK(g}TyB2h$xrb3Fj~JDua$jhVie@G!A42Y`qR01y)o06*!im`?x@q6`3=NC42t z2Y|DI#a-4~^aB=mGh;(K=|MB-j;7;Gpov2;oyh;@wvYZ4y2zl(;*#HW-B+ZU=P zB}2dsV24HBu>?1;z;#Eh9yt|?k=;eTY!cEb@0K1Pezig}iAh5}_{F#MZ_`~Z_H5WM zht&5U)((Fiz(3Hg3~&;3`Airp>SE*eMZVE`PBat;y;nD=55DwgK?4JYEg2Y-|6*^+1h{6-B&!SBe5E!SDN3fp!U|+<*0HElltJPGMb2?$>mdjTQQ3Mqo_(|wl3C-(8CMUw8T%-yS zDLLqp!S7=7)+lf1la3^}gDt78Fm`^U^Y!9}*=u>O1L?;j)34rmZ_6fVh&0(ra(6K zJ=A1PP9x(ih6CAgn4;n)0$DZawSV_W(_i1X7rx}!Xg6v7R}ECxx{@Ft+}fJV<~|A? zT#CQIM-GxXBXR9m8-wXdbCPRV=nh?Es5CeZh+ix$;up!#EzWwCHSF?;%g0A*_o}eE zS@rODuIXUI&~%>=BeTDO-{ak(dP&UNJQW#k3?f3q&%YKh zj}8p+oTqknw4m|3D2ESG2DE4XHe;BL+gnd7yRtHYZE#h7p%}cu?v9ssl)5bl4Hqcs zjQsg)Mc|0RKfg$1C&O%-Ns&h^|1j7uzj0=?xk1$ZUPouzJ~f?WqK^36@=wtfO|p1> za8L`rc)&O$WF1$kHujFpY~RER*JX;aRh2o_v1b!LQcGbFFE-c=*Kz^*aC{Vxer~kF za&$=c0%o1-Z$pmfjy5LGSkk9*ZS~~7dR%P=g|R|GD+(K_J*y8b(~+x?!|&+{ zgwxtPh~cLbaf``1!NC!cBR|vlGd74Wu%e z`#rd~NyJNCse4$c7#`W)tb{SXwVIv1_qpB6rM`G^5%aP1ZnY=lB~jj$uc_~=lDctU z^KU+EFZewa@@4oD(~b!yW&K?;zfc+lF}=|GE_iyhZDizh@kvh)r_?CYnKB=#W@ZKo zo9saqaK=oo?F>*%ho{-UxxNN{6uBnT`lM5vWZRyJ`vZ%e?Q zv>M#LLI?u0V|e`&oeEN)Utq8)ElVHL66eGIaHra288b%v`Cs{C*WKA9> zriVh>?^EI?gQ=OdEzWl&1$lN998+JD=B&BhrO-a8npM^`3))VBswx~r6Nn(J8%AkC zOc}-6$>*;0eW&!2qn|>lKilj7Eb*_GRp-qYEj^EVKp@aa2V>yE!W8Ghq6kv6CB}Xi zA0%-#d>lmd^_E3Jqz&&U^hs6Uf$!cB2rB7F=`1dUelVb#$>ZZ>$s&hR4==JusF6np z@V-*lk1f6H=2V(#_q0v%|RYgqWP3 zfQ)Z`wWK5;x3mt&aI*<@>-2G04>CN;FWhnE8+3fk&IE&95(P2zm&wMO$4Uan+^d}@ zKfdFCtnE?lK?R}Tyh*Wvd9AIdTB{ym3f0Fe=wMXI ld?;Oj{O<-V+RrN(>*g2u?@lP8bD!=2rbZTqP5Maue*i?K%;o?9 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/cybrosys-logo.png b/pos_receipt_extend/static/description/assets/misc/cybrosys-logo.png new file mode 100755 index 0000000000000000000000000000000000000000..cc3cc0ccfdaf8dff2e8ebcb010e24ad9e636b494 GIT binary patch literal 4496 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 B&Kv*$ literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/logo.png b/pos_receipt_extend/static/description/assets/misc/logo.png new file mode 100755 index 0000000000000000000000000000000000000000..478462d3e73d73cc9bae9fea8e7f8fac84fab049 GIT binary patch literal 3452 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 e!*|2?|H>Z_>p))&1OWs90000l? zWKy}bLYpqAEQ(GYLL;Gb(D`-#IL~wb=zX5=`+48*`+lDHkMH++vpn2fWTn-m0RWIC z9Kam{srDn};o#iz@f{BYjOs*k0)QL&sI?$TaIX_`;1CG_67>Kel?4EQfvMC#0pJ80 z0A>OKz_uI!ROyu+p7!7YJlNF*2NE3LoOvlAr055ZFhBlyRK=FmTchU@1VS5t^%)rBQM9x$MwS_ zIXL28E0Jutq+4j;o%BRKk^5frRo5||pMzOotWxt7e`AC8&_%_GFa5wg4|BIgM?sHX}t!3?X6PLp4$UBYR*G4H& zMWX78_VXrTlyZUMxJRvzIRlyY?ck;R``%gwo;iG&QYPkRhHGmxV&U|J?Y^rE3saY1 zG~M-*5Q7+U3lPx5rh}=!OE26Gy*noAY^$SS1z(p>+80-3tY&2q4P(pi=oiXZbv==y zXNz%@hg?y+v5^*UM&psGr?#W?#oy?vVT!Nq;xo2R2u5H<#RL5qj7dO4ac@0F^!ngf z&PKr*uOm|Ap(E|9ZzYaPLWnC%tr3r8Ip>Osz(!1gNeva3Mwcv72UG3Cw(^a2VSqj+ zi^Gw7-K8=_q3X|GY3d)JcoS`y2fuJ>cPr!LN#P&A2aWB|#WZhQ72J@Mi-2%_f2*#Y zN>HTSP7l8m-qvJ*mJe2QXf)d?xw#rCH_dEO(a3Z^O8y(8pbhe*mx~XuA}pYj%F=G$6K(s;ly_O+L&wbDL`GV~pO~%~ zb-PH}OteCdwx9+4m(buZi#6EN`j}3e6EiuG#AL|cKo&hdUL+J{m?}#zsV1<9ax%nz zu6S>pFkEA{-8Z>oTkYo&~Ct(r52;n35<_46W44SR|=yRZb>u`vCFL|O%y zvHd+g6~vOiaEwWo&Gx1)vM`!ybp5j9d~a2FcK#-HcUG{IW9kF$JJMax#<6T@tbvx@ z$jqUkmA=~0F9J@|)1nwszzpy4gMpl7U8}JtE7}@?iFZV zi%UJkou|bMX>_Z&mia{Gm1ER8qI{S!4wYU=N;1}ifE8wL*nd%HI-fmC8l2CMv-R~u zvLDDM5}tj44JzEQ*b$bs1|hT<=)srdA^a+{tvf8CrMN979i}O4ehAemf%4cedr{mn zGO;GJJ6*4d5f{8kimVX0tGi;q66V;a5r+ll#Tf1JQR?ITA_3c#FgN#Z&wSd7rsk1# zz@rm(^=;c#Bj>sSsWVIc7rsY+Ik(`8u_yE!zp6Cn)=S25Z^cV3AX(?Dbv!U6gQlBt zNC{m%*Y<{X>)BW2u_SzBEef}Y{Dt+>dGfohq3m#N@KS^KHSx!Gg!cfYpwHXRC9@B$ z4an`Ay4?85=X%4ZN>1Uk%ZcT8LJ)2eT3WnQW+Lo>r(h_TX1>tfcWOr&Dyk3?X=J36 zKdbY6a*BJb<@)(GsIql|R|Wyu3I4h}nRq`YC5Rbn8xj`^0>Gd#7-O`RF~;gJ+QJrX zZHvb2LZfZbXvv51_x~qE|3ZlfOZd6KWD8G&g28_;Fe9Qv8O)$)`p=ymdGocP0}$|T JxMpl%+CQV6u!vJ6b2LQ+{ z08k|5Hl8;V48(lSS)m0K*v8qWXaU4Y)|bKr#QoPfLFWB}1Vpy6w*bw8ppr_kLt{~G zg3c!!^cfdyd+o&tj0-_-IqKL|DT#v*Tt(VR^p4|6prn%In@+FjDyl+Ba-xF~Di*o1 zx1guX{>c}`ffisl;XpCP%2;L>T(T8x-gJ;p+_7=b(m`FN+@eG_S^4z(swp$6AOG}(RGqLPX`>E|>w!|QLqhG3-1qHCT)(Q)h~`IeQAoQ|B(Fe(k=IQDJyJ-)3slV5N9QB$+< zu4?=JxT>vkq}G80CL?V-ntJN=@c2yUm&LetGTO2T(#j^OseJ*DCoC?G5Q?B&pWvkm zOYoE;DdcSqJUen1_q3ZEmgOznZDExTJ)V_&Rh)`E95GzJ4&G^q{F$r}|7E&o>+(ec z64CLp)6^!M!3fo%=MZluDcd<1WlhCFjp4Bl4#q!@b*1&Xwa{w%sl7v6O-=ScLhV0; z47)u%PF004qYRdY9GTLSaf>OCK~;YtPt6V3z-srmem%XD3*m0au-^8>2S>(GiYsD) zpO-i4^Dmc2^2iIJL37{IB_*OpP`gM*{r#;A#$k<&;^~d;9KudWS?k0v&zimPlH?|J z;knX-i?W2q)DsQlGC4*m`V4HUu4;M&+t4(GUC+0%aXetc60Y;`z{a8cy)H|gYm={j z;l{W9T$SPNFVBC(rBJ#sc(pp-rX=*iu67=eLx|jWLQcNE{{sE{`T7@1Z)9bD8zf0( zjj~_mT4SZ%t3rjZ)!{+2vp?nO{UgKK5#yNL>do)RTlsz2bB}HLdTS3{kkn^F2U7gp zeaCg}X@l?hW~nDsTvy+m_*r&&mzT4%)(9!}{CMT15>^6t%fNQzma@FX@aRa|1l0z*qvGe-ASXo+H75MF{hm1@$B`s6e`mtp!u{1kM23&ZI?Q~aH zN9c6V;=6*9!4dO;r|zZd$_WOZQV@&;NNnA|Q?IR?yF8?du)`6$l_(0$V9J1RKmcV* zL8?eOFOMC}v{Q;TXr?v4(8$Y*4M*d5teg-LQu7*+Szj~fKj&n^&=_#Bn>!WDNFV)p zKhqa@bvz1L=JLch`E!DQQi`PCX&pZg7N>Eq;&or4tJE-I1D?u=@o}LTUVUV9Z1x9K zl-W1V4UY3U$sz7&6*jVHxCmv$zDA`E312662$dQQFCCh1p7TfJ34T$BgE}dRTB|LT-;YEoNK7ViA>jCqdQH zKBcB6G4S@&$Lel2T2^;NazX~5d1xAxU`Q7a_L)UzJ8>v}+Nh30S#B5{KE{W0 z#*57t-V&9JQeIkH6N@r-4+)waqjM8>2F_r#b(0B(>Dx`rM_;dK`EU>?=Qro7lB?mj zx7S_n@%OR(i)Ai{8Me<&+UvtElV8*v3lri0qIr4s zu+es*p>Y-FhM%-{8Q?+x5Ci4jtTNiRdwT3D*)8iinnteUB|-VY!51KxoFN{psB7JI zKNn5!NMef%;b~SiLeB68D2@4D9cerQV-6f;Tjg~E` z?bzd}7Tt$!x1AqrR-WumDLffbZQ^=ao6`5U;WZ~2%Nx&p^xjAh*d9)kkNG}$%5A+VOdR^iev6_9*0mc5>s>W({cMY*pr&6E+Y%Cnm&&+Xg{{c=MKK%dy literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/right-arrow.png b/pos_receipt_extend/static/description/assets/misc/right-arrow.png new file mode 100755 index 0000000000000000000000000000000000000000..730984a0635c971661c6ccafc2fec83a2dee1632 GIT binary patch literal 967 zcmeAS@N?(olHy`uVBq!ia0vp^4j?SR1|)y|Tss#?v7|ftIx;Y9?C1WI$O_~uBzpw; zGB8xBF)%c=0965n8eT9klo~KFyh>nTu$sZZAYL$MSD+10f-TA0-33Sk!B6Mi^+1ZV zz$3C4NGE{this?wKn8n>r>`sfGj=I%4b4g4AADwDU~2MoaSW-r_4bZ!MsT3Sv5((f zj=RO|;#kCS=}}7XL8tDJKN>$74xU}fF>8v}j2jEzPD!~~B4D&6V6&)t;iMZW0#n(z zM5Ri70$rZ#WgS)W=yTpFs=aW@vwOvPpZ>4?exP>p_lE`Vt_v~(ZHIzC=1bq*>z0|h zL$rJ5x+8)Hu@2<{TBXXnCcMxU`O+qJVZYbXC(k_;P{=m zoy94kwEF;O_c>0rrT6}e&e$-V*P8MWRF-G>B-@r{Pc42%%tE>x>1&hK=0!iJj_bFU=Io=^F7{M7dD=9_DxO9dJFZ;G)nC3NUIDloLooN-(2f)V94EWEpbZ~Z zma#f64Z4`2v~cT7d6xV)e1{w_vmT7DkGCt5Ur=3pHLa;*5f zc07h}=2!o+4~gCP*(>6B_RmB<{nj$JXpjQAjcb8g9~ebTzfTZ+G3jl;^Y7o%?q9u4 zqt|+Q)SXiP9{zRhqs#@~+wA#bT zfk+J(R@O0J6qFZ;eYtTmFny?&xJHzuB$lLFB^RXvDF!10BO_e{b6q2|5JN*N69X#~ zLu~^CD+2>trOB!&8glbfGSez?Yw)Spo(a^T0k@$fGdH!kBr&%Dw;t&%E;pba22WQ% Jmvv4FO#tlhdcptz literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/star.png b/pos_receipt_extend/static/description/assets/misc/star.png new file mode 100755 index 0000000000000000000000000000000000000000..2eb9ab29f722b495b4ab0ece3ad21e7b82394f3a GIT binary patch literal 1642 zcmZ{kX;cze6o8)_%zz{|jy5T_nC3DXlBrQ{D7dhQ;$CJZkW?-u8k#BY>10{CONm2j zS(=t;$2D_paV=a*EprsoO3bpw(qZPuoHIYV=iK|<`|kP9`*+i+6h{PXBMbn5aCUNV zmvO^CiG;{%wRoyg2F1g6WIF(A&cnY2D#_-}K~C;u0Aln2;3fm`RrbV{01$}=VD2CQ z*n9vq!g&pDdu0pAA)=#$jI#J*-xx2$&*4tK5i%b9H>F2${jvtib|&MYvrtXNjmD2) z)OG-rbe$dSJbcS0T_J9h7=ba)GD@Y)Z4%I{m53aoBzyMi|aQIi2zE_#N__+%0Hh141 zV)v5xuhe>IzQVca4VwMpL#TJ;||e=cM%{MUEOMwYghQ!59{b=zmX~BHv&X<2eM{7 zJT{LNN4icLnLvP!Ewik?>43_Xk-W6c`%|~N(~8YTkzAaqSziUr9cx*2f;C`S`~LK_)qAtD+(@_ z6v)gsESJaedKJd zzMz`=g#GSPA~$k=udY|Ck-;UK7mXS^iJi>UHmr|=+dAkFfWO*vQtF3n``AUWOpI3? zEF}hZww+i>%gM19tGjo*w3hd8vdUn+qao=`9HKDAWo2bhnFHc|DnA>=!aD;R&9l;G zrwWa{zm=aejS%-0j~v5vqoQM1>P{-W3`>n-jAv(FHm_W(Z&AkG=F|jOSK(ic-5I2q zp)4Nr(r>kMkR2V|4FR2FtE>9(`mG_+yRU7hY2+g&CU!hL`;9QIiA=8G?$yohE_xEw)9HD{!>f`iy!}WHSiub;MVCN)k+@T?13yj(M z(wU){=%JR=)P$>47q{kzQ08MINlTgk`ZK3+cJZm))tuKtzop@eZ`mK)k_5)%yT-<7 z9>}Gn-m+S!GDG8%lC}JoekmU2LoW3`l}DF}z68$8dut|51%IB1IJv-dbq-=RL+?-g z=H}ajB8^x1x2RWPoD5kp^ImzQ|4BH!2EX=(xl8!F0Zc!ydxizbxY`!bGQy8pW&lifskd_1( zFYZ(53wrAabdp3|dUg+}e8=5%A|-3}=ymk=whX)8wAK1OEL4xj(R3@wdMT7sJC|V^ z|CRlxnxbWERUd83oF(h=9O)w4%Br^=^;tdl>2P8Jr}${b9}yZ0%ebU-feJ@{fnBBz zfGa-!2#}ixv)1#}|2o?*cE3B2V4sr0LpUbrqX$H{3T>_F7mKZQOx9b)1)$F|JAE&Q zk~~ENSjzTiKU4itCzMx8>g>~i?O)fwAEN9c)Q;mH+0mFo`w+J z!*=e&?(uBBSn&Qnk5{r7?c-OxFaJUbhB{pk_WapsiU)LORr3U6oHn`k4GMwBkwiW3 zD*crDtFt&2UOG^Vq{eP>JGmCMJ#_qOG1MYg^(i+MY4Mb~cg zU!IW~3F^Z|k&AaZ6EokH)C$R2*K0o-%WkMH8}GxW2eKL1pc4!k00xc07^5wWF%}+Z zGc3j&YqrY>jmDzU^5^=x{wIWl(OJys9}5vrqGDu%{(nEPSs{!Fc3?>OkDYB@-lZ}J NIO8b}Rk(wRe*?eI-Sq$f literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/support.png b/pos_receipt_extend/static/description/assets/misc/support.png new file mode 100755 index 0000000000000000000000000000000000000000..4f18b8b8201e3a268ab1d8ceb8bf46d7a7a37dd9 GIT binary patch literal 3892 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/misc/whatsapp.png b/pos_receipt_extend/static/description/assets/misc/whatsapp.png new file mode 100755 index 0000000000000000000000000000000000000000..d513a5356b2564f545f2edcb0b80dd3dbff9629b GIT binary patch literal 5097 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/modules/1.png b/pos_receipt_extend/static/description/assets/modules/1.png new file mode 100644 index 0000000000000000000000000000000000000000..2aa92f3a98f7a9e505639634f428b222071ce07a GIT binary patch literal 58469 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 EAJAhxW&i*H literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/modules/2.png b/pos_receipt_extend/static/description/assets/modules/2.png new file mode 100644 index 0000000000000000000000000000000000000000..6f28da108fbf03879a37659463e4ee25d82e2753 GIT binary patch literal 59649 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

^H+TP?oC2%|J>8A7c(`J;!A&W zPvx;#C?^I#9);=333(VQP1ra8Nf{!Pvb82+_L=T~Tl4et1rb>6AEWHVx8GPZ{UhLC z{I`fZ)t8XjdfkHU84Q0t7|Sb$(gkZ6o@)vJxmFF~xR@x=P@}5`>K+5^qT+8(N51+- z6JuK@$=!*1sMB5^-rBLNyE{;r5Q$@pI&p9tRC#8H@rcyHsb-Y~bhIv?T(c1wWSZ)_x4!XL!cw2dljkL71f`fzc2sir0O+FHyEJKP;_Nq^F zg*`l51R0Dk-^q&i@6~hrJo`Ua@B}>ID%8-Gvi^-M+fTZ;D{b;g6tQ}mdt1Az7Tf|O z=i`}>OFi53cUmju{@p8ogH7A8>(H)v#O;keY{ve5WV)eu{9{}&m zapw*)@eEj)pL}cCqoa_rxOm)m%KR8V;5}f2vP2|BfD~(k#b*yQNd^ICIH(VVeV=HU z%`RUbAh)&m|K$95`7VB<<30+EsMAq4@>SRz!aK1p`(g?9G4w{%viU z#Egxv&CQM5cMm{8e|=S>&A-)8W0z#g{tiD*DeRV7IOltzWhm*$O( z%DbORF9T^zhW<=VI`Cc2QmZ@VfXSIqvv{-)am@Qe9dCDc_kj(xu%39+*BMVwPlf64 zy@IEpxrvE|=rFy!eGPgmp~&;tE%KB$VTp~ZQwl9p_FV%bs6Vj8Q-$Zgv3*7aCyw%} z;%FlZR+y%lGFCxRBwxO7-zgR~_96lc_RZHJHxW@$dK&7pop1;r1mXjUZl_6!eWzorjJOSwe46_1Gkb>$wAenyCwhp(u%ocyFe!m1$Iy zyqbeYMjjg-xY|MN{@fi95a8NDh7RAjQhn4JLQv>|FdS*TxkwNKwMR!38HwV#=szH; z@cfc+$#g4@5t$U9P?($>%d;kk3gIajMeZ_coL<`bekMcH``OOK!m`m}O--7BgOj?N zkyD$OSDn*&b=A|;Gt*e+dv~B86S+aJPA;-Ek#peC^v4ksc4)Mw)g}g1%)lLg)nwU{ zC1lLf_3uA`2;H|D=T}=aJPSQLWqMC zJ7@wdam%j4mcVeS$q6*X344nELs_@Vx@*2cQ3ou8~oEe-Qa{ z5@$*nICntlbWYc4GJOaWDK0Jsc{O+D=+=Q2W|C>IQMC-k#SR$)7Uu5mt^)!FQ=f3o z_(U|%iavqGvk7J1jHgqx0mYca*wf;ap-1ymJIeoJfM5TLdnUy zTzd8vPj3=d22^vWAhCQ4oM)1?{V!OLLiEa zp%x7WCHWu%JP8(NgfZXA_I`x|JXO8b5e#Fy)A8y4uR}OF6z1y40h0{<_Pw(c0epO{ zCUsyQ6|^UDot4qz%$b%5j6ObwjdJ*DLgnJ~7*I5Zn8gRgKhdR`kv(UAUM}X3q*%#Y zzPsA1ZxVuI*RPNT{w~*t)GU_ZlJ>+|!pKOI4d!}OC(@E&F~$`Yz;}0}5{Hs^b_gLD zYRV`l2pc~BdQFl5JqTg+Th>}ZDMC~*5Qm+>xinrpD>Y|)e!LZUKJ@b?M`?Lv1ryjW zI^jZJqi1Dg=t1;m9dvl@XUo=>G(E4{$Gn)RJQ_dU*Tz~K19E$qk#crQrEo)@3Ra|u z$nuLVT$?#C-3SP6INf;YQc$J`z3K3he`cT2gnNXU`%;L%bSK_Tg~(MbyG#G70LvMX z#JpSt>eHg6ld{ysE-Z2R{EU|R7&=i@T zGlo?;*sb$_Aq2y>cdT8o_ZZiK-+v9qdXh3N885;Y__O@N{bn2)1f8QpH-+Q;E-$CJ z0`)~0OSzyxiw*o#GJQ()8Rr42K(V0ZEV<*7fO})k0*#nV;rCnk$~bX?U?1#$wTdcS z*)*9*wIUlE>jThwd~mrMIkILEu11r%Urf!+%nU6gXxs)K@@r&LvTTbSK?%i#35$&V zbud-H@^k2pxEz~Pv38@k<0r(RvUt`v><&G)>oQwnk)wGuzxj?CL0!G%qPXtStSK*G zh%4K`#(A<*d;M^Gk%^E0F5s)Frd=QAE9h7zB^*T+l{(*U8(Q^p_+^*Zt_2D~%t6$V z%%UN`{$heJW9`RNDJifOXDzNFvf2ARfsEwhSFJxMfZ}hhC`^2$D<~NjI15tuE{$db zp{)(HCmXHutD&)un?I0iTQ;`H_sFE6v8Pi%Eda&p^PZN?(e1@9gNnMq!(JZqDm}5i zA}mb88)9J%8AZ6%fz=;K#(}89*vNI)A1}X00!5aociJV+WJ6xqyH;A9tN#1F$0&A6! z5a(i@3rzljY#|5axBV!AD3eVBYf>2($F&p9;^;e&tj8d`prlwrm_omBPa+l8{|r zbKE*zSAV*#QDwt%oVL1bJ!y+i$@ur@>Il_$m5!gR$N`SnGu~H(uS6p9)P^k#Me4WA zAl>NM(aRSNzn`*=&r58|EY4w;JGVWs@-vPS>$-6tv+Zvy&o3lL``QJGWGu9N;=Ml| zKZQAgtj&MIZ7?AVY`dRbN@mdecO4|ml5GOVjE!Uk2^R9z#HBsmyOst|(J3(A#*udq zCxIvtKA;Vbyf5W_Dz&W4RPG+tmYg}Z4D5#L5+0XhQ%+7N^5=9MU0q$Q5=M*Zj~#mC zO&tOFM4?Q9rW#46k09MP{RRm}0I%>cv6|n700-=f-g7eMGRVt>u{U429$$3Ui=d(k zyEW911rp6Zpw-ZMT`f0fRWLC2qo^?Gx43VLLG&3>{| z!Z+8@gMy@G*CXAcim~A2=3@HW&TTUF)+Q!8Z<<%k{9RmKuP!hDe;KR7zUE}ZB-tt8 z7kII`ny?h!VOulRybDOCMD6d9_^_eNn?fW)YT~ib*Vo6kX~hVG@`cSRYIKZGKJ%pKaTaJ_Pa( zD)dR`AFrBXvPP9g8Lzq?f9UV~4alLbj6r8IHX%m>DY*}i*=9@1FY?X}260;^rcIKH zXIxH#uprj}*t`f2|MHwHL4r(P`oph{=~wWn46m+ki}vXJ>%YA6-{(8G)0ZERti3N- z6L=^chhUy2{^+>SZf$g9Yk)i+Bzt=^8(nm&e9!q8r&z#(i0tJ@0BSGphMnWLRwwdr zbx;?f$hV99swt<8G7J%77isG{0UbG4spJ+ zb*rr_X!O0g)bcr6;jVvAJiRhKp`g0kZB3l~Ll3yZ8<9V}`oo@1<@lFI3fh_qVup=3 ziHzv!N1!R?2wr>V~gIa zzk3>8Z8#W_Wk*^K6k;jx9w-c7j_aD=`c%qz7Lq^r7uWi)_KOj1YX&(2m_GM|G#7e3 z2tp}m<;8%dWjGpKAZMvv-HdFl+iqfQ zvMIdgRh!Na9XD4L>0W9sOK@OltAX3DdUQXy(vu}aUD;-Lw86g3pjYv;t?6f*J8%n) z5q|PV za@xeg>^!u;<}V`WlPGo_s)TXd{_I+8Yc{LJMa{g}a~AEuY7$!38WU79>er+quchcP z!xL-lV+H4(i*xqlkgvpZnaMH3FpQcdsA_oDqbSp|vIMj)H|+G8stY;acbq)Bm>0bC z)bA3s+vi(>CUD(0>4kZz`{oV=Ej zqKjr=j4vRI;gn@PgKfhqu?b-6gAT_;=tYa|p?nStGJ>MFS6Z_fPyhnr$B@4lmUK=smY$y$v~qvhvHq$B6r9<@oBKiaRv5dzDuiVCQJ$RPK8$ic@pjHC|l zLf?7HqZ;HO$$!iCjJ>$(Xc?a6iPri7^MiSCp|GuHTOn^_+xUd~$5}@_#YJP-30Wc(hR_g`eDa<^lG>AN3v%jD1qn-0@Hs=z;u+pA~cIY^%q~0Vufz zlc2yCgtg`6SMo|jMd^J0gZ!|5l|doQ1~5FHQv@>685^aRiFzcum7#`-(hWK4=Te2U zGn>2m%(xe?_N1Uhsjt>I7+A&*Sdh@IvqX|qTV&Us{7Jv>6Yt0FOGrs?*?B@z3Q91g zkQat+cK>r&AD?XgmwA+BJ6&y&e!Tf8wfq>9r*&iYC_UKg-BHqLKDz0rjt$_0fY_|S z5{Kz1)qRPLXU}|j0Y!0ylo* zGeDGpoKInW=}1sLEMr(~D^W^04;9&2p z{pXQG>9Mmdu8w;`{)YEMq?^s@_~|G9 z4kyK5H#qC^xlU}Z;XPcptX&PyHcgAPx~(^2?%sU^9>_k5{)hsjUC72!bdnc=_kAWS zJs><3axLS>q9`op9UL9-+cTAXfje@UKqE)VU-3IJm{~Yxyn?YoAPy2fi?Z`^+ALhM zwzBf{@-+ASlm*-AAIDsL`7zOT*`h`tv%5ybjwRBvUsQ~mxaSy=U8qc~Qq{6QiX!hZ zUWSaWv+mu}ef0kf&Zodj>)aE4Ls zstV^tH%-d1EDf5Sk7V?k9S^^jyqYMNYv~-pDth6Xu0u*@_fg<%I|-|z#T>G-#zwbN zW>sqS9#TDbPiAZDv3@7saQYc9;*^SfZloly`e+a4e&x=Gw1CR^Hc7RCUeQLr-DoMT zFU`}9Frq{Mx@o${@}$P<-g9@YyCQP-oHxNn!{K4`HUFC1FRuHXT(|n1?>WHdZw1Qp z6W5nRlS&W)Tyiv1zRSRNKLb$ZJ{j9_0;&kl7~l1;t0QdV0KJn^tIbyk5cY)S1kP@j z-$Iyp#yvGXJuHYrpEOT?S0Qe0abjpt?H5KbCLxHI;Q6qV*h-N#f>UTc>CXV(Bjo3s z*)x0?JcvGr%FIiwaY%7NmsF;2>y^jC-8FHBgmu(LZz(nt#s0pC;DK5HB-BjB$GiWl z-@_g<7;kd#od^m^1J!Kw{l=U|Co3{eskZsX_;_uC;z_~MLU`ND%D^w6vsqL=w!*0F z*>u2gon5FKsjZ^-&|~-G(y`hStWI88Uh@NPjFjY*M*tMEx$%KYdC<p^a2-y`M3t-L0M#b9qHheX=_bXtMty-lGEZJu` zl2fib@WThkf!Z++ec}iF2PSc?K2+V_kcFkPPK){@LZ3MMrSflVgb!EI)HDv=p51>8 zfNpH5QrsqxBM(GEpU3ny@6((k9X6avVaDtpYy_&W{<+tX#`Ijv&YpAg$SVIrOPL=l zUf&9-i0QHS{@(9x<0A}WY931)N=YE7Jd)C@Rx~K$VAfA(=bU@uy}3{FO#PA)0l1Sh=G@W zm5YZnKk5&~1RKt59pL(eIZ9Rg;&e*;?KPML2|7B9w(^0ca&<-Rs6sp*uUf_X8kz8l z$WioI02el=*LqO=E*SsOXw!ksQc*=OGV8OP(crJPXN|1DSVBMb{b8&fZ zSLY3E5V3WU!G|dfqp49Op$V(3e6Hksb{iUai%$Px2puie|2@RqtWOfXW*=FYikWp_ zA{m%TmvvEHz&voxdtJ4{Xo|Hvkl^U+zPL1dWTJM~PRRQa&1=j;Y=+Ve-vPaG8+~a% zI#wxR-S$tfgWE~&xhySTQ@ALwbMjYaRfA<}N9}5{D$j&k39DVii*>c zG+UsNlA*(PgRLOf<6(M&#ruOrMSmw4<-i)tDAvi4MJ0&$1j}+!01gmw?8NDPu6Tw> zILJeiVw5iq6K0%jRrH;%bCFbCN^%s%^+)uSem&O}_bo7FF0ZnVJ>624HdMyQU7EVd z{AdM40X^$y@f;1B2Ac<*l#0}eVu$FR4X`@fsE!o#^#kyPnzrhu#VKq~c&qK%)aebT z3d8$fs-KLC=Z^zumelq)atAC`zi8TA^KiJg6ts}ki5+}a`mO(oeRX=d-Ydpo+B|+b z?xtz^#GBUV{&m->y?*8t1WJOeu}t$K@5jSUbn9_lI0e$X?ipHj9v*Hp69YYX$cb?z zitGfoq0D+h8{1a}Ce$J0v_j3`{hxLP8cwy2%}NA6V!&Kd+73E{z;6`=cwE{ecR z5ePUN;bcZbl2nnXUAjm%a!Cfz+8`*BTYLrRW7_<#adFMynqiV{+q_pM3P?9|Z+^H= zH~b71%T!mf=P?EJnw5!p*SxzlPI|2ean_P!3kw(YXpuhg3xUjrdx|uRUY13HLn&hl z@wjt5Ok>}h{>GajxD1)g#gVF(+=ddfI=`mYVp3*WQ5@WTURum_JoBZ&LHfr`pCisR z7pu$_OaZm_dyj2~4i?~pHkbCe-}K+OV1{9aUsv; z3|MtdOJWgFmUX#BME7x&_7;Q59-tJi>(>O#y{a^5TpNwO{mj>1=n8OiO{yP?lww}U zIhnj~meka;bfZ~qK4(lKZ9n|Y092L?yydk8^BEL#fyJW-w1ySE*HzW z@Hsr=Ic_5*nY@DxSg;*GpARKJJ;f}Rsy}igKEr`I%}~aeyIzVl$*Pi=OPH#jXv%;s z@~3zniP4ul$-wUtG|`e#t*)18;5QQNp4~R;NbIijf0X+^joPh1q-|8A$dwXk@}u87 zu{a$q+n;3TF)m!eSplF0z@FG*MBCHfsjW6&{VkSOD`z$z2O)AEqvV$I-7B7f+x>da z(q-bJoRW$Q&-CO=5=`JfSBua@6%IJ^saIu}`^eS&TT$D;^Qs+xtYahJbAaa1bpoUc zuC4v@OX2M1hMm4_I11dUPU=Wei#{R%2(@SX*Z%zAyXr9aW@RhAEoI3u11TA9f7{WuxS@aat!GfPzsEE84pp&CO#j)yp zAAoGbNJW=0UuOk+2?%{|)~y*kCa0&jI+$;?Vc#Xt<+1P8y(^b1t@rYuFkoU4D;Fwa z-ot0-;QT1-nWtwxZdHGU5Ff>Te-!BdQtxyw3}Je!9<^@E%)*JG*J8WSiGTl%SbIOe zFl#NJ8X#~aDL{^mBi<~?5OyMNF0y{^RDTb{9FLK}&$irUO@9g^+ub zs%I{;q!c;RL1i~q?Tb;_C$XRZU`XvvEDdpVttzk;m=a9g`)2<(n8bsGs=H>J+X|uN0KSqHW z4t7aamf<;)P(z=FoM;U?y$0{wopNm&nwL7&Jb?idww}*+BEDV6)WX7kX~byg_&q-b zEUGXpF-h2?C3KF21gsHUj^*LcYA*6@01_mso_~rV{)#<#?7caiW!yRI3PbGdIv3XH zcU^NqvF;l7zf{|0iB-nyf@cFO^bl(-NSk&a@ZOZ%Ibc3OR_IH8|z88^P4AwZ3$=3SIK&rVplBT{k zav!WQFE<-E%O^Zk8}mj;&arPKlkm^_YSRH4o{r<|#-J^^w9dkY5(oV zS)^tYx6yZ76W2A`3U!KRM-D&Nmb9&J&Q0@Z&4r>^*;!;>(EvbX(Td}WFl&ixoWQ32 z0SpkCX00!y*e~^tWuj0V+ZQJr)5}}Yvbd>}q=u!|zx4wBPu$H8EE%`AFiZCt=t-JM zKi-|Y{Fnudpp1?lA$F~ku*gWEy*{r}ln^~L^Fr+YzO*%W>1+iP-n;LW@Xnu7a>qr! zQOo3LG}@Mn(AnBp;^5*sU8|hI!QtTGfDMR2F`ABwfq{z3-gzr^s>rSF;<)oQ%sYXpb2I!8a}(WPxyxP%3#XHMZ0F+oK{6_H!eSY1&R=e$2GK7o&HYc38f4)Y)HBP zZJXP#)A2aUc#|MEOQn6Y>Ebq;&g<|;{D52hem!uj!Xu}fiFf&Q4vRTR`J}Z!#A(gj z(9kf3|LSJ4rY1cqs+_(&Gc%L4yL;2>^5&*Vuafg4;*Og~DLcs~z`FqutgZ3Vas`KfTHSK}$i&hDf3dYyGa0ak@kr zI$|p%BMH->>PkUF5J5e+PnEF3o8`#L^d7>Rgf5n#L5Jn!ZK(e;1^*)k$(RlW7Q1hs zVcp3;{^pnDI8jnK-@(>~#hl2NqeTIZ>W>wdZwP)^WwawygRbP}n(da`i0=~Q2el#aaa|{>pQ#Tn3=SM1iV8saySKM@xQ7jX_6V^F3Fr2mDdJ;G$5A4Bm5S*| zNJzLTxH%XY$jQk)Th35~)6&wej#nQ$?@z9suW!6hS*gHHfLBJ#(I7){EGMUD>I1CQ zzR)GvkT^-vH=2Z>710wrOtJ)WB@xmJ;fS5+i=4cj|4qNdsL@^O_Kx#`PPJyX~se zIj(X~NP+P*I4|)-GKFY&w|;T+50XT3+0&%pu>EgHhuNl}tv^bnU+1rno?O8B|?42XMnNe3j^ zR5SQ{Zur|~@*s-5iOG2#GR%S<^Bb@4=%ORD{^!@o&x1p(b-H%0=nA7CSGCp8B2TBm z>-F|5U)@B^{V#97xR>LylZw;%&Os_U`0}xjWaUh23QEmi29xBYLLLV0_RU{F5NL9? zv$Ac8h&5I8a2RSy?^F=6OQywfUYaf9r%aN2?&4aXn_JoaW>YtRjJb+^0m9nrK`w&> z(Xpy`pD(QKerjtwwLi&-oI&F)uOvr`8B04|fcjO3*BmHI2$e?8AEJ0dkq@za3{cCP zvu)nYx*ft?ARtne5V+gqv4V&Z6wE)=w_2t{bGJrN_(Z@XM&OYsTj8rFRzKPS0SseJ+sA?|Kno%b2@;3Qc6t)1}6mWK1YKn(} zdi2gla9@h?p9pz?6TQFbWKVNK7*1ST>ku0Yn4)W_M{}t@;<}V9gHyQDqE^JGP_ z;C&-v3hKznh`#Sx?|wXGrEV(+FPl%0rUU}SJpyI+H+EEHtix#xKmvT|#+DT$HFln! zUzU=cDPUY%W1Y5pa*#(Mp|duUwQSam@!bvk*<=y;-Badqb#2wEO-sN75m@pA#i{LD zcdtyXADgJ0u8J40Rl_%t1ZMfG6iJe~$CSm2`nc9KD)XvGu4Jhg*e4V%sFI}cbSDN7 z^N@%1bz-&knx10m<%BVp#8(uTa_9cyzs)`%T$uELj7)qCco9SXVp3}7+`u9iU%Af2+;b~&~f!m+p#2}7I!l4mlm zk&~(qRdXwp!bWx2>2q64KQ4DrQ_OZfiwp{n4z2G0EhmFwZ??Nuqu8!%Dq z3?`-l*Iq^`x7Y3YcI>()fs~^#Q+CFU;GgUXEc$HvkY+U51|2)kYXQAXM~GUVD0J)SntYkz%|OmOI^_#W zP(>Ifdi;7eJolCh+{?GamNV^@U+fO8Ph6cRK<%tG?E4GU%dj+Fm(V9dJ93Yz)ZFk| zk#lyMM-s;Nd3#E~y?V%Mp#aQZ*Ec(sjQv=N=tmah0U`|5y0Z(4OK2*^`dAJz6C8!0 zkTHKXa-ZQXuXU;X1q29+2R#5i2kx=oUKB))SVc;)4^X?NFSncx^xX8}$|tl8^xVUm zk(n`@H4|QY2Yd&vM`O;9!K3Q^6(x~cI%xcrC@|i)nqJ!4y1FZ%KhwHW52D~BbYLLe zp-By9>PXOT0Kd6;AKg<#22Vjz&%E93WT=Nr5g>&-JC2P0rg zx=h21RXuxpnAl`l=~(&8{@U)Vh|#b=ZW>N9Ju%Y}8|8$e^i&z&uP(iXD$sr@Yh55s zfiVCM4gnV|KY?_htkEun0{Qc>unEX{-@DP#7SHRwkZB6Pl%{~O_BZP?I{LbBuRm6G ziIR~rR=Nq!6DyBFJf@}KsxY2&Wqzwk+!xe&Rb}m@v9Jiu8Ga9FYW%UC?H^FC2Fyx; z0sE2%6~hxVS{6=U3KoPG&%bDm6f7+Ki;3?G)h6^VlSjFKfx1@FPN6mfvEuK-N0%-R zF8q|a6?O2Eez*ly)Xp7FeAa%Ays>EQ`VS({(WoB_FdRCKe_V?cy zXk6AtqQbE{BzgZ@+@5dl`X}*0fMr}Qh|Yj;KiB9tCO~X$Ky?rWU!@=@8E6!%AOg#5 zap_r|)$k+=ql_&XgqA5$$!vjCn>*q|1dv&o%Pu{MNcAhSMwf0^FM-kuqb`>U&ZSFoMC$t=4p+BF_azIvmzi^FyOaD&{1lYeiqDHMlkwZa@!*Cz4;3Eb zGn7B^51((=?XZc2mDE$yV>)gU7zqsnm9iCJw;WHVlIVu4>a{?8HGks{X6-24%X;-n zy=I-M$w`*`G^l0VdsLTcuTxie>10{Za#EGnyAd37>4gOx$wA~+5AyOK@ zgGm^@&_V`P28CHZZ;1=h7)n$b8$slB^Op@ke1893KoFwfx?g|yzkKy<{PuNGrg$|2 zg%Ch}70btXG70=N`xsQGLIl{m9)jZshec<{;Hv;1l2*0O;Rk;^ri z1kcmBvenC%TS;5hnDaB<|BVs3rt};Wb7Pp)Y{B2|$`|fV()Tcg1CvVKyBNV(TcFc@ zYkz-Z&q9i-2m0d_8zyX%*z7~!=RlMsLpTzh>Nnj?6!Bq(*bu$7wYjyKnT3hfiTUwy z`%N(?r&_IYGfh`DS7=A+y|)S2#yNsiDD!ZC=yFJcsH+voglCVw9`?mSpRwr%qN5th zrAdumo)DebTTggnC||i<`P}v~?Ap+c9do1ph~4tZ$^+G6q6HfJMbH2>t)R+z#IUrA z`{jfORJ)QZ%>cid6>=69!=)9T4T>{Bddgsoa25qhNe<`L;-k|4%`l4r&BgX%s}Mx; zQ$}Hpc+0k8&6UMjuNzo$G`M^gOQ{+_RFON=_#&;hxXJLEc{9Fff3#^H52y_oDdAmFrg9L?zpmzChC+ z*74PiVn5p*MoCNBn|4@=gW}LPllWhYB_EgmBDG$1v@P}OHry`z1PFkC%EB?Z=?>|r zWt7O$Xw8sU0(i5XzNcjT2F1glHeAgIp`2?EQ%~He|9j?!bsVCr*u*S~u>oKw93y{! z7HrgDLpCk3Joe~FtJYR=26(F2P_ziDobL)M&U&`Ttnwl1YD9tHa-W|Xu`1_gSprRQ zW-VA8tMfn~S-E!7jR@7{TKgle8?`a1x9?)Y!@pL)Qw1rZU={|)jgHW&J$nyl4F}Ny z`KN!7W!pUeJAmiiFnHKkZY{A% z;KPOc>zGVJCm;fVLKJ34P`>u=4-T#<=*yOSDcH!QAytDzDof&-*5rB?v`|H}SJo`4 zY#+N%LtosuQ>90HCX_TaQ54EfPEP9T>hf;#`uc02Q|f;?Rfxr8vn5MHyfrjz+A^iT z-_lmj?6s*3;t*4h+p`KH0}FGzDx zhX5t)7QLXnxxX)>i(8}E=u@&Ar@p20fg>0J;sWz08-2k~PT)yiUeptOp)_7F^;#^H zhRp#|j7J9Dzdy~FJC0D@k2H=z)+ibYaac=b;Lin84S@bNT3$!*DkDV^xO>G!$i9Pq zk^LkhXD8#)Qh8uxi6@$|6s%+@(DQlPhKcKRY!@s-3aOfP_-i-eM4=g2So_VBeomZg zeg_x>)z#YB-69*iFMRFyr+eeD*VM$nd(t8Sn$+y?iu@{LTqxXw9vTXWF2JEvGyo`; z;;j0f=}Ws){y}i*7({iwypx25nZRhT^} zhlsLGcmK2d*ex@iG+^WE;+X@?0D_Od4(_U6RXI>hf;g#A-40gl^2 zdq(Bs*fsy-RP@*AYJFLas69pDaCF+O6Zl_eV{$ z^0#wLA! zzl9c?^k)WCDN(M5e^!qgV{Fzj|HK}Dy2@COZqB6e>>s@#ZFz^po4e1>x~N(yu&%FDD3b)5&(XC&inihea3vcPW&x z;?{EVa^As|NvcY3B9O!~=V$aBY4W@lU|xMwwtz`63j3r}Xzv>-CSQ8_F)bI*vDmS8* zKKUMJ3P1`~t?Bg*HTn!#ux0wlO9$Jp(|-sigELJjXX>)Z^+6FR>}eYtzTY+|8{g9v zU^SuYJbcCc{lgnnk*RNc^Vq__ix>~TE5_|rNeuac-EB}E3q+{+-5w5$?7Z2g@<0PQ z3e&O?^+i7CvvJ^e;Z3n%$DR=ar&n)4+dMuAY;`ECrI1LzW1XJ}Lz3oW(f8kplT6Jb z6xn-ewOHn!ZQwf0Fz3YI4*+`5H!eWX+Oj}+QxQfl3$_X9vnYZ`ei58{p+Pek(;59=o{#aCt{?Aa@r(A!d2W%MBM2MyJi-+nEYG9;Q- z)WZBM4O`guIU|7XLy8y}GW;Gh#(0N+A_0~h^&5#XDMsx2`w&4`Vk&C-1(?s^=Ad|I zu(9?v+)4&oB)LGG#zQ-!oOfi1>7?fumi_TRe4`*B0#HeoTDlT4x}m#U48$YO$o!OOQO@P(fMd{Ld}N=aEh(zVTot*Z*8gVY=&t!~F~;@4ZAYCv!^Fw?Y23MevTB<-t z6t=hwH~_w<3_S4FhG-svbZu5+>R^fW1GL~Dj~Ac)V*a-oSBfbUBdX=e5Vq#5l2I9+ z8@mi1JGQfs{w#HPc(^viu~2-S5fGVje@bBI)GgQKI*NK5bs@eV*u`YfN=SPLRiG?f zy%)VpK&R6#NQSY*2P*wt`QcQef!iIUwDjgz-rF6-%!sdF8kUFolNNFH$lr6!dCM;k zB(TLpu_w$x?w4-PSK1?#tp#m4hZy*`VW$G~uCEUWPjXMU-YOx8GlC8{%bpofQt zA52b^CPVAcGv(mbJcsQ)((f2r0Y-6(!8vP{1-Pu0OcY?38Ukp__*`Kyh=gDP7;{cO zR3y5YS$nZ)s(=>#2{%Rl_oR|j`|TyJ-(4**`hW&E>6*If1fIsA?cFoG1gV1S6+eAD z`7!nW7#=G%e3}HQZO*L6*)GwD2cMh;6a~+|^xtECuvn@rh<(_`h>w%NeRyLK2-j%C z*(iCEa0CHW8)`PsaB{kBC97<8tV0~BKooLx3Y$d>mEtr#AKj@{X51EbBRYB6k>`o) zjoDSB`(9CUa(Vv81hvv;1s`H(ZCP;<5#IYuyGm_0>sK`@PMq0@jyitQU1%~6)#PM! z;2T2?zC;%{*@8=Sk^%I@P!ckka$KbN7RQqI>>uYl3M7hu`P?KoHWvl%>YjTfInW2g z@KAqmpIO^U`nh|V43J1s)$#e~{@ljESeM!!mFK@bzhJz(yMq>xu!9Zi8cd`;Y2VG7 zX8m6fFuh$;m5v;4C+ zEbveZ`c?%1g3xbBBbkUlXm6sd9wlKUU;|2P*C(s#8K!F8@~c|~C|D-IjKmNEyQyGn z=mAF?Yf$Mh^O(~`nu<}RMBU&FqG`J4vi#<2A_M5^_x`2o?|%jDP}q8qcQc)$zkVf{ zEpwP2Ku?$=Q0om`HTj--w7Y*NtfD&S`rf~4d_$5A{2W5_XUwpuwtVH{ot$orvs0}A zdSH)bx0w+(Dx}=}>0kr}Eq90ts_N8OP|{GwP^xkQ2k~8|91Qbz9h>pT_|BdbUb}4W z)bhZW%kd6xtg(>#^T{Q~u0n6}!F)Qj)X)f*F7FNT=np7z(TF#>tFyKu65uI|<$X<= zY`$tS3s^N^No(Upei=G{)aP{;qbQ9fho6_|7Nc75G{oS9(+MLSEyCl%3LpWGHZCKu z#$h6H-@g+jN(D5KTKsY7I8j0;M}ZZ)3t=QIp0##fHKDp4E~m{g0rT|3EBWH{tQ%Zo zkzpQ|7WKXIuZZNZHok~d%!MW-VZtOG?x%S4XheZ3G>J;Z=wTu#YxXZ5;s_Cv?xv@4 zS}(Q|hv2g_5{VZd@vjiN%z$wbaiU0KWBzEwIfCfq zG1zJ`84H)HU#z?x<*Y=U$z-Qc7VLq`6qS9JXVRx!R|1YYoP;jofk}QOC=tCd+YZct zH?WN2mX;3usaYbSM6t1o7XLO`&gyop6p9~sG+sRnclc0IN0O6BvSE;akal^Umj39n z{LQpOk1bFk1@zi0#fs3O8wYAUi^OBn88W|4=L7`im_K1QSa7Ly|0v>3xnXls4C`s3 zOgFLLBoNizLaMofsx_!ECxx3+h~I=e7QSqJCuhZ&m-*RP@vsC$LQLFd+anmpVMyk5cYU1Ktvv zni6^twFLI-SN=;)_3=p^BTja2v@tyU-?!F9#u0Drq?CZoD(=5RqoAN{jSztRaOUUo z&ktmwOmxmzAhNqY#g*SEZZz%*N}6x``o7PhyFzVg8DM;lK0(2f%@289eX6~uMFxcj zLmW(FnTgXS5L7jpknjyW54UBYr5`vB^LWy-y-OXxQ2f@<69@_`QQ zdibi*ATW&UyGTz7Ucb^?0?xfjmO(L9dsC`!x(r1mlc+M#jk?gEi#MmN>VM$sny@VRxV(G!4#+Av@zg9dG+bN@jy%LY7HpGjM?ypPuvA}DJq*c- z$E(51hgV%Zl-h)E=w$i6&mxy3kb}xVgFI zGI;^Nw8Nk?sa#t&az8$Xe{^&}Pf@dY#-c*6xy5|0;_U1Uj4s<4QwCZ0p~ZTHa4Zd* zXE9jNFi;H9()M}smX~joD;gUZ@ZGBJ2beOIypqCnS#!A`wqGp%nBx?%q)Lz}MMYm- zUy}y1u&|<`q18G$s+DW0w&b&suuM9dB}&b#uKNDn8URK0X_0&M$Z8D|(8rL?#9s0d ze~*wURi@a|vbdPq!{e4#O^tzyL5&JsE(-^u=T}>OHs1MJJO-~>O&g>cTU%TC1qHZ> z!NItk{O-@Mn`IjEzwEcTG$zs0?ovLKEw}x@p58hx%I}L79=;+VAX3tyNH<6bNQiVw zNOwqgNeH@jb0E>=*{)7vir*`!6N?kD{p7EA0(|CZ(--@iIQ`oq`x&4FPL$6QK&Zl!RP3abxMpTT(yP>Tn;X)Tuvhx~z<2I?xDyf+)fHcwyqu1S~6$bM$mrlsC? zgko-6BtRcic<6D1+ot6~%vlcp%Im6Q!ooUAf|9^6K)>bc?iBywDi2tM{;v$Jm-mO8 z8|(UEPP_}-N_hevkG`jya3I6fw^jkYJI#PG(9hpLd_ozq2&Lz*BThuCBaf{S1cjS= z5gkgZ(%61=7dD7k?e{ z3S|2doSmF?8l4C2<)S2%%QM*-_+S^LexRHvGlE25es=Vx_|U^0Hd#EMK7cDa!oh@# znv#;Nsi{%t`~1JZwXL@cafPa{;S5Du)fGl|+vgTj;EKT%c580A*!lXyn_0IetP#~^ zqcgknreQb!FL3&Sw4u#dt}J0v(#*_E4md(gnzLhbWAo!+6GuksHhq_5#EWBAH{ctO zii&bs^16KlQ<{EYE!>+K9ZmjlC0@H&qx1WVE!s;UBa6?hL5U^3vs)S&7FJbNrB$yO z6P=u#9`#pHQ`hED8v59?d3(`kQ~`xP)LPhR)8L|-CF7wWzIgFM8rGkgWmuxq%+AGC zQ)Rhbu?_>wB*S234K1ztg$2*^{;#lnMB!!d_a|tmB>d%puSl)y>{fS|u5K1C=igzc za5t9Jdt6T>=+=8|EB38KKR$Gjv%h~|e;nGiGEh`BI;!aR<^0+_K>wg=w`9DE<5f$j zo(9f`jtOrEB?1sQS|(oheA*EE6hAbmyGD7@sQj1zUF9OU`yQ|6LNh!YVqh#{qN4X_ zn}V&YaK1PxD#1Z91!Zt=0)yoRila-ls-?0fKn*ZV)!2T9|8k+Wu4>#qR4mJNH=H{; zC1qdd4CreKx~)m97sSmS)OFA&iKBrL86C-jQgywx{|1kaj=)|ZbKPUB*MfU~%^M>X zbl#hvsZ@dsjs3TXEfZGWXVeJ*o!sYDGRzFgf{)uK>A?{Z8yLgp9LN`kf}T576K?>K z+9cz^V?BcKsLN57xS^v#D4w^JqB;9wEtKDgaKK1@MRKMVN{ zhZA!=;y-Al9##v;JN>B(yrZxHx2(SI>ewuS(J7E@Hzyz_Z4|uY|H%?IvRfW>eONgXc6y}P7#NT`F#O-8FBHzebTYfF*4{$ zFi;a|c@UUO783gh#@M(h1B5i`B4bi?Hy} zIe<>fFgtja<`^4?;xUbaVG{cbFW?JL1ln|E4Y$aLt-4Md1I4>j z3GvK!#y?dY8V$`q%LKPDrwffyIr_v~1R~c};$KenB?fx`d58 z%F%3jZEq~%m-T65ZDZrqTpgG#j|-XC_+4OPe*b-YZ~;VorgU7-&+?UOOnUqKHR{dd zL?{S}$X1r*#?Ef$tP9o3+wIXhSjnMh3LP(ZDc8Yv{%C)7)IU+!-=9}BLrO?iE|M{| zyYq0!_*K9bd>!Y!)&t!|E$d zXL^GqN@AkiS-+`$+j*(9I0aATQSxk=J;@h()7uZXS42+-4s2|!(e=0yJ1LJxospfS zhFgOO<8sdyP0Ni`-dIg_4O6KaIE!$>zJiHDH+Od{`Si4yO1rWBO?Y~>pBra_1vq!W zNw$(a1||N@7dwT7NrWzoPPJ5NePDCO54&1g?!`n3auJ}X)LJvq(FKQvRFP2Qg&wwC zlI1J!sEeETe);e6e|spmeUdzRvnkJGB+fWin@F~_*;VF|$8Lo|+ASJyINvP4q-r}} zf^v6qq2c%#fNx*?D`J=UchpvSs@QCNDvoy9~=*kk)XM9I!E8Oe9gLYSMR;~u5UpBM( zvb2~tYu!aq()itLa&r9nT)%z86Lb@R9^4&5FB@AQu36lj53McIWblAbs?%t#t(=`U znV6F!Jz1jJ)4Kle$1{8ut$zaF2sV5#7Z3NhUC+vU@Nrqn8f+XL9RYjL_z1njqsC$L zFa!FK!E(R47968B@sS&@IaR8wqp;i*9Q_U)uiC!_PbwwtiV245fKa$CdCD$@ziZDd zn|5%TTiv^|g75Ude&We3;6t!dH~ z@)`syb>H8X#5C!Yl9Q7k?(EDqTU;U^LiN~_fKV7V4$f3@>-hsRnQi*-P6C*bV!pC@ zy+5Y?#oi2tj=A$lW^{jCjI50^{Z|ulMZ!2H2@awm65j7W zr6+X?n=ekJS%71rT`?}_la#y7xjXsI=-Y{nC8$CLvLIIzEMCVuuu|m=!J#-KyJts? zpI;~~wte1^ZPTw6gS5?eEU_RPwpVkD2LWJ|x_5LjwKhr4pjDcWL5F~3`k%e>rY0Cu zK6=JO-8SxE26QgqWuwb}1)@=&d|Ja7?X;*U(1(!)+}8WA1Y>_D{#%(rc`J@Vda$#z zbGX~+cuc{aK}Jg2yc0h`%)O}7;3(<0>J&}_lvhRoPlY<>tsgp4hyTtFDAahxJlHq! z!KT@8&S%8{rhVh)-qVxUq=V|;Zca86FGIb0ky$m*{^3J!B7ugGiILIA`|8q#x{+aS zCo#>!k-de=&8?_+DK(Z}XU9Db4)$q`&uAGL=PR6cd&s>^C5zH|JU4&~ixv{P8~s`6k`bGLNrakUG-m_BuOZdS)@JIB-g(i*z;yYaBONAdaq0YvqijD__4 z(^&w9`SudF#(;|1Zj)bbXZPykRoh5MU_B`yU&wOXc$FWXmXwr~Mv%K-jfii)e$7KfEISq{@IcUg zb*`#QnlvlZX2f1yUGs201Ql?p*_k=?Fi{9D>@#F|3blbFi1T^mOa3!Rq9&sgPdss5 z1Bo9BFzw8rgX<}&scFk~IrnoH69SO#Kbi-kyj5|cPybC@@T<%gNPB@TwsN8$7Cckw z?s8>kJaU%_3VS*vxWfqXuGIx2A9f_Ot(Vy^!@>p$>X*6-A(M~*((9l zuj7{Czrda4U@`<$a3Ufi3Y6(f0JqYkeF%CSnt3e>bT3tutZ>&;Ncpcgi>kbVE~g>z zSpyHDM_u?Cr})Hgz{dQ%KT-I2yYyH*woT??+L%?jzP@g=*s$(_!N;QMBAZ85J4gb(1 z0U^xgi!z_>rp*mlF(8>Aw%p5!ySt0K z-+~B*ZIZ!p#W^(JUk$iu8`M44&=tZj$5!2 z({qyTn z_M{@y2M=joI|hQ)?6ozJJ25m|1x%?Sm9KWSk?5};_gSFfAPSPT1yVXdLBF^5pJ0QMDK&p0u%I7+bA6yxkuyfl1T(q_Yo1r^mMfle(=B zGw?JJmsK|=VjHHW#VDz(&y3Dn)~hNip7=cPszG)@c?*0iBMvEJc5A{dkg@{)D+uHG zjwg;QO$v(I`#&SUTCB121ybN^G2Se8alC&1J7BlW`{X_JopW+exuskV{f#oz@E1E= zqfABf{gHCMfgB5{l3C3is@lsa(g0e*4e6s6LGLhk8tXK2COlK(s+W|J((;5c-RTIQ zpP$pT^8VFr>g{2bk#~ud%IOCaws+ifz5m0!RLAo=<8h7qU|GVrA}mbC>oq)4igV48 z)2Gjfh&V;DCnheg%PDtnf19Ta`k3_InMx-{$G!v+tza6Dh@UD z$H=xL>ArK#Xc8XS6+I{v=&&+$jsir;fLEgGWc#i_-}9gGOper%Qu~BS7pY$(d|zZp z5B2^_@OE@^vb(ov631jC2xnyJHB<+hp>DSHh3YH_OuaBz0t5B4{^R5F++1oJrP2Qo z2GfkX`umZ|JiN*2$OOJ``CbbCvw_u?9Sag<<@OtAByca<3eH`7@_1}%QBTH~cXIT$I6+JE8n2oML<*4yk3>(~;+ zSd*LET>fs=gSuV#pFe%ZY4@I<6H1p|HK8e@>%929JOSq;jo$l`z2gGw9HNbCTR3=l zH4im&lSSIFR=X*9n(p51{0_Y__`v#^{1K>Q@>?Dn%*XZLkJL=oY~+4} znHl44c32Q*uqX&ME2Z=`iqvZ_@=emqIS_JKyAHX{{9&_o51j^KtE)J`pZVPJvN6Rm zFfefGvhCR`OXzULd`vFC`l}ZRR7d!yXWX5!5O4L61fGs~+2$yoDv|i1Yw?^jnbxoh zV~-}9FSqNKGY!?>M~ozG0QkMw>`v0fkH^W$34oZJJ{+1<5?>m%1@`@)tTom)G9yX? z#%j6ccZ z4Nc%J2Q_niYiQQ%u%ZmLxj;+NeDnkfN?`LUipZ<6fj0x@mytiwz`$^iY~#slMWXn4 z5`k5FULz8V1Ea0K^a33rJ5l=3yA!cYg8AXwLR54BlW0BPt3<z%Y&{*U`S&v-!Zr|h*`!Mh(h@`L~W{ae!YIPSPysvT4+ znAnLFyxG$Ax~bfqDz&LMoEyzCmXnhni51J@I>M7R_$WKy!Inh8&ru0Tx=Sx%OrRs{WEvAa^Z)#imSQOv-9a(&?Pa|ftfjK4Ta$C-SpX+`ZUpM%F3xc_I z+|vZHqa>>ISGx}%w*rHMgHhggcQ#%0GxS7|RT7oS<+1IL9rn?fCi<0==5t&=aFR*!x9xtkJ+uY(~y>z2gw5fm-;^QrH?arbUfRM zD|}*kw|X@<7w>;FTm|8-;8HEXvX*A9`)E+>@A6Ce9i|ps7~aL!{s7`{u3c@$(e>=AU}XA*hKhRFe7V?@?h(B!2JF1Mrh7+tKqOE<4E4Nal>SH< zu)Vzv_8EG|m&9m>H3GwY<>dHu9nY4A)*+Hc;_&WdSVB+F1Vz*bF6Q{cuh=1euCA^C zh~iBHnF0sk+-X=@L7}ZGAo)-YN(gD>(>+$Jrv$FI-i3<+sM77w^OFDgOzFA*^SezW z50AS}RT^fUI!t`>rTKAXhiiLHi$XUoSrj62^3q1<{f1q+q6rKR$OWL}^YW_Gra ze}Ny#_iraFz}>!@z?&X+EHXS!Bt3-Nr&^9d=lObZE>5aFio29s=*Hg#$Pq-0fNLB9 zGQjSKX;4B8dK*yrl`+2cD?`^;k1z8Bg>FT3DyKap0OP4E2ZY+Hdi#wudSb zG9m%5JGJxrQ&7VM77sXHC~uRra(^;l3j6)^>-3B63bk3Pay6S#6sOtV-RJk*aa0-` zgu~%AlUzUAKJJFIO>R5lipDWA2M2{Qvaql)>-1*KK9yE}|JN1=;{>lI3J(z6 z33$_T)G~;7>gvAx{v94!6kunMPK#;Q`*a*#kpskmr>z4QMiw7#EJ`PIOP8E`xIh}~ zW_+9Y9Pn-_06Ky<3@${bK_-y$+O=u40=+#x%&s@JwzlpJBy|S_ET%681Rz8(Ulzc12Cr^83K zc6P_{R+_++Z1qzjEwImdi>X5*j+6b5#jz5hoF3Xq{yGv_^by9b%l zzj{CWjIgi(Q6UPzd%&8jByc6ksFrGhSP>Hi5wL{8p*B`O*wH9>B%W0 z0@d5>?TtZDoA~<+P+kQH2MIwe!&<16)Rn^)9w{j)X96>bS`T-3H@z%=N>Bo%>J+fe z@R=Q}PM3lGj!PyA7O4Qxq2F*@TN}8wcS^LCA`4}yahQI^#KbVrGo;yk|D%{sWIeyN zz5NM=E)I)5DK?W9hEqsH3YG&5Ze!gz+eD31)W*uJxUexkA!CSB*xb_e1L#I#VG$~q zXQ)nrje3fDVxwN!9oOuf3YstuKv0!bzPba3W9C44Hczq$V!4(~pJF|0!uQQ4Cn{2Qxixa=&UpZ6F2oe*c-i68l)5Q2X`t*FePEO&XHX-O>n|B|Q}HH=qeyqU7*3 z350c5&r8g{pDYXquq188rq2GZl#?Z%BfSMGdaNCF@J*m<2l?jTXB@K;MwuSOdTdmK ztxxiMQZ&LmH67J+VruvD_`iSPruF&N1~Q34GA|$~k~j*KHG7eU{JZ>whH~(5liF9j zA2Mb}(yi675rv-vj)_{LbSvPZt;xdeHAiD=Di>$=pTUPlOUJaylE39sK|UGWXmcW< z5R{yyN5-w-^s9kLeaOrRQF-6{q(N8Jd0>O(V1hwi`x?ZPyz?N zk{^f}3=KFm!uw34`?D#cdi7XAhri@pV|K#U-S2Iz=viaiGSo3@j2kxb?<+wWib|m< zN}sWPVfr${H})hDeW83(7*U{zGDQ+MK)X0W`V@#ceNGI)G$48GO-`()_Pb5QJk>?S zs#YE+wJ;IKYw4+Q@ZgrQ0Fdj>S}+c{lp7lx=QK0{6#l2UxHvx_#16ozCOd53WUJQj zw0->X?6x(VmY$!VzfIL8ySey2>y=>B7f%6B{=owbUWE4`IFH2FE#h^c=HsSeXScuM zL&P+q{WQER)v7;b0}<*4UF`=rKX;(ugkgRnc3s2+MY%r2M&h!UINi~Cy90w-_^hU|s<@I3`fIiHd z@Co9e`ah`>A5D-Fl9JAVJS?!dA^mZ5ba0(g$gsJSSk_w<26X@#{6ztKOo+AvB`P>Q z#t)6WUfni~wHq-jSp87n$xn(8`@nWmvxk+&&3%%_wYskY2NusV1RH|&^?@dwB!r}r zveJzp2gbm_0HWRN?GQNV)iN+J!0IoYH3IL2?1eF z&}cy($~s3e7&9a^R5bu>5Cedff)7Z&APT>&h4dYe0=ozL!;lk__6-fOBn#fBuY$`R zK)}Fct*^rN>+aa_Df*a`q{U} z2=lrd5mz-gw?DB@^ZNiY51#Am37`znz(A%al8n#s$eUd&DJp53a*c?HXclDLHa0fc zCZ-cIpo=4mQBg^B2{2O9(h<`ZUgx5`#@qO6iy`0IPr&<-9NEXJquv?aT2qD_@~6 ztF!4icy8qg5aCecJW=V>zTk+>-U=v&FoAfunPI?$oSgD|j`5tN+~*A$)8W*z)MLLt z2S$+cCxaAtLWT=qM{Gh*Q{p%9#AyIoV*Q@<@ciOzzTsh#N;+Pr$@X_k%c5k=haW<} z6hQ?Ya%Dv&y-Lvs+kZk6N$=(2(G9{%Cv^DApim>DwPYuY#>NI0uNz5_fXZ6^Na~3rXnZv>HAREV zQ-myNe>FVV-EGqHaNh2ET2WECy0QXDNvWwBq2HpF6yxLLz!ko~SX~Gb8Aj|p{Yl0~ zMgzL6t(930=S;O)xm*zU0uKdfvVgn6$e!@65jgYJ)zymm10%=4 zA@ciquj^I+$7n?Ra$a_8@_L<|W;EaJ6xQ?9$4ksgfr`934N^R^ z08H%Au3DSL*t8g55<#8z3haCicJ}|?a(w(Kqd;J|N10{DN}v}15)Ey2qe6rtN{bmE zl{7#E0A|2;vFC^70w2`b+1XrUwyjMlax85O=;y{({_Ok34T6zSDr^|Z<=t~MwfOym z1AE5=0DuBq$(Vh6FohdfwAcC}AVsCt6N-R2#R381GTtPu%Fpia0UHoiR87v>8pJ7M zy0^2$Hm%hj*Y@Ivzm3<|1+PXPmlm7FMV%JhA&>jMLEaP+uC%Wd3_VhABxH_X$K>a7 z6UEGDm)F!5Gp9U^j8_|!3~Eo+6mFC>mdGAx)DE)Cj&4wo+(^t(CW}~`3u6}s{lj^! z`{u((+;2$V0;by924*fJ-#dIb{eY~zk&4ig!Q24}^t>4PdUbree?O;5V5nK!RCjt= zI+K!OC_XRQNNYr^Z~Lz^#|F=5<1q&Tk||c#yx94fFE#RDr?2M24*S>I0*?t>hRi`< zO09SON)ocN>z!#BJ%8#HVyI;=LO=wd2{@9gib@@m=HiiLp1T`^l_u~F79AN8yikzh z-q=_(w;Vin0}cWi1-9tO?(64o#di4w4Yk(nJ7>nmK8yJLx^dzBCZp&fEG!#7GqEit zA+vRG;M}+XD3+@nbG-KO`frNw1l|e&KIpcsR%y{de?J9hjWogE!rL7^bH`BY0Z z%xbw4QfbRMG*n8}-&@T(?w>JjYMq5-(wcWZNCHL%0oK^K5izIvcwMZWh*7mV&*o}( zINBV;;_f*-Mey;Q`{8JF0V;4b5{Or53=4fM;14f5sw70h0f+ldKOJ;b+EsF?LGr}q z*IC-`U~K+?`yf|18(;Hc={Sz|v&^jKtge|A$C@)&;#;lhR0e_emlsX%V;N zb%I|#FT^zUC_bay)lq9H#&QA@Yu3?{yq3lL4o;VlWSGT6bp**ZhOGzD?8VN4G%X#_F1H2}TLDBBDS4WUi? zpDiqQX~>}-AjcStbJ}uwf37~GZoU+c&!}}3lOb@~!@cNn&E1-m$Zgj*YV5EHmz6+i z%`OGdOLa9TGc$Z_)y&lNPidjFl$3eRoE4X5N&jCSU<4Kx_+JDEa~If9M#z!yutx*| zQc^RS&9otQjFMuy_GQu7_IK!`mqYl>qNQ$&L057Q`PB65#TCbf#(BU*#gjG!_l$;7 z&E4c1spG<@Lho@C;HYu0|J?U0JZChO2#CReAcTq7slcU)WMnF1m zJ*#m1fxTFz@JxQy_7B+!*?WqO;Joyz8Oz2c_tKS}>SG-0kLPEC^64K%S2s5R@MJNt z;fl5)pCVw`)e$LEzbS`dV(@spkZ|x11_`4=`44!IL2?fmpIT}u5`ri;Q$uxh4^b6x zMWft3OY5)J@0Chq`jm;^^Sv#{yxgVnk&V^!hGKPa%&`uMy9tvEpcv>dm0qL zKuLI3%J{wwB$j{Q#@=_RZER?el9mG97oJp2i|;)0DM(bLrKKm%pB%yb{QRWVp4yrk z4W{_SM69t~dGJqY&ERBBPEIcVX<@TBvQ%+)wzRa=wz2}Ashr$FcArMGO+i5cJe7Cf zz8-LjH@r?;%6wt9W$IR6zkbzDOWP(Syqteer9(wTohg@4c=g>5sDDhC8=4HJ^RK7V z5!n??7|<~>Syjw*hf7ms9$34KlxG4^CFAa_KL0X+C#x5H{lsL_Ah$@=rfffKaByOp zf3=JcVBm!}4Gm3_G4V{gCFM)K+m1T*9`z+PazR+2m+)b;Ql9z8U!Zp!D=nLWkGJO% z1T*KuroGTM8qGah4z2*OC{nQHI@%D5&ASb5F{n{;A=^g&L?nyMgt__m9wl&H#1oS@ zEF46=6DOLuug%L7*9qEoZUh*0&aet@R~Z{1S;xJrIXJL}*WbM{CzPTJTwvpJEpk2s zhC;$+In}*+QGojsUmARRS}nXgKDrdO^=^!ONu&AOVDgi<7`^B0{x>f$IoYyssz?D1 zIMM0BTd!|D+8%I3N33ftTn5JjqPfwfwx|#x3e1)hDOhX=b4$fVZVs8pH8tf{X-tO7 zn%y4CN;tuQQ%hz)u_jYee8N1SPNqzaedbG?&|v*0 z7t#Aq7eP#|ymXqAN1yZtG~>=>>nsd&=Y7lsQiZeAy+`+eggm}u%uV?Cz;O~r0iWd2e7o^NVZzhyfxvS=9fEHseP*R|sU-7ndS{tYa&bIoO{+fUS0fC%2=R>s$Sp!pN-4 zp&jJ@?JvK#J~)>l1>$rN2thx&PBg{aKHBWNLBve;DPj(!8;GP-kQ557{?<=kKSF*q zi1$(Ap`OjgBg<*p;B-o(QP^}5edwD4Jgvo6h2kj>1Zx0l5GVpfL+I>FzFUmeHAW*R zP0O5veDTi6B0gzEC`O>bDe{&e_?6?f@SM{YaJvUXkF%RN#dX99D>zN8b5thWm%`~u zbJ1)y!EiAtLnxk12-0s!smVspK>wxW4!^M6i?Cd-YPQRzKizmDL0sSmnnuG1Io&{O zAF2Df-}^}JMG}2EMA~e^<92i^5+mGhwL|sM`_ugJE#AU z9iEv_R7W4`l#ZL6K<)wb6d({~IK~YTiDcDuXuo)6(0Nc;*QGqU@1df*G(D5Q+lep^ z)=B>pZuuuw%}`7>uA0F#mr9-B@HF3od}>ux8L%ADJ=+XLiQ7y zZt^-G3C9H`zGTzi-}@@pZZriJaEpNc@~m1{T%OM$A_%&LZb33-WkbboZLIsom z{V#X|lQj0;_s-uYj(QV^IMwXpqAY8#xWxSOZ0n{MvI zz@GPhdOH8t51hzhPs>A^+K&Pm`IOUF59O0OUx{2+$Fz&~+*B>x0_4Aq3q^Yg$Ra(Em8z#>94lWlwgY0`IfgAeKEi zDyQ}q0GqHZ0LKv`1pOonzx@~-bsc$?u3$wthDB|=cjD&q8;VJQ3SMZT29UY#9sXd2 z@({(O?6a(`r`{S9J6Xm+S6W-`rBOQj zNb+VBB-4H!y@Yh1ipP3V(isLFu#~>!Yd>Vx9d(66*g^G_h{*KuO9(I89{HLL;dmtF zI!7f_4wa02|GV&)n|p(9f=Cc7037}NmuLfF)e?-3ZAp&}Wghn#imxk|Uz^8W>yL5u5WW)tKSJJth~WMw<*oB!gBTJvF+@paxEvF^ka-nYXljpv z1Ypl$G;KeKkV$P^wlZ02%-nSJ+&>i3qd^N*zH)D5N3eo#AgExYFixb$7I7!XF0N%X z{uK_Pmpv${WhfzJcOZa+0U~~0CWf5hQcDsJ$BdGTNd3rNd6&%J~yW3jE;S!RTRGeg4uS;x$3aAgv)4y)e;O7<(a z&-AB#UKWIg%_rjjJ-8()r`UhUMn_7=l1o|tZ@>KB_G+YW1s*r4o+@`1k1Y4ZqV%bl6?MWU^fMc*{BvqL_e)1)vTlNT;jJG(pS84FTYmWVV(gAY?}?k5zfCspcIMSR9({U)UB6FaXKg}Q|JWM*w|mPD@ovOP z&OU?s1O?qb&@RzXP{4y}o9l}O-q-W9$&nS8S2_UScyBGXSGKMyyL0uJl7>e5knE%F z8<&+%;ObD=*K0iw#E{KkGyGNZqM>@m@?kAT9*{j(ceZ}AsCelQql1b$z-G{$uE?p% zUilk|2U-p?H3l$Y-MGootgpNJ~58zGvZ1K-Wpwp9X6dtcq9#ebKgiZiPfzGQ41-b zvyqAM`r6taaC3Jji${BMeCqm)8XT|f#lGb_hHj7Lf*^?rK2%y*2r~6KR8*r~%n2|f zcFBy{YKw%AL9+`JC5J;eWD6nii8o+Fx!fS1$Po8V2oiA znyhLx;>AzJ!v|x;3oWfY^D0j2-Sb3EYe4nR?Rt&XT&<0~gv1A@n=_y1Xc(_?KOV2e zh&Y~YjZ8%Hb9qnoT5xQP76>$ObL(2IiwkXfv$wwMyQoOb|$pNxdW zo6J>FQ2^XWGsl3M8Ilj*zqs9>jmg_AHeCbS?r3<>7QSY!RB4Xp-I7TL2nRG zINC!FWo(W>G@?bYCWgZiAPas~n5c_sI2(H;(02QWxRiXjcTMcvP=CQPK6PqG>Vjk-pzS|*ErFXJt^DP3hZJa^BDWC zM!V6uShH5{8jQCjPM3y~vPiSm8gPP6#9Mf5(ogXEzYG|$8)xT9zXL2>%n>j-+RUoL z!agLC1q<5yHxD19E@UV#7hE#VR?_p8a?B(Ssly3Z9eL>tp3duw|D9L=g)|%j2_#EM z6knRBHusTB4ZfuGm_rdrXS83a;#rBP;#FSTl| z7Z^%gq(s2>!Ykwy6x6*|r>luE{`M`M$3e_Xm2lL5Q5bb9h!*^hr4~=ca~?s#*0QoM zw+BR1mz%*H-zbK}_buLmTe>anC+d>e(0`DC=W%$#A(akyEQr)7{jacLWiA8F&eA-y zh3ojlyxLgFJD{uN<^G%t*ed6{Q#d0lcXywkKko?*jdR-h(IDo0Gfr21E%BlWAZ|)| z@};`1Iwfe*1%>}5x9OG^Y1Ny5owgIUvAerE9x?2eC_Ozn0qd`#rPXA!)Dlk2)w@eN zaZuvy2~C%9r$!PMdSM&**`1s)JQUuzZ&PXH?RRa46o4X@?ha)>R`TJseWu- zT<~UO7aX>exg{{oyrwmL&U-(7c`9e_`U^`RjK*?@15w>W0jEz&`n9yQ)Y@E5ULLZi z)z<$zxSeXiBC`9+iQlpORU;W5o z<($-&Ok{G(OmI%(3RRfY%7oMfT5c`+VK8p%={KT!ppXn8ynII^;@8*LV5oDnZTsoU3LqYzD$%m{;LskT;6iq@aXUg~A>l z9QyDWoEoaN2GBT)O|3Ohx<|1odU^tvABqlS56?L2>KA|M9^I&-qeE7uKeKM{>2+nh zMTSq|b`ngp);#n(o6^{{j!JpaZx5UkPjXurLbb z>}@UP%0qnJ1HR%Ot$*}9gMXCPS@UvcuV`f3L&Z)?M0xWv{I__^y_$2xr^w6rGgI)4N1s9W-Q%X6D(?*fC`d%rYC2C`-h}d!$SLI{>%)`rcA8( zZRs`IqZM4sFdZ=f&$1t(PV++;7Q`{DD3Er@(1>x~HS7mp%kyqLoq{1#>lpE?A+$}K z28sz`lz`XZ(tZZve|qQgoFctOYT&~0{^J{d`%DABo=c{}g|XAn_XSL^5N=+9V+Rq6 z#)h2XKYZ-=9&>1~;*~es?PqCx`>LX~VJET6VE%I(CYUlky*H9CAPx2R?X@1s7&rte zN;5xQ#-;+JajXPf+dGa)(GP$Z>-_`x@Q|(i41b&TPfI>4vEAZQ^kOb`Ilue&E~ZL# z*bWr*Xo0`Vs`upc+~>b;@f^u|^SULeEt^@mr8@SQf6*qRuK%tT>G5V>eGmSl@#(AE zp1#^`l-Yw}=t?D*(X%v2wyavvwp{F{Vlq8_kVYE)I}!msFlgwMPZKFmUWenqYc) zavDRmpHB8U;~7$6VxS2Vn;Qn?bNHKos+^EvNz>&Nwk63h5s}Vdtko9W+_S)2U7YeL zGMj>|ECWSetZGof7P`{^Lj7itECBUx`Wb%ptu02V;VPI)kkIKMWpkrxW9b6jpBeRT4h0^hB&40fmm{n}w7w#i| zLveQtbZpMraOawW74)dIN}O(4Q0{4u=aIzMJI~Um6T9JX1vWP6_v}uIT*z*y_06oWkC{nK%;PwVZ_H<|UPlcaZ)kP8tX#4H3U3=|t&-L9}nK^_UNM zZ%k|@bjD}02@G~3dn;$?&AI5l#O$$WKS}Cy#Q`;f0{ft3i=J_|0*BfQU z@9F7m0X`+v2RD~tq_lyJi$H0Hpr;uyNlpp#!U%E(_LKtc>r?p9Z6M{ko&6|sc(ee| zOG??$E!f5CBF7`$KXZHONfhKv>-tQDBsuk&_giH=r3;lh*WMnt-Bpn=+PRe~8XD!! z7yJC_;*}Ln$=v9|PwPNZun0ozvNXDNU5A``qhTacF@%&BSsMD$lsTP7`)yc&X14&E z$or=?2z>Yi(W|o!rStz~z1dQx_{B>o==F7$s49;30XaTtW#fXFAhHPE|NrPO@aR|W zEn4~E<7Sv&HvB+5QrpbZY7XoiFQC;2a^XTWTjYoku@~AhGsMP7%`Y1?G-Uhe$}9P* zbF$v>aPbQ~JlJH5y0x=zffX2jQL_Q@{t+8WcfS<+AJ^8IbJm&7#0yl07)?I$`o<;W z1J0THq~l}WL1LsA*)kAEpSV~E=1XO+En2x@tTlt$((0e{h4yke#v9L1FC)n8Tt6ZS zB8dn&q9vn5$X?}e_7KT&$flH;>P(b*?3D&ZRz}E5R`n63Lb5})GBPSD zGi8J_BL3H*`hM>Fu0DN#_x=C>f4|4i<56+m@9Vl=`}KUiUYCLl^$%>>xN{=}0@QE6%R)eZv7su9nV|JxdX8!|Ya2~32F=Jz z|1ibt6a`NeQ`sk?;Qu%o$5-??#iIYj%HJpW)hc>Tv>7aRI7)-s>` z2c~EqHoth4`Q*o|j*4mw8p*|haoEAZ_PgyEewU(%ni|tq@FFrMHuh8pcV}598{gK@ zh$I)9vKV-dg~E_f80Ih>tB3@)gxUi`gKt(})pMZQ&^^Du3XBDYhazx?VR%J2P7#g# z53d44rjlGp|M)VMqDXgO*pYx5Z0tx@GzCX{D>0ED%2iZzuytU7g8_BOzkjZ!re?@+ zpxfAj2hN8M5Ja@p)i7{81_MRN!&k`F(^J&4cXlD!Q)pU5Wii03yp0W25lx2C;UqL2 zilWg_P%<6`gW{-Y1eA)U!O3V0ii*YIzpp1cP+XaY$y~qcqf`e9*yCU1;Sgvf97dx< z(R2zPilw3OP&^HV0TRR@;B+z>fx^+h?`FWT0bzn<`}bX$R8hf>NCW{#R3{)YC>TN= z3x^YMc$69np{Aw^L%=i$KmkmvPy|~5a!5=+R2Bnlu6$_9v`$;s)eo@<82D0vGynef z-0UBo|LgG)dmEq!gqR4^u2w~F1VS7TF*s}GGea8>nyo3(21vzug$NuD9P_V7W`BEx zLcy5v<6pu$O!IKjC3(^q&ffwPfn@dVJ6oH->3roKeUcqG*MREaAR_X2#jiYM?)2lK z!awZ640IGvGQ+{y(^(!wrC;p!UtasCeg7wDGc+&~0d`DvrMQUbx!Steh!~R?HY9tO zUl950_y37n4O<$>RB9xKh!KdX&cE3IKfm=)yZ%qe0QC!6P-4u}6`1*E)ld|EVM_n{ z_`7SV0;hKdk??1Rwhx0t6Yy9JUX`GZ#v{}S7*%x)QH=n{p*3(CLGajT@OUy6 zil>5qC@4Gyi$(nDUT_=|hog{iP!tx9V(x{9lF2YQl#ZZc$yhWDL&2c`bT7aP0uHBw z7>Osr!CqLf7X^uf;!y}H34@1Ga5(s%?uEi(=wuQO2gSkhq*WftbTS=E$6!b(9126H zBCvnF7X=&*!_uKZ#w&Y)xXUCCkHw>CC^(KrMWFt4FEj#%r%+HdC=vw{+KRkLR4f`O zlR`$LX*e92`o}z?k$5};i6t?4#QryVM5Aa}7!Ifqg#|{osz)lE0;Q9&csv@3#bMB- zKjsmQMo_3!3Y5l7@hf}bNHh}2dO*1_ESy3`{;{p1@jxUrD!`j)>Iz*Lkn_+eD2@WB zk*E|5422{ADP0&C1w%%na8MWtwXzp*9~c=p5`|8qpfDI34E@J+0lx;>6GnkjP$(p@ zP!s}6!s5|TEQX53P)KMTFtb0U3k%0lad0{XibvBiOnH%^K;~p99fzdAv2;3$PDB3b zUU&qF21g=LPzo0P%_i`0Bppg6p)oWNBHn0?j0@Jt*-!IJTS zN)!wS`(s-rqw&D)5LhS;38-1MFFKh9rD0Gc41xrsAz<`B<&lD<;!tQjl^MUj+XMzf zhvGXQK0)}HkaJ-rtK^22hM`E$6 zC?Z_rcPmL`U{t^o@NiI|lTaXckZ4F?bHK#Va0G&mr2cL-84CyEg_2<)b|Fw87?OaY zL173u3J(J+CI8G6e(*~I(xg!FP#g_OfdcD_@sE$RVkQnsu&Lyg;siQDx7=i$Ri8@*p14F37VXEK@i3h;$ zH@p%xaB6CxNcYJWH=HI1yLVp6~)vq z$kW(! zOHfzE6R_%kKNF9`;$a}xVDW^XB>L~#L4rI5WDH6G6aogtlR^1U!UJRkYyzMm9HA%fUu4M(GH|*9Iz=e33O2K zFeLgXF#gBcBn%vd0B8{yASg~?z#_?L0AP?L93Do(fN1?Q@c3gjg@m9{L9C?1U;r00 zBP|{VU>OyOhSQK#BnkVwXomr@4XsMl_`9Ap05B$?3F&Gm$QUFd*QgQ5Yni3a}~lH#UaF z;Xp3L|1Wq17UVGk9D{{}3TGu30$=*Gh=)}pz|;shwI7lKdigV7!m6tgKrTf5`(B76 zfJ_Smxfid2W#)Vw9tl?i$EvI2(W*$*-)IL%rP5${936@PAQWIlpdB0@K>^xf#%&6T z1hB@hb&I1TNhm6e2BqL=XehwMpmqRp9pq8~Qh+_vkhI_U5+0_3#i|iO3HdJ>tHKGY z8X9;k03N^b1U!rkVg;x(=?E-1lIg>E8kqt`sgm@^N1iTQOjRqAkf`&jNNLYZte=RXQ z6-Nf;HwsFpfvN@+B!GN4XfS{t1qFB@sKaPKDNMgpu8PMI5I7tjqx$dSEMUuMI4H1x zSS7G$RRU2Jl(bkZ9H#zjiq()v0s#y9sNYc`6Xy^x>KFhg5h#t{U^_Kckag5Cn7`{+ zO&x+gI5n1WS>5!C*Ut^UmWh*$ywfztr;`Bx@WQzxn;FmNmpq5d0O zrH%sG69&#js%tPYtSSM6!xP|mB501N13dd{36ansb^~}1MWe_dozZ|!aiA7}(g8li z(P2oC6n=9qiP?NX0t-f?Rwf8cG>D^6p%~D3Lf{Y>9GUVPiy-6hpyUDB427T|phya6 z$&*L`FwtpL(7eKufX;v8{S*=$3z7*E9EKx9F<9o=7%Ucw#ltBGfX>hq*l+M8g^XZ& zI9P}W6%?Au0|`$C_zKU=-UuoTOZ!RT`d!CVIGjWS?f@l|$at`Z4B8jK4S^VtfDI%W z58(H&Wllw6DF_U+Zh(P`3yx>zVLE8_fJ{z8Q80in4DC0o(JYrlNwn?|BjD9j=N6byJM z4ac-|fWttu3uH_b8cxN)e&Z!{P~M}#8$i`aJQPD^Rsu9&aG?8ufib-oPWlaMqhn|Y z3I>2wI7pIEP#y!gip9}DDFOriC(!-F(tfuZ1OzM$&vXkU3Q8q|8Wm5c12{y-ATbC) z3i&^@r+?nF|5nE4|yifHWj;p_hb)!(+JSd;9n zXyEpO!phu*Id%b4xqp)n4I~nwra>gE0J)zuQGU(`9Ca8DQ$!;FKjVYqVDCm_{LPXa zNenP=bOEDDWidL#!A^wa=xA$0S(&sdxY<*`-D&tSX%ca95Lum9pLC>I{aRpD8pGyq zs{i{jKWGs7pFHp%ElmUUe}snqTyXzV15+vgptoOZ>YoLN{_hD6|G$Zg;@}7XR4{NT z$XB2r#Y8+f(544v2m;JJkN`e{i%S0~+#ujkP;Vo^wGfyh3PhZLlb4m7C#b&#%6}u| z{BV=+H2vL&{yooOUM=}$i2ief`v(*IS7`X{dH-l{Ahn`lbTG1mqbV5XMHSFD1Z6c8 zq-rp&1U-E;0^HR2k7?omM?L)`KPVW$v;a?ot`nG)BbXHi88oM%6bhXVy7X8$oq1K} zSNtFpk#I#c=HK(7|99=~$9<*$R^0h>yZfIx?;rI9<}zSZ3NBKC5kCwxMF76WqriXx zGz_SqSqbI}NXq|4diqCxz{r-2Bay(ol?Eyl3LT7AZ~*Otct=5@!R-bt3G-jz)i3Y1 z{TaOauQ%;h*Zm2^`oA{b{n^F5{}dm7bqDc(R8K4A%xYDl@Sh8o)t`y0Fi(St99M3I zD*miA`BO^-*F+V;MZ{&oxa`^7A9wV3(sk2}rahab11Y4)I)V1PT%dyh($LLe0(T13^u9*Ltp z?)#5+UV(k|?oHUosy0y~zLuM?X1j!0QzXqSCfK&2q}nO*o=pNZs^@b-0?y)|fK}4a zYrF0kTEp&qulxS{xp#~BuMK>?uo>q2`s~@ zm)Em^OWH`DO4#PgIqz-dqW+gBv0Z-bVu749tp1!cD(qa3VbnEZn=7s7+B+pj^m0YV z!$l9s_qx7(F)w<3{P;%4$wg)6MelOgZR%VXIEjnOoUkqTts~>a>L&d*i21_V6ZFb$Qk&OCvxM^K=`Z%STen7s zOKc`_QZ~xmkq!{HOeCksV%bE}N0!Zs2iWk_uY9G-*R#t2;u~!*r*Ecm=sKs}GSj-? z+j*ugC_u{unc5?)mU{Tnhx|NAt_VP8*BTZ{2;>a^*2w6ybph&8qo~=qGq1~((v%Th zU*WgI!ny%Rnh~{Mby)U_q^yNNVEw9*2uOFh6#s`{DSm>c-(_n9n@qycSK4Y zu-RS}TM4ZoNk8n?k6Q1qFQC+4A_>>J#wP`KkB$DJ_R&+79O z5&yvWnccB-X?<-Au^9#G4L!o;YPW1AZkx)c_9VgCnpdeBRXrHp!mg#Q;+US2Ai7rc zaS&j-_A>FV6|LjM-L58<6aGuCs&9igZR$xEmK<4 zuac6(xPxYHTb9YSvVKrF+pwyItP>&E11>-9x+De7Ds0;LD9cDJOkUr$EM>3BF2;$k z7Y>_U2BNk9CR$dgzfYwX%BI`471b2V4y;;qd!Z9;e#7|I6x8l7S$Q8S{RzP6Uaeix zni+d!^lLh=9yj@Zce+irglGs?L=>v~w$tkDJrexFnQVE@4_ zAJ^2RYE94VUmwE3d!tA9lA|9)r9Nr4MpE*@OXN_w(JI+{RX2$$IPHt4vWqHioH!oS zvTaA-P!F82eB{A^@bGYvr_dWSPDAi}6>&+hC)+al9?yA;+`rUg-THtl%oBC%?ZM;O zwYK3K-KNKVE_r!Z*B@wW?J4H?_)WX!agVzKuPfFVC0>%!(~*Ae^FH_pUYT?VJ0YJr z^3>j)L3* zA02tKd6GS$MI!f})+`ZK7ZNyk?M^d4!`q@-CgNSfXMr677nyV`uhKo3qFAHXrV(Wu zUUy6H9AALx-G%%_($(6gB55t!MT~7@L<5uJ-K+M<09xnhOsym3zL`cBYTqh?*4#fg zc)-3lPU1=-*wk)y)2}k|V(Yv1*4Ts{h_aO#>9$53kXLbA5OU&n?>xRnIOSWY*&(y> z^dP?G*!Hm5w7TNU&!PmdYAC!>x%&>_;&>J#zRD-NITG?SU!FwW+BT`ottY>E)85?4 zFzei+=St;Pt12=v+!nx96|H}_Q?ynrUU1S7WwvdX)9B1zG4*ldX~^+&=;-@rzq;{# z+<}Kc?xsL9&OZ^?^yd_Nl@j^VA<_}%&(HJG?as`8z1hgXz)As30Q=hUeQa+mI1QUM z_0flsd-?lxAmvBb+sWRb@#=+{IEHujnNDEwQYr30tS&{p)Po*X5nB=lIQ5$MgGCZ_ z6_zBZ302xlcgNXUZU_u}a9cGW|INAlOVhzm5b+YmXATv`esNw9u0Pq()@mV>IRY|(B(Wc9l z`ZBy5s#D)MdJ>Gey@^?^D9fTF7ROwt`&`prTk{$dbT>fa#DR~g^YeH0d!KC3YOrP~ zg$;DL@DOTmt<%CrioYs$JxBB+w+T%?EAbfu3~}lm?lRjVxj{^Gn}lrl19IJy!9I~2 zWg7yx59&J|(|1btBDzj~EZoG_(4KbE$aDi7h95)sTOU`9pFNv%+FvwtEu<03_q0bML%c=8Dn5b4ZWFZe3*D2~X<~=Jf6d-| zB+9{uMaUr$$Nl^HW#rQ8g7!yp`djZRnG7nzC>I`)_*{RFcAXeqKt3yB+Uk=XLE;OP z1^Q)MIB(DKB>I&#quvddY0V%zs~e%Z1>|1bSL`fzKGjQSQ6DR{>xnmYw`x?~e-<6h zQo(4EkdBvVy_|B<@3V{T$>M^GxpOnL4Q6%MmO8yDm$=sI>;@Y@5gZk(^1Mgi(#TJE z=7Fl?To2FWp5TH{WF5gP?i*|Ng%cd^m=@wiE56=sHSz=E}bll&+$(TS9 zOP=qU_2tyNM?Tb-yf{0oMv=N9I@E4p3Mo%iKNxMppm!wPJJwr#7N5{_BACHPSji_| z8^6&gl2IJ@snoS+Ra?k+2D3O-Yg zk}maJbJgbFOR;$BxyR>)mt%+18SZ6gEk(A(D1S+?I!74fx&M*VYz>62qD$KN^vdzz z{!>zR1&N8aC&Frj)Mdx9u-^E%Ps5S4@o>SlnT1nHJaMDMDAcur{v8GZ#4p*`2#&D7m6#3Ik$$iUj9Ec-Ol!KKl4EE&Cy zo1CQna(p5!z)mPoIUW17L+=H56nDYf+@?&`6@S}Acha>fx$W)Ko$g7F^eup61{%*v zU?&oUcX~NiY6K1Me0>(OmL+4Es|`C_g>{?h^Q;z#UGP52E_(O@$%fvd!h`=M@Tg6!NvN8{hp8|pM8tS4S<5nbb+<+=Y%LO?GPd2Wz8TXn&ND8g;) zIkV4it7B{Cje?Ctg65$$kfE^df;h&Dd-mkrAChJ24^Dr4-D-=*Yot0XK!d0CP`mL1IyR|X{Bl{ z+u)IAGbRs`?v2;g*8Nl0jk%mr=w7N zZ_&_O?Ud!<=TkT2v$j!o6&~zp_k6kaxKGd5hDWw1y}0%C-Nhw1BISCHzOTtO%cHhk zy2NUQrtG$M<$%QPmAOO?X_T{0!DMh=EOKilhk5sjIAc_D@y$JdJ=?K^m(WmGSgFE7 zo9t-aZqdnJO|X!bph`$mC9=C7WlovSk0gx`Js}=)B3vjsb*bb$vhxhPXgYOT`)ut{ zL!VT(`OD50il-9p=q|zC1=IV_YTl)`-E(jko^CCNKtv#<5LvG$HPLh(>6UhaU>2>% zHHfrhxX@zz7ftgoW%4pE(_$yqPrB}xjnJ9!S=yInrlmv3b)1iRu7$sKd~s4dJbgFo z+0aiC1b;)NOWD;UHsgw)yWe(v2=%}0e|zA{%T8&k*}gF~!t;JlySK`45!4G5l#7NXC@4ZCNRsX+Lf`=#kVdT9dvv6wH#ya|6A~xy zjhCL7d>gqLJ7K}iH9s_UXigb^W6q@|mnh#enP4RtBBjTTh)iDW+4MH(;IW-omUZo4rikdO$QY`YiptuLYIf>*^?jkA>(=A9b)b@F2rBTKKW z)oRs{8Iy=|$G+Vj^C z3o>k?RIAGxfp~r8Aq=NmI(BiZ*1)0g@Op*Y>C#+cfpVsn{+x@Ys9nCx zXA-c=MHBwd9UFRV>u%sA2X(Xbjm_6<~AVR*_E@-f#=Z+5*t$0}W ziT;FAtLc%luhQXHGj{7>?mXCTC^e9=EoV=db|7gw#aF1r&Q-7T>5+m?)ZTsiK}Qw+ zTuBUjb1K2bF)p!0-@)76xheZS<;t$YHNzKMqL-p3d1zQOovD+}$KXY_?-yOp)>hlC ze<5I=6>h=5cxj>Yh3tcZ-TTCErR7`^L0HU60@^LQgj_;GT6$TXqMv6(8M{~U^E^AQ z@RZ?vAn_%cyzH)(d+`Yeeb@1|(ZGIV0&uhigYKv3{7#f`&-~{kgWgKzxXTgImt)Di z;^x_c;UVFdLc+}-WDc|jZET8r65%v-XODRq<-S=+^)cx?=_dyB^SqDu&{UL?W;P!G z`t^Q(d}fe(6i*ZvyXZMFa!n`eZBGxQ&g_|r@zZVF&pkfp;CC`h+@RvG>0X~xo`zzv zLr}|iqZyC;#WtwII=4XL5?}$cM0iNG#37N~G8b;M(Lf6EUBcki-CVs%2~rKzYuU#t z6W%`8DHkebmzmby5hrwzW4GXlyqWK9M#W!Z_je9FIHzlW7;BgPG!-prp6B+$yXSKn z+m!ak(L_!`DZfvhPj@YUdgFO2m`kYmF{Nz2IoF^}win6&_UhyMK>x`bB3BxAEsxF0 z3(GnbzOIEy!1oqf_akx}tDi@WZOJxfoy`mH9kKP|7Tw0hwub_NIPX+H7$|aKt+lQV zrd#=Rt+{bz57$M`p;wFkGcpHuv{^`|+_cQ<)VTEOg)v*B3!pkJirf@-bWc&=8_I{> zcM{e`gCO_HUFeqJH4Gyj!;3Oocq8S1nWj53x4lEzgH1Hu=V?Jyg#>~9`sLa>hI5;cNoi6;!EZmd}H0T_JF?#k@GS8dj_EDNcniZ^^FhdgRNQ^Quj9T zGMqw1(?aRdqxU4l9*?~}f3;~xx6Spc#XB)i{_vfMtJ=;gTJa|I9D7!7BG7B>1LruYH6+E#_A!KjQ#*bOg4`mO9oLM zYF^Mjnr5DtpSh@Q#>E8QueIk zJ96$WwKVPZTgJ>zSTvZ_>6z!vyh@IWsX^*6+NLdS56U~9ju8ZYoU#9u#6Wwi){Ngp zoz~}sf*AdwdbMN6OCR%8vLTZl)@a`$icXvCh_@`fljc6G<8YPy?8~JW$fB^9*LW0O zo7d}kiup&M-*~?-VbN8co~Jsp&J1{s?bOq}J=AT~0}>ju`7Yvj^y1s2kLSiG%au|x z8ah!s>AIfc5Qv9~2%7s|o(p&PF-1?=J(*~!s-y&M&*Gj_9rYge0qG|?KC17(C3rY4 z;Ap0G9D7uRe8@Jsj_rjqp#KeoJWAENYpIUk( zc3<3ANO@FX>f_~GHQw3lZ?W2yjBUYqJ6Rm7I;r=m`c6Y*SfG?K&m*68_df@|hhNE7 zeUvg~TKGJaS7#y@v3Fvn>2N04PJg5q-jz5iW%O9vD6;iT%XQjSjoAxdb?F_IHY3S= z`{E>hChbnVFm92^vQ9o9u2+X#_8PMjC^M(}pk^N$+kqa-h-ggXp&R+~Wd6jfmzpd~ z2@L(6vpsK1MJ>*|#4t1`$E1xPA@F%EsYfm?k=%E2fUe8d%td~q7aw@4dhU9sevnYB zE!Y&fen37yl`>d6xNKs3tP(PWJMOc!J+bhln}n#i?0xE&)Vu!0+Zx{64(2ktB zE>mCTsr}OToYaky?u;mC%T$)xP|0GVSn7y@adyO%&x5vIak4&>TTZyPdN#O^8`SFL zPT%}kb#qL`vvD+qVMvNM#5Amnmy|2yMn>8B)=r6W7q(BK8m`B;=Hwi|o)PuZCAF-r zT0Mgfa)E;Bsgm)>8o@E^AAPx@0{WptyDp{5T$|vjygHiSDQ&G3Pb5N9!lNJVHTZh5 zS_f4Bh01QQmvis3%KA=C_bh{WGILGIxHzx<{rvogOS}9gi(*(fv9okc1a#Xbld-N7 zp0|$d#l$sfJLkQ&MikY8Bnvet8aw;4DQxp+jz``B$t*KlLSPyZ5;wZ%p5?N(mG2&n0g@l@$*Tp4&5`2e0$ZA0$7zHS1ozMw+>9Ve%ow>%1(p z+k7G@(Rgx}qF?O1eQvk;sxaV2Ntj>j{+<%+$M!$&UVS}ORxG2aku zoZa(ziY-R8rS2(*MY7zsO+1K5fN2GfBIcSByl;oqcT_GYdKGFJ#^yY8e&1i|p@d49 zV@um}LtYVa!td7740pVo7${^;Bo$!k56rvmFx`5b(pq(}njJSzuC>p&d>Y}f^vHC& zv;h(~=d#YpTW>liR^{CX$DA)j{LLO2_7Ex8G&N& zd~BI`O=K7KuZcAvH!c;7AId&ir9EA{KV>I>k!wbnuYekW?vT-`3VLspUE__bqf(tl z;t72{yVGRZw=8@Wo6dg*ah!i7kzJDM2_m|s;=#9X=F!`aOe{_Jj*foyJw3s{0M9Va zE;(`pJ9g8pWU=CbZ{Qb2uimf2WoCAK;~%$sy`FD64x|+%85kEeRT*;j7S5$(Y5QWv zl;%1L>ahRblz%yt9&I?gJ6vFF*0NL?Z2lpQozI{|O-Ns+gp7vxJOz9ha9ksB0uc7&bVA11Yuh8aE zwY5NE!_Y?wdv!3`DR#57k38-+GKNL{4M$4)E#4&Nd7RAAIvy>Q5MN%J-S%##_+DE| zTey`G*M&fVcVJ{MIk!&hm*Y^V>>D1l}RxtxlG9@1(ckMNao9k!v zO&qAwO}Z}fVOME?{=)4~D&()sI_*KeWfLgVgcdF&`ARh|`FiW!KlL_EvgXv)v8+2c^IrJWw3(Fi@en=|T{%Sg zMEy&@PR*sFtKGb;URW7B*k8oe)~_dsMqHb%5`HX)m&`SalWgc-81{dUL`!T|IN$eBkhX* zoO`=NMU+8k)}MOkrM<`7%_3=ZpT*??y1=xb#X}j3ak3k0Bbw9jOJ`Li5w-7H2pEk# zPrj3*G;ZA!X<~`@oE!?+scEnVawg$bh%7#;C-F&?@yzJ1JEP+pW1pwLd==5fRm~Nl z(vUFGyuCbe4NHb_oTRMu7dE{{UrGr4_43dTOFf|_K}mu#)RL{Y8wrv;xW>x0A2eV~gZWj_kV()KPyWQT$`B=nWJ5tmi%m_Iz zhz>9`KH1C~8!Y8Jwy5loa~a+U`pla%{B-pW-K%ahk}l=i#ecZ?Yv1vjZE2;#$=djt zin6jye{10JN};K;ml%DqcW6)!c$2Te)zMuBS|OL_2G@ldTbbv<2H_{tEfvavNYq zS9{_ZsU}-B{7LWSd*0dF>eTCP*Sd|8aF0s$n`=<hX+IC`WNrgFYU1rzq!8Wyyf48Q z8$#Esxg3%^{^m>j1+T-d_Pw{BE>EOg(7^^qz@M{TT@P82J4*;${b1q-d-(&Wob=`N zKWw`4Na=#ezUA^SFVD~CEbFs43sPlRAJ65y?r(b)<*9wHTUS!UUpIX>7eQ0`FU6(0 zil}SCb-NoaA9^``IVX4Bbl^?NgOhrcBVV5z?f7u#6?JpJlSI7rQEE)WicR{QFB-&3 zD~}jL_1zz~H<>5)^2%R|)l~Y3DnGi8g_d%HqK%@Bdn+XqdCp3zdi2?ysI65{oeffB7(wPNpaj{8-MV%ADH(-+49Y+DKG`q%`-H z%x-&D^(#=vtjM9sPmQfNt;0hE8)=+|>&5O%Ug5b_FH4e)Z@nF9=}alj4wXGNuoTX7 zR7_KM4FpUP3=WX}Wj6{)_h}eGImD=`w-Z8kk+Ho);iU9gqdZK5^e9?{k@=$S`LbNeZg;M*A^?EaAu2Ip6DOH#G9eEj-ZDRu1Ai;F~|-p{@L-HiEg#&upckM(P#&o*nA26a8V4A`M^>Br}s z&Af1hQycJ=a@Be})f`iY*(}CK*=VG3;qt9K9BW1DDSrEG-$k_+?tSW>H1WJpV!8*=+|rE(%f?6Xp)7A2m93ip2?_n$Z}_(qjEDa_=2 zCU?(eObkqI*Z60D8X%fDpMyO{1#H&HSGs{EGWNh<4Zb|cw>;5D-Wn@UBkYru%n=hi(K2n!S)-uOyeeqTg#u83SCPyf0Tf@`Div-pRAD-h0l z3CRO79+Z$GvGW#v1k2K-=$ZvfQUvHemE%l9H-Yol`UgRso>U&Fs?+1nUyuO9KIi$M z@mGUj$X!#B-&5YUGHit`K0zqsbL-^e5&g=qI}#sgtj|+lSL9QK3mO>qoKNOggb1!o zfFVm(%F02y4xtmprWloqq@v=7DTejupWByDf7__C@RNj?9(*b%P$bqNmTTLh3q8~7 z0!R7b)%B<8G06jRNuQ`*Q@y;rQ?SL?Y{yuRn*vJD2zO~2h#7$gRz z!@97cz(PQv2%-35>>%rjtt+$lGs2ha$|FU*OQc%@1PfZD6y#+-Re7-7Wm~ybcM*lQ@Vi-*g4PF zKD#dTPL$txvk5dCARlvV9<94NV=nmgNa`N`oC!M~(QV2}R|l^;vA%(=5_Iiq{#AV1 z+k<(sT=Knd=0^o(!-s(q-mtGeR=5|NOpIx2Y{@&^S+s70%=>^u!SF3Ykc;1pBrMxr zbyQ`u*mM4z*nXwxc-}oR9w%=?a2%^dVn(?FNE7NeZz-EmQE{@_wnT7g|0go>~yWHO1J~!uIl}@}A zzwgQu>%70hnsZ}#T@Tzi?a_7fxv1cor%we*>_aV!DI!{gb0|qO!5s}zbv|zHtMb0n zHy(EWavnpFHNZituyk+p>^)~?wDAJFsF09QP57>tWe&&f?6S=>rkZ?vcJT7%-@N&5 z-0o#eY|iC|LAU1iEgWvb%CA2+Rb1CG`6MpBPvAOR3)#uhUVn7#Lw|uiSM|fv&>PNJ z%WGxzSa(n_Lx#4UW1rOG@C{5TGM= z^r^jKPJaH3%CRrL^M%e|__u4va}rQH^?I5TSiiDLHpFZU7*crnC@X8Iplo8FOVv%| z1)6`d`sNF{9hkw-FD}n}rrwls=>2Ac-kH(;B1R1&`lwr%H|i_sI*q+Y>{|YMC2MVT zu(#h{dk>E}mE&K&ju_q0&7ImzgYm`3C#+j@`m`!bIJWSk!Cu(2N7MH^4BWZSSA z_$ncA>b0(0N$G;kHJ430cM2*o=I+`*$&r1~-qU7u>{w2Vb(i~=v^2FVv1sLzC7~;^ zd`I3_)a%5L@4EAP-KqoXWZJ0&d8tX9uON5kB=6a3wsYijo)i1^itE?^+G7%WU&i}J zn~lP;hd3pr#?q|ucZWMVzPJ)!XWTA^nuzF}}6_ z;(A|agn zEU`uFCSjjVy&hfEP~K8<%pmTnWiX}A8l`_ahYzvG#2_A~C^X5i+qW8YvAV{tX+hT9 zp-=sgwnw}9xlp^g9=d(r%gs%$mbZWYPVQ2wVD||+{kl!_(D1e=_s2KrpM_6N>8srT zG6?2Q5T9n-QZTi1POHOmiu$)p`WO1d-tc+kIjh^{`OL=XT8o^|IYB<}g$)Ge-9(7T zg=!zHdr@`JLk77>eSOpg;*K4L8tm%sQW9R|S_l&*fw#`ogic&m(_Kb4xf`U*7Ck<% zQ7zx>?qHzB)i^F|4r}|EsltpNkT53a*yIQBUdxFmKC_iJ`*zo`&|&J6>4&r>(mi}G zJw3n<*I;e=5Ne)Ha=8_K3LUs`0MI32s0@QuI*z%qUT3ixN}7$ zqJ_nV8>o+OYLbZlA`<@6Q7r@($!%gG{7GRgC$~^2kFJyKj$eCJbl{HRyY=hySnn5Z zjrf**p2o+gKEU+$?AU!oJ0QpMYejUsnWakK)~@3BfnZlQw%~s9U?E=B%^Z$M1}N=-hMV*e>7w-xA;Enh!+)gjkj~gdL8X zm_dnC+D~#3qWA9)Ru`S0=W2)zfXYT@WK5+W(rugR*W}S{>zl(l`5c|Qmr-?s&+g%K z=TYL*peXUrTQu@sG(4?%y6Ok7Xj#|r_u#$04bRs_PZJ2d7Ya+~xJ?6|?@nS6`M9{s zTy+NOTi=Yzl`6&Y7Cn@dA_VqLa)wJ^yC$ut6I%44dA#z#%UK`vA(M#;INQ!ui`*K& zSv(?i-abGVCE}hdJs;MN3J-O$?{9Vr=H^C}%_d4gxEK%aAUP;{utn%? zb+E<0?&p)wk3DJF+cCFk)fCuFM|+hcvL3`u*k9V>G%vq3J>BcXZOHYdrPE)Dw$j@A z+PeCwYdKtp+wBvDFZii#SX_XNW4ehT^>+(y?H#(fs^7e(z2m znYh))I$VE1AmMhhcvx_7_g(p=@gl+w`Mb`t$;8O1ca;w`4==}-J-rvly?Vm=%tm*f zHr|kaxTH-`q=045!1^`XSW<{H!+E01r>4X1B{w&Brt&pdNT0c0O(|;OY!^U& z-QAyFv(>*4xT@kK%BW^6#Of6m{A1;O?1?v zEGUGdMO^99JzPRO({I$a_AHmrJbZ{d(A>FY3)=6a)ARx1QwxcEQVw>!emL*vCqLIy zwn1EM6g0{-`!K!mLw;G5iG4S6gztU}`ZcJsP^qPB$X;bmiJcJ-AF4K&)YT;mjl9YQ zNq&CEF&TN;m^x}$;+>NdHoac;>>y^r6&4iX%>Ki=Kl2Cs;gE&^cJ3h1Em20QU*P+f+ zo!PFic)?S4C6gCb^8NCj=2>%#f-`KE`*ie7W>Lc=!N_aZJSLQ*pH-K^*L*|9!M8D+ z@4XVSx+hli{LIvNl|)zBOEa;EcP%x-3vX2xZ#uS!u?eT1v@4n~^LxMeMF1O%;W+vb z*U^d?vw1)ibni?`eJ2A379!t#zNVYArX5zhjm+)Oi8vJ9u;u)?uI8uq{lkIa>qfHY zP~pUBtg?7z#YJl`FNe~p*f3wVz?OGIJ)yflYg(3wFSzS)^E?g?wuz{1+WSRlRd)xv z?D_oJRnzzAo=mZv&)btZl9$VIB@$w+Yujk_RB3u~Q*Urskkd!e7o|&23SQeRlf$hv z&g4$fOWaO4zTmOB4s+}GI$awwVX}4AITf4N)Z6R?WnU2=>UL--&&!_ft&ZyI2UM0z zCX~O9A`jhaueiwf@@vdr` z(}3>jKqZ+yZA~!Jef=ct zcX~G8j&HBYJ>k0; zR8yUk$tZza>TFmWrVu>9#^$M{{+=|rG(L|3m@L@;kq?lkf<%Qr-&Hv^<{ z&a0BD5vynzqoJ-=DYC%JEAO*dCmm^&`10M+>_bu&oUSr6Ge!M;zy6}FJ$30e6fAUj@gfC;k>cYxX&`@D;)dgf=rHo^)@&zJeKES z$+>HM?w+P@Ti2#woUaZ2VkI*Y`RPeW;+OU1Qv@gWcaI&a6j{3+@3vv>xr@TypPHc- ziM}T+EM5xSDe35XrMtJ=vR1b5p=r&gg3yy_$}?{V*gn|(N)p(od=|GIp9yRA+2r6a zb)&54XuYAvCE_~$oK1;FyPZ#*IAN6TX%` zIZyXd_@oesL$HIUW0UCU#mk&FColEi@6yP-z$bLloc~)uOw`CkaS$@sMO%}(Up+W; zui^Q;{mqH|fSP{g`F5lEb?fAnW~MS4whs=ni^k7%{H3CMuma!xIMA_1n9L_cbK$Vd z;`z4K(F3^o?8y>dJ^qHtb+)v7yH{jCAr&~6_83aB^WcgScg|ib4^&qBo5Ik zSV(v8+T?Tdi-Fr4{NHl0Mf(FN6?!rcyS^W}T3PD9kxxOLvS|*Ikxpw&hMBCXH#`dy z<~1~rii@5bFfw3cD{7S~y*(`R6tTX1SF-Tl?ELN=?3ZU?hd7- zrMo)@q#LBWrMnv>hK^_Z`#$%sb=SJH<_}$tGw1BH&)%PSz28TEZOO&P;i#fOHm$hD zdnu>00ur70^OqH)ET!E&g}+`bm-T)S-ZDv?&3~uFJzy?^kvu<<+Qj3SAqj6J?^>_Q zWtS8@F*(U)Jx?9Q`>G@f3nKHH59H*>r}9ZC60(sEUM-54dYtoFjH<@B2onFdnt(B~ z$hB6>ZPJvC>0gfx7bh(0ZvUgIBRYCLu0*Bb??=d&rQycL6fX1^eqfYEPy#A1ID12z z)I_1qnd===Iv<1o+o3d#S}230ngy6}_FQFb(0*X46BBJE!H?jh1PABkF>Ya;81{9u z4n=ha@$vHV3o>x<7by{LZR#NS7piNB*}TU#Ha=i51~^;gY)x-OSXe3}qas6GI%zbGl;UjvlFLO-&XQQ$d7okCt3DKuYXC1hi64obU8P+kPPh=GwLs#-i;fXnl9wyZNelsYF;Fs z;8~e?$ji`MrBd1uSOtb?~cjbElQ0s!ru8LBfAChR4Hm$LEoP z5}p=loPHYW-c6R%%Gov_(tvUI* z_FYGTUfB<==gZY>Mj#Bu2u$Y)aM=37OogoH&nhy`8IYw`f^w&T1&km4^*k@%;(|4F zCQ+gpg`IIAiRsi>F&?qK40qb_84}Xz4H@xa*xQ7`gm)U->KqRKV;`S>ccT)7wW7~o zNEmIT*l_S_EpGGW()Y)|HNCs#yF9YFxyDg$n&Bh5iJn1}n2gU)%y#2Xe!Hs38Sp0e zAAZ1=Z$>-S^wUJ4BY?QuBMj&4Y;AS-bT@bg zw6-oMTg(t<)VYEb;eGRMPv7uupK=~Z?(__)-{G>qXtCCnn;IYYxzy}^M63dZGmd3+ zIur<6Ct;ZTcR7f*aD;pmUaRAu*9+WMPt8EF2QRh5J>4 zxpst1xo6{^$AU)BF~$hvkCUCTT+?WN9X{nM95qEoa=~B5VyXGdkYA3{kH4O{m5# z!)VU11TVK}(75|;+Vh9?3Y1^I^~_{kG&@l7<{^O0?$ucdgD_bTt@*X;Gp1I*#PxPM-DQkUf1X|`W zyRVjA`$$}`-CWwVOJ*#bUbMJekvxaMD)|Qg>{_rm7IazFK2jzK-ZT*aV00D)&-qy(`*Isezarg$Y2qjwdt0PTMTU*<;Y)DjJoDpJaYinzd z#s`nUNq$~hT2VUOMo%x@p3n-^PQoc(Ct>r~6vA}46P)NAOSM=K)*iMZyPBP1`t(U5 zKR9G56`!0Eu_>hqa-&RqM0HwoiWg=VU0cyPO^(cuW9S}Ti3?l!SHI1butDk zw3=Ui`a({S_*ob+%ndiD!PN2Va)DI2} zA`$#MU~nWRsGg7g1Q```q26q=y}a#I?IRH}{s$J8(XGBuP!$(vXF~K3p_-i?ovNi@ z1(V>r2^;45yhPuiZ447r`!}a#QHMpbRoV#&$3* zBI1(PQmr5ZerTOdo6x)W!?>wfIZ@XPDwn7sy;sg%hp^gDzv&;fjEM0GT0IBNcgW5; z_YZcVf)0E4%N#NSGL#9-%gvsTX8|fZ#aNK2Q+e=qqj_#YzNn-q?{qWkR^Y8%K3~y3 z()}O91*Yxv$*d;8$hJ6xS#;R2`#vGcEPFrV!^~oPcI{H+d6cSs-m?@0h{~6MHcYjVb5Ct0g2S*;yk&p^Za+@3i zKuz=8H~13r_46BzljYm7&d9OU=f<~D@=kTbaE|z^L4kj@tbT94DSU!E{s)lXt>)iP zhy*P!9Ow=u0JM0-hEEcl2Y3TCt9O}?)yiF#GU51om?P>G;|M~JiwZdYG_}No>(!;5 z4#pST_0LN}QeV=Y&*1SqKD?hyTkzqf;7HahmtBPk1@D>r_~{uQqrScY=HY_R{p@(z2s2d0;_tQbYkz85 zTG}RphYJ`C9TPK@2IT8KKSnoDMY5}_tDy_W%k^e4MfgGQr{{TXAG0+KFf2jl8;TFI zIb$>cR02st%Vm|&yac7h=7fjO?TF2-NUk`glq!OhQ8acgm#kVLodtAVL`uQ`VgE{%)(Z98Oom!@!>rRJ& zJ@y;_%5YqK{N>V#K-hq<{qaY}Nm1kFNWm*UKfdCmFx85sNlx$U8pt3DiA!tfV? zSjpK`R8$;Qm6hxqlpR#NMNp+5lr*d||1%y7X(Q-_hS6yj$ z+BZY{Vlx7E1$^VVd-%2b14Gf8E@k9I~GYYM3=ljxP2K^|7X5`}gmMhfK~{ z2tA3TI}7u61qWkMwJeu}Q|2z#1brZg*jsU<1%-fxe_^3ic}rFeOf+V1DL3`cDr*B2 zPaRBZqu{sicD7ZHW>@E>>S)0D!)}iL0fRNHrT9=J#;VE@}Tcr*rOD2|25*$C--+KJcw*w-HUUL@;85^Q;1(?!E$S zME(2T7gYm~-tcMPVSLnX2-4GPQk!SiRS*Y(8fR82zqNZz8lnr7@+}AVEcEo|we%z? zm8|6al6ixL{A|+6nljhm>6=D*+k1tT)tFB=pZdOkFD3U9YR)B`)V8rhho?!@J_x5B zocaRRM6j+{Heiua#Hu#_KD-BzG#_5+z^Cq-O2%+ySpG9VVPwLtG*mhh=B2S;>+?0OHlvrXg+OD5^8wLVbA~uHFN-J-_=B2%{1pIFm zYv1&V{0FXnr~3`RT7*)tgRQDAQAhICkov-C-@^t~J+_7szFz%OMu zn{(af=98uq)7m#rKi(>1PR~0&eBCltcto!2$cw2RPl(o0SorhiT)0B!UWwB{sVJyS zC49M2ns0waXkp2l+eNRfi&gyuwA$E0W3t=pD6y{-w9K)>K-&=lknB zkqeBTN=U_6k;Yx1;?Z-;jU2KESXHl(0HLW~#luAE-!8hV1bW1~A93$vwx#KmDO;gI z3lIZ-MfTX_<<@TwTZlU>XsXI3d`)4*;Ychp7q?>~0ZBsF>3r~c)~_@(4QD4%zSSlSwcC!N}a)rHZSt*~fQUB#Kr9ksD3yJO@%BYtGxw7WY>L1&+ zM*WiB1rl{q6r=@D$}uQgp#5F2s)kZd@| zlAX|(2eyFYFUGNWa%_1P!^N`&Sl|!fT(ZMyT3-*P3g@>PJZKRh3_L4RV#TR_RCI9$ ziIVriP7~~9UfuCGws-bMZyj-RL@fwOsL(bbMd(7@+{a~nie%n&++4kBY(t;EVautc zH99{2PHHdn_QC9WonKgg;jfHYDmx^8diB+qK|@ccdnUrV&enbBRms9Ka(BnQQw(|r z;J%?UC);tjKfLLIl<<>IZPLXHB#-vZaz=Ze#46>#{#cFYH+ROS<(4ilJ5(&S91iTY zRz0_7S%&*H8prB7lNf(=(;E9XIomhWZ(V~{dd(Qv+ze=Q-`03N%sg$hHDQp^lAQ?j zQy`<`HCF6VLVggUbzL$qJO9m{*bE{ca6MM@{sGHy^2Zuv3HD0!-jr%%AHG7XO!xYG1t85abvI=7%WUpQOodNvrq1Y_s1ethJ(kmx^#oL&BW4_{;urwvfC=B z^`Uy?JyCg#rJ^w}{N$nXb=9?(moT#$b(fxPD^8KYt+UN8e^A#U8!ccYJTo zkp)gWlxxjf&pB6~KCdg#i`m5LP@y@jZ}`c!UVI0q_7VF`0SvPN?DJv-PZryn%BWe1 zjorR;e8BtC+|>TQvv}s}bG|rq#+j4ZMLDN)QIVQRk45h5kOs5U?X6mEc;`DT z#k<_tW=9P-zQOMW0d;dFIHg5}=4B0eM9RU2(X)TJ?=qf~Yj}@Z)xPL_{APEs9{$U} z4=Cw0V7!a1GEF)+KLku`O6$vWt}c%I^Kkd&F&%3aF&KuhJ3&ASZua;=?8=bsB+~KX zns4X9zecZEO5dtEzMtXF$dW>jc5{{^6a4}DO;=f+=~`@Ncr;k`4bOh!zogHabdqmZ zOEMefHzSh%!1bPV)@OCSJCyY3h&L@lj}QzUB0s#45?ORYLY>~m5u+;fY{|md#gu^PuLXpO$GY-X2n( zTv$Y-OvtwBD`MluzDKWyr7wBt&(CSsV)K;e`dXXnO+5P++6aYxssY&q5c9UxxLjOWn@*& z`gaYie1))@8BQ*hsRafe_7>vHHjEnc@ZKkh1{LRS_KA0zs+ORF`L5TjuyL#BZ+hlXU!^v-^9nj4c|N z*W7}vL+EZZrt#LjdkhQm;|=b09uIPsihtS6AI)ahH3g$Bsz?F+wPkDsq#L13L)vJ7 z9Kkp8Gn!HgWG0os8$m>)H}Y~o7#_jIJsIXk+lxg+KJ1l{_R`VzxgOB302Q{#LA(kX zQhqk5;H?B)H@%2|VUg>cFkZ2}mlUlq_3T%|4Cjagxd9v(z?lFPT3d{ity= zlCXSx{Pg(eWUm55X&Q{oOePgau|71$4K=8#DNGw3AhoXwEQ;Ua2KpFL5ttMTor!@o4>6@3ku{#GW(bei@s#+3&%hO@U%A9HOjO8vrkf!*3N7B&kzRs=d|Sw{XHM~ zht#}GSqU#smhNs#%HO}2PWtrn0xuTl!rcoL8Y3I% zWq7d>B@epHYBYk869JAt9KS$rjiK@rtcF_}Dkk{b$3TqNTHa!Nk7qDL>*WAV zK4Yxy*qY>v{F=6pjuDdr!PhX`20NXGKp;p(HQJL{?6^AC8o@>0KLww<&bwb}9qb)R z=?(yr_Q!q5v4q5+eQIEFiXh>_qMkzw_0{X|SP%wa?DGmD{;hEfZIG3BKjk7nYDGmwq|hzh2f^bkQa(s?v)VnHsREqwOXthU zcK!?~VYeDklEfn&Fq%JIb_%_Iy2zZ0RL3JCulb*7T<{_3_zzld;%m=g3p=+m3qq zSko(;^)jnYN>l~o28>ix1h6=HOFg&Syf=rxjZy$rwTcUV#rv9f(Y$r8Zzx#0=P1%v zJhnjs4YZnWd8mh$H73|Vr+y+!etM|w<~$4HuEg4CaWXP}Sp9?bkpNWdlCjqHY>Rm)z=GC!q!*bacmrH91`^A z#2Ap@!W4~rgFKM#)IF%%73_X)rs+I6)w|Gfx=SpV7B94kZ?p{uv-am)V3 z5%1>HabFC z#TOgYKR*o4xZYV?YeTTGJ1}2PFp?g%${>Flx-R&smv~OV?C9d$$P?&m4;$D5Wqedr z)B>R?We%!L+IeqoeVjfpN~n6%d0yQ{ zRrL4Hx2k`_F(MuR)RejFBHH(4)wQmp_B>r|hCZ9?c1sd*poGr^64~K;`WJzCUZ0cM zVATQ{AlQOlG6#o6COfO@GY`H-v#6gLCmh681D*h7jW&MJU+mB~lMlWVX{tjcsqRIj zJASJRlFb+2UH>gf&|=;yVRnsV11Fc%k6&$A8Kn=KxM8cCB>q_0PJ)?I$cN8kTSW;W zi%UClSojRcm=64zU8!eQ;VKKu%hnh6P158CySuwbuw%@Yq*rqKVNUy}D%pNo55rUF zE60LlxcE}Y4I6V-JD91Y$3zh1fSyE_!A?S!<@$@RUZl_2kPUWh>0XcICiQZzcMS$f zik+sdAB?(ZVU@+hqe~=-&gT*^YCO?o2+#AGw<-GPr@5{ z>at{Bu!$C!IP#hdRu3anQFgJ78%PgFq)K6Bzhd{A2TzVt${{Ndmi|ZK_5H^we zNRJU6h7rlB*=VkieKqo?Q_m=kdv!dXHi>b$2coGeLjHY zlWa{%o~Y+3S~R85PR?*fGS5|>*$CZdkUu`CMqqx%Czg`t^dlr8VD%!x_F6^yp5jr>mxaUm0uT=4haC|K z?MCRsH)?w`h;ii7^&!A!|c(S%>)L8#JR>4-M5(cG2)2?)>!z0>e-P z{jSr~GJ$Db&KHl5AkkbSWrAW%`Y*087v#w3}T3#RYH$*Fz#OQCUuR-W4Y z+iON8COK>Q(_nqCqE{$_gn@F)6ahtf?yCK=TghD4#E}KGwHYj|`MOIg(vA>OY!?<7 zJ^6s7ooDA~jhPHkVt@*lLus%uw0R6ZjSvB2liORM5&r5057Hqo6{t}VRrmmij8F$1 zTCV65pQm2Gm%_5A|4j4_oA2(Y+7K&mJ~`1V(Z(q*c|sxzX=%Ho3f!K@d5i@QRuQ*5 z@!`Y-w8>a!sZN5wPUc6)PYv6poICyd6hn$u6%ZlNno=92Td8 zrUmQw#(g|S>~ER)+03UR&?DQfwKPIW!8r`uzm10~f8_~1XTr?i%+nBXn`g-QXk62V zX0d^z(TOvx(+|#v{^iM!w05>OQnhXcR3?o*Q8FLPYBDaC3w~2I zKXmYhVvWdz;!84U^~;4&WTpZ>Xq>V1>9xaa8muod(XPL^r-F<{1MQ{QvWb+-eLT;* zKkv{bf7nImhab(HB3M+(o!outXQU=+FYE38wPeDOU}q}51V}f@GUBLFQ6R`7wB2v~ zuRYVh@ZOLP(!QrcFtDg^$h`e(G_uaG(P9Qv!Pwpx$Sy4HptSW+yZN7pIg!+|#HJ#- z4HO?555zEEdz`?fL`C=Ig>tdf#qI5xC(p%s#XlH*1*riT(IpV-9Of@nn4z2}uvEh+ zEvDvyUyEJj>_9k5cL!fat4Vut_B4sKR`?P4%q3S+^?=G2K7_73_v51tg;U&2koyZP z2xXEXu=gl{5NSM2fkH_3BVYdQ5Y6R4(G5|2=qqU^3r(;ozI*zEf)OJG+BZ^o)5&Z# zsQnPWSs}thAB*~F?}?HOgo5j>04IzJR|AGVxkmAFrTsw7L(_Jeh)C3tVWMVJ2Q`ep zrC?2`-ON=we3~|8?SuHC82m;ia(WR~p- zbKvEpN4VwNMC7!J8>fFb=HX#AoXWd(U4R4)^a8NET7^zM}P#IGcdI{ z*32r;nX#W+1a2Y^Gt<&>LCsEf;6EQO<1h(lZpowc=~j*&UHfyv1k6%XX(iWq1IoV>|mll=3UTy(dAxL%(J9@jj) zn>%GkjU&v<&AdTj|KPy3B&+{a7IR))CUwqfaqD14Non}vg1V$N`x2a^mWQQ|*uR7a zRJJ;8jve-Eoc1GwzSS;QJ`}tbTA5amF9Au0qN4oP^$jgBra38TDm@MdzBLoW<%ToA z(CMwb{-j;TXg}a`kLa+JBJEv|NIyJ3zoA5S=O%2?o|^C3T`F_y{u&=otX@BcXn=r` z2zC@3$t&{oYoE>*zp!uZpld7|b{ZUs;eD~d)li`3Oey`YZ}F_8a`W@&SV;>(t^B-EUjQae}a zJV32)a^4Q|ihut;vb_GkkLg_Atz0h_HD!QaVEeDg@blEh>sD1khs%dxQnieUwxYUo8#sF;O#Wvi; z=`a+!$X1_B+okB|7V)@c8qtX{m4@eM*I`{A-e-Sz$NJv3`Rr6ZxtAXf#voIGBy?`A z-IVoy>+Wf4Wtoq?(DNo~1;g?3&inqia2_Gw{dOzxYT9(2El{=qCCFRQ$yn{XWd+l% zlR$@M!Dpa-MI0<~zZY~y^8c6DCjE0vSPdO&?I3TxZcH=9mhL*36g37{50su8#&+#i z7&D|(s1FWyYsh!z{^p|zM#*63=Sk=LjOHLY1W`fAhj?n^Jaw(Wa%GE!0}T)q zYJK(fao>poi}bLLR$?l!-$=5oq0Iq(jA^-Cz zis0LWM`lqYMFI6nrIZ*?VZDm;7Ffxc+j0wB$clIzoNff_)G%hZ1jeL`Bb8OiOPH3` zlT%ZSYjCwnravexHOtE%>2mUqO%JwqfJI$CxI(Z*vx2E{rnrXrkk}|rRp>d!*$nCd zll5rkDdFVJ@;H{9`h?>ZsO|Pz%^g1GQKOuqEYwavz?4P#5GR&#MFRZ&<#4A~gwEM@ zIA}8$|8}L3KU@wgW{|Cc^@Y?~kpBl!RP z!oa?Jaq@6bGEQHCI)k@DS5E7%8+JGE{&I%k?r!c`A#e(M^4!eua_a>*Ik@8uR%H4l zUk%c#=7XMnJ&#X;LKw(H10S{s(h2eKxf&{h+?9@^?n4r^*+#YF!dwIBGjA?%d@9@eDMp;4IZZ$1y-#)FaLp>G=oRB`8-QRSzu!1?Cl-#+H;n=vK={(V|Q=R2-rS-?7k`U3knw5 zviAMiZ@BWXe4g@QMP6BXYI14gWUXGG_Id2S{1g&PYv9ita>n&HCY;$@%*)h6`_D84tnRlbn$lFVTAl6OMSy#z_3J$8%V`ds#+-(Casvk${q; z_YyUMAsv*xcnT2wH7#Dzxx!cFqA1VIWQB^34#>HE+8;{XQUTlB9_f9t8bL~Ekfw6b zb$R;D5FCll!;NCc&zeY?xw-EwxS-O~`l$a7Lg%9PxE?-8NR>0Qe+~JjT|n^TnL&tr zPWumJ2w}yO0&dMtoNVjE{p`Tq%*|dA7?nhU`nD%@nGbPbd&ifSwV7F?>cJw*$bH>gJ`pobg%v%gq@dWm^SS9R5qhNh9}vE1 zkS=9ki)n=*bdG;|$D8FzvoWv0k5xu-MOO;`%EmO=tAVA>i z{v1=F*)N>dq?!mv&ikeyGG;qZKZJdO{dDtfkYUy*HOcK)kU)H1u_yng^resYN(OmJRMxD`$DbWXgP-?E6`v+#ZZL_Bz6{4GraQ)UP264 z!(rtHQBq-8FF^_C%a3fj;=FB@`R_yYCb~mqP~0ESEDeC6=?g#Vuf(rktwY!TNgyL$ zO>h`v8v2+$Sh~m=8+UkJ$&n3gzwGRE@V+!i7oMoSLzR|gfgmg5Ru+!^4IKM5CY^HZ zx<6+!F)=YDm^*V2NiJ~NKN7h>k$Ld}Dv?8^7@E5td$VUu-a)A0h?D%syGo>hXw>pN z06|JGS?qwb(d@G<_}$<1)lqD`I8-l2hn_pM8WNINEIi~<)3fQ{u*+)2yp1z{`1@Sm zQtJGUoPoreP5m7J|DEg(TsBX!v2n;e?t`1^mPoOQ%`fF!w0*9}vSxI=pxg8B%P~4V zj1@qnxsLiQr<3Z)30m|#X);4#O|-kFtOw(pT;}9{c69d6J00Cx!+&J{U*u#v=1g3k zIb&06;zs)#*yJb;3JRH-WPi4QNABGT`oK{A&45n$5$THn{oCGp3ECK|#*K&|vgN3l z6vj%^DQi|j!IheWG_DnMOUsL8!e%Q#FTY6BCdS6i*jt=Y1j8TwjuDg<0X-1t{v!MZ zm4R)Z>SJ&uW^!~gVw%^F;jn*~q3k=ojTlx=#oa7hD?j&Dg3yk5UV0-F4Q?O-OaEPg zP9X_NH$DBv6=h$atL10XEV+8exk|p1`AW~5ki=QSK^#Zkr3IUon)A*`UclWtDYhkw z!_ycTc74JQ>1cs2nW0wJlVeK=JM#_#i#)M{F7zvmfL<|-D-01@(MivAR1cCrTJ_e> z)N}f0|K_4?sy|nZ_p7@o`Ml$6^9)u>%JaKXgUEcREw}UU4i00&R1^@xaPpxhh$>C~2ijq#b*7RdRoq!`2PygS{FNefuJ(s#c~PC5b1;m7F95m>&wo>OzC3g zeO{wMXwbu*C#mSEg56VJRNTIgNS{oJ)(*UiSbGvXLb={;@T_p`7Cl|JzBca!bLmY= zK;|#3ffC2hpJ6@^eEGKPmv`V&4&&kCUd(RDGSM@)PK}LCEKZD%v+;9s@_zWh%Ue8U z4&z;N&G-`L#`z8lxl6wS0E{nRzC=ft{PN|?XkXvJ$iVP0-oi4QJy7a)Rc!DHJzgsq z<#DBd*8#_>z!b9x^E%hE1)~D@^bKxe2K+eJ)5)l4_y@bYmX5!+kvilCuW?9la7Y{g zjf|Xid3hOedHD!lt&ij5^5LQeth;mfv2t{{p)?c}6l<^6qU7aKP*Bz;!-KFUW@lY> zS6W8}AF7*57B>8@a*}ZWJ?8)p{s)QD8Ej{MPTF+5%N9*9zAnl70?nka9cc9~;kX#%8UjSde+$MH9b#(z&g45DDg&!d4_xF)lR7A@d&^43@`B?}QTaQoYrsvf)G(5J>wgA7)tgNk2 zG9^gnOAZcI7tEcm>SOpCXENGd}0pj9@?y;PT-ZL@nVhV%*&YORyZ z&oULTpiIVW)3V$}@VBnn_Nn^q`Lp}kKdw>XujBYB4UckMxa}v46%(wrTK5(|dKI?h ztML^6(gd(FDu6DP$sG#M_wT0yR3cZ3i$Pg^ku*EuKL}IJv|>FQ)TwlO5aANDp1J!e z?nLgwR481j1c5pa9w0N;u54aCC(42HL+^sHv)rN5)go_6cGgY#?aY1hf)cvu# zbF@6T6XYoE|58G0hOL(e7s}$aDw1=h`XyahGo?nPtK6IOYR92bH^To}5YFD-J1Z(d zl`R0P^RHmh25!+IrV(Shq`BEov~RH30qr&aXYq1wCpx!l)vW<2oPaFF%)XM9KXv__ zEwYC*+>PI#ttWB8^#@i5A<=haiY`-5;&4&Fc3n>58g(lj8yyo9F%JzumwI_=X(=jB z&dw5cvQ|~%{8U7s%Y62z?66%t<;$M)W+5s_a#KM=v1dj`%h~1MM47y=BY&izUgoo1(oGY@8nr=X&`O6F;^wX=ZFe}Zg*||oMc(WQzv+nOI?wR_ANs5q&9u2db zzm=Mof%|O=0dWY{#2)PZOc~7CRCKdG>9ngmT+S~@K)&A|&}L45LA zY>Wj0@{UH3hvk{lc`q@#Xpbp%ZJTn0kLS;DS_6d*Dr`zp^6ECwIV<{KTpK2WF^r%A zN?9{Yf3nDwNuRD)y@YBMY!1Z!EiYEn3nQL&4_~TXEzG?4C`;rmrA3rMsd$ciPnG;( z*4N3jeF~PYiar3q~>|7lf@!L}+xsZdpb}s+G*=O@s33ij>TsJavP61H(4H z<u($Mqg9t~iDVAcYYStywcYb{Pl zKrOKbFQbpvIPgZ_h?1=EyvG$*7>`)tH+YXZfcKhq{89^ z2lU1obOFr2QbkGD3AQbrO09)JEnf3a#_#6NW;;nPH6tgSWOM*ybBuI=$b*kOEcrYx z3>60;==KoF%E~kcy)rInqyHYj+akJaY9XGdy^{uyu&M};D;Iynv)5r9DEKB4d035i zWhLkDt2q7A{A>omvLDu`y@Og!yXds&!LHLrS4`$UEn!@}ErRwm9shk$w3PrD5Fp9M zKHAg06;hKl3g0_z?i8i=-7LU>Jq&~c@s1@3tVK4Ij3?WE(4zHS`(j; zaz4i2xQkbC1T0gHy(SrY2?p)^?{PV&$#yjxjq@c~0#xbmY>411h2aBvI<%8 zEI{V-p~7|{|8TKgy%lE)%d-tdQybHV^+@t0717!mP7rARW59~h+23~?&Ygr7DO>28 zyn%bI*TRZqFvP>4$XCInF!)g(BN6>grepG_0v=G$|CH7PA_5?70U$c|4I7h~C_A4sc8&&*6SdCu_m!JM3}Or;MKiv4=3Q(h~KpOy@Hv{$4VeRO{bXq;NXXDQ4GSgfom`LX6eIO%|4NSB6>%dF$JqV7^=+frJ5 zGk?LSc{c-dm{Rc|w>N3A8g|j)bDG=xYnawUy^L%BkIX$A z*W})x`S^oyQ(7jwD)k~O@J-6;_JBRD;#!x<8I`MA1$&`o`|P%8$j12Q9~{#_yJm;6 zU)C?~Ur?icPMllxCB^wpoBoCZNCQpOl*EC=?#yH?gJ>W%y1C>n!`*_%)2-hVK9b}E zH#Sl@M)({5TfSTEhkkOc)*tFTJ=QEqiqSh2QEov{b4=%HJ{p##v(M@^@e6ljVfwn< z6jc3ZuBKA;X)Oha3@RzlW#Qpg1L@C~R9tkr2o1g)nM2h#$5co;s6Gd?QB?6{QWM4m zx4rbId?kJUdcNLk`!}wL{PHlxEk|baQPw|i%9eLa?rGX9LWjLk+yQLFan_L^7(TMtv3NUJ2Z; zJAgcX(K)A~_MX^f4x%ZV?MS=HRPa9k^?~JTtc7lBlcTr3%)otI0KYdJlWv*}SR4LD z>CXS2qGI0rq9h#8MoDR*L0#3LX=($7NZfd#QOcW+g(lPaRqFr7=aq5FmJ}x@F#-Gf zZYv7nJQ3^GFeXNHem-!;Fh1z2dqW9{sHV^M<%Q?#g(wtmF#z_mZ z&7H(RV9%`CWVkj@6BgCr=Iwcu#!tDqoFT}Bl8g=y1d)e+K3>vnQR73}>?dUewRcX! zBMr{`l}4brRLKkM%avwVtnym3RZ6DS!-WCp8-~S>+6UG)ODn_;7BGfi!CnN&@(~q9 zc-DeM+IlOicn-CL@CwgAR>@%A?RuE5Lrc2>RC-h<_ zS++E1J9hWu^roaFKXB1uYW%X*)1N5Cpp!m+T=RP*`>y)sd+v(YO~E5sz=2Xog@&?I z?FSN0gBqv28=mP8PQu9lKfU~M@d}LPnO@^t#b1qK6x>pepw$4{LIGZ?9QlH6S7GI1 zFFyV@XiCcIm-*x$#*#)2B&U99b8|IfP?`9Cej&}#HKgYvnk%onoWmIvk3^UxF9CUpzWC@t2i_+-0negMNkU9pZvV zV^f=eSMt!`4-or?`z97ooA!=?<I}Ut?^}Uzm(6*OD-5Z9Jg*ZjQT^1o_C;BULK(sViZ|8&YqM{*7be;aEd~PHzYdt z2LkQZ8h%)wxHyl{o!y`L1ty{TU%&nqnWSqs8?uqkmb^MdMM1fF#Ps=Pz2r`ASo9_n zP0ruS--wkRZR1KP@^HqwN~$Vvk{7f^TQT0w`|@Fr+|Gu1zXa$|8ZkfIZ-z-0(^?Iz zD=&X6kuPJ3IpPD_Ff?SaAH{zB>AE6t{s`y4oK2#csCO`+I&3i=Gs*R*-<{ryAC*J^9P(?z zjo`K;QY#T6_H6lQ!K4k>VSRFyt_o&Dfv`_|dm-;qg370W6hGV?ufzKewuuWN6h?j* z^(7|e^Vts4=wKA>+XbGC-i>!(f4!mQbq9y1%B*8;W=%v)3_*TwIT9@m+zC3a{jU!X z4?9Fc+1b5jsxkgOI1xzGiP<_5JC={7&5LfoZrzfm9CeX{z(VFopim*~2yD&&Kq_kj z>uhBUmzMi)R2+M)TsavKkc{3vUCsm00`>1!I@~i_4Jh4Pb>#32eExmgKzq@ef_7Y* z!7m9$xniYX^GRN_n{&?Yw8d$PB4-6aSG;=fo ztAkbe4KC=P+z6Jugx`|tpk+e&%o?C3*yJRAgU1)82v)ukZMpwi;raW4snMQ;7X|im zcF@BCpx!}fh#Ce%3m)3EhyDi!n2dj2*` z6TYGd`|%e%kWQE(E zZb35&B`umBVTW`?|0a6Z;IB<%U}#lmn*)nbRwe#Bz4@(N~8eh5+xeJ=nt<_T9u3C{7qsRDgun5w+VS(c@aD zc0+PJWPw1?VT$-Q$72df?8xel5``G=vP-~8H51Ay5Gp246m#;X$>fZGl;U|e^Vaj>N zkxCG1ZyFMf+%16U1+9@rHi-Iyi-SXjABtE@Rd`b2bE1ITy>SYx(aX{c{}gi`8`3rO zXsC{aM1!(CGUwvswqkxON>dRRgpiMWD;&#Q@e_y{Ew$0;*z&0nqNJ!>JTDO5ty1{M zO5|xW6CgjsTKUD=!zqpW3}LD8a#rI`c|bmAyfgF-MJaex1!f0wPO!AYY{a%@78i+R z@Q3neMdbbUeiCdK&Hak*z^$_ZBLK%`Yag4B|9^P;>Zq!o?`q4_1c*JIEGR7#Pf=66twR_5tD7ndjKR_slr4wK{Ny%cQK zB*#7pAfV_5ZKWt;1lDIG8{vS*7|6WY;G-lnpV7ve@*`*c%wm^(-XDmCOy54Zao)Xw z+b!A}rFaSzrJ_)Z<9r2J&Mn@lBxQT4eEhS}g4F@?eDN(o9z{fF&O0? zQ0+T|A2;&+7(#_n1rcjYe4}2Q{K=s~x^n&B^CcY2wINcCh;$8x^a32}p9F+kEMUHe zm$@@KRU(Z$0~6f5UXX<41QM6lHGbe&nfd;FNwy;Ka_>v)p$-;lvniFl)8=!!*u-77&P#ci7h3`US)ThGN_>HbM+) zEOw?IcD4T`U-Q<4Red7VB$NUCIjZzr@7_~TYmySbHG9BCM|>eaW^K-2Op-?!IBLoD z{J*FTd7n7U?6GY(LDEYK>lbFQPl{jSKC*cq+2DDaiv9#tLHnq0j0nsO3_gCy%l;-q zij9qnyS9g?YFsot{3c$81eX|>jBLcaAJP9AmE34tyTLEEF7NGzamx>xBb�@`DP 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/modules/4.png b/pos_receipt_extend/static/description/assets/modules/4.png new file mode 100644 index 0000000000000000000000000000000000000000..3afc1472202414b165ec81d956a882a1baeb6196 GIT binary patch literal 58986 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 DPL`?s literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/modules/5.png b/pos_receipt_extend/static/description/assets/modules/5.png new file mode 100644 index 0000000000000000000000000000000000000000..cea66b05f17b3557b601deba18a7c94a0d238d00 GIT binary patch literal 56919 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

F|U5kz(d__)_PH2d_N^U$y)G^o2m0n5^Rx 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

`}DzL+BTR2K`4`*F|N$%k@)vJYXa)Fi< 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/screenshots/hero.gif b/pos_receipt_extend/static/description/assets/screenshots/hero.gif new file mode 100644 index 0000000000000000000000000000000000000000..aff1dd171ce570b07074a07997a28b4ab44d6001 GIT binary patch literal 187618 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 oq|gRK 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 z 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 J)Y2w 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 u5tf;N4ia@kv>p3X&q--AGGHN_Qjw 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

n5Vk5Zq|51arT$CWR$nZMGV~} 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 Q0{+uKZlqnHX%qUt0J|9mEdT%j literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/screenshots/pos_receipt_08.png b/pos_receipt_extend/static/description/assets/screenshots/pos_receipt_08.png new file mode 100644 index 0000000000000000000000000000000000000000..296815d7c3087a67c72434396883e9d12cb51f34 GIT binary patch literal 55425 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� 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/screenshots/receipt1.png b/pos_receipt_extend/static/description/assets/screenshots/receipt1.png new file mode 100644 index 0000000000000000000000000000000000000000..355da7897fa89df5c51a15b828701ef8203648e6 GIT binary patch literal 142770 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 UZkdj{Z61l|orVDo@ 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/assets/screenshots/receipt2.png b/pos_receipt_extend/static/description/assets/screenshots/receipt2.png new file mode 100644 index 0000000000000000000000000000000000000000..add8fd06da9a1c8f46e74155a714bf2ffcf9ff3d GIT binary patch literal 141592 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 z�)jBy6}zf*?snM4}*~AfO^SiUAY>1)7|5&Ka7Z0*WM+Ad;2bWN30|KtRcobI#C! zga*0^?{4qhnVV+rylcJRTHlZPq3bOAgnepP)vkK#seN9bH7yHMlDfBac(gYe`e7tT zqxj`)V143_YtS)Gc zjyrXUKctd>0|^n})+%i$Ne5lAcOw%--SRAGF?K|R4u@cIkV%Hgp7S}}|8XC`pkKh6 zSPfn7FdO1-jdkKO;p+^7x(&rb;>U)HMl8~bOT`t6Xio|LyR7$LfA<%Sm#QR1l3~ds z9v|5C)sXkz>9XRNUxmwEkTZW$vgSGGa6L_-KE3YA&E+sfiK86%Y@_eNFj`*Od1l{; zlRLJo%%#>S6^M^|LY+~iv)ulKs(gT!*WpDMiZV4~2ZC)UH6ner(dV#APKePc*Gj~p z;gQJu5juox0qA3ov3e|g-|QSZ5I(D^3&ZE56-{Wp;vp_lj{%c87L zBN;_q@7U^aMO?Z#!^%)4J9)*Zr_&5be3y9jfl77y8iLSNF65;s!ew>fw&R@a?2phUq|gqEjt|2*YSSGNeFhCLCasHK9m7eLNKZqcWZhJPY3OM z&j{oYb*($}37PAPQ9HG}8nsp$Cg4{dcqymK6?L1H>5KBKR9w@N+_X1htQ=%LZ@~d?eMqxuS#|=x%x1Ed>_HXmgk3iFFv>Itlm_ zw$KE1?s`+9VtKxe6Bt&5-P8g-GkushZwS~ zXPFTT zUh%Z$3{}y;ueoZ0MYn=%@-^tga(NC9J$S~HqbYxCi5crhP!3JrzEm@Gd>HU%Yn?;y z+olY$TpDTEDqEF^&oto?s%$dk#RV60Wq`fguJtNP!rqXbZ+U>yAxZvr8d+@Gakj6i zNrE9@UaH9_!cy2E$AZza-1e;|-E!bF<%>L1U<0W*Oc|B#<%^#sU)j|jJd9Wo24%+k zwyBq02PD=;p?L12r8Y&z-_Ej`j-(rvVhHbEkW>Uxe?8yXS!Hv{gaqjUdcY-Mn6V-c z)pLGb=B|E^-d~N?Y|E_p3sT6xT-PrcpMRA<&Vh+C`8>(C@SIHj^!?=z$HNh*u*8#u zB!TP6d)ZTJ53Gi22QpuK_qFbx@3wG&RE=ENX`#V$|6FP4bs{XEXxGhhnGwPLru4l} zRR2nPi2DJ5ed#VoNUvuNYVH6-eog>u&}Qo4cr2EIe^a~Rp!RT#WL_Du?qF%y`Mjyf zwb9gLW0&^a>-;b@@nswI+Hm?+-X7}F7Ld9V?%G~<2EI>gW^Jne1-sou_35e-B`Ls( zB^*jsl4=}(eesTY#Jw~0g0|-w%)UlkKCA!Ub95ww9WvVnb|;F77xxQ|72owc0N480$0K{7_wQBzaHnC=If!nAg+-@dCf?f9sm=w(T$zv-7r zM(hS0;#m|uf9$h+bo>d_vhXwC$0T-LfuzG3gbh34u-2tMZN5W_KjMmi&Wp#c6W-Q= z9D9#zdU$+erGvY82U&{iaRs)=vP+_dc<2#6Hsh=hdL!{MUb&w|pR6wBDQDQc_|z1i zNCwoHv78mcmgY3IHz|wf5|_s;rm~g!c`&$m+Ca%==i2Pn_{qL<(Zbwmi%+`|lXl;g zCd_-NuPFx&tbu?s>$p2qdjS9rYQ{y z*fah#>ysn=*^k3{7_~2DWb(bKthWEoipmcUS8Uj8Xl#`KsH2A(yhkZMR|K)H;LGi6 z8ld3DJI8N!SxC!}`^%#~!iSX>gqB~W-2;oyQ7Fn7oc06TIdJagbB(-(Slf`9abaF! zN;4fo>>oe^M`^JI@>bqTR{DwwBK<;d;sk6ycHifkzw^b8q&LhGGD?R0E>dbwfuwVZ z%yse;sTpGKxj$PB$l3OWjq>B4Whk#Jr$1qhv?p%#54qEQkzjQ&pY~Nvjn|$)r#V-F zEaZAVv&S6ud)5&R@~QU6cs6Mr59Oz&Kf3t+7f`z!f&UX)zt1WKmY6ohkC^=sF->^s zqu14&OVqJ0n|^2VwG?YDCcoRu$dBD-tBWd&hF&NGmtD1xcJO&uo%8o#G?2D$gUXJ=L zr!x$cE_&2d&n^py1iyMkLdS0z`Dk@aN@rMA2t?c=Y~*+1bM5O(EqbpSc&QOi@mmdi z1-N6X=k7{+0#zxs{;7viTx!uEQ@j*&YvpRA&Y74(`1RyMUb(RV^NR9+c^bvd5H#$6q`S>Fu3+thH$Z)-Y?bXP91um9fL-GvSQRNdV(L7N#hKW3-RXaYp4;_14r9nYm)@$yX6O~{%0I?$b? zXl^ZIEE?tbfXH`^65sCg!_X&|#xL0;q@Ok|Qqi%ov4swuzI*nQr4nAuP3xy^VON~uzEf&HDLd{sjw2Vem!LI?PfeY^CBfbuib46L^ps)QDC50NYnDU>An zMrCzb;NDazL*8{j2eVD}&3l^i+p_%WO?=PO6q>I#JYG3V)9q+lwdvHvVD(*UtVIHuX#R{C{7z`(M%MKPd12w?!ks9zlP&*_nH- znUZNm^~k{NcPY@npYwGlPzFVH@)J!}nQazl{H+S%PMER<+W{*>T+42C9RJaR{<1WK z)R6-l0)t1mZWhn}?-Bpr%Kxtgt>)JyT8A%o#Boe>dZSnR zxxSZPA6F|PmYY9C<$I!0ByDJ9*fiRrg_#(IR)f-7McEg<(VC6qoXPSgZz}bo4<(iZ z`=zguv7C^>uW@P;*~*HSXl`7QNK7nRS)=ptnDrd?S?=MEblojie7x}W@&n(bD+Yyy z3&p}VqjFV-O=;b8uN~R1UNyiv$j7zao9B|Pu&8S*z6+fn=7gT3_VsBLIk4R0iBZr$ zoJ!%bF{}DMzhwSRbXjei4e*b@bSYNGoQb4d>5Iabs9jiO-WcLJ8LoatF*c~xy4cE1 z`{~o1%hASgOZaLXTiWA9u`Sb3%^tXlMe)(@zWagmA_ZNIZ&G|PNz83wr&i@C_}9(W zyJaOCB|fT-E9WgV%3s}B89IpWvh0YzJj$bUM{;{>GvaJ(iC%2cmTs=dI~_H~A)my- zQLT>`IB%S&Rps@y#_%?s*(dt@1%$<4GzrODcgRXi$rQ=@Aoy#cQOn%taEZsI%62uo z(P!ud+Pzx@l#26>DWikQt()|`Yb>LJmFg5aRMx(M{kj4IzfF?G$f~Qq9A0t_M#f%+ zEUFM4$!^p-^4wOE7^>}XK9uaYl6@xWn{^YGt*t^$^ZkC)G*qWD)|XNTA>GU@rhg3c zUA}$0!oO<5W)VTta+v! z$1QGr`!1x?!;lHL`QYHPQTFiQ?6|5)u8JZv#VZguj9G1tgqNyBj+R>R^%qH$jFGV| z;dInxE^j|=tzi&b9f{))H*Hi3l5-^7RBK18WNK}@WfQZu@<|R;ioA{5uCj?SSLcUE zc0_TdBvHBFGcuan_9VZeN;FSnCT;w3eH--=F`uA`2!$}DC;4V!#nRxnAFhwGc_C2n zC|{KKfzC`*=zrrN$AXaka5Z+f^)V29xyIhHP%6UT1Ob2vK(4o1x$>_(kLZD!5I$f# z=22bTkngoXBtKTlcMS~@iX3`_WS2YtexQSI@^rifzJ1Lhk@3AUFXR16{)b=hOAUF; zjAw4xj2jXvd>Ojhk?QpNtmB+!Cg@K5*b!&svkniNj=(ZUJjhUZ#7pB&ZS&?rQ~;w$ zTO;TBaOIStvwlwUhZ+H0^qtd@4>bv=XyK}ShFpe62Tncqoi`4o7!mn{nX$5v&MccX z?dq3LZ2Ft6ne$L6g!9{-YZ{N&m1*s7xkyrS>pk`i~%QGH;1H%Q_7 zgBH}^?0o)n5gL2x2glz8m~E=#d}~kYqjMSJZZ3Muq3i9#P9M=8Ch4#0R7Z=Slf+vj zX0j&#$_2nL2v292NXbf=4uqMln#OwW$Ua{k#K(`>w4m{5VH9E^&eMHscS#_clP{f4 zjnl9sIOV7<^8NFVr$n?FYbOOQ4H?QFq#s^YfE#WF5&sB?doYvRKO1=W_mN`j!oo@Kcv4q zeymd$MmTeKr6AFHuHZhow``r4k>r07OS1S^z47DvWOM)iOO~T;VrFmL4(1AY6-D_w z>0ZlQCb4|JkDl+xQClP>Am~^(t9_%*b>`@oljUMK4J`4^REJvhz3e;zr4BD!(&})P%uH50J_`}IQU;2es~p&!_q?tfeIoVrXTnW2Kf4A5$JRvO zct_XreBOAHI3!b8>Ve!#cF1VMXoj@oyktg2JD)hw)Tv@K()*(}dpl2XEv4JERjyz6 zRsty~$lhaCB2LBeus^9 zR5zf&)D5;epjlKo4kMgWi`+FE$$LX7b}f_azd*w9&X!|I%2`Kvv`U{mfAPYkJNfP- zd`A<#WqBbnR;33+O^ztd55q2nh5>0dZ_;P7G=lg<6q1Cw$YSy$%ZKRMt*i!fIQij6 zS~L8g!;`W=k%6w9t(%G3Eo#D$w7_iJYMm=SMUI{SU2jXLTuv~+3o!G z7Uu_63X6nM{uSpVgGpVsQ*M2lm1GJDcak&!WL8M+AgClIb8W~bhNrUq77*DxWe&Lq zHg#;o1^p~Lq|2Wqdo*i(vtEhj>kupFmsJrE7uay{Sar;OYMoDf=YPA@f=~W3BS#v4 zjZ@1^(|p$esy&^`{TZ1@h)?Zo54(pY%95_XJWEWqP^n=Nef<-0cBWV?g?>y6nc$Vb z=K{K2nF=yB8>B~;Cthd>p*+$-Z>P&zCV`P?6U=NE)NaWMV z+YhhNwML9e(J4Jk55`VzxcFiZ!(pe)M7@$W+%}Fd5==~mU2gdsnq9l%dp^wA8c8dS zHon%6(gRcYT|OfO?j9_Cxrxn8NYb<_9u4z7J^Qza(`$S1dvdB)dQ+oZiB^<)&ab0L zUsjD1_zvD4tpBW_PdSwkL^0B=YBMI$I-)4N^Oa7$)I)0&t-2ODcAe9kmrUi#21T{6 z6U%+c>r@Rvs*n?E^@ml``icfd_^n+36DByp-b^?W^_zyLjk(9@_#o^6HW8+9@d z?Fk()AGxq<}w}~!+h&uV_0XtHI$(3 z9`8s+Z{msR3-Vme4o_lT_|}9dUdBCv3fr1ggIqF|gNX~7Ta4Zo&{eI2hVyv&(XVUK zvj+l|59L>VIxE%}iSg^Vonq9=Q2usOVkf(&dfyGpeH19;d=PB>@{JRf6a}|BV z{_E9Vd@R$dEE7cSYs{n%X~?{PKbK7>+NM;nAl_-X+C%3W++HmRe_e(^Am3)#x{8vy z$k9J(FH`;7dX95q?nH45PXd4MsZ-f0G%UoF+#E0;ePI-v|6cZEA%wUO4a0`8_Yf4% zDtu;YYiMMn%(ZaF)<*@e-T&XH$G0 zyB?NLSUlg8Sy!zB^DH9QirqVh{l>-?5C*bhUsgQ(8zFBbSpS{Q|MGx{ulS_?b?U_v z*}9G?368Dbs56Ez<9n{)0|9pPfTJ+sDnx!35@b#d339^P^ZW-J`gy{GX6eLC!(UX3*2Q|K2ix8RZlQ9=<-lzT|lL4$*(mv!4oh`?3_|2_*jY zXi(YTyt|)Y5+RA-X}=?9$sXE&uf4yh_1BjWyqkFTS8bUmg8%cBLGXRfvOumv(7i{p zdjHlY{_z9LIebDSAu_fc=Fav1R=CC@kj^g%kH5Vui=PxB5s4q$t4GRzHw}J%F<`X1 zD^50lCoL(K=ip50FR9o6_DrN4m|Nc63W2|SeHN;_c=%H!hCS#1_ROg?2wp)9Mw|Zc zl!fY5G6c__@RkMX-=4Xtd20A%SoPBw7Z%&>ZZ}_h7PEI9#mI<${V-|M&vg3B-Hkvnydbiz$ z-c|2e83W|hT!Y5ITf=T5e=+*_S4i4bL9OLaMBFlA4AJ6Vu6vUp)~Kjkt*e)`)bd^Y z>DyoV0^#o`89jUj-bx5enJwX;r*tIA^5?__|wwW zKhGUiAee%S>hUxReW0#Vra*Q1xV~bk zfkU}S4Ssn0`cvGW^;qg6P)7rO2Tt6$Site=+uzTe19Q#-Sz!8$wQEKZOyTiDB=u$B zK4WQEAe}iZ8!})_hWEh_53dH>{)KNb01hq4zbOkhuIJ#G@o*7C*0M24i|f4Su*7d#&>IpB3mO@NNvJE@a>yf0|Va63=q3<0g1{ zFd^%Ip~C;0kpE{BGV~#{?&NrMy?mB}UdTR~hF4ciKt!GwC;Q(S0+J8RMb}crO`vL1 zTHtt6ft>LkIEj@DOjl2_+r~tx?}^Xei}#8W!+>vYWHVZdC^Bh#ctJ8`fW)s6+1j8C zXkONP<8DbuTW!3!iXW&Yjh@!2QO(sHsD*jaZna=<`5t=V9}vOfNEjlYl6ThG#x z5TH3@55YKA8Jyu5$aF^wtCfKv7 z`{8qVn`TL{g$5jXF~i&z(AizC3;8+ZREuV8;p%cOxX*yVL1&Mz(*Xtabcm?=1WW3egNA@jYjOedy;X|9# zjogZfVx=~t0$xYEgX60KWVEjR^?*rTE4r5w#8d?EjNw5&Uz<>R!P1AJmxcia4o4(G zu*rm#Z{`6YHCoioR@8YZLOxM!xORVrOwB^O#?!^>`=@~UuWuU>2p z0)Qfs%AO2n&*t3KCk44$WtxDkt`kSYsUjOuCE(bo0?E0Fu;@+i+yeYMM1C!%RpR8( zNpwC^xu>RE&-ZA4LEZp0Y?hRerNB<q#?gZW8h+Hfe`6p#)J+$LdzffS4@&$Wo4q{h(DtOx~3Jx~JE8W99< z$Yb5NiaC(ut(lAdxIT~@N9G|DddXxl!7ULk4gGrf<(#5=IFq<`0Tz&-s&1-#L6Uqh z%L4jHNY&w1TP~o-pyy-sMzri|<~t>I&FOaOIh%QsA^V6y-QtCgxT-|1RJF}X&@@qX zgdQEYY78WI+J*~P9%EL=>)cQyCNbKMui;Fphyu>$T_S%_;vV8I8#A2r-VRN0Xr^1& z?)VPMv)Z!Wn^X0v!b(kr(uaUws(BNl3%~>UB#H6!Jd0gPldkJyu{!~fUG|F*J=ktP z8c?Llr_^N3AvsSmrK7gR^KCIzt#bge=^l3y*_l6u$mhMevFNuO@n}J1i2zg=j9}SfBx_8`axkM?1ZWk1iW;u_puKj~eYea=P1B zEM8j>H4N&w=_vI(wogQ8jQ!|_sK*Q*p6t(t3%IPP&{A+YtL-8d_C8wW-3rJjz2Op` z`Oa&5p@YY}uO_)dg(RDo{ojQeEG%TNx(ejiG?2co(pY!0s=`_ZKPEV&vTofu#US^|3M6Vi_rKlrXjXhIIb+*L_Ip@VAL z4gp|~DIy3XsWf17TrcBr2KJDx8G!w01rwI4&(B8Cyjn4%%Yt;8Lk?S*eaoL}`o~K5 zgJ!5JD7>6amHd;#?XE|Auh#jwten$(Au#5bNOTWnJ7wjocfu49)ehDE!-oS78j89fyG7nY|uJh4qr)pPINc-vrjLz zY*kMHDw)G5WRHYyrPDy*x62j4)&U_sDXp?lDk}}$fZ!1=b(@u^-RPM&yd%Y3606yK zG^G~828_VX5;bMp_VEkf<^Y2B2FrC-S`baNW#S#Z;bJp4+MbO!(mF?CcL45yU?}G_ zfY#(XK~dS3IssX4Df|$r<yhZKy#GTX{R8!GQZw9p8H6nfjLHy(sN-tRr8?}_#HP(&P%T^No( zNV;-#MJ-QTV5e{s{Wh%cq6P79f*M{Rx|+Vl5g@dk+-#0G^;DtY;!u^RXJ1%*j}r z1&Gue40ae*lf$AO^%_%^U4AdT8zNL*QWmY8r-{ghQ>itTKF5c>;TVT&J2(gNj|kE~ zlavY~6BW~p%Vj=*crEOk#phm}?(Tzx<$A|?2-k=H6wCWWE+bg}^8AeuI=->QbWALI zPp8(qVw4PuMFyTiYJT(pL{AsUD9fWw5xV(f9Ql)}-oYZ)+2n#in5d1&)UoIv@Q?Y^6|VJ+K5h@j0#AC$FKP0lA@ z6VbXw)WFUio`cl8T-VUD+?!DqJXN(`$@PG!U_r)f%`y)mQ^M&0JenWPvE^&~fP`F4 zgdGPJlChy1T-7)yoAztf}pT=?rEXngI>qZvT@fq zEaUg1tdpyH_?k3ZfWhcc$A(Ez_H_y4%yG%g)~MqGY%WK+Pl8qh?Xb(zPM>&9%_psd zvpMzZe7_M)?JV%z+CcBq?KXx}7D~8{SrU=WDY`s8A&g#U7W8?Si}f_>={oHG8j_B+qDWGb7s`h#MIsgV97`WXf zvV%>5+0sZ^PMSi|ma(=(Ia%Czx#ICHA#}6S9z^f6-$9e%ero=(Bnj9UQw6CZkfg-| z@CnnPsd86`B)e`A^bT5tDUtc@-V3N9eMSRW-A9kwp};>kgY4`Gnw;!+8ZtnkYeSO7 z1DL%x@0NWj=5(L`OeI=Fst@IW=ilz8Wl$OC5)9=!INP1AtA;2-^YQ3ZmT2{8My+R` zRh@#9dP2W&?F>xPbb_@d)Yco*@bdWrXa^GO$GH@_r8o(SQ)2TF&libZc1hS{gA6cdv+LmL}wvcW)6(AR_^@8i9j8YVr7yRn01}YyE zzr1Zw@UL5uq+XSRw8MTvvQ(VlP#kyoJ4|BcJ_`b}e^8h|oX)M4dpChA$7CCB{k@1r zwL<9umr8+De8@+Ge~t~jW-aiM`=-?dIDhGe3j~r3nuEYy4{@(t_Rm+o0O3_H=|eLM znRnz{P6ckww9V#f%zC;m(3u!onD5a1Q-%=#S2#Bj`5t_f65?MD0F1CV7RFTIC6GUW zDu&yAq5Jtl$JDY`z$J+v>Or(6sUR_E#g^rNsVxLw;|360)08#^ZeVy|U>84Jsl;JB z_oYFEayGc+rxYTf_ymcUY|C7i&Dr13%I&@*reG?`2&^-Qt(W(cg5C+}_>9PJ1h}sN zk`p&&=^&g_>jL8uPr?_$&6IH{ki&qG6U_;U^Tx!uWI_rDNb;`SG;RNI#=`o{+OFs_ zD%N#sDn+HME0!&Y-{R?@v59?~5kF=2zTCfc~yeN9FMNh)XDz(GZZkHMhR z)8BMHlmZ9%ukQFuohQ6~2_iGybLTfGij+2xUCVsQ?Q6I=S{Z0y?96NjxS7-%Fx{3; zZIhA=fPoc`+SQF?_BQN5Uw!M+s1W79r2mhj8Cmd{u&eJ=a8pfv7L1DON(b)P2PmC_ z@IAnEEG6S9M^?I`KJGOB12+i!Kmu(%?N??yZYk=vUUG@wa{ov*&G$Fr`$cj710beM z>9@BrX$Q6z0G|k`?oOb}$J>-)h8crACkofBWpH$RsrDO4lGHb*jsLl_{5t%vB4D0# ziWeT^-Z%&M#;s4jE8;})9=F2aLGiRfa*r!GS|k1NqB#^3&*N>T+zYban)`-sqSYJv z#*t(V*cW9NxHYFpPrv+?3!omxAZ)$dlZFOap;qi|lQrNdO0+8+H9)400?~aj2o}qo z@+wz2t;Wg=tM=E&t85xxo=&$M19W9g(AtswbzLiH2q4n}Jsl_zsg|kf zdNl3oEhag(UKcR_O69fNua^5XMcQ@TWw64^8?&5I>V4q23cAoknI$K7ANeXs9y!xS zW*NrMAY*BA zw8}2l$A<@~Xf0c?!))D7k6b$EGyq8|l0aP3+9|prW(D9CGC!K73D4DB)hs1;EZA+p z8m!?1VDYmW$ceQXE@}dKnXuPNR>lob|KTyN1MP=;CAGXgHiRSGC z99jeR&8Rw6d$2%HFY1~D@{V>QB&jO1&%VJPU%;nuv8`8R=1z;9DBacGjBv77P#C-$ z+Fw@B9z{a}$5*5ILh46@$tKlkf$fbiHY@|^r$XY|8P)!RFo6DyfHVaa@6`E-)b9-q z*8+NT@g*bY~(LF8S~QZVA2G-pz|Mr3RcS-F-oW9650V2$6u(!V_9__B(+29lQ2C z;;66}^ysbt$eP!bKk=9qTs2qZDr5p-6(i~kV1@M>k@Jz+Md}+~v!R08>~@<^U%}Zw zgUoEthkUoy4CJ4H&j02AjsdngTFmM*c-pkXyZnG3ml&_N~B{4I<601!0tH+>wPe5 z#a)#!Z-iK}v>J2_5DnX)yO!6D8M7fiKbmOAD*!IpW)I0J*y|9SboRGiq8=j<@*uLm z36a;u9#!y0mV$a!BJE;YjkB%PAja3FB(7zq+f;|Oy6w3Vt9IE!%u4K<} zdAW`kUybh$s9dFP8@g(5|Drm244f@`(7T%+j2cM^WbN~T2!k_7V}D#WGS>~+2aq2E zIK@8HH~3Si+`T%?3fz`*YU&s{La^V?*X7*C7Q};>pi8u=VU{ot>cSFrz!Y&*{^59G zryP&%1zX`oAl(-rvwklV&V=F&7Ij&f!=!I&*qBRB>qETvHx0^OmPCi~s23!|%?Fr} z^=Y4RkS)MBoCd#d^^N4KLu*K1BeYARGY0rEXp|Lb%XO0zC64i%sD)LLGl>mVx^1kZ zMFyCfl3?gqgx#csh4AW)@_-7$Kl&JwRDklg+x$gLviXBRKcNuxuhIIQ0?8=AR25vH z^`w>n>08J)g*wnHKys#3uuBRb?|iGpu8RV2Ged!~3P@x8UB@youH@ZXU}oyT)!>l3 zf#kacYD5fY{Ag6+N^a8)0eNzQY7M`mmUV-*Np3W*7e?WLdxg1Qd>o@k8D_`v>e^zpSt9QscFlomL^qx59;m!_H z^eC~x2S7QC)WMqiroMvVPam&e(P z@dytA-o7?jkzxkU^HT#i(EaA5gVXglATBAs7~h6-OMmd_8Z00xBKoS04{YVtEnHL- zce4_Qzs6@m@HSt!{`fs){nMoW|L{U*FGD&Fm3VN0CFMIsk)wW4|k0-@GPHaAH)CRn%`8DkxAhC<9J$6T+#HtHW=DW>K$A-`oGut zlL-Fv?0kGm-g%^-n7i+thQb;pMe(Y2t_;Gh7FESKQqEkw@kfdJ0H6Uqo72sK(+^y^ z%I>H_1e_FMg0H~{sS|d1Cw}<#b4$oZ>U)JEu=r~N67O1AqIiybp`nJr@eYskqBzWY zcZJuc6U)b~H&Oiz)hiCejI{5W3J0+#`B(!mOmW-u8~I{Ktch6yRKgHOR(iBnaM@LU z+ca;ygkgOJmR}=ig}yadyZ`BpHKy-1^(rO#pKKHP8l-kfALuuvfr8Cw00l`jiz&pN z_KmQb)DN!hSO`6=d;I+cF~vybF1>YI*`(&Qbbxhp$v4&XCl+0c%YmIbC^*8(X1Zk? zM1s!^_RM~~GbwfK=d>Cu4UM{{D>lAI3_R+ck)?uDwHl{A6Rb|!Ce*-8#aE^d%NfMa2xEdF{C z=fTd9xYIx+caTS}PBER2#8o5%DSQWX8N>(jYzO)hnQz@8s0m-c4z_72TL$$l4}~S^ z7fE!MM!J{G>=a|oW3;`WRoYyk^vkbFuOMf}IA<@OELLsg-knWX_oPb>+P1^;H31vljgXDYZwJ(V$NrYTc z>RlKdX_k+(nZ@uwnofEy1?^Gr@(M%^6*fMO;e`LlF0VAqOr;b)akqL`Lo;Ny zU$x5{tvtI3s}ZfI#g7;#zEAzEGO*DD`{L#x^`M4fQ^0gXqCI+Mqzv}pDZ z2IT3-tX5($Zfg07dAHpcs*0@#*T+>wx|8z!Ef*9RMa#FF>wct@U)*sI_F9|ua9V3G zGEuJCdrpI-9Ge_WbYHRXT6ukUpj3X0opfVv6Ae*ITGPU~5 zy!&5#0I!ydzC1BHdA+AXIT#k8=3U!!UMYWa6EP2}R(Tbbu~9cP8kl??3)m+Kgen@< ztOhmO25gi=rqgcmYQFGuIdJMMmV;{>Ds$9;04d6nKgakra;((K=yOZ8wdB!ZF|1;X zZ?H_y=b$N299zw;S@Ol_2qh@WR&c+3-Jf2hv|2jl9)6)X+(N!t$y>lF(GL)^O+RvHjRC>K!<)W7|OP}{# z3h_JBm1AP2((AnwrNy0`b}@Rcv1C+|2hIj8H*Og5WhfTn6OooX#oW*_EgSRH(zjR~ z8z?upC+fbG+yR`{d}qSwM8d89gnTxDz(TX;+Y&5t^Q}y_;_i3^TUeL|l#Sc28-fBr zD7RK^LqLIC49rx=Ze>k+bycgZ$opU`&C`sCU`kN}gUquWXyB>b#E;uq*f;8gY9-iK z4zHKj1fj6Al(cs^@*xw)y^5}|Dthf}Cvt1b1-TjMrC@iGQfxa;ltJ)VA4h2&6q0%z*ldOf3j z@Aw$2Yt=VrDQdr&%&k{>(_(qyoCdxp;1HqvrY@t`bM{cZ;S$a%mYd~elXW(jkl0fF zV{J8Raf_`!Bm61baXUbEPa4U5+cgXgrN64NyENQZBe7L6J&^May1uJASXRbwRa>N{ zd&$NnKWA1K%SOfNw$#@o;CR+&M996GE_2Ce z|E&ya61IWxb*UPzIaFggZ_9Y`MRp7=_lFI9*WXp?er9z0Cpe8K|C90q7Y+X?Snjq4 zaEP@wsf$_J6I=6b!+o#qG*hIB#?Rcb`rcYM#ps62TdpYnj$A;#Xekli zYxF>)%Cv0ex7bz7pQaSxPw97i=p}irm9C#Sq7r2xhxKc2sGO~N9VvKPI^s$R1@xG6 z&S&e#-GOz?fGaLI8NfQdll{!!c+;`F``)V2pEor&$PW_q@CN(XIW@h8WsgB=nqW#i9zMWcMPU3>& z2&g`_mjmSa9}DX*3!N;8x!aF^1_Zx_k#V9aa8zr@EeayL^cq?3*w-3`i*EqLQ9&WCG=O0$oWIfCcW>oZO}FKDoR)mSq$?jWF+TuBA|Ew>|dE?MUPsTrY>09aT-jY$+$_ zWKs!$Kzd32`X!T-*`*IS{>p-5?tiym1oGa^lqVlaK~9<5#IP z0PKf?;Egg4p(g|+J%xzZrZ_j}$BeJv(U9DdRHUZIywRW?P$^QvfqD?5Ym3Osw3yX{ z36Fp4QTm=e0VOH`1n*T6U9*w7vYb|S+Kf?CA-v7QaEVeayQ;?9T6hfF4H(Hum>u~g zL6`p88vHgXIIB9etugS7E3CF=P)9(JDiCDJM>_cy-^{rg89lGbN^W&gW5o(0(G3sY zj5D>?cutt^jrFg7P-bHUmXV+fVOUE=+p1DYc&!r)TrMDXDE#z*K<|=!7eGTBdHMdh zhLT)42gro3KVO;zM1Bj2xWlvek-T`D>*IChocctb+mh~+jtlL}rYz;oKi(-ymX1|8 zWe9WCY@p0Gs$x|dQK5s)M9~s?(<2n* ze$dNWRl4`!J|6sDtD%EobZR%BP=Incd(?ckPj=n6a9LvHw0i~(L^1JpN6DO!mC%&Hn#Y>QlJ1OE0PqR+NK-9;=#eYQB zY>n)v!fba(3aGm(Hn+htMc{QL5m{2VkuG&Jdz;y7hg$UWlh{<44I+H=4O@~6c5#J7 zwb}J#kQ;a*iBbTLz+FrT+L+X(-B(giySfIDu8Rqa3GdUD5!>7}f5L?W6;o@r(dW68 z$^l{r_+Ysn`jj(lGRKAUau=>bKW9&_oLJ2^YbJ~!dTKteFZT|b)(W=0BSvawYsy{Y zI>YOUSuS0AfAFZkBL%PE(uQ+yN2&9$8M^N9%Uov&s=8pY}I zW2>YwgWiaNg^mOhGY};^+wMuxY|D^I6w0FT7{c5@kf2kuf!H(cC{@#AGEy7JN|?)J z(Zegowk9gxCL@hI>t}ld-sD)7t*fF#_{Jn^H61IS#P(!OXk-x~eGd;Zpzvp- zfTe8hHa5}dISDiC@lq!9t2>z{uBsg;&(kcmcn=40>kJQ-Zr!w%)%Qb7`de$UseAbv z+fk#% z&TkVqiQdXG6uawVL-!|waSO0T2_9;WpIXTQ@*aETPCsfXmS;qV=OI=UKO^{qs6lNL zyB0KRtb_q@L2#)UQLf}kH5=93g_27D$K4ZqW6RO56imQXpI&1-43v+>lwLmrof=Jb zV55z{aBZ`0Q_%g|62rmFwX&qOw`?*x=3^DTia&25!x`ayZu#c*>Mba_9@?(1I#!u5n< z6(uXOX93MI4u8(kEE++98W{;q5J?}RKiH0fuVrNf4Pm4<6Bhf#RP)!PR1uG9yb4bI zUY$a&s6DLi9VGxMQe7E!S6B(VTug;S6sJZ5lyCA<=2~Zrpxviq%x&A>IPIUh*aOgk zg@r%)G!{6)l)CA7xkWL*jZdzN`Q!kTud~z*%7EJ6aB+UFe|}Q&pd!$6K*%Qs?ma~a zLIp)gXc=xY3a^35_@TiD=`5!)WBujqe>oPvG7w=*V4PgQWyo-F>=RFe`H5TI#f8I} zgh;xw863O%*G1-+qfJ#%fYkEM!xd}xpMm4>V(BFClm9hP?lNPD`e!7K8^OQKZ~{0k zuhp)8+)6G9j6hLAV(wJ?78Ieexo?=Qmk~>89G?=BO4JM&joB8ScW62v_^BU#?ftzSCs+I z_v9{MmWa8cht0I!T;R?D9|mYa%}&&K*?^)Wt~;a(kR*D=PXHOe5cG0PWP?q~!KUo& z5Q#jVpHUo%aTGwoR3AAp;`GZEr(b4yOV@GwbsZ-dZ_uD&Kb_Ah0Je3p10P-}1#}s8 zz-B;UR`V5qoT3Z#G57ogPzoCy^&_Az<;ViCQV@WM2;k1Axs=yVjUaOcPu1Gw}#pd`vuF7|yEY!*`lc2`sf)EJ!)YfW!Q_*8B}Z2L0bV$Y6)H(pL0 zUI&bs*;D;Mo}b0hLq@9LvmMyMx?`Gwh)mF%^XC0ewf_WyCx!>wA8|%zr~)FQha6$H zxG_wV0t7#gAyf9~2NG|To`m;B5UrdP*F_lUWYFo~00<^Gi1}SNr|zx-_B}ij_l*JA z$E-kV*-Q?wUlkppHqI!Kq9ovf27t%&bb7*!JsL@3eW<= zz49fd7{Km^{h7}iZ7Y|r0v$;@0+L;S@kB?j1#F+IO_JjZ9WQeKVHgK?n$DU@1AAHX zXy>UHeiC&9u`!NOA?m$fKo+_??O=b}9C{9X?8IyR2oTi6aoqwiNIb7zt-YO0C$3=+ z=YfcN$o!7BLOv&}oh0dHt6bm9dCw+8fouHndMLD<`hE;efvHd>rQj$J@q{XLo{Px0Kv;HhFoz-%2WewUc05<3b?=YwI- zHDMZ{Eyy+^ zpn+u#5WQVsY9tKa&Cj4axHf?2KfqoDTA(mL&ZoTD?eyIbk6?^18M8m`HmNaD?J;h7 zL;m9(hkVH&U(SJ^F#f9fXe}ibh?VHsfH}_#WU%JoZ}f=@KQ;182r!lQCp3&dE9_5z zqJZsdseq|W<>Js6*iDfdPe!deyL^OZ>CMw$-ay=e>i|UD{ED>qqkxst7b7^~-Uy2T zjHZABQa_g^g8MM4EJ_)gcPj*KpszG;&^-)>5(L_}Xun#)RGVSe552uQ(A!RGjN z*r$9Yxg!WG4jr|qx@^cm&?i9GlK0es_3?Y|EKPI1cu$PXh9urH3dANqyIU+h6~yHE z6()s25>Q@2q(o>kM{{QO6MrHN0S~~pLF7(pZS)db5&Y1y?X;C?IRl{7Iomb>Nhr zuwJ#e=d(tXJd_P9F|`CrSXBFcwC9^jm+l$5FLH0Cn`2397*nD?!I}*wRgo%=N;Q6( zX|$qn#*4W0`_ql4e$!s1QzVH(V6YkoX7u&8MaD_RKk3uf$+VB2ake-6foX0Ea~;wi zr72>bIr33d%_1}BkwbODEaTzq`$!4%D(h7;w83F4@}|b?`egl$W+056CeocdT<`ni z(}`}2&1^0eeYNtxvR;=>mGhplM1KlB=KcF=fnkcvTAoX*<+W@t#8H+pTex>wRE&i~ z4ig})j=ke4R(TpblApr^p5oS@w-9RE zRP)leYH^W{O*0IRt5I6>^-!})vF&aJ{Of-4jr9PPD?Z!glZy0za zs(kj0v86~h`yg-^yqOo(DHa~aYN;V0jBUo}ot$y|?l;bq-D+Ms+jWj|{^rZ9^ywPd zQ3vK*cA19O`Me+SsdgyW^GlJv6mq?%I!xsD#U(AVIZ9ED3F3v4&(+!@9Rb{K)l#1S z)?C944Os%e#A&l?8-&lOVL6Q*V?`S{860zZbf8tF-$Y8b1d~rn5`SE?M`4$Jk*Bt_ zcG#mF)x7cXreMM!2q_K1f{|}S+%oTT(1)W~iMk5}L{O^bDqop$+Cvp}M%C9)P%$V}6I}FU|M2V|?{EYiNHcx(st;#= zrtFaFwgQ8K8ylk<+y>K=3R!kri(6yLqqwxskCMYXfp8*b?G?cpI6FSRyY^+mK%ij%#2Xe z=*gaoqO22=yHL66>!7~!C(7)Mr#tj+d0-NLzQ}CgWDSacsw;$_^c>3SEz=Q7znsKu z9d}j0FAc!fbQB|4Mw#xpzD;r0e&Equ5AH8AjuHF6*b{zCiPC3w89EuMF-19IC&Vrt z5ZymmVZL{pnp+c#oNH4wMPuo&saqc^>8CEPzNOJi1vqTPkqtz4z1y_`vNwp+<>4(xeMfsvYiF`y!W&58- zR+gM~cD_;h9S#oJ;d7=Os$!|QQ6%Zy@ZQdo`M}htnD~X!S3i<+*b}@dD^8+2N{wH7 zO68u;427cIm1PRB*3v)b&VLp&pkBn0kll54u**--Gc|LMcG3JWgR_bvlrsI?fkVNM zLl1KrIR`j?*|2ix^@+R}$Qs2ikr5-G<3Keb6j<2tO@IUua@%)YDrBj@4liQ(szTCTTh1} zJx1{MN96e~Dt4Jfr_M_iw1*}1RnRd-H%zXrbV;r>@a+x0F=dxSW6pgL^VC+*&I8=F zjR1G=D8yX&Aa>~~MRWMW+z;B?hxDBj&K;lnZam_?;+#B?ic3RnQ;dJ2d`kCpbVO+C z7F!_BX(*fhv1qqiJdAg{QK7?;o-?-1KPgC4-N`8Al}mS4FP2NkUbk~M>zr}Ix$uMd zE&cu2FFjI%Pbiu?Cz=*1p6NB;c?ZqlfMiYGksM-z`U4B$lYlJe?1`f2)Sv1+@Gwp! zc`aMH-!J1Zk>Ab!=+$>7hn=-Xd&AD6!%6SEz58~QwFpnYQli7`+)xl8tW>V~Q5_DY z-okMpto(n`UkI#Tc~`Qz`MH`<+{4*AYQJM;ohN`dbQyO|cIp$ZFB8so-9-c+xm$Dz z1x9BYKIb-G{!9XqbGQ(QTxjCEDcoeHT6FAmgNcOspMg~pJB>zI*Upp?Mg24D<9&xI zQ6s!^RDJNpU)%&gSJ1^(w!B+)bc_>-zY9m;&CL-z$p$GSN1!Wf^H$=%5rUVQ3bs7> zj7PvoC0q)j%4{`b7t&2}q1;{0%=7r;FL^|Fr`?k0h6;42A%0po-6VcY&Eu~-^kD^c zMW&2F2<5jBU0-4;wtzfRj6B{pd_F$Y`|&v^R6u$XY8X!Hey&g4ry`q;QH5OZwR!YE>au@gio~8n2gt0)z zYeBp{&8LCX(@fN(d^k)7{70b*nH4IP%tOcrJ0tv&_h0K}wNx+ZsF8os5Ih&j4CW`wnQXw@eb?gFpBFX62U$vFP12`Yx^9E^K`w9M> zxnwr$t(ho{=b>Q;C`}emAvfWN@9BSrz-9MvV)#=6%q~sT+t?!6!h7oQTk6u_cxN#W=8T%u`-LklQ$0TQn`vE+5H+k%*fBslw6Uo5#UX5ow{chHoQnc<8 zX{mL23vbRUVIv|!VV1*4`#u=IXNdV~OpIIrTPB&~9Xfco%4aDz7_vmZ*v-H0`9bEo zrh;X0W61S`_Qn(RYW1YoohI(HCO5c%_=_I#PcbF(Am6MX>dwG~G0cD~LB!X-m|GHC{-}4bPdnCR#x2&yofO)={+qj(JVN`{Pv>XLnMs}e zmPnGjsLN?1Xj{_|r&q%+0N-yqR*|Gdrwd8CgoQozJ*mw223z>-**qL)s<*5p}Uks-~c8}bQ}4d_anPoMZ=cXz0nt> zyG!j@rm`45sYtgyT7LQcbi>rG$BS2#pT%*lH$VAY8)3Lv;x=T(t)9KSWA7}XN3g&gYK2-Z}qX(H&>A#7}2oAV?=@c#1ts-22hOL-Skq?WfuY&vF= z-v@$t^JBOWS@b+2&>_5;lNCte%j?uA)j0*DzViB+rfKgIYWNS_85s9;&%Lj!-$}_v zt;FK3XI&0)^0Zxhwr^@?jE^#S9VpUg`YdA&a&vT~om)OeI~Gbcrc+cC)(wF!CNh?y zepmaL*3*P%9}vO&1T0uPsa2}UI+aDyWQtX&Bh^I+cj!9&K*YD6*>pHd(NCDLgK*2a zq1n?9Q%qV^oL2IysTrAG%!YiKDkv(X>18?QRnM7DojoNc0reIfQ)_ck)3rfSK2~IU z1VWZpzzCguY9+c}oig-%_SW<|?Q*tDbkkr5-#cp$zZ%X$olhUgSSrS&N2v%KSFZHa zJ<9JB()q9re8!UCrT`dR4-n;moal}zhI9WF(ok9H45i^ zth^&^v31J1ymJ{RBiY;}lth^8P!RJ8`-6tsag?OpQcYFcc2|9BCuGF(>A9)#1L{v{ zf~F1+nK#?BHz6EciJhx=PZx1q(ueRmXhej>QK0Sw+xtrz!as~cLNt9nJf!2Qn%aTT zmM*0#RzsvD`8TTnIuy!D%@wLsbW^jFV@_?qVMw8ETH@MsQ0A+rxUNJ(JU42_hSAuK zgr?Ebq|JTW5}WdpGv}E)(a}z~_fcg9N^CBU=zMkhen+EPvRCf`!bu7FDnmmxb@m$KG56w(*<@e1l(d3`tTx-sLPAg0g&c_+BTZGmh5s8iIPUe zkgqjRH|L*5pF1d2M7#PKwT$q<^^U>dw_~z_j-w%}y;o6To&S>`nXNt}aiO87K0C$7 zZ0b2+5bDykmz%Qgqne4eIT(V}>rkK9Q90O=+fk{SYK1Q@CY+5l)L5XsPkTPxu0G}I zQ~=vD!dHelNrZP2nx_D}B zf}n1yNXIpioTfguvK+e3V@un7Q41$y*~J#tRmenSiKfdN-uRlgQY zn7Mi`CI2X#eo~d0rfZ*=fabS$Dr2_&2p1G^ZP5GW|9T{7t$;S(`CgZGQX3~y%b9GP zpZ`Qjo!hy=8sBvqg=&RXC}ui4^4m14A<&|FNxF8VR{lc7s7fz}VLv-OKR_8O)3MGN zK9xGfK1|^vlr8bk21m`=jfJMg4cj3^HSY{y^S21kXsVmF&5e3b#6J>h!Lya+daiVJ z`(c`)mg4r!mKCBjissh?GKBo-=phPi_*zG1t8jk@j!&YIn_eZ*GtfHPNR5I5fPPYx zS-x9M3IUD;tF1?Wf6Mn1d3I{^J7UKCtyKGkAC5$qcdH)|Q~3|r2E#xkA;It2;K(xA zboA9sjp&%~UPwRLqh!oW=f39rr=)lmO@cEbY~ zFBluM3An|3uPhRtGz=`DfoSJNWvm8Ms=_g~b?b(fY&mVCiE=xi`QF5pzS#1+yYWoShMvVUehdDrAO3$PB+NdP!!OhFw)CZ4pm^Hw?wF;}BlJ zCopAf%H@ZMUsW3D9Uqj(UK4+XG48KJ90l^0#kg<72;+VK z#7g4c+g1e{jTxa-`D$|an%iRhV;2dK#P2~B9%2uEA$F&5_Sd6QO!N`z=dAaR=oK!21O}-EL!tnS4#ux6A@HV_| zc^EGwuk;5?Dm4_7JG@1vhmofxYq+QKfk(~3YDeufR27HL^#bvVl z3zk11Zy`YZ%Du{!#4dFK%|qMQH(?fI%ZJyHX7=FpTJ>yU#v6u|b6z2`kz#zD_=H#V zAh#94GR_1(bzvoLGm+UOvzjw!&jp)}cDr#d%wVuEN zj1?Fi*^Z^!)Zn2%zN{4Hu!$ig|MMZdervO_sx{$)#E;R>_I8?$Q4S~7y*3E&^*Jra z>GO!#%<<`8rnkZXzWN!*^K)dkH=b#Gl;-NKUa4VeggiKsE z@f{9@T9D^z5m4O43f)OQS_VPwz5;0HPY806WVs_KlLDEG!1JXE9UKSB!PT@;a1MS# z16CSRD#A*AU*6lD(O%ZK{Kl3quL3~mx)@1b)EI3o6+X6#qS7&-f7*tzG2Oo+inFx# zia4a-eFyfWO3EVBY)nfcriERmcP7zUM5K=B0>*6foq1|o9?LY#j#{_X9?p-Zq#&Ld z26HxvaOs`=_Sy(;ND@eDK7n-To3C715xR67Kl;kk)|F4p_{xdT*`Gqr4jj)9mPum} zE)I1mg8b{^^!YS+JwIxvyPdx*c(r!`F~k!;sxwFh_&Tr;ATeJls7^B@6cxpv8NZ&1p+?!oDT7`#~CXswvG+~%<2>s zD_Q2mqX;(b!_}!VD(X!-uue;AOK*TYZgp@PXd&)O*+ufnxl|B#25xUuZI6HwqYaF3 ziLl$X?g*+8e8pZx`Tch{y@N+)Dq;RH5#)fH@K@Ui%Rp*E61ugWk5wq!GEY$THP0r? zrkDhWCVjOlBZwF;IXeGq?m2tH^xF9ZdbcC$$}F-qv`{q=^!=MIA;jrKpr&H+srbp_ zTw`_mY^KC#wauli6$7qk;!2Y)?%m!cK+y-Vg8^d*oxbgS9?2au*MJ5iYB9wPaMDfV zp3RJH7+MSSezoBihpEwo$8bK~-0tJUgTe*bb?0X2+BgFbaHc8jvSt5|8exhY5}kT% z*|uMIflcEs46gjC3DbjmJ3tYXZlhM;4QXyY8%b3)iXBL3T|+4gYgI+w9d^Ipm&XUG zv7*}b#1>zVa5A{`s}pKS?~+ipoAVF zTlIx!-$|6GmlwBKfcuChUw78*b9P4SjhO4bgu#IjTL`mji#He&cFiK-B%hatx<0^?p{A6;+UOH5q<(~YIRLqLc7 z;ROyxK2%*z{!@(FIt!4M#w3S}Zj75=NBBqp0MYG@JEx`A&~jj^6_Sde5lu<8D9@D7 zFn;6n*t}Gb5Lf6N)4r2FovQW|Q>QZs);PC-3fYL95K`>)#y$rQrh56 z+uzBBBYJ9?6S}`2R;7SJv$VGx5~h-z&=NIp5Y5@S{nyEB?1>*06fOJZ5FDG3Q>k{8 zSZ6{daW(;r(~932^YtM)!UPk-`_B3lJ?}+4tgx*SH?AwRL6+? z%GvHFp)(rZ1_%tzzroGa2?x{?lrC!p;nEI73w}JjUsj@Kx}nff+Vmqr^)%COqj{fQ zsTyh~!%Gdq&R-W^v(tJ0%~gCC-p^YY!=%r5-pEp-D{z&dO<#XvO?9e-7;U8VK zq_ywe2vaBM#dfCcFT1CaW?JU;8D6{MyFdwLzu2?6TFJ+Xk>|f46sD76wv12Oe$Ov$ zw|G7Daq?2`+tsWq5maiJs`=>1F~!zay-KGcWHtP~wX^P|UeidU^_}?H*80U23b-J7 zZYYy3pgH3EIpTUfjh{I8wFRuFlpRP%ed@7mjkgk+H8nb%;K?*+Ypb%7wx!UR zXsn+y<9fHxmNmY#M~KoF{K(}=Mob9;Mar8~9Q%dQ+}d7l>rm(OSBJM74OfE(=sN;# zVl^+|S8O(&YR7PDG*`=0EQ5uXlhaTI*nLOy@BR#V42L{=8&*%sW5o`BAEv~)^R8{R zP|uFi(z|T>4{JW6`s?B!Up9Dmoh7#(5m!XeT$_(LseQZ zTeowT{Wvxpa49+Sn8TsjqvBLoKKg*$=J1Ug_{%-r?fM+Pr3Zt1lK~351py6^Xm)xN z>Nb+G;gDTBYXcDp&O{Q+m)6-uEd3xD!fhYlZm=eMb`NwP|I>5=DQB3li5~LdEOj3j z3IK)>kPdnnKZK~RS`E{TB10SyTj>wFNe;M1;`AAkBcBHoRNUR!@1F`NR%TtXq~pgUS}XAFylp zFO5T+-FiIk?)%5^m?H-zQ)kt|$y5bC@pfCm(crH*62f7=H0XW?di3?`P?sZ_VX=rT zW}b7^*S#aLHSlhmK~4R<_MKYM+OkHo^w_89j+zm1@WHP8 zRr;|Jg=)`DhO?bpd`oy($3+JyQOh`y2Mp1HQRR4~)SuL8dC$Te+28v)XMBp}>8#jo zo7ONNX3Us8{T2DA@T|kcvk<`M<6U-o2?_mQAmQ%nFIy%Fz}N_lnHle*@h%i;aFw!B zlV~K;yC)Za8fgDTaIST0VBYP%bM4Kf$;-}MKa;xr<&TRJyWaXXGQLiSe_1gsaqJ?o zHHpFX^r|h%g4G?s#g`X&9Ur$tsf|;!IlY{Xu7|kYWExvyC0r?{%}Qi}m#~~v6mPI4 zvH)KGy1MN2iL?!8;x#Jwvx6eE55gT>-Hc0ZKs%Q>X#VypgvFgWvZkuuMdU%V;OaQ; z3G<({7O6lAeGKUZ~9)iACda^L}`LSqYIe zg3x_Ul1ICy{@z072Z<)b%k!=tpPbyYctZAA`8pOm5X5>N49qPROCs7agW~rWYB7ax_!&+x%LFa_lrtZWT7d#ak=id+}v%Pnj z7AvmfRKTin9uXsLEeuU@4;hWi84OiOZnPFR>UJcbh?tm@H(koO=?M8q3iYYGF<{w4 zX1)`Nw|FkxTyL)yf%)OOWl*BC)~-HJZW)g}spHN?T4YYVA7f4{cU4d3-6{^!XCNzF zW|nvAniOLI>DwV_d=AF*$+OpxIf{OxNgjC}pHJxWM*bCk7Z{h8m1DNnKam!Fw%tz> zcU5H{P-3JM=?-|a_;qV%Fpfe(Q)r~XN`yBEfy*{e=?#jLl4igkRB!h2^5OG>^wi5s zX0?pmwwl$*vt7)HbzJs#;Z~ajSr3zcS_(ir+)@x_9Jl6}=h%yjh!H-vrFP*~YnT!x zBvSGp66kFpgK+Ljq_GQZ(KGysG&M>j?r9eFu)uftKZX-j* z$fO(x7q>ptIw(BMmy4vy z$)R7iYk~9XX)PBi-5mwQlqUSHoA_NmEU}#w-WCC|B}Bf$uyN6int(SXRk65X7mrqw z#r;G7FhtF8HdEFV`W@?xoqZuPtE0gF@5W?&;W0G?=Z0lP;x?GB0;j5NFSk`^946Rb zAR}%euN0AGg8-!;IA0WDT`2kUdMLVC_s@Rh%9L1WT9Ihvv)Ni-oB*ry37OwW&<9F| zTbw;*_x*t_1d6Z++R0|1`WM*>b;qzon>GAWi6nYJ#GUxYmI~`-I=x~UrL6Ome*2}Q z-u}bIXKP}nyxtSUMB8Q!x9&TekZwFCCD2K_6CNHpjMLchTym3=c@Q+ zI7o`{3ciCzpg8N4b%`ylzghb;Ou-c*u?ejjS=6dDYY}86H*Oux+d5)&&SqH8ps}Hq zqGC}fJxVykq<~g=_UZw)ztKJ3F)wlf1+sexC;JNEkT>Y;b{qPccj&RDR!MJc?I^%- z;qbyESv2!p5W!YXcSiq!w}_a0175fb(Be1n<=#1EW||~jqQfUoZmUY$j|Ld4dRt1x z-ILGOJlH)OGwsD5N?HP(b!;eD^c((n!BDRh52ZDtC>rEFFJ8P@;gr0Ql2d8Zp1$vIW?)kQqhPJz3k#ZD7dhJ@kWoL{$YNOjQFE>$*^2X3& z%Ug>|NEAv2XJOSN!2)s`CCX!GFsoi7%%TjLd&bWhO*ySw+A{ZWczT;hZJ*Ss$Lrrb zGthHh!CZ&D;2R{veC(eM_-&IhJKRD6ZcG()IjDfQt^ptBZKVLQm1knXhW(=fNPYi!gZ7?MigsfclH0E<9v$U+Or2$1 z$aB`>HEmlDiZBez?(=7fC2AtHzw!GJfh_P z{am?%ynr_kbDE&)ugv;{ku7tXI#EtyGSJfuAuM`1trWhkL~v5H1EtmXW#u-Sj$~`c zYXo?FVCvs(zdOuQ2R6~S$l58rkJVXWvAd)0>G=pGJ`N$K(>;t2dl9FY`}l$tI&j!G zyYw`Sd5B?AuXVVUO|EQWe_KMxiwitL3qtW2SGf3Pwh&gkfVTADp84iXszcJtFGUwhh3i`NZn9Bbm(f^5kZHSK8z}uY=vIsAR>?$bTmgA*4{Bie2v=xOpT@&ZgulyhH?bttFES4D1vr&-sBgWos$+J< z!YKlLl&Hrq_DrEmFKy2*o%MO{%6_ zG=e(~792(n>yFBfoc}87Mz~cg5?ag#c7j>xj2661&E9U)@%s4cHlS^WO~4P6f%9ixQbXUK(#>{Pr=iiJ#eSasY9~YAl7(b^_^)d^c2)Tk|MiRt zKKdpMbi(PdM83!J?jcd)@6omKbPLx-fBDDzkopqT8h;p_57+&8xIC5!lmbbd>{EV4 zHj^a`Ps^`gL?tE<%=x&HKEulUN1``j$-+Gg$Fr7wHx?zsnvc)%YnERl&n*T>Or`3I z%-Evgn?DaD{Bsc7w<>Bu0WpsguVG2`1fOmpKPF6;LafJ5PmGZ+fH7V(Tr`%xV)Dav zS>fL6$qr$I}&u;(&V z+JCdP=`-pda+ft_a^ITDaB3<@Y<*LNp#Wr%dIFo`#Np|y&Ot9~!j+x~A28%oo&EGO z-ri?Can4&8jzK2LY>d6ff18-GtMvMhB=Iv|vWl!<BSpJ?MGS|`CC=~LFJ1a@OoHkrSYvi))axs|;H0QJUa z<+Wzj5agy_ym}QV^)X&g2gtK^ej*0GD4xCRb@a*p@-8gM3a5aL6gh6|ttdh4b{(!6 zffetE=8$g@fK%F>V#O54^b>`{{HWvJ+-(MMV1~i-FGz5_29Rh4GIn$M_)bVi76nNy z7s>8CcU#0jpYTqX45O-2PQ0oUW_+QzbI% zS!C8D<`yt!9f{S7BZikIXMO$L#O)MXeMfdBhe>NkRQPbF8vDBI|AW6_f`Z4x98?so zu0@ta%qZH5k04AHk%CiBjQ)3bqw~zTyP=dm0B0khQ;nq#f_s8 zw92L|;Y?4{GL$TCsPD!q6%=heU3yQwF`?)KMN`Dp>k@6lh7Ef^N4{W69MMm3PiCzF zuIo1PumSQqAdZ;S_u+wMzd>GK@QYM{@3fYA&WK5cBhD`=Ywki|N;U+MpVgY*f|+z5 z9ll}rb9DPn{ei6ue~)B1_s0BA9+_=2U^?8NvwZdUANx$aN!W61lat^tbDi+cQ9ITj zm9<`Pxj6z~Su47Xdv(EyIqP7u!`D*U92??Rg%7Rjdl@cEnYR6lw%>m@TVt`!1@lC z<&|PqKx(T-IWg`7exu9REtq1$X2T&PwJZa&?eXf{hd(X-$yZDA1vRCp&30LWlp8kQ z^Hpx!{Yfy5N+Ny?8~1O)Kk0u7kin7J5^wI{vG$N|-wSKmAQ>HBxW=k;qsv}By8 z&0ew|iPhUM;sQF*VMYlEz}tx{?IE+_&}r-jtwkurGgCM`s@NzE5EvJQd!2fL<#E?1 z`P_)sILmc{L)}vPV((1jCqpcCU0ri zP&l_N^tc(#C}o5Y5M=&v=`rP*I~D|}AYr>D4u%WJ2^Wl0pk0-tfpNl-vv-;B_VLIv z!j#i@2vW*c9%rkLIZ)qvDR-b79zhPLI!g(ZL7=>9(K}bvcq{wGg!Idxr9iTB7m$wy zi=JlcC54=itr8{eW~b!xgtP>t@vzp;&3)PHy==SBRC?xcvXuudID==N8-%DqxBdkm zowzeQQ!W)(I#dC_*ZsIDATv`o*=zA0O3<&FhG6?jrD)2Wb+~3$^F=%DZdpQVt7hYU zrUb{|`T*%}Z=YUvA~MxNi?6p>*r?sNj1s^I6VsRABGVjfTW9rV>RP-BWL__)>y%87-56>^yNG|7sC56bm8h1R&(BG2lJIF+=MEL>G)cO4X2 z0GY3WYcFc_$jTtjbYZJxk!*j^Me8kNt2G722`_D7KUumTz&km*UDsMhPJb+~)10wa z#Cw`f-yuy=Q5HJH)QQu_7@a4QkjDQ|SOMPEJ#d%5qfAYL?|SJGB2WkeLy7o z7G616Rj6SS95Do|$3JbN&(I+*V9Um^be))}hG4S%TM+zhyQz>o!5C!&gtp<(<1GxUkUosT z{Ycobj+n;hNVHwulQbk|x(u6GCdEc+A|JCwWGqPDGjwg{n2s{RmA)Uu2u`q069Sv( z>*YaK_$iF*X^k&yh(aS;jj9LZm*jvPokIP`avOt~g&K{+>Li0{WB5eZG;7w$t6a_xo#$L6h3-rF)SbQkP+;v z-4En~cvP9RnzhCG} zBK76iybUjj{QW0=VbkTKpK)^M0_bUQmiU!K?N@|;jetp5{P5s%kE>Vr^~-Q_bFT*P z2QoG>dwza-St6_QaO*F4Z23ru+~UCDU9=DJP=&5^66i(LI2_4?V@k|*-ic!5O*t1} zmJ&s~IU%z2gV&TwED<2oU zN7uWXNUx(lWal?8nIGN=N4`aTD;&VJ;uy79dp`@L?Zp5KYesip_FKzsn>*S^mOU1s zSb@dIXRU-~#ewMy)|yzQZem~R~>7m|y_5W&GW-U79453v~ z7mm5T=$7{#d^bq|65_1$+=xDgo_1eeut%##`)nC#dVrH`K}qx$(8+jQzb;|-P%rCo z%84p_ zXddIpop~;$1+C5=`88WIYa{468dC#2Rmqy)glZp$k2p0wv~9s+x0| z3kaBCj~=wc=CSSEhyP>F#%j!ml31aKPR|>U7r(Il%ZK8O`42u+EK^L# zt=Ol{fa|Y9^@RkJ4QjfS4F^yNpHJLGKy42t=*x0RwwB8}_jtqB_3w0ooz!4zS{QT_ zO`Dz;7=%6m>&XCb%~`2ct5&@^)7DCX5AX1-KXvdoidhzLP!Uf!s&ITbTVx993N;Uw zh)XbhOsDR5n@!-|9lP6z7HO|fq}3dIX2=nOaDyT={piU=eq=0w(@yk@d8f?~M4S^W zc3*^vu>K@_Mr7HH@iTxW8D?m!{mMSo->{ZLJ= z-yipWRwaVWaPii|Oc$+5<0&vVjo0V7FksCzjNyX7N=NA)&Al1j!HhuweC%#B#3ztg ztV>VVF?|rXPu*TVY7zXvac~wAQ5RAwwPG1ro4hH>BqzmAby(Nv&N6KuVjezm&CaHj z@)$Km=%t$%D8Ep-z9IM}=)ZihQLc@aOKY?rk|Uwz06Qovv=WbLRxR_^(QBskHMtpU z;ux1C>5HE$jhV=i`WhQ?yUJTCK2v4!xm}C<*knmW_)4U%G#ew9*~BVbOjtb9QnY*y z1@$-DD9{L@!8qGfCgf$EUVljyK2N?`JAau_5d55)k#wS&29J$WD$4a@>!YoTXnapl z-0lm4o2#se1Fo`uX&`xF*HLIyFBpf>p$+%WMKX?-Nrzf>FLNwD#$1PnApt^h38x}b zr=~cP#$tu`%Lf~1^{G}K?StBGXUBu`%_?QW#_h+{&yzGtDi!)#EnZxC8*&2oYH408hdaRn6vvS1qD~c^w0DL5_Uc_2fsLOE`4bo)n z;%&ans*`6ntP#-8x{_+4S=3mnSTs^fSI^_npwKL8(rq7X0lMv&FwgYZX^6ItK4XA7 zI7xd&wtH}`AfOEx_$Cp~5@Mhztc0;5xcAj$6#m&d&Sr{aYUwWcp})-<CIZQ zWeqwm&5>QLk#@YSJ+POiBYO)O($r&%co_ZOgK}ea5&n0dd&9S!ScP`dPqH0^~ zqUQv*@bhclYGlZ_mKSPq*g0HlmY1RS(rPyxedTX=&Oyal<FG~W}@k+T30=O7vx5J`im6l7AluHG=(-(W_8q_2q8F-3;SS%s`_}6pkz9t z85Odr#w&?@#^9B+`6pJ2Dh?67RsJsR&LhX5?Q@^m_#PWuS0ZHndd( z{(SfEu89Rz22??Ik%?AMXgVsVnu}lBFC}jj+MgTZ+NULc>>g7msEbxXZ-q5`mCZ7A z_)uupezr{9lbss;yO!-3flDCPJd0tC|F>8(-r8ZM$yg4A?EHyUe@Y_FoN54XL0QIm;28rHquiVmeba~B9%4N z?U+73ZOKS7CNiE7?lH5=d1NOmF>K}OVz@HjY|%n;U?U@#cvLa(1<{jr(39u8zgXcn zV?Pug&%I=2?`H(+ln}*n9@N9x5+W$%BbF{Sa$J9;N&WXjv>o#a*sPV zvAB7hj|pieN6)}r3gh_1Nx<(M47XWVuieD}$lxeU2!?xAjt9f>PaV8kRnmGTMnh=^ zMZj+-NwVAJuxUEAx=HO8<4XS9xNF!)W8x0ti)v!`=L9A(Dvtf$$w# z6FF%q{ervGy^pbUnEU@_1Qn*qOU+1SY?>;_E|5z#Tt&vEhjFzZVs9XDD@~GI+93Lz zs5r(?7Z8_hN`B(lb?IcbS6(z;gnvS@LAzghbAa3Q=jjgT!B#(#p)p2R@ z8!ssN2huW@OgYi5uwe|o`DfngHS(J_m)I8(0kOFRQ5SD{v3^q0+{XQ0>woU|vYATq z^wxj8SLTXx@AH{kBkn%Wc;&6+zimty|4D)Yw`#df`2}2Sl1;q=iu<1g$+>EGH5Q2g zm+QOhI?rBJRn^QHbNlH0RR{x5J}Zzu6vtSEpVnN_|{>!p_`ON zB%4$B@m@DDVSdQ31ax-cd_e!$1b>yX|1U(?2EKHFRm8Sg0JI%}X1864Z@mS+dNtsD z+#JUNBUlIS%$u+m18r4;B$vS@^g&ljRp17WNZ(1d*t}^|SwR^3wicsMB*W!*QqPZ? zDtq2m*GykfE-rtQAM>;WrnV9%Nf>;}b<3T}vvJSW1ww)ePx=BgG_w38dPo=3-^qo^ zKpX6R^}(tZ*s&{@@*JCO92;u)F%GQ?)OT0t_Zn^@+Jld1paWAIh|;;R4QJEL*9`a% zL%$}<(`PXyUdrt@-+VhRH`J%ERedE*4A}w@feHcHCSD(TDJZ8EDS%b);k#PLFeO^u z%?9n;@#1igPtpT;dtc-e0^<#aM>f~GEGMuAKDu-R>RhbP)yi~a9|jU;HOV=JwIXAt zObJ3=8W%H2JBwC@ze5LwkFgp>Qwj$h&}23o`LR_lpHWZr`xD&7Z$O5Nc9%DrQD}a0 zQShSXa&g`IrrdR+y*m2v>f>mUyIwzA6Gcm0KV9QCkA7V`Dr%H^DX$~D+v^)@m!`b( z5J4z-Y|Bq#7@^mvOw#kR{AD@k#)w&l9Q!qBnnsz{ z68@!yx=&J;m$}U_Gcb(dd--?ZSDA_q$2jgwv})b{Aju7%%B6RsmLM)L)sB=2-JisL ztseIwu90Db%<@1zoLWg7t$+4XIbBjr)!l)T$9x2RzeV`z`ykxwZ=)^a?I2V+ zKd!q+ZwkF^M30eZ=0Ak}ebc8ggNTGHIZ$*KA7j{Wf0!$bGvtCYKf=iAF{LXb_t<{o z%5As%VX5VFF?Twr2jw&}(PAKKH0Gl>era^-ZBfer6z>qwK0*&t&ugaHl-1sJQ2hQM za9>s87P}Ly@^rzj8LbxU`#Z<+oB8T^YsDtO3HKl_JvXN;6w`O`l^5ULw%`vLv(O26 z3LVKQaUJa_`zN55YoHzFc;IT(1!ZAsRbKdQw%jlJg^J2|w3;`W5vh)gM}HT&sVwvX zQH|RPCjx@zR3}lDlidv9#T>l8*BY){Bv>m(O73j8?;5i(@P)uK;w_cO{LNb$RM6y5 z>Rn&;@ZlOes~@DarjSzBeYV#{SJv+oik=!g4Q07CpC7Kd^!xSA<*R-P9SXl<3AURH zPt#sl+sYch_BO_58KrHD>1eC@*W#Kw^((&V{02>g9nyjxBms7yJ& z9H`?>RU2C!-=VZo)U*rf(K00imO3!x`gfmln9;Pwsmnh>;zH>UoiX%R+m;h2O2PwGQqB$Sh`yMB`RD%Ahas+2iALKqCNW>eZ*Q+{s0Evc zL|8NA6hOlNR0GoqHXY@Mi*Y)0@N5*VEpNZ$w_Zyi@5a*2+Y+rh&@cV>3Y{%caBoM3 zkYyHwpMlWDwVIsM$PwiqkQ!(D&~BGJ!lpS zHypVjwORB0(I?o7-Ti?9WbgfHP5mI4{oQ<8Q?ZQRkuZ1ycT`WTDO<%MD0p8JqeF}( zX8R}DmdPXl%Wpq3dy@!wfi&37;fX;4(L|@ zhf5@hmpI4dhz}W!CUo=jx9^_A=y87yqi1(v$QaA`UymT4{;%WnV-i9x@gfqnBfy`W zhkxouBytY!_SzHq=GJIG-J-l8RDx}jTd~_{e^Ep2KoLTkgP&#`dT5x_seF6&GQ(5u zt3x=~YQF!GY<%{wdow;Q!Rz*!)oT&M+Z!zlMH8m=T-vc`0tlBzc+>%lC`s~i5 z6{xwg`6ar{=0cOxzx1b-Z^4peFJs*FFZ|(*sbaGi2?R`=?O6X-b1w6oxeG<*!`(*N zWP|d^WdAuBZ!kQFT90|!;5UQ>Q=`-8K!Q6x zDSY&hwGuO+T}0S_O{16dNchBZ@GNAO9n~lrlyK_{9v-Z9GZ^kzM87D-QlXeI!{SK@ z{p}rrfg2qHlm^+!(9XEyfIMTO@{H#xWKr3mp?7nJ?j};HPHwKD@1`f*-)g$VPqL?! zu92H_^83}M(B9fXub|sm>+U=XjE!dU*efPwPFB)#gat8O9Wt02VPb?uGQr(M zG(uA^!y%Pi;W?9F2>y85|9JLLU}>_*e_1f)k2Kfh!~T|`bQi@WT%L1xH#w&2=VD{| zZ7i}SZE`FW^Pl~Fm}$iFkGoHshJ|^Zj!pE6V-Y#_5=kz%ec!VSL93vLQm$?=nDAw= zK@pB1yd)t)vNOmjatJfg@STiB7g&h4XZMrBJIM&j??z1?lw+?LPJoLw_AaCx-{!9Y z(erUP{dhTx*~t9a>{+;o5wmAJXzXdun6uXFPRvBeH{x@Yn&)pKl}uQTY19`&Y~dJX z!Qh0?K0cp+D{3<$zVz}wEFnlJ^bAOcdmk0i_?nk1y^t*;`Lk zT*Bu4M8*BF2zvlbvdL`z#ZO-DuK`j0aJMJAu4PM*E2{GrWu&t3$`g;I_F~S;7I#k} zt8pBkRbm%*lk=LHfCMQXI)5U$|9T>ww56T3c3ufF)t+IHyt^!ykihl@MS3h#Cn$}V zefaR9{z!wA6`Wf~I|r@BlaC}1uOk(U8h38JBqF@$^ z+!*>FfhPX7vE7K))yN0a;* zSPuA>uNZv|{JIGU{Prq*Li+0sEOG9xR8Gq5Ap@q3oIh%}u8=S$Da^mt5}*D=S67qN zyq9zmgV)c48q6~0wSQ&FCtkZ~;~vbA7p3BAc`-M|^zH4vByoricyqF#f#daV!4h95 zNn3ntmSL;qqD6lb(f=7`?K8bX;_pRcf;v;_q&n-)I*ok@M3^8wg;KCZB%o~HR&fxq znUw^Rid?`Rcjl?zLPv+9Xxgd!KyJP^8r>*d5O4wAi8FEDQKYf!$dMx}P{WsWrr(O> zup&?o*M&Y9uMv6Q8Jc`FZ`PX-*{nsm@Qhz=>j(x+6b9q&u7-E(NUH=A`go&%!hk~C zx(4QWHbN99kzHQFN4L)Yd5L$tY)x(}%GSD-YP_6bWi~A38%1>G&aKt^_W`jaIAg4psF{ra&MG3*Q@|a z?GDO{{8Oz_-*;*DQmdQ}|7(_hKRyFzva}BcRc^v~)2846%chiF#O6k!?(ST#g z6P~p46O7Cl6(uH2Lse zou!l{5&)}Qfn?z=IoAPy@6A8I&!8e&B{DkFpBsTHmQ}{e*;DQLQIFUgpY>xOTUIwp zH$cg!_^WcWhAfLDGMf#&U(stp?d!!dd}`==3HyiFK2n7PhY zEml$K=9i?^XR8{kKP9c0;dZB11sU^b9<#Hc8|nffry{VC5lC%BmZ+bvM_-DzDwHMTnG)l-%LMYBnnRI^ zH&!Bfh`%&JXABN&jdewtbD%Q+Dm&nwUV-jA`hSsHSVd8O;qAF=x-_2~aJVl806H3c zoS#^oL2FtZuP2kNmdqN-^V$4B%Zw`yLK6W=gx!=IV-rw&_+GR(XYj|Zt;5ax_kPX< z#62If@AJgtRIO_o`#mm$oLO~#`p$3cXObGR$idT40NVgubWLTgv}-8Xpre3W=>W!Y zyEAn}S0vaDnl&67si75m_YDbMVy|q}F*N8XrVN0+RTPmD+pj^Tzgu-UnG$D==D+s& zRQg-h^*M_fG!{~*Y&{Vo@#`IElBDc3 zWOP$o)nsgYYb%*}=g+_Mo{9FflVfwWH;pA7QL+COP)5%9%Tjj(zW&J38EPEX(|f3m=`Qu%)jAEt0$o0>oDb83BA*XUJTKIOSWG z*;{a5&FxJP_rL?1p%45n6~q1AT(pAnxY>>0e*uPzb7SIvR1(G4Q&U+$GJY5SFcB*h z>0aosq@V&$@{ldZA8VH>W;vybYl_ISoCf=DG%iWLn0zVPx$Fm6c8uY~ccBeZsr~ZRIYTUlHNILhR@fSMIZ;wq z0I<9dzyki=X9!sH(jIFH?I=hq2CP|<|HV@OABhq+!8lXNTEp|W<#Aq4yjJa}Cu>hI#Vt42XvOAy_qYI0jje_!ozw%BM;s9?@_tp0KiOe#}*>5*@69i@C_R|O*6NSvxXYL;p{Jio}Y}E#f z*D=e?(b1&fcdm1e&6oVG6u^AxgD8MqMceuOI{|HaXP{E;n3uF)4=bHfJ(h5(PC9`U z8pJn(P$RJY0b++jC`1;mDFDD>vymi@_748PNDRgokaIdriUVuJ2yVI#=7r&@(p#lu zfe}&h=Vo%BIo*cUhL!0zamfEzcKLKH`}39W?1+3f5_2U=y?~&D*ffcyL+9f7dELO} z=S5^KE}vGt)E$luzdFD0J~sRxnqW1ygUloI0&;pMs>9&YHrPcBbO8a_d2<|>w5-B_ zHmluA{qxZ+^rud+V?$+xA^_KoJE2UjYLtTS35}krG= zTCSzBe|w&<1$sdJlr(xk8ayC@hldtSVm{hC0+{(*l^Tu@;3$;Y{MqV{4*Kst`43B5 zY6E=j#Kwy2~0o@Av;U0 z`?5;%*x{!2j|sA6BfwOx?u6JQ7-Y{rSRn_okF(aiOB#qDP`Es42a{|+@+*+a#qaAa z7}i^R>QPyQnt$*H?y`Q$o*(Y=GZ;3a0pF^A@!Atb4t`B%TbOX^j-D^qN)Q4hp=UC9 z<}_Lkx7=gio!f8vY|jfxFKW)7o$l|w&d_X|t+=Ie=(n%KjohqZy9ib0zJcJ{_aGl7 ztX+2!x$qlP-0l~?Iv}^)txR_8BD`K65hFI+jT0ui9kwODrqIsR&p%rIqHMRm0R);j zSJH0U|4JyYwXw$rnoKC5h(oc)^AO6f&_Yh^ozp!I;e-wO%Oq~Kga@k{-dnRG9}lCVugW=B{a;G*@3~oKlA6n_`xG)&aTba-%%xS zkCl>XzUy;A1jcLCVFjGl-zo!7flF5THhAA(u5SnQDi^Z;)BWzkXwi2)S*yTq0iSIh zJvGqCP3j?l$?71O%KnbS0?)H;Ov+~&qLmQo@@HFqe)>O6w*LC!e?2Pc|4Ou8BOAV2 zt$uafas1@N$HX(J_}+wR^HjS**{5kfwa*}y66utcTsIPXF!EELx1WmHNP1Y`m|f{- z21&DLtPkjB@h-m;73+bS!ZgA2&g z*{j`Q`$3<4s@s(JRm!y&C6`{5dR0VUTMYK-cb8`qpSJxE)7A=^(aPLqxoD=2zzT~` zxqc0;OI1o+IycwOJT3OYIvthnmew-=Dz_zMW$pi-@->YP=fDsb)i&o2M9tNdbSx&8VG z3QajMMOQ?tPfWFol5JNq`5$(-Wyy^YuZ_09W3&KmlmdR!#x}E|5FyLg_l~LqCu`)x zLw}_dd1vF6H~F%p_7D5sGq4GsidrGbXeE%{~!8I1=SK@ktqH)+Qf4r&SI6{P z2}Q6?TqiACUTYc^c{{+6VZ)C(rVZWn8-DF^K{KSJ@Qz-=JbVC-)pwF(E z7peIL*y7_09KxJ*Eawi=x@A}pFRV6%r|?@eNLdt&38vW0b{~-Qjam>C4C_p>Bk)_a z6^Br)6g~fRIC)60-k;p9a#%C~*Gc5dDCWMd|e*9wf8pY)wjVp)7 z@VvXOk5+0DoI5@|Y>epKxyzVnipjm*y1i~DwyQ2*N6X%{&no4RIAdn>iRxhaj=?Co zYtzJupotONS~gL;XXcV5t<||DL%)Noqg{@{Y0r0km1&E7ynWxjv}2v@&n<;4{Or2e z_nT{VhhgTH-j*cu=gZt#tSP$TIM6n?t3-0-?Gc?+DM0$`j}rm8(U+e-cD?#_Uh?&s z3_n1T^t{RX$yxe&ET9AXw{YYi_SH^iXnow336kqDCkXA}RkBi&nYdN?S5J0X%5A|L zl2mhYa22lv-X9^qH?F_l<15r(>*aX9TY@imLM~WBX2WI{zdpyCHw(@WB#;k+oca}8kTR=ZHi(%8?zA^QwP8lq{peYWPyW#!m6;L|;w^{TJpnR32vj%xZu z%PX@>!%voH{w@gg>uf6oUq_!?WhbHyS%L6bV#-L_DD0i?Zd5QkM=0spMfX|KbL@$t~Af zEyPK1!T_|1a+g*CwsXBAb1K=Sk!6WAYn&Btb;Y>-n~VMM!!rNda|ufhp|T+>LaoXB zRTFe`xa^qtcst32;M?OZx*#LPl*lK9EV_SeOwYhF@wq2jjbh=WkghSCSUxHS(}?pL z(yEb3-?#x~3w|4|wJqa3cvBU$Yq^FVNYYk_eK(N6-P-GU<3FrnsGqE_5D;9lW>Uf$ zrvC6j4z1xCa9Be1WK{p%u8qG8m)}1AQ}OJVQ*{SW!Y#`EHGe3l zqX(LOnScH1-=F@@{2`(cfNvYdc760k1AOjD7v!67c4a?*$xC)6ozxYWk~>3 zpZ>n{&riS3p+AqLKSTq6jfq<{tYdMk#Wn;MTE7pR$1RLP$o{KBMwbg6*wR1m{P&lB z^*`sYk9Qzy@;^iIM_>KVQ2hUXRSYLx+WHd<@Y_=SwJiQWutER}{UgXFR-g_j`yX5H z`F({G!nyQ6X7v9pTBP^5F)kp{SD)s0!T&(yi1kCs4`kt>AF`ToX1Fu0Uu5%A`${=zO^aJMOcTflu&C07)s{iOE=0mQ^$*HbX1oIZb)LvA6@I3CFPHpiig&51DJGe!|bsJuE&4T1X<;ii#G~BL63KkcdnEnKEqbw=HG7o`l zgbE;eJF7PhP^aAoq2%p!x8}IC(&IqrP8w>sG1c$`XyWSE18bd0rV-wc`DVvDK=ygB zC;EMI{Z1`kfMjz{L1`R9Cme+lx}dkd8-^6*HDe(^QOsZoUN*}1L|V#mQdj{orXR6E zktG9x{yqeOhJ@n<;DX8=&*(1?EQeHNB=A;&$okIriE$(6^7z>^XZG)0g+%l5Yah2{ z-5y%2(|ikno=c#6)pLJbK~`4{G~cW1`CrI;MGTOGJdYtaD24TC{1E6W1-dMkQ^XPK5D^Uz z90m6@#mH_P@~GFLENb$POe%`+Yi3xO-v?Nq2a-j7+nIsLL?Ej385nhkL2m-ejRhc~ z{U`6*PqJ|tOf*hMdarIV7 zWsmE0uFiojf_nK*->gORB?chRbwfvzH0zHXVVHpjP=wvIVFC$a-u4mAfPC^xn~~+M zdMvu8LN-9deG(iLc3m-c#yKYT=;6Df*Dbb=upSlNE<~OZ5OvX#B2wy;o@_{A$?SrhTOD98hd@*bP?w+9ryS2=<<`81^2&ckxA>;Pr^*IO{AoVYKs z30QI*#RR0a`H*yv=?vuTbkZ$$$4iewSg11hc4s~kRMEDf9RauZVFCg8-gQu34zy$x zt^p%E3a^o2zKZmBs!=hL87G~}cGGN7>2Pdu~Lm<@!s>oHS zL#|I&@GR(3$u=k2ZW@{IN=ixsfv0?o@ZOm(1t-^L{rGm6^>J*4D?Xs0Aw2HdzNXLN z=2j23VyNn|Z^%|u2P51p@0bEI&dmS=5t6$3aOl%$wnUb;1N6Yh(;uU3noI!!+5>lT zr%HFpZI9jXh~bA%^G@ z)yWN@>|-DsN?sP#6S(6%6d8CrxYN?s%N_?K^HM{ z6GfsWiRJzXxg|bu1I~+q;{}vSIk?+*-uwaySj?~F2VlSth(v>ep{ZLtC}N$c0!Bw4 zjQ)Ga$2eg_!j*AX>#*8o&g_>2U8DSNKGzrVk|N~6pk)l4viIt0Fj(K;U# z#OIz5F|ms~+&+aF-Ss}>Y*^_10bt0PBD?T#? z-BZVx#e5?9SUkSRsDGDrFYHGXn(t^iLM$OYiVNMI`XEcfX$Rt@2YegGdte^C0!&>K zr?QweS<-QV!tfk+!F46D%aOr2Vxfz6x97bBoSXnMxxC~-CB2?Pddryz56-s|oMRNs z8#yU=Z@R!qS0^KCyl;1&n$lv}#HN($&elA;35)a&$AJ^okI$X|R#jmi)|xjU(7hCD z4cU7`G51{NM^#YJ%ogh4K$+78Wp?tYq2vrR-kz!uPL%2JgyO5%wqfbWQ+4R*nulT& zix?H<9j5ii(z;PK#C2EYJmPxPlvVI1YVOfEdxPp%hcF4cdD)iDAo?>L?c6jEr8bth z^gX}ymOWiy{v-+D_dL(G*e#31Zn8`I#djT)`cxl-RF_{njweBt)xFIeit%6Yh1&T~ z#pl)2KX>=6gZk|FFc+;dm4@~#Oxzz((utMA2A*1I3zj%%JEG`NiHD7 z48xkU!D=*MWDylZCrmarRN^qI*rejC;xAQm_~~WBryo2VTY5 zM9Mb!4KX$_EtXO}AP44XCPAu70V>;l1=LI@$GLz)O-2ohlvCQCAA;z!K}BwLf*Ay= zyE^#CY~NypV`6-C)~Od|Qcml~_vy0?abi>#@uq6~GnS7CVpJvZ4%u&-{kKZ?X(KUp zH>qbd*Wl3G5#3`DvL~-r_(#%|3fy*H3=0R^XO9E;L-@Ve%Wue2bO*n5-f?#;M%{G8 zWcYf#0p7-yc@((nBDW$!p=PKAM)fG}s4YnLqyud%2dea}s1$<~RJLBdYW-R6%uZm( z5G3M(4*QxJSnv9wdd#s&rWm}#x$qnQ2jo`f4sBKy7PlMMM#YQ>W{sNJNfe1(o(Kj* zOtb-ODL+Wnl+M)QeEdVAm*h$jfR*~mI;IOaKat!GR>{nTe$9p;Zr!uaSng@Osge}W zB^?6SL)f>iyLsh!*yt_aOMcSKQ8UL5cELFSob~jkO{y*05Q1batKsiTuD{(jT%aJa z^uepJh^4U1T6`sH%?$YH52c6ofr>_XKXnygc7YI#}bg9&LKch_PiDP zwi)&6MaVC2KZ1eUwRq?KIGhFZ163$xOZ{@Y&h2LmyO=}rp=>HBx*eD7PcHsoT_sYc z=7+n8b+>}mB|Fkn1$Ba`g)DX9hKzvG+scJydYHgHtOq=?Z zXxs~CSzsQu5zevh!i+4dc;Cj2c;WqAcXX3SIY|S`Pq7ffq}hQK;?DAwtjlS zLYWm$5yGNYiv8|x`MSEp7po8M?Cm@E*clmNu+_eK1KTE5K(95r**7rC3@y6rj>9iF zgQae6D5MHMh~a&pY2tbx80thXJlbftd<=7=?73_96=gam#--0oIXsr(MC&Y!FQnQiIxXZ^Pn?3)K*c0Atr;=8&ar!T_N?yP&pk9@pCr=dNkKJ+0@u@o12 zW`W&}O1*2qS4^{DYwsh!ciIzN_&SehR%Lj}ym?$)HCE}&NMoc2mY^DW{<(x!cCqb5 zt0~FR_OM^CVX<^K(F$iXRMW;H6cf0qGMvtSBdfSWL)V=J8L|F|Rn>Tt>$xx$=%|h# z#&l)ci6p3eCW z@k0~_0iT)U&C9OXnhEbk*%5WoA?Bt0%;)Cf_v1=r(>1L+rQsQfm(~9P&%wHv49MVODvhi7Rtz zm`C+r7!Cqw*ts`-RMU(YQ`wpBDUSA`y&JSjX!=ulSN%o8G(;9U+w+v$x0)-uQ1-l< z+16S_pkFdo)w&qStMkT`;VIn1$OwTaGMWmw;IKl?#GA&DLc;uaw5WW^$sHRtYPiK6hP~6I{I6hz1`MAcNw#v4ETo zNl}~iHJ@wabGC|p>}BVpwiPNW13k!({TBskvF_eRwq>KkG0EbWSW=B<5iO0y83Qcxq9eGLz0k1*EepBAR+T>q3vnY zVPbD%$=i5S()285nUitnEm~LZvDyu(dC?OM%x;y{FuBL;TsLojQMuwWA^-B~L4Mps zg5~3}PP;;uCcMEIpf9ksqg^T0o}G9S5_=%jMGB(_*DN+nO@Y z9dzxa)=3+Q9)GEoF_vgzAv(Y^&XE>x`Ls%-89yIGbDC0@%S6wmwcx)C%;FW*(+z0!#ctdqN)pH_`I*Wid66sw;FMo0xCFU50G7n+&* zF!Wq+HN#pO@;fq1yi&|N3Nn^T<(ehzz9?yBT=5U!)@lmM{`^YbTuU=nDRL$4h-P}7 zYMid&IUn|<(7cfw5dvs%f(yx4&z{@T2E zy`$Z(HS<|v{#*gv?S)-Bq;j5Y!^W^md85A2yNBP{RHlS@yGUYfh$Dvbe1?5ZLd(uY zz^&cSr`SSab@}O;t0l9JR;zFO$L)p!^C`2y1|H9Gz0|~1!@^Lhms&xlub-p_FefeSZk}%qd9^$mgsTo-qs|>=vK@E+uMne7P)S6nyIQ?b57?|ApzS*3#4Ep zryXKv>lYfPv3iTg!YbzSy7H98$fu%KwMku7-X0z|HIohc{K&@rG{~g+{h*FO<$1Xl z=$jEendvQD*vfjI>Xlsnkl$Z?%+oo`+@UbDO5B%av{+wG@8o;A&=`F==JyVqBCEX$ zPCIaJHkH}lt6%yL2{jVfGxH|c-x!+|&0BEwgpO--K7A181bKY`HPaUY8`AO&uF_ zz;QTw#%b`tQxD$4AW`dlhCqXLJ%w}Lb_X-x5CUEAWVTZIOJm}wYb>)kU97stRWoem zIMm~9r2AvSNhF!NhxIp>j$U$&9%7lB#JWbm(cL}HxsYYhJQqugQ__Pc*H=<7;)tx-T;M3e5Bh!6MbeIr)tq29i3Fv^icmUP;+{w@Hx5oOahA zT`FcSOk%KQ);*BTw^id{w&B$Y9q}WU-OH!p%n|2^F%cbh5zk)qs<7^mF%UmGKFTh7 zP*m-$V}S2+nep@XF<_NjgRS2F1Dtogv9E#uIKcE$=mK@Nw4iY#foV6 zuj`zkAtltYv@DYv3e>jaweV4{z6oJGzzcRivkt7hH_{##X+UT(wMTn8M-(ZehH(|;pV_5vSvn$s}v;I?Bp1JiM zFOB;ykerAHdQ8MSrL6c7*1L+Lf|#aE{Outn-agx2ULlv2kKR;bS=%>y1O`*iSW#KM zod_RG;JAh}ebw8<-qb<}+$DKmNT(oQayB$3HuHM;L_kNrE2B5VduZR;Y3B)D8uj5) z`)pNbuME3x1+5O+SJO2M3A!84+dgq(mAv7E5WDA1!4OOxm*7Rhp@$H8YtNPbH|XFU z27lggf>GQFg2g5JxULR|(H5qf>v39T2B!UoWwrWo%=hU=$2b(nTQjP?yo#c%R2aVC zRB(M9N<&3A6vc6$X{mf1K1NdCpkbQBC^W`7JcxEvW#+KVm;7{g^LQ_pIBxm<@Rbmp zP|j_m(6Oy^g^6z+cSKS9w3W&SjdN_{YPftfQY!1Fhr{Z`to~&p?zmDgjs;7Hv*Nuh zHtSobz&uL%zLZz-q-|Wa)1A02>fz&7cJb0_3GBmTHq8NHm=?9GIf8aJ(zYq3ba{ce z-8Me<30pM%ZQVxYce>|@r<3@r{csiESVQxZz{;0Z1po>{)l^HU)@Pv zsjWzO#Gdsel)sXk#hzFurbexH`1K&W>}~HPp&0hfc*5DuL&0-pMTVwXff%Oa8%S?P zFv7Kq(MKtJPWSqq?l#Bi zdN1TO(&;(PO@IY_J!z2YfcL@K&gZZ!Fe-d}-YlY=rUzK^6r+ zu_XU^z3Qq}s^V*9ANMbNd`2bB-M0cjpI6#R9&yJbkfPKh+s%Q9Hpqku-q~LEOybC_ z**m{mx#c7)E^hg1UKpkN7eB(O+x4GIH>A)ksD#JFzGdEq*W_=ReKRqGH6A1VTaJi#tOw75_E2=ADi0dWx zCf-+(L5aIe+s=%9h`&L`fXZFZ)wu!7$uW&hz@0_$E2u*9S}e`Hzc??}Hr=r&u7><_ zh{AH`$$P3C!|XNdKHpFHtP+q)!vs+sAt6z$nPEnBpT zQrZZ_FXi6B&S$ct`ZuTFp|E=EC{R1`vc>kB&BVQ@@5sDbQE{$+oz^nL#D$%}YJ0j? z5B6g^o7We5lE%uXwj5&pdp9;AjW=8}D)QTvL@{~LdRyD}5ut0u(1@YO0_|QmL^n|v zJ}i~={0noCC2-%eMg2s>odPYJ3an`}ar?&iTB8d-tGv2Yi9Q^;_aXu}Fq)%zyWs1? zcw~3D@te6*+7?=iM9Hp&iA3oFk*jDinm0F$HLP|Ui9MMl}gQMPdEFkFOU$py2-h{AJUe52&$n5qsr zsaQqg?&&LIA}(rRCzdZ(|K*XgDlh#m%A{%53s+IUY>De?ST0hQc-0#%s1nfo(oS-= zz5z!mSi4QO9*6s=PbcJ=yhP{5m?q<{kz1&6WqO1h+JhHNwIHO!Yzn%i@x?qbfpF>; zc7Le-=PewQ!{HI9I`x&Y2~nxokFhlh%15~q8?!%obtFyi!f@B{PDF{R1kCKJT4fTV zdK*>K7-cPIUC+Zcsl4NeA+~2w8W%-4Im+cGAZ`PDU({}Sud%`5-6olpoMC?@~j1;zL4C++cfcN za$6i6#wIIFOBZ{OZ+Q?RENSgLD4@a2y;}#!(;|AcuW&^uxxF|P@=zy5UU?#(bn9Ka>qCP2Wf*R6%-X4p9-=5Cu-n`qvMr;Zb7n(cNtk56mnCnZs8!yXqlXIn25Oe;LMML~Jq zgswwhSucO7>-5Ms_FJ!ea2`UIt>fJGbKNw4Gs+YpF>Ewqj8rc59kU-DCR^IEhU0ei zg4{>2nSo)4-=uBm=^IKhi_zjxH!T_df@|7~#YE2Co~uzGSuqJZ?fJf3HDRhK;G~T+ z&PwG>!dM7xW}|b zs2)k1>xo(m!DPOF{B_M^=77!yC=i~LmXIEGMYYj)S(DPPO{TEYU65ZC#`!7>C&UWl)$m`ro0%ny=z2gQu1#Hy zF2OO}n@EZ{+>EV^lR96Z6@&5l_{QxxDuK?zS#lu&H~OsOD%~Wa=|{ zOy@SkLXMFuYLVg_HVW;0Vet@Cd1Nd5t{BZsf5)K|I4{5j4uEx~GW{~=OUvt5A?A&`#I znPG@{Nj^Gr3a`svCwyq*C)ih~@?GabUm7{7*I?8Q#;%oqG+ywiq(Zx>C&a3>AG~B; zBS}J?-=57w=Yvqlr*A*Z@*Lk&`kt3Gt>u}SaWR{@=w@gPRRS{fleB1Cu#{@n^-NqV zo9=2-xob|CxBG-jq|&f24{@nnkM;`F>XlwD(Yc|EIW zCi`(-FCg=$$){?{Y3i@0cn1HdYbn9+PF_lLYF$u*dOaUrkEt+Lk6*6;@^-)2WfcZ} z8=fyShlL?(8cd*X+NRa&KbU|1TIk^GP2H^yvC`NEX-~r~7xB~Q8A{XkulZq;6q9=v zI5h&wXs}qh2%UmfG~WLC&>W|i$<3sdk)qV7t<8DN^lpruczduY$J$S$ znY^rR#WC2us{ubocKo1^)li$~ldI6lY#_TRX)*b6W1=X936@H$?CySyAAy(Yrr3KA z428uBwY+PQoc!v1=`m${l9ZOkCAxLWH5dHUG`62_ir0DXZS6x<*v7PhxbwpNm{|I? zGdZd*W)VEvu#>O6GttE6jN6peE~IX2i0RkmEaw5|Nv1o1C2VLxZ*-fbHstTR?1CjY zChYL5@_gSamdqZ8(Ve~Yz-R+wUQggCQw{jY(bk>E_)8DVby>}V0i$G8!$NMUkYB5oxlTs?QF0JB5wN9z~f?TXtmd&3r%#<$e~S#8iFc$o;ka#b)6~8H7p~}K@ltDA61#` zA}(sEr7RL)1tDUB(A!C0?FGkkYI4yyS8Oxxt?g_LMOH$ny3=$B5TA}?ArsT*C`i+7 z?in6p(fhvG=tLPhb(Ewb1k3E;Zn}1XSY2t$9(a^6c_a&8`DnD)v8U6KKQuh*S!aLq z_6C*DL8p#lg(!Qzj=VZ_a$ht5SkP;yiTrh{X&3j8K)5cf${)$_972@Tw~CeB$KFkL zzL0#@u^^u@b>&LxD+6S3#iGzYOO9NW#nKc(gI8l!Up&o1H(?$x@YbUF3ApEKBsTJ|>Kd6O+*2k7y z?|@?Lkfzihr$wLkP+o@Gv2_9bKkHEZNPfZXw|qo7p&RH)TQ>gJoY2~@*Zz5c^q?ZL zgG*7c{sQ>j2TML60a>YK_;R!>M;#?R5Z&yze>joutN2=)@J~yC^_fr9zj57L0N34f z-bTn9iLUrT^W+~r3`J9N7VygQWQmCX0Ew1@s$DM~*FYG*p0*Zw-@_(%0w(uATBHOW z`E1yNWi20r#)gSeY&X2o5QObRR-Mn&{@(uYUv>xi)}ssG)8~Ib?E&J(pB4?efx6?z zn0)^v6#-d|y^WpxsJ!8Mz>y0dJ^+Xj$k73?TbM-j-S&M1|M=b&G-R7l=ly!x7G$44 zxXoX=mVEyGP2A5z|DVI<7$fYsFB%vn*-@0Wi-1z{R?7>!!OH*hz2UML-n@fxt*L)M z4JOF?!oP-$g8r5v{=03@p#ObT?CMb=PEIs15ieU1$MC$X`&W85J^ML5+mW$?Dhjnc z2b+<$$P`i!QLVj4dY#{0=hc$Hu~lmJR73Loleyv6y|LBn#YlbkcbPZEiOhGCpCp-J z@!v*LM*q~aS$lE>!0)VZ3tO7K;BA=D+e`&pBks(b)9WvCVaB`SgVW6GMe&uU&G9J; z5~0Q*#hC0kkzdZ6KX~_~I6Jvsd4BTU({}R8obfJ)I^UBEPdmT(l@n6!X9n6MrXW74 zDKImqVf%NQ^w)4J!Fm&JbbK&^@|}-htTGoXMNsVx#XXe!nK9j~c&$+!H*a;*H_yl0 zTF-RnbwIkGJ6PByPQXY}GW=nJGe|K+4S!j&pb45&fVyil#LM%DHS_BcYoC-r6koVM z=K(Dm)<SR;?GDMX=?u@qmayH;V?MGdt0@TSjgdGIp9JZjm!B;l+0}^Rd{Js86-IO zWhQ%WWXxYdA`Ob`YJuAECbzxQGcy0$dCmhLu195TX98k29}pPN;xP3M;7EGU}?g;sr~x#MKs*N!kbNtCJ=29G4`U1#i|}%b6xh zrs|42wmc>;a&Ro0?3!t6w|(y|L{xl9({nY?TVy9po(k2*LcQwXLbplTea8%E3wzPpnSe{_ra&Bd(Zi_JpaVF z64pJ97aMJKCAGgM5>E(Tn|xzNoM$`wfh*_p71$qFFttAc41aHWN-D4{&WPPFN89d2 zfJS7lpAr#3%OV6VQODj*RRJ6AlRZVxi}z6e5gYv zyFB+j*2Pq#IkC_Mr8VX?uow`_DEd|v^o6{#LR&C`e=<6sMc%&-Kt&~pQ5cT5gnOu=nj+YE%@Xp$(F_aAQU2TOwy>dBI-?T;{ByQZD zH&}d6{LV>=$st4Mc7PQbKi*#P=_WmT^`4r4zdAy1m54o9Ll|C!?ICl0jR;cTQ{4K; zE|&5M9@Nc2bSDjFhqZVMtu!R$%zK^LhS6K>EFbk(Fl;NfPl*HQZflhcCd4o>85wSW zP7Edw*q)DZTCb^NRl+Q(k9(hql=T6k^NIvttFT-g&bHgqCu?lZG(qKiR&PAW>^E3-R!qVz$rv^dYFv zpNFjC4mh_w!#^HF`#=SpR8?`S5dvs6X}imU&HT~Qbzo1hq^o=0blpr7-jJbt9I*RA zINLy8Eej3>R!fjBIhlZ2>^-bJmdu@y?!IohJ;jyyIDkj1Da^1!%d(wLsLKr2H=x@M z>HoEbUxfLUd3s3%>16u)K~oO5@@OOZGsQ&&hT_vs{pgkFl`nb?=5V6J+;H3CCXTl4 zdU0tvF3veRE<<+WU#H?I;;Qu=NeWJ9ZbDi4c)c)*blXnRU{UkzPboLworTwP#ot02 z27jI)AHAT{B@$bhp;3R>An;uLxj-I03kLD&m$cUm7l*rj*xK6DBy&s8`s{e!_@xXG zW0?#RD=~S;zVSf4@<5xxmLiK=rVQlS`@wN%y@v(IN#tAB$Qb%ZfA2p4X6x125M;KV z2hv#2^D!1)RD+hsE9KfGQ*o1-=5wY`%XS-nQpj!Wr^0TZFZ-` z7MI>`f@UKZcG^{6Vr`ZF`SMIqzsG8~^sOB*44fV?!%xJVFh-&lzUN^A=q~_CUJTAm zQft>PqPuxZVl7mdH;;a@;|tyup!1g#J*E%;YXGI*_`;27H~GCslX~YqFgv9~FDRpN z1{3gKQw<)ByrtUz3?ZVj+HiZ1+&`uWx;zEn>Dan92>|qk{s(_!4;b65vExx|j7l_U7mg(%Mx`&}N)B~S*azD; z;+-*)mHx9?r;)L()G23x<^r<9{jXj{^}9Jq2y|4yVEhvf_uKb=`6d731^tf~^sia| z-@Ty!Sr~t;*Z+s`!0FwX)gBK9GoT_3b!+@u=MVnUfAW6p=MsJh>ox0p8O`6#%s;o2 zRc4Cc7bveT;fGG=;92-EVMrqvLdVj+DVUV>H{y0%0v%nH8itXEewF6 z6xvPweb4252RqA&Y)4}x^rgrNbAs}_&=)5OUgvQ^wae@~4h`T2jb#*&%%{Rm7VQjk zU9}H}S`3}G?dGa*&*#~Kyr`Nsynza{B1SvMg5;#rl@1~<%bV!rGsZF(r+0aMjAC#O*hkU>~W`7TGh;wTAMIN=qP*_W{m86 zUk;dkD@I9t=yNFyajO{LMz=Xdm4L)HpbXwX{Fz3AUiUZ%7Un>80dt`3xeOOWt%Mfm zg-*j=LKggTo|(2|nt0H!^kx+~J|Z1itR`;NnQH7$NPZ=1V*>cUg4HPzz+3aEU>)@obtvhIN=#@ut-~AibKA(e2W1 zJKFLEZ_S%MxW}|BH_LghQEeXT;w;8SFu%^Q=xo!o4i&YjTa3PU>3gh&6SzO?3ybcY z?WN5-9Yv$%&9FM3QP2vbH3m~L14{Q@3#QcUp5ZH4N#@Z^{Yah6Qf4Ih7nYVtQCIILW%*1thIzVtk*(c#o+k>@ZsnmbdK!mE?5{`T-251Jmmm9N`fHiwVYEuJx; z@%H9_@hDV6vo{DybxI)e3A;|YUH%LkM=>rh+twR@J5T2R=A;wVC+qDZbRU(QcSKD! z0c$X1%rlE)b<#`XX!GV{ESAP$z(ZTQ>4$UX%bh&ss_R(*Y^>_+%j`~*(qzilQ4L){ zAsy;3ZkgIGsr-FoV?yr0%|q7o$jr%uJ*OUDkf{k5Zwk>A7%HYnWEX~l+4YjFjUMO4 zeN_Ok=iuOmQ&csr8M+d|PHB>NQhZ}mx9fyscM239TA~hg*cdxEJo`q;l|UWtuo!d* zqk6`N{T`P(wtpNXrbr^Lb9lWaFCV1$8+zyKLt7A;9Z+}V1F{hZcj79PwK0Ms^QmR* zjuoX(cJ=~3`v^9Nf36p5>-aNc%6Dg2j|9zaS*$(BF}FJj7a`ysfqT>cHkQGL70Yfq zJcpG*9{$NN5{9NLO8JvkFtuu{Tj8h-3i@n_hSuGu^+-Qge&d>QrLZO$1Z z{emPS(EnCwbsg+SA8{vqq;Z>bCR{%NT+!z$MU$O=! zu{R{@g)vPf#+###YEY!Th3z&btC93Qw6 zNwKi+Cl+8FriFHyIZVONCooN-A2bUz__s)Ew5atjgouWcZhJm6uKx6%aFZvgE;UCF z@0JUQr~Z&!6SXDydo==gS*G)W81*lMw0yZe&Cytaao|(-8_sMLti-%^6WZv;+{Ja8 zuJmZzgiyhfcUTr^in1pGTfY9OdqUp4X2DqkrGBN+TQ2>)EzuYC*kt&gh(qyVm#DvZ zWWochugY|^IPS^7EH&px=QVgZXUUzDJ0q@1apW`ZRb2bW%8={1Ub zH@VC~Ui4yc71;Jz$f91Ihd`rGRft%e48F`#+zrly;a+i2yFH&q_$8(24hBK9mYRHG z=frYSNU7zr9#!iPul0YosP4jTbAqZAu&m2=;w>svUgw7!>1WdOd`ImK z1xhFD1x#rv^*z&}6!M(wwp|#>nTiuPtK$zxV9go3_~~wkNjR^pYXX+_lJWkz8s!Z* z{Ts-KhUL#lRkt6b>WRzm_J9UvEf1tM>z?oo0(6}LwfB|TuP=2u>!Xf6Jav_dKm#l; zYJ-RRCWdU}>2kh>dP#1krstn`cYz2_^ zB3yUuQ1LSg&3Qwq&LEn0KLKYtC#9@>*yN%yHvLe8tQyzD-51CPMXS}dcf ztzPDuct_)`R~tQt#AtI_eVbEuG!wroFkvM&(>JjknUwoX4Gtu9>G><}w>PCiF0QyD7gC-AB1&|vw0vO zPZNc28W7N}&pd-Io+>q`c_nZrrPL}YU&DaKyB*+-szm=yZp_Oj+O41n(4J#QAf&&j zMV!*WjaR-;hBv~<{*-xTjZE4hl;_eVl{6wdgbFOaDtR?1-xR>(AiOhYLn4=9ZlU-3wlpo z%W(4?ggdyO7-aO)p`L;sPPk;+8GAe%it0%`(FF@3*5oW!I7n2}JRa(39X_JUoVe=q z$L=w|{JQDRsroIZ-kRPARU+}j8s2=VO%|gpg+X%$pn2{>*W*l_Uvh?lG?jh#N@@1i z%O*?{(`T0LxvR?~tE@pm8ec{dbaGbA4hM0Gz?%2w<5GQ*6X2G?ium#mE{m@PY^(uej-P^Hrl1lToG zjV{+wOag6pT*kz^GL<(u>b~mBI4Mo@+LwH`^8vCe_HVwE-eP~x^Zt2|q;QH*QqP&F`~MI47F0S#0uP5v~nC%q}Ms zFEF2ab`sR{of>8Fs_~=6w0yJ89}znNqHqUjB9t*sAYI`|CM}G?oShFy)ckykA`)kt zrtPuHyU`7M0k4Q{Ob+^{uDpYLuyMI)S^H@4gC?dXm9n<8Pua)bSHtZRC9Eaf9XD& zcQ#`*NolNJ#p9=Y1?6tW8*ojI*F`?&sE0k=m@olVA|>Y^s!_xV4yWA8@AVN|SuVu6 zs2+;Dc-^!1_|+dX9O*khz7#aGHp7uSC*fQYfM$3Z426@nlhe;E`yO6jc?zo!Igh^W zh2H`w4P{?G+KAAhB;YhaAFBKxup$4e0(p>6Tq1x-zxIcakdwxQgr!)vCx3!53k-YO zmrb~_srGr<-{DOu3ox@fwy%BRzX#gR?0JL9H z20pWpWVzA4Qy`BQBw0>AZQ`jf;1Id>fp8^?tdnExH8Po@I{5Hoj=}~(_lS~7-rRMh^9TykT5sVT7n3oCvNa10ue5@CGRR>Z|x_L zbTlHfk&~QF8!o6On6*0T7$y%0JIu!9O^time!f78*KGW}BuXuIkS|exY9QT`>@w2+ z&U%{Tsseg5_mj|wnSEEOQR{BOdp#Suh47b`QQW(A#`0-YQ}y!3a?bWtQix zu2=;;&)&|!y7E~yLBo)(E##$AbHHc`z(%-BT+k@3LVwN-lysrbOz`<#O?fJ+Wn~3# zB4W9Yst_Ef)cbQIcfvw*=35XC)V%yg6YflXZ@wkXUW{)3G%fK~{WdaY`i@W<0ch~5 z;Z9k-;wq(1pa%3V-Jsb5uZ%zY+MKH*|KrTHQJ6~TNl&Dt*Xet{goJvU;6cIi`Qtk& ztg70%wJCD1x6|WwQtk)v>TpGlpYa|jb>@FxCGLFZqK;bfc1VH6F%i+ETw;XY4cqRB zwvx-RU-+Ejt4H{RLYQ;|xpYjJh4Cm%rbUxpl~!s6Ahe7~4z}qF5+TFvD_A?_y%r1M zR=XCe>zMK8OP|wh`v(8Q>qWn?ndqpZ!u68|GA25%r+ni}&m+!jd1Tv|HNO^@I1hgJ z#1mqRXXRMDbe^b-o?M!GaqVd1jd+(^G)~{VOfQW*M1w=(ax7!9H7K(s0yCPU1gbs>I51mk? ziHM?r4N!_SX$hf+-Vsod4xuK1bOHo~(94+%-Q~CUch0!qANPLaj&c55ac@?6*Ie_R z?Rg#p{Oz_>n=B-^&Bd9RGHB#Xef*~#IwblpsG>QwG=}`qiUlm>YNt)0-5{v3Kdsiu z{zi7qsR!8cU^}%_Q(R8mmvLM|r_ZeAl2@jrmIu4cE=FNtZ< zDt0K!>X`$`fKjP26#Gi;3jX91abK-#IjgjR8Gp)_T%YC}gTiSGSd7O#q! zr9obyjMV!i4AV$tnKxw@5ymr`n@7k=@5TJ4dsVWMDfko=?4Vyq%% z691yt*V~3S51pi1@}NeikIv0-yC{J@t`cht26akrpd$S;rRts1p60A1zVURu#Fm`@)GGcdFEhBAu(0yFfEg=uFI3#7(D!UYIGq>$)hMjY z>3BwXkx`D@JE?4oS#6eXex3G^M>Z5rf!vubmYf(yj-}oZQ(}9pcQRYy!q-E&F3nv^ zd-^whQXColFtt`Ay!S+20WxBfDEjv`FjEzK9X>axHlv)w9XCcb?Uh^k(Zb0!nN`!pQ{&L!^w$KIJ*|XB&;_nX#FK=8)71kraLXCZP zTE?xeU`edmMXtrVH_#FlI@Gyve71KF&jVBKh@b+|^}D;upsVQj{j&KN^7}$xbJZT%r^%nxP!^r}&1|D(Y>Y|Tfg8AG-5l$KtEcXa2EItHkkio?7>T*` z-sIT}!EyD}kl1iP3H}=MQE|Iin%nFt17J7kta8(96UE6jS&OLSS3Oa>rzvl3MELMG zcyr!6HdU4=+Otr0srHsvYh@j5uK70iEDnj_Q}7$taP+f^0v+gLvfYhN_h1>oJGN7weckoD3D51T#3WR5J8 z!Zlh~WezF+2wcE6w|ARNPpZytF+ zRp9O8qqnOrM~!qfUf%Ro>IuJ~U6bW3=Ge{pXoGOauU9qD zjj0b(TlS1|$ox(|k5M{s{Eg@Fb%E!*t3?EUIZ{O!>P;!69m=+P&V1I_c$zPkj&=z$ zeGcqp2akH?I?W$#y<5r2t|lh^q++)~^*aMG0%l6lSTr8f;VT_GXLWg0vy6R(>VSK+ z8Q04`#vAIKyr{bcFiyL?YpIRPYP2u>14 zrZ5KG1LOU@0%(m&UbjT;blJ%Ju+9}WzP$Xro;B~5-=po*Lu|2Kf|pSbM`N-aSG+`h zokh<-tGK==t{i)HK6mnE?538Pa4P`~dJ>=Yx`k&IWea9za;(d8cP;e@J-Xz^ozkos zr5T zyIvBN0B&w#Jt@v3*2c5`MKS zIH^=k@sd$!1l_6n_3I8?4uI2Qe~0oX2e@agMj7u)F{f>&aU7P6M?rWkp4`c2E0~VL z<;CUef(uwb9+Z&&F&guwYHE*f=j;M6-SwR*t7ZPA|2gVhum7h&$MwZ0MfO*;_hqh6 z85R4`USJq55NB`Sld4B?b&m@&wng#LR~rBAD$)||HzYD zS#+SOAeLtV3gfaN*QHMncz<|;WH|Fk9(Z_H9un7WL*hF5!;Q%F4Z?CON%w^J6ud<} z;CDQ^IhOr-R)uoL8@A~g)0p9s_Tljola%uH#R@m~CQ1MY*u-OhIYy&0;X5Xzv`@x) zHkaXT+9!=7dy1mT18Anb^iU^Di3*veri>cA=rame@Q4B-*1Re9+9vd>kxzL9{<2$A zLZl0;PpUsv&nWPkujbGO=-BOZCQR38SL$e6ms7RSCD|n6e zn7_#*UtmgEP;J!yD!La%Fu7v78SaAiyYl?Kn$)Akl(!v!l;L9KU0L*%<~tjOjkjK( zPc(fmX%V^lq2X;Ej6c=}J{+&uw}?PiHG-0Zs#Krh=@Lo>iMwy$v*|@!u-EPqw=Io7 z_IJ4wKdC^lcyM*2Y~o}bxuMzYU^_-DAJB?9r2KOL$kA`(sE&h*OKEqp4mQunsu*|8nIo6AJ@AA*YgsgU->{xhQdVKQ#d`0TlhgMUcd zS0!5@Cv^b6gVbfN>DBm1mZdbo_B0GifR}|3UaIAg|ISRBV`|XP0142Ce}@!OxuBec zY^dc>7tlUi6UqvS#Stq=ZbNlmcA?bKY|nK_U-o6$CzjSbVuL?H#xsZ4lM!ty%hh)g z_X>LxTa#9kcN2Ux__Fe~Rv zDrQRJ$Ss7iSm&i$Hi7wJHb#naqp*pfG0_9)y@ZaCrQDs~wfq5sci~pdDYpJUr~@xZexaRB5<5D%Jn>ucdRc*P4h8LP3D(kCDD|;M(JrYcNm{0? zrar@#dhs_%Pr};|iVy=@zM=JK9;bheRCyhJ84f6HqoXHYxE#IK5@mv}){LZ+00lci zaUGRT&rBW<>u0`L9UN)(Lfn^CHFbCXbS(Y6OZa-z!6zL=($nQVDdQItm$6@7w2J8) zKzf^Fcb)b5!UuW;;LD`41@d^3MP1Shqq`njMA_MN(GF){>#NqvT%4g5aXVDPbSo*P z^xGTCcCKauda`SZ-3F?CLfJ1QR_fa`AiT(Z;QQvg#-TmDU?rZrZ;2LURYV7STrw5o ztUuG>t2mGwBi*-G+BYld;O?$gD}yzIIg{n1N4%;{E;ts)Gg&BQ`&sz#sSfl@%#4bA zvSn{q|M&vqk$(TR0JDNTInL~ZVxn6({CR?s)WcN&d)9Qh?!35HoL&xzFG}dTO z`FL3Syxo|nFcrZduC91ul_>kM!WpYtrWn9VVG5##c^KVjG!I2OYwC_Amb3eA%Y>q> zvQF93#i~&RB$m?l8O<2V#@jZZ?|0+~$}xU5yO5F#NwXy0rSGHn8_gXS05_|gSv>Tv zxr-0bKtt`*`;e6JVN7al@@P+zMhQurs5mO57wQ({gWX(UPkbn*f@Mk}M{3RXA6m^3 zPjXSXXaT#%RvRFp$t)+fBo;PIatT%@d24@{o74W8VPD$NcNj%Jwinp2CJmke(TYKE zAtwEyQO*;J^UQ+fshPZ+i>8PCS)Wrhi<7oz2NPVIt4#Mytqbu>=4pQPUQEeoYQ-UuiJKCx$VC!$&RQ(2`@z9;SK(aEpLzj{j&QA7r(RVf1B;@n)VTK46-U8){dDG6UQUpQM` zG(Vbi!O9*>Eea6hyC=asiXllZipegqd9=O=)-^Y;j{0Ho?13Qti6F5I0V^sEmpwTqfARaCZ|8_+L9%Fh$Bng4g z9N7XtzTX_!i##7Y+)AAMVattcD~0?E6Wk_;d&T9o6K#Ep2q`?43W-I$|5b#td1E;i z`QLI8l#(;2_3|HoxMr z6izez;8?-$G!*$Tiw@NI=}au^Tk9gvPchnBbe*d+u@sXQZ5yRR*~*%KIgOVH5Kwv@ z^1%OSwHRJbrlwa)y_lbsD51Aty>EAo+KzT{uM?44JZq{;GU?3g1MT7rn0gvmm>mqm zeem5QHj+(GK`4>ML0@fe!OcLu`jrLN8Vq3@Yo3Z>t2{@JSedA}E6Z2L?Dg3uQ3!w!!1aP=UgY$ zT#u4VT(-MOZH|RGx_Aoc?0?NZ}FLs|E4Z!H8 z!hKf?=1mn&Hz>-s<`2h)SU;{{cLyCM)4^~z*G!t!_flFHOp1}?ZU{&(Pd6@eRpBUh zK|0Q3Byy_3WrUvCclYUvOp7jTb%;ck;_;kMpyYcG7+x+5xZGP94AjC-R+8{B=Or7AWQ(y(uoy-FmdHihBRWM661&#YO&_ACyMW}uy@_=%^Af)}QS?h^L7Z7%^ z=zzH_C4P8QsX(;ex+Vs_aC?OV7DjVnY zM-R!83xaf7Kjy5?uG*DM+!(A`8eq}OONgjCl*qirZ|@d&?w5#Az_iCb80<4IeY|mI zAjF~__j@T@t0Vz0!#3z>WiFWe-w4ojbB7nl^J>>`+NF<7#PVXZOV~ag4z+wF=gm9>h|)I6!O&h7jb$AeiCgX} zm}xgHJSVBkYN^4KX4<%lZ`Wx4#9qyP3|9Ly(cU<3b!9Of=xA<+Km75f@SJ)FjK;b& zTY<=VudZJ9YpGhl`$!-1&wUv=x(z<^jF+^xA`%W>Ll85MyCv87kvoyqDt~?eMczGF z6K0CPjcz5F!+oqxF=JLt8k=fWVy{m&=LW-^R3?5CId(W089UU7V%HywW7k6OG2Jr+ zL%CIMGs$kt1kU$mwDmOlYa(g|7^TO6kv(N9yNBdB?eLQGN$g3wDptlZnF#1`@0#lSv{Q%AYS9zMNW%oB!reZ*sv+UyS^E z5^<)}&;?PZuk?-}KRzN~j|$paMPA@3z}bXMF&#Gsmb$p=xU1fhmV;bHZqO`QQ}Ax2 zOUYzL^PYTs9lF_UD@y2NlV(=%Ob$#I7FvsE2`8iGym)jcOs533$qNO|1WXoUkFvW8 zNALy#RU>X*Rl!@F+S2Z8a2JEXI|*b)7EN@_flS?0PAMVLr$Zmc#?VZweTU^HTLd1r zmB`}7$*Oh1*jyOvT=9P{h*A?{Ts<7tClpVDVeJ--j)ZZ;@8gXAwpYKJqkoyY{2u6L z#@#ZsN&w@RKM6m0c8JCyMt=?2Qk*#-Ixn4Z?tP91Z$V^AB(_PYY)ZCLFdwzIqh-#t zD0ohdmRh3np(!h8H!0#e$x#$YB;%W5peHjMbYEQA2Vlyu{)S$nT%#-K6s8_llWb`6iQ@8!?I1d00-M|xq(u=&QtWtgCx z^XWSr{;>5^?7va{;3s5f3Q4K_u0oA}UReo&($(|lP@vn&f> zjrQ~XL5rrhwb1o@E!c-1siB1O18M$lO9pPswQ{RKP`3a>q*okV9PJND|IG^4{K3mZ zU<$?!x3m!m(#;p}qx@-g0KJQ!b2K^)!<4n8Pf`%S^OP?gM*NULklVfTR#9;MEEr z&Y$CShj74zoY!u4EM_G9{Xz@owcPX2e`+s!l)}>=zpmtmu-M&u0qt_45A5Gl~Chy4{PL9wF(q1CMZPjgIq@vKSsi zA`1s=P95_7%^LS_#P-%J7>LSj$0U=G59){%{D?~LM>J{WuOUMvqkiYTIXgZYrzcv+ z_{dHWF>!%i##7|6Ory4Ija}hQMR7oaEgrLwwvQ*>sQx!+kgyqz^ydFMTS?EO%krMk zci+q>C8`(hGDd1KgMin*TCAmyX7gXLZ+w9o$zhA~56Goe;Twx?Xv_fOnBNd;l&PJ& zBpjcRWKX)rB%kYM@Je(%Eph3k${}O8)nU>SEk$zRD9k{yqtb<5Fj2~3-|AJ5(YCti z;U92~X(HE-Haeb1uQ5?Xa615Vu&>x{s1Ae~Hs-ys7xb)RC%Q{m#k)QK7HzG$-Ft`^ zI5Z<@j(pXAH{78xwls$*!oL(pf`~km`L7~oQ<-Dp5tx?8F7fPllvw#Jq>OSvwWmqo z{Qmp@NM!I$R$T|)??K7^_>42_?mQyFnEy1L{U%7z+@-ZM)L+Wj3|!|u z{osXpS0M$o)v!U@*3ZO1rRJ`XyWGOifkwHkPV48ZFOtS;r0JsQ(?ASX0WSVNvd@{f zrIqUul1%3&dR*Cu0AbcnNG=?yjiw>0N93kDP`8^ghg~8;4BOf2P0B6&&-5fM7eNx$ zMJSMoS`u#N0CJgBmY_OBXN@$*`9mu9%~qrcG8AzbV3me(BD>*+a$Z%u>d_uX%o68O z9;6)l_sv!QZ^b;1O-RdrVoR(eVvfiR?Xs@JSlFcf_;A^qT!q&Z;A9m#wu~Su%D#Xc z)$q;@6gSZ2e&{}@LVsMbaXEYa1(A>kbZQsML{f{ z4iK_7y4$L=7HEgb%>Z6$&~pf$sTTC-2I91o0o5WlWu8SDh|`qqf2(2!P(ar)ebyFs zcXUjiVJ&|iqWJPTkw%_ZonHctqqfNN-lG6d$_SIjEv&+n_{9%QDd##7Fj?abxv?@T z*w_LjHch$fS*zWadIi#%yE$d&iVxlRVAi7NRsd8G&3%z0-HIXwqCJd*&24M6KL4>s z!ANYT;cbUbL-ey8V1b3)lx2ih9q?=FLzSY8Y zidWz+{s#l@vznnczdA}`d&h-tpP6J^xAC{DuYc39R%U;_?&RPLjgv{VyEScMm12e% z9h;i?_zk~3-FWNug=gE>{eHNAc|qMc=YpV9Iy!bWbgr7VT$&`e z07|G8$tNg9Wos5tjIH{)ataICACH!o`g0ie1*y&W0Gp z9qWr>qR(b=I2Ma9;_ z1O8`EZE)Lc{4aJ3W3WDD>7#5&3VjZ~?7a*7Ke8Yzj!as5g}v5cb}ETFDDF6NtRuZP z>EJmY(z@xn$zCOH0=qLwSU0~F(Tc;&6OI==a>(&R^mMy7tx>yHqiyU(EkrH*kl>0Q~gCQtOYok~6!_NB&kU+y3|$ys>#n&^^`LWuQR!Ryx=G5hi8 z+baXt3F;lKn)VDM6OxGPTK zuw8`(e9oh(S1Ho(zO*0xQelz$fAe$~WHvWNf4+V&VB zhFdbY!uiLk{}%l^KyNB(Ba+H^{CW73wQaXi?*E3ht;w=c1ODRgtZf?*Dz&-Fm;8U< zN`CFWlVB6tKZ)V~Jp4)IajMSt-^77Gi9C8@(-C|684&G7WeA&)4x3_Jo1pwa5GG5W&swedQ4w z@=tHH?~He0B4f;Y+8wYC~? zupSOPo+7qy+dVA)p8*`aj6M=rnl7hE*jm-^pggN(LhBsTU*0N<*oW_K;s1hr?;7~1 z<5!>7BJX<$UdCmMZ^I`67Xv&?XQEhcWc~ZWli@W@IXMik5ibbBnQx~~9z={DQPu3> zJ+1j)kPE(reuMVwt>MTAU%vxd-PCuD22cq{*!M56eZc;s+6(5b3vX(WG0`9iXO2*X zGsoQRRYdH54wj@$;z7nA7^AX0J$VFrY{_}4f5j;;znc^UF=G$=QARk|m{jd~0uoPRm-qqjzx2;6{4mbV! z@!Vc8yQd%EiqjRL{0H3SFTm;_keaalX9);OJxGBt**mBPIdcs1TDf`kkld{lS&G7w z(dGZRE##T6!c8CCIEm0{ZIyv54*5#TT>9@A8A@AFyb!4qJw}$|p~0o+|FRe;&LJzi z{ksifB~Ea~dR`kRu##1aZZ!Yb<9|kUNAme~rPhYsfm|qC)$Ad{fw>_Z`C6c> z(6oNb-d%+yk$*mv{7L3-R@rBNnM1@G#CvlhC;mTpZ%0^}P~7=z-ar593IWzx^A}!; z2kz7HXzFQZE6S z*1hR(s(bs+!)bRv>QDLkF8ZFq6+dkHor1WR1~_TxrR!UeBHlWUeIZPi?+wG1pM76d z<_~RHd1hY|7ZMFkfM*5Jg|dhKqbBqKRDR4ur)Lxb?Gz~QwgJfdeFLs-_b*?yo#RAh zTf+m>fn(aHzh3@Jez>FQGuB+ly9kH(GG#0}3>3mpO@&*z6AJtn9ljFOAyEkYY$ z4E{0>Bzw#W9}vA|4^N#FSSDF1IU7kKF@&^=8!$qhD~mgBu_3N6ieL0YT0*j^o)8 zACH?e1}AL-LG72k6FNvp3k4c$zq>2}(!CBOgjG^jq4Q<|c~wT)7U^R#y}!Hcb{+}) zV;10?{m<=xpFi?&Mkj{Xx1>~sM?4I=m;Am;!c_o12+;yVZ1q9J0#i5RXP-*BqoGjPcd)cPr)cvpUVBhVp z52iLW?AwBLVBw=gXkv~&N|i=FN+!7R4VzBsAP@EX*0-o^9g>MSZcI}v)mWvZxbN;p zBRRltd5x3mcO8z>X=ZnfuCdrSBB6MBa08$SwAKX zO_r=q65h)MN@JG%D+5Tp0V^u%@twIlqS|UZ8kA+0lN@U%ddkKg?@+d!@&H-yR-g*$ zb)BWn&gIbyO`|XSXWG%o8X%b4dG-pE#b{`MT)3-sPjZnlKMVw%Y zt)&BDaNvL2xO8snn9B_t+3HCcjM$&$>hs*h3%{cq7urzCTHAb-#zH9DB7V&tjWkg1hX1tw8NQRK=G9a zu65f@6t3n;TbA3AMpjHI%(qxc&|$We(Cl&?KfsA1iCEYjs0gYrify=axX ztPCV3na)S93poriNqCh&o`dwX({2K`Iv;8(*qR9M_Ke5rrH$s9Z588%i&%-nH}!c} z7dHDULE`O51Jt*+GZ0(o19enU$l;?Xa+#SEN_lEMpQ23&IOm+3E#ZyE$9ro_R28&~ zTwNq8=fJ^muog=t`^B_8F#3RL(!Q~LQ=sXv8@AWGm_0(wzcHMFiWoru8b0hh2fGZ< zNGOsRY(S)nQYyXI?l(^Av93Kii6qn1h}*|1B?~;Kjh>IwM$zkwe|@4L=NHUyKYyGHZ;1Sn^;t zuP+Sb0Dvat+)c{OX5aIa6M!GXn`eCMNz_Qc4Sb*D(EIzwnjwWVgGQ@0S|&Oq(j=}u z`5HInCi-F$*6D-ONWyrM_nsI4$3gLEleYNw}t2VtJE0&FHtZe^})Sw%to*R-_4cA$yzl&w4pO;z{cq1imwT0}NHi5*jv z$DsFD1>p$Kmw;_(9OnQ9cglGk{CD)b#4d)^gVFP*lZx_C`FRsN%WUd;+IHw>mZpyy zs{Z`lRIMdx_vKpEdidlQbM0x`!RbchQIc;5q*u=4+V!fGMS!gc_?O&ra(o6HMxLw5 z%tQasT+eOUE)wN1OTpo64x2w4a54!J0HV(TLA15dhasliIXRk#LfG?Pj08T#cqpTdzPE&h;_;kb1?=tyT{mz*rI9C(kzjicW8K`ofo>~M z)#`lx1<$WG;j}V8nAg8S5fo>9_|T0N>x*+0@b>YXx!dsFni4k{hLm{KgX2&wxjiJM z!te{!JPTcgM5Pe%@zW$lv;;=S4t<*mnT{DK#L)|8+ut5l>D=50s({$ZE#0XGmF-Z+ zAAY1q5k(&)Ju*adq#|J`xZB@7T2W_)Y(k@8l+?9|HaiU;)m@-s%hBq;peSwX_p$4X zlRk}@MYT?TQO9BcOOH)R!Ei=!^PmWV7#qQYJ?987jgCG5Rge$?l<9cPybu36m2P1F zkF&8*H5yw5QoP)kXIG~7>7-{M2!&rd)VmCwki`BY!b<0}bB#P~|4#U}j-8_Hqa;)P zEG`D@l~KK0o_{q(N6RRJg>`_b;X*&H>;Qz z6!7Qnc@;XbrC>jdP;7yA%TnSZ!v-DuaSw_Xn~3)%JoI8oH(^^dmiMM{E zI4bRqX42M%BH&gbOUw}ArcTw>B#rcn0s+U)Y^x+@XDIM;Om>|KMlzRuFa4R}dth_) zQvqhGuBm76Zg9D3qjlQnIPVNciY|}0oX6fcJNXy};Be!!>8`6n8=8eq`f#`}3wD83 zXA=A*IdzPxdxw4Z*n+PDHY{}`kGnn3`4D+bm#zx#PjS#G0XTJG2(?NeXZrA zc;++WC}q)>1E`wHqA$}(K>t||cC95|6(_`5n-M{Co6P>h1$iUCGs6~jv8hh$_)T>2 zMRWME91@K;nIDSwPXs!S<7b-}Z4o{+9+ZIVT+i|1=2#OA^x#OCL+Tx)D0Y3XB6bf_ zXL_LC3WToOtf|24lPHxe=*M`E{VM1{&VktGBfEYDJy2rZ-+hN3Ces$O4H=|DjQI*+Us zx%(4~)p|(GonPJ@KFp00x`1)c>~eKR3T--F&FeJ;U#jWdqhV$r_a*cEloo*G{}vs! zWdvfuV3aG7bVtoE3`88)ES&ebr|%sHurXG&?u&lo$J6tJjI2@&z%!Ug?rq+D3C(Q!tmJ#3yBeB^ zbsC9Hz+2j}+*aHnh(bz=T7Eafo8xbl?GZN{!uovx8nf|353Vw$Tqli2_$9>bX+Cbg zB0b543b$`J#$G*-UL0DVz-%BKat7EGvmQrM2jko|6{Sq(?^EPurt8jAs&yeSP`oJk zf_&;l?l57sC02Imok`q6B<_f*fUq;sC;S3@CGQhwxoL+Iu`4E$#te<-TD*4Pt5PG% zi9ZOOjF>M%h!EEMDN9i(C_b2!-9=yUbG>1zVdyq*xNKJPh;?Q(y*AfvBvKeXh1XQ) zv@-VNk~XaOyrao_fxdz4X`sm{(_61;v$HzOr~NkQa&3}njh%n0D;DYaf_eOa-znxK07@)0o9?V{66EziM1t|2q6ug_e>>-3nyV5lBdEX<|RymT8!;~v#=6>D_Z*{rO3@~w%xZr`m$E^ zC10d9cYS2>S5r;?9VBOEqM8{9nf7NywB9~c63Iee+IX0)FU}bmg)n=BYF_o{bV}bF z`OJYcNUx%Yo)GuJMDvssUk5VxC}_d(*;p{JU#kPAlqiH_8E0)_REucdk!e3&e>ty3 z>5uT(0v>Z-JZhQ^F4^h?W=)jn+knJ}N8n!0pS&)*9oYyV&Dz>}Zl4y@iRqtDy>Bak z6uK?_c!@~)=+sfz8m{X2Aw`~b2%bdVQ(=uk8u?QXgiS-G_%7z>d45BR1SJY_Rmep) z!qv5ZLyp#nn*Ubc{h!X^QVlMbVQqZ^@qr>p4tsakFd~6+GYyvM%caq^ z5+(9J)*M}f%8Qh=)ZmakXp5YCi+WpM4?>jx%&JrJWra_urr2km3#>_v;BOqYm}W#;v}YRMt>O&jfDMDQm?43uf8v+M2W=S|Hlywy zE@mNV_c`o0T|=F<8!*$#G4ZvdwH~s>bmp@@hXMk-8sPyWG)ou?4QVq-kEbwTggSWA4*O> z*|mC4438$M<%!nx8NZgYf550bovF8{ruvbL>zh^8GgAmQSjTN_%Fw1do%B4NJJSm9WyH$*WK%&HbAXVllQmLxLwO}>e3U-EiRe3)ZRE+$+s zqES#l{_(UEK;OiSV{v5;<4ayOcl~B-cc%}wZP9&+cf*7Lm5MQAq$$n6 zp!*?_M>&Y$cgxv(Pp0#%UuJ{WDd)~wl}@F8A6?R`n$#&}I}QfgW2UaQC=J?WDP234 z$Fb)mW>*Rv8=tT)Cj92y{!KEoO$(w(f^-IUoHghESg%NhLnIb$ado_(T-qTwBMqrt zpu!8CEt*{_c2!GVJ39pFha7Zj&0A{BDJNGK6vZ3Os20!9R{o$`@jBWw6dAKG)=Jml zsyBM5GV3qPKD21PLZhY<$JDdb6l_-1Q@^SuYK{rY7_g+$-Ga^fznUBHbu8hqQC-!+ z$)gexn1-SQJE|4Pi8_O>IDuR`|2QrwlT()OK1G^jW%KUB)RU-zUF@lqN^|9b%c-T+ zTGJEn^)wPp9#rp!9n`2Qe`G+AdRD$C3m+k7sB)h$AR-kfPNK0{6h;}K6SUi;9K(-p zYSA|QI<1kZ6LXDfC^QyPz)`f&>m7c$BiD{Mf43b2kAQL4{9Ox5AUVn_zN=cMoYLgTJbnn)}I;uF7q;8(l0Zr zM#7nDfju5SuUNJqor^YGIvBxoO#AK**Z0_9)13K)mgEt1mdKCSO|s!GlH@QwoAWw6 z!5Cvd@~4o~)sq7m!9{9}V>_zfybe3hEg`3!YE2s6qfL6?3(PU~)$=1{YKb%VSEsCC z#g4%0d`J4(j_JYh@jKOc-6Gc?0~sb+N%V0lyX23+fWTC;SOi_IEh$Y)=5pl=PIo|C zT1|~!a7*5?dnmXmUu(a!qlGr9;br@9Z7(;~RF+7)-CKifuKy8ouOi!x#r5HB$aeD) zTxdN{MT^{$+2(xrG}i*DnJ-V1DZXbZCmI5epvczW!rd4|j;%CDiTHtUdVScXv9SUP zr8`55;jYGPqir3Tl+1jb!5FU=;8}4ynitb?ES9aGlR23Gmf1 zaJu)2Jhl~Vz;JbpM9&Yo$Kqs%lb}^NjU{X6yv}nJtyuKKL;h>jOF?xQMOXOQNK|tb zyPn2I;iApnn5HwgBo|CIPqrtyXMRMfOQhJIPFGmY6{m3A=iW+-P05@a3GIn4vN@!A z*ZS2gwXdF9UE{Jy*EPDTAcq?7EDXpii4S?C=g>uKBYASXUgizK2Ogobrb$)!+1aNA zQhjwP7u39b+Er3ZGsiCl7X@&ks*1dETgD{rew$5Vz9u2vT;xmLTsHo}w_UtpG0`x~ z&m+m_yByM1f`-@jD+i$%WXyh(vyu~vT#ianT-fNr$bWVtT*P5vve5E z-kAA`hVf4tBi3vYEAXCjwc~V3Xh2V)_!N7rz%`neM3v7(^Bkjh6a~%F6}5LI%wr1L z#R}NE*x78@cXQ8;k5})Q_IU=fOKpbHg~+a(C;6@RO>e^TfvW4voDfBvJ~<;GCOJA?t{avhd0 zx&qHCG=wIO9BDb5S)$A^d(t9MUBvn0kqzl0Q_8?wC!?Dsg%#R8Dd+T9OM`1kv&;rM zJZZO$x^P*?v0IYd^*A>l`Q%qXea^cYQ?+{KOs(=`^-zU}tSKvrj^FvJb(Y zn8a*i%c@%a0_UEBi$G!zZ5zYK0iH;eI1<`|TNo4d4oLLm2%D!cQT5=7&b()_A-e3_ z?NlyFgtTW-%f~|DGpLsF%4I*ctRxY^l_5Tb$J+HOa}#riB}YO8bowvKh!iK%C|C9_ z%o|~pwl5~#ahorYai#;8m70}z=!yGJ@)CAI(P$vHREzaJ{?x5^gs&{<=Al@<(e19e zlL=NBY3ky=kLCP&63#`Fr3UEOw_K{a-rTdlMYIh(W+nAq# zo?zBQ>mP|{5L}xiRtKW?a@{p;RFbCLLo;42*&ayN=nbP7;y=vYUoZoLro6moiIZ&! z*fHVt86Q#E1-LhMhv|m^&_C7sl~)oWT!RSfml6$U~ z@e305doM)ZwF2twsVA+HPw)=h8GI*Fa3y7Wn)feqzB>A_+0e--(I8|XDV)8HE8Ao| zT4~Wm$~y71)tv~Qe7+&{y@iew^z<3sZX*7+g+h`T6YD|S)(27E}hDRIwy&u|R)EIU3c8hmS zm{Dl87Wd`lEWvjcPBxT& zAvGtPqK#OpR_9#M)IiL|>U6OB>;tQfe`L%f}CP_T5}VkRHY>+kehPp;A0la_xUMNmulzM?@Pbl+@#7I;d{&JYh zZ{*5tzl9H2Rq){>Rei>%3;K5kIWk$!3sVV+_T0^Sluyl@Rnb3;h855Xi{%BnPsYsb z%A5$y-S4_v12cP_~@MVH=QUYV9aXRVyM zWAX~P)v=A+ziL|b9;TBvuq=)blqP_ARmkn#X{y$+y{^2P_wL}X^n6EuW*wsYcZ*=o z>N&d)&hp1(QRK5%yM~LLC9?7?tXo}|DQB-WM@|+ka(^B{^CYY*?pitXW#G8F`jEO) z$_;cDyC+(yGg?ua9M}%SIfeD zLJetmDxxx9ulPaN(W&knCu(kt^Q)U4(su4csOeo_94J8I{RSjsRsIPLSqHcCxh z_pAgs*J3u)WlE~|NE~U}wYnZ{#=u6Q)JuriohI+)&;c(N=Xn+z2{kt@7iuc?vP~YK zJB%8Yj#3_X)(|#0E=G&w_cP&as<=&5SW^PutGy(IywUuvfit7GizyU(C^o~CM|fk40 zDii$E*^-bQBVp<6jPDY@Ws7BnwuIpLQVjhVdGFWch4+$chAaMwI%LOGC6O<>EOC}9uo4Abh#4)h@3?oLhq_SD?)D!9fL`LveHR#WF; zXT`S`%4GC0X0TWS+O%OCYOyEr(M&75zHm>N(bA6UbW(=HEv>8TCz&QDl2@cF8A7gT ztHO5YS*z-i=HDjtPUga-_j_c@CF4XTG8gmrVUV?n7moC!p{heeMOEZgTXHBX_RF0D zIbm=D*LYT4ES%_}cxShXN9t(jBk!7HLqhQSjIOviT%hq6N%a09zRbyxz?8-`n_Q20 z9K&zPDHNli?fCp)L|jei7*(>f(lng8agu6XPRsY%D9jo^yW4d5u2*|*33p;~t$_>F&s}BhW#2eJ;L>SoH50Za;&b`x-Y>1(2ds#fLz@VybR!P$+ z=B`DI8hJ|Rk1$(kD(H`8J?D91nsAM^d_|hZC4b`xhupQIES;t(#WV)lw%K*)Ca1%&LQW2K?!)?&C z@U0Q`ri0(D3bdFImwA20tE`VxCK9;1(96kQ;MCM&rcTiJ%d;j`7Z@b`nC3|~QLEZe zbr1}=>Lll^u1@5^2wD@qho3og415f5WE!}=>mCSj3V0GINFF)u^fKj*ghj)=n4H^e z?>2IMM^Rzc!sqQGp=w18Lz$Pm^qTRLDo^vhF>Q(W-z=M`Rf}+caFv{4qYZi`G$Xs3 zbU}x@;*rDc*MR(~;Cqq>_@l4`^=D}5A_bBba`ZbT*Qg^>_;$6=V?`ehx^5hLE$A** z)N)N4-@07mTzsp=C7dF~lS>sFR1{sY8CVUp{1Emza0+Kg^+ zr8B3V$wTfM+!WO~zcbHX(80!;|H`IPH!B$Z?%{$!YcRXs1li!;K&|C{Q-3QsetCDu zL^wE~V7UT?vV5IaHAiD(yh&$61UYSYm^80ag?ZefRRfOXzQSMY9xI3$%;3^9(~s|^ zJ@M1q7R4){n-kBgdC?sEUY;(EzgO>EA&5yFI@dafLlJzw4}NLvwD!#PNbq5zEHzdC z=2h5R5Q4{>9Z|`AL7K*z;2&KG!9RAJ3AEMj7EYgaquy@WoR2Fzx}@qr;C;gG;x>za z#8^4Qr_y5%sxj2li6J3QxKwP)a79RXq5Lkv1PhQls81CJ>PeTGtB4oV2z*Q8X!S8&ZdtkzA=%6(-|BQlPgFA`Swh4ITz3+xFUto9O(YdY`1 zo_=4KaLGy|WR6V?}-wwPNcU#yo7XG}ysLRY`) zO`g5btJir}i}Qv_l7O^czbv4s`K1? zuf6x$YwvUI&-$#LJiQRu^7RuXwR>cs8@W{14qOY)wU?;bWC7acQXkVz%%+cJOZ3{k zV9UYIdEHPOQipiaE>W_eYALTkwamVxJHb&_kl83q-L)3otLe*v|J1lSERFyGXx#hI zG(tS~e!w`_JS`$4+e0tVYPY1dE0RY2yX_Z!OrrfR9ml$X| z(RJ96GSro`6~+ihzN!$|(_7;N6#h7p;f41npy3c&N7@7RR^_W(cc04aE^U1F;E1a^ z)PzF42M&v`n>JrkYfufeAetNTapp9lLZD0sZg<9ZwN zc@jV+8i&w|{O`N15n}HpP5TZzIt&J2_&|Uk70(X*M1A_n!cdyrwdO|MXFx*Jv8tiF z2ou1w&MEJ=!u%XWc*+V-1$0N>{}lA0I0$-P?5Y?NG!gurhCU(tQK#|%S6G`QVu<#; zo$;4~3DQs#C`M=)=*oF8E>UM{7m>qX@+wq9!?lc%!k2*qo#ESusPUimGgCs^!hT5# zkvBgp3P*EJ^<;;U`*9fbVdzm9IY2U%K&zrId|&(x$t>fBYL@rC|3!GDk7hBWm;ucq zaTFAzlknk1U5^GTCT_w*+JErv_@I&uZkNJ;Q7oa;8h@#WSQGTYodNncO8mA7eV%rp z{XCn0^yiKRf;S=({=+{RJfMHY01+OYtZF<3y$?q;nbA3e2qY~U2OSsV(b&n4j`Wg} z4Y5Jp+W84>e1pe%!aF1OpRwXYZ=egkdrvYVXerD|64ZZZct{7;uLX)U`ss8d32Im$ zM(d@|U#2}03Q|gV^8VC2N(Ok||BR3eb^ig}xHG(Z5zdHec?9Em?yns7d(hkx2bQD0 zgWnNp!Tqy-Hb|i)(SRO0BY;xCQlb`_pOc&Z85b(J$+X_dEr;qw5f~aw@C&%@(a-(p zKmYq`4GsUlejD?D7V!$&UKJ(QwWEJX9(H<2!NyJbQ`)7`{#%c z_rm?KG764Fi~TJ19)%?({mQU_;Bkd?;up{@*DI82F#RtX7A{c}TVXbU9;lt(yik|* z?Y+pQnI6H%PA^RTEA$}B(hkUX#9Q5b(YjTDyEWfx$tIKwV8=T&l+?asSP}j{&g*%_ zPrK$O`j8Oz*wMOo<|r@|z)aPUBI?1jgil1J5TlgDrIA~|wlZsu#VK7|+o09D7m)<{ z-*mPC&)a*!Zpz4u(N0yW^4i)%fp$wEdTA|oc2tL)OUi51^cWybY2&q>P!b$}?|)FfIvn>x$0;<{@q%{LC+9a1(9B9|!y*t{Cd%HSfKcpjDKQVom|4 zOW_Fo5~dJUYgb0XstP%qOuoK8v;6g3U2dJPzzCfqz*$ToQ66wiT`+EZ{{*0-mfZb5 z5cUURYKV@R1MN@{il4RXu~kvw$v5dZTky@B!=#eYK65gqq*#8N29u&$(0bT;QDMcp zMl&UEMMF%kCd+acze7z4v2{ z3zBIF*DjbrU%K1gIZT{XiAbIofT+4|mttKYRhohc$wb-FG@k;P$adYR+aS?<8KH<7 zV*yr-mVS11K^i;1zJvInq-Guv78x4f38@{2c5&GHEQTImmkPcj znv5Eh(Sj5NtI=UO!ihA#7IqSAVS@8JI~DqiEkHCMzaLOOQ5O*jF?svN(5dETIWSU}XvY*y%kSBvo^|{cpD(xO^Q2b@+bHQ*3ATWJX zFhF~i<;a&>u?BJJRs-25$Ew#CuUCLZjQy*B5I~pyEF;jv%xYO-EgseUR1d{N} zmtWFDyUSmrRCmluFtsEw5@E2HlFKe*mnSqcN#~XB#Jl3wl(4y^T1&H}%`>@!Br|yoF^%B7PAf)gkl+Jl!vRDaThOem)4jSJ_PPts%}o> zq z7e!1Vk*cIU#UwdRiR*w!&eKfxJ+^EhpzL9Z5OMlDdLZh zO5-1um=_8*S8SgDfHTR_9H?+0nHy(4JgM1dFjXw^F5BSCw#B>I#>})g_RIZKHqSDc z{r(!o@z?NDjLqsY+8!$^e+vfVi!f^_|)fbbESG84fxu zn-d^o^S6u@LjiKDrNWqarhyKU)_oy-{|WH;DcA(%ZzFQDya`C_%;G}IZk2%gOX{4&W9I|Un1ag<_d!AhKP*hfG)Fw8b&>v^gWZe(s2+vKgk#_-?N zTqZ-YaDL(*+31k=0X`*s^Gm1B;)4BEGIbenRX5ZzEEzD)jN>2 zkx~Dx508Q3ARvLq4Lu9h0@Y@p055z$9H?p#;RJ0r?k@I2_L`y+p#_Zp<`Q=|gf4dx zej~NbIEYF3rn=>jl3a3f3hSA$(F=@sZPzztq>YWo^$B%xZpr}(3=k1Pu~Iy!kFWDa zY?fA;B|5ORr66$W@bC|=7KoN_A=RrB7-g_$^Bm_fZncr-1D3Y9gq3~9Fuck%85+&z zJ`uQ#rBZx63-PUU{y9W%c=ZB(=!9Am78#ZFnXpTaB{lS1G zv7&gF>K8%|c}2>&)yO~>Wk1yYt!FBw^>TE*zqa3TB0jcT&^GJj`<8-RgE>mObh5D1irBc`y$Rv-VB6X55zPU~ zq0uq%XBOCGTq1TUt!ylk-Hm2rP5J;FGq!l`XEau}^hD_D#KF5SsLY%Y?g(sz+;J*& zNy9I&9r-|wF`5mqsFjQZTxz-Ax2FN$y`*rd2=@-#lTZz&PKWDL(#mP$gC;&nyx0R@ z#Jk$-+1OSr8wsPOuj z(AWIh%&)o0pMdq_4XMu7!_;F@ zN;nyNoF>ggxweP{L8VhGJX(?B9z=&wIxeC=k)vnX zTejCj+2ykmGr(53BoBLHS#YlG)Y#z|9F}Gg=p~aOh=j$H$#Lq;imwjg7gC;0gK(M~ z>~kDqQtrVgogaYycvRE&Nt1;v(%-9C*OR$ zTN0?Z9Q0jTG;zX$aM@uy{qp#gSxjpd8%2?;+H_OF;}%xWYEHa24ckLQEg#_iNNwik z7vU7uylOe&Wy#6LG)=9g(AvKQ$o@SH^g0arfTgvfCAGMHsE}DQhEF3PDB4#xyF5c!)Ny`4f$^a0h ztZaKP@(hoaE{^@O{jZ7jkzmrq*7TM3$12q4)@zrb-ACRU`>=QSlzMeeQ}Dx3mW~E*}gsqxVa0lWp*ve zxYv8TVxkjRApj4KbUErF`9PPW-b2W>z(vO8nnc=TVuBMseBQ`U-AwJshTjn}lZ_wq zkcGb8Bdon6TjIhvD!aw9K|&9eo~3)v&3Yy_FmAnQ_(BaRh6E%^Rj zbg(*)taBcBw`HE&Q76PSlN<@tF7WCxKkWH!X_Aa%2Dy(EW%&h;gA#?yzF>;3CGqQz>n zy=k6mO*k!guP(n+=}k>Ib@*k3vV|(aS%~fryRTP^wC*AD)|wm>cSPUBH{hE%h{`wR zr+*3_3m`w+JjTKSG$5M+FD+mX+d?s)Q>3gjN7t@JoDe37w!Zp8xFfV zAZIHze64=9MF-9+SD^a8&<8Njq6smR9REegdj}kqavZEg$mV~)4DX(L^g<3T2NrN# z1(|$2{Ac$>sTw`_*+1uu!x8lU;bROjc6ppTkh!y<5GB35_yfBgBa4Rl^l7g@ z?%K1*q1q#Va#p@YUd7L%jeAk&d_bBzABW^&WJLYYpj^C=`7^=_+LQ#h&es++@~GZV z;5M{&-mxzKnU|tU5Jsqw{>Fu0!GdZ~XH)g(52#0laGxGF z8UpOdDBOnid;0ldQ)J6-P(tWncf6j2af4IPgTUHQk-p;18ON^7JN`XRgG+W(;ZcfX zSAW=VLKyJ$2QQ{9@Z5IldND9;kvIG+drVb4G$XevutU`$3C)O-llh7u}qFOm&AQRI$bfjTlqWZ)f9Il>3j7_x7@>xWZ`4m*4_%bhtSIR8V> z`mTSC|9*_2VyN|>ee+k9e%nxdRit8(63r2E#beJbqk*~1PML}Mkx}Q>bhc~2iqjql483pKUY;?D(@C{CYmxJqvcLFuXMW8 zg4=b4aE|U|PG>4?UtesgZ+Pb3~gBRDw26dM|88UTE+jpBri9bKXRnnbgOj|I& zW}FBfNxRuiiq3-BB6FZ0NRN>{?GUCiJxB%c6}5<7}Jpv&OBNPc*F>2wQWmo9Ac) zcYP<5Ya*M?h8X#U`kA72@|APgDIJt-RWwKUA1-ZZm zTd0tu?=+8v8;@CY)$Olg2Jc*!^K7RZJG5K|1iFxmvbJD0OX9F&*-Y^uui#Yu_BMG> zLQ2sGEvHo)$ED~|%_;~(6>Ltt1H^0DCw%C;>h`ljpl?a8NLzw>o6D*Jj?AzvQPa4* zgiaT(AcBfkmM2?dY>g!fz&T9sRMElv{fk1j@rqe%`c>=ok*?XPp!lY#A%D5l$>ie3 z=~1Fm*+YEk;MhsUb6m{8Ca5?@EYflx-&!1`NK`0)l-p+Ad%KkuXI^RGM-&GFVTfSYbk@OotuNd58hF9kLrFY<|)$KzmjPv zyN45&(rP&c7r{ET+b**2awnQHG%sHA?HM7A65F!$ePhwRtxdHS*fo>N`p%_7>;Ak* zYmvH2=r_;obtap*>7q7K$Hja?u}sYaj8(rp(fAGfSo5ozTk0Q@c$czP#B<{!XQ1`Zi6HNzs(k0b{w`ytqB&abNO*Q6WwnBi{>pN2CLjR4&SfY)nJ1P zoHsB(x>6))2-4T`a28lD2KtGKQOE<3wfv^w=DXgasgBrp7M1PW{pBWG8-&Ym?4JRh zK5b@$cJbP8Q$~sDyWhoS_i@1Mz*MY3SeE`$1QC<|O1Evn`u#}Ey>IV7+to)%v|l2c zF<Kzbb?q@vDfu30JKp_ydJt~-d^U06)hZ&cU~Hxf$xdar53Y_Hbw>KAo2_L9X`e1y z&oSuo<$mv*QmC2jl$S6g1jcmw(PZ*TVmF{TEM4N8ZZpl%;d@y~4Zf8`lV2ChoMHrLqXz}v|;3C9?@o6FIxyYTAlKDWg z(k$DF_6F{f#iJ|aw-C(bkD2@V>pu~rfxxc8LoZ*O7Yv#?ZhVfNO7mh$E!sVEGj-jI z$=PI-JWuDTx29+DIm4Rt>%vZT4$B?oT%Vj;Xo6^*%pt}M{G&H3lMC|hc0*V7(`v4( zU>F=<0tYHAG*{j07nd@Vw2CUQd^zTA*~i6qc*FiCoBLzP9p?rs?Dr5XGL_^M zI^aVnZ2hkObK7>wIg1OU%Qa&!l!0gm|2towLnU|dls6ZCzv0{U=RNnDlI+@#5Ot}~ z78;uuFTYF(T*^s;=-@CdXQKA}rOBy;eecwxr2?q5c8?RgNjUR#x-e|}J9?!CzFFqm zb}lyzv%_gxcCf5koNWA;EDwJJKl}|9!FG*#3@^1z!!tjp&%vM3_TxaZAjCoD?3X)i zVm(ru^+W0#i?oYA7P7L_@a%*|JlfA3v#%nIOAZ+&xXB6HlX zi7Tf=mQTxYFa3GRJ0wO~IoJZZ)?`z4TDA4iUO?<;wRPPz47(kqX{GR?j>b&e=JPP` zP`CBe#*xv$^Ivy}(*B$;cJy@Lez-wzcWcr_pE)G3xgGawM>GsoMDF245C!-(br*#| z8Lw%l{^r_p8cLZ_bxIU(*$)M|6hgy!=aBq15TxYER@V}mv-jqI0`E zmucF!U?z=ZKWm=bQur>4Ih;F1hIC49b-vAvew((VZG@Tdd~?ZkYu9XMj+SEwU;yNI zdUT;5rPvveV9Hq${!tI?rV-c_t)AsM{0XvCbhnl!T5U&V3`mToQ?@j}aTyCa)@lfT zpDUlLm`t&(yqV>YCA2uF$GbTA+;pJqscV`8OQL8qT+ zj9gA<#29)kEoN-pE|Gb2Tbq3QJbmmSN)Pu>=Sb0hIG*p~JANKH4XW~B;naG$?L@qG z?5oQ8X}jliB|7`I?E*FLZTU?xTOn5Oe>Mv`aDc?4rwl&TRMxo%Ij#@KIoQ>7|Hk=zQS| z4g>3p0KY;#4HPYg6Z7|P7yr$W(7}+DpO(tphh9tuS?r1gkn#3A2MZvq!TR5j05a>r z033`OE=3I)K|^AKHs{fFNg}@$&#C1M!SB4Hhj}#((P#HTYlQCJ-fyOKhA;_M+ z-T%iA@edjQ>gK)-SUHByh^PTn{w}m1e?RRv1HfPAnQ}Ksefk-dDRP6RLzys5^PPag zA#`71xES_t_!+BSL$5201Wuzfts0cCCuiKdbEe(@6Ce5eiUWH1Yu?;XgY(Br_m$Bx zG*X&SX3D{O2PkO>q6tKee*8x-e*Y4!fRR2Y{>2?R_39DO#cs@qAC*TK%DY-q|H{xv z{O}S;y(j7lJt{K=WenRwGj~6z*&4)AnF1)&u{45CL!z}HnzeY{6A<%{P(OdUKSLrSi-nPw?<3S^JhUG>@~QXtG{U>Tii-Zv()qu0={&xS*#KBo zXQ}%x>)T)dD4n|u@#)IX57{e!UZF6%f>JIRa*mUrHOdXzW^>Jo0cl=8Xf7TTbI4EJ zE-1ut(Cd-L-?rg@%LA%^r5})RCtEDlvrTT|W1_O_rI!Y|4p+g1#WN+((}bTCquN^y`?zagO-64A|ds(A-=f1v9LTGq}>T= zrgB^OGEu&y1Z+ZJk4=;8xY41?pB-Y3!gs+Giuv5V_Qr7hJI#SW%nu+qNwx2DZre?9 z*aUbs)o*Nm`6LHCl_|1-+%hYe<^=?qctvO`+^QBpe!Zmo3nO;(pJ)v?oPsZY5ZRii zNC2`t1WgORxVLi0gjKx&`Fww71EbV|vBpr4%OY7(oS25H_14C!-JlQOfsIs|;IrJ% zy5aWNw9k1Z3%=T8{6(fK*MQX!4icWN!0wW8BU&nAuyT1C@J{J~RZHz(fK+kqC_CI% zApoQh9qCPzu5Wc>n6TxDA-A3Nd}JT79%cijsC!7Ve+tN)vLPA4xd|kPxaRwOo))JRef{1fZ&3e7Z9Ukw_%P6>pQgSJZIsj;*9msRSy6`v#rv91C zGonauSN{e0l-a>~)b#|0&N<^`tr;scyoa1&_yWBJLI_l zz3TwTS&%#{6C~1-kGwAh4lP7dgCJL-6^Lie4l)=9OjJW?P%m&PhFYUk25+>d>orUP zA!Rm9jooKnV+SN|>VU(Vg4^%TZ>JCG34K-V7RMCwtU2ufD2rio=PDl`*s;gxTICl? z-0CL1~mhcaHd$s4S=9^{o=(; z6?R^0hqPByKn|EDwA@|}#3ANzL2Z2`9cO5}kOkz8$@!`S2@gixcM;{+WsNgHmId#c z;B%FCA?=?_ax^V~0~`^guE&0<16UGGf;8>Y5QQgj1D>=OYv`-JxF7={MdJ_eHjCqH zfHoE33BQK$nobCpK$eDXAIZ&b3O5xI(8j80{vadiG@xH}#zKmYnUz9z{Ut|jiddkZtlrvKxURyLpl1e|T+E6Q z`mM7$UJ>O}K?xc7SiQ9&!bYRUKC`4VNgyB_CED~X1;{{YSRl&6lNnkPck04(m$ycT zBTKQ;qLbalFP24s-M`1_j2%7V&;0T2so6}-;9bPMN@l_{+rS{VaJeS${5za#TIBjF zjLFEx;sRv5DXaN#o_pfyNU#Kh<-?O3*wD>sNV}PaQlLRD&Y{Z#h{rUmO>44(tKlMC zF>XhqWw46)Tlxm2XW_`;-UtV|AaS2rw5K0|urKb5M)Sa=C(Lex&Be_r@O3KjMA5(Z zVz7E#a5FA-x!bzV_Q*Km3k43b+i?%noL3^Ba;F2~+vlEch?atM2nV`L75&D&-sVTd z(%S=yDXHLQto6!tS6j~>B@5gFP=Z<7a&t*1(LW}Yx6M$(UPQ?a)-%jV?SLAxUp&@f ze8m*VX>Hx_LVC3xAIYAL7RNq^m6>U?bnxf_Fj)88?XQSdIWN?Q)Xr9;=eVy(9YQ(c z_alN?P*_8?y9#*e>@RE=Zt$tvmaB}`?^Vf~N6A1UvdavYq(>E^vxM7flzQTvAuoeW zrE+Sbyy~cFL!@WIYh7e?VUHum*ClgXa=uGzI)HT2XN#E#sWZXj*1 zL0C*0v{VFe+K#B_!V~z?*fMs`7OI*p22tIt&Ik+ayF0!S0&RekF@=3eT-PKgF#PHPCKpV#neTXA+WDLtV@b>!l?@v5 z!dnd2T1jho$e)bphDcLkhz3fI?x1k0(8t<{iNIMn5>O&WtW;lyX|#deK&rFnz&5$g zwjy?JVs~&EL}|x)XWh)W&5ddG;VY_?#paXVvGq{8l)9zar|7o^sS0y3Kf}Bm z@+Q6-#1ijP5^0vho=afL&r1kR1t9RQ8+<0V8Oocjwvk(GsjYkaUIOu*!3(p_w@|HF z{M8=S7N2X_O?JBCp_kGc+KV%nmTFSm6vmR~x>GRAno3KNrD}aGG4vTG#2Y2cwSpDN z37zF#kb0JCW#*&7w+HGLPy80D~G+gqEs3^Wn2DLmTF#$0pF%=c_XOXJQ#0~iT zPxe=`B&P{|;#&S_`E;;Xx|`m7J5a#IaHiYwc5Qdwpn5UaO}mk|8FjsVz4o=$YtvZ= z2$(T=#QMA3HK^QZNO1Ng={94GiOnAYhjLo|DpCD|&Qhv9yUr-x2{$+<`51dX=}Hyk z@cHVzQqX6ce)9MuGss>=p8PpR!IetgKuq%49)kY9%^7<;I+?mQerit+dMTo>$K57+ zQY2LZdV%DRb*dQbdPp3Hqtx>ADv1Q{{z_hxbTVf2Dxesgc zM1>S*!0DvNV?c5&;G=R=@>LH@1NjR^HaykHCAd8?nMt3g&PxuZd(azur{LWcMPazX-aR12xMPELF{^MrV zmWMWS!fd>?NFcDi3&n&qN>zW3t)dbTrO`d+&TlcqP7{9Px{3s*RpUIj08PLNwL2s< zXCk+Tr(R(=CE^(ppCmzzBdJMJ81lQj*-6FY(`ip>nY<96P?4>b5(weBEg-(jWle^> zMiis0-v9~LYAkU@IAZ1=f3u>(*V_BJy)ZlT{{Fb1G=3_93gg;Ku5c52sR&NI8~7>d zR+5|nM!1zilkks+N~z4jl-hq8At6s6KTP7E9%Vx*xBP;<`kKxj0-dWQ3FG}Ceczp*K~%ZgutVl^2>JVKV=b4?KEVwL?Og<4 z_f|)x))P-0_QqG%PUm33NXrDp9nMbEr#-RXEkH`0Xu0{75DUyEk0@p&h#varzH!10 z_MXWvQ%KL70o-9B8)r#@o-iDD!)RDGyllacYgJOjC zo_`#9*~XLsPt~?xN#**{q_DKRRu84zlpRVZh)b=q*_X6)39S_$KK-aFAfL5`%ZrVB znPFI`hBGE9m1;@6U!8|zd#AI-*w>rqQZFDl+Ux1Y+i$nLKPVgku5zynQ0RCyUy_W@aJ(~Rle%R_&QM$ow`FRmoUBv{B#aG?jeAE8G zsE1h%+aX|sffW--7jK_`RENcv-6tc`n&lDh;-lVy3;ogdjRxsIvz@Pf=PXCSw>*lSL*kIZYpAjB6SYWSmeuo_#~!b%0Deb^fG- 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 literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/banner.png b/pos_receipt_extend/static/description/banner.png new file mode 100644 index 0000000000000000000000000000000000000000..d9f62eb36cfcbd7fe4f98c0fce92cd4eaf543855 GIT binary patch literal 82238 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 P*{!Q(2(Q*~y7&J8YeTkn literal 0 HcmV?d00001 diff --git a/pos_receipt_extend/static/description/index.html b/pos_receipt_extend/static/description/index.html new file mode 100755 index 000000000..4e5775924 --- /dev/null +++ b/pos_receipt_extend/static/description/index.html @@ -0,0 +1,696 @@ +

+ + +
+
+ +
+

+ Explore This + Module

+
+
+
+ +
+
+ Overview + Learn + more about this + module +
+ +
+ +
+
+ +
+
+ Features + View + features of this + module +
+ +
+ +
+
+ +
+
+ Screenshots + View + screenshots for this + module +
+ +
+ +
+
+ + + +
+
+ +
+

+ Overview +

+
+
+
+ This module helps you to get advanced POS receipt that contains more + information about the customer +
+
+ + + +
+
+ +
+

+ Features +

+
+
+
+
+ + Community and Enterprise. +
+
+ + POS receipt extended +
+
+ + POS receipt with customer information +
+
+ + Invoice information can be visible in receipt +
+
+
+ +
+ + QR code information about the invoice +
+ + +
+ + Easy to handle POS receipt +
+ +
+
+ + + +
+
+ +
+

+ Screenshots +

+
+
+
+ +
+

+ Enable Customer Details from POS Config +

+

+ Go to Point of Sale -> Configuration -> Click the instance + -> + We can enable the checkbox for customer details, and we can + enable the required data to be visible in the receipt +

+ +
+ +
+

+ Customer details in receipt +

+

+ Create a receipt and see the changes

+ +
+ +
+

+ Invoice Details inside receipt +

+

+ We can enable the checkbox for invoice number to view Invoice + Number on the receipt +

+ +
+ +
+

+ Invoice Number in receipt +

+ +
+ +
+ + +

+ Enable to see QR code +

+

+ We can enable the checkbox for QR code and select QR code + option

+ + +

+ QR code in receipt +

+

+ Create a receipt and see the QR code +

+ +
+
+
+ + + + + +
+
+ +
+

+ Related + Products +

+
+
+
+

Suggested Products

+
+ +
+
+ + + + +
+
+ +
+

+ Our Services +

+
+ +
+
+
+
+ +
+
+ Odoo + Customization
+
+ +
+
+ +
+
+ Odoo + Implementation
+
+ +
+
+ +
+
+ Odoo + Support
+
+ + +
+
+ +
+
+ Hire + Odoo + Developer
+
+ +
+
+ +
+
+ Odoo + Integration
+
+ +
+
+ +
+
+ Odoo + Migration
+
+ + +
+
+ +
+
+ Odoo + Consultancy
+
+ +
+
+ +
+
+ Odoo + Implementation
+
+ +
+
+ +
+
+ Odoo + Licensing Consultancy
+
+
+ +
+ + + + + +
+
+ +
+

+ Our + Industries +

+
+ +
+
+
+
+ +
+ Trading +
+

+ Easily procure + and + sell your products

+
+
+ +
+
+ +
+ POS +
+

+ Easy + configuration + and convivial experience

+
+
+ +
+
+ +
+ Education +
+

+ A platform for + educational management

+
+
+ +
+
+ +
+ Manufacturing +
+

+ Plan, track and + schedule your operations

+
+
+ +
+
+ +
+ E-commerce & Website +
+

+ Mobile + friendly, + awe-inspiring product pages

+
+
+ +
+
+ +
+ Service Management +
+

+ Keep track of + services and invoice

+
+
+ +
+
+ +
+ Restaurant +
+

+ Run your bar or + restaurant methodically

+
+
+ +
+
+ +
+ Hotel Management +
+

+ An + all-inclusive + hotel management application

+
+
+
+
+ + + + +
+
+ +
+

+ Support +

+
+
+
+
+
+
+ +
+
+

Need Help?

+

Got questions or need help? + Get in touch.

+ +

+ odoo@cybrosys.com

+ +
+
+
+
+
+
+ +
+
+

WhatsApp

+

Say hi to us on WhatsApp!

+ +

+ +91 86068 + 27707

+ +
+
+
+
+
+
+ +
+
+
+ \ No newline at end of file diff --git a/pos_receipt_extend/static/src/js/payment.js b/pos_receipt_extend/static/src/js/payment.js new file mode 100755 index 000000000..b530682f1 --- /dev/null +++ b/pos_receipt_extend/static/src/js/payment.js @@ -0,0 +1,70 @@ +odoo.define('pos_receipt_extend.PaymentScreen', function (require) { + 'use strict'; + const PaymentScreen = require('point_of_sale.PaymentScreen'); + const Registries = require('point_of_sale.Registries'); + const rpc = require('web.rpc'); + const { onMounted } = owl; + const { Gui } = require('point_of_sale.Gui'); + const PosPaymentReceiptExtend = PaymentScreen => + class extends PaymentScreen { + /** + * Validates the order and performs customization for the receipt. + * @param {boolean} isForceValidate - Whether to forcefully validate the order. + */ + async validateOrder(isForceValidate) { + await super.validateOrder(...arguments); + const selectedOrder = this.env.pos.get_order(); + const receiptNumber = selectedOrder.name; + const order = this.env.pos.config; + const { + is_customer_mobile, + is_customer_phone, + is_customer_email, + is_customer_vat, + is_customer_address, + is_customer_name, + is_invoice_number, + is_qr_code, + } = order; + const customer = selectedOrder.get_client(); + if (!is_customer_address) customer.street = null; + if (!is_customer_name) customer.name = null; + if (!is_customer_mobile) customer.mobile = null; + if (!is_customer_phone) customer.phone = null; + if (!is_customer_email) customer.email = null; + if (!is_customer_vat) customer.vat = null; + if (!is_invoice_number) selectedOrder.name = null; + if (is_qr_code || is_invoice_number) { + const result = await rpc.query({ + model: 'pos.order', + method: 'get_invoice', + args: [receiptNumber], + }); + if (is_qr_code) { + const codeWriter = new window.ZXing.BrowserQRCodeSvgWriter(); + const address = `${result.base_url}/my/invoices/${result.invoice_id}?`; + const qrCodeSvg = new XMLSerializer().serializeToString( + codeWriter.write(address, 150, 150) + ); + this.env.pos.qr_image = `data:image/svg+xml;base64,${window.btoa(qrCodeSvg)}`; + } + if (is_invoice_number) { + this.env.pos.invoice = result.invoice_name; + } + this.refreshReceipt() + } + } + /** + * Refreshes the receipt and prompts the user to display it on the customer screen. + */ + refreshReceipt() { + Gui.showPopup('ConfirmPopup', { + title: 'Do you want to display receipt in customer screen', + confirmText: 'To Customer screen', // Add the confirm button text + confirm: this.env.pos.send_current_order_to_customer_facing_display(), // Call printReceipt when confirm is clicked + }); + } + }; + Registries.Component.extend(PaymentScreen, PosPaymentReceiptExtend); + return PaymentScreen; +}); diff --git a/pos_receipt_extend/static/src/lib/zxing.js b/pos_receipt_extend/static/src/lib/zxing.js new file mode 100644 index 000000000..3443007ae --- /dev/null +++ b/pos_receipt_extend/static/src/lib/zxing.js @@ -0,0 +1,24234 @@ +/*! + * ZXing.js v0.18.6 + * https://github.com/zxing-js/library + * (c) 2018 ZXing for JS Contributors + * Released under the MIT License + */ +(function (global, factory) { + typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) : + typeof define === 'function' && define.amd ? define(['exports'], factory) : + (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.ZXing = {})); +}(this, (function (exports) { 'use strict'; + + /*! ***************************************************************************** + Copyright (c) Microsoft Corporation. All rights reserved. + Licensed under the Apache License, Version 2.0 (the "License"); you may not use + this file except in compliance with the License. You may obtain a copy of the + License at http://www.apache.org/licenses/LICENSE-2.0 + + THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED + WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE, + MERCHANTABLITY OR NON-INFRINGEMENT. + + See the Apache Version 2.0 License for specific language governing permissions + and limitations under the License. + ***************************************************************************** */ + /* global Reflect, Promise */ + + var extendStatics = Object.setPrototypeOf || + ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) || + function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; }; + + function __extends(d, b) { + extendStatics(d, b); + function __() { this.constructor = d; } + d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __()); + } + + function fixProto(target, prototype) { + var setPrototypeOf = Object.setPrototypeOf; + setPrototypeOf ? setPrototypeOf(target, prototype) : (target.__proto__ = prototype); + } + + function fixStack(target, fn) { + if (fn === void 0) { + fn = target.constructor; + } + var captureStackTrace = Error.captureStackTrace; + captureStackTrace && captureStackTrace(target, fn); + } + + + + + + var CustomError = (function (_super) { + __extends(CustomError, _super); + function CustomError(message) { + var _newTarget = this.constructor; + var _this = _super.call(this, message) || this; + Object.defineProperty(_this, 'name', { + value: _newTarget.name, + enumerable: false + }); + fixProto(_this, _newTarget.prototype); + fixStack(_this); + return _this; + } + + return CustomError; + })(Error); + + /** + * Custom Error class of type Exception. + */ + class Exception extends CustomError { + /** + * Allows Exception to be constructed directly + * with some message and prototype definition. + */ + constructor(message = undefined) { + super(message); + this.message = message; + } + getKind() { + const ex = this.constructor; + return ex.kind; + } + } + /** + * It's typed as string so it can be extended and overriden. + */ + Exception.kind = 'Exception'; + + /** + * Custom Error class of type Exception. + */ + class ArgumentException extends Exception { + } + ArgumentException.kind = 'ArgumentException'; + + /** + * Custom Error class of type Exception. + */ + class IllegalArgumentException extends Exception { + } + IllegalArgumentException.kind = 'IllegalArgumentException'; + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + class BinaryBitmap { + constructor(binarizer) { + this.binarizer = binarizer; + if (binarizer === null) { + throw new IllegalArgumentException('Binarizer must be non-null.'); + } + } + /** + * @return The width of the bitmap. + */ + getWidth() { + return this.binarizer.getWidth(); + } + /** + * @return The height of the bitmap. + */ + getHeight() { + return this.binarizer.getHeight(); + } + /** + * Converts one row of luminance data to 1 bit data. May actually do the conversion, or return + * cached data. Callers should assume this method is expensive and call it as seldom as possible. + * This method is intended for decoding 1D barcodes and may choose to apply sharpening. + * + * @param y The row to fetch, which must be in [0, bitmap height) + * @param row An optional preallocated array. If null or too small, it will be ignored. + * If used, the Binarizer will call BitArray.clear(). Always use the returned object. + * @return The array of bits for this row (true means black). + * @throws NotFoundException if row can't be binarized + */ + getBlackRow(y /*int*/, row) { + return this.binarizer.getBlackRow(y, row); + } + /** + * Converts a 2D array of luminance data to 1 bit. As above, assume this method is expensive + * and do not call it repeatedly. This method is intended for decoding 2D barcodes and may or + * may not apply sharpening. Therefore, a row from this matrix may not be identical to one + * fetched using getBlackRow(), so don't mix and match between them. + * + * @return The 2D array of bits for the image (true means black). + * @throws NotFoundException if image can't be binarized to make a matrix + */ + getBlackMatrix() { + // The matrix is created on demand the first time it is requested, then cached. There are two + // reasons for this: + // 1. This work will never be done if the caller only installs 1D Reader objects, or if a + // 1D Reader finds a barcode before the 2D Readers run. + // 2. This work will only be done once even if the caller installs multiple 2D Readers. + if (this.matrix === null || this.matrix === undefined) { + this.matrix = this.binarizer.getBlackMatrix(); + } + return this.matrix; + } + /** + * @return Whether this bitmap can be cropped. + */ + isCropSupported() { + return this.binarizer.getLuminanceSource().isCropSupported(); + } + /** + * Returns a new object with cropped image data. Implementations may keep a reference to the + * original data rather than a copy. Only callable if isCropSupported() is true. + * + * @param left The left coordinate, which must be in [0,getWidth()) + * @param top The top coordinate, which must be in [0,getHeight()) + * @param width The width of the rectangle to crop. + * @param height The height of the rectangle to crop. + * @return A cropped version of this object. + */ + crop(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + const newSource = this.binarizer.getLuminanceSource().crop(left, top, width, height); + return new BinaryBitmap(this.binarizer.createBinarizer(newSource)); + } + /** + * @return Whether this bitmap supports counter-clockwise rotation. + */ + isRotateSupported() { + return this.binarizer.getLuminanceSource().isRotateSupported(); + } + /** + * Returns a new object with rotated image data by 90 degrees counterclockwise. + * Only callable if {@link #isRotateSupported()} is true. + * + * @return A rotated version of this object. + */ + rotateCounterClockwise() { + const newSource = this.binarizer.getLuminanceSource().rotateCounterClockwise(); + return new BinaryBitmap(this.binarizer.createBinarizer(newSource)); + } + /** + * Returns a new object with rotated image data by 45 degrees counterclockwise. + * Only callable if {@link #isRotateSupported()} is true. + * + * @return A rotated version of this object. + */ + rotateCounterClockwise45() { + const newSource = this.binarizer.getLuminanceSource().rotateCounterClockwise45(); + return new BinaryBitmap(this.binarizer.createBinarizer(newSource)); + } + /*@Override*/ + toString() { + try { + return this.getBlackMatrix().toString(); + } + catch (e /*: NotFoundException*/) { + return ''; + } + } + } + + /** + * Custom Error class of type Exception. + */ + class ChecksumException extends Exception { + static getChecksumInstance() { + return new ChecksumException(); + } + } + ChecksumException.kind = 'ChecksumException'; + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This class hierarchy provides a set of methods to convert luminance data to 1 bit data. + * It allows the algorithm to vary polymorphically, for example allowing a very expensive + * thresholding technique for servers and a fast one for mobile. It also permits the implementation + * to vary, e.g. a JNI version for Android and a Java fallback version for other platforms. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class Binarizer { + constructor(source) { + this.source = source; + } + getLuminanceSource() { + return this.source; + } + getWidth() { + return this.source.getWidth(); + } + getHeight() { + return this.source.getHeight(); + } + } + + class System { + // public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length) + /** + * Makes a copy of a array. + */ + static arraycopy(src, srcPos, dest, destPos, length) { + // TODO: better use split or set? + while (length--) { + dest[destPos++] = src[srcPos++]; + } + } + /** + * Returns the current time in milliseconds. + */ + static currentTimeMillis() { + return Date.now(); + } + } + + /** + * Custom Error class of type Exception. + */ + class IndexOutOfBoundsException extends Exception { + } + IndexOutOfBoundsException.kind = 'IndexOutOfBoundsException'; + + /** + * Custom Error class of type Exception. + */ + class ArrayIndexOutOfBoundsException extends IndexOutOfBoundsException { + constructor(index = undefined, message = undefined) { + super(message); + this.index = index; + this.message = message; + } + } + ArrayIndexOutOfBoundsException.kind = 'ArrayIndexOutOfBoundsException'; + + class Arrays { + /** + * Assigns the specified int value to each element of the specified array + * of ints. + * + * @param a the array to be filled + * @param val the value to be stored in all elements of the array + */ + static fill(a, val) { + for (let i = 0, len = a.length; i < len; i++) + a[i] = val; + } + /** + * Assigns the specified int value to each element of the specified + * range of the specified array of ints. The range to be filled + * extends from index {@code fromIndex}, inclusive, to index + * {@code toIndex}, exclusive. (If {@code fromIndex==toIndex}, the + * range to be filled is empty.) + * + * @param a the array to be filled + * @param fromIndex the index of the first element (inclusive) to be + * filled with the specified value + * @param toIndex the index of the last element (exclusive) to be + * filled with the specified value + * @param val the value to be stored in all elements of the array + * @throws IllegalArgumentException if {@code fromIndex > toIndex} + * @throws ArrayIndexOutOfBoundsException if {@code fromIndex < 0} or + * {@code toIndex > a.length} + */ + static fillWithin(a, fromIndex, toIndex, val) { + Arrays.rangeCheck(a.length, fromIndex, toIndex); + for (let i = fromIndex; i < toIndex; i++) + a[i] = val; + } + /** + * Checks that {@code fromIndex} and {@code toIndex} are in + * the range and throws an exception if they aren't. + */ + static rangeCheck(arrayLength, fromIndex, toIndex) { + if (fromIndex > toIndex) { + throw new IllegalArgumentException('fromIndex(' + fromIndex + ') > toIndex(' + toIndex + ')'); + } + if (fromIndex < 0) { + throw new ArrayIndexOutOfBoundsException(fromIndex); + } + if (toIndex > arrayLength) { + throw new ArrayIndexOutOfBoundsException(toIndex); + } + } + static asList(...args) { + return args; + } + static create(rows, cols, value) { + let arr = Array.from({ length: rows }); + return arr.map(x => Array.from({ length: cols }).fill(value)); + } + static createInt32Array(rows, cols, value) { + let arr = Array.from({ length: rows }); + return arr.map(x => Int32Array.from({ length: cols }).fill(value)); + } + static equals(first, second) { + if (!first) { + return false; + } + if (!second) { + return false; + } + if (!first.length) { + return false; + } + if (!second.length) { + return false; + } + if (first.length !== second.length) { + return false; + } + for (let i = 0, length = first.length; i < length; i++) { + if (first[i] !== second[i]) { + return false; + } + } + return true; + } + static hashCode(a) { + if (a === null) { + return 0; + } + let result = 1; + for (const element of a) { + result = 31 * result + element; + } + return result; + } + static fillUint8Array(a, value) { + for (let i = 0; i !== a.length; i++) { + a[i] = value; + } + } + static copyOf(original, newLength) { + return original.slice(0, newLength); + } + static copyOfUint8Array(original, newLength) { + if (original.length <= newLength) { + const newArray = new Uint8Array(newLength); + newArray.set(original); + return newArray; + } + return original.slice(0, newLength); + } + static copyOfRange(original, from, to) { + const newLength = to - from; + const copy = new Int32Array(newLength); + System.arraycopy(original, from, copy, 0, newLength); + return copy; + } + /* + * Returns the index of of the element in a sorted array or (-n-1) where n is the insertion point + * for the new element. + * Parameters: + * ar - A sorted array + * el - An element to search for + * comparator - A comparator function. The function takes two arguments: (a, b) and returns: + * a negative number if a is less than b; + * 0 if a is equal to b; + * a positive number of a is greater than b. + * The array may contain duplicate elements. If there are more than one equal elements in the array, + * the returned value can be the index of any one of the equal elements. + * + * http://jsfiddle.net/aryzhov/pkfst550/ + */ + static binarySearch(ar, el, comparator) { + if (undefined === comparator) { + comparator = Arrays.numberComparator; + } + let m = 0; + let n = ar.length - 1; + while (m <= n) { + const k = (n + m) >> 1; + const cmp = comparator(el, ar[k]); + if (cmp > 0) { + m = k + 1; + } + else if (cmp < 0) { + n = k - 1; + } + else { + return k; + } + } + return -m - 1; + } + static numberComparator(a, b) { + return a - b; + } + } + + /** + * Ponyfill for Java's Integer class. + */ + class Integer { + static numberOfTrailingZeros(i) { + let y; + if (i === 0) + return 32; + let n = 31; + y = i << 16; + if (y !== 0) { + n -= 16; + i = y; + } + y = i << 8; + if (y !== 0) { + n -= 8; + i = y; + } + y = i << 4; + if (y !== 0) { + n -= 4; + i = y; + } + y = i << 2; + if (y !== 0) { + n -= 2; + i = y; + } + return n - ((i << 1) >>> 31); + } + static numberOfLeadingZeros(i) { + // HD, Figure 5-6 + if (i === 0) { + return 32; + } + let n = 1; + if (i >>> 16 === 0) { + n += 16; + i <<= 16; + } + if (i >>> 24 === 0) { + n += 8; + i <<= 8; + } + if (i >>> 28 === 0) { + n += 4; + i <<= 4; + } + if (i >>> 30 === 0) { + n += 2; + i <<= 2; + } + n -= i >>> 31; + return n; + } + static toHexString(i) { + return i.toString(16); + } + static toBinaryString(intNumber) { + return String(parseInt(String(intNumber), 2)); + } + // Returns the number of one-bits in the two's complement binary representation of the specified int value. This function is sometimes referred to as the population count. + // Returns: + // the number of one-bits in the two's complement binary representation of the specified int value. + static bitCount(i) { + // HD, Figure 5-2 + i = i - ((i >>> 1) & 0x55555555); + i = (i & 0x33333333) + ((i >>> 2) & 0x33333333); + i = (i + (i >>> 4)) & 0x0f0f0f0f; + i = i + (i >>> 8); + i = i + (i >>> 16); + return i & 0x3f; + } + static truncDivision(dividend, divisor) { + return Math.trunc(dividend / divisor); + } + /** + * Converts A string to an integer. + * @param s A string to convert into a number. + * @param radix A value between 2 and 36 that specifies the base of the number in numString. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal. + */ + static parseInt(num, radix = undefined) { + return parseInt(num, radix); + } + } + Integer.MIN_VALUE_32_BITS = -2147483648; + Integer.MAX_VALUE = Number.MAX_SAFE_INTEGER; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

A simple, fast array of bits, represented compactly by an array of ints internally.

+ * + * @author Sean Owen + */ + class BitArray /*implements Cloneable*/ { + // public constructor() { + // this.size = 0 + // this.bits = new Int32Array(1) + // } + // public constructor(size?: number /*int*/) { + // if (undefined === size) { + // this.size = 0 + // } else { + // this.size = size + // } + // this.bits = this.makeArray(size) + // } + // For testing only + constructor(size /*int*/, bits) { + if (undefined === size) { + this.size = 0; + this.bits = new Int32Array(1); + } + else { + this.size = size; + if (undefined === bits || null === bits) { + this.bits = BitArray.makeArray(size); + } + else { + this.bits = bits; + } + } + } + getSize() { + return this.size; + } + getSizeInBytes() { + return Math.floor((this.size + 7) / 8); + } + ensureCapacity(size /*int*/) { + if (size > this.bits.length * 32) { + const newBits = BitArray.makeArray(size); + System.arraycopy(this.bits, 0, newBits, 0, this.bits.length); + this.bits = newBits; + } + } + /** + * @param i bit to get + * @return true iff bit i is set + */ + get(i /*int*/) { + return (this.bits[Math.floor(i / 32)] & (1 << (i & 0x1F))) !== 0; + } + /** + * Sets bit i. + * + * @param i bit to set + */ + set(i /*int*/) { + this.bits[Math.floor(i / 32)] |= 1 << (i & 0x1F); + } + /** + * Flips bit i. + * + * @param i bit to set + */ + flip(i /*int*/) { + this.bits[Math.floor(i / 32)] ^= 1 << (i & 0x1F); + } + /** + * @param from first bit to check + * @return index of first bit that is set, starting from the given index, or size if none are set + * at or beyond this given index + * @see #getNextUnset(int) + */ + getNextSet(from /*int*/) { + const size = this.size; + if (from >= size) { + return size; + } + const bits = this.bits; + let bitsOffset = Math.floor(from / 32); + let currentBits = bits[bitsOffset]; + // mask off lesser bits first + currentBits &= ~((1 << (from & 0x1F)) - 1); + const length = bits.length; + while (currentBits === 0) { + if (++bitsOffset === length) { + return size; + } + currentBits = bits[bitsOffset]; + } + const result = (bitsOffset * 32) + Integer.numberOfTrailingZeros(currentBits); + return result > size ? size : result; + } + /** + * @param from index to start looking for unset bit + * @return index of next unset bit, or {@code size} if none are unset until the end + * @see #getNextSet(int) + */ + getNextUnset(from /*int*/) { + const size = this.size; + if (from >= size) { + return size; + } + const bits = this.bits; + let bitsOffset = Math.floor(from / 32); + let currentBits = ~bits[bitsOffset]; + // mask off lesser bits first + currentBits &= ~((1 << (from & 0x1F)) - 1); + const length = bits.length; + while (currentBits === 0) { + if (++bitsOffset === length) { + return size; + } + currentBits = ~bits[bitsOffset]; + } + const result = (bitsOffset * 32) + Integer.numberOfTrailingZeros(currentBits); + return result > size ? size : result; + } + /** + * Sets a block of 32 bits, starting at bit i. + * + * @param i first bit to set + * @param newBits the new value of the next 32 bits. Note again that the least-significant bit + * corresponds to bit i, the next-least-significant to i+1, and so on. + */ + setBulk(i /*int*/, newBits /*int*/) { + this.bits[Math.floor(i / 32)] = newBits; + } + /** + * Sets a range of bits. + * + * @param start start of range, inclusive. + * @param end end of range, exclusive + */ + setRange(start /*int*/, end /*int*/) { + if (end < start || start < 0 || end > this.size) { + throw new IllegalArgumentException(); + } + if (end === start) { + return; + } + end--; // will be easier to treat this as the last actually set bit -- inclusive + const firstInt = Math.floor(start / 32); + const lastInt = Math.floor(end / 32); + const bits = this.bits; + for (let i = firstInt; i <= lastInt; i++) { + const firstBit = i > firstInt ? 0 : start & 0x1F; + const lastBit = i < lastInt ? 31 : end & 0x1F; + // Ones from firstBit to lastBit, inclusive + const mask = (2 << lastBit) - (1 << firstBit); + bits[i] |= mask; + } + } + /** + * Clears all bits (sets to false). + */ + clear() { + const max = this.bits.length; + const bits = this.bits; + for (let i = 0; i < max; i++) { + bits[i] = 0; + } + } + /** + * Efficient method to check if a range of bits is set, or not set. + * + * @param start start of range, inclusive. + * @param end end of range, exclusive + * @param value if true, checks that bits in range are set, otherwise checks that they are not set + * @return true iff all bits are set or not set in range, according to value argument + * @throws IllegalArgumentException if end is less than start or the range is not contained in the array + */ + isRange(start /*int*/, end /*int*/, value) { + if (end < start || start < 0 || end > this.size) { + throw new IllegalArgumentException(); + } + if (end === start) { + return true; // empty range matches + } + end--; // will be easier to treat this as the last actually set bit -- inclusive + const firstInt = Math.floor(start / 32); + const lastInt = Math.floor(end / 32); + const bits = this.bits; + for (let i = firstInt; i <= lastInt; i++) { + const firstBit = i > firstInt ? 0 : start & 0x1F; + const lastBit = i < lastInt ? 31 : end & 0x1F; + // Ones from firstBit to lastBit, inclusive + const mask = (2 << lastBit) - (1 << firstBit) & 0xFFFFFFFF; + // TYPESCRIPTPORT: & 0xFFFFFFFF added to discard anything after 32 bits, as ES has 53 bits + // Return false if we're looking for 1s and the masked bits[i] isn't all 1s (is: that, + // equals the mask, or we're looking for 0s and the masked portion is not all 0s + if ((bits[i] & mask) !== (value ? mask : 0)) { + return false; + } + } + return true; + } + appendBit(bit) { + this.ensureCapacity(this.size + 1); + if (bit) { + this.bits[Math.floor(this.size / 32)] |= 1 << (this.size & 0x1F); + } + this.size++; + } + /** + * Appends the least-significant bits, from value, in order from most-significant to + * least-significant. For example, appending 6 bits from 0x000001E will append the bits + * 0, 1, 1, 1, 1, 0 in that order. + * + * @param value {@code int} containing bits to append + * @param numBits bits from value to append + */ + appendBits(value /*int*/, numBits /*int*/) { + if (numBits < 0 || numBits > 32) { + throw new IllegalArgumentException('Num bits must be between 0 and 32'); + } + this.ensureCapacity(this.size + numBits); + // const appendBit = this.appendBit; + for (let numBitsLeft = numBits; numBitsLeft > 0; numBitsLeft--) { + this.appendBit(((value >> (numBitsLeft - 1)) & 0x01) === 1); + } + } + appendBitArray(other) { + const otherSize = other.size; + this.ensureCapacity(this.size + otherSize); + // const appendBit = this.appendBit; + for (let i = 0; i < otherSize; i++) { + this.appendBit(other.get(i)); + } + } + xor(other) { + if (this.size !== other.size) { + throw new IllegalArgumentException('Sizes don\'t match'); + } + const bits = this.bits; + for (let i = 0, length = bits.length; i < length; i++) { + // The last int could be incomplete (i.e. not have 32 bits in + // it) but there is no problem since 0 XOR 0 == 0. + bits[i] ^= other.bits[i]; + } + } + /** + * + * @param bitOffset first bit to start writing + * @param array array to write into. Bytes are written most-significant byte first. This is the opposite + * of the internal representation, which is exposed by {@link #getBitArray()} + * @param offset position in array to start writing + * @param numBytes how many bytes to write + */ + toBytes(bitOffset /*int*/, array, offset /*int*/, numBytes /*int*/) { + for (let i = 0; i < numBytes; i++) { + let theByte = 0; + for (let j = 0; j < 8; j++) { + if (this.get(bitOffset)) { + theByte |= 1 << (7 - j); + } + bitOffset++; + } + array[offset + i] = /*(byte)*/ theByte; + } + } + /** + * @return underlying array of ints. The first element holds the first 32 bits, and the least + * significant bit is bit 0. + */ + getBitArray() { + return this.bits; + } + /** + * Reverses all bits in the array. + */ + reverse() { + const newBits = new Int32Array(this.bits.length); + // reverse all int's first + const len = Math.floor((this.size - 1) / 32); + const oldBitsLen = len + 1; + const bits = this.bits; + for (let i = 0; i < oldBitsLen; i++) { + let x = bits[i]; + x = ((x >> 1) & 0x55555555) | ((x & 0x55555555) << 1); + x = ((x >> 2) & 0x33333333) | ((x & 0x33333333) << 2); + x = ((x >> 4) & 0x0f0f0f0f) | ((x & 0x0f0f0f0f) << 4); + x = ((x >> 8) & 0x00ff00ff) | ((x & 0x00ff00ff) << 8); + x = ((x >> 16) & 0x0000ffff) | ((x & 0x0000ffff) << 16); + newBits[len - i] = /*(int)*/ x; + } + // now correct the int's if the bit size isn't a multiple of 32 + if (this.size !== oldBitsLen * 32) { + const leftOffset = oldBitsLen * 32 - this.size; + let currentInt = newBits[0] >>> leftOffset; + for (let i = 1; i < oldBitsLen; i++) { + const nextInt = newBits[i]; + currentInt |= nextInt << (32 - leftOffset); + newBits[i - 1] = currentInt; + currentInt = nextInt >>> leftOffset; + } + newBits[oldBitsLen - 1] = currentInt; + } + this.bits = newBits; + } + static makeArray(size /*int*/) { + return new Int32Array(Math.floor((size + 31) / 32)); + } + /*@Override*/ + equals(o) { + if (!(o instanceof BitArray)) { + return false; + } + const other = o; + return this.size === other.size && Arrays.equals(this.bits, other.bits); + } + /*@Override*/ + hashCode() { + return 31 * this.size + Arrays.hashCode(this.bits); + } + /*@Override*/ + toString() { + let result = ''; + for (let i = 0, size = this.size; i < size; i++) { + if ((i & 0x07) === 0) { + result += ' '; + } + result += this.get(i) ? 'X' : '.'; + } + return result; + } + /*@Override*/ + clone() { + return new BitArray(this.size, this.bits.slice()); + } + } + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * Encapsulates a type of hint that a caller may pass to a barcode reader to help it + * more quickly or accurately decode it. It is up to implementations to decide what, + * if anything, to do with the information that is supplied. + * + * @author Sean Owen + * @author dswitkin@google.com (Daniel Switkin) + * @see Reader#decode(BinaryBitmap,java.util.Map) + */ + var DecodeHintType; + (function (DecodeHintType) { + /** + * Unspecified, application-specific hint. Maps to an unspecified {@link Object}. + */ + DecodeHintType[DecodeHintType["OTHER"] = 0] = "OTHER"; /*(Object.class)*/ + /** + * Image is a pure monochrome image of a barcode. Doesn't matter what it maps to; + * use {@link Boolean#TRUE}. + */ + DecodeHintType[DecodeHintType["PURE_BARCODE"] = 1] = "PURE_BARCODE"; /*(Void.class)*/ + /** + * Image is known to be of one of a few possible formats. + * Maps to a {@link List} of {@link BarcodeFormat}s. + */ + DecodeHintType[DecodeHintType["POSSIBLE_FORMATS"] = 2] = "POSSIBLE_FORMATS"; /*(List.class)*/ + /** + * Spend more time to try to find a barcode; optimize for accuracy, not speed. + * Doesn't matter what it maps to; use {@link Boolean#TRUE}. + */ + DecodeHintType[DecodeHintType["TRY_HARDER"] = 3] = "TRY_HARDER"; /*(Void.class)*/ + /** + * Specifies what character encoding to use when decoding, where applicable (type String) + */ + DecodeHintType[DecodeHintType["CHARACTER_SET"] = 4] = "CHARACTER_SET"; /*(String.class)*/ + /** + * Allowed lengths of encoded data -- reject anything else. Maps to an {@code Int32Array}. + */ + DecodeHintType[DecodeHintType["ALLOWED_LENGTHS"] = 5] = "ALLOWED_LENGTHS"; /*(Int32Array.class)*/ + /** + * Assume Code 39 codes employ a check digit. Doesn't matter what it maps to; + * use {@link Boolean#TRUE}. + */ + DecodeHintType[DecodeHintType["ASSUME_CODE_39_CHECK_DIGIT"] = 6] = "ASSUME_CODE_39_CHECK_DIGIT"; /*(Void.class)*/ + /** + * Assume the barcode is being processed as a GS1 barcode, and modify behavior as needed. + * For example this affects FNC1 handling for Code 128 (aka GS1-128). Doesn't matter what it maps to; + * use {@link Boolean#TRUE}. + */ + DecodeHintType[DecodeHintType["ASSUME_GS1"] = 7] = "ASSUME_GS1"; /*(Void.class)*/ + /** + * If true, return the start and end digits in a Codabar barcode instead of stripping them. They + * are alpha, whereas the rest are numeric. By default, they are stripped, but this causes them + * to not be. Doesn't matter what it maps to; use {@link Boolean#TRUE}. + */ + DecodeHintType[DecodeHintType["RETURN_CODABAR_START_END"] = 8] = "RETURN_CODABAR_START_END"; /*(Void.class)*/ + /** + * The caller needs to be notified via callback when a possible {@link ResultPoint} + * is found. Maps to a {@link ResultPointCallback}. + */ + DecodeHintType[DecodeHintType["NEED_RESULT_POINT_CALLBACK"] = 9] = "NEED_RESULT_POINT_CALLBACK"; /*(ResultPointCallback.class)*/ + /** + * Allowed extension lengths for EAN or UPC barcodes. Other formats will ignore this. + * Maps to an {@code Int32Array} of the allowed extension lengths, for example [2], [5], or [2, 5]. + * If it is optional to have an extension, do not set this hint. If this is set, + * and a UPC or EAN barcode is found but an extension is not, then no result will be returned + * at all. + */ + DecodeHintType[DecodeHintType["ALLOWED_EAN_EXTENSIONS"] = 10] = "ALLOWED_EAN_EXTENSIONS"; /*(Int32Array.class)*/ + // End of enumeration values. + /** + * Data type the hint is expecting. + * Among the possible values the {@link Void} stands out as being used for + * hints that do not expect a value to be supplied (flag hints). Such hints + * will possibly have their value ignored, or replaced by a + * {@link Boolean#TRUE}. Hint suppliers should probably use + * {@link Boolean#TRUE} as directed by the actual hint documentation. + */ + // private valueType: Class + // DecodeHintType(valueType: Class) { + // this.valueType = valueType + // } + // public getValueType(): Class { + // return valueType + // } + })(DecodeHintType || (DecodeHintType = {})); + var DecodeHintType$1 = DecodeHintType; + + /** + * Custom Error class of type Exception. + */ + class FormatException extends Exception { + static getFormatInstance() { + return new FormatException(); + } + } + FormatException.kind = 'FormatException'; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.HashMap;*/ + /*import java.util.Map;*/ + var CharacterSetValueIdentifiers; + (function (CharacterSetValueIdentifiers) { + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["Cp437"] = 0] = "Cp437"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_1"] = 1] = "ISO8859_1"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_2"] = 2] = "ISO8859_2"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_3"] = 3] = "ISO8859_3"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_4"] = 4] = "ISO8859_4"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_5"] = 5] = "ISO8859_5"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_6"] = 6] = "ISO8859_6"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_7"] = 7] = "ISO8859_7"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_8"] = 8] = "ISO8859_8"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_9"] = 9] = "ISO8859_9"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_10"] = 10] = "ISO8859_10"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_11"] = 11] = "ISO8859_11"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_13"] = 12] = "ISO8859_13"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_14"] = 13] = "ISO8859_14"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_15"] = 14] = "ISO8859_15"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ISO8859_16"] = 15] = "ISO8859_16"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["SJIS"] = 16] = "SJIS"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["Cp1250"] = 17] = "Cp1250"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["Cp1251"] = 18] = "Cp1251"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["Cp1252"] = 19] = "Cp1252"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["Cp1256"] = 20] = "Cp1256"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["UnicodeBigUnmarked"] = 21] = "UnicodeBigUnmarked"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["UTF8"] = 22] = "UTF8"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["ASCII"] = 23] = "ASCII"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["Big5"] = 24] = "Big5"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["GB18030"] = 25] = "GB18030"; + CharacterSetValueIdentifiers[CharacterSetValueIdentifiers["EUC_KR"] = 26] = "EUC_KR"; + })(CharacterSetValueIdentifiers || (CharacterSetValueIdentifiers = {})); + /** + * Encapsulates a Character Set ECI, according to "Extended Channel Interpretations" 5.3.1.1 + * of ISO 18004. + * + * @author Sean Owen + */ + class CharacterSetECI { + constructor(valueIdentifier, valuesParam, name, ...otherEncodingNames) { + this.valueIdentifier = valueIdentifier; + this.name = name; + if (typeof valuesParam === 'number') { + this.values = Int32Array.from([valuesParam]); + } + else { + this.values = valuesParam; + } + this.otherEncodingNames = otherEncodingNames; + CharacterSetECI.VALUE_IDENTIFIER_TO_ECI.set(valueIdentifier, this); + CharacterSetECI.NAME_TO_ECI.set(name, this); + const values = this.values; + for (let i = 0, length = values.length; i !== length; i++) { + const v = values[i]; + CharacterSetECI.VALUES_TO_ECI.set(v, this); + } + for (const otherName of otherEncodingNames) { + CharacterSetECI.NAME_TO_ECI.set(otherName, this); + } + } + // CharacterSetECI(value: number /*int*/) { + // this(new Int32Array {value}) + // } + // CharacterSetECI(value: number /*int*/, String... otherEncodingNames) { + // this.values = new Int32Array {value} + // this.otherEncodingNames = otherEncodingNames + // } + // CharacterSetECI(values: Int32Array, String... otherEncodingNames) { + // this.values = values + // this.otherEncodingNames = otherEncodingNames + // } + getValueIdentifier() { + return this.valueIdentifier; + } + getName() { + return this.name; + } + getValue() { + return this.values[0]; + } + /** + * @param value character set ECI value + * @return {@code CharacterSetECI} representing ECI of given value, or null if it is legal but + * unsupported + * @throws FormatException if ECI value is invalid + */ + static getCharacterSetECIByValue(value /*int*/) { + if (value < 0 || value >= 900) { + throw new FormatException('incorect value'); + } + const characterSet = CharacterSetECI.VALUES_TO_ECI.get(value); + if (undefined === characterSet) { + throw new FormatException('incorect value'); + } + return characterSet; + } + /** + * @param name character set ECI encoding name + * @return CharacterSetECI representing ECI for character encoding, or null if it is legal + * but unsupported + */ + static getCharacterSetECIByName(name) { + const characterSet = CharacterSetECI.NAME_TO_ECI.get(name); + if (undefined === characterSet) { + throw new FormatException('incorect value'); + } + return characterSet; + } + equals(o) { + if (!(o instanceof CharacterSetECI)) { + return false; + } + const other = o; + return this.getName() === other.getName(); + } + } + CharacterSetECI.VALUE_IDENTIFIER_TO_ECI = new Map(); + CharacterSetECI.VALUES_TO_ECI = new Map(); + CharacterSetECI.NAME_TO_ECI = new Map(); + // Enum name is a Java encoding valid for java.lang and java.io + // TYPESCRIPTPORT: changed the main label for ISO as the TextEncoder did not recognized them in the form from java + // (eg ISO8859_1 must be ISO88591 or ISO8859-1 or ISO-8859-1) + // later on: well, except 16 wich does not work with ISO885916 so used ISO-8859-1 form for default + CharacterSetECI.Cp437 = new CharacterSetECI(CharacterSetValueIdentifiers.Cp437, Int32Array.from([0, 2]), 'Cp437'); + CharacterSetECI.ISO8859_1 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_1, Int32Array.from([1, 3]), 'ISO-8859-1', 'ISO88591', 'ISO8859_1'); + CharacterSetECI.ISO8859_2 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_2, 4, 'ISO-8859-2', 'ISO88592', 'ISO8859_2'); + CharacterSetECI.ISO8859_3 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_3, 5, 'ISO-8859-3', 'ISO88593', 'ISO8859_3'); + CharacterSetECI.ISO8859_4 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_4, 6, 'ISO-8859-4', 'ISO88594', 'ISO8859_4'); + CharacterSetECI.ISO8859_5 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_5, 7, 'ISO-8859-5', 'ISO88595', 'ISO8859_5'); + CharacterSetECI.ISO8859_6 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_6, 8, 'ISO-8859-6', 'ISO88596', 'ISO8859_6'); + CharacterSetECI.ISO8859_7 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_7, 9, 'ISO-8859-7', 'ISO88597', 'ISO8859_7'); + CharacterSetECI.ISO8859_8 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_8, 10, 'ISO-8859-8', 'ISO88598', 'ISO8859_8'); + CharacterSetECI.ISO8859_9 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_9, 11, 'ISO-8859-9', 'ISO88599', 'ISO8859_9'); + CharacterSetECI.ISO8859_10 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_10, 12, 'ISO-8859-10', 'ISO885910', 'ISO8859_10'); + CharacterSetECI.ISO8859_11 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_11, 13, 'ISO-8859-11', 'ISO885911', 'ISO8859_11'); + CharacterSetECI.ISO8859_13 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_13, 15, 'ISO-8859-13', 'ISO885913', 'ISO8859_13'); + CharacterSetECI.ISO8859_14 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_14, 16, 'ISO-8859-14', 'ISO885914', 'ISO8859_14'); + CharacterSetECI.ISO8859_15 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_15, 17, 'ISO-8859-15', 'ISO885915', 'ISO8859_15'); + CharacterSetECI.ISO8859_16 = new CharacterSetECI(CharacterSetValueIdentifiers.ISO8859_16, 18, 'ISO-8859-16', 'ISO885916', 'ISO8859_16'); + CharacterSetECI.SJIS = new CharacterSetECI(CharacterSetValueIdentifiers.SJIS, 20, 'SJIS', 'Shift_JIS'); + CharacterSetECI.Cp1250 = new CharacterSetECI(CharacterSetValueIdentifiers.Cp1250, 21, 'Cp1250', 'windows-1250'); + CharacterSetECI.Cp1251 = new CharacterSetECI(CharacterSetValueIdentifiers.Cp1251, 22, 'Cp1251', 'windows-1251'); + CharacterSetECI.Cp1252 = new CharacterSetECI(CharacterSetValueIdentifiers.Cp1252, 23, 'Cp1252', 'windows-1252'); + CharacterSetECI.Cp1256 = new CharacterSetECI(CharacterSetValueIdentifiers.Cp1256, 24, 'Cp1256', 'windows-1256'); + CharacterSetECI.UnicodeBigUnmarked = new CharacterSetECI(CharacterSetValueIdentifiers.UnicodeBigUnmarked, 25, 'UnicodeBigUnmarked', 'UTF-16BE', 'UnicodeBig'); + CharacterSetECI.UTF8 = new CharacterSetECI(CharacterSetValueIdentifiers.UTF8, 26, 'UTF8', 'UTF-8'); + CharacterSetECI.ASCII = new CharacterSetECI(CharacterSetValueIdentifiers.ASCII, Int32Array.from([27, 170]), 'ASCII', 'US-ASCII'); + CharacterSetECI.Big5 = new CharacterSetECI(CharacterSetValueIdentifiers.Big5, 28, 'Big5'); + CharacterSetECI.GB18030 = new CharacterSetECI(CharacterSetValueIdentifiers.GB18030, 29, 'GB18030', 'GB2312', 'EUC_CN', 'GBK'); + CharacterSetECI.EUC_KR = new CharacterSetECI(CharacterSetValueIdentifiers.EUC_KR, 30, 'EUC_KR', 'EUC-KR'); + + /** + * Custom Error class of type Exception. + */ + class UnsupportedOperationException extends Exception { + } + UnsupportedOperationException.kind = 'UnsupportedOperationException'; + + /** + * Responsible for en/decoding strings. + */ + class StringEncoding { + /** + * Decodes some Uint8Array to a string format. + */ + static decode(bytes, encoding) { + const encodingName = this.encodingName(encoding); + if (this.customDecoder) { + return this.customDecoder(bytes, encodingName); + } + // Increases browser support. + if (typeof TextDecoder === 'undefined' || this.shouldDecodeOnFallback(encodingName)) { + return this.decodeFallback(bytes, encodingName); + } + return new TextDecoder(encodingName).decode(bytes); + } + /** + * Checks if the decoding method should use the fallback for decoding + * once Node TextDecoder doesn't support all encoding formats. + * + * @param encodingName + */ + static shouldDecodeOnFallback(encodingName) { + return !StringEncoding.isBrowser() && encodingName === 'ISO-8859-1'; + } + /** + * Encodes some string into a Uint8Array. + */ + static encode(s, encoding) { + const encodingName = this.encodingName(encoding); + if (this.customEncoder) { + return this.customEncoder(s, encodingName); + } + // Increases browser support. + if (typeof TextEncoder === 'undefined') { + return this.encodeFallback(s); + } + // TextEncoder only encodes to UTF8 by default as specified by encoding.spec.whatwg.org + return new TextEncoder().encode(s); + } + static isBrowser() { + return (typeof window !== 'undefined' && {}.toString.call(window) === '[object Window]'); + } + /** + * Returns the string value from some encoding character set. + */ + static encodingName(encoding) { + return typeof encoding === 'string' + ? encoding + : encoding.getName(); + } + /** + * Returns character set from some encoding character set. + */ + static encodingCharacterSet(encoding) { + if (encoding instanceof CharacterSetECI) { + return encoding; + } + return CharacterSetECI.getCharacterSetECIByName(encoding); + } + /** + * Runs a fallback for the native decoding funcion. + */ + static decodeFallback(bytes, encoding) { + const characterSet = this.encodingCharacterSet(encoding); + if (StringEncoding.isDecodeFallbackSupported(characterSet)) { + let s = ''; + for (let i = 0, length = bytes.length; i < length; i++) { + let h = bytes[i].toString(16); + if (h.length < 2) { + h = '0' + h; + } + s += '%' + h; + } + return decodeURIComponent(s); + } + if (characterSet.equals(CharacterSetECI.UnicodeBigUnmarked)) { + return String.fromCharCode.apply(null, new Uint16Array(bytes.buffer)); + } + throw new UnsupportedOperationException(`Encoding ${this.encodingName(encoding)} not supported by fallback.`); + } + static isDecodeFallbackSupported(characterSet) { + return characterSet.equals(CharacterSetECI.UTF8) || + characterSet.equals(CharacterSetECI.ISO8859_1) || + characterSet.equals(CharacterSetECI.ASCII); + } + /** + * Runs a fallback for the native encoding funcion. + * + * @see https://stackoverflow.com/a/17192845/4367683 + */ + static encodeFallback(s) { + const encodedURIstring = btoa(unescape(encodeURIComponent(s))); + const charList = encodedURIstring.split(''); + const uintArray = []; + for (let i = 0; i < charList.length; i++) { + uintArray.push(charList[i].charCodeAt(0)); + } + return new Uint8Array(uintArray); + } + } + + /* + * Copyright (C) 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Common string-related functions. + * + * @author Sean Owen + * @author Alex Dupre + */ + class StringUtils { + // SHIFT_JIS.equalsIgnoreCase(PLATFORM_DEFAULT_ENCODING) || + // EUC_JP.equalsIgnoreCase(PLATFORM_DEFAULT_ENCODING); + static castAsNonUtf8Char(code, encoding = null) { + // ISO 8859-1 is the Java default as UTF-8 is JavaScripts + // you can see this method as a Java version of String.fromCharCode + const e = encoding ? encoding.getName() : this.ISO88591; + // use passed format (fromCharCode will return UTF8 encoding) + return StringEncoding.decode(new Uint8Array([code]), e); + } + /** + * @param bytes bytes encoding a string, whose encoding should be guessed + * @param hints decode hints if applicable + * @return name of guessed encoding; at the moment will only guess one of: + * {@link #SHIFT_JIS}, {@link #UTF8}, {@link #ISO88591}, or the platform + * default encoding if none of these can possibly be correct + */ + static guessEncoding(bytes, hints) { + if (hints !== null && hints !== undefined && undefined !== hints.get(DecodeHintType$1.CHARACTER_SET)) { + return hints.get(DecodeHintType$1.CHARACTER_SET).toString(); + } + // For now, merely tries to distinguish ISO-8859-1, UTF-8 and Shift_JIS, + // which should be by far the most common encodings. + const length = bytes.length; + let canBeISO88591 = true; + let canBeShiftJIS = true; + let canBeUTF8 = true; + let utf8BytesLeft = 0; + // int utf8LowChars = 0 + let utf2BytesChars = 0; + let utf3BytesChars = 0; + let utf4BytesChars = 0; + let sjisBytesLeft = 0; + // int sjisLowChars = 0 + let sjisKatakanaChars = 0; + // int sjisDoubleBytesChars = 0 + let sjisCurKatakanaWordLength = 0; + let sjisCurDoubleBytesWordLength = 0; + let sjisMaxKatakanaWordLength = 0; + let sjisMaxDoubleBytesWordLength = 0; + // int isoLowChars = 0 + // int isoHighChars = 0 + let isoHighOther = 0; + const utf8bom = bytes.length > 3 && + bytes[0] === /*(byte) */ 0xEF && + bytes[1] === /*(byte) */ 0xBB && + bytes[2] === /*(byte) */ 0xBF; + for (let i = 0; i < length && (canBeISO88591 || canBeShiftJIS || canBeUTF8); i++) { + const value = bytes[i] & 0xFF; + // UTF-8 stuff + if (canBeUTF8) { + if (utf8BytesLeft > 0) { + if ((value & 0x80) === 0) { + canBeUTF8 = false; + } + else { + utf8BytesLeft--; + } + } + else if ((value & 0x80) !== 0) { + if ((value & 0x40) === 0) { + canBeUTF8 = false; + } + else { + utf8BytesLeft++; + if ((value & 0x20) === 0) { + utf2BytesChars++; + } + else { + utf8BytesLeft++; + if ((value & 0x10) === 0) { + utf3BytesChars++; + } + else { + utf8BytesLeft++; + if ((value & 0x08) === 0) { + utf4BytesChars++; + } + else { + canBeUTF8 = false; + } + } + } + } + } // else { + // utf8LowChars++ + // } + } + // ISO-8859-1 stuff + if (canBeISO88591) { + if (value > 0x7F && value < 0xA0) { + canBeISO88591 = false; + } + else if (value > 0x9F) { + if (value < 0xC0 || value === 0xD7 || value === 0xF7) { + isoHighOther++; + } // else { + // isoHighChars++ + // } + } // else { + // isoLowChars++ + // } + } + // Shift_JIS stuff + if (canBeShiftJIS) { + if (sjisBytesLeft > 0) { + if (value < 0x40 || value === 0x7F || value > 0xFC) { + canBeShiftJIS = false; + } + else { + sjisBytesLeft--; + } + } + else if (value === 0x80 || value === 0xA0 || value > 0xEF) { + canBeShiftJIS = false; + } + else if (value > 0xA0 && value < 0xE0) { + sjisKatakanaChars++; + sjisCurDoubleBytesWordLength = 0; + sjisCurKatakanaWordLength++; + if (sjisCurKatakanaWordLength > sjisMaxKatakanaWordLength) { + sjisMaxKatakanaWordLength = sjisCurKatakanaWordLength; + } + } + else if (value > 0x7F) { + sjisBytesLeft++; + // sjisDoubleBytesChars++ + sjisCurKatakanaWordLength = 0; + sjisCurDoubleBytesWordLength++; + if (sjisCurDoubleBytesWordLength > sjisMaxDoubleBytesWordLength) { + sjisMaxDoubleBytesWordLength = sjisCurDoubleBytesWordLength; + } + } + else { + // sjisLowChars++ + sjisCurKatakanaWordLength = 0; + sjisCurDoubleBytesWordLength = 0; + } + } + } + if (canBeUTF8 && utf8BytesLeft > 0) { + canBeUTF8 = false; + } + if (canBeShiftJIS && sjisBytesLeft > 0) { + canBeShiftJIS = false; + } + // Easy -- if there is BOM or at least 1 valid not-single byte character (and no evidence it can't be UTF-8), done + if (canBeUTF8 && (utf8bom || utf2BytesChars + utf3BytesChars + utf4BytesChars > 0)) { + return StringUtils.UTF8; + } + // Easy -- if assuming Shift_JIS or at least 3 valid consecutive not-ascii characters (and no evidence it can't be), done + if (canBeShiftJIS && (StringUtils.ASSUME_SHIFT_JIS || sjisMaxKatakanaWordLength >= 3 || sjisMaxDoubleBytesWordLength >= 3)) { + return StringUtils.SHIFT_JIS; + } + // Distinguishing Shift_JIS and ISO-8859-1 can be a little tough for short words. The crude heuristic is: + // - If we saw + // - only two consecutive katakana chars in the whole text, or + // - at least 10% of bytes that could be "upper" not-alphanumeric Latin1, + // - then we conclude Shift_JIS, else ISO-8859-1 + if (canBeISO88591 && canBeShiftJIS) { + return (sjisMaxKatakanaWordLength === 2 && sjisKatakanaChars === 2) || isoHighOther * 10 >= length + ? StringUtils.SHIFT_JIS : StringUtils.ISO88591; + } + // Otherwise, try in order ISO-8859-1, Shift JIS, UTF-8 and fall back to default platform encoding + if (canBeISO88591) { + return StringUtils.ISO88591; + } + if (canBeShiftJIS) { + return StringUtils.SHIFT_JIS; + } + if (canBeUTF8) { + return StringUtils.UTF8; + } + // Otherwise, we take a wild guess with platform encoding + return StringUtils.PLATFORM_DEFAULT_ENCODING; + } + /** + * + * @see https://stackoverflow.com/a/13439711/4367683 + * + * @param append The new string to append. + * @param args Argumets values to be formated. + */ + static format(append, ...args) { + let i = -1; + function callback(exp, p0, p1, p2, p3, p4) { + if (exp === '%%') + return '%'; + if (args[++i] === undefined) + return undefined; + exp = p2 ? parseInt(p2.substr(1)) : undefined; + let base = p3 ? parseInt(p3.substr(1)) : undefined; + let val; + switch (p4) { + case 's': + val = args[i]; + break; + case 'c': + val = args[i][0]; + break; + case 'f': + val = parseFloat(args[i]).toFixed(exp); + break; + case 'p': + val = parseFloat(args[i]).toPrecision(exp); + break; + case 'e': + val = parseFloat(args[i]).toExponential(exp); + break; + case 'x': + val = parseInt(args[i]).toString(base ? base : 16); + break; + case 'd': + val = parseFloat(parseInt(args[i], base ? base : 10).toPrecision(exp)).toFixed(0); + break; + } + val = typeof val === 'object' ? JSON.stringify(val) : (+val).toString(base); + let size = parseInt(p1); /* padding size */ + let ch = p1 && (p1[0] + '') === '0' ? '0' : ' '; /* isnull? */ + while (val.length < size) + val = p0 !== undefined ? val + ch : ch + val; /* isminus? */ + return val; + } + let regex = /%(-)?(0?[0-9]+)?([.][0-9]+)?([#][0-9]+)?([scfpexd%])/g; + return append.replace(regex, callback); + } + /** + * + */ + static getBytes(str, encoding) { + return StringEncoding.encode(str, encoding); + } + /** + * Returns the charcode at the specified index or at index zero. + */ + static getCharCode(str, index = 0) { + return str.charCodeAt(index); + } + /** + * Returns char for given charcode + */ + static getCharAt(charCode) { + return String.fromCharCode(charCode); + } + } + StringUtils.SHIFT_JIS = CharacterSetECI.SJIS.getName(); // "SJIS" + StringUtils.GB2312 = 'GB2312'; + StringUtils.ISO88591 = CharacterSetECI.ISO8859_1.getName(); // "ISO8859_1" + StringUtils.EUC_JP = 'EUC_JP'; + StringUtils.UTF8 = CharacterSetECI.UTF8.getName(); // "UTF8" + StringUtils.PLATFORM_DEFAULT_ENCODING = StringUtils.UTF8; // "UTF8"//Charset.defaultCharset().name() + StringUtils.ASSUME_SHIFT_JIS = false; + + class StringBuilder { + constructor(value = '') { + this.value = value; + } + enableDecoding(encoding) { + this.encoding = encoding; + return this; + } + append(s) { + if (typeof s === 'string') { + this.value += s.toString(); + } + else if (this.encoding) { + // use passed format (fromCharCode will return UTF8 encoding) + this.value += StringUtils.castAsNonUtf8Char(s, this.encoding); + } + else { + // correctly converts from UTF-8, but not other encodings + this.value += String.fromCharCode(s); + } + return this; + } + appendChars(str, offset, len) { + for (let i = offset; offset < offset + len; i++) { + this.append(str[i]); + } + return this; + } + length() { + return this.value.length; + } + charAt(n) { + return this.value.charAt(n); + } + deleteCharAt(n) { + this.value = this.value.substr(0, n) + this.value.substring(n + 1); + } + setCharAt(n, c) { + this.value = this.value.substr(0, n) + c + this.value.substr(n + 1); + } + substring(start, end) { + return this.value.substring(start, end); + } + /** + * @note helper method for RSS Expanded + */ + setLengthToZero() { + this.value = ''; + } + toString() { + return this.value; + } + insert(n, c) { + this.value = this.value.substr(0, n) + c + this.value.substr(n + c.length); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Represents a 2D matrix of bits. In function arguments below, and throughout the common + * module, x is the column position, and y is the row position. The ordering is always x, y. + * The origin is at the top-left.

+ * + *

Internally the bits are represented in a 1-D array of 32-bit ints. However, each row begins + * with a new int. This is done intentionally so that we can copy out a row into a BitArray very + * efficiently.

+ * + *

The ordering of bits is row-major. Within each int, the least significant bits are used first, + * meaning they represent lower x values. This is compatible with BitArray's implementation.

+ * + * @author Sean Owen + * @author dswitkin@google.com (Daniel Switkin) + */ + class BitMatrix /*implements Cloneable*/ { + /** + * Creates an empty square {@link BitMatrix}. + * + * @param dimension height and width + */ + // public constructor(dimension: number /*int*/) { + // this(dimension, dimension) + // } + /** + * Creates an empty {@link BitMatrix}. + * + * @param width bit matrix width + * @param height bit matrix height + */ + // public constructor(width: number /*int*/, height: number /*int*/) { + // if (width < 1 || height < 1) { + // throw new IllegalArgumentException("Both dimensions must be greater than 0") + // } + // this.width = width + // this.height = height + // this.rowSize = (width + 31) / 32 + // bits = new int[rowSize * height]; + // } + constructor(width /*int*/, height /*int*/, rowSize /*int*/, bits) { + this.width = width; + this.height = height; + this.rowSize = rowSize; + this.bits = bits; + if (undefined === height || null === height) { + height = width; + } + this.height = height; + if (width < 1 || height < 1) { + throw new IllegalArgumentException('Both dimensions must be greater than 0'); + } + if (undefined === rowSize || null === rowSize) { + rowSize = Math.floor((width + 31) / 32); + } + this.rowSize = rowSize; + if (undefined === bits || null === bits) { + this.bits = new Int32Array(this.rowSize * this.height); + } + } + /** + * Interprets a 2D array of booleans as a {@link BitMatrix}, where "true" means an "on" bit. + * + * @function parse + * @param image bits of the image, as a row-major 2D array. Elements are arrays representing rows + * @return {@link BitMatrix} representation of image + */ + static parseFromBooleanArray(image) { + const height = image.length; + const width = image[0].length; + const bits = new BitMatrix(width, height); + for (let i = 0; i < height; i++) { + const imageI = image[i]; + for (let j = 0; j < width; j++) { + if (imageI[j]) { + bits.set(j, i); + } + } + } + return bits; + } + /** + * + * @function parse + * @param stringRepresentation + * @param setString + * @param unsetString + */ + static parseFromString(stringRepresentation, setString, unsetString) { + if (stringRepresentation === null) { + throw new IllegalArgumentException('stringRepresentation cannot be null'); + } + const bits = new Array(stringRepresentation.length); + let bitsPos = 0; + let rowStartPos = 0; + let rowLength = -1; + let nRows = 0; + let pos = 0; + while (pos < stringRepresentation.length) { + if (stringRepresentation.charAt(pos) === '\n' || + stringRepresentation.charAt(pos) === '\r') { + if (bitsPos > rowStartPos) { + if (rowLength === -1) { + rowLength = bitsPos - rowStartPos; + } + else if (bitsPos - rowStartPos !== rowLength) { + throw new IllegalArgumentException('row lengths do not match'); + } + rowStartPos = bitsPos; + nRows++; + } + pos++; + } + else if (stringRepresentation.substring(pos, pos + setString.length) === setString) { + pos += setString.length; + bits[bitsPos] = true; + bitsPos++; + } + else if (stringRepresentation.substring(pos, pos + unsetString.length) === unsetString) { + pos += unsetString.length; + bits[bitsPos] = false; + bitsPos++; + } + else { + throw new IllegalArgumentException('illegal character encountered: ' + stringRepresentation.substring(pos)); + } + } + // no EOL at end? + if (bitsPos > rowStartPos) { + if (rowLength === -1) { + rowLength = bitsPos - rowStartPos; + } + else if (bitsPos - rowStartPos !== rowLength) { + throw new IllegalArgumentException('row lengths do not match'); + } + nRows++; + } + const matrix = new BitMatrix(rowLength, nRows); + for (let i = 0; i < bitsPos; i++) { + if (bits[i]) { + matrix.set(Math.floor(i % rowLength), Math.floor(i / rowLength)); + } + } + return matrix; + } + /** + *

Gets the requested bit, where true means black.

+ * + * @param x The horizontal component (i.e. which column) + * @param y The vertical component (i.e. which row) + * @return value of given bit in matrix + */ + get(x /*int*/, y /*int*/) { + const offset = y * this.rowSize + Math.floor(x / 32); + return ((this.bits[offset] >>> (x & 0x1f)) & 1) !== 0; + } + /** + *

Sets the given bit to true.

+ * + * @param x The horizontal component (i.e. which column) + * @param y The vertical component (i.e. which row) + */ + set(x /*int*/, y /*int*/) { + const offset = y * this.rowSize + Math.floor(x / 32); + this.bits[offset] |= (1 << (x & 0x1f)) & 0xFFFFFFFF; + } + unset(x /*int*/, y /*int*/) { + const offset = y * this.rowSize + Math.floor(x / 32); + this.bits[offset] &= ~((1 << (x & 0x1f)) & 0xFFFFFFFF); + } + /** + *

Flips the given bit.

+ * + * @param x The horizontal component (i.e. which column) + * @param y The vertical component (i.e. which row) + */ + flip(x /*int*/, y /*int*/) { + const offset = y * this.rowSize + Math.floor(x / 32); + this.bits[offset] ^= ((1 << (x & 0x1f)) & 0xFFFFFFFF); + } + /** + * Exclusive-or (XOR): Flip the bit in this {@code BitMatrix} if the corresponding + * mask bit is set. + * + * @param mask XOR mask + */ + xor(mask) { + if (this.width !== mask.getWidth() || this.height !== mask.getHeight() + || this.rowSize !== mask.getRowSize()) { + throw new IllegalArgumentException('input matrix dimensions do not match'); + } + const rowArray = new BitArray(Math.floor(this.width / 32) + 1); + const rowSize = this.rowSize; + const bits = this.bits; + for (let y = 0, height = this.height; y < height; y++) { + const offset = y * rowSize; + const row = mask.getRow(y, rowArray).getBitArray(); + for (let x = 0; x < rowSize; x++) { + bits[offset + x] ^= row[x]; + } + } + } + /** + * Clears all bits (sets to false). + */ + clear() { + const bits = this.bits; + const max = bits.length; + for (let i = 0; i < max; i++) { + bits[i] = 0; + } + } + /** + *

Sets a square region of the bit matrix to true.

+ * + * @param left The horizontal position to begin at (inclusive) + * @param top The vertical position to begin at (inclusive) + * @param width The width of the region + * @param height The height of the region + */ + setRegion(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + if (top < 0 || left < 0) { + throw new IllegalArgumentException('Left and top must be nonnegative'); + } + if (height < 1 || width < 1) { + throw new IllegalArgumentException('Height and width must be at least 1'); + } + const right = left + width; + const bottom = top + height; + if (bottom > this.height || right > this.width) { + throw new IllegalArgumentException('The region must fit inside the matrix'); + } + const rowSize = this.rowSize; + const bits = this.bits; + for (let y = top; y < bottom; y++) { + const offset = y * rowSize; + for (let x = left; x < right; x++) { + bits[offset + Math.floor(x / 32)] |= ((1 << (x & 0x1f)) & 0xFFFFFFFF); + } + } + } + /** + * A fast method to retrieve one row of data from the matrix as a BitArray. + * + * @param y The row to retrieve + * @param row An optional caller-allocated BitArray, will be allocated if null or too small + * @return The resulting BitArray - this reference should always be used even when passing + * your own row + */ + getRow(y /*int*/, row) { + if (row === null || row === undefined || row.getSize() < this.width) { + row = new BitArray(this.width); + } + else { + row.clear(); + } + const rowSize = this.rowSize; + const bits = this.bits; + const offset = y * rowSize; + for (let x = 0; x < rowSize; x++) { + row.setBulk(x * 32, bits[offset + x]); + } + return row; + } + /** + * @param y row to set + * @param row {@link BitArray} to copy from + */ + setRow(y /*int*/, row) { + System.arraycopy(row.getBitArray(), 0, this.bits, y * this.rowSize, this.rowSize); + } + /** + * Modifies this {@code BitMatrix} to represent the same but rotated 180 degrees + */ + rotate180() { + const width = this.getWidth(); + const height = this.getHeight(); + let topRow = new BitArray(width); + let bottomRow = new BitArray(width); + for (let i = 0, length = Math.floor((height + 1) / 2); i < length; i++) { + topRow = this.getRow(i, topRow); + bottomRow = this.getRow(height - 1 - i, bottomRow); + topRow.reverse(); + bottomRow.reverse(); + this.setRow(i, bottomRow); + this.setRow(height - 1 - i, topRow); + } + } + /** + * This is useful in detecting the enclosing rectangle of a 'pure' barcode. + * + * @return {@code left,top,width,height} enclosing rectangle of all 1 bits, or null if it is all white + */ + getEnclosingRectangle() { + const width = this.width; + const height = this.height; + const rowSize = this.rowSize; + const bits = this.bits; + let left = width; + let top = height; + let right = -1; + let bottom = -1; + for (let y = 0; y < height; y++) { + for (let x32 = 0; x32 < rowSize; x32++) { + const theBits = bits[y * rowSize + x32]; + if (theBits !== 0) { + if (y < top) { + top = y; + } + if (y > bottom) { + bottom = y; + } + if (x32 * 32 < left) { + let bit = 0; + while (((theBits << (31 - bit)) & 0xFFFFFFFF) === 0) { + bit++; + } + if ((x32 * 32 + bit) < left) { + left = x32 * 32 + bit; + } + } + if (x32 * 32 + 31 > right) { + let bit = 31; + while ((theBits >>> bit) === 0) { + bit--; + } + if ((x32 * 32 + bit) > right) { + right = x32 * 32 + bit; + } + } + } + } + } + if (right < left || bottom < top) { + return null; + } + return Int32Array.from([left, top, right - left + 1, bottom - top + 1]); + } + /** + * This is useful in detecting a corner of a 'pure' barcode. + * + * @return {@code x,y} coordinate of top-left-most 1 bit, or null if it is all white + */ + getTopLeftOnBit() { + const rowSize = this.rowSize; + const bits = this.bits; + let bitsOffset = 0; + while (bitsOffset < bits.length && bits[bitsOffset] === 0) { + bitsOffset++; + } + if (bitsOffset === bits.length) { + return null; + } + const y = bitsOffset / rowSize; + let x = (bitsOffset % rowSize) * 32; + const theBits = bits[bitsOffset]; + let bit = 0; + while (((theBits << (31 - bit)) & 0xFFFFFFFF) === 0) { + bit++; + } + x += bit; + return Int32Array.from([x, y]); + } + getBottomRightOnBit() { + const rowSize = this.rowSize; + const bits = this.bits; + let bitsOffset = bits.length - 1; + while (bitsOffset >= 0 && bits[bitsOffset] === 0) { + bitsOffset--; + } + if (bitsOffset < 0) { + return null; + } + const y = Math.floor(bitsOffset / rowSize); + let x = Math.floor(bitsOffset % rowSize) * 32; + const theBits = bits[bitsOffset]; + let bit = 31; + while ((theBits >>> bit) === 0) { + bit--; + } + x += bit; + return Int32Array.from([x, y]); + } + /** + * @return The width of the matrix + */ + getWidth() { + return this.width; + } + /** + * @return The height of the matrix + */ + getHeight() { + return this.height; + } + /** + * @return The row size of the matrix + */ + getRowSize() { + return this.rowSize; + } + /*@Override*/ + equals(o) { + if (!(o instanceof BitMatrix)) { + return false; + } + const other = o; + return this.width === other.width && this.height === other.height && this.rowSize === other.rowSize && + Arrays.equals(this.bits, other.bits); + } + /*@Override*/ + hashCode() { + let hash = this.width; + hash = 31 * hash + this.width; + hash = 31 * hash + this.height; + hash = 31 * hash + this.rowSize; + hash = 31 * hash + Arrays.hashCode(this.bits); + return hash; + } + /** + * @return string representation using "X" for set and " " for unset bits + */ + /*@Override*/ + // public toString(): string { + // return toString(": "X, " ") + // } + /** + * @param setString representation of a set bit + * @param unsetString representation of an unset bit + * @return string representation of entire matrix utilizing given strings + */ + // public toString(setString: string = "X ", unsetString: string = " "): string { + // return this.buildToString(setString, unsetString, "\n") + // } + /** + * @param setString representation of a set bit + * @param unsetString representation of an unset bit + * @param lineSeparator newline character in string representation + * @return string representation of entire matrix utilizing given strings and line separator + * @deprecated call {@link #toString(String,String)} only, which uses \n line separator always + */ + // @Deprecated + toString(setString = 'X ', unsetString = ' ', lineSeparator = '\n') { + return this.buildToString(setString, unsetString, lineSeparator); + } + buildToString(setString, unsetString, lineSeparator) { + let result = new StringBuilder(); + // result.append(lineSeparator); + for (let y = 0, height = this.height; y < height; y++) { + for (let x = 0, width = this.width; x < width; x++) { + result.append(this.get(x, y) ? setString : unsetString); + } + result.append(lineSeparator); + } + return result.toString(); + } + /*@Override*/ + clone() { + return new BitMatrix(this.width, this.height, this.rowSize, this.bits.slice()); + } + } + + /** + * Custom Error class of type Exception. + */ + class NotFoundException extends Exception { + static getNotFoundInstance() { + return new NotFoundException(); + } + } + NotFoundException.kind = 'NotFoundException'; + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This Binarizer implementation uses the old ZXing global histogram approach. It is suitable + * for low-end mobile devices which don't have enough CPU or memory to use a local thresholding + * algorithm. However, because it picks a global black point, it cannot handle difficult shadows + * and gradients. + * + * Faster mobile devices and all desktop applications should probably use HybridBinarizer instead. + * + * @author dswitkin@google.com (Daniel Switkin) + * @author Sean Owen + */ + class GlobalHistogramBinarizer extends Binarizer { + constructor(source) { + super(source); + this.luminances = GlobalHistogramBinarizer.EMPTY; + this.buckets = new Int32Array(GlobalHistogramBinarizer.LUMINANCE_BUCKETS); + } + // Applies simple sharpening to the row data to improve performance of the 1D Readers. + /*@Override*/ + getBlackRow(y /*int*/, row) { + const source = this.getLuminanceSource(); + const width = source.getWidth(); + if (row === undefined || row === null || row.getSize() < width) { + row = new BitArray(width); + } + else { + row.clear(); + } + this.initArrays(width); + const localLuminances = source.getRow(y, this.luminances); + const localBuckets = this.buckets; + for (let x = 0; x < width; x++) { + localBuckets[(localLuminances[x] & 0xff) >> GlobalHistogramBinarizer.LUMINANCE_SHIFT]++; + } + const blackPoint = GlobalHistogramBinarizer.estimateBlackPoint(localBuckets); + if (width < 3) { + // Special case for very small images + for (let x = 0; x < width; x++) { + if ((localLuminances[x] & 0xff) < blackPoint) { + row.set(x); + } + } + } + else { + let left = localLuminances[0] & 0xff; + let center = localLuminances[1] & 0xff; + for (let x = 1; x < width - 1; x++) { + const right = localLuminances[x + 1] & 0xff; + // A simple -1 4 -1 box filter with a weight of 2. + if (((center * 4) - left - right) / 2 < blackPoint) { + row.set(x); + } + left = center; + center = right; + } + } + return row; + } + // Does not sharpen the data, as this call is intended to only be used by 2D Readers. + /*@Override*/ + getBlackMatrix() { + const source = this.getLuminanceSource(); + const width = source.getWidth(); + const height = source.getHeight(); + const matrix = new BitMatrix(width, height); + // Quickly calculates the histogram by sampling four rows from the image. This proved to be + // more robust on the blackbox tests than sampling a diagonal as we used to do. + this.initArrays(width); + const localBuckets = this.buckets; + for (let y = 1; y < 5; y++) { + const row = Math.floor((height * y) / 5); + const localLuminances = source.getRow(row, this.luminances); + const right = Math.floor((width * 4) / 5); + for (let x = Math.floor(width / 5); x < right; x++) { + const pixel = localLuminances[x] & 0xff; + localBuckets[pixel >> GlobalHistogramBinarizer.LUMINANCE_SHIFT]++; + } + } + const blackPoint = GlobalHistogramBinarizer.estimateBlackPoint(localBuckets); + // We delay reading the entire image luminance until the black point estimation succeeds. + // Although we end up reading four rows twice, it is consistent with our motto of + // "fail quickly" which is necessary for continuous scanning. + const localLuminances = source.getMatrix(); + for (let y = 0; y < height; y++) { + const offset = y * width; + for (let x = 0; x < width; x++) { + const pixel = localLuminances[offset + x] & 0xff; + if (pixel < blackPoint) { + matrix.set(x, y); + } + } + } + return matrix; + } + /*@Override*/ + createBinarizer(source) { + return new GlobalHistogramBinarizer(source); + } + initArrays(luminanceSize /*int*/) { + if (this.luminances.length < luminanceSize) { + this.luminances = new Uint8ClampedArray(luminanceSize); + } + const buckets = this.buckets; + for (let x = 0; x < GlobalHistogramBinarizer.LUMINANCE_BUCKETS; x++) { + buckets[x] = 0; + } + } + static estimateBlackPoint(buckets) { + // Find the tallest peak in the histogram. + const numBuckets = buckets.length; + let maxBucketCount = 0; + let firstPeak = 0; + let firstPeakSize = 0; + for (let x = 0; x < numBuckets; x++) { + if (buckets[x] > firstPeakSize) { + firstPeak = x; + firstPeakSize = buckets[x]; + } + if (buckets[x] > maxBucketCount) { + maxBucketCount = buckets[x]; + } + } + // Find the second-tallest peak which is somewhat far from the tallest peak. + let secondPeak = 0; + let secondPeakScore = 0; + for (let x = 0; x < numBuckets; x++) { + const distanceToBiggest = x - firstPeak; + // Encourage more distant second peaks by multiplying by square of distance. + const score = buckets[x] * distanceToBiggest * distanceToBiggest; + if (score > secondPeakScore) { + secondPeak = x; + secondPeakScore = score; + } + } + // Make sure firstPeak corresponds to the black peak. + if (firstPeak > secondPeak) { + const temp = firstPeak; + firstPeak = secondPeak; + secondPeak = temp; + } + // If there is too little contrast in the image to pick a meaningful black point, throw rather + // than waste time trying to decode the image, and risk false positives. + if (secondPeak - firstPeak <= numBuckets / 16) { + throw new NotFoundException(); + } + // Find a valley between them that is low and closer to the white peak. + let bestValley = secondPeak - 1; + let bestValleyScore = -1; + for (let x = secondPeak - 1; x > firstPeak; x--) { + const fromFirst = x - firstPeak; + const score = fromFirst * fromFirst * (secondPeak - x) * (maxBucketCount - buckets[x]); + if (score > bestValleyScore) { + bestValley = x; + bestValleyScore = score; + } + } + return bestValley << GlobalHistogramBinarizer.LUMINANCE_SHIFT; + } + } + GlobalHistogramBinarizer.LUMINANCE_BITS = 5; + GlobalHistogramBinarizer.LUMINANCE_SHIFT = 8 - GlobalHistogramBinarizer.LUMINANCE_BITS; + GlobalHistogramBinarizer.LUMINANCE_BUCKETS = 1 << GlobalHistogramBinarizer.LUMINANCE_BITS; + GlobalHistogramBinarizer.EMPTY = Uint8ClampedArray.from([0]); + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This class implements a local thresholding algorithm, which while slower than the + * GlobalHistogramBinarizer, is fairly efficient for what it does. It is designed for + * high frequency images of barcodes with black data on white backgrounds. For this application, + * it does a much better job than a global blackpoint with severe shadows and gradients. + * However it tends to produce artifacts on lower frequency images and is therefore not + * a good general purpose binarizer for uses outside ZXing. + * + * This class extends GlobalHistogramBinarizer, using the older histogram approach for 1D readers, + * and the newer local approach for 2D readers. 1D decoding using a per-row histogram is already + * inherently local, and only fails for horizontal gradients. We can revisit that problem later, + * but for now it was not a win to use local blocks for 1D. + * + * This Binarizer is the default for the unit tests and the recommended class for library users. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class HybridBinarizer extends GlobalHistogramBinarizer { + constructor(source) { + super(source); + this.matrix = null; + } + /** + * Calculates the final BitMatrix once for all requests. This could be called once from the + * constructor instead, but there are some advantages to doing it lazily, such as making + * profiling easier, and not doing heavy lifting when callers don't expect it. + */ + /*@Override*/ + getBlackMatrix() { + if (this.matrix !== null) { + return this.matrix; + } + const source = this.getLuminanceSource(); + const width = source.getWidth(); + const height = source.getHeight(); + if (width >= HybridBinarizer.MINIMUM_DIMENSION && height >= HybridBinarizer.MINIMUM_DIMENSION) { + const luminances = source.getMatrix(); + let subWidth = width >> HybridBinarizer.BLOCK_SIZE_POWER; + if ((width & HybridBinarizer.BLOCK_SIZE_MASK) !== 0) { + subWidth++; + } + let subHeight = height >> HybridBinarizer.BLOCK_SIZE_POWER; + if ((height & HybridBinarizer.BLOCK_SIZE_MASK) !== 0) { + subHeight++; + } + const blackPoints = HybridBinarizer.calculateBlackPoints(luminances, subWidth, subHeight, width, height); + const newMatrix = new BitMatrix(width, height); + HybridBinarizer.calculateThresholdForBlock(luminances, subWidth, subHeight, width, height, blackPoints, newMatrix); + this.matrix = newMatrix; + } + else { + // If the image is too small, fall back to the global histogram approach. + this.matrix = super.getBlackMatrix(); + } + return this.matrix; + } + /*@Override*/ + createBinarizer(source) { + return new HybridBinarizer(source); + } + /** + * For each block in the image, calculate the average black point using a 5x5 grid + * of the blocks around it. Also handles the corner cases (fractional blocks are computed based + * on the last pixels in the row/column which are also used in the previous block). + */ + static calculateThresholdForBlock(luminances, subWidth /*int*/, subHeight /*int*/, width /*int*/, height /*int*/, blackPoints, matrix) { + const maxYOffset = height - HybridBinarizer.BLOCK_SIZE; + const maxXOffset = width - HybridBinarizer.BLOCK_SIZE; + for (let y = 0; y < subHeight; y++) { + let yoffset = y << HybridBinarizer.BLOCK_SIZE_POWER; + if (yoffset > maxYOffset) { + yoffset = maxYOffset; + } + const top = HybridBinarizer.cap(y, 2, subHeight - 3); + for (let x = 0; x < subWidth; x++) { + let xoffset = x << HybridBinarizer.BLOCK_SIZE_POWER; + if (xoffset > maxXOffset) { + xoffset = maxXOffset; + } + const left = HybridBinarizer.cap(x, 2, subWidth - 3); + let sum = 0; + for (let z = -2; z <= 2; z++) { + const blackRow = blackPoints[top + z]; + sum += blackRow[left - 2] + blackRow[left - 1] + blackRow[left] + blackRow[left + 1] + blackRow[left + 2]; + } + const average = sum / 25; + HybridBinarizer.thresholdBlock(luminances, xoffset, yoffset, average, width, matrix); + } + } + } + static cap(value /*int*/, min /*int*/, max /*int*/) { + return value < min ? min : value > max ? max : value; + } + /** + * Applies a single threshold to a block of pixels. + */ + static thresholdBlock(luminances, xoffset /*int*/, yoffset /*int*/, threshold /*int*/, stride /*int*/, matrix) { + for (let y = 0, offset = yoffset * stride + xoffset; y < HybridBinarizer.BLOCK_SIZE; y++, offset += stride) { + for (let x = 0; x < HybridBinarizer.BLOCK_SIZE; x++) { + // Comparison needs to be <= so that black == 0 pixels are black even if the threshold is 0. + if ((luminances[offset + x] & 0xFF) <= threshold) { + matrix.set(xoffset + x, yoffset + y); + } + } + } + } + /** + * Calculates a single black point for each block of pixels and saves it away. + * See the following thread for a discussion of this algorithm: + * http://groups.google.com/group/zxing/browse_thread/thread/d06efa2c35a7ddc0 + */ + static calculateBlackPoints(luminances, subWidth /*int*/, subHeight /*int*/, width /*int*/, height /*int*/) { + const maxYOffset = height - HybridBinarizer.BLOCK_SIZE; + const maxXOffset = width - HybridBinarizer.BLOCK_SIZE; + // tslint:disable-next-line:whitespace + const blackPoints = new Array(subHeight); // subWidth + for (let y = 0; y < subHeight; y++) { + blackPoints[y] = new Int32Array(subWidth); + let yoffset = y << HybridBinarizer.BLOCK_SIZE_POWER; + if (yoffset > maxYOffset) { + yoffset = maxYOffset; + } + for (let x = 0; x < subWidth; x++) { + let xoffset = x << HybridBinarizer.BLOCK_SIZE_POWER; + if (xoffset > maxXOffset) { + xoffset = maxXOffset; + } + let sum = 0; + let min = 0xFF; + let max = 0; + for (let yy = 0, offset = yoffset * width + xoffset; yy < HybridBinarizer.BLOCK_SIZE; yy++, offset += width) { + for (let xx = 0; xx < HybridBinarizer.BLOCK_SIZE; xx++) { + const pixel = luminances[offset + xx] & 0xFF; + sum += pixel; + // still looking for good contrast + if (pixel < min) { + min = pixel; + } + if (pixel > max) { + max = pixel; + } + } + // short-circuit min/max tests once dynamic range is met + if (max - min > HybridBinarizer.MIN_DYNAMIC_RANGE) { + // finish the rest of the rows quickly + for (yy++, offset += width; yy < HybridBinarizer.BLOCK_SIZE; yy++, offset += width) { + for (let xx = 0; xx < HybridBinarizer.BLOCK_SIZE; xx++) { + sum += luminances[offset + xx] & 0xFF; + } + } + } + } + // The default estimate is the average of the values in the block. + let average = sum >> (HybridBinarizer.BLOCK_SIZE_POWER * 2); + if (max - min <= HybridBinarizer.MIN_DYNAMIC_RANGE) { + // If variation within the block is low, assume this is a block with only light or only + // dark pixels. In that case we do not want to use the average, as it would divide this + // low contrast area into black and white pixels, essentially creating data out of noise. + // + // The default assumption is that the block is light/background. Since no estimate for + // the level of dark pixels exists locally, use half the min for the block. + average = min / 2; + if (y > 0 && x > 0) { + // Correct the "white background" assumption for blocks that have neighbors by comparing + // the pixels in this block to the previously calculated black points. This is based on + // the fact that dark barcode symbology is always surrounded by some amount of light + // background for which reasonable black point estimates were made. The bp estimated at + // the boundaries is used for the interior. + // The (min < bp) is arbitrary but works better than other heuristics that were tried. + const averageNeighborBlackPoint = (blackPoints[y - 1][x] + (2 * blackPoints[y][x - 1]) + blackPoints[y - 1][x - 1]) / 4; + if (min < averageNeighborBlackPoint) { + average = averageNeighborBlackPoint; + } + } + } + blackPoints[y][x] = average; + } + } + return blackPoints; + } + } + // This class uses 5x5 blocks to compute local luminance, where each block is 8x8 pixels. + // So this is the smallest dimension in each axis we can accept. + HybridBinarizer.BLOCK_SIZE_POWER = 3; + HybridBinarizer.BLOCK_SIZE = 1 << HybridBinarizer.BLOCK_SIZE_POWER; // ...0100...00 + HybridBinarizer.BLOCK_SIZE_MASK = HybridBinarizer.BLOCK_SIZE - 1; // ...0011...11 + HybridBinarizer.MINIMUM_DIMENSION = HybridBinarizer.BLOCK_SIZE * 5; + HybridBinarizer.MIN_DYNAMIC_RANGE = 24; + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * The purpose of this class hierarchy is to abstract different bitmap implementations across + * platforms into a standard interface for requesting greyscale luminance values. The interface + * only provides immutable methods; therefore crop and rotation create copies. This is to ensure + * that one Reader does not modify the original luminance source and leave it in an unknown state + * for other Readers in the chain. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class LuminanceSource { + constructor(width /*int*/, height /*int*/) { + this.width = width; + this.height = height; + } + /** + * @return The width of the bitmap. + */ + getWidth() { + return this.width; + } + /** + * @return The height of the bitmap. + */ + getHeight() { + return this.height; + } + /** + * @return Whether this subclass supports cropping. + */ + isCropSupported() { + return false; + } + /** + * Returns a new object with cropped image data. Implementations may keep a reference to the + * original data rather than a copy. Only callable if isCropSupported() is true. + * + * @param left The left coordinate, which must be in [0,getWidth()) + * @param top The top coordinate, which must be in [0,getHeight()) + * @param width The width of the rectangle to crop. + * @param height The height of the rectangle to crop. + * @return A cropped version of this object. + */ + crop(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + throw new UnsupportedOperationException('This luminance source does not support cropping.'); + } + /** + * @return Whether this subclass supports counter-clockwise rotation. + */ + isRotateSupported() { + return false; + } + /** + * Returns a new object with rotated image data by 90 degrees counterclockwise. + * Only callable if {@link #isRotateSupported()} is true. + * + * @return A rotated version of this object. + */ + rotateCounterClockwise() { + throw new UnsupportedOperationException('This luminance source does not support rotation by 90 degrees.'); + } + /** + * Returns a new object with rotated image data by 45 degrees counterclockwise. + * Only callable if {@link #isRotateSupported()} is true. + * + * @return A rotated version of this object. + */ + rotateCounterClockwise45() { + throw new UnsupportedOperationException('This luminance source does not support rotation by 45 degrees.'); + } + /*@Override*/ + toString() { + const row = new Uint8ClampedArray(this.width); + let result = new StringBuilder(); + for (let y = 0; y < this.height; y++) { + const sourceRow = this.getRow(y, row); + for (let x = 0; x < this.width; x++) { + const luminance = sourceRow[x] & 0xFF; + let c; + if (luminance < 0x40) { + c = '#'; + } + else if (luminance < 0x80) { + c = '+'; + } + else if (luminance < 0xC0) { + c = '.'; + } + else { + c = ' '; + } + result.append(c); + } + result.append('\n'); + } + return result.toString(); + } + } + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * A wrapper implementation of {@link LuminanceSource} which inverts the luminances it returns -- black becomes + * white and vice versa, and each value becomes (255-value). + * + * @author Sean Owen + */ + class InvertedLuminanceSource extends LuminanceSource { + constructor(delegate) { + super(delegate.getWidth(), delegate.getHeight()); + this.delegate = delegate; + } + /*@Override*/ + getRow(y /*int*/, row) { + const sourceRow = this.delegate.getRow(y, row); + const width = this.getWidth(); + for (let i = 0; i < width; i++) { + sourceRow[i] = /*(byte)*/ (255 - (sourceRow[i] & 0xFF)); + } + return sourceRow; + } + /*@Override*/ + getMatrix() { + const matrix = this.delegate.getMatrix(); + const length = this.getWidth() * this.getHeight(); + const invertedMatrix = new Uint8ClampedArray(length); + for (let i = 0; i < length; i++) { + invertedMatrix[i] = /*(byte)*/ (255 - (matrix[i] & 0xFF)); + } + return invertedMatrix; + } + /*@Override*/ + isCropSupported() { + return this.delegate.isCropSupported(); + } + /*@Override*/ + crop(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + return new InvertedLuminanceSource(this.delegate.crop(left, top, width, height)); + } + /*@Override*/ + isRotateSupported() { + return this.delegate.isRotateSupported(); + } + /** + * @return original delegate {@link LuminanceSource} since invert undoes itself + */ + /*@Override*/ + invert() { + return this.delegate; + } + /*@Override*/ + rotateCounterClockwise() { + return new InvertedLuminanceSource(this.delegate.rotateCounterClockwise()); + } + /*@Override*/ + rotateCounterClockwise45() { + return new InvertedLuminanceSource(this.delegate.rotateCounterClockwise45()); + } + } + + /** + * @deprecated Moving to @zxing/browser + */ + class HTMLCanvasElementLuminanceSource extends LuminanceSource { + constructor(canvas) { + super(canvas.width, canvas.height); + this.canvas = canvas; + this.tempCanvasElement = null; + this.buffer = HTMLCanvasElementLuminanceSource.makeBufferFromCanvasImageData(canvas); + } + static makeBufferFromCanvasImageData(canvas) { + const imageData = canvas.getContext('2d').getImageData(0, 0, canvas.width, canvas.height); + return HTMLCanvasElementLuminanceSource.toGrayscaleBuffer(imageData.data, canvas.width, canvas.height); + } + static toGrayscaleBuffer(imageBuffer, width, height) { + const grayscaleBuffer = new Uint8ClampedArray(width * height); + for (let i = 0, j = 0, length = imageBuffer.length; i < length; i += 4, j++) { + let gray; + const alpha = imageBuffer[i + 3]; + // The color of fully-transparent pixels is irrelevant. They are often, technically, fully-transparent + // black (0 alpha, and then 0 RGB). They are often used, of course as the "white" area in a + // barcode image. Force any such pixel to be white: + if (alpha === 0) { + gray = 0xFF; + } + else { + const pixelR = imageBuffer[i]; + const pixelG = imageBuffer[i + 1]; + const pixelB = imageBuffer[i + 2]; + // .299R + 0.587G + 0.114B (YUV/YIQ for PAL and NTSC), + // (306*R) >> 10 is approximately equal to R*0.299, and so on. + // 0x200 >> 10 is 0.5, it implements rounding. + gray = (306 * pixelR + + 601 * pixelG + + 117 * pixelB + + 0x200) >> 10; + } + grayscaleBuffer[j] = gray; + } + return grayscaleBuffer; + } + getRow(y /*int*/, row) { + if (y < 0 || y >= this.getHeight()) { + throw new IllegalArgumentException('Requested row is outside the image: ' + y); + } + const width = this.getWidth(); + const start = y * width; + if (row === null) { + row = this.buffer.slice(start, start + width); + } + else { + if (row.length < width) { + row = new Uint8ClampedArray(width); + } + // The underlying raster of image consists of bytes with the luminance values + // TODO: can avoid set/slice? + row.set(this.buffer.slice(start, start + width)); + } + return row; + } + getMatrix() { + return this.buffer; + } + isCropSupported() { + return true; + } + crop(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + super.crop(left, top, width, height); + return this; + } + /** + * This is always true, since the image is a gray-scale image. + * + * @return true + */ + isRotateSupported() { + return true; + } + rotateCounterClockwise() { + this.rotate(-90); + return this; + } + rotateCounterClockwise45() { + this.rotate(-45); + return this; + } + getTempCanvasElement() { + if (null === this.tempCanvasElement) { + const tempCanvasElement = this.canvas.ownerDocument.createElement('canvas'); + tempCanvasElement.width = this.canvas.width; + tempCanvasElement.height = this.canvas.height; + this.tempCanvasElement = tempCanvasElement; + } + return this.tempCanvasElement; + } + rotate(angle) { + const tempCanvasElement = this.getTempCanvasElement(); + const tempContext = tempCanvasElement.getContext('2d'); + const angleRadians = angle * HTMLCanvasElementLuminanceSource.DEGREE_TO_RADIANS; + // Calculate and set new dimensions for temp canvas + const width = this.canvas.width; + const height = this.canvas.height; + const newWidth = Math.ceil(Math.abs(Math.cos(angleRadians)) * width + Math.abs(Math.sin(angleRadians)) * height); + const newHeight = Math.ceil(Math.abs(Math.sin(angleRadians)) * width + Math.abs(Math.cos(angleRadians)) * height); + tempCanvasElement.width = newWidth; + tempCanvasElement.height = newHeight; + // Draw at center of temp canvas to prevent clipping of image data + tempContext.translate(newWidth / 2, newHeight / 2); + tempContext.rotate(angleRadians); + tempContext.drawImage(this.canvas, width / -2, height / -2); + this.buffer = HTMLCanvasElementLuminanceSource.makeBufferFromCanvasImageData(tempCanvasElement); + return this; + } + invert() { + return new InvertedLuminanceSource(this); + } + } + HTMLCanvasElementLuminanceSource.DEGREE_TO_RADIANS = Math.PI / 180; + + /** + * @deprecated Moving to @zxing/browser + * + * Video input device metadata containing the id and label of the device if available. + */ + class VideoInputDevice { + /** + * Creates an instance of VideoInputDevice. + * + * @param {string} deviceId the video input device id + * @param {string} label the label of the device if available + */ + constructor(deviceId, label, groupId) { + this.deviceId = deviceId; + this.label = label; + /** @inheritdoc */ + this.kind = 'videoinput'; + this.groupId = groupId || undefined; + } + /** @inheritdoc */ + toJSON() { + return { + kind: this.kind, + groupId: this.groupId, + deviceId: this.deviceId, + label: this.label, + }; + } + } + + var __awaiter = ((globalThis || global || self || window || undefined) && (globalThis || global || self || window || undefined).__awaiter) || function (thisArg, _arguments, P, generator) { + function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); } + return new (P || (P = Promise))(function (resolve, reject) { + function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } } + function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } } + function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); } + step((generator = generator.apply(thisArg, _arguments || [])).next()); + }); + }; + /** + * @deprecated Moving to @zxing/browser + * + * Base class for browser code reader. + */ + class BrowserCodeReader { + /** + * Creates an instance of BrowserCodeReader. + * @param {Reader} reader The reader instance to decode the barcode + * @param {number} [timeBetweenScansMillis=500] the time delay between subsequent successful decode tries + * + * @memberOf BrowserCodeReader + */ + constructor(reader, timeBetweenScansMillis = 500, _hints) { + this.reader = reader; + this.timeBetweenScansMillis = timeBetweenScansMillis; + this._hints = _hints; + /** + * This will break the loop. + */ + this._stopContinuousDecode = false; + /** + * This will break the loop. + */ + this._stopAsyncDecode = false; + /** + * Delay time between decode attempts made by the scanner. + */ + this._timeBetweenDecodingAttempts = 0; + } + /** + * If navigator is present. + */ + get hasNavigator() { + return typeof navigator !== 'undefined'; + } + /** + * If mediaDevices under navigator is supported. + */ + get isMediaDevicesSuported() { + return this.hasNavigator && !!navigator.mediaDevices; + } + /** + * If enumerateDevices under navigator is supported. + */ + get canEnumerateDevices() { + return !!(this.isMediaDevicesSuported && navigator.mediaDevices.enumerateDevices); + } + /** Time between two decoding tries in milli seconds. */ + get timeBetweenDecodingAttempts() { + return this._timeBetweenDecodingAttempts; + } + /** + * Change the time span the decoder waits between two decoding tries. + * + * @param {number} millis Time between two decoding tries in milli seconds. + */ + set timeBetweenDecodingAttempts(millis) { + this._timeBetweenDecodingAttempts = millis < 0 ? 0 : millis; + } + /** + * Sets the hints. + */ + set hints(hints) { + this._hints = hints || null; + } + /** + * Sets the hints. + */ + get hints() { + return this._hints; + } + /** + * Lists all the available video input devices. + */ + listVideoInputDevices() { + return __awaiter(this, void 0, void 0, function* () { + if (!this.hasNavigator) { + throw new Error('Can\'t enumerate devices, navigator is not present.'); + } + if (!this.canEnumerateDevices) { + throw new Error('Can\'t enumerate devices, method not supported.'); + } + const devices = yield navigator.mediaDevices.enumerateDevices(); + const videoDevices = []; + for (const device of devices) { + const kind = device.kind === 'video' ? 'videoinput' : device.kind; + if (kind !== 'videoinput') { + continue; + } + const deviceId = device.deviceId || device.id; + const label = device.label || `Video device ${videoDevices.length + 1}`; + const groupId = device.groupId; + const videoDevice = { deviceId, label, kind, groupId }; + videoDevices.push(videoDevice); + } + return videoDevices; + }); + } + /** + * Obtain the list of available devices with type 'videoinput'. + * + * @returns {Promise} an array of available video input devices + * + * @memberOf BrowserCodeReader + * + * @deprecated Use `listVideoInputDevices` instead. + */ + getVideoInputDevices() { + return __awaiter(this, void 0, void 0, function* () { + const devices = yield this.listVideoInputDevices(); + return devices.map(d => new VideoInputDevice(d.deviceId, d.label)); + }); + } + /** + * Let's you find a device using it's Id. + */ + findDeviceById(deviceId) { + return __awaiter(this, void 0, void 0, function* () { + const devices = yield this.listVideoInputDevices(); + if (!devices) { + return null; + } + return devices.find(x => x.deviceId === deviceId); + }); + } + /** + * Decodes the barcode from the device specified by deviceId while showing the video in the specified video element. + * + * @param deviceId the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available. + * @param video the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns The decoding result. + * + * @memberOf BrowserCodeReader + * + * @deprecated Use `decodeOnceFromVideoDevice` instead. + */ + decodeFromInputVideoDevice(deviceId, videoSource) { + return __awaiter(this, void 0, void 0, function* () { + return yield this.decodeOnceFromVideoDevice(deviceId, videoSource); + }); + } + /** + * In one attempt, tries to decode the barcode from the device specified by deviceId while showing the video in the specified video element. + * + * @param deviceId the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available. + * @param video the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeOnceFromVideoDevice(deviceId, videoSource) { + return __awaiter(this, void 0, void 0, function* () { + this.reset(); + let videoConstraints; + if (!deviceId) { + videoConstraints = { facingMode: 'environment' }; + } + else { + videoConstraints = { deviceId: { exact: deviceId } }; + } + const constraints = { video: videoConstraints }; + return yield this.decodeOnceFromConstraints(constraints, videoSource); + }); + } + /** + * In one attempt, tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element. + * + * @param constraints the media stream constraints to get s valid media stream to decode from + * @param video the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeOnceFromConstraints(constraints, videoSource) { + return __awaiter(this, void 0, void 0, function* () { + const stream = yield navigator.mediaDevices.getUserMedia(constraints); + return yield this.decodeOnceFromStream(stream, videoSource); + }); + } + /** + * In one attempt, tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element. + * + * @param {MediaStream} [constraints] the media stream constraints to get s valid media stream to decode from + * @param {string|HTMLVideoElement} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns {Promise} The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeOnceFromStream(stream, videoSource) { + return __awaiter(this, void 0, void 0, function* () { + this.reset(); + const video = yield this.attachStreamToVideo(stream, videoSource); + const result = yield this.decodeOnce(video); + return result; + }); + } + /** + * Continuously decodes the barcode from the device specified by device while showing the video in the specified video element. + * + * @param {string|null} [deviceId] the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available. + * @param {string|HTMLVideoElement|null} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns {Promise} + * + * @memberOf BrowserCodeReader + * + * @deprecated Use `decodeFromVideoDevice` instead. + */ + decodeFromInputVideoDeviceContinuously(deviceId, videoSource, callbackFn) { + return __awaiter(this, void 0, void 0, function* () { + return yield this.decodeFromVideoDevice(deviceId, videoSource, callbackFn); + }); + } + /** + * Continuously tries to decode the barcode from the device specified by device while showing the video in the specified video element. + * + * @param {string|null} [deviceId] the id of one of the devices obtained after calling getVideoInputDevices. Can be undefined, in this case it will decode from one of the available devices, preffering the main camera (environment facing) if available. + * @param {string|HTMLVideoElement|null} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns {Promise} + * + * @memberOf BrowserCodeReader + */ + decodeFromVideoDevice(deviceId, videoSource, callbackFn) { + return __awaiter(this, void 0, void 0, function* () { + let videoConstraints; + if (!deviceId) { + videoConstraints = { facingMode: 'environment' }; + } + else { + videoConstraints = { deviceId: { exact: deviceId } }; + } + const constraints = { video: videoConstraints }; + return yield this.decodeFromConstraints(constraints, videoSource, callbackFn); + }); + } + /** + * Continuously tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element. + * + * @param {MediaStream} [constraints] the media stream constraints to get s valid media stream to decode from + * @param {string|HTMLVideoElement} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns {Promise} The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeFromConstraints(constraints, videoSource, callbackFn) { + return __awaiter(this, void 0, void 0, function* () { + const stream = yield navigator.mediaDevices.getUserMedia(constraints); + return yield this.decodeFromStream(stream, videoSource, callbackFn); + }); + } + /** + * In one attempt, tries to decode the barcode from a stream obtained from the given constraints while showing the video in the specified video element. + * + * @param {MediaStream} [constraints] the media stream constraints to get s valid media stream to decode from + * @param {string|HTMLVideoElement} [video] the video element in page where to show the video while decoding. Can be either an element id or directly an HTMLVideoElement. Can be undefined, in which case no video will be shown. + * @returns {Promise} The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeFromStream(stream, videoSource, callbackFn) { + return __awaiter(this, void 0, void 0, function* () { + this.reset(); + const video = yield this.attachStreamToVideo(stream, videoSource); + return yield this.decodeContinuously(video, callbackFn); + }); + } + /** + * Breaks the decoding loop. + */ + stopAsyncDecode() { + this._stopAsyncDecode = true; + } + /** + * Breaks the decoding loop. + */ + stopContinuousDecode() { + this._stopContinuousDecode = true; + } + /** + * Sets the new stream and request a new decoding-with-delay. + * + * @param stream The stream to be shown in the video element. + * @param decodeFn A callback for the decode method. + */ + attachStreamToVideo(stream, videoSource) { + return __awaiter(this, void 0, void 0, function* () { + const videoElement = this.prepareVideoElement(videoSource); + this.addVideoSource(videoElement, stream); + this.videoElement = videoElement; + this.stream = stream; + yield this.playVideoOnLoadAsync(videoElement); + return videoElement; + }); + } + /** + * + * @param videoElement + */ + playVideoOnLoadAsync(videoElement) { + return new Promise((resolve, reject) => this.playVideoOnLoad(videoElement, () => resolve())); + } + /** + * Binds listeners and callbacks to the videoElement. + * + * @param element + * @param callbackFn + */ + playVideoOnLoad(element, callbackFn) { + this.videoEndedListener = () => this.stopStreams(); + this.videoCanPlayListener = () => this.tryPlayVideo(element); + element.addEventListener('ended', this.videoEndedListener); + element.addEventListener('canplay', this.videoCanPlayListener); + element.addEventListener('playing', callbackFn); + // if canplay was already fired, we won't know when to play, so just give it a try + this.tryPlayVideo(element); + } + /** + * Checks if the given video element is currently playing. + */ + isVideoPlaying(video) { + return video.currentTime > 0 && !video.paused && !video.ended && video.readyState > 2; + } + /** + * Just tries to play the video and logs any errors. + * The play call is only made is the video is not already playing. + */ + tryPlayVideo(videoElement) { + return __awaiter(this, void 0, void 0, function* () { + if (this.isVideoPlaying(videoElement)) { + console.warn('Trying to play video that is already playing.'); + return; + } + try { + yield videoElement.play(); + } + catch (_a) { + console.warn('It was not possible to play the video.'); + } + }); + } + /** + * Searches and validates a media element. + */ + getMediaElement(mediaElementId, type) { + const mediaElement = document.getElementById(mediaElementId); + if (!mediaElement) { + throw new ArgumentException(`element with id '${mediaElementId}' not found`); + } + if (mediaElement.nodeName.toLowerCase() !== type.toLowerCase()) { + throw new ArgumentException(`element with id '${mediaElementId}' must be an ${type} element`); + } + return mediaElement; + } + /** + * Decodes the barcode from an image. + * + * @param {(string|HTMLImageElement)} [source] The image element that can be either an element id or the element itself. Can be undefined in which case the decoding will be done from the imageUrl parameter. + * @param {string} [url] + * @returns {Promise} The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeFromImage(source, url) { + if (!source && !url) { + throw new ArgumentException('either imageElement with a src set or an url must be provided'); + } + if (url && !source) { + return this.decodeFromImageUrl(url); + } + return this.decodeFromImageElement(source); + } + /** + * Decodes the barcode from a video. + * + * @param {(string|HTMLImageElement)} [source] The image element that can be either an element id or the element itself. Can be undefined in which case the decoding will be done from the imageUrl parameter. + * @param {string} [url] + * @returns {Promise} The decoding result. + * + * @memberOf BrowserCodeReader + */ + decodeFromVideo(source, url) { + if (!source && !url) { + throw new ArgumentException('Either an element with a src set or an URL must be provided'); + } + if (url && !source) { + return this.decodeFromVideoUrl(url); + } + return this.decodeFromVideoElement(source); + } + /** + * Decodes continuously the barcode from a video. + * + * @param {(string|HTMLImageElement)} [source] The image element that can be either an element id or the element itself. Can be undefined in which case the decoding will be done from the imageUrl parameter. + * @param {string} [url] + * @returns {Promise} The decoding result. + * + * @memberOf BrowserCodeReader + * + * @experimental + */ + decodeFromVideoContinuously(source, url, callbackFn) { + if (undefined === source && undefined === url) { + throw new ArgumentException('Either an element with a src set or an URL must be provided'); + } + if (url && !source) { + return this.decodeFromVideoUrlContinuously(url, callbackFn); + } + return this.decodeFromVideoElementContinuously(source, callbackFn); + } + /** + * Decodes something from an image HTML element. + */ + decodeFromImageElement(source) { + if (!source) { + throw new ArgumentException('An image element must be provided.'); + } + this.reset(); + const element = this.prepareImageElement(source); + this.imageElement = element; + let task; + if (this.isImageLoaded(element)) { + task = this.decodeOnce(element, false, true); + } + else { + task = this._decodeOnLoadImage(element); + } + return task; + } + /** + * Decodes something from an image HTML element. + */ + decodeFromVideoElement(source) { + const element = this._decodeFromVideoElementSetup(source); + return this._decodeOnLoadVideo(element); + } + /** + * Decodes something from an image HTML element. + */ + decodeFromVideoElementContinuously(source, callbackFn) { + const element = this._decodeFromVideoElementSetup(source); + return this._decodeOnLoadVideoContinuously(element, callbackFn); + } + /** + * Sets up the video source so it can be decoded when loaded. + * + * @param source The video source element. + */ + _decodeFromVideoElementSetup(source) { + if (!source) { + throw new ArgumentException('A video element must be provided.'); + } + this.reset(); + const element = this.prepareVideoElement(source); + // defines the video element before starts decoding + this.videoElement = element; + return element; + } + /** + * Decodes an image from a URL. + */ + decodeFromImageUrl(url) { + if (!url) { + throw new ArgumentException('An URL must be provided.'); + } + this.reset(); + const element = this.prepareImageElement(); + this.imageElement = element; + const decodeTask = this._decodeOnLoadImage(element); + element.src = url; + return decodeTask; + } + /** + * Decodes an image from a URL. + */ + decodeFromVideoUrl(url) { + if (!url) { + throw new ArgumentException('An URL must be provided.'); + } + this.reset(); + // creates a new element + const element = this.prepareVideoElement(); + const decodeTask = this.decodeFromVideoElement(element); + element.src = url; + return decodeTask; + } + /** + * Decodes an image from a URL. + * + * @experimental + */ + decodeFromVideoUrlContinuously(url, callbackFn) { + if (!url) { + throw new ArgumentException('An URL must be provided.'); + } + this.reset(); + // creates a new element + const element = this.prepareVideoElement(); + const decodeTask = this.decodeFromVideoElementContinuously(element, callbackFn); + element.src = url; + return decodeTask; + } + _decodeOnLoadImage(element) { + return new Promise((resolve, reject) => { + this.imageLoadedListener = () => this.decodeOnce(element, false, true).then(resolve, reject); + element.addEventListener('load', this.imageLoadedListener); + }); + } + _decodeOnLoadVideo(videoElement) { + return __awaiter(this, void 0, void 0, function* () { + // plays the video + yield this.playVideoOnLoadAsync(videoElement); + // starts decoding after played the video + return yield this.decodeOnce(videoElement); + }); + } + _decodeOnLoadVideoContinuously(videoElement, callbackFn) { + return __awaiter(this, void 0, void 0, function* () { + // plays the video + yield this.playVideoOnLoadAsync(videoElement); + // starts decoding after played the video + this.decodeContinuously(videoElement, callbackFn); + }); + } + isImageLoaded(img) { + // During the onload event, IE correctly identifies any images that + // weren’t downloaded as not complete. Others should too. Gecko-based + // browsers act like NS4 in that they report this incorrectly. + if (!img.complete) { + return false; + } + // However, they do have two very useful properties: naturalWidth and + // naturalHeight. These give the true size of the image. If it failed + // to load, either of these should be zero. + if (img.naturalWidth === 0) { + return false; + } + // No other way of checking: assume it’s ok. + return true; + } + prepareImageElement(imageSource) { + let imageElement; + if (typeof imageSource === 'undefined') { + imageElement = document.createElement('img'); + imageElement.width = 200; + imageElement.height = 200; + } + if (typeof imageSource === 'string') { + imageElement = this.getMediaElement(imageSource, 'img'); + } + if (imageSource instanceof HTMLImageElement) { + imageElement = imageSource; + } + return imageElement; + } + /** + * Sets a HTMLVideoElement for scanning or creates a new one. + * + * @param videoSource The HTMLVideoElement to be set. + */ + prepareVideoElement(videoSource) { + let videoElement; + if (!videoSource && typeof document !== 'undefined') { + videoElement = document.createElement('video'); + videoElement.width = 200; + videoElement.height = 200; + } + if (typeof videoSource === 'string') { + videoElement = this.getMediaElement(videoSource, 'video'); + } + if (videoSource instanceof HTMLVideoElement) { + videoElement = videoSource; + } + // Needed for iOS 11 + videoElement.setAttribute('autoplay', 'true'); + videoElement.setAttribute('muted', 'true'); + videoElement.setAttribute('playsinline', 'true'); + return videoElement; + } + /** + * Tries to decode from the video input until it finds some value. + */ + decodeOnce(element, retryIfNotFound = true, retryIfChecksumOrFormatError = true) { + this._stopAsyncDecode = false; + const loop = (resolve, reject) => { + if (this._stopAsyncDecode) { + reject(new NotFoundException('Video stream has ended before any code could be detected.')); + this._stopAsyncDecode = undefined; + return; + } + try { + const result = this.decode(element); + resolve(result); + } + catch (e) { + const ifNotFound = retryIfNotFound && e instanceof NotFoundException; + const isChecksumOrFormatError = e instanceof ChecksumException || e instanceof FormatException; + const ifChecksumOrFormat = isChecksumOrFormatError && retryIfChecksumOrFormatError; + if (ifNotFound || ifChecksumOrFormat) { + // trying again + return setTimeout(loop, this._timeBetweenDecodingAttempts, resolve, reject); + } + reject(e); + } + }; + return new Promise((resolve, reject) => loop(resolve, reject)); + } + /** + * Continuously decodes from video input. + */ + decodeContinuously(element, callbackFn) { + this._stopContinuousDecode = false; + const loop = () => { + if (this._stopContinuousDecode) { + this._stopContinuousDecode = undefined; + return; + } + try { + const result = this.decode(element); + callbackFn(result, null); + setTimeout(loop, this.timeBetweenScansMillis); + } + catch (e) { + callbackFn(null, e); + const isChecksumOrFormatError = e instanceof ChecksumException || e instanceof FormatException; + const isNotFound = e instanceof NotFoundException; + if (isChecksumOrFormatError || isNotFound) { + // trying again + setTimeout(loop, this._timeBetweenDecodingAttempts); + } + } + }; + loop(); + } + /** + * Gets the BinaryBitmap for ya! (and decodes it) + */ + decode(element) { + // get binary bitmap for decode function + const binaryBitmap = this.createBinaryBitmap(element); + return this.decodeBitmap(binaryBitmap); + } + /** + * Creates a binaryBitmap based in some image source. + * + * @param mediaElement HTML element containing drawable image source. + */ + createBinaryBitmap(mediaElement) { + const ctx = this.getCaptureCanvasContext(mediaElement); + this.drawImageOnCanvas(ctx, mediaElement); + const canvas = this.getCaptureCanvas(mediaElement); + const luminanceSource = new HTMLCanvasElementLuminanceSource(canvas); + const hybridBinarizer = new HybridBinarizer(luminanceSource); + return new BinaryBitmap(hybridBinarizer); + } + /** + * + */ + getCaptureCanvasContext(mediaElement) { + if (!this.captureCanvasContext) { + const elem = this.getCaptureCanvas(mediaElement); + const ctx = elem.getContext('2d'); + this.captureCanvasContext = ctx; + } + return this.captureCanvasContext; + } + /** + * + */ + getCaptureCanvas(mediaElement) { + if (!this.captureCanvas) { + const elem = this.createCaptureCanvas(mediaElement); + this.captureCanvas = elem; + } + return this.captureCanvas; + } + /** + * Ovewriting this allows you to manipulate the snapshot image in anyway you want before decode. + */ + drawImageOnCanvas(canvasElementContext, srcElement) { + canvasElementContext.drawImage(srcElement, 0, 0); + } + /** + * Call the encapsulated readers decode + */ + decodeBitmap(binaryBitmap) { + return this.reader.decode(binaryBitmap, this._hints); + } + /** + * 🖌 Prepares the canvas for capture and scan frames. + */ + createCaptureCanvas(mediaElement) { + if (typeof document === 'undefined') { + this._destroyCaptureCanvas(); + return null; + } + const canvasElement = document.createElement('canvas'); + let width; + let height; + if (typeof mediaElement !== 'undefined') { + if (mediaElement instanceof HTMLVideoElement) { + width = mediaElement.videoWidth; + height = mediaElement.videoHeight; + } + else if (mediaElement instanceof HTMLImageElement) { + width = mediaElement.naturalWidth || mediaElement.width; + height = mediaElement.naturalHeight || mediaElement.height; + } + } + canvasElement.style.width = width + 'px'; + canvasElement.style.height = height + 'px'; + canvasElement.width = width; + canvasElement.height = height; + return canvasElement; + } + /** + * Stops the continuous scan and cleans the stream. + */ + stopStreams() { + if (this.stream) { + this.stream.getVideoTracks().forEach(t => t.stop()); + this.stream = undefined; + } + if (this._stopAsyncDecode === false) { + this.stopAsyncDecode(); + } + if (this._stopContinuousDecode === false) { + this.stopContinuousDecode(); + } + } + /** + * Resets the code reader to the initial state. Cancels any ongoing barcode scanning from video or camera. + * + * @memberOf BrowserCodeReader + */ + reset() { + // stops the camera, preview and scan 🔴 + this.stopStreams(); + // clean and forget about HTML elements + this._destroyVideoElement(); + this._destroyImageElement(); + this._destroyCaptureCanvas(); + } + _destroyVideoElement() { + if (!this.videoElement) { + return; + } + // first gives freedon to the element 🕊 + if (typeof this.videoEndedListener !== 'undefined') { + this.videoElement.removeEventListener('ended', this.videoEndedListener); + } + if (typeof this.videoPlayingEventListener !== 'undefined') { + this.videoElement.removeEventListener('playing', this.videoPlayingEventListener); + } + if (typeof this.videoCanPlayListener !== 'undefined') { + this.videoElement.removeEventListener('loadedmetadata', this.videoCanPlayListener); + } + // then forgets about that element 😢 + this.cleanVideoSource(this.videoElement); + this.videoElement = undefined; + } + _destroyImageElement() { + if (!this.imageElement) { + return; + } + // first gives freedon to the element 🕊 + if (undefined !== this.imageLoadedListener) { + this.imageElement.removeEventListener('load', this.imageLoadedListener); + } + // then forget about that element 😢 + this.imageElement.src = undefined; + this.imageElement.removeAttribute('src'); + this.imageElement = undefined; + } + /** + * Cleans canvas references 🖌 + */ + _destroyCaptureCanvas() { + // then forget about that element 😢 + this.captureCanvasContext = undefined; + this.captureCanvas = undefined; + } + /** + * Defines what the videoElement src will be. + * + * @param videoElement + * @param stream + */ + addVideoSource(videoElement, stream) { + // Older browsers may not have `srcObject` + try { + // @note Throws Exception if interrupted by a new loaded request + videoElement.srcObject = stream; + } + catch (err) { + // @note Avoid using this in new browsers, as it is going away. + videoElement.src = URL.createObjectURL(stream); + } + } + /** + * Unbinds a HTML video src property. + * + * @param videoElement + */ + cleanVideoSource(videoElement) { + try { + videoElement.srcObject = null; + } + catch (err) { + videoElement.src = ''; + } + this.videoElement.removeAttribute('src'); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates the result of decoding a barcode within an image.

+ * + * @author Sean Owen + */ + class Result { + // public constructor(private text: string, + // Uint8Array rawBytes, + // ResultPoconst resultPoints: Int32Array, + // BarcodeFormat format) { + // this(text, rawBytes, resultPoints, format, System.currentTimeMillis()) + // } + // public constructor(text: string, + // Uint8Array rawBytes, + // ResultPoconst resultPoints: Int32Array, + // BarcodeFormat format, + // long timestamp) { + // this(text, rawBytes, rawBytes == null ? 0 : 8 * rawBytes.length, + // resultPoints, format, timestamp) + // } + constructor(text, rawBytes, numBits = rawBytes == null ? 0 : 8 * rawBytes.length, resultPoints, format, timestamp = System.currentTimeMillis()) { + this.text = text; + this.rawBytes = rawBytes; + this.numBits = numBits; + this.resultPoints = resultPoints; + this.format = format; + this.timestamp = timestamp; + this.text = text; + this.rawBytes = rawBytes; + if (undefined === numBits || null === numBits) { + this.numBits = (rawBytes === null || rawBytes === undefined) ? 0 : 8 * rawBytes.length; + } + else { + this.numBits = numBits; + } + this.resultPoints = resultPoints; + this.format = format; + this.resultMetadata = null; + if (undefined === timestamp || null === timestamp) { + this.timestamp = System.currentTimeMillis(); + } + else { + this.timestamp = timestamp; + } + } + /** + * @return raw text encoded by the barcode + */ + getText() { + return this.text; + } + /** + * @return raw bytes encoded by the barcode, if applicable, otherwise {@code null} + */ + getRawBytes() { + return this.rawBytes; + } + /** + * @return how many bits of {@link #getRawBytes()} are valid; typically 8 times its length + * @since 3.3.0 + */ + getNumBits() { + return this.numBits; + } + /** + * @return points related to the barcode in the image. These are typically points + * identifying finder patterns or the corners of the barcode. The exact meaning is + * specific to the type of barcode that was decoded. + */ + getResultPoints() { + return this.resultPoints; + } + /** + * @return {@link BarcodeFormat} representing the format of the barcode that was decoded + */ + getBarcodeFormat() { + return this.format; + } + /** + * @return {@link Map} mapping {@link ResultMetadataType} keys to values. May be + * {@code null}. This contains optional metadata about what was detected about the barcode, + * like orientation. + */ + getResultMetadata() { + return this.resultMetadata; + } + putMetadata(type, value) { + if (this.resultMetadata === null) { + this.resultMetadata = new Map(); + } + this.resultMetadata.set(type, value); + } + putAllMetadata(metadata) { + if (metadata !== null) { + if (this.resultMetadata === null) { + this.resultMetadata = metadata; + } + else { + this.resultMetadata = new Map(metadata); + } + } + } + addResultPoints(newPoints) { + const oldPoints = this.resultPoints; + if (oldPoints === null) { + this.resultPoints = newPoints; + } + else if (newPoints !== null && newPoints.length > 0) { + const allPoints = new Array(oldPoints.length + newPoints.length); + System.arraycopy(oldPoints, 0, allPoints, 0, oldPoints.length); + System.arraycopy(newPoints, 0, allPoints, oldPoints.length, newPoints.length); + this.resultPoints = allPoints; + } + } + getTimestamp() { + return this.timestamp; + } + /*@Override*/ + toString() { + return this.text; + } + } + + /* + * Direct port to TypeScript of ZXing by Adrian Toșcă + */ + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * Enumerates barcode formats known to this package. Please keep alphabetized. + * + * @author Sean Owen + */ + var BarcodeFormat; + (function (BarcodeFormat) { + /** Aztec 2D barcode format. */ + BarcodeFormat[BarcodeFormat["AZTEC"] = 0] = "AZTEC"; + /** CODABAR 1D format. */ + BarcodeFormat[BarcodeFormat["CODABAR"] = 1] = "CODABAR"; + /** Code 39 1D format. */ + BarcodeFormat[BarcodeFormat["CODE_39"] = 2] = "CODE_39"; + /** Code 93 1D format. */ + BarcodeFormat[BarcodeFormat["CODE_93"] = 3] = "CODE_93"; + /** Code 128 1D format. */ + BarcodeFormat[BarcodeFormat["CODE_128"] = 4] = "CODE_128"; + /** Data Matrix 2D barcode format. */ + BarcodeFormat[BarcodeFormat["DATA_MATRIX"] = 5] = "DATA_MATRIX"; + /** EAN-8 1D format. */ + BarcodeFormat[BarcodeFormat["EAN_8"] = 6] = "EAN_8"; + /** EAN-13 1D format. */ + BarcodeFormat[BarcodeFormat["EAN_13"] = 7] = "EAN_13"; + /** ITF (Interleaved Two of Five) 1D format. */ + BarcodeFormat[BarcodeFormat["ITF"] = 8] = "ITF"; + /** MaxiCode 2D barcode format. */ + BarcodeFormat[BarcodeFormat["MAXICODE"] = 9] = "MAXICODE"; + /** PDF417 format. */ + BarcodeFormat[BarcodeFormat["PDF_417"] = 10] = "PDF_417"; + /** QR Code 2D barcode format. */ + BarcodeFormat[BarcodeFormat["QR_CODE"] = 11] = "QR_CODE"; + /** RSS 14 */ + BarcodeFormat[BarcodeFormat["RSS_14"] = 12] = "RSS_14"; + /** RSS EXPANDED */ + BarcodeFormat[BarcodeFormat["RSS_EXPANDED"] = 13] = "RSS_EXPANDED"; + /** UPC-A 1D format. */ + BarcodeFormat[BarcodeFormat["UPC_A"] = 14] = "UPC_A"; + /** UPC-E 1D format. */ + BarcodeFormat[BarcodeFormat["UPC_E"] = 15] = "UPC_E"; + /** UPC/EAN extension format. Not a stand-alone format. */ + BarcodeFormat[BarcodeFormat["UPC_EAN_EXTENSION"] = 16] = "UPC_EAN_EXTENSION"; + })(BarcodeFormat || (BarcodeFormat = {})); + var BarcodeFormat$1 = BarcodeFormat; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * Represents some type of metadata about the result of the decoding that the decoder + * wishes to communicate back to the caller. + * + * @author Sean Owen + */ + var ResultMetadataType; + (function (ResultMetadataType) { + /** + * Unspecified, application-specific metadata. Maps to an unspecified {@link Object}. + */ + ResultMetadataType[ResultMetadataType["OTHER"] = 0] = "OTHER"; + /** + * Denotes the likely approximate orientation of the barcode in the image. This value + * is given as degrees rotated clockwise from the normal, upright orientation. + * For example a 1D barcode which was found by reading top-to-bottom would be + * said to have orientation "90". This key maps to an {@link Integer} whose + * value is in the range [0,360). + */ + ResultMetadataType[ResultMetadataType["ORIENTATION"] = 1] = "ORIENTATION"; + /** + *

2D barcode formats typically encode text, but allow for a sort of 'byte mode' + * which is sometimes used to encode binary data. While {@link Result} makes available + * the complete raw bytes in the barcode for these formats, it does not offer the bytes + * from the byte segments alone.

+ * + *

This maps to a {@link java.util.List} of byte arrays corresponding to the + * raw bytes in the byte segments in the barcode, in order.

+ */ + ResultMetadataType[ResultMetadataType["BYTE_SEGMENTS"] = 2] = "BYTE_SEGMENTS"; + /** + * Error correction level used, if applicable. The value type depends on the + * format, but is typically a String. + */ + ResultMetadataType[ResultMetadataType["ERROR_CORRECTION_LEVEL"] = 3] = "ERROR_CORRECTION_LEVEL"; + /** + * For some periodicals, indicates the issue number as an {@link Integer}. + */ + ResultMetadataType[ResultMetadataType["ISSUE_NUMBER"] = 4] = "ISSUE_NUMBER"; + /** + * For some products, indicates the suggested retail price in the barcode as a + * formatted {@link String}. + */ + ResultMetadataType[ResultMetadataType["SUGGESTED_PRICE"] = 5] = "SUGGESTED_PRICE"; + /** + * For some products, the possible country of manufacture as a {@link String} denoting the + * ISO country code. Some map to multiple possible countries, like "US/CA". + */ + ResultMetadataType[ResultMetadataType["POSSIBLE_COUNTRY"] = 6] = "POSSIBLE_COUNTRY"; + /** + * For some products, the extension text + */ + ResultMetadataType[ResultMetadataType["UPC_EAN_EXTENSION"] = 7] = "UPC_EAN_EXTENSION"; + /** + * PDF417-specific metadata + */ + ResultMetadataType[ResultMetadataType["PDF417_EXTRA_METADATA"] = 8] = "PDF417_EXTRA_METADATA"; + /** + * If the code format supports structured append and the current scanned code is part of one then the + * sequence number is given with it. + */ + ResultMetadataType[ResultMetadataType["STRUCTURED_APPEND_SEQUENCE"] = 9] = "STRUCTURED_APPEND_SEQUENCE"; + /** + * If the code format supports structured append and the current scanned code is part of one then the + * parity is given with it. + */ + ResultMetadataType[ResultMetadataType["STRUCTURED_APPEND_PARITY"] = 10] = "STRUCTURED_APPEND_PARITY"; + })(ResultMetadataType || (ResultMetadataType = {})); + var ResultMetadataType$1 = ResultMetadataType; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing.common {*/ + /*import java.util.List;*/ + /** + *

Encapsulates the result of decoding a matrix of bits. This typically + * applies to 2D barcode formats. For now it contains the raw bytes obtained, + * as well as a String interpretation of those bytes, if applicable.

+ * + * @author Sean Owen + */ + class DecoderResult { + // public constructor(rawBytes: Uint8Array, + // text: string, + // List byteSegments, + // String ecLevel) { + // this(rawBytes, text, byteSegments, ecLevel, -1, -1) + // } + constructor(rawBytes, text, byteSegments, ecLevel, structuredAppendSequenceNumber = -1, structuredAppendParity = -1) { + this.rawBytes = rawBytes; + this.text = text; + this.byteSegments = byteSegments; + this.ecLevel = ecLevel; + this.structuredAppendSequenceNumber = structuredAppendSequenceNumber; + this.structuredAppendParity = structuredAppendParity; + this.numBits = (rawBytes === undefined || rawBytes === null) ? 0 : 8 * rawBytes.length; + } + /** + * @return raw bytes representing the result, or {@code null} if not applicable + */ + getRawBytes() { + return this.rawBytes; + } + /** + * @return how many bits of {@link #getRawBytes()} are valid; typically 8 times its length + * @since 3.3.0 + */ + getNumBits() { + return this.numBits; + } + /** + * @param numBits overrides the number of bits that are valid in {@link #getRawBytes()} + * @since 3.3.0 + */ + setNumBits(numBits /*int*/) { + this.numBits = numBits; + } + /** + * @return text representation of the result + */ + getText() { + return this.text; + } + /** + * @return list of byte segments in the result, or {@code null} if not applicable + */ + getByteSegments() { + return this.byteSegments; + } + /** + * @return name of error correction level used, or {@code null} if not applicable + */ + getECLevel() { + return this.ecLevel; + } + /** + * @return number of errors corrected, or {@code null} if not applicable + */ + getErrorsCorrected() { + return this.errorsCorrected; + } + setErrorsCorrected(errorsCorrected /*Integer*/) { + this.errorsCorrected = errorsCorrected; + } + /** + * @return number of erasures corrected, or {@code null} if not applicable + */ + getErasures() { + return this.erasures; + } + setErasures(erasures /*Integer*/) { + this.erasures = erasures; + } + /** + * @return arbitrary additional metadata + */ + getOther() { + return this.other; + } + setOther(other) { + this.other = other; + } + hasStructuredAppend() { + return this.structuredAppendParity >= 0 && this.structuredAppendSequenceNumber >= 0; + } + getStructuredAppendParity() { + return this.structuredAppendParity; + } + getStructuredAppendSequenceNumber() { + return this.structuredAppendSequenceNumber; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

This class contains utility methods for performing mathematical operations over + * the Galois Fields. Operations use a given primitive polynomial in calculations.

+ * + *

Throughout this package, elements of the GF are represented as an {@code int} + * for convenience and speed (but at the cost of memory). + *

+ * + * @author Sean Owen + * @author David Olivier + */ + class AbstractGenericGF { + /** + * @return 2 to the power of a in GF(size) + */ + exp(a) { + return this.expTable[a]; + } + /** + * @return base 2 log of a in GF(size) + */ + log(a /*int*/) { + if (a === 0) { + throw new IllegalArgumentException(); + } + return this.logTable[a]; + } + /** + * Implements both addition and subtraction -- they are the same in GF(size). + * + * @return sum/difference of a and b + */ + static addOrSubtract(a /*int*/, b /*int*/) { + return a ^ b; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Represents a polynomial whose coefficients are elements of a GF. + * Instances of this class are immutable.

+ * + *

Much credit is due to William Rucklidge since portions of this code are an indirect + * port of his C++ Reed-Solomon implementation.

+ * + * @author Sean Owen + */ + class GenericGFPoly { + /** + * @param field the {@link GenericGF} instance representing the field to use + * to perform computations + * @param coefficients coefficients as ints representing elements of GF(size), arranged + * from most significant (highest-power term) coefficient to least significant + * @throws IllegalArgumentException if argument is null or empty, + * or if leading coefficient is 0 and this is not a + * constant polynomial (that is, it is not the monomial "0") + */ + constructor(field, coefficients) { + if (coefficients.length === 0) { + throw new IllegalArgumentException(); + } + this.field = field; + const coefficientsLength = coefficients.length; + if (coefficientsLength > 1 && coefficients[0] === 0) { + // Leading term must be non-zero for anything except the constant polynomial "0" + let firstNonZero = 1; + while (firstNonZero < coefficientsLength && coefficients[firstNonZero] === 0) { + firstNonZero++; + } + if (firstNonZero === coefficientsLength) { + this.coefficients = Int32Array.from([0]); + } + else { + this.coefficients = new Int32Array(coefficientsLength - firstNonZero); + System.arraycopy(coefficients, firstNonZero, this.coefficients, 0, this.coefficients.length); + } + } + else { + this.coefficients = coefficients; + } + } + getCoefficients() { + return this.coefficients; + } + /** + * @return degree of this polynomial + */ + getDegree() { + return this.coefficients.length - 1; + } + /** + * @return true iff this polynomial is the monomial "0" + */ + isZero() { + return this.coefficients[0] === 0; + } + /** + * @return coefficient of x^degree term in this polynomial + */ + getCoefficient(degree /*int*/) { + return this.coefficients[this.coefficients.length - 1 - degree]; + } + /** + * @return evaluation of this polynomial at a given point + */ + evaluateAt(a /*int*/) { + if (a === 0) { + // Just return the x^0 coefficient + return this.getCoefficient(0); + } + const coefficients = this.coefficients; + let result; + if (a === 1) { + // Just the sum of the coefficients + result = 0; + for (let i = 0, length = coefficients.length; i !== length; i++) { + const coefficient = coefficients[i]; + result = AbstractGenericGF.addOrSubtract(result, coefficient); + } + return result; + } + result = coefficients[0]; + const size = coefficients.length; + const field = this.field; + for (let i = 1; i < size; i++) { + result = AbstractGenericGF.addOrSubtract(field.multiply(a, result), coefficients[i]); + } + return result; + } + addOrSubtract(other) { + if (!this.field.equals(other.field)) { + throw new IllegalArgumentException('GenericGFPolys do not have same GenericGF field'); + } + if (this.isZero()) { + return other; + } + if (other.isZero()) { + return this; + } + let smallerCoefficients = this.coefficients; + let largerCoefficients = other.coefficients; + if (smallerCoefficients.length > largerCoefficients.length) { + const temp = smallerCoefficients; + smallerCoefficients = largerCoefficients; + largerCoefficients = temp; + } + let sumDiff = new Int32Array(largerCoefficients.length); + const lengthDiff = largerCoefficients.length - smallerCoefficients.length; + // Copy high-order terms only found in higher-degree polynomial's coefficients + System.arraycopy(largerCoefficients, 0, sumDiff, 0, lengthDiff); + for (let i = lengthDiff; i < largerCoefficients.length; i++) { + sumDiff[i] = AbstractGenericGF.addOrSubtract(smallerCoefficients[i - lengthDiff], largerCoefficients[i]); + } + return new GenericGFPoly(this.field, sumDiff); + } + multiply(other) { + if (!this.field.equals(other.field)) { + throw new IllegalArgumentException('GenericGFPolys do not have same GenericGF field'); + } + if (this.isZero() || other.isZero()) { + return this.field.getZero(); + } + const aCoefficients = this.coefficients; + const aLength = aCoefficients.length; + const bCoefficients = other.coefficients; + const bLength = bCoefficients.length; + const product = new Int32Array(aLength + bLength - 1); + const field = this.field; + for (let i = 0; i < aLength; i++) { + const aCoeff = aCoefficients[i]; + for (let j = 0; j < bLength; j++) { + product[i + j] = AbstractGenericGF.addOrSubtract(product[i + j], field.multiply(aCoeff, bCoefficients[j])); + } + } + return new GenericGFPoly(field, product); + } + multiplyScalar(scalar /*int*/) { + if (scalar === 0) { + return this.field.getZero(); + } + if (scalar === 1) { + return this; + } + const size = this.coefficients.length; + const field = this.field; + const product = new Int32Array(size); + const coefficients = this.coefficients; + for (let i = 0; i < size; i++) { + product[i] = field.multiply(coefficients[i], scalar); + } + return new GenericGFPoly(field, product); + } + multiplyByMonomial(degree /*int*/, coefficient /*int*/) { + if (degree < 0) { + throw new IllegalArgumentException(); + } + if (coefficient === 0) { + return this.field.getZero(); + } + const coefficients = this.coefficients; + const size = coefficients.length; + const product = new Int32Array(size + degree); + const field = this.field; + for (let i = 0; i < size; i++) { + product[i] = field.multiply(coefficients[i], coefficient); + } + return new GenericGFPoly(field, product); + } + divide(other) { + if (!this.field.equals(other.field)) { + throw new IllegalArgumentException('GenericGFPolys do not have same GenericGF field'); + } + if (other.isZero()) { + throw new IllegalArgumentException('Divide by 0'); + } + const field = this.field; + let quotient = field.getZero(); + let remainder = this; + const denominatorLeadingTerm = other.getCoefficient(other.getDegree()); + const inverseDenominatorLeadingTerm = field.inverse(denominatorLeadingTerm); + while (remainder.getDegree() >= other.getDegree() && !remainder.isZero()) { + const degreeDifference = remainder.getDegree() - other.getDegree(); + const scale = field.multiply(remainder.getCoefficient(remainder.getDegree()), inverseDenominatorLeadingTerm); + const term = other.multiplyByMonomial(degreeDifference, scale); + const iterationQuotient = field.buildMonomial(degreeDifference, scale); + quotient = quotient.addOrSubtract(iterationQuotient); + remainder = remainder.addOrSubtract(term); + } + return [quotient, remainder]; + } + /*@Override*/ + toString() { + let result = ''; + for (let degree = this.getDegree(); degree >= 0; degree--) { + let coefficient = this.getCoefficient(degree); + if (coefficient !== 0) { + if (coefficient < 0) { + result += ' - '; + coefficient = -coefficient; + } + else { + if (result.length > 0) { + result += ' + '; + } + } + if (degree === 0 || coefficient !== 1) { + const alphaPower = this.field.log(coefficient); + if (alphaPower === 0) { + result += '1'; + } + else if (alphaPower === 1) { + result += 'a'; + } + else { + result += 'a^'; + result += alphaPower; + } + } + if (degree !== 0) { + if (degree === 1) { + result += 'x'; + } + else { + result += 'x^'; + result += degree; + } + } + } + } + return result; + } + } + + /** + * Custom Error class of type Exception. + */ + class ArithmeticException extends Exception { + } + ArithmeticException.kind = 'ArithmeticException'; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

This class contains utility methods for performing mathematical operations over + * the Galois Fields. Operations use a given primitive polynomial in calculations.

+ * + *

Throughout this package, elements of the GF are represented as an {@code int} + * for convenience and speed (but at the cost of memory). + *

+ * + * @author Sean Owen + * @author David Olivier + */ + class GenericGF extends AbstractGenericGF { + /** + * Create a representation of GF(size) using the given primitive polynomial. + * + * @param primitive irreducible polynomial whose coefficients are represented by + * the bits of an int, where the least-significant bit represents the constant + * coefficient + * @param size the size of the field + * @param b the factor b in the generator polynomial can be 0- or 1-based + * (g(x) = (x+a^b)(x+a^(b+1))...(x+a^(b+2t-1))). + * In most cases it should be 1, but for QR code it is 0. + */ + constructor(primitive /*int*/, size /*int*/, generatorBase /*int*/) { + super(); + this.primitive = primitive; + this.size = size; + this.generatorBase = generatorBase; + const expTable = new Int32Array(size); + let x = 1; + for (let i = 0; i < size; i++) { + expTable[i] = x; + x *= 2; // we're assuming the generator alpha is 2 + if (x >= size) { + x ^= primitive; + x &= size - 1; + } + } + this.expTable = expTable; + const logTable = new Int32Array(size); + for (let i = 0; i < size - 1; i++) { + logTable[expTable[i]] = i; + } + this.logTable = logTable; + // logTable[0] == 0 but this should never be used + this.zero = new GenericGFPoly(this, Int32Array.from([0])); + this.one = new GenericGFPoly(this, Int32Array.from([1])); + } + getZero() { + return this.zero; + } + getOne() { + return this.one; + } + /** + * @return the monomial representing coefficient * x^degree + */ + buildMonomial(degree /*int*/, coefficient /*int*/) { + if (degree < 0) { + throw new IllegalArgumentException(); + } + if (coefficient === 0) { + return this.zero; + } + const coefficients = new Int32Array(degree + 1); + coefficients[0] = coefficient; + return new GenericGFPoly(this, coefficients); + } + /** + * @return multiplicative inverse of a + */ + inverse(a /*int*/) { + if (a === 0) { + throw new ArithmeticException(); + } + return this.expTable[this.size - this.logTable[a] - 1]; + } + /** + * @return product of a and b in GF(size) + */ + multiply(a /*int*/, b /*int*/) { + if (a === 0 || b === 0) { + return 0; + } + return this.expTable[(this.logTable[a] + this.logTable[b]) % (this.size - 1)]; + } + getSize() { + return this.size; + } + getGeneratorBase() { + return this.generatorBase; + } + /*@Override*/ + toString() { + return ('GF(0x' + Integer.toHexString(this.primitive) + ',' + this.size + ')'); + } + equals(o) { + return o === this; + } + } + GenericGF.AZTEC_DATA_12 = new GenericGF(0x1069, 4096, 1); // x^12 + x^6 + x^5 + x^3 + 1 + GenericGF.AZTEC_DATA_10 = new GenericGF(0x409, 1024, 1); // x^10 + x^3 + 1 + GenericGF.AZTEC_DATA_6 = new GenericGF(0x43, 64, 1); // x^6 + x + 1 + GenericGF.AZTEC_PARAM = new GenericGF(0x13, 16, 1); // x^4 + x + 1 + GenericGF.QR_CODE_FIELD_256 = new GenericGF(0x011d, 256, 0); // x^8 + x^4 + x^3 + x^2 + 1 + GenericGF.DATA_MATRIX_FIELD_256 = new GenericGF(0x012d, 256, 1); // x^8 + x^5 + x^3 + x^2 + 1 + GenericGF.AZTEC_DATA_8 = GenericGF.DATA_MATRIX_FIELD_256; + GenericGF.MAXICODE_FIELD_64 = GenericGF.AZTEC_DATA_6; + + /** + * Custom Error class of type Exception. + */ + class ReedSolomonException extends Exception { + } + ReedSolomonException.kind = 'ReedSolomonException'; + + /** + * Custom Error class of type Exception. + */ + class IllegalStateException extends Exception { + } + IllegalStateException.kind = 'IllegalStateException'; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Implements Reed-Solomon decoding, as the name implies.

+ * + *

The algorithm will not be explained here, but the following references were helpful + * in creating this implementation:

+ * + * + * + *

Much credit is due to William Rucklidge since portions of this code are an indirect + * port of his C++ Reed-Solomon implementation.

+ * + * @author Sean Owen + * @author William Rucklidge + * @author sanfordsquires + */ + class ReedSolomonDecoder { + constructor(field) { + this.field = field; + } + /** + *

Decodes given set of received codewords, which include both data and error-correction + * codewords. Really, this means it uses Reed-Solomon to detect and correct errors, in-place, + * in the input.

+ * + * @param received data and error-correction codewords + * @param twoS number of error-correction codewords available + * @throws ReedSolomonException if decoding fails for any reason + */ + decode(received, twoS /*int*/) { + const field = this.field; + const poly = new GenericGFPoly(field, received); + const syndromeCoefficients = new Int32Array(twoS); + let noError = true; + for (let i = 0; i < twoS; i++) { + const evalResult = poly.evaluateAt(field.exp(i + field.getGeneratorBase())); + syndromeCoefficients[syndromeCoefficients.length - 1 - i] = evalResult; + if (evalResult !== 0) { + noError = false; + } + } + if (noError) { + return; + } + const syndrome = new GenericGFPoly(field, syndromeCoefficients); + const sigmaOmega = this.runEuclideanAlgorithm(field.buildMonomial(twoS, 1), syndrome, twoS); + const sigma = sigmaOmega[0]; + const omega = sigmaOmega[1]; + const errorLocations = this.findErrorLocations(sigma); + const errorMagnitudes = this.findErrorMagnitudes(omega, errorLocations); + for (let i = 0; i < errorLocations.length; i++) { + const position = received.length - 1 - field.log(errorLocations[i]); + if (position < 0) { + throw new ReedSolomonException('Bad error location'); + } + received[position] = GenericGF.addOrSubtract(received[position], errorMagnitudes[i]); + } + } + runEuclideanAlgorithm(a, b, R /*int*/) { + // Assume a's degree is >= b's + if (a.getDegree() < b.getDegree()) { + const temp = a; + a = b; + b = temp; + } + const field = this.field; + let rLast = a; + let r = b; + let tLast = field.getZero(); + let t = field.getOne(); + // Run Euclidean algorithm until r's degree is less than R/2 + while (r.getDegree() >= (R / 2 | 0)) { + let rLastLast = rLast; + let tLastLast = tLast; + rLast = r; + tLast = t; + // Divide rLastLast by rLast, with quotient in q and remainder in r + if (rLast.isZero()) { + // Oops, Euclidean algorithm already terminated? + throw new ReedSolomonException('r_{i-1} was zero'); + } + r = rLastLast; + let q = field.getZero(); + const denominatorLeadingTerm = rLast.getCoefficient(rLast.getDegree()); + const dltInverse = field.inverse(denominatorLeadingTerm); + while (r.getDegree() >= rLast.getDegree() && !r.isZero()) { + const degreeDiff = r.getDegree() - rLast.getDegree(); + const scale = field.multiply(r.getCoefficient(r.getDegree()), dltInverse); + q = q.addOrSubtract(field.buildMonomial(degreeDiff, scale)); + r = r.addOrSubtract(rLast.multiplyByMonomial(degreeDiff, scale)); + } + t = q.multiply(tLast).addOrSubtract(tLastLast); + if (r.getDegree() >= rLast.getDegree()) { + throw new IllegalStateException('Division algorithm failed to reduce polynomial?'); + } + } + const sigmaTildeAtZero = t.getCoefficient(0); + if (sigmaTildeAtZero === 0) { + throw new ReedSolomonException('sigmaTilde(0) was zero'); + } + const inverse = field.inverse(sigmaTildeAtZero); + const sigma = t.multiplyScalar(inverse); + const omega = r.multiplyScalar(inverse); + return [sigma, omega]; + } + findErrorLocations(errorLocator) { + // This is a direct application of Chien's search + const numErrors = errorLocator.getDegree(); + if (numErrors === 1) { // shortcut + return Int32Array.from([errorLocator.getCoefficient(1)]); + } + const result = new Int32Array(numErrors); + let e = 0; + const field = this.field; + for (let i = 1; i < field.getSize() && e < numErrors; i++) { + if (errorLocator.evaluateAt(i) === 0) { + result[e] = field.inverse(i); + e++; + } + } + if (e !== numErrors) { + throw new ReedSolomonException('Error locator degree does not match number of roots'); + } + return result; + } + findErrorMagnitudes(errorEvaluator, errorLocations) { + // This is directly applying Forney's Formula + const s = errorLocations.length; + const result = new Int32Array(s); + const field = this.field; + for (let i = 0; i < s; i++) { + const xiInverse = field.inverse(errorLocations[i]); + let denominator = 1; + for (let j = 0; j < s; j++) { + if (i !== j) { + // denominator = field.multiply(denominator, + // GenericGF.addOrSubtract(1, field.multiply(errorLocations[j], xiInverse))) + // Above should work but fails on some Apple and Linux JDKs due to a Hotspot bug. + // Below is a funny-looking workaround from Steven Parkes + const term = field.multiply(errorLocations[j], xiInverse); + const termPlus1 = (term & 0x1) === 0 ? term | 1 : term & ~1; + denominator = field.multiply(denominator, termPlus1); + } + } + result[i] = field.multiply(errorEvaluator.evaluateAt(xiInverse), field.inverse(denominator)); + if (field.getGeneratorBase() !== 0) { + result[i] = field.multiply(result[i], xiInverse); + } + } + return result; + } + } + + /* + * Copyright 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.Arrays; + var Table; + (function (Table) { + Table[Table["UPPER"] = 0] = "UPPER"; + Table[Table["LOWER"] = 1] = "LOWER"; + Table[Table["MIXED"] = 2] = "MIXED"; + Table[Table["DIGIT"] = 3] = "DIGIT"; + Table[Table["PUNCT"] = 4] = "PUNCT"; + Table[Table["BINARY"] = 5] = "BINARY"; + })(Table || (Table = {})); + /** + *

The main class which implements Aztec Code decoding -- as opposed to locating and extracting + * the Aztec Code from an image.

+ * + * @author David Olivier + */ + class Decoder { + decode(detectorResult) { + this.ddata = detectorResult; + let matrix = detectorResult.getBits(); + let rawbits = this.extractBits(matrix); + let correctedBits = this.correctBits(rawbits); + let rawBytes = Decoder.convertBoolArrayToByteArray(correctedBits); + let result = Decoder.getEncodedData(correctedBits); + let decoderResult = new DecoderResult(rawBytes, result, null, null); + decoderResult.setNumBits(correctedBits.length); + return decoderResult; + } + // This method is used for testing the high-level encoder + static highLevelDecode(correctedBits) { + return this.getEncodedData(correctedBits); + } + /** + * Gets the string encoded in the aztec code bits + * + * @return the decoded string + */ + static getEncodedData(correctedBits) { + let endIndex = correctedBits.length; + let latchTable = Table.UPPER; // table most recently latched to + let shiftTable = Table.UPPER; // table to use for the next read + let result = ''; + let index = 0; + while (index < endIndex) { + if (shiftTable === Table.BINARY) { + if (endIndex - index < 5) { + break; + } + let length = Decoder.readCode(correctedBits, index, 5); + index += 5; + if (length === 0) { + if (endIndex - index < 11) { + break; + } + length = Decoder.readCode(correctedBits, index, 11) + 31; + index += 11; + } + for (let charCount = 0; charCount < length; charCount++) { + if (endIndex - index < 8) { + index = endIndex; // Force outer loop to exit + break; + } + const code = Decoder.readCode(correctedBits, index, 8); + result += /*(char)*/ StringUtils.castAsNonUtf8Char(code); + index += 8; + } + // Go back to whatever mode we had been in + shiftTable = latchTable; + } + else { + let size = shiftTable === Table.DIGIT ? 4 : 5; + if (endIndex - index < size) { + break; + } + let code = Decoder.readCode(correctedBits, index, size); + index += size; + let str = Decoder.getCharacter(shiftTable, code); + if (str.startsWith('CTRL_')) { + // Table changes + // ISO/IEC 24778:2008 prescribes ending a shift sequence in the mode from which it was invoked. + // That's including when that mode is a shift. + // Our test case dlusbs.png for issue #642 exercises that. + latchTable = shiftTable; // Latch the current mode, so as to return to Upper after U/S B/S + shiftTable = Decoder.getTable(str.charAt(5)); + if (str.charAt(6) === 'L') { + latchTable = shiftTable; + } + } + else { + result += str; + // Go back to whatever mode we had been in + shiftTable = latchTable; + } + } + } + return result; + } + /** + * gets the table corresponding to the char passed + */ + static getTable(t) { + switch (t) { + case 'L': + return Table.LOWER; + case 'P': + return Table.PUNCT; + case 'M': + return Table.MIXED; + case 'D': + return Table.DIGIT; + case 'B': + return Table.BINARY; + case 'U': + default: + return Table.UPPER; + } + } + /** + * Gets the character (or string) corresponding to the passed code in the given table + * + * @param table the table used + * @param code the code of the character + */ + static getCharacter(table, code) { + switch (table) { + case Table.UPPER: + return Decoder.UPPER_TABLE[code]; + case Table.LOWER: + return Decoder.LOWER_TABLE[code]; + case Table.MIXED: + return Decoder.MIXED_TABLE[code]; + case Table.PUNCT: + return Decoder.PUNCT_TABLE[code]; + case Table.DIGIT: + return Decoder.DIGIT_TABLE[code]; + default: + // Should not reach here. + throw new IllegalStateException('Bad table'); + } + } + /** + *

Performs RS error correction on an array of bits.

+ * + * @return the corrected array + * @throws FormatException if the input contains too many errors + */ + correctBits(rawbits) { + let gf; + let codewordSize; + if (this.ddata.getNbLayers() <= 2) { + codewordSize = 6; + gf = GenericGF.AZTEC_DATA_6; + } + else if (this.ddata.getNbLayers() <= 8) { + codewordSize = 8; + gf = GenericGF.AZTEC_DATA_8; + } + else if (this.ddata.getNbLayers() <= 22) { + codewordSize = 10; + gf = GenericGF.AZTEC_DATA_10; + } + else { + codewordSize = 12; + gf = GenericGF.AZTEC_DATA_12; + } + let numDataCodewords = this.ddata.getNbDatablocks(); + let numCodewords = rawbits.length / codewordSize; + if (numCodewords < numDataCodewords) { + throw new FormatException(); + } + let offset = rawbits.length % codewordSize; + let dataWords = new Int32Array(numCodewords); + for (let i = 0; i < numCodewords; i++, offset += codewordSize) { + dataWords[i] = Decoder.readCode(rawbits, offset, codewordSize); + } + try { + let rsDecoder = new ReedSolomonDecoder(gf); + rsDecoder.decode(dataWords, numCodewords - numDataCodewords); + } + catch (ex) { + throw new FormatException(ex); + } + // Now perform the unstuffing operation. + // First, count how many bits are going to be thrown out as stuffing + let mask = (1 << codewordSize) - 1; + let stuffedBits = 0; + for (let i = 0; i < numDataCodewords; i++) { + let dataWord = dataWords[i]; + if (dataWord === 0 || dataWord === mask) { + throw new FormatException(); + } + else if (dataWord === 1 || dataWord === mask - 1) { + stuffedBits++; + } + } + // Now, actually unpack the bits and remove the stuffing + let correctedBits = new Array(numDataCodewords * codewordSize - stuffedBits); + let index = 0; + for (let i = 0; i < numDataCodewords; i++) { + let dataWord = dataWords[i]; + if (dataWord === 1 || dataWord === mask - 1) { + // next codewordSize-1 bits are all zeros or all ones + correctedBits.fill(dataWord > 1, index, index + codewordSize - 1); + // Arrays.fill(correctedBits, index, index + codewordSize - 1, dataWord > 1); + index += codewordSize - 1; + } + else { + for (let bit = codewordSize - 1; bit >= 0; --bit) { + correctedBits[index++] = (dataWord & (1 << bit)) !== 0; + } + } + } + return correctedBits; + } + /** + * Gets the array of bits from an Aztec Code matrix + * + * @return the array of bits + */ + extractBits(matrix) { + let compact = this.ddata.isCompact(); + let layers = this.ddata.getNbLayers(); + let baseMatrixSize = (compact ? 11 : 14) + layers * 4; // not including alignment lines + let alignmentMap = new Int32Array(baseMatrixSize); + let rawbits = new Array(this.totalBitsInLayer(layers, compact)); + if (compact) { + for (let i = 0; i < alignmentMap.length; i++) { + alignmentMap[i] = i; + } + } + else { + let matrixSize = baseMatrixSize + 1 + 2 * Integer.truncDivision((Integer.truncDivision(baseMatrixSize, 2) - 1), 15); + let origCenter = baseMatrixSize / 2; + let center = Integer.truncDivision(matrixSize, 2); + for (let i = 0; i < origCenter; i++) { + let newOffset = i + Integer.truncDivision(i, 15); + alignmentMap[origCenter - i - 1] = center - newOffset - 1; + alignmentMap[origCenter + i] = center + newOffset + 1; + } + } + for (let i = 0, rowOffset = 0; i < layers; i++) { + let rowSize = (layers - i) * 4 + (compact ? 9 : 12); + // The top-left most point of this layer is (not including alignment lines) + let low = i * 2; + // The bottom-right most point of this layer is (not including alignment lines) + let high = baseMatrixSize - 1 - low; + // We pull bits from the two 2 x rowSize columns and two rowSize x 2 rows + for (let j = 0; j < rowSize; j++) { + let columnOffset = j * 2; + for (let k = 0; k < 2; k++) { + // left column + rawbits[rowOffset + columnOffset + k] = + matrix.get(alignmentMap[low + k], alignmentMap[low + j]); + // bottom row + rawbits[rowOffset + 2 * rowSize + columnOffset + k] = + matrix.get(alignmentMap[low + j], alignmentMap[high - k]); + // right column + rawbits[rowOffset + 4 * rowSize + columnOffset + k] = + matrix.get(alignmentMap[high - k], alignmentMap[high - j]); + // top row + rawbits[rowOffset + 6 * rowSize + columnOffset + k] = + matrix.get(alignmentMap[high - j], alignmentMap[low + k]); + } + } + rowOffset += rowSize * 8; + } + return rawbits; + } + /** + * Reads a code of given length and at given index in an array of bits + */ + static readCode(rawbits, startIndex, length) { + let res = 0; + for (let i = startIndex; i < startIndex + length; i++) { + res <<= 1; + if (rawbits[i]) { + res |= 0x01; + } + } + return res; + } + /** + * Reads a code of length 8 in an array of bits, padding with zeros + */ + static readByte(rawbits, startIndex) { + let n = rawbits.length - startIndex; + if (n >= 8) { + return Decoder.readCode(rawbits, startIndex, 8); + } + return Decoder.readCode(rawbits, startIndex, n) << (8 - n); + } + /** + * Packs a bit array into bytes, most significant bit first + */ + static convertBoolArrayToByteArray(boolArr) { + let byteArr = new Uint8Array((boolArr.length + 7) / 8); + for (let i = 0; i < byteArr.length; i++) { + byteArr[i] = Decoder.readByte(boolArr, 8 * i); + } + return byteArr; + } + totalBitsInLayer(layers, compact) { + return ((compact ? 88 : 112) + 16 * layers) * layers; + } + } + Decoder.UPPER_TABLE = [ + 'CTRL_PS', ' ', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', + 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'CTRL_LL', 'CTRL_ML', 'CTRL_DL', 'CTRL_BS' + ]; + Decoder.LOWER_TABLE = [ + 'CTRL_PS', ' ', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', + 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'CTRL_US', 'CTRL_ML', 'CTRL_DL', 'CTRL_BS' + ]; + Decoder.MIXED_TABLE = [ + // Module parse failed: Octal literal in strict mode (50:29) + // so number string were scaped + 'CTRL_PS', ' ', '\\1', '\\2', '\\3', '\\4', '\\5', '\\6', '\\7', '\b', '\t', '\n', + '\\13', '\f', '\r', '\\33', '\\34', '\\35', '\\36', '\\37', '@', '\\', '^', '_', + '`', '|', '~', '\\177', 'CTRL_LL', 'CTRL_UL', 'CTRL_PL', 'CTRL_BS' + ]; + Decoder.PUNCT_TABLE = [ + '', '\r', '\r\n', '. ', ', ', ': ', '!', '"', '#', '$', '%', '&', '\'', '(', ')', + '*', '+', ',', '-', '.', '/', ':', ';', '<', '=', '>', '?', '[', ']', '{', '}', 'CTRL_UL' + ]; + Decoder.DIGIT_TABLE = [ + 'CTRL_PS', ' ', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ',', '.', 'CTRL_UL', 'CTRL_US' + ]; + + /* + * Copyright 2012 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing.common.detector {*/ + /** + * General math-related and numeric utility functions. + */ + class MathUtils { + constructor() { } + /** + * Ends up being a bit faster than {@link Math#round(float)}. This merely rounds its + * argument to the nearest int, where x.5 rounds up to x+1. Semantics of this shortcut + * differ slightly from {@link Math#round(float)} in that half rounds down for negative + * values. -2.5 rounds to -3, not -2. For purposes here it makes no difference. + * + * @param d real value to round + * @return nearest {@code int} + */ + static round(d /*float*/) { + if (NaN === d) + return 0; + if (d <= Number.MIN_SAFE_INTEGER) + return Number.MIN_SAFE_INTEGER; + if (d >= Number.MAX_SAFE_INTEGER) + return Number.MAX_SAFE_INTEGER; + return /*(int) */ (d + (d < 0.0 ? -0.5 : 0.5)) | 0; + } + // TYPESCRIPTPORT: maybe remove round method and call directly Math.round, it looks like it doesn't make sense for js + /** + * @param aX point A x coordinate + * @param aY point A y coordinate + * @param bX point B x coordinate + * @param bY point B y coordinate + * @return Euclidean distance between points A and B + */ + static distance(aX /*float|int*/, aY /*float|int*/, bX /*float|int*/, bY /*float|int*/) { + const xDiff = aX - bX; + const yDiff = aY - bY; + return /*(float) */ Math.sqrt(xDiff * xDiff + yDiff * yDiff); + } + /** + * @param aX point A x coordinate + * @param aY point A y coordinate + * @param bX point B x coordinate + * @param bY point B y coordinate + * @return Euclidean distance between points A and B + */ + // public static distance(aX: number /*int*/, aY: number /*int*/, bX: number /*int*/, bY: number /*int*/): float { + // const xDiff = aX - bX + // const yDiff = aY - bY + // return (float) Math.sqrt(xDiff * xDiff + yDiff * yDiff); + // } + /** + * @param array values to sum + * @return sum of values in array + */ + static sum(array) { + let count = 0; + for (let i = 0, length = array.length; i !== length; i++) { + const a = array[i]; + count += a; + } + return count; + } + } + + /** + * Ponyfill for Java's Float class. + */ + class Float { + /** + * SincTS has no difference between int and float, there's all numbers, + * this is used only to polyfill Java code. + */ + static floatToIntBits(f) { + return f; + } + } + /** + * The float max value in JS is the number max value. + */ + Float.MAX_VALUE = Number.MAX_SAFE_INTEGER; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates a point of interest in an image containing a barcode. Typically, this + * would be the location of a finder pattern or the corner of the barcode, for example.

+ * + * @author Sean Owen + */ + class ResultPoint { + constructor(x, y) { + this.x = x; + this.y = y; + } + getX() { + return this.x; + } + getY() { + return this.y; + } + /*@Override*/ + equals(other) { + if (other instanceof ResultPoint) { + const otherPoint = other; + return this.x === otherPoint.x && this.y === otherPoint.y; + } + return false; + } + /*@Override*/ + hashCode() { + return 31 * Float.floatToIntBits(this.x) + Float.floatToIntBits(this.y); + } + /*@Override*/ + toString() { + return '(' + this.x + ',' + this.y + ')'; + } + /** + * Orders an array of three ResultPoints in an order [A,B,C] such that AB is less than AC + * and BC is less than AC, and the angle between BC and BA is less than 180 degrees. + * + * @param patterns array of three {@code ResultPoint} to order + */ + static orderBestPatterns(patterns) { + // Find distances between pattern centers + const zeroOneDistance = this.distance(patterns[0], patterns[1]); + const oneTwoDistance = this.distance(patterns[1], patterns[2]); + const zeroTwoDistance = this.distance(patterns[0], patterns[2]); + let pointA; + let pointB; + let pointC; + // Assume one closest to other two is B; A and C will just be guesses at first + if (oneTwoDistance >= zeroOneDistance && oneTwoDistance >= zeroTwoDistance) { + pointB = patterns[0]; + pointA = patterns[1]; + pointC = patterns[2]; + } + else if (zeroTwoDistance >= oneTwoDistance && zeroTwoDistance >= zeroOneDistance) { + pointB = patterns[1]; + pointA = patterns[0]; + pointC = patterns[2]; + } + else { + pointB = patterns[2]; + pointA = patterns[0]; + pointC = patterns[1]; + } + // Use cross product to figure out whether A and C are correct or flipped. + // This asks whether BC x BA has a positive z component, which is the arrangement + // we want for A, B, C. If it's negative, then we've got it flipped around and + // should swap A and C. + if (this.crossProductZ(pointA, pointB, pointC) < 0.0) { + const temp = pointA; + pointA = pointC; + pointC = temp; + } + patterns[0] = pointA; + patterns[1] = pointB; + patterns[2] = pointC; + } + /** + * @param pattern1 first pattern + * @param pattern2 second pattern + * @return distance between two points + */ + static distance(pattern1, pattern2) { + return MathUtils.distance(pattern1.x, pattern1.y, pattern2.x, pattern2.y); + } + /** + * Returns the z component of the cross product between vectors BC and BA. + */ + static crossProductZ(pointA, pointB, pointC) { + const bX = pointB.x; + const bY = pointB.y; + return ((pointC.x - bX) * (pointA.y - bY)) - ((pointC.y - bY) * (pointA.x - bX)); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates the result of detecting a barcode in an image. This includes the raw + * matrix of black/white pixels corresponding to the barcode, and possibly points of interest + * in the image, like the location of finder patterns or corners of the barcode in the image.

+ * + * @author Sean Owen + */ + class DetectorResult { + constructor(bits, points) { + this.bits = bits; + this.points = points; + } + getBits() { + return this.bits; + } + getPoints() { + return this.points; + } + } + + /* + * Copyright 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Extends {@link DetectorResult} with more information specific to the Aztec format, + * like the number of layers and whether it's compact.

+ * + * @author Sean Owen + */ + class AztecDetectorResult extends DetectorResult { + constructor(bits, points, compact, nbDatablocks, nbLayers) { + super(bits, points); + this.compact = compact; + this.nbDatablocks = nbDatablocks; + this.nbLayers = nbLayers; + } + getNbLayers() { + return this.nbLayers; + } + getNbDatablocks() { + return this.nbDatablocks; + } + isCompact() { + return this.compact; + } + } + + /* + * Copyright 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

+ * Detects a candidate barcode-like rectangular region within an image. It + * starts around the center of the image, increases the size of the candidate + * region until it finds a white rectangular region. By keeping track of the + * last black points it encountered, it determines the corners of the barcode. + *

+ * + * @author David Olivier + */ + class WhiteRectangleDetector { + // public constructor(private image: BitMatrix) /*throws NotFoundException*/ { + // this(image, INIT_SIZE, image.getWidth() / 2, image.getHeight() / 2) + // } + /** + * @param image barcode image to find a rectangle in + * @param initSize initial size of search area around center + * @param x x position of search center + * @param y y position of search center + * @throws NotFoundException if image is too small to accommodate {@code initSize} + */ + constructor(image, initSize /*int*/, x /*int*/, y /*int*/) { + this.image = image; + this.height = image.getHeight(); + this.width = image.getWidth(); + if (undefined === initSize || null === initSize) { + initSize = WhiteRectangleDetector.INIT_SIZE; + } + if (undefined === x || null === x) { + x = image.getWidth() / 2 | 0; + } + if (undefined === y || null === y) { + y = image.getHeight() / 2 | 0; + } + const halfsize = initSize / 2 | 0; + this.leftInit = x - halfsize; + this.rightInit = x + halfsize; + this.upInit = y - halfsize; + this.downInit = y + halfsize; + if (this.upInit < 0 || this.leftInit < 0 || this.downInit >= this.height || this.rightInit >= this.width) { + throw new NotFoundException(); + } + } + /** + *

+ * Detects a candidate barcode-like rectangular region within an image. It + * starts around the center of the image, increases the size of the candidate + * region until it finds a white rectangular region. + *

+ * + * @return {@link ResultPoint}[] describing the corners of the rectangular + * region. The first and last points are opposed on the diagonal, as + * are the second and third. The first point will be the topmost + * point and the last, the bottommost. The second point will be + * leftmost and the third, the rightmost + * @throws NotFoundException if no Data Matrix Code can be found + */ + detect() { + let left = this.leftInit; + let right = this.rightInit; + let up = this.upInit; + let down = this.downInit; + let sizeExceeded = false; + let aBlackPointFoundOnBorder = true; + let atLeastOneBlackPointFoundOnBorder = false; + let atLeastOneBlackPointFoundOnRight = false; + let atLeastOneBlackPointFoundOnBottom = false; + let atLeastOneBlackPointFoundOnLeft = false; + let atLeastOneBlackPointFoundOnTop = false; + const width = this.width; + const height = this.height; + while (aBlackPointFoundOnBorder) { + aBlackPointFoundOnBorder = false; + // ..... + // . | + // ..... + let rightBorderNotWhite = true; + while ((rightBorderNotWhite || !atLeastOneBlackPointFoundOnRight) && right < width) { + rightBorderNotWhite = this.containsBlackPoint(up, down, right, false); + if (rightBorderNotWhite) { + right++; + aBlackPointFoundOnBorder = true; + atLeastOneBlackPointFoundOnRight = true; + } + else if (!atLeastOneBlackPointFoundOnRight) { + right++; + } + } + if (right >= width) { + sizeExceeded = true; + break; + } + // ..... + // . . + // .___. + let bottomBorderNotWhite = true; + while ((bottomBorderNotWhite || !atLeastOneBlackPointFoundOnBottom) && down < height) { + bottomBorderNotWhite = this.containsBlackPoint(left, right, down, true); + if (bottomBorderNotWhite) { + down++; + aBlackPointFoundOnBorder = true; + atLeastOneBlackPointFoundOnBottom = true; + } + else if (!atLeastOneBlackPointFoundOnBottom) { + down++; + } + } + if (down >= height) { + sizeExceeded = true; + break; + } + // ..... + // | . + // ..... + let leftBorderNotWhite = true; + while ((leftBorderNotWhite || !atLeastOneBlackPointFoundOnLeft) && left >= 0) { + leftBorderNotWhite = this.containsBlackPoint(up, down, left, false); + if (leftBorderNotWhite) { + left--; + aBlackPointFoundOnBorder = true; + atLeastOneBlackPointFoundOnLeft = true; + } + else if (!atLeastOneBlackPointFoundOnLeft) { + left--; + } + } + if (left < 0) { + sizeExceeded = true; + break; + } + // .___. + // . . + // ..... + let topBorderNotWhite = true; + while ((topBorderNotWhite || !atLeastOneBlackPointFoundOnTop) && up >= 0) { + topBorderNotWhite = this.containsBlackPoint(left, right, up, true); + if (topBorderNotWhite) { + up--; + aBlackPointFoundOnBorder = true; + atLeastOneBlackPointFoundOnTop = true; + } + else if (!atLeastOneBlackPointFoundOnTop) { + up--; + } + } + if (up < 0) { + sizeExceeded = true; + break; + } + if (aBlackPointFoundOnBorder) { + atLeastOneBlackPointFoundOnBorder = true; + } + } + if (!sizeExceeded && atLeastOneBlackPointFoundOnBorder) { + const maxSize = right - left; + let z = null; + for (let i = 1; z === null && i < maxSize; i++) { + z = this.getBlackPointOnSegment(left, down - i, left + i, down); + } + if (z == null) { + throw new NotFoundException(); + } + let t = null; + // go down right + for (let i = 1; t === null && i < maxSize; i++) { + t = this.getBlackPointOnSegment(left, up + i, left + i, up); + } + if (t == null) { + throw new NotFoundException(); + } + let x = null; + // go down left + for (let i = 1; x === null && i < maxSize; i++) { + x = this.getBlackPointOnSegment(right, up + i, right - i, up); + } + if (x == null) { + throw new NotFoundException(); + } + let y = null; + // go up left + for (let i = 1; y === null && i < maxSize; i++) { + y = this.getBlackPointOnSegment(right, down - i, right - i, down); + } + if (y == null) { + throw new NotFoundException(); + } + return this.centerEdges(y, z, x, t); + } + else { + throw new NotFoundException(); + } + } + getBlackPointOnSegment(aX /*float*/, aY /*float*/, bX /*float*/, bY /*float*/) { + const dist = MathUtils.round(MathUtils.distance(aX, aY, bX, bY)); + const xStep = (bX - aX) / dist; + const yStep = (bY - aY) / dist; + const image = this.image; + for (let i = 0; i < dist; i++) { + const x = MathUtils.round(aX + i * xStep); + const y = MathUtils.round(aY + i * yStep); + if (image.get(x, y)) { + return new ResultPoint(x, y); + } + } + return null; + } + /** + * recenters the points of a constant distance towards the center + * + * @param y bottom most point + * @param z left most point + * @param x right most point + * @param t top most point + * @return {@link ResultPoint}[] describing the corners of the rectangular + * region. The first and last points are opposed on the diagonal, as + * are the second and third. The first point will be the topmost + * point and the last, the bottommost. The second point will be + * leftmost and the third, the rightmost + */ + centerEdges(y, z, x, t) { + // + // t t + // z x + // x OR z + // y y + // + const yi = y.getX(); + const yj = y.getY(); + const zi = z.getX(); + const zj = z.getY(); + const xi = x.getX(); + const xj = x.getY(); + const ti = t.getX(); + const tj = t.getY(); + const CORR = WhiteRectangleDetector.CORR; + if (yi < this.width / 2.0) { + return [ + new ResultPoint(ti - CORR, tj + CORR), + new ResultPoint(zi + CORR, zj + CORR), + new ResultPoint(xi - CORR, xj - CORR), + new ResultPoint(yi + CORR, yj - CORR) + ]; + } + else { + return [ + new ResultPoint(ti + CORR, tj + CORR), + new ResultPoint(zi + CORR, zj - CORR), + new ResultPoint(xi - CORR, xj + CORR), + new ResultPoint(yi - CORR, yj - CORR) + ]; + } + } + /** + * Determines whether a segment contains a black point + * + * @param a min value of the scanned coordinate + * @param b max value of the scanned coordinate + * @param fixed value of fixed coordinate + * @param horizontal set to true if scan must be horizontal, false if vertical + * @return true if a black point has been found, else false. + */ + containsBlackPoint(a /*int*/, b /*int*/, fixed /*int*/, horizontal) { + const image = this.image; + if (horizontal) { + for (let x = a; x <= b; x++) { + if (image.get(x, fixed)) { + return true; + } + } + } + else { + for (let y = a; y <= b; y++) { + if (image.get(fixed, y)) { + return true; + } + } + } + return false; + } + } + WhiteRectangleDetector.INIT_SIZE = 10; + WhiteRectangleDetector.CORR = 1; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Implementations of this class can, given locations of finder patterns for a QR code in an + * image, sample the right points in the image to reconstruct the QR code, accounting for + * perspective distortion. It is abstracted since it is relatively expensive and should be allowed + * to take advantage of platform-specific optimized implementations, like Sun's Java Advanced + * Imaging library, but which may not be available in other environments such as J2ME, and vice + * versa. + * + * The implementation used can be controlled by calling {@link #setGridSampler(GridSampler)} + * with an instance of a class which implements this interface. + * + * @author Sean Owen + */ + class GridSampler { + /** + *

Checks a set of points that have been transformed to sample points on an image against + * the image's dimensions to see if the point are even within the image.

+ * + *

This method will actually "nudge" the endpoints back onto the image if they are found to be + * barely (less than 1 pixel) off the image. This accounts for imperfect detection of finder + * patterns in an image where the QR Code runs all the way to the image border.

+ * + *

For efficiency, the method will check points from either end of the line until one is found + * to be within the image. Because the set of points are assumed to be linear, this is valid.

+ * + * @param image image into which the points should map + * @param points actual points in x1,y1,...,xn,yn form + * @throws NotFoundException if an endpoint is lies outside the image boundaries + */ + static checkAndNudgePoints(image, points) { + const width = image.getWidth(); + const height = image.getHeight(); + // Check and nudge points from start until we see some that are OK: + let nudged = true; + for (let offset = 0; offset < points.length && nudged; offset += 2) { + const x = Math.floor(points[offset]); + const y = Math.floor(points[offset + 1]); + if (x < -1 || x > width || y < -1 || y > height) { + throw new NotFoundException(); + } + nudged = false; + if (x === -1) { + points[offset] = 0.0; + nudged = true; + } + else if (x === width) { + points[offset] = width - 1; + nudged = true; + } + if (y === -1) { + points[offset + 1] = 0.0; + nudged = true; + } + else if (y === height) { + points[offset + 1] = height - 1; + nudged = true; + } + } + // Check and nudge points from end: + nudged = true; + for (let offset = points.length - 2; offset >= 0 && nudged; offset -= 2) { + const x = Math.floor(points[offset]); + const y = Math.floor(points[offset + 1]); + if (x < -1 || x > width || y < -1 || y > height) { + throw new NotFoundException(); + } + nudged = false; + if (x === -1) { + points[offset] = 0.0; + nudged = true; + } + else if (x === width) { + points[offset] = width - 1; + nudged = true; + } + if (y === -1) { + points[offset + 1] = 0.0; + nudged = true; + } + else if (y === height) { + points[offset + 1] = height - 1; + nudged = true; + } + } + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing.common {*/ + /** + *

This class implements a perspective transform in two dimensions. Given four source and four + * destination points, it will compute the transformation implied between them. The code is based + * directly upon section 3.4.2 of George Wolberg's "Digital Image Warping"; see pages 54-56.

+ * + * @author Sean Owen + */ + class PerspectiveTransform { + constructor(a11 /*float*/, a21 /*float*/, a31 /*float*/, a12 /*float*/, a22 /*float*/, a32 /*float*/, a13 /*float*/, a23 /*float*/, a33 /*float*/) { + this.a11 = a11; + this.a21 = a21; + this.a31 = a31; + this.a12 = a12; + this.a22 = a22; + this.a32 = a32; + this.a13 = a13; + this.a23 = a23; + this.a33 = a33; + } + static quadrilateralToQuadrilateral(x0 /*float*/, y0 /*float*/, x1 /*float*/, y1 /*float*/, x2 /*float*/, y2 /*float*/, x3 /*float*/, y3 /*float*/, x0p /*float*/, y0p /*float*/, x1p /*float*/, y1p /*float*/, x2p /*float*/, y2p /*float*/, x3p /*float*/, y3p /*float*/) { + const qToS = PerspectiveTransform.quadrilateralToSquare(x0, y0, x1, y1, x2, y2, x3, y3); + const sToQ = PerspectiveTransform.squareToQuadrilateral(x0p, y0p, x1p, y1p, x2p, y2p, x3p, y3p); + return sToQ.times(qToS); + } + transformPoints(points) { + const max = points.length; + const a11 = this.a11; + const a12 = this.a12; + const a13 = this.a13; + const a21 = this.a21; + const a22 = this.a22; + const a23 = this.a23; + const a31 = this.a31; + const a32 = this.a32; + const a33 = this.a33; + for (let i = 0; i < max; i += 2) { + const x = points[i]; + const y = points[i + 1]; + const denominator = a13 * x + a23 * y + a33; + points[i] = (a11 * x + a21 * y + a31) / denominator; + points[i + 1] = (a12 * x + a22 * y + a32) / denominator; + } + } + transformPointsWithValues(xValues, yValues) { + const a11 = this.a11; + const a12 = this.a12; + const a13 = this.a13; + const a21 = this.a21; + const a22 = this.a22; + const a23 = this.a23; + const a31 = this.a31; + const a32 = this.a32; + const a33 = this.a33; + const n = xValues.length; + for (let i = 0; i < n; i++) { + const x = xValues[i]; + const y = yValues[i]; + const denominator = a13 * x + a23 * y + a33; + xValues[i] = (a11 * x + a21 * y + a31) / denominator; + yValues[i] = (a12 * x + a22 * y + a32) / denominator; + } + } + static squareToQuadrilateral(x0 /*float*/, y0 /*float*/, x1 /*float*/, y1 /*float*/, x2 /*float*/, y2 /*float*/, x3 /*float*/, y3 /*float*/) { + const dx3 = x0 - x1 + x2 - x3; + const dy3 = y0 - y1 + y2 - y3; + if (dx3 === 0.0 && dy3 === 0.0) { + // Affine + return new PerspectiveTransform(x1 - x0, x2 - x1, x0, y1 - y0, y2 - y1, y0, 0.0, 0.0, 1.0); + } + else { + const dx1 = x1 - x2; + const dx2 = x3 - x2; + const dy1 = y1 - y2; + const dy2 = y3 - y2; + const denominator = dx1 * dy2 - dx2 * dy1; + const a13 = (dx3 * dy2 - dx2 * dy3) / denominator; + const a23 = (dx1 * dy3 - dx3 * dy1) / denominator; + return new PerspectiveTransform(x1 - x0 + a13 * x1, x3 - x0 + a23 * x3, x0, y1 - y0 + a13 * y1, y3 - y0 + a23 * y3, y0, a13, a23, 1.0); + } + } + static quadrilateralToSquare(x0 /*float*/, y0 /*float*/, x1 /*float*/, y1 /*float*/, x2 /*float*/, y2 /*float*/, x3 /*float*/, y3 /*float*/) { + // Here, the adjoint serves as the inverse: + return PerspectiveTransform.squareToQuadrilateral(x0, y0, x1, y1, x2, y2, x3, y3).buildAdjoint(); + } + buildAdjoint() { + // Adjoint is the transpose of the cofactor matrix: + return new PerspectiveTransform(this.a22 * this.a33 - this.a23 * this.a32, this.a23 * this.a31 - this.a21 * this.a33, this.a21 * this.a32 - this.a22 * this.a31, this.a13 * this.a32 - this.a12 * this.a33, this.a11 * this.a33 - this.a13 * this.a31, this.a12 * this.a31 - this.a11 * this.a32, this.a12 * this.a23 - this.a13 * this.a22, this.a13 * this.a21 - this.a11 * this.a23, this.a11 * this.a22 - this.a12 * this.a21); + } + times(other) { + return new PerspectiveTransform(this.a11 * other.a11 + this.a21 * other.a12 + this.a31 * other.a13, this.a11 * other.a21 + this.a21 * other.a22 + this.a31 * other.a23, this.a11 * other.a31 + this.a21 * other.a32 + this.a31 * other.a33, this.a12 * other.a11 + this.a22 * other.a12 + this.a32 * other.a13, this.a12 * other.a21 + this.a22 * other.a22 + this.a32 * other.a23, this.a12 * other.a31 + this.a22 * other.a32 + this.a32 * other.a33, this.a13 * other.a11 + this.a23 * other.a12 + this.a33 * other.a13, this.a13 * other.a21 + this.a23 * other.a22 + this.a33 * other.a23, this.a13 * other.a31 + this.a23 * other.a32 + this.a33 * other.a33); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Sean Owen + */ + class DefaultGridSampler extends GridSampler { + /*@Override*/ + sampleGrid(image, dimensionX /*int*/, dimensionY /*int*/, p1ToX /*float*/, p1ToY /*float*/, p2ToX /*float*/, p2ToY /*float*/, p3ToX /*float*/, p3ToY /*float*/, p4ToX /*float*/, p4ToY /*float*/, p1FromX /*float*/, p1FromY /*float*/, p2FromX /*float*/, p2FromY /*float*/, p3FromX /*float*/, p3FromY /*float*/, p4FromX /*float*/, p4FromY /*float*/) { + const transform = PerspectiveTransform.quadrilateralToQuadrilateral(p1ToX, p1ToY, p2ToX, p2ToY, p3ToX, p3ToY, p4ToX, p4ToY, p1FromX, p1FromY, p2FromX, p2FromY, p3FromX, p3FromY, p4FromX, p4FromY); + return this.sampleGridWithTransform(image, dimensionX, dimensionY, transform); + } + /*@Override*/ + sampleGridWithTransform(image, dimensionX /*int*/, dimensionY /*int*/, transform) { + if (dimensionX <= 0 || dimensionY <= 0) { + throw new NotFoundException(); + } + const bits = new BitMatrix(dimensionX, dimensionY); + const points = new Float32Array(2 * dimensionX); + for (let y = 0; y < dimensionY; y++) { + const max = points.length; + const iValue = y + 0.5; + for (let x = 0; x < max; x += 2) { + points[x] = (x / 2) + 0.5; + points[x + 1] = iValue; + } + transform.transformPoints(points); + // Quick check to see if points transformed to something inside the image + // sufficient to check the endpoints + GridSampler.checkAndNudgePoints(image, points); + try { + for (let x = 0; x < max; x += 2) { + if (image.get(Math.floor(points[x]), Math.floor(points[x + 1]))) { + // Black(-ish) pixel + bits.set(x / 2, y); + } + } + } + catch (aioobe /*: ArrayIndexOutOfBoundsException*/) { + // This feels wrong, but, sometimes if the finder patterns are misidentified, the resulting + // transform gets "twisted" such that it maps a straight line of points to a set of points + // whose endpoints are in bounds, but others are not. There is probably some mathematical + // way to detect this about the transformation that I don't know yet. + // This results in an ugly runtime exception despite our clever checks above -- can't have + // that. We could check each point's coordinates but that feels duplicative. We settle for + // catching and wrapping ArrayIndexOutOfBoundsException. + throw new NotFoundException(); + } + } + return bits; + } + } + + class GridSamplerInstance { + /** + * Sets the implementation of GridSampler used by the library. One global + * instance is stored, which may sound problematic. But, the implementation provided + * ought to be appropriate for the entire platform, and all uses of this library + * in the whole lifetime of the JVM. For instance, an Android activity can swap in + * an implementation that takes advantage of native platform libraries. + * + * @param newGridSampler The platform-specific object to install. + */ + static setGridSampler(newGridSampler) { + GridSamplerInstance.gridSampler = newGridSampler; + } + /** + * @return the current implementation of GridSampler + */ + static getInstance() { + return GridSamplerInstance.gridSampler; + } + } + GridSamplerInstance.gridSampler = new DefaultGridSampler(); + + /* + * Copyright 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + class Point { + constructor(x, y) { + this.x = x; + this.y = y; + } + toResultPoint() { + return new ResultPoint(this.getX(), this.getY()); + } + getX() { + return this.x; + } + getY() { + return this.y; + } + } + /** + * Encapsulates logic that can detect an Aztec Code in an image, even if the Aztec Code + * is rotated or skewed, or partially obscured. + * + * @author David Olivier + * @author Frank Yellin + */ + class Detector { + constructor(image) { + this.EXPECTED_CORNER_BITS = new Int32Array([ + 0xee0, + 0x1dc, + 0x83b, + 0x707, + ]); + this.image = image; + } + detect() { + return this.detectMirror(false); + } + /** + * Detects an Aztec Code in an image. + * + * @param isMirror if true, image is a mirror-image of original + * @return {@link AztecDetectorResult} encapsulating results of detecting an Aztec Code + * @throws NotFoundException if no Aztec Code can be found + */ + detectMirror(isMirror) { + // 1. Get the center of the aztec matrix + let pCenter = this.getMatrixCenter(); + // 2. Get the center points of the four diagonal points just outside the bull's eye + // [topRight, bottomRight, bottomLeft, topLeft] + let bullsEyeCorners = this.getBullsEyeCorners(pCenter); + if (isMirror) { + let temp = bullsEyeCorners[0]; + bullsEyeCorners[0] = bullsEyeCorners[2]; + bullsEyeCorners[2] = temp; + } + // 3. Get the size of the matrix and other parameters from the bull's eye + this.extractParameters(bullsEyeCorners); + // 4. Sample the grid + let bits = this.sampleGrid(this.image, bullsEyeCorners[this.shift % 4], bullsEyeCorners[(this.shift + 1) % 4], bullsEyeCorners[(this.shift + 2) % 4], bullsEyeCorners[(this.shift + 3) % 4]); + // 5. Get the corners of the matrix. + let corners = this.getMatrixCornerPoints(bullsEyeCorners); + return new AztecDetectorResult(bits, corners, this.compact, this.nbDataBlocks, this.nbLayers); + } + /** + * Extracts the number of data layers and data blocks from the layer around the bull's eye. + * + * @param bullsEyeCorners the array of bull's eye corners + * @throws NotFoundException in case of too many errors or invalid parameters + */ + extractParameters(bullsEyeCorners) { + if (!this.isValidPoint(bullsEyeCorners[0]) || !this.isValidPoint(bullsEyeCorners[1]) || + !this.isValidPoint(bullsEyeCorners[2]) || !this.isValidPoint(bullsEyeCorners[3])) { + throw new NotFoundException(); + } + let length = 2 * this.nbCenterLayers; + // Get the bits around the bull's eye + let sides = new Int32Array([ + this.sampleLine(bullsEyeCorners[0], bullsEyeCorners[1], length), + this.sampleLine(bullsEyeCorners[1], bullsEyeCorners[2], length), + this.sampleLine(bullsEyeCorners[2], bullsEyeCorners[3], length), + this.sampleLine(bullsEyeCorners[3], bullsEyeCorners[0], length) // Top + ]); + // bullsEyeCorners[shift] is the corner of the bulls'eye that has three + // orientation marks. + // sides[shift] is the row/column that goes from the corner with three + // orientation marks to the corner with two. + this.shift = this.getRotation(sides, length); + // Flatten the parameter bits into a single 28- or 40-bit long + let parameterData = 0; + for (let i = 0; i < 4; i++) { + let side = sides[(this.shift + i) % 4]; + if (this.compact) { + // Each side of the form ..XXXXXXX. where Xs are parameter data + parameterData <<= 7; + parameterData += (side >> 1) & 0x7F; + } + else { + // Each side of the form ..XXXXX.XXXXX. where Xs are parameter data + parameterData <<= 10; + parameterData += ((side >> 2) & (0x1f << 5)) + ((side >> 1) & 0x1F); + } + } + // Corrects parameter data using RS. Returns just the data portion + // without the error correction. + let correctedData = this.getCorrectedParameterData(parameterData, this.compact); + if (this.compact) { + // 8 bits: 2 bits layers and 6 bits data blocks + this.nbLayers = (correctedData >> 6) + 1; + this.nbDataBlocks = (correctedData & 0x3F) + 1; + } + else { + // 16 bits: 5 bits layers and 11 bits data blocks + this.nbLayers = (correctedData >> 11) + 1; + this.nbDataBlocks = (correctedData & 0x7FF) + 1; + } + } + getRotation(sides, length) { + // In a normal pattern, we expect to See + // ** .* D A + // * * + // + // . * + // .. .. C B + // + // Grab the 3 bits from each of the sides the form the locator pattern and concatenate + // into a 12-bit integer. Start with the bit at A + let cornerBits = 0; + sides.forEach((side, idx, arr) => { + // XX......X where X's are orientation marks + let t = ((side >> (length - 2)) << 1) + (side & 1); + cornerBits = (cornerBits << 3) + t; + }); + // for (var side in sides) { + // // XX......X where X's are orientation marks + // var t = ((side >> (length - 2)) << 1) + (side & 1); + // cornerBits = (cornerBits << 3) + t; + // } + // Mov the bottom bit to the top, so that the three bits of the locator pattern at A are + // together. cornerBits is now: + // 3 orientation bits at A || 3 orientation bits at B || ... || 3 orientation bits at D + cornerBits = ((cornerBits & 1) << 11) + (cornerBits >> 1); + // The result shift indicates which element of BullsEyeCorners[] goes into the top-left + // corner. Since the four rotation values have a Hamming distance of 8, we + // can easily tolerate two errors. + for (let shift = 0; shift < 4; shift++) { + if (Integer.bitCount(cornerBits ^ this.EXPECTED_CORNER_BITS[shift]) <= 2) { + return shift; + } + } + throw new NotFoundException(); + } + /** + * Corrects the parameter bits using Reed-Solomon algorithm. + * + * @param parameterData parameter bits + * @param compact true if this is a compact Aztec code + * @throws NotFoundException if the array contains too many errors + */ + getCorrectedParameterData(parameterData, compact) { + let numCodewords; + let numDataCodewords; + if (compact) { + numCodewords = 7; + numDataCodewords = 2; + } + else { + numCodewords = 10; + numDataCodewords = 4; + } + let numECCodewords = numCodewords - numDataCodewords; + let parameterWords = new Int32Array(numCodewords); + for (let i = numCodewords - 1; i >= 0; --i) { + parameterWords[i] = parameterData & 0xF; + parameterData >>= 4; + } + try { + let rsDecoder = new ReedSolomonDecoder(GenericGF.AZTEC_PARAM); + rsDecoder.decode(parameterWords, numECCodewords); + } + catch (ignored) { + throw new NotFoundException(); + } + // Toss the error correction. Just return the data as an integer + let result = 0; + for (let i = 0; i < numDataCodewords; i++) { + result = (result << 4) + parameterWords[i]; + } + return result; + } + /** + * Finds the corners of a bull-eye centered on the passed point. + * This returns the centers of the diagonal points just outside the bull's eye + * Returns [topRight, bottomRight, bottomLeft, topLeft] + * + * @param pCenter Center point + * @return The corners of the bull-eye + * @throws NotFoundException If no valid bull-eye can be found + */ + getBullsEyeCorners(pCenter) { + let pina = pCenter; + let pinb = pCenter; + let pinc = pCenter; + let pind = pCenter; + let color = true; + for (this.nbCenterLayers = 1; this.nbCenterLayers < 9; this.nbCenterLayers++) { + let pouta = this.getFirstDifferent(pina, color, 1, -1); + let poutb = this.getFirstDifferent(pinb, color, 1, 1); + let poutc = this.getFirstDifferent(pinc, color, -1, 1); + let poutd = this.getFirstDifferent(pind, color, -1, -1); + // d a + // + // c b + if (this.nbCenterLayers > 2) { + let q = (this.distancePoint(poutd, pouta) * this.nbCenterLayers) / (this.distancePoint(pind, pina) * (this.nbCenterLayers + 2)); + if (q < 0.75 || q > 1.25 || !this.isWhiteOrBlackRectangle(pouta, poutb, poutc, poutd)) { + break; + } + } + pina = pouta; + pinb = poutb; + pinc = poutc; + pind = poutd; + color = !color; + } + if (this.nbCenterLayers !== 5 && this.nbCenterLayers !== 7) { + throw new NotFoundException(); + } + this.compact = this.nbCenterLayers === 5; + // Expand the square by .5 pixel in each direction so that we're on the border + // between the white square and the black square + let pinax = new ResultPoint(pina.getX() + 0.5, pina.getY() - 0.5); + let pinbx = new ResultPoint(pinb.getX() + 0.5, pinb.getY() + 0.5); + let pincx = new ResultPoint(pinc.getX() - 0.5, pinc.getY() + 0.5); + let pindx = new ResultPoint(pind.getX() - 0.5, pind.getY() - 0.5); + // Expand the square so that its corners are the centers of the points + // just outside the bull's eye. + return this.expandSquare([pinax, pinbx, pincx, pindx], 2 * this.nbCenterLayers - 3, 2 * this.nbCenterLayers); + } + /** + * Finds a candidate center point of an Aztec code from an image + * + * @return the center point + */ + getMatrixCenter() { + let pointA; + let pointB; + let pointC; + let pointD; + // Get a white rectangle that can be the border of the matrix in center bull's eye or + try { + let cornerPoints = new WhiteRectangleDetector(this.image).detect(); + pointA = cornerPoints[0]; + pointB = cornerPoints[1]; + pointC = cornerPoints[2]; + pointD = cornerPoints[3]; + } + catch (e) { + // This exception can be in case the initial rectangle is white + // In that case, surely in the bull's eye, we try to expand the rectangle. + let cx = this.image.getWidth() / 2; + let cy = this.image.getHeight() / 2; + pointA = this.getFirstDifferent(new Point(cx + 7, cy - 7), false, 1, -1).toResultPoint(); + pointB = this.getFirstDifferent(new Point(cx + 7, cy + 7), false, 1, 1).toResultPoint(); + pointC = this.getFirstDifferent(new Point(cx - 7, cy + 7), false, -1, 1).toResultPoint(); + pointD = this.getFirstDifferent(new Point(cx - 7, cy - 7), false, -1, -1).toResultPoint(); + } + // Compute the center of the rectangle + let cx = MathUtils.round((pointA.getX() + pointD.getX() + pointB.getX() + pointC.getX()) / 4.0); + let cy = MathUtils.round((pointA.getY() + pointD.getY() + pointB.getY() + pointC.getY()) / 4.0); + // Redetermine the white rectangle starting from previously computed center. + // This will ensure that we end up with a white rectangle in center bull's eye + // in order to compute a more accurate center. + try { + let cornerPoints = new WhiteRectangleDetector(this.image, 15, cx, cy).detect(); + pointA = cornerPoints[0]; + pointB = cornerPoints[1]; + pointC = cornerPoints[2]; + pointD = cornerPoints[3]; + } + catch (e) { + // This exception can be in case the initial rectangle is white + // In that case we try to expand the rectangle. + pointA = this.getFirstDifferent(new Point(cx + 7, cy - 7), false, 1, -1).toResultPoint(); + pointB = this.getFirstDifferent(new Point(cx + 7, cy + 7), false, 1, 1).toResultPoint(); + pointC = this.getFirstDifferent(new Point(cx - 7, cy + 7), false, -1, 1).toResultPoint(); + pointD = this.getFirstDifferent(new Point(cx - 7, cy - 7), false, -1, -1).toResultPoint(); + } + // Recompute the center of the rectangle + cx = MathUtils.round((pointA.getX() + pointD.getX() + pointB.getX() + pointC.getX()) / 4.0); + cy = MathUtils.round((pointA.getY() + pointD.getY() + pointB.getY() + pointC.getY()) / 4.0); + return new Point(cx, cy); + } + /** + * Gets the Aztec code corners from the bull's eye corners and the parameters. + * + * @param bullsEyeCorners the array of bull's eye corners + * @return the array of aztec code corners + */ + getMatrixCornerPoints(bullsEyeCorners) { + return this.expandSquare(bullsEyeCorners, 2 * this.nbCenterLayers, this.getDimension()); + } + /** + * Creates a BitMatrix by sampling the provided image. + * topLeft, topRight, bottomRight, and bottomLeft are the centers of the squares on the + * diagonal just outside the bull's eye. + */ + sampleGrid(image, topLeft, topRight, bottomRight, bottomLeft) { + let sampler = GridSamplerInstance.getInstance(); + let dimension = this.getDimension(); + let low = dimension / 2 - this.nbCenterLayers; + let high = dimension / 2 + this.nbCenterLayers; + return sampler.sampleGrid(image, dimension, dimension, low, low, // topleft + high, low, // topright + high, high, // bottomright + low, high, // bottomleft + topLeft.getX(), topLeft.getY(), topRight.getX(), topRight.getY(), bottomRight.getX(), bottomRight.getY(), bottomLeft.getX(), bottomLeft.getY()); + } + /** + * Samples a line. + * + * @param p1 start point (inclusive) + * @param p2 end point (exclusive) + * @param size number of bits + * @return the array of bits as an int (first bit is high-order bit of result) + */ + sampleLine(p1, p2, size) { + let result = 0; + let d = this.distanceResultPoint(p1, p2); + let moduleSize = d / size; + let px = p1.getX(); + let py = p1.getY(); + let dx = moduleSize * (p2.getX() - p1.getX()) / d; + let dy = moduleSize * (p2.getY() - p1.getY()) / d; + for (let i = 0; i < size; i++) { + if (this.image.get(MathUtils.round(px + i * dx), MathUtils.round(py + i * dy))) { + result |= 1 << (size - i - 1); + } + } + return result; + } + /** + * @return true if the border of the rectangle passed in parameter is compound of white points only + * or black points only + */ + isWhiteOrBlackRectangle(p1, p2, p3, p4) { + let corr = 3; + p1 = new Point(p1.getX() - corr, p1.getY() + corr); + p2 = new Point(p2.getX() - corr, p2.getY() - corr); + p3 = new Point(p3.getX() + corr, p3.getY() - corr); + p4 = new Point(p4.getX() + corr, p4.getY() + corr); + let cInit = this.getColor(p4, p1); + if (cInit === 0) { + return false; + } + let c = this.getColor(p1, p2); + if (c !== cInit) { + return false; + } + c = this.getColor(p2, p3); + if (c !== cInit) { + return false; + } + c = this.getColor(p3, p4); + return c === cInit; + } + /** + * Gets the color of a segment + * + * @return 1 if segment more than 90% black, -1 if segment is more than 90% white, 0 else + */ + getColor(p1, p2) { + let d = this.distancePoint(p1, p2); + let dx = (p2.getX() - p1.getX()) / d; + let dy = (p2.getY() - p1.getY()) / d; + let error = 0; + let px = p1.getX(); + let py = p1.getY(); + let colorModel = this.image.get(p1.getX(), p1.getY()); + let iMax = Math.ceil(d); + for (let i = 0; i < iMax; i++) { + px += dx; + py += dy; + if (this.image.get(MathUtils.round(px), MathUtils.round(py)) !== colorModel) { + error++; + } + } + let errRatio = error / d; + if (errRatio > 0.1 && errRatio < 0.9) { + return 0; + } + return (errRatio <= 0.1) === colorModel ? 1 : -1; + } + /** + * Gets the coordinate of the first point with a different color in the given direction + */ + getFirstDifferent(init, color, dx, dy) { + let x = init.getX() + dx; + let y = init.getY() + dy; + while (this.isValid(x, y) && this.image.get(x, y) === color) { + x += dx; + y += dy; + } + x -= dx; + y -= dy; + while (this.isValid(x, y) && this.image.get(x, y) === color) { + x += dx; + } + x -= dx; + while (this.isValid(x, y) && this.image.get(x, y) === color) { + y += dy; + } + y -= dy; + return new Point(x, y); + } + /** + * Expand the square represented by the corner points by pushing out equally in all directions + * + * @param cornerPoints the corners of the square, which has the bull's eye at its center + * @param oldSide the original length of the side of the square in the target bit matrix + * @param newSide the new length of the size of the square in the target bit matrix + * @return the corners of the expanded square + */ + expandSquare(cornerPoints, oldSide, newSide) { + let ratio = newSide / (2.0 * oldSide); + let dx = cornerPoints[0].getX() - cornerPoints[2].getX(); + let dy = cornerPoints[0].getY() - cornerPoints[2].getY(); + let centerx = (cornerPoints[0].getX() + cornerPoints[2].getX()) / 2.0; + let centery = (cornerPoints[0].getY() + cornerPoints[2].getY()) / 2.0; + let result0 = new ResultPoint(centerx + ratio * dx, centery + ratio * dy); + let result2 = new ResultPoint(centerx - ratio * dx, centery - ratio * dy); + dx = cornerPoints[1].getX() - cornerPoints[3].getX(); + dy = cornerPoints[1].getY() - cornerPoints[3].getY(); + centerx = (cornerPoints[1].getX() + cornerPoints[3].getX()) / 2.0; + centery = (cornerPoints[1].getY() + cornerPoints[3].getY()) / 2.0; + let result1 = new ResultPoint(centerx + ratio * dx, centery + ratio * dy); + let result3 = new ResultPoint(centerx - ratio * dx, centery - ratio * dy); + let results = [result0, result1, result2, result3]; + return results; + } + isValid(x, y) { + return x >= 0 && x < this.image.getWidth() && y > 0 && y < this.image.getHeight(); + } + isValidPoint(point) { + let x = MathUtils.round(point.getX()); + let y = MathUtils.round(point.getY()); + return this.isValid(x, y); + } + distancePoint(a, b) { + return MathUtils.distance(a.getX(), a.getY(), b.getX(), b.getY()); + } + distanceResultPoint(a, b) { + return MathUtils.distance(a.getX(), a.getY(), b.getX(), b.getY()); + } + getDimension() { + if (this.compact) { + return 4 * this.nbLayers + 11; + } + if (this.nbLayers <= 4) { + return 4 * this.nbLayers + 15; + } + return 4 * this.nbLayers + 2 * (Integer.truncDivision((this.nbLayers - 4), 8) + 1) + 15; + } + } + + /* + * Copyright 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.List; + // import java.util.Map; + /** + * This implementation can detect and decode Aztec codes in an image. + * + * @author David Olivier + */ + class AztecReader { + /** + * Locates and decodes a Data Matrix code in an image. + * + * @return a String representing the content encoded by the Data Matrix code + * @throws NotFoundException if a Data Matrix code cannot be found + * @throws FormatException if a Data Matrix code cannot be decoded + */ + decode(image, hints = null) { + let exception = null; + let detector = new Detector(image.getBlackMatrix()); + let points = null; + let decoderResult = null; + try { + let detectorResult = detector.detectMirror(false); + points = detectorResult.getPoints(); + this.reportFoundResultPoints(hints, points); + decoderResult = new Decoder().decode(detectorResult); + } + catch (e) { + exception = e; + } + if (decoderResult == null) { + try { + let detectorResult = detector.detectMirror(true); + points = detectorResult.getPoints(); + this.reportFoundResultPoints(hints, points); + decoderResult = new Decoder().decode(detectorResult); + } + catch (e) { + if (exception != null) { + throw exception; + } + throw e; + } + } + let result = new Result(decoderResult.getText(), decoderResult.getRawBytes(), decoderResult.getNumBits(), points, BarcodeFormat$1.AZTEC, System.currentTimeMillis()); + let byteSegments = decoderResult.getByteSegments(); + if (byteSegments != null) { + result.putMetadata(ResultMetadataType$1.BYTE_SEGMENTS, byteSegments); + } + let ecLevel = decoderResult.getECLevel(); + if (ecLevel != null) { + result.putMetadata(ResultMetadataType$1.ERROR_CORRECTION_LEVEL, ecLevel); + } + return result; + } + reportFoundResultPoints(hints, points) { + if (hints != null) { + let rpcb = hints.get(DecodeHintType$1.NEED_RESULT_POINT_CALLBACK); + if (rpcb != null) { + points.forEach((point, idx, arr) => { + rpcb.foundPossibleResultPoint(point); + }); + } + } + } + // @Override + reset() { + // do nothing + } + } + + /** + * Aztec Code reader to use from browser. + * + * @class BrowserAztecCodeReader + * @extends {BrowserCodeReader} + */ + class BrowserAztecCodeReader extends BrowserCodeReader { + /** + * Creates an instance of BrowserAztecCodeReader. + * @param {number} [timeBetweenScansMillis=500] the time delay between subsequent decode tries + * + * @memberOf BrowserAztecCodeReader + */ + constructor(timeBetweenScansMillis = 500) { + super(new AztecReader(), timeBetweenScansMillis); + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Encapsulates functionality and implementation that is common to all families + * of one-dimensional barcodes. + * + * @author dswitkin@google.com (Daniel Switkin) + * @author Sean Owen + */ + class OneDReader { + /* + @Override + public Result decode(BinaryBitmap image) throws NotFoundException, FormatException { + return decode(image, null); + } + */ + // Note that we don't try rotation without the try harder flag, even if rotation was supported. + // @Override + decode(image, hints) { + try { + return this.doDecode(image, hints); + } + catch (nfe) { + const tryHarder = hints && (hints.get(DecodeHintType$1.TRY_HARDER) === true); + if (tryHarder && image.isRotateSupported()) { + const rotatedImage = image.rotateCounterClockwise(); + const result = this.doDecode(rotatedImage, hints); + // Record that we found it rotated 90 degrees CCW / 270 degrees CW + const metadata = result.getResultMetadata(); + let orientation = 270; + if (metadata !== null && (metadata.get(ResultMetadataType$1.ORIENTATION) === true)) { + // But if we found it reversed in doDecode(), add in that result here: + orientation = (orientation + metadata.get(ResultMetadataType$1.ORIENTATION) % 360); + } + result.putMetadata(ResultMetadataType$1.ORIENTATION, orientation); + // Update result points + const points = result.getResultPoints(); + if (points !== null) { + const height = rotatedImage.getHeight(); + for (let i = 0; i < points.length; i++) { + points[i] = new ResultPoint(height - points[i].getY() - 1, points[i].getX()); + } + } + return result; + } + else { + throw new NotFoundException(); + } + } + } + // @Override + reset() { + // do nothing + } + /** + * We're going to examine rows from the middle outward, searching alternately above and below the + * middle, and farther out each time. rowStep is the number of rows between each successive + * attempt above and below the middle. So we'd scan row middle, then middle - rowStep, then + * middle + rowStep, then middle - (2 * rowStep), etc. + * rowStep is bigger as the image is taller, but is always at least 1. We've somewhat arbitrarily + * decided that moving up and down by about 1/16 of the image is pretty good; we try more of the + * image if "trying harder". + * + * @param image The image to decode + * @param hints Any hints that were requested + * @return The contents of the decoded barcode + * @throws NotFoundException Any spontaneous errors which occur + */ + doDecode(image, hints) { + const width = image.getWidth(); + const height = image.getHeight(); + let row = new BitArray(width); + const tryHarder = hints && (hints.get(DecodeHintType$1.TRY_HARDER) === true); + const rowStep = Math.max(1, height >> (tryHarder ? 8 : 5)); + let maxLines; + if (tryHarder) { + maxLines = height; // Look at the whole image, not just the center + } + else { + maxLines = 15; // 15 rows spaced 1/32 apart is roughly the middle half of the image + } + const middle = Math.trunc(height / 2); + for (let x = 0; x < maxLines; x++) { + // Scanning from the middle out. Determine which row we're looking at next: + const rowStepsAboveOrBelow = Math.trunc((x + 1) / 2); + const isAbove = (x & 0x01) === 0; // i.e. is x even? + const rowNumber = middle + rowStep * (isAbove ? rowStepsAboveOrBelow : -rowStepsAboveOrBelow); + if (rowNumber < 0 || rowNumber >= height) { + // Oops, if we run off the top or bottom, stop + break; + } + // Estimate black point for this row and load it: + try { + row = image.getBlackRow(rowNumber, row); + } + catch (ignored) { + continue; + } + // While we have the image data in a BitArray, it's fairly cheap to reverse it in place to + // handle decoding upside down barcodes. + for (let attempt = 0; attempt < 2; attempt++) { + if (attempt === 1) { // trying again? + row.reverse(); // reverse the row and continue + // This means we will only ever draw result points *once* in the life of this method + // since we want to avoid drawing the wrong points after flipping the row, and, + // don't want to clutter with noise from every single row scan -- just the scans + // that start on the center line. + if (hints && (hints.get(DecodeHintType$1.NEED_RESULT_POINT_CALLBACK) === true)) { + const newHints = new Map(); + hints.forEach((hint, key) => newHints.set(key, hint)); + newHints.delete(DecodeHintType$1.NEED_RESULT_POINT_CALLBACK); + hints = newHints; + } + } + try { + // Look for a barcode + const result = this.decodeRow(rowNumber, row, hints); + // We found our barcode + if (attempt === 1) { + // But it was upside down, so note that + result.putMetadata(ResultMetadataType$1.ORIENTATION, 180); + // And remember to flip the result points horizontally. + const points = result.getResultPoints(); + if (points !== null) { + points[0] = new ResultPoint(width - points[0].getX() - 1, points[0].getY()); + points[1] = new ResultPoint(width - points[1].getX() - 1, points[1].getY()); + } + } + return result; + } + catch (re) { + // continue -- just couldn't decode this row + } + } + } + throw new NotFoundException(); + } + /** + * Records the size of successive runs of white and black pixels in a row, starting at a given point. + * The values are recorded in the given array, and the number of runs recorded is equal to the size + * of the array. If the row starts on a white pixel at the given start point, then the first count + * recorded is the run of white pixels starting from that point; likewise it is the count of a run + * of black pixels if the row begin on a black pixels at that point. + * + * @param row row to count from + * @param start offset into row to start at + * @param counters array into which to record counts + * @throws NotFoundException if counters cannot be filled entirely from row before running out + * of pixels + */ + static recordPattern(row, start, counters) { + const numCounters = counters.length; + for (let index = 0; index < numCounters; index++) + counters[index] = 0; + const end = row.getSize(); + if (start >= end) { + throw new NotFoundException(); + } + let isWhite = !row.get(start); + let counterPosition = 0; + let i = start; + while (i < end) { + if (row.get(i) !== isWhite) { + counters[counterPosition]++; + } + else { + if (++counterPosition === numCounters) { + break; + } + else { + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + i++; + } + // If we read fully the last section of pixels and filled up our counters -- or filled + // the last counter but ran off the side of the image, OK. Otherwise, a problem. + if (!(counterPosition === numCounters || (counterPosition === numCounters - 1 && i === end))) { + throw new NotFoundException(); + } + } + static recordPatternInReverse(row, start, counters) { + // This could be more efficient I guess + let numTransitionsLeft = counters.length; + let last = row.get(start); + while (start > 0 && numTransitionsLeft >= 0) { + if (row.get(--start) !== last) { + numTransitionsLeft--; + last = !last; + } + } + if (numTransitionsLeft >= 0) { + throw new NotFoundException(); + } + OneDReader.recordPattern(row, start + 1, counters); + } + /** + * Determines how closely a set of observed counts of runs of black/white values matches a given + * target pattern. This is reported as the ratio of the total variance from the expected pattern + * proportions across all pattern elements, to the length of the pattern. + * + * @param counters observed counters + * @param pattern expected pattern + * @param maxIndividualVariance The most any counter can differ before we give up + * @return ratio of total variance between counters and pattern compared to total pattern size + */ + static patternMatchVariance(counters, pattern, maxIndividualVariance) { + const numCounters = counters.length; + let total = 0; + let patternLength = 0; + for (let i = 0; i < numCounters; i++) { + total += counters[i]; + patternLength += pattern[i]; + } + if (total < patternLength) { + // If we don't even have one pixel per unit of bar width, assume this is too small + // to reliably match, so fail: + return Number.POSITIVE_INFINITY; + } + const unitBarWidth = total / patternLength; + maxIndividualVariance *= unitBarWidth; + let totalVariance = 0.0; + for (let x = 0; x < numCounters; x++) { + const counter = counters[x]; + const scaledPattern = pattern[x] * unitBarWidth; + const variance = counter > scaledPattern ? counter - scaledPattern : scaledPattern - counter; + if (variance > maxIndividualVariance) { + return Number.POSITIVE_INFINITY; + } + totalVariance += variance; + } + return totalVariance / total; + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Decodes Code 128 barcodes.

+ * + * @author Sean Owen + */ + class Code128Reader extends OneDReader { + static findStartPattern(row) { + const width = row.getSize(); + const rowOffset = row.getNextSet(0); + let counterPosition = 0; + let counters = Int32Array.from([0, 0, 0, 0, 0, 0]); + let patternStart = rowOffset; + let isWhite = false; + const patternLength = 6; + for (let i = rowOffset; i < width; i++) { + if (row.get(i) !== isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition === (patternLength - 1)) { + let bestVariance = Code128Reader.MAX_AVG_VARIANCE; + let bestMatch = -1; + for (let startCode = Code128Reader.CODE_START_A; startCode <= Code128Reader.CODE_START_C; startCode++) { + const variance = OneDReader.patternMatchVariance(counters, Code128Reader.CODE_PATTERNS[startCode], Code128Reader.MAX_INDIVIDUAL_VARIANCE); + if (variance < bestVariance) { + bestVariance = variance; + bestMatch = startCode; + } + } + // Look for whitespace before start pattern, >= 50% of width of start pattern + if (bestMatch >= 0 && + row.isRange(Math.max(0, patternStart - (i - patternStart) / 2), patternStart, false)) { + return Int32Array.from([patternStart, i, bestMatch]); + } + patternStart += counters[0] + counters[1]; + counters = counters.slice(2, counters.length - 1); + counters[counterPosition - 1] = 0; + counters[counterPosition] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + throw new NotFoundException(); + } + static decodeCode(row, counters, rowOffset) { + OneDReader.recordPattern(row, rowOffset, counters); + let bestVariance = Code128Reader.MAX_AVG_VARIANCE; // worst variance we'll accept + let bestMatch = -1; + for (let d = 0; d < Code128Reader.CODE_PATTERNS.length; d++) { + const pattern = Code128Reader.CODE_PATTERNS[d]; + const variance = this.patternMatchVariance(counters, pattern, Code128Reader.MAX_INDIVIDUAL_VARIANCE); + if (variance < bestVariance) { + bestVariance = variance; + bestMatch = d; + } + } + // TODO We're overlooking the fact that the STOP pattern has 7 values, not 6. + if (bestMatch >= 0) { + return bestMatch; + } + else { + throw new NotFoundException(); + } + } + decodeRow(rowNumber, row, hints) { + const convertFNC1 = hints && (hints.get(DecodeHintType$1.ASSUME_GS1) === true); + const startPatternInfo = Code128Reader.findStartPattern(row); + const startCode = startPatternInfo[2]; + let currentRawCodesIndex = 0; + const rawCodes = new Uint8Array(20); + rawCodes[currentRawCodesIndex++] = startCode; + let codeSet; + switch (startCode) { + case Code128Reader.CODE_START_A: + codeSet = Code128Reader.CODE_CODE_A; + break; + case Code128Reader.CODE_START_B: + codeSet = Code128Reader.CODE_CODE_B; + break; + case Code128Reader.CODE_START_C: + codeSet = Code128Reader.CODE_CODE_C; + break; + default: + throw new FormatException(); + } + let done = false; + let isNextShifted = false; + let result = ''; + let lastStart = startPatternInfo[0]; + let nextStart = startPatternInfo[1]; + const counters = Int32Array.from([0, 0, 0, 0, 0, 0]); + let lastCode = 0; + let code = 0; + let checksumTotal = startCode; + let multiplier = 0; + let lastCharacterWasPrintable = true; + let upperMode = false; + let shiftUpperMode = false; + while (!done) { + const unshift = isNextShifted; + isNextShifted = false; + // Save off last code + lastCode = code; + // Decode another code from image + code = Code128Reader.decodeCode(row, counters, nextStart); + rawCodes[currentRawCodesIndex++] = code; + // Remember whether the last code was printable or not (excluding CODE_STOP) + if (code !== Code128Reader.CODE_STOP) { + lastCharacterWasPrintable = true; + } + // Add to checksum computation (if not CODE_STOP of course) + if (code !== Code128Reader.CODE_STOP) { + multiplier++; + checksumTotal += multiplier * code; + } + // Advance to where the next code will to start + lastStart = nextStart; + nextStart += counters.reduce((previous, current) => previous + current, 0); + // Take care of illegal start codes + switch (code) { + case Code128Reader.CODE_START_A: + case Code128Reader.CODE_START_B: + case Code128Reader.CODE_START_C: + throw new FormatException(); + } + switch (codeSet) { + case Code128Reader.CODE_CODE_A: + if (code < 64) { + if (shiftUpperMode === upperMode) { + result += String.fromCharCode((' '.charCodeAt(0) + code)); + } + else { + result += String.fromCharCode((' '.charCodeAt(0) + code + 128)); + } + shiftUpperMode = false; + } + else if (code < 96) { + if (shiftUpperMode === upperMode) { + result += String.fromCharCode((code - 64)); + } + else { + result += String.fromCharCode((code + 64)); + } + shiftUpperMode = false; + } + else { + // Don't let CODE_STOP, which always appears, affect whether whether we think the last + // code was printable or not. + if (code !== Code128Reader.CODE_STOP) { + lastCharacterWasPrintable = false; + } + switch (code) { + case Code128Reader.CODE_FNC_1: + if (convertFNC1) { + if (result.length === 0) { + // GS1 specification 5.4.3.7. and 5.4.6.4. If the first char after the start code + // is FNC1 then this is GS1-128. We add the symbology identifier. + result += ']C1'; + } + else { + // GS1 specification 5.4.7.5. Every subsequent FNC1 is returned as ASCII 29 (GS) + result += String.fromCharCode(29); + } + } + break; + case Code128Reader.CODE_FNC_2: + case Code128Reader.CODE_FNC_3: + // do nothing? + break; + case Code128Reader.CODE_FNC_4_A: + if (!upperMode && shiftUpperMode) { + upperMode = true; + shiftUpperMode = false; + } + else if (upperMode && shiftUpperMode) { + upperMode = false; + shiftUpperMode = false; + } + else { + shiftUpperMode = true; + } + break; + case Code128Reader.CODE_SHIFT: + isNextShifted = true; + codeSet = Code128Reader.CODE_CODE_B; + break; + case Code128Reader.CODE_CODE_B: + codeSet = Code128Reader.CODE_CODE_B; + break; + case Code128Reader.CODE_CODE_C: + codeSet = Code128Reader.CODE_CODE_C; + break; + case Code128Reader.CODE_STOP: + done = true; + break; + } + } + break; + case Code128Reader.CODE_CODE_B: + if (code < 96) { + if (shiftUpperMode === upperMode) { + result += String.fromCharCode((' '.charCodeAt(0) + code)); + } + else { + result += String.fromCharCode((' '.charCodeAt(0) + code + 128)); + } + shiftUpperMode = false; + } + else { + if (code !== Code128Reader.CODE_STOP) { + lastCharacterWasPrintable = false; + } + switch (code) { + case Code128Reader.CODE_FNC_1: + if (convertFNC1) { + if (result.length === 0) { + // GS1 specification 5.4.3.7. and 5.4.6.4. If the first char after the start code + // is FNC1 then this is GS1-128. We add the symbology identifier. + result += ']C1'; + } + else { + // GS1 specification 5.4.7.5. Every subsequent FNC1 is returned as ASCII 29 (GS) + result += String.fromCharCode(29); + } + } + break; + case Code128Reader.CODE_FNC_2: + case Code128Reader.CODE_FNC_3: + // do nothing? + break; + case Code128Reader.CODE_FNC_4_B: + if (!upperMode && shiftUpperMode) { + upperMode = true; + shiftUpperMode = false; + } + else if (upperMode && shiftUpperMode) { + upperMode = false; + shiftUpperMode = false; + } + else { + shiftUpperMode = true; + } + break; + case Code128Reader.CODE_SHIFT: + isNextShifted = true; + codeSet = Code128Reader.CODE_CODE_A; + break; + case Code128Reader.CODE_CODE_A: + codeSet = Code128Reader.CODE_CODE_A; + break; + case Code128Reader.CODE_CODE_C: + codeSet = Code128Reader.CODE_CODE_C; + break; + case Code128Reader.CODE_STOP: + done = true; + break; + } + } + break; + case Code128Reader.CODE_CODE_C: + if (code < 100) { + if (code < 10) { + result += '0'; + } + result += code; + } + else { + if (code !== Code128Reader.CODE_STOP) { + lastCharacterWasPrintable = false; + } + switch (code) { + case Code128Reader.CODE_FNC_1: + if (convertFNC1) { + if (result.length === 0) { + // GS1 specification 5.4.3.7. and 5.4.6.4. If the first char after the start code + // is FNC1 then this is GS1-128. We add the symbology identifier. + result += ']C1'; + } + else { + // GS1 specification 5.4.7.5. Every subsequent FNC1 is returned as ASCII 29 (GS) + result += String.fromCharCode(29); + } + } + break; + case Code128Reader.CODE_CODE_A: + codeSet = Code128Reader.CODE_CODE_A; + break; + case Code128Reader.CODE_CODE_B: + codeSet = Code128Reader.CODE_CODE_B; + break; + case Code128Reader.CODE_STOP: + done = true; + break; + } + } + break; + } + // Unshift back to another code set if we were shifted + if (unshift) { + codeSet = codeSet === Code128Reader.CODE_CODE_A ? Code128Reader.CODE_CODE_B : Code128Reader.CODE_CODE_A; + } + } + const lastPatternSize = nextStart - lastStart; + // Check for ample whitespace following pattern, but, to do this we first need to remember that + // we fudged decoding CODE_STOP since it actually has 7 bars, not 6. There is a black bar left + // to read off. Would be slightly better to properly read. Here we just skip it: + nextStart = row.getNextUnset(nextStart); + if (!row.isRange(nextStart, Math.min(row.getSize(), nextStart + (nextStart - lastStart) / 2), false)) { + throw new NotFoundException(); + } + // Pull out from sum the value of the penultimate check code + checksumTotal -= multiplier * lastCode; + // lastCode is the checksum then: + if (checksumTotal % 103 !== lastCode) { + throw new ChecksumException(); + } + // Need to pull out the check digits from string + const resultLength = result.length; + if (resultLength === 0) { + // false positive + throw new NotFoundException(); + } + // Only bother if the result had at least one character, and if the checksum digit happened to + // be a printable character. If it was just interpreted as a control code, nothing to remove. + if (resultLength > 0 && lastCharacterWasPrintable) { + if (codeSet === Code128Reader.CODE_CODE_C) { + result = result.substring(0, resultLength - 2); + } + else { + result = result.substring(0, resultLength - 1); + } + } + const left = (startPatternInfo[1] + startPatternInfo[0]) / 2.0; + const right = lastStart + lastPatternSize / 2.0; + const rawCodesSize = rawCodes.length; + const rawBytes = new Uint8Array(rawCodesSize); + for (let i = 0; i < rawCodesSize; i++) { + rawBytes[i] = rawCodes[i]; + } + const points = [new ResultPoint(left, rowNumber), new ResultPoint(right, rowNumber)]; + return new Result(result, rawBytes, 0, points, BarcodeFormat$1.CODE_128, new Date().getTime()); + } + } + Code128Reader.CODE_PATTERNS = [ + Int32Array.from([2, 1, 2, 2, 2, 2]), + Int32Array.from([2, 2, 2, 1, 2, 2]), + Int32Array.from([2, 2, 2, 2, 2, 1]), + Int32Array.from([1, 2, 1, 2, 2, 3]), + Int32Array.from([1, 2, 1, 3, 2, 2]), + Int32Array.from([1, 3, 1, 2, 2, 2]), + Int32Array.from([1, 2, 2, 2, 1, 3]), + Int32Array.from([1, 2, 2, 3, 1, 2]), + Int32Array.from([1, 3, 2, 2, 1, 2]), + Int32Array.from([2, 2, 1, 2, 1, 3]), + Int32Array.from([2, 2, 1, 3, 1, 2]), + Int32Array.from([2, 3, 1, 2, 1, 2]), + Int32Array.from([1, 1, 2, 2, 3, 2]), + Int32Array.from([1, 2, 2, 1, 3, 2]), + Int32Array.from([1, 2, 2, 2, 3, 1]), + Int32Array.from([1, 1, 3, 2, 2, 2]), + Int32Array.from([1, 2, 3, 1, 2, 2]), + Int32Array.from([1, 2, 3, 2, 2, 1]), + Int32Array.from([2, 2, 3, 2, 1, 1]), + Int32Array.from([2, 2, 1, 1, 3, 2]), + Int32Array.from([2, 2, 1, 2, 3, 1]), + Int32Array.from([2, 1, 3, 2, 1, 2]), + Int32Array.from([2, 2, 3, 1, 1, 2]), + Int32Array.from([3, 1, 2, 1, 3, 1]), + Int32Array.from([3, 1, 1, 2, 2, 2]), + Int32Array.from([3, 2, 1, 1, 2, 2]), + Int32Array.from([3, 2, 1, 2, 2, 1]), + Int32Array.from([3, 1, 2, 2, 1, 2]), + Int32Array.from([3, 2, 2, 1, 1, 2]), + Int32Array.from([3, 2, 2, 2, 1, 1]), + Int32Array.from([2, 1, 2, 1, 2, 3]), + Int32Array.from([2, 1, 2, 3, 2, 1]), + Int32Array.from([2, 3, 2, 1, 2, 1]), + Int32Array.from([1, 1, 1, 3, 2, 3]), + Int32Array.from([1, 3, 1, 1, 2, 3]), + Int32Array.from([1, 3, 1, 3, 2, 1]), + Int32Array.from([1, 1, 2, 3, 1, 3]), + Int32Array.from([1, 3, 2, 1, 1, 3]), + Int32Array.from([1, 3, 2, 3, 1, 1]), + Int32Array.from([2, 1, 1, 3, 1, 3]), + Int32Array.from([2, 3, 1, 1, 1, 3]), + Int32Array.from([2, 3, 1, 3, 1, 1]), + Int32Array.from([1, 1, 2, 1, 3, 3]), + Int32Array.from([1, 1, 2, 3, 3, 1]), + Int32Array.from([1, 3, 2, 1, 3, 1]), + Int32Array.from([1, 1, 3, 1, 2, 3]), + Int32Array.from([1, 1, 3, 3, 2, 1]), + Int32Array.from([1, 3, 3, 1, 2, 1]), + Int32Array.from([3, 1, 3, 1, 2, 1]), + Int32Array.from([2, 1, 1, 3, 3, 1]), + Int32Array.from([2, 3, 1, 1, 3, 1]), + Int32Array.from([2, 1, 3, 1, 1, 3]), + Int32Array.from([2, 1, 3, 3, 1, 1]), + Int32Array.from([2, 1, 3, 1, 3, 1]), + Int32Array.from([3, 1, 1, 1, 2, 3]), + Int32Array.from([3, 1, 1, 3, 2, 1]), + Int32Array.from([3, 3, 1, 1, 2, 1]), + Int32Array.from([3, 1, 2, 1, 1, 3]), + Int32Array.from([3, 1, 2, 3, 1, 1]), + Int32Array.from([3, 3, 2, 1, 1, 1]), + Int32Array.from([3, 1, 4, 1, 1, 1]), + Int32Array.from([2, 2, 1, 4, 1, 1]), + Int32Array.from([4, 3, 1, 1, 1, 1]), + Int32Array.from([1, 1, 1, 2, 2, 4]), + Int32Array.from([1, 1, 1, 4, 2, 2]), + Int32Array.from([1, 2, 1, 1, 2, 4]), + Int32Array.from([1, 2, 1, 4, 2, 1]), + Int32Array.from([1, 4, 1, 1, 2, 2]), + Int32Array.from([1, 4, 1, 2, 2, 1]), + Int32Array.from([1, 1, 2, 2, 1, 4]), + Int32Array.from([1, 1, 2, 4, 1, 2]), + Int32Array.from([1, 2, 2, 1, 1, 4]), + Int32Array.from([1, 2, 2, 4, 1, 1]), + Int32Array.from([1, 4, 2, 1, 1, 2]), + Int32Array.from([1, 4, 2, 2, 1, 1]), + Int32Array.from([2, 4, 1, 2, 1, 1]), + Int32Array.from([2, 2, 1, 1, 1, 4]), + Int32Array.from([4, 1, 3, 1, 1, 1]), + Int32Array.from([2, 4, 1, 1, 1, 2]), + Int32Array.from([1, 3, 4, 1, 1, 1]), + Int32Array.from([1, 1, 1, 2, 4, 2]), + Int32Array.from([1, 2, 1, 1, 4, 2]), + Int32Array.from([1, 2, 1, 2, 4, 1]), + Int32Array.from([1, 1, 4, 2, 1, 2]), + Int32Array.from([1, 2, 4, 1, 1, 2]), + Int32Array.from([1, 2, 4, 2, 1, 1]), + Int32Array.from([4, 1, 1, 2, 1, 2]), + Int32Array.from([4, 2, 1, 1, 1, 2]), + Int32Array.from([4, 2, 1, 2, 1, 1]), + Int32Array.from([2, 1, 2, 1, 4, 1]), + Int32Array.from([2, 1, 4, 1, 2, 1]), + Int32Array.from([4, 1, 2, 1, 2, 1]), + Int32Array.from([1, 1, 1, 1, 4, 3]), + Int32Array.from([1, 1, 1, 3, 4, 1]), + Int32Array.from([1, 3, 1, 1, 4, 1]), + Int32Array.from([1, 1, 4, 1, 1, 3]), + Int32Array.from([1, 1, 4, 3, 1, 1]), + Int32Array.from([4, 1, 1, 1, 1, 3]), + Int32Array.from([4, 1, 1, 3, 1, 1]), + Int32Array.from([1, 1, 3, 1, 4, 1]), + Int32Array.from([1, 1, 4, 1, 3, 1]), + Int32Array.from([3, 1, 1, 1, 4, 1]), + Int32Array.from([4, 1, 1, 1, 3, 1]), + Int32Array.from([2, 1, 1, 4, 1, 2]), + Int32Array.from([2, 1, 1, 2, 1, 4]), + Int32Array.from([2, 1, 1, 2, 3, 2]), + Int32Array.from([2, 3, 3, 1, 1, 1, 2]), + ]; + Code128Reader.MAX_AVG_VARIANCE = 0.25; + Code128Reader.MAX_INDIVIDUAL_VARIANCE = 0.7; + Code128Reader.CODE_SHIFT = 98; + Code128Reader.CODE_CODE_C = 99; + Code128Reader.CODE_CODE_B = 100; + Code128Reader.CODE_CODE_A = 101; + Code128Reader.CODE_FNC_1 = 102; + Code128Reader.CODE_FNC_2 = 97; + Code128Reader.CODE_FNC_3 = 96; + Code128Reader.CODE_FNC_4_A = 101; + Code128Reader.CODE_FNC_4_B = 100; + Code128Reader.CODE_START_A = 103; + Code128Reader.CODE_START_B = 104; + Code128Reader.CODE_START_C = 105; + Code128Reader.CODE_STOP = 106; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Decodes Code 39 barcodes. Supports "Full ASCII Code 39" if USE_CODE_39_EXTENDED_MODE is set.

+ * + * @author Sean Owen + * @see Code93Reader + */ + class Code39Reader extends OneDReader { + /** + * Creates a reader that assumes all encoded data is data, and does not treat the final + * character as a check digit. It will not decoded "extended Code 39" sequences. + */ + // public Code39Reader() { + // this(false); + // } + /** + * Creates a reader that can be configured to check the last character as a check digit. + * It will not decoded "extended Code 39" sequences. + * + * @param usingCheckDigit if true, treat the last data character as a check digit, not + * data, and verify that the checksum passes. + */ + // public Code39Reader(boolean usingCheckDigit) { + // this(usingCheckDigit, false); + // } + /** + * Creates a reader that can be configured to check the last character as a check digit, + * or optionally attempt to decode "extended Code 39" sequences that are used to encode + * the full ASCII character set. + * + * @param usingCheckDigit if true, treat the last data character as a check digit, not + * data, and verify that the checksum passes. + * @param extendedMode if true, will attempt to decode extended Code 39 sequences in the + * text. + */ + constructor(usingCheckDigit = false, extendedMode = false) { + super(); + this.usingCheckDigit = usingCheckDigit; + this.extendedMode = extendedMode; + this.decodeRowResult = ''; + this.counters = new Int32Array(9); + } + decodeRow(rowNumber, row, hints) { + let theCounters = this.counters; + theCounters.fill(0); + this.decodeRowResult = ''; + let start = Code39Reader.findAsteriskPattern(row, theCounters); + // Read off white space + let nextStart = row.getNextSet(start[1]); + let end = row.getSize(); + let decodedChar; + let lastStart; + do { + Code39Reader.recordPattern(row, nextStart, theCounters); + let pattern = Code39Reader.toNarrowWidePattern(theCounters); + if (pattern < 0) { + throw new NotFoundException(); + } + decodedChar = Code39Reader.patternToChar(pattern); + this.decodeRowResult += decodedChar; + lastStart = nextStart; + for (let counter of theCounters) { + nextStart += counter; + } + // Read off white space + nextStart = row.getNextSet(nextStart); + } while (decodedChar !== '*'); + this.decodeRowResult = this.decodeRowResult.substring(0, this.decodeRowResult.length - 1); // remove asterisk + // Look for whitespace after pattern: + let lastPatternSize = 0; + for (let counter of theCounters) { + lastPatternSize += counter; + } + let whiteSpaceAfterEnd = nextStart - lastStart - lastPatternSize; + // If 50% of last pattern size, following last pattern, is not whitespace, fail + // (but if it's whitespace to the very end of the image, that's OK) + if (nextStart !== end && (whiteSpaceAfterEnd * 2) < lastPatternSize) { + throw new NotFoundException(); + } + if (this.usingCheckDigit) { + let max = this.decodeRowResult.length - 1; + let total = 0; + for (let i = 0; i < max; i++) { + total += Code39Reader.ALPHABET_STRING.indexOf(this.decodeRowResult.charAt(i)); + } + if (this.decodeRowResult.charAt(max) !== Code39Reader.ALPHABET_STRING.charAt(total % 43)) { + throw new ChecksumException(); + } + this.decodeRowResult = this.decodeRowResult.substring(0, max); + } + if (this.decodeRowResult.length === 0) { + // false positive + throw new NotFoundException(); + } + let resultString; + if (this.extendedMode) { + resultString = Code39Reader.decodeExtended(this.decodeRowResult); + } + else { + resultString = this.decodeRowResult; + } + let left = (start[1] + start[0]) / 2.0; + let right = lastStart + lastPatternSize / 2.0; + return new Result(resultString, null, 0, [new ResultPoint(left, rowNumber), new ResultPoint(right, rowNumber)], BarcodeFormat$1.CODE_39, new Date().getTime()); + } + static findAsteriskPattern(row, counters) { + let width = row.getSize(); + let rowOffset = row.getNextSet(0); + let counterPosition = 0; + let patternStart = rowOffset; + let isWhite = false; + let patternLength = counters.length; + for (let i = rowOffset; i < width; i++) { + if (row.get(i) !== isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition === patternLength - 1) { + // Look for whitespace before start pattern, >= 50% of width of start pattern + if (this.toNarrowWidePattern(counters) === Code39Reader.ASTERISK_ENCODING && + row.isRange(Math.max(0, patternStart - Math.floor((i - patternStart) / 2)), patternStart, false)) { + return [patternStart, i]; + } + patternStart += counters[0] + counters[1]; + counters.copyWithin(0, 2, 2 + counterPosition - 1); + counters[counterPosition - 1] = 0; + counters[counterPosition] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + throw new NotFoundException(); + } + // For efficiency, returns -1 on failure. Not throwing here saved as many as 700 exceptions + // per image when using some of our blackbox images. + static toNarrowWidePattern(counters) { + let numCounters = counters.length; + let maxNarrowCounter = 0; + let wideCounters; + do { + let minCounter = 0x7fffffff; + for (let counter of counters) { + if (counter < minCounter && counter > maxNarrowCounter) { + minCounter = counter; + } + } + maxNarrowCounter = minCounter; + wideCounters = 0; + let totalWideCountersWidth = 0; + let pattern = 0; + for (let i = 0; i < numCounters; i++) { + let counter = counters[i]; + if (counter > maxNarrowCounter) { + pattern |= 1 << (numCounters - 1 - i); + wideCounters++; + totalWideCountersWidth += counter; + } + } + if (wideCounters === 3) { + // Found 3 wide counters, but are they close enough in width? + // We can perform a cheap, conservative check to see if any individual + // counter is more than 1.5 times the average: + for (let i = 0; i < numCounters && wideCounters > 0; i++) { + let counter = counters[i]; + if (counter > maxNarrowCounter) { + wideCounters--; + // totalWideCountersWidth = 3 * average, so this checks if counter >= 3/2 * average + if ((counter * 2) >= totalWideCountersWidth) { + return -1; + } + } + } + return pattern; + } + } while (wideCounters > 3); + return -1; + } + static patternToChar(pattern) { + for (let i = 0; i < Code39Reader.CHARACTER_ENCODINGS.length; i++) { + if (Code39Reader.CHARACTER_ENCODINGS[i] === pattern) { + return Code39Reader.ALPHABET_STRING.charAt(i); + } + } + if (pattern === Code39Reader.ASTERISK_ENCODING) { + return '*'; + } + throw new NotFoundException(); + } + static decodeExtended(encoded) { + let length = encoded.length; + let decoded = ''; + for (let i = 0; i < length; i++) { + let c = encoded.charAt(i); + if (c === '+' || c === '$' || c === '%' || c === '/') { + let next = encoded.charAt(i + 1); + let decodedChar = '\0'; + switch (c) { + case '+': + // +A to +Z map to a to z + if (next >= 'A' && next <= 'Z') { + decodedChar = String.fromCharCode(next.charCodeAt(0) + 32); + } + else { + throw new FormatException(); + } + break; + case '$': + // $A to $Z map to control codes SH to SB + if (next >= 'A' && next <= 'Z') { + decodedChar = String.fromCharCode(next.charCodeAt(0) - 64); + } + else { + throw new FormatException(); + } + break; + case '%': + // %A to %E map to control codes ESC to US + if (next >= 'A' && next <= 'E') { + decodedChar = String.fromCharCode(next.charCodeAt(0) - 38); + } + else if (next >= 'F' && next <= 'J') { + decodedChar = String.fromCharCode(next.charCodeAt(0) - 11); + } + else if (next >= 'K' && next <= 'O') { + decodedChar = String.fromCharCode(next.charCodeAt(0) + 16); + } + else if (next >= 'P' && next <= 'T') { + decodedChar = String.fromCharCode(next.charCodeAt(0) + 43); + } + else if (next === 'U') { + decodedChar = '\0'; + } + else if (next === 'V') { + decodedChar = '@'; + } + else if (next === 'W') { + decodedChar = '`'; + } + else if (next === 'X' || next === 'Y' || next === 'Z') { + decodedChar = '\x7f'; + } + else { + throw new FormatException(); + } + break; + case '/': + // /A to /O map to ! to , and /Z maps to : + if (next >= 'A' && next <= 'O') { + decodedChar = String.fromCharCode(next.charCodeAt(0) - 32); + } + else if (next === 'Z') { + decodedChar = ':'; + } + else { + throw new FormatException(); + } + break; + } + decoded += decodedChar; + // bump up i again since we read two characters + i++; + } + else { + decoded += c; + } + } + return decoded; + } + } + Code39Reader.ALPHABET_STRING = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-. $/+%'; + /** + * These represent the encodings of characters, as patterns of wide and narrow bars. + * The 9 least-significant bits of each int correspond to the pattern of wide and narrow, + * with 1s representing "wide" and 0s representing narrow. + */ + Code39Reader.CHARACTER_ENCODINGS = [ + 0x034, 0x121, 0x061, 0x160, 0x031, 0x130, 0x070, 0x025, 0x124, 0x064, + 0x109, 0x049, 0x148, 0x019, 0x118, 0x058, 0x00D, 0x10C, 0x04C, 0x01C, + 0x103, 0x043, 0x142, 0x013, 0x112, 0x052, 0x007, 0x106, 0x046, 0x016, + 0x181, 0x0C1, 0x1C0, 0x091, 0x190, 0x0D0, 0x085, 0x184, 0x0C4, 0x0A8, + 0x0A2, 0x08A, 0x02A // /-% + ]; + Code39Reader.ASTERISK_ENCODING = 0x094; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Decodes ITF barcodes.

+ * + * @author Tjieco + */ + class ITFReader extends OneDReader { + constructor() { + // private static W = 3; // Pixel width of a 3x wide line + // private static w = 2; // Pixel width of a 2x wide line + // private static N = 1; // Pixed width of a narrow line + super(...arguments); + // Stores the actual narrow line width of the image being decoded. + this.narrowLineWidth = -1; + } + // See ITFWriter.PATTERNS + /* + + /!** + * Patterns of Wide / Narrow lines to indicate each digit + *!/ + */ + decodeRow(rowNumber, row, hints) { + // Find out where the Middle section (payload) starts & ends + let startRange = this.decodeStart(row); + let endRange = this.decodeEnd(row); + let result = new StringBuilder(); + ITFReader.decodeMiddle(row, startRange[1], endRange[0], result); + let resultString = result.toString(); + let allowedLengths = null; + if (hints != null) { + allowedLengths = hints.get(DecodeHintType$1.ALLOWED_LENGTHS); + } + if (allowedLengths == null) { + allowedLengths = ITFReader.DEFAULT_ALLOWED_LENGTHS; + } + // To avoid false positives with 2D barcodes (and other patterns), make + // an assumption that the decoded string must be a 'standard' length if it's short + let length = resultString.length; + let lengthOK = false; + let maxAllowedLength = 0; + for (let value of allowedLengths) { + if (length === value) { + lengthOK = true; + break; + } + if (value > maxAllowedLength) { + maxAllowedLength = value; + } + } + if (!lengthOK && length > maxAllowedLength) { + lengthOK = true; + } + if (!lengthOK) { + throw new FormatException(); + } + const points = [new ResultPoint(startRange[1], rowNumber), new ResultPoint(endRange[0], rowNumber)]; + let resultReturn = new Result(resultString, null, // no natural byte representation for these barcodes + 0, points, BarcodeFormat$1.ITF, new Date().getTime()); + return resultReturn; + } + /* + /!** + * @param row row of black/white values to search + * @param payloadStart offset of start pattern + * @param resultString {@link StringBuilder} to append decoded chars to + * @throws NotFoundException if decoding could not complete successfully + *!/*/ + static decodeMiddle(row, payloadStart, payloadEnd, resultString) { + // Digits are interleaved in pairs - 5 black lines for one digit, and the + // 5 + // interleaved white lines for the second digit. + // Therefore, need to scan 10 lines and then + // split these into two arrays + let counterDigitPair = new Int32Array(10); // 10 + let counterBlack = new Int32Array(5); // 5 + let counterWhite = new Int32Array(5); // 5 + counterDigitPair.fill(0); + counterBlack.fill(0); + counterWhite.fill(0); + while (payloadStart < payloadEnd) { + // Get 10 runs of black/white. + OneDReader.recordPattern(row, payloadStart, counterDigitPair); + // Split them into each array + for (let k = 0; k < 5; k++) { + let twoK = 2 * k; + counterBlack[k] = counterDigitPair[twoK]; + counterWhite[k] = counterDigitPair[twoK + 1]; + } + let bestMatch = ITFReader.decodeDigit(counterBlack); + resultString.append(bestMatch.toString()); + bestMatch = this.decodeDigit(counterWhite); + resultString.append(bestMatch.toString()); + counterDigitPair.forEach(function (counterDigit) { + payloadStart += counterDigit; + }); + } + } + /*/!** + * Identify where the start of the middle / payload section starts. + * + * @param row row of black/white values to search + * @return Array, containing index of start of 'start block' and end of + * 'start block' + *!/*/ + decodeStart(row) { + let endStart = ITFReader.skipWhiteSpace(row); + let startPattern = ITFReader.findGuardPattern(row, endStart, ITFReader.START_PATTERN); + // Determine the width of a narrow line in pixels. We can do this by + // getting the width of the start pattern and dividing by 4 because its + // made up of 4 narrow lines. + this.narrowLineWidth = (startPattern[1] - startPattern[0]) / 4; + this.validateQuietZone(row, startPattern[0]); + return startPattern; + } + /*/!** + * The start & end patterns must be pre/post fixed by a quiet zone. This + * zone must be at least 10 times the width of a narrow line. Scan back until + * we either get to the start of the barcode or match the necessary number of + * quiet zone pixels. + * + * Note: Its assumed the row is reversed when using this method to find + * quiet zone after the end pattern. + * + * ref: http://www.barcode-1.net/i25code.html + * + * @param row bit array representing the scanned barcode. + * @param startPattern index into row of the start or end pattern. + * @throws NotFoundException if the quiet zone cannot be found + *!/*/ + validateQuietZone(row, startPattern) { + let quietCount = this.narrowLineWidth * 10; // expect to find this many pixels of quiet zone + // if there are not so many pixel at all let's try as many as possible + quietCount = quietCount < startPattern ? quietCount : startPattern; + for (let i = startPattern - 1; quietCount > 0 && i >= 0; i--) { + if (row.get(i)) { + break; + } + quietCount--; + } + if (quietCount !== 0) { + // Unable to find the necessary number of quiet zone pixels. + throw new NotFoundException(); + } + } + /* + /!** + * Skip all whitespace until we get to the first black line. + * + * @param row row of black/white values to search + * @return index of the first black line. + * @throws NotFoundException Throws exception if no black lines are found in the row + *!/*/ + static skipWhiteSpace(row) { + const width = row.getSize(); + const endStart = row.getNextSet(0); + if (endStart === width) { + throw new NotFoundException(); + } + return endStart; + } + /*/!** + * Identify where the end of the middle / payload section ends. + * + * @param row row of black/white values to search + * @return Array, containing index of start of 'end block' and end of 'end + * block' + *!/*/ + decodeEnd(row) { + // For convenience, reverse the row and then + // search from 'the start' for the end block + row.reverse(); + try { + let endStart = ITFReader.skipWhiteSpace(row); + let endPattern; + try { + endPattern = ITFReader.findGuardPattern(row, endStart, ITFReader.END_PATTERN_REVERSED[0]); + } + catch (error) { + if (error instanceof NotFoundException) { + endPattern = ITFReader.findGuardPattern(row, endStart, ITFReader.END_PATTERN_REVERSED[1]); + } + } + // The start & end patterns must be pre/post fixed by a quiet zone. This + // zone must be at least 10 times the width of a narrow line. + // ref: http://www.barcode-1.net/i25code.html + this.validateQuietZone(row, endPattern[0]); + // Now recalculate the indices of where the 'endblock' starts & stops to + // accommodate + // the reversed nature of the search + let temp = endPattern[0]; + endPattern[0] = row.getSize() - endPattern[1]; + endPattern[1] = row.getSize() - temp; + return endPattern; + } + finally { + // Put the row back the right way. + row.reverse(); + } + } + /* + /!** + * @param row row of black/white values to search + * @param rowOffset position to start search + * @param pattern pattern of counts of number of black and white pixels that are + * being searched for as a pattern + * @return start/end horizontal offset of guard pattern, as an array of two + * ints + * @throws NotFoundException if pattern is not found + *!/*/ + static findGuardPattern(row, rowOffset, pattern) { + let patternLength = pattern.length; + let counters = new Int32Array(patternLength); + let width = row.getSize(); + let isWhite = false; + let counterPosition = 0; + let patternStart = rowOffset; + counters.fill(0); + for (let x = rowOffset; x < width; x++) { + if (row.get(x) !== isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition === patternLength - 1) { + if (OneDReader.patternMatchVariance(counters, pattern, ITFReader.MAX_INDIVIDUAL_VARIANCE) < ITFReader.MAX_AVG_VARIANCE) { + return [patternStart, x]; + } + patternStart += counters[0] + counters[1]; + System.arraycopy(counters, 2, counters, 0, counterPosition - 1); + counters[counterPosition - 1] = 0; + counters[counterPosition] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + throw new NotFoundException(); + } + /*/!** + * Attempts to decode a sequence of ITF black/white lines into single + * digit. + * + * @param counters the counts of runs of observed black/white/black/... values + * @return The decoded digit + * @throws NotFoundException if digit cannot be decoded + *!/*/ + static decodeDigit(counters) { + let bestVariance = ITFReader.MAX_AVG_VARIANCE; // worst variance we'll accept + let bestMatch = -1; + let max = ITFReader.PATTERNS.length; + for (let i = 0; i < max; i++) { + let pattern = ITFReader.PATTERNS[i]; + let variance = OneDReader.patternMatchVariance(counters, pattern, ITFReader.MAX_INDIVIDUAL_VARIANCE); + if (variance < bestVariance) { + bestVariance = variance; + bestMatch = i; + } + else if (variance === bestVariance) { + // if we find a second 'best match' with the same variance, we can not reliably report to have a suitable match + bestMatch = -1; + } + } + if (bestMatch >= 0) { + return bestMatch % 10; + } + else { + throw new NotFoundException(); + } + } + } + ITFReader.PATTERNS = [ + Int32Array.from([1, 1, 2, 2, 1]), + Int32Array.from([2, 1, 1, 1, 2]), + Int32Array.from([1, 2, 1, 1, 2]), + Int32Array.from([2, 2, 1, 1, 1]), + Int32Array.from([1, 1, 2, 1, 2]), + Int32Array.from([2, 1, 2, 1, 1]), + Int32Array.from([1, 2, 2, 1, 1]), + Int32Array.from([1, 1, 1, 2, 2]), + Int32Array.from([2, 1, 1, 2, 1]), + Int32Array.from([1, 2, 1, 2, 1]), + Int32Array.from([1, 1, 3, 3, 1]), + Int32Array.from([3, 1, 1, 1, 3]), + Int32Array.from([1, 3, 1, 1, 3]), + Int32Array.from([3, 3, 1, 1, 1]), + Int32Array.from([1, 1, 3, 1, 3]), + Int32Array.from([3, 1, 3, 1, 1]), + Int32Array.from([1, 3, 3, 1, 1]), + Int32Array.from([1, 1, 1, 3, 3]), + Int32Array.from([3, 1, 1, 3, 1]), + Int32Array.from([1, 3, 1, 3, 1]) // 9 + ]; + ITFReader.MAX_AVG_VARIANCE = 0.38; + ITFReader.MAX_INDIVIDUAL_VARIANCE = 0.5; + /* /!** Valid ITF lengths. Anything longer than the largest value is also allowed. *!/*/ + ITFReader.DEFAULT_ALLOWED_LENGTHS = [6, 8, 10, 12, 14]; + /*/!** + * Start/end guard pattern. + * + * Note: The end pattern is reversed because the row is reversed before + * searching for the END_PATTERN + *!/*/ + ITFReader.START_PATTERN = Int32Array.from([1, 1, 1, 1]); + ITFReader.END_PATTERN_REVERSED = [ + Int32Array.from([1, 1, 2]), + Int32Array.from([1, 1, 3]) // 3x + ]; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates functionality and implementation that is common to UPC and EAN families + * of one-dimensional barcodes.

+ * + * @author dswitkin@google.com (Daniel Switkin) + * @author Sean Owen + * @author alasdair@google.com (Alasdair Mackintosh) + */ + class AbstractUPCEANReader extends OneDReader { + constructor() { + super(...arguments); + this.decodeRowStringBuffer = ''; + } + // private final UPCEANExtensionSupport extensionReader; + // private final EANManufacturerOrgSupport eanManSupport; + /* + protected UPCEANReader() { + decodeRowStringBuffer = new StringBuilder(20); + extensionReader = new UPCEANExtensionSupport(); + eanManSupport = new EANManufacturerOrgSupport(); + } + */ + static findStartGuardPattern(row) { + let foundStart = false; + let startRange; + let nextStart = 0; + let counters = Int32Array.from([0, 0, 0]); + while (!foundStart) { + counters = Int32Array.from([0, 0, 0]); + startRange = AbstractUPCEANReader.findGuardPattern(row, nextStart, false, this.START_END_PATTERN, counters); + let start = startRange[0]; + nextStart = startRange[1]; + let quietStart = start - (nextStart - start); + if (quietStart >= 0) { + foundStart = row.isRange(quietStart, start, false); + } + } + return startRange; + } + static checkChecksum(s) { + return AbstractUPCEANReader.checkStandardUPCEANChecksum(s); + } + static checkStandardUPCEANChecksum(s) { + let length = s.length; + if (length === 0) + return false; + let check = parseInt(s.charAt(length - 1), 10); + return AbstractUPCEANReader.getStandardUPCEANChecksum(s.substring(0, length - 1)) === check; + } + static getStandardUPCEANChecksum(s) { + let length = s.length; + let sum = 0; + for (let i = length - 1; i >= 0; i -= 2) { + let digit = s.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + if (digit < 0 || digit > 9) { + throw new FormatException(); + } + sum += digit; + } + sum *= 3; + for (let i = length - 2; i >= 0; i -= 2) { + let digit = s.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + if (digit < 0 || digit > 9) { + throw new FormatException(); + } + sum += digit; + } + return (1000 - sum) % 10; + } + static decodeEnd(row, endStart) { + return AbstractUPCEANReader.findGuardPattern(row, endStart, false, AbstractUPCEANReader.START_END_PATTERN, new Int32Array(AbstractUPCEANReader.START_END_PATTERN.length).fill(0)); + } + /** + * @throws NotFoundException + */ + static findGuardPatternWithoutCounters(row, rowOffset, whiteFirst, pattern) { + return this.findGuardPattern(row, rowOffset, whiteFirst, pattern, new Int32Array(pattern.length)); + } + /** + * @param row row of black/white values to search + * @param rowOffset position to start search + * @param whiteFirst if true, indicates that the pattern specifies white/black/white/... + * pixel counts, otherwise, it is interpreted as black/white/black/... + * @param pattern pattern of counts of number of black and white pixels that are being + * searched for as a pattern + * @param counters array of counters, as long as pattern, to re-use + * @return start/end horizontal offset of guard pattern, as an array of two ints + * @throws NotFoundException if pattern is not found + */ + static findGuardPattern(row, rowOffset, whiteFirst, pattern, counters) { + let width = row.getSize(); + rowOffset = whiteFirst ? row.getNextUnset(rowOffset) : row.getNextSet(rowOffset); + let counterPosition = 0; + let patternStart = rowOffset; + let patternLength = pattern.length; + let isWhite = whiteFirst; + for (let x = rowOffset; x < width; x++) { + if (row.get(x) !== isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition === patternLength - 1) { + if (OneDReader.patternMatchVariance(counters, pattern, AbstractUPCEANReader.MAX_INDIVIDUAL_VARIANCE) < AbstractUPCEANReader.MAX_AVG_VARIANCE) { + return Int32Array.from([patternStart, x]); + } + patternStart += counters[0] + counters[1]; + let slice = counters.slice(2, counters.length - 1); + for (let i = 0; i < counterPosition - 1; i++) { + counters[i] = slice[i]; + } + counters[counterPosition - 1] = 0; + counters[counterPosition] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + throw new NotFoundException(); + } + static decodeDigit(row, counters, rowOffset, patterns) { + this.recordPattern(row, rowOffset, counters); + let bestVariance = this.MAX_AVG_VARIANCE; + let bestMatch = -1; + let max = patterns.length; + for (let i = 0; i < max; i++) { + let pattern = patterns[i]; + let variance = OneDReader.patternMatchVariance(counters, pattern, AbstractUPCEANReader.MAX_INDIVIDUAL_VARIANCE); + if (variance < bestVariance) { + bestVariance = variance; + bestMatch = i; + } + } + if (bestMatch >= 0) { + return bestMatch; + } + else { + throw new NotFoundException(); + } + } + } + // These two values are critical for determining how permissive the decoding will be. + // We've arrived at these values through a lot of trial and error. Setting them any higher + // lets false positives creep in quickly. + AbstractUPCEANReader.MAX_AVG_VARIANCE = 0.48; + AbstractUPCEANReader.MAX_INDIVIDUAL_VARIANCE = 0.7; + /** + * Start/end guard pattern. + */ + AbstractUPCEANReader.START_END_PATTERN = Int32Array.from([1, 1, 1]); + /** + * Pattern marking the middle of a UPC/EAN pattern, separating the two halves. + */ + AbstractUPCEANReader.MIDDLE_PATTERN = Int32Array.from([1, 1, 1, 1, 1]); + /** + * end guard pattern. + */ + AbstractUPCEANReader.END_PATTERN = Int32Array.from([1, 1, 1, 1, 1, 1]); + /** + * "Odd", or "L" patterns used to encode UPC/EAN digits. + */ + AbstractUPCEANReader.L_PATTERNS = [ + Int32Array.from([3, 2, 1, 1]), + Int32Array.from([2, 2, 2, 1]), + Int32Array.from([2, 1, 2, 2]), + Int32Array.from([1, 4, 1, 1]), + Int32Array.from([1, 1, 3, 2]), + Int32Array.from([1, 2, 3, 1]), + Int32Array.from([1, 1, 1, 4]), + Int32Array.from([1, 3, 1, 2]), + Int32Array.from([1, 2, 1, 3]), + Int32Array.from([3, 1, 1, 2]), + ]; + + /* + * Copyright (C) 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @see UPCEANExtension2Support + */ + class UPCEANExtension5Support { + constructor() { + this.CHECK_DIGIT_ENCODINGS = [0x18, 0x14, 0x12, 0x11, 0x0C, 0x06, 0x03, 0x0A, 0x09, 0x05]; + this.decodeMiddleCounters = Int32Array.from([0, 0, 0, 0]); + this.decodeRowStringBuffer = ''; + } + decodeRow(rowNumber, row, extensionStartRange) { + let result = this.decodeRowStringBuffer; + let end = this.decodeMiddle(row, extensionStartRange, result); + let resultString = result.toString(); + let extensionData = UPCEANExtension5Support.parseExtensionString(resultString); + let resultPoints = [ + new ResultPoint((extensionStartRange[0] + extensionStartRange[1]) / 2.0, rowNumber), + new ResultPoint(end, rowNumber) + ]; + let extensionResult = new Result(resultString, null, 0, resultPoints, BarcodeFormat$1.UPC_EAN_EXTENSION, new Date().getTime()); + if (extensionData != null) { + extensionResult.putAllMetadata(extensionData); + } + return extensionResult; + } + decodeMiddle(row, startRange, resultString) { + let counters = this.decodeMiddleCounters; + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + let end = row.getSize(); + let rowOffset = startRange[1]; + let lgPatternFound = 0; + for (let x = 0; x < 5 && rowOffset < end; x++) { + let bestMatch = AbstractUPCEANReader.decodeDigit(row, counters, rowOffset, AbstractUPCEANReader.L_AND_G_PATTERNS); + resultString += String.fromCharCode(('0'.charCodeAt(0) + bestMatch % 10)); + for (let counter of counters) { + rowOffset += counter; + } + if (bestMatch >= 10) { + lgPatternFound |= 1 << (4 - x); + } + if (x !== 4) { + // Read off separator if not last + rowOffset = row.getNextSet(rowOffset); + rowOffset = row.getNextUnset(rowOffset); + } + } + if (resultString.length !== 5) { + throw new NotFoundException(); + } + let checkDigit = this.determineCheckDigit(lgPatternFound); + if (UPCEANExtension5Support.extensionChecksum(resultString.toString()) !== checkDigit) { + throw new NotFoundException(); + } + return rowOffset; + } + static extensionChecksum(s) { + let length = s.length; + let sum = 0; + for (let i = length - 2; i >= 0; i -= 2) { + sum += s.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + } + sum *= 3; + for (let i = length - 1; i >= 0; i -= 2) { + sum += s.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + } + sum *= 3; + return sum % 10; + } + determineCheckDigit(lgPatternFound) { + for (let d = 0; d < 10; d++) { + if (lgPatternFound === this.CHECK_DIGIT_ENCODINGS[d]) { + return d; + } + } + throw new NotFoundException(); + } + static parseExtensionString(raw) { + if (raw.length !== 5) { + return null; + } + let value = UPCEANExtension5Support.parseExtension5String(raw); + if (value == null) { + return null; + } + return new Map([[ResultMetadataType$1.SUGGESTED_PRICE, value]]); + } + static parseExtension5String(raw) { + let currency; + switch (raw.charAt(0)) { + case '0': + currency = '£'; + break; + case '5': + currency = '$'; + break; + case '9': + // Reference: http://www.jollytech.com + switch (raw) { + case '90000': + // No suggested retail price + return null; + case '99991': + // Complementary + return '0.00'; + case '99990': + return 'Used'; + } + // Otherwise... unknown currency? + currency = ''; + break; + default: + currency = ''; + break; + } + let rawAmount = parseInt(raw.substring(1)); + let unitsString = (rawAmount / 100).toString(); + let hundredths = rawAmount % 100; + let hundredthsString = hundredths < 10 ? '0' + hundredths : hundredths.toString(); // fixme + return currency + unitsString + '.' + hundredthsString; + } + } + + /* + * Copyright (C) 2012 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @see UPCEANExtension5Support + */ + class UPCEANExtension2Support { + constructor() { + this.decodeMiddleCounters = Int32Array.from([0, 0, 0, 0]); + this.decodeRowStringBuffer = ''; + } + decodeRow(rowNumber, row, extensionStartRange) { + let result = this.decodeRowStringBuffer; + let end = this.decodeMiddle(row, extensionStartRange, result); + let resultString = result.toString(); + let extensionData = UPCEANExtension2Support.parseExtensionString(resultString); + let resultPoints = [ + new ResultPoint((extensionStartRange[0] + extensionStartRange[1]) / 2.0, rowNumber), + new ResultPoint(end, rowNumber) + ]; + let extensionResult = new Result(resultString, null, 0, resultPoints, BarcodeFormat$1.UPC_EAN_EXTENSION, new Date().getTime()); + if (extensionData != null) { + extensionResult.putAllMetadata(extensionData); + } + return extensionResult; + } + decodeMiddle(row, startRange, resultString) { + let counters = this.decodeMiddleCounters; + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + let end = row.getSize(); + let rowOffset = startRange[1]; + let checkParity = 0; + for (let x = 0; x < 2 && rowOffset < end; x++) { + let bestMatch = AbstractUPCEANReader.decodeDigit(row, counters, rowOffset, AbstractUPCEANReader.L_AND_G_PATTERNS); + resultString += String.fromCharCode(('0'.charCodeAt(0) + bestMatch % 10)); + for (let counter of counters) { + rowOffset += counter; + } + if (bestMatch >= 10) { + checkParity |= 1 << (1 - x); + } + if (x !== 1) { + // Read off separator if not last + rowOffset = row.getNextSet(rowOffset); + rowOffset = row.getNextUnset(rowOffset); + } + } + if (resultString.length !== 2) { + throw new NotFoundException(); + } + if (parseInt(resultString.toString()) % 4 !== checkParity) { + throw new NotFoundException(); + } + return rowOffset; + } + static parseExtensionString(raw) { + if (raw.length !== 2) { + return null; + } + return new Map([[ResultMetadataType$1.ISSUE_NUMBER, parseInt(raw)]]); + } + } + + /* + * Copyright (C) 2010 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + class UPCEANExtensionSupport { + static decodeRow(rowNumber, row, rowOffset) { + let extensionStartRange = AbstractUPCEANReader.findGuardPattern(row, rowOffset, false, this.EXTENSION_START_PATTERN, new Int32Array(this.EXTENSION_START_PATTERN.length).fill(0)); + try { + // return null; + let fiveSupport = new UPCEANExtension5Support(); + return fiveSupport.decodeRow(rowNumber, row, extensionStartRange); + } + catch (err) { + // return null; + let twoSupport = new UPCEANExtension2Support(); + return twoSupport.decodeRow(rowNumber, row, extensionStartRange); + } + } + } + UPCEANExtensionSupport.EXTENSION_START_PATTERN = Int32Array.from([1, 1, 2]); + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates functionality and implementation that is common to UPC and EAN families + * of one-dimensional barcodes.

+ * + * @author dswitkin@google.com (Daniel Switkin) + * @author Sean Owen + * @author alasdair@google.com (Alasdair Mackintosh) + */ + class UPCEANReader extends AbstractUPCEANReader { + constructor() { + super(); + this.decodeRowStringBuffer = ''; + UPCEANReader.L_AND_G_PATTERNS = UPCEANReader.L_PATTERNS.map(arr => Int32Array.from(arr)); + for (let i = 10; i < 20; i++) { + let widths = UPCEANReader.L_PATTERNS[i - 10]; + let reversedWidths = new Int32Array(widths.length); + for (let j = 0; j < widths.length; j++) { + reversedWidths[j] = widths[widths.length - j - 1]; + } + UPCEANReader.L_AND_G_PATTERNS[i] = reversedWidths; + } + } + decodeRow(rowNumber, row, hints) { + let startGuardRange = UPCEANReader.findStartGuardPattern(row); + let resultPointCallback = hints == null ? null : hints.get(DecodeHintType$1.NEED_RESULT_POINT_CALLBACK); + if (resultPointCallback != null) { + const resultPoint = new ResultPoint((startGuardRange[0] + startGuardRange[1]) / 2.0, rowNumber); + resultPointCallback.foundPossibleResultPoint(resultPoint); + } + let budello = this.decodeMiddle(row, startGuardRange, this.decodeRowStringBuffer); + let endStart = budello.rowOffset; + let result = budello.resultString; + if (resultPointCallback != null) { + const resultPoint = new ResultPoint(endStart, rowNumber); + resultPointCallback.foundPossibleResultPoint(resultPoint); + } + let endRange = UPCEANReader.decodeEnd(row, endStart); + if (resultPointCallback != null) { + const resultPoint = new ResultPoint((endRange[0] + endRange[1]) / 2.0, rowNumber); + resultPointCallback.foundPossibleResultPoint(resultPoint); + } + // Make sure there is a quiet zone at least as big as the end pattern after the barcode. The + // spec might want more whitespace, but in practice this is the maximum we can count on. + let end = endRange[1]; + let quietEnd = end + (end - endRange[0]); + if (quietEnd >= row.getSize() || !row.isRange(end, quietEnd, false)) { + throw new NotFoundException(); + } + let resultString = result.toString(); + // UPC/EAN should never be less than 8 chars anyway + if (resultString.length < 8) { + throw new FormatException(); + } + if (!UPCEANReader.checkChecksum(resultString)) { + throw new ChecksumException(); + } + let left = (startGuardRange[1] + startGuardRange[0]) / 2.0; + let right = (endRange[1] + endRange[0]) / 2.0; + let format = this.getBarcodeFormat(); + let resultPoint = [new ResultPoint(left, rowNumber), new ResultPoint(right, rowNumber)]; + let decodeResult = new Result(resultString, null, 0, resultPoint, format, new Date().getTime()); + let extensionLength = 0; + try { + let extensionResult = UPCEANExtensionSupport.decodeRow(rowNumber, row, endRange[1]); + decodeResult.putMetadata(ResultMetadataType$1.UPC_EAN_EXTENSION, extensionResult.getText()); + decodeResult.putAllMetadata(extensionResult.getResultMetadata()); + decodeResult.addResultPoints(extensionResult.getResultPoints()); + extensionLength = extensionResult.getText().length; + } + catch (err) { + } + let allowedExtensions = hints == null ? null : hints.get(DecodeHintType$1.ALLOWED_EAN_EXTENSIONS); + if (allowedExtensions != null) { + let valid = false; + for (let length in allowedExtensions) { + if (extensionLength.toString() === length) { // check me + valid = true; + break; + } + } + if (!valid) { + throw new NotFoundException(); + } + } + if (format === BarcodeFormat$1.EAN_13 || format === BarcodeFormat$1.UPC_A) ; + return decodeResult; + } + static checkChecksum(s) { + return UPCEANReader.checkStandardUPCEANChecksum(s); + } + static checkStandardUPCEANChecksum(s) { + let length = s.length; + if (length === 0) + return false; + let check = parseInt(s.charAt(length - 1), 10); + return UPCEANReader.getStandardUPCEANChecksum(s.substring(0, length - 1)) === check; + } + static getStandardUPCEANChecksum(s) { + let length = s.length; + let sum = 0; + for (let i = length - 1; i >= 0; i -= 2) { + let digit = s.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + if (digit < 0 || digit > 9) { + throw new FormatException(); + } + sum += digit; + } + sum *= 3; + for (let i = length - 2; i >= 0; i -= 2) { + let digit = s.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + if (digit < 0 || digit > 9) { + throw new FormatException(); + } + sum += digit; + } + return (1000 - sum) % 10; + } + static decodeEnd(row, endStart) { + return UPCEANReader.findGuardPattern(row, endStart, false, UPCEANReader.START_END_PATTERN, new Int32Array(UPCEANReader.START_END_PATTERN.length).fill(0)); + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Implements decoding of the EAN-13 format.

+ * + * @author dswitkin@google.com (Daniel Switkin) + * @author Sean Owen + * @author alasdair@google.com (Alasdair Mackintosh) + */ + class EAN13Reader extends UPCEANReader { + constructor() { + super(); + this.decodeMiddleCounters = Int32Array.from([0, 0, 0, 0]); + } + decodeMiddle(row, startRange, resultString) { + let counters = this.decodeMiddleCounters; + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + let end = row.getSize(); + let rowOffset = startRange[1]; + let lgPatternFound = 0; + for (let x = 0; x < 6 && rowOffset < end; x++) { + let bestMatch = UPCEANReader.decodeDigit(row, counters, rowOffset, UPCEANReader.L_AND_G_PATTERNS); + resultString += String.fromCharCode(('0'.charCodeAt(0) + bestMatch % 10)); + for (let counter of counters) { + rowOffset += counter; + } + if (bestMatch >= 10) { + lgPatternFound |= 1 << (5 - x); + } + } + resultString = EAN13Reader.determineFirstDigit(resultString, lgPatternFound); + let middleRange = UPCEANReader.findGuardPattern(row, rowOffset, true, UPCEANReader.MIDDLE_PATTERN, new Int32Array(UPCEANReader.MIDDLE_PATTERN.length).fill(0)); + rowOffset = middleRange[1]; + for (let x = 0; x < 6 && rowOffset < end; x++) { + let bestMatch = UPCEANReader.decodeDigit(row, counters, rowOffset, UPCEANReader.L_PATTERNS); + resultString += String.fromCharCode(('0'.charCodeAt(0) + bestMatch)); + for (let counter of counters) { + rowOffset += counter; + } + } + return { rowOffset, resultString }; + } + getBarcodeFormat() { + return BarcodeFormat$1.EAN_13; + } + static determineFirstDigit(resultString, lgPatternFound) { + for (let d = 0; d < 10; d++) { + if (lgPatternFound === this.FIRST_DIGIT_ENCODINGS[d]) { + resultString = String.fromCharCode(('0'.charCodeAt(0) + d)) + resultString; + return resultString; + } + } + throw new NotFoundException(); + } + } + EAN13Reader.FIRST_DIGIT_ENCODINGS = [0x00, 0x0B, 0x0D, 0xE, 0x13, 0x19, 0x1C, 0x15, 0x16, 0x1A]; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Implements decoding of the EAN-8 format.

+ * + * @author Sean Owen + */ + class EAN8Reader extends UPCEANReader { + constructor() { + super(); + this.decodeMiddleCounters = Int32Array.from([0, 0, 0, 0]); + } + decodeMiddle(row, startRange, resultString) { + const counters = this.decodeMiddleCounters; + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + let end = row.getSize(); + let rowOffset = startRange[1]; + for (let x = 0; x < 4 && rowOffset < end; x++) { + let bestMatch = UPCEANReader.decodeDigit(row, counters, rowOffset, UPCEANReader.L_PATTERNS); + resultString += String.fromCharCode(('0'.charCodeAt(0) + bestMatch)); + for (let counter of counters) { + rowOffset += counter; + } + } + let middleRange = UPCEANReader.findGuardPattern(row, rowOffset, true, UPCEANReader.MIDDLE_PATTERN, new Int32Array(UPCEANReader.MIDDLE_PATTERN.length).fill(0)); + rowOffset = middleRange[1]; + for (let x = 0; x < 4 && rowOffset < end; x++) { + let bestMatch = UPCEANReader.decodeDigit(row, counters, rowOffset, UPCEANReader.L_PATTERNS); + resultString += String.fromCharCode(('0'.charCodeAt(0) + bestMatch)); + for (let counter of counters) { + rowOffset += counter; + } + } + return { rowOffset, resultString }; + } + getBarcodeFormat() { + return BarcodeFormat$1.EAN_8; + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Encapsulates functionality and implementation that is common to all families + * of one-dimensional barcodes. + * + * @author dswitkin@google.com (Daniel Switkin) + * @author Sean Owen + * @author sam2332 (Sam Rudloff) + * + * @source https://github.com/zxing/zxing/blob/3c96923276dd5785d58eb970b6ba3f80d36a9505/core/src/main/java/com/google/zxing/oned/UPCAReader.java + * + * @experimental + */ + class UPCAReader extends UPCEANReader { + constructor() { + super(...arguments); + this.ean13Reader = new EAN13Reader(); + } + // @Override + getBarcodeFormat() { + return BarcodeFormat$1.UPC_A; + } + // Note that we don't try rotation without the try harder flag, even if rotation was supported. + // @Override + decode(image, hints) { + return this.maybeReturnResult(this.ean13Reader.decode(image)); + } + // @Override + decodeRow(rowNumber, row, hints) { + return this.maybeReturnResult(this.ean13Reader.decodeRow(rowNumber, row, hints)); + } + // @Override + decodeMiddle(row, startRange, resultString) { + return this.ean13Reader.decodeMiddle(row, startRange, resultString); + } + maybeReturnResult(result) { + let text = result.getText(); + if (text.charAt(0) === '0') { + let upcaResult = new Result(text.substring(1), null, null, result.getResultPoints(), BarcodeFormat$1.UPC_A); + if (result.getResultMetadata() != null) { + upcaResult.putAllMetadata(result.getResultMetadata()); + } + return upcaResult; + } + else { + throw new NotFoundException(); + } + } + reset() { + this.ean13Reader.reset(); + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // package com.google.zxing.oned; + // import com.google.zxing.BarcodeFormat; + // import com.google.zxing.FormatException; + // import com.google.zxing.NotFoundException; + // import com.google.zxing.common.BitArray; + /** + *

Implements decoding of the UPC-E format.

+ *

This is a great reference for + * UPC-E information.

+ * + * @author Sean Owen + * + * @source https://github.com/zxing/zxing/blob/3c96923276dd5785d58eb970b6ba3f80d36a9505/core/src/main/java/com/google/zxing/oned/UPCEReader.java + * + * @experimental + */ + /* final */ class UPCEReader extends UPCEANReader { + constructor() { + super(); + this.decodeMiddleCounters = new Int32Array(4); + } + /** + * @throws NotFoundException + */ + // @Override + decodeMiddle(row, startRange, result) { + const counters = this.decodeMiddleCounters.map(x => x); + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + const end = row.getSize(); + let rowOffset = startRange[1]; + let lgPatternFound = 0; + for (let x = 0; x < 6 && rowOffset < end; x++) { + const bestMatch = UPCEReader.decodeDigit(row, counters, rowOffset, UPCEReader.L_AND_G_PATTERNS); + result += String.fromCharCode(('0'.charCodeAt(0) + bestMatch % 10)); + for (let counter of counters) { + rowOffset += counter; + } + if (bestMatch >= 10) { + lgPatternFound |= 1 << (5 - x); + } + } + UPCEReader.determineNumSysAndCheckDigit(new StringBuilder(result), lgPatternFound); + return rowOffset; + } + /** + * @throws NotFoundException + */ + // @Override + decodeEnd(row, endStart) { + return UPCEReader.findGuardPatternWithoutCounters(row, endStart, true, UPCEReader.MIDDLE_END_PATTERN); + } + /** + * @throws FormatException + */ + // @Override + checkChecksum(s) { + return UPCEANReader.checkChecksum(UPCEReader.convertUPCEtoUPCA(s)); + } + /** + * @throws NotFoundException + */ + static determineNumSysAndCheckDigit(resultString, lgPatternFound) { + for (let numSys = 0; numSys <= 1; numSys++) { + for (let d = 0; d < 10; d++) { + if (lgPatternFound === this.NUMSYS_AND_CHECK_DIGIT_PATTERNS[numSys][d]) { + resultString.insert(0, /*(char)*/ ('0' + numSys)); + resultString.append(/*(char)*/ ('0' + d)); + return; + } + } + } + throw NotFoundException.getNotFoundInstance(); + } + // @Override + getBarcodeFormat() { + return BarcodeFormat$1.UPC_E; + } + /** + * Expands a UPC-E value back into its full, equivalent UPC-A code value. + * + * @param upce UPC-E code as string of digits + * @return equivalent UPC-A code as string of digits + */ + static convertUPCEtoUPCA(upce) { + // the following line is equivalent to upce.getChars(1, 7, upceChars, 0); + const upceChars = upce.slice(1, 7).split('').map(x => x.charCodeAt(0)); + const result = new StringBuilder( /*12*/); + result.append(upce.charAt(0)); + let lastChar = upceChars[5]; + switch (lastChar) { + case 0: + case 1: + case 2: + result.appendChars(upceChars, 0, 2); + result.append(lastChar); + result.append('0000'); + result.appendChars(upceChars, 2, 3); + break; + case 3: + result.appendChars(upceChars, 0, 3); + result.append('00000'); + result.appendChars(upceChars, 3, 2); + break; + case 4: + result.appendChars(upceChars, 0, 4); + result.append('00000'); + result.append(upceChars[4]); + break; + default: + result.appendChars(upceChars, 0, 5); + result.append('0000'); + result.append(lastChar); + break; + } + // Only append check digit in conversion if supplied + if (upce.length >= 8) { + result.append(upce.charAt(7)); + } + return result.toString(); + } + } + /** + * The pattern that marks the middle, and end, of a UPC-E pattern. + * There is no "second half" to a UPC-E barcode. + */ + UPCEReader.MIDDLE_END_PATTERN = Int32Array.from([1, 1, 1, 1, 1, 1]); + // For an UPC-E barcode, the final digit is represented by the parities used + // to encode the middle six digits, according to the table below. + // + // Parity of next 6 digits + // Digit 0 1 2 3 4 5 + // 0 Even Even Even Odd Odd Odd + // 1 Even Even Odd Even Odd Odd + // 2 Even Even Odd Odd Even Odd + // 3 Even Even Odd Odd Odd Even + // 4 Even Odd Even Even Odd Odd + // 5 Even Odd Odd Even Even Odd + // 6 Even Odd Odd Odd Even Even + // 7 Even Odd Even Odd Even Odd + // 8 Even Odd Even Odd Odd Even + // 9 Even Odd Odd Even Odd Even + // + // The encoding is represented by the following array, which is a bit pattern + // using Odd = 0 and Even = 1. For example, 5 is represented by: + // + // Odd Even Even Odd Odd Even + // in binary: + // 0 1 1 0 0 1 == 0x19 + // + /** + * See {@link #L_AND_G_PATTERNS}; these values similarly represent patterns of + * even-odd parity encodings of digits that imply both the number system (0 or 1) + * used, and the check digit. + */ + UPCEReader.NUMSYS_AND_CHECK_DIGIT_PATTERNS = [ + Int32Array.from([0x38, 0x34, 0x32, 0x31, 0x2C, 0x26, 0x23, 0x2A, 0x29, 0x25]), + Int32Array.from([0x07, 0x0B, 0x0D, 0x0E, 0x13, 0x19, 0x1C, 0x15, 0x16, 0x1]), + ]; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

A reader that can read all available UPC/EAN formats. If a caller wants to try to + * read all such formats, it is most efficient to use this implementation rather than invoke + * individual readers.

+ * + * @author Sean Owen + */ + class MultiFormatUPCEANReader extends OneDReader { + constructor(hints) { + super(); + let possibleFormats = hints == null ? null : hints.get(DecodeHintType$1.POSSIBLE_FORMATS); + let readers = []; + if (possibleFormats != null) { + if (possibleFormats.indexOf(BarcodeFormat$1.EAN_13) > -1) { + readers.push(new EAN13Reader()); + } + else if (possibleFormats.indexOf(BarcodeFormat$1.UPC_A) > -1) { + readers.push(new UPCAReader()); + } + if (possibleFormats.indexOf(BarcodeFormat$1.EAN_8) > -1) { + readers.push(new EAN8Reader()); + } + if (possibleFormats.indexOf(BarcodeFormat$1.UPC_E) > -1) { + readers.push(new UPCEReader()); + } + } + if (readers.length === 0) { + readers.push(new EAN13Reader()); + // UPC-A is covered by EAN-13 + readers.push(new EAN8Reader()); + readers.push(new UPCEReader()); + } + this.readers = readers; + } + decodeRow(rowNumber, row, hints) { + for (let reader of this.readers) { + try { + // const result: Result = reader.decodeRow(rowNumber, row, startGuardPattern, hints); + const result = reader.decodeRow(rowNumber, row, hints); + // Special case: a 12-digit code encoded in UPC-A is identical to a "0" + // followed by those 12 digits encoded as EAN-13. Each will recognize such a code, + // UPC-A as a 12-digit string and EAN-13 as a 13-digit string starting with "0". + // Individually these are correct and their readers will both read such a code + // and correctly call it EAN-13, or UPC-A, respectively. + // + // In this case, if we've been looking for both types, we'd like to call it + // a UPC-A code. But for efficiency we only run the EAN-13 decoder to also read + // UPC-A. So we special case it here, and convert an EAN-13 result to a UPC-A + // result if appropriate. + // + // But, don't return UPC-A if UPC-A was not a requested format! + const ean13MayBeUPCA = result.getBarcodeFormat() === BarcodeFormat$1.EAN_13 && + result.getText().charAt(0) === '0'; + // @SuppressWarnings("unchecked") + const possibleFormats = hints == null ? null : hints.get(DecodeHintType$1.POSSIBLE_FORMATS); + const canReturnUPCA = possibleFormats == null || possibleFormats.includes(BarcodeFormat$1.UPC_A); + if (ean13MayBeUPCA && canReturnUPCA) { + const rawBytes = result.getRawBytes(); + // Transfer the metadata across + const resultUPCA = new Result(result.getText().substring(1), rawBytes, rawBytes.length, result.getResultPoints(), BarcodeFormat$1.UPC_A); + resultUPCA.putAllMetadata(result.getResultMetadata()); + return resultUPCA; + } + return result; + } + catch (err) { + // continue; + } + } + throw new NotFoundException(); + } + reset() { + for (let reader of this.readers) { + reader.reset(); + } + } + } + + // import Integer from '../../util/Integer'; + // import Float from '../../util/Float'; + class AbstractRSSReader extends OneDReader { + constructor() { + super(); + this.decodeFinderCounters = new Int32Array(4); + this.dataCharacterCounters = new Int32Array(8); + this.oddRoundingErrors = new Array(4); + this.evenRoundingErrors = new Array(4); + this.oddCounts = new Array(this.dataCharacterCounters.length / 2); + this.evenCounts = new Array(this.dataCharacterCounters.length / 2); + } + getDecodeFinderCounters() { + return this.decodeFinderCounters; + } + getDataCharacterCounters() { + return this.dataCharacterCounters; + } + getOddRoundingErrors() { + return this.oddRoundingErrors; + } + getEvenRoundingErrors() { + return this.evenRoundingErrors; + } + getOddCounts() { + return this.oddCounts; + } + getEvenCounts() { + return this.evenCounts; + } + parseFinderValue(counters, finderPatterns) { + for (let value = 0; value < finderPatterns.length; value++) { + if (OneDReader.patternMatchVariance(counters, finderPatterns[value], AbstractRSSReader.MAX_INDIVIDUAL_VARIANCE) < AbstractRSSReader.MAX_AVG_VARIANCE) { + return value; + } + } + throw new NotFoundException(); + } + /** + * @param array values to sum + * @return sum of values + * @deprecated call {@link MathUtils#sum(int[])} + */ + static count(array) { + return MathUtils.sum(new Int32Array(array)); + } + static increment(array, errors) { + let index = 0; + let biggestError = errors[0]; + for (let i = 1; i < array.length; i++) { + if (errors[i] > biggestError) { + biggestError = errors[i]; + index = i; + } + } + array[index]++; + } + static decrement(array, errors) { + let index = 0; + let biggestError = errors[0]; + for (let i = 1; i < array.length; i++) { + if (errors[i] < biggestError) { + biggestError = errors[i]; + index = i; + } + } + array[index]--; + } + static isFinderPattern(counters) { + let firstTwoSum = counters[0] + counters[1]; + let sum = firstTwoSum + counters[2] + counters[3]; + let ratio = firstTwoSum / sum; + if (ratio >= AbstractRSSReader.MIN_FINDER_PATTERN_RATIO && ratio <= AbstractRSSReader.MAX_FINDER_PATTERN_RATIO) { + // passes ratio test in spec, but see if the counts are unreasonable + let minCounter = Number.MAX_SAFE_INTEGER; + let maxCounter = Number.MIN_SAFE_INTEGER; + for (let counter of counters) { + if (counter > maxCounter) { + maxCounter = counter; + } + if (counter < minCounter) { + minCounter = counter; + } + } + return maxCounter < 10 * minCounter; + } + return false; + } + } + AbstractRSSReader.MAX_AVG_VARIANCE = 0.2; + AbstractRSSReader.MAX_INDIVIDUAL_VARIANCE = 0.45; + AbstractRSSReader.MIN_FINDER_PATTERN_RATIO = 9.5 / 12.0; + AbstractRSSReader.MAX_FINDER_PATTERN_RATIO = 12.5 / 14.0; + + class DataCharacter { + constructor(value, checksumPortion) { + this.value = value; + this.checksumPortion = checksumPortion; + } + getValue() { + return this.value; + } + getChecksumPortion() { + return this.checksumPortion; + } + toString() { + return this.value + '(' + this.checksumPortion + ')'; + } + equals(o) { + if (!(o instanceof DataCharacter)) { + return false; + } + const that = o; + return this.value === that.value && this.checksumPortion === that.checksumPortion; + } + hashCode() { + return this.value ^ this.checksumPortion; + } + } + + class FinderPattern { + constructor(value, startEnd, start, end, rowNumber) { + this.value = value; + this.startEnd = startEnd; + this.value = value; + this.startEnd = startEnd; + this.resultPoints = new Array(); + this.resultPoints.push(new ResultPoint(start, rowNumber)); + this.resultPoints.push(new ResultPoint(end, rowNumber)); + } + getValue() { + return this.value; + } + getStartEnd() { + return this.startEnd; + } + getResultPoints() { + return this.resultPoints; + } + equals(o) { + if (!(o instanceof FinderPattern)) { + return false; + } + const that = o; + return this.value === that.value; + } + hashCode() { + return this.value; + } + } + + /** + * RSS util functions. + */ + class RSSUtils { + constructor() { } + static getRSSvalue(widths, maxWidth, noNarrow) { + let n = 0; + for (let width of widths) { + n += width; + } + let val = 0; + let narrowMask = 0; + let elements = widths.length; + for (let bar = 0; bar < elements - 1; bar++) { + let elmWidth; + for (elmWidth = 1, narrowMask |= 1 << bar; elmWidth < widths[bar]; elmWidth++, narrowMask &= ~(1 << bar)) { + let subVal = RSSUtils.combins(n - elmWidth - 1, elements - bar - 2); + if (noNarrow && (narrowMask === 0) && (n - elmWidth - (elements - bar - 1) >= elements - bar - 1)) { + subVal -= RSSUtils.combins(n - elmWidth - (elements - bar), elements - bar - 2); + } + if (elements - bar - 1 > 1) { + let lessVal = 0; + for (let mxwElement = n - elmWidth - (elements - bar - 2); mxwElement > maxWidth; mxwElement--) { + lessVal += RSSUtils.combins(n - elmWidth - mxwElement - 1, elements - bar - 3); + } + subVal -= lessVal * (elements - 1 - bar); + } + else if (n - elmWidth > maxWidth) { + subVal--; + } + val += subVal; + } + n -= elmWidth; + } + return val; + } + static combins(n, r) { + let maxDenom; + let minDenom; + if (n - r > r) { + minDenom = r; + maxDenom = n - r; + } + else { + minDenom = n - r; + maxDenom = r; + } + let val = 1; + let j = 1; + for (let i = n; i > maxDenom; i--) { + val *= i; + if (j <= minDenom) { + val /= j; + j++; + } + } + while ((j <= minDenom)) { + val /= j; + j++; + } + return val; + } + } + + class BitArrayBuilder { + static buildBitArray(pairs) { + let charNumber = (pairs.length * 2) - 1; + if (pairs[pairs.length - 1].getRightChar() == null) { + charNumber -= 1; + } + let size = 12 * charNumber; + let binary = new BitArray(size); + let accPos = 0; + let firstPair = pairs[0]; + let firstValue = firstPair.getRightChar().getValue(); + for (let i = 11; i >= 0; --i) { + if ((firstValue & (1 << i)) != 0) { + binary.set(accPos); + } + accPos++; + } + for (let i = 1; i < pairs.length; ++i) { + let currentPair = pairs[i]; + let leftValue = currentPair.getLeftChar().getValue(); + for (let j = 11; j >= 0; --j) { + if ((leftValue & (1 << j)) != 0) { + binary.set(accPos); + } + accPos++; + } + if (currentPair.getRightChar() != null) { + let rightValue = currentPair.getRightChar().getValue(); + for (let j = 11; j >= 0; --j) { + if ((rightValue & (1 << j)) != 0) { + binary.set(accPos); + } + accPos++; + } + } + } + return binary; + } + } + + class BlockParsedResult { + constructor(finished, decodedInformation) { + if (decodedInformation) { + this.decodedInformation = null; + } + else { + this.finished = finished; + this.decodedInformation = decodedInformation; + } + } + getDecodedInformation() { + return this.decodedInformation; + } + isFinished() { + return this.finished; + } + } + + class DecodedObject { + constructor(newPosition) { + this.newPosition = newPosition; + } + getNewPosition() { + return this.newPosition; + } + } + + class DecodedChar extends DecodedObject { + constructor(newPosition, value) { + super(newPosition); + this.value = value; + } + getValue() { + return this.value; + } + isFNC1() { + return this.value === DecodedChar.FNC1; + } + } + DecodedChar.FNC1 = '$'; + + class DecodedInformation extends DecodedObject { + constructor(newPosition, newString, remainingValue) { + super(newPosition); + if (remainingValue) { + this.remaining = true; + this.remainingValue = this.remainingValue; + } + else { + this.remaining = false; + this.remainingValue = 0; + } + this.newString = newString; + } + getNewString() { + return this.newString; + } + isRemaining() { + return this.remaining; + } + getRemainingValue() { + return this.remainingValue; + } + } + + class DecodedNumeric extends DecodedObject { + constructor(newPosition, firstDigit, secondDigit) { + super(newPosition); + if (firstDigit < 0 || firstDigit > 10 || secondDigit < 0 || secondDigit > 10) { + throw new FormatException(); + } + this.firstDigit = firstDigit; + this.secondDigit = secondDigit; + } + getFirstDigit() { + return this.firstDigit; + } + getSecondDigit() { + return this.secondDigit; + } + getValue() { + return this.firstDigit * 10 + this.secondDigit; + } + isFirstDigitFNC1() { + return this.firstDigit === DecodedNumeric.FNC1; + } + isSecondDigitFNC1() { + return this.secondDigit === DecodedNumeric.FNC1; + } + isAnyFNC1() { + return this.firstDigit === DecodedNumeric.FNC1 || this.secondDigit === DecodedNumeric.FNC1; + } + } + DecodedNumeric.FNC1 = 10; + + class FieldParser { + constructor() { + } + static parseFieldsInGeneralPurpose(rawInformation) { + if (!rawInformation) { + return null; + } + // Processing 2-digit AIs + if (rawInformation.length < 2) { + throw new NotFoundException(); + } + let firstTwoDigits = rawInformation.substring(0, 2); + for (let dataLength of FieldParser.TWO_DIGIT_DATA_LENGTH) { + if (dataLength[0] === firstTwoDigits) { + if (dataLength[1] === FieldParser.VARIABLE_LENGTH) { + return FieldParser.processVariableAI(2, dataLength[2], rawInformation); + } + return FieldParser.processFixedAI(2, dataLength[1], rawInformation); + } + } + if (rawInformation.length < 3) { + throw new NotFoundException(); + } + let firstThreeDigits = rawInformation.substring(0, 3); + for (let dataLength of FieldParser.THREE_DIGIT_DATA_LENGTH) { + if (dataLength[0] === firstThreeDigits) { + if (dataLength[1] === FieldParser.VARIABLE_LENGTH) { + return FieldParser.processVariableAI(3, dataLength[2], rawInformation); + } + return FieldParser.processFixedAI(3, dataLength[1], rawInformation); + } + } + for (let dataLength of FieldParser.THREE_DIGIT_PLUS_DIGIT_DATA_LENGTH) { + if (dataLength[0] === firstThreeDigits) { + if (dataLength[1] === FieldParser.VARIABLE_LENGTH) { + return FieldParser.processVariableAI(4, dataLength[2], rawInformation); + } + return FieldParser.processFixedAI(4, dataLength[1], rawInformation); + } + } + if (rawInformation.length < 4) { + throw new NotFoundException(); + } + let firstFourDigits = rawInformation.substring(0, 4); + for (let dataLength of FieldParser.FOUR_DIGIT_DATA_LENGTH) { + if (dataLength[0] === firstFourDigits) { + if (dataLength[1] === FieldParser.VARIABLE_LENGTH) { + return FieldParser.processVariableAI(4, dataLength[2], rawInformation); + } + return FieldParser.processFixedAI(4, dataLength[1], rawInformation); + } + } + throw new NotFoundException(); + } + static processFixedAI(aiSize, fieldSize, rawInformation) { + if (rawInformation.length < aiSize) { + throw new NotFoundException(); + } + let ai = rawInformation.substring(0, aiSize); + if (rawInformation.length < aiSize + fieldSize) { + throw new NotFoundException(); + } + let field = rawInformation.substring(aiSize, aiSize + fieldSize); + let remaining = rawInformation.substring(aiSize + fieldSize); + let result = '(' + ai + ')' + field; + let parsedAI = FieldParser.parseFieldsInGeneralPurpose(remaining); + return parsedAI == null ? result : result + parsedAI; + } + static processVariableAI(aiSize, variableFieldSize, rawInformation) { + let ai = rawInformation.substring(0, aiSize); + let maxSize; + if (rawInformation.length < aiSize + variableFieldSize) { + maxSize = rawInformation.length; + } + else { + maxSize = aiSize + variableFieldSize; + } + let field = rawInformation.substring(aiSize, maxSize); + let remaining = rawInformation.substring(maxSize); + let result = '(' + ai + ')' + field; + let parsedAI = FieldParser.parseFieldsInGeneralPurpose(remaining); + return parsedAI == null ? result : result + parsedAI; + } + } + FieldParser.VARIABLE_LENGTH = []; + FieldParser.TWO_DIGIT_DATA_LENGTH = [ + ['00', 18], + ['01', 14], + ['02', 14], + ['10', FieldParser.VARIABLE_LENGTH, 20], + ['11', 6], + ['12', 6], + ['13', 6], + ['15', 6], + ['17', 6], + ['20', 2], + ['21', FieldParser.VARIABLE_LENGTH, 20], + ['22', FieldParser.VARIABLE_LENGTH, 29], + ['30', FieldParser.VARIABLE_LENGTH, 8], + ['37', FieldParser.VARIABLE_LENGTH, 8], + // internal company codes + ['90', FieldParser.VARIABLE_LENGTH, 30], + ['91', FieldParser.VARIABLE_LENGTH, 30], + ['92', FieldParser.VARIABLE_LENGTH, 30], + ['93', FieldParser.VARIABLE_LENGTH, 30], + ['94', FieldParser.VARIABLE_LENGTH, 30], + ['95', FieldParser.VARIABLE_LENGTH, 30], + ['96', FieldParser.VARIABLE_LENGTH, 30], + ['97', FieldParser.VARIABLE_LENGTH, 3], + ['98', FieldParser.VARIABLE_LENGTH, 30], + ['99', FieldParser.VARIABLE_LENGTH, 30], + ]; + FieldParser.THREE_DIGIT_DATA_LENGTH = [ + // Same format as above + ['240', FieldParser.VARIABLE_LENGTH, 30], + ['241', FieldParser.VARIABLE_LENGTH, 30], + ['242', FieldParser.VARIABLE_LENGTH, 6], + ['250', FieldParser.VARIABLE_LENGTH, 30], + ['251', FieldParser.VARIABLE_LENGTH, 30], + ['253', FieldParser.VARIABLE_LENGTH, 17], + ['254', FieldParser.VARIABLE_LENGTH, 20], + ['400', FieldParser.VARIABLE_LENGTH, 30], + ['401', FieldParser.VARIABLE_LENGTH, 30], + ['402', 17], + ['403', FieldParser.VARIABLE_LENGTH, 30], + ['410', 13], + ['411', 13], + ['412', 13], + ['413', 13], + ['414', 13], + ['420', FieldParser.VARIABLE_LENGTH, 20], + ['421', FieldParser.VARIABLE_LENGTH, 15], + ['422', 3], + ['423', FieldParser.VARIABLE_LENGTH, 15], + ['424', 3], + ['425', 3], + ['426', 3], + ]; + FieldParser.THREE_DIGIT_PLUS_DIGIT_DATA_LENGTH = [ + // Same format as above + ['310', 6], + ['311', 6], + ['312', 6], + ['313', 6], + ['314', 6], + ['315', 6], + ['316', 6], + ['320', 6], + ['321', 6], + ['322', 6], + ['323', 6], + ['324', 6], + ['325', 6], + ['326', 6], + ['327', 6], + ['328', 6], + ['329', 6], + ['330', 6], + ['331', 6], + ['332', 6], + ['333', 6], + ['334', 6], + ['335', 6], + ['336', 6], + ['340', 6], + ['341', 6], + ['342', 6], + ['343', 6], + ['344', 6], + ['345', 6], + ['346', 6], + ['347', 6], + ['348', 6], + ['349', 6], + ['350', 6], + ['351', 6], + ['352', 6], + ['353', 6], + ['354', 6], + ['355', 6], + ['356', 6], + ['357', 6], + ['360', 6], + ['361', 6], + ['362', 6], + ['363', 6], + ['364', 6], + ['365', 6], + ['366', 6], + ['367', 6], + ['368', 6], + ['369', 6], + ['390', FieldParser.VARIABLE_LENGTH, 15], + ['391', FieldParser.VARIABLE_LENGTH, 18], + ['392', FieldParser.VARIABLE_LENGTH, 15], + ['393', FieldParser.VARIABLE_LENGTH, 18], + ['703', FieldParser.VARIABLE_LENGTH, 30], + ]; + FieldParser.FOUR_DIGIT_DATA_LENGTH = [ + // Same format as above + ['7001', 13], + ['7002', FieldParser.VARIABLE_LENGTH, 30], + ['7003', 10], + ['8001', 14], + ['8002', FieldParser.VARIABLE_LENGTH, 20], + ['8003', FieldParser.VARIABLE_LENGTH, 30], + ['8004', FieldParser.VARIABLE_LENGTH, 30], + ['8005', 6], + ['8006', 18], + ['8007', FieldParser.VARIABLE_LENGTH, 30], + ['8008', FieldParser.VARIABLE_LENGTH, 12], + ['8018', 18], + ['8020', FieldParser.VARIABLE_LENGTH, 25], + ['8100', 6], + ['8101', 10], + ['8102', 2], + ['8110', FieldParser.VARIABLE_LENGTH, 70], + ['8200', FieldParser.VARIABLE_LENGTH, 70], + ]; + + class GeneralAppIdDecoder { + constructor(information) { + this.buffer = new StringBuilder(); + this.information = information; + } + decodeAllCodes(buff, initialPosition) { + let currentPosition = initialPosition; + let remaining = null; + do { + let info = this.decodeGeneralPurposeField(currentPosition, remaining); + let parsedFields = FieldParser.parseFieldsInGeneralPurpose(info.getNewString()); + if (parsedFields != null) { + buff.append(parsedFields); + } + if (info.isRemaining()) { + remaining = '' + info.getRemainingValue(); + } + else { + remaining = null; + } + if (currentPosition === info.getNewPosition()) { // No step forward! + break; + } + currentPosition = info.getNewPosition(); + } while (true); + return buff.toString(); + } + isStillNumeric(pos) { + // It's numeric if it still has 7 positions + // and one of the first 4 bits is "1". + if (pos + 7 > this.information.getSize()) { + return pos + 4 <= this.information.getSize(); + } + for (let i = pos; i < pos + 3; ++i) { + if (this.information.get(i)) { + return true; + } + } + return this.information.get(pos + 3); + } + decodeNumeric(pos) { + if (pos + 7 > this.information.getSize()) { + let numeric = this.extractNumericValueFromBitArray(pos, 4); + if (numeric === 0) { + return new DecodedNumeric(this.information.getSize(), DecodedNumeric.FNC1, DecodedNumeric.FNC1); + } + return new DecodedNumeric(this.information.getSize(), numeric - 1, DecodedNumeric.FNC1); + } + let numeric = this.extractNumericValueFromBitArray(pos, 7); + let digit1 = (numeric - 8) / 11; + let digit2 = (numeric - 8) % 11; + return new DecodedNumeric(pos + 7, digit1, digit2); + } + extractNumericValueFromBitArray(pos, bits) { + return GeneralAppIdDecoder.extractNumericValueFromBitArray(this.information, pos, bits); + } + static extractNumericValueFromBitArray(information, pos, bits) { + let value = 0; + for (let i = 0; i < bits; ++i) { + if (information.get(pos + i)) { + value |= 1 << (bits - i - 1); + } + } + return value; + } + decodeGeneralPurposeField(pos, remaining) { + // this.buffer.setLength(0); + this.buffer.setLengthToZero(); + if (remaining != null) { + this.buffer.append(remaining); + } + this.current.setPosition(pos); + let lastDecoded = this.parseBlocks(); + if (lastDecoded != null && lastDecoded.isRemaining()) { + return new DecodedInformation(this.current.getPosition(), this.buffer.toString(), lastDecoded.getRemainingValue()); + } + return new DecodedInformation(this.current.getPosition(), this.buffer.toString()); + } + parseBlocks() { + let isFinished; + let result; + do { + let initialPosition = this.current.getPosition(); + if (this.current.isAlpha()) { + result = this.parseAlphaBlock(); + isFinished = result.isFinished(); + } + else if (this.current.isIsoIec646()) { + result = this.parseIsoIec646Block(); + isFinished = result.isFinished(); + } + else { // it must be numeric + result = this.parseNumericBlock(); + isFinished = result.isFinished(); + } + let positionChanged = initialPosition !== this.current.getPosition(); + if (!positionChanged && !isFinished) { + break; + } + } while (!isFinished); + return result.getDecodedInformation(); + } + parseNumericBlock() { + while (this.isStillNumeric(this.current.getPosition())) { + let numeric = this.decodeNumeric(this.current.getPosition()); + this.current.setPosition(numeric.getNewPosition()); + if (numeric.isFirstDigitFNC1()) { + let information; + if (numeric.isSecondDigitFNC1()) { + information = new DecodedInformation(this.current.getPosition(), this.buffer.toString()); + } + else { + information = new DecodedInformation(this.current.getPosition(), this.buffer.toString(), numeric.getSecondDigit()); + } + return new BlockParsedResult(true, information); + } + this.buffer.append(numeric.getFirstDigit()); + if (numeric.isSecondDigitFNC1()) { + let information = new DecodedInformation(this.current.getPosition(), this.buffer.toString()); + return new BlockParsedResult(true, information); + } + this.buffer.append(numeric.getSecondDigit()); + } + if (this.isNumericToAlphaNumericLatch(this.current.getPosition())) { + this.current.setAlpha(); + this.current.incrementPosition(4); + } + return new BlockParsedResult(false); + } + parseIsoIec646Block() { + while (this.isStillIsoIec646(this.current.getPosition())) { + let iso = this.decodeIsoIec646(this.current.getPosition()); + this.current.setPosition(iso.getNewPosition()); + if (iso.isFNC1()) { + let information = new DecodedInformation(this.current.getPosition(), this.buffer.toString()); + return new BlockParsedResult(true, information); + } + this.buffer.append(iso.getValue()); + } + if (this.isAlphaOr646ToNumericLatch(this.current.getPosition())) { + this.current.incrementPosition(3); + this.current.setNumeric(); + } + else if (this.isAlphaTo646ToAlphaLatch(this.current.getPosition())) { + if (this.current.getPosition() + 5 < this.information.getSize()) { + this.current.incrementPosition(5); + } + else { + this.current.setPosition(this.information.getSize()); + } + this.current.setAlpha(); + } + return new BlockParsedResult(false); + } + parseAlphaBlock() { + while (this.isStillAlpha(this.current.getPosition())) { + let alpha = this.decodeAlphanumeric(this.current.getPosition()); + this.current.setPosition(alpha.getNewPosition()); + if (alpha.isFNC1()) { + let information = new DecodedInformation(this.current.getPosition(), this.buffer.toString()); + return new BlockParsedResult(true, information); // end of the char block + } + this.buffer.append(alpha.getValue()); + } + if (this.isAlphaOr646ToNumericLatch(this.current.getPosition())) { + this.current.incrementPosition(3); + this.current.setNumeric(); + } + else if (this.isAlphaTo646ToAlphaLatch(this.current.getPosition())) { + if (this.current.getPosition() + 5 < this.information.getSize()) { + this.current.incrementPosition(5); + } + else { + this.current.setPosition(this.information.getSize()); + } + this.current.setIsoIec646(); + } + return new BlockParsedResult(false); + } + isStillIsoIec646(pos) { + if (pos + 5 > this.information.getSize()) { + return false; + } + let fiveBitValue = this.extractNumericValueFromBitArray(pos, 5); + if (fiveBitValue >= 5 && fiveBitValue < 16) { + return true; + } + if (pos + 7 > this.information.getSize()) { + return false; + } + let sevenBitValue = this.extractNumericValueFromBitArray(pos, 7); + if (sevenBitValue >= 64 && sevenBitValue < 116) { + return true; + } + if (pos + 8 > this.information.getSize()) { + return false; + } + let eightBitValue = this.extractNumericValueFromBitArray(pos, 8); + return eightBitValue >= 232 && eightBitValue < 253; + } + decodeIsoIec646(pos) { + let fiveBitValue = this.extractNumericValueFromBitArray(pos, 5); + if (fiveBitValue === 15) { + return new DecodedChar(pos + 5, DecodedChar.FNC1); + } + if (fiveBitValue >= 5 && fiveBitValue < 15) { + return new DecodedChar(pos + 5, ('0' + (fiveBitValue - 5))); + } + let sevenBitValue = this.extractNumericValueFromBitArray(pos, 7); + if (sevenBitValue >= 64 && sevenBitValue < 90) { + return new DecodedChar(pos + 7, ('' + (sevenBitValue + 1))); + } + if (sevenBitValue >= 90 && sevenBitValue < 116) { + return new DecodedChar(pos + 7, ('' + (sevenBitValue + 7))); + } + let eightBitValue = this.extractNumericValueFromBitArray(pos, 8); + let c; + switch (eightBitValue) { + case 232: + c = '!'; + break; + case 233: + c = '"'; + break; + case 234: + c = '%'; + break; + case 235: + c = '&'; + break; + case 236: + c = '\''; + break; + case 237: + c = '('; + break; + case 238: + c = ')'; + break; + case 239: + c = '*'; + break; + case 240: + c = '+'; + break; + case 241: + c = ','; + break; + case 242: + c = '-'; + break; + case 243: + c = '.'; + break; + case 244: + c = '/'; + break; + case 245: + c = ':'; + break; + case 246: + c = ';'; + break; + case 247: + c = '<'; + break; + case 248: + c = '='; + break; + case 249: + c = '>'; + break; + case 250: + c = '?'; + break; + case 251: + c = '_'; + break; + case 252: + c = ' '; + break; + default: + throw new FormatException(); + } + return new DecodedChar(pos + 8, c); + } + isStillAlpha(pos) { + if (pos + 5 > this.information.getSize()) { + return false; + } + // We now check if it's a valid 5-bit value (0..9 and FNC1) + let fiveBitValue = this.extractNumericValueFromBitArray(pos, 5); + if (fiveBitValue >= 5 && fiveBitValue < 16) { + return true; + } + if (pos + 6 > this.information.getSize()) { + return false; + } + let sixBitValue = this.extractNumericValueFromBitArray(pos, 6); + return sixBitValue >= 16 && sixBitValue < 63; // 63 not included + } + decodeAlphanumeric(pos) { + let fiveBitValue = this.extractNumericValueFromBitArray(pos, 5); + if (fiveBitValue === 15) { + return new DecodedChar(pos + 5, DecodedChar.FNC1); + } + if (fiveBitValue >= 5 && fiveBitValue < 15) { + return new DecodedChar(pos + 5, ('0' + (fiveBitValue - 5))); + } + let sixBitValue = this.extractNumericValueFromBitArray(pos, 6); + if (sixBitValue >= 32 && sixBitValue < 58) { + return new DecodedChar(pos + 6, ('' + (sixBitValue + 33))); + } + let c; + switch (sixBitValue) { + case 58: + c = '*'; + break; + case 59: + c = ','; + break; + case 60: + c = '-'; + break; + case 61: + c = '.'; + break; + case 62: + c = '/'; + break; + default: + throw new IllegalStateException('Decoding invalid alphanumeric value: ' + sixBitValue); + } + return new DecodedChar(pos + 6, c); + } + isAlphaTo646ToAlphaLatch(pos) { + if (pos + 1 > this.information.getSize()) { + return false; + } + for (let i = 0; i < 5 && i + pos < this.information.getSize(); ++i) { + if (i === 2) { + if (!this.information.get(pos + 2)) { + return false; + } + } + else if (this.information.get(pos + i)) { + return false; + } + } + return true; + } + isAlphaOr646ToNumericLatch(pos) { + // Next is alphanumeric if there are 3 positions and they are all zeros + if (pos + 3 > this.information.getSize()) { + return false; + } + for (let i = pos; i < pos + 3; ++i) { + if (this.information.get(i)) { + return false; + } + } + return true; + } + isNumericToAlphaNumericLatch(pos) { + // Next is alphanumeric if there are 4 positions and they are all zeros, or + // if there is a subset of this just before the end of the symbol + if (pos + 1 > this.information.getSize()) { + return false; + } + for (let i = 0; i < 4 && i + pos < this.information.getSize(); ++i) { + if (this.information.get(pos + i)) { + return false; + } + } + return true; + } + } + + class AbstractExpandedDecoder { + constructor(information) { + this.information = information; + this.generalDecoder = new GeneralAppIdDecoder(information); + } + getInformation() { + return this.information; + } + getGeneralDecoder() { + return this.generalDecoder; + } + } + + class AI01decoder extends AbstractExpandedDecoder { + constructor(information) { + super(information); + } + encodeCompressedGtin(buf, currentPos) { + buf.append('(01)'); + let initialPosition = buf.length(); + buf.append('9'); + this.encodeCompressedGtinWithoutAI(buf, currentPos, initialPosition); + } + encodeCompressedGtinWithoutAI(buf, currentPos, initialBufferPosition) { + for (let i = 0; i < 4; ++i) { + let currentBlock = this.getGeneralDecoder().extractNumericValueFromBitArray(currentPos + 10 * i, 10); + if (currentBlock / 100 === 0) { + buf.append('0'); + } + if (currentBlock / 10 === 0) { + buf.append('0'); + } + buf.append(currentBlock); + } + AI01decoder.appendCheckDigit(buf, initialBufferPosition); + } + static appendCheckDigit(buf, currentPos) { + let checkDigit = 0; + for (let i = 0; i < 13; i++) { + // let digit = buf.charAt(i + currentPos) - '0'; + // To be checked + let digit = buf.charAt(i + currentPos).charCodeAt(0) - '0'.charCodeAt(0); + checkDigit += (i & 0x01) === 0 ? 3 * digit : digit; + } + checkDigit = 10 - (checkDigit % 10); + if (checkDigit === 10) { + checkDigit = 0; + } + buf.append(checkDigit); + } + } + AI01decoder.GTIN_SIZE = 40; + + class AI01AndOtherAIs extends AI01decoder { + // the second one is the encodation method, and the other two are for the variable length + constructor(information) { + super(information); + } + parseInformation() { + let buff = new StringBuilder(); + buff.append('(01)'); + let initialGtinPosition = buff.length(); + let firstGtinDigit = this.getGeneralDecoder().extractNumericValueFromBitArray(AI01AndOtherAIs.HEADER_SIZE, 4); + buff.append(firstGtinDigit); + this.encodeCompressedGtinWithoutAI(buff, AI01AndOtherAIs.HEADER_SIZE + 4, initialGtinPosition); + return this.getGeneralDecoder().decodeAllCodes(buff, AI01AndOtherAIs.HEADER_SIZE + 44); + } + } + AI01AndOtherAIs.HEADER_SIZE = 1 + 1 + 2; // first bit encodes the linkage flag, + + class AnyAIDecoder extends AbstractExpandedDecoder { + constructor(information) { + super(information); + } + parseInformation() { + let buf = new StringBuilder(); + return this.getGeneralDecoder().decodeAllCodes(buf, AnyAIDecoder.HEADER_SIZE); + } + } + AnyAIDecoder.HEADER_SIZE = 2 + 1 + 2; + + class AI01weightDecoder extends AI01decoder { + constructor(information) { + super(information); + } + encodeCompressedWeight(buf, currentPos, weightSize) { + let originalWeightNumeric = this.getGeneralDecoder().extractNumericValueFromBitArray(currentPos, weightSize); + this.addWeightCode(buf, originalWeightNumeric); + let weightNumeric = this.checkWeight(originalWeightNumeric); + let currentDivisor = 100000; + for (let i = 0; i < 5; ++i) { + if (weightNumeric / currentDivisor === 0) { + buf.append('0'); + } + currentDivisor /= 10; + } + buf.append(weightNumeric); + } + } + + class AI013x0xDecoder extends AI01weightDecoder { + constructor(information) { + super(information); + } + parseInformation() { + if (this.getInformation().getSize() != AI013x0xDecoder.HEADER_SIZE + AI01weightDecoder.GTIN_SIZE + AI013x0xDecoder.WEIGHT_SIZE) { + throw new NotFoundException(); + } + let buf = new StringBuilder(); + this.encodeCompressedGtin(buf, AI013x0xDecoder.HEADER_SIZE); + this.encodeCompressedWeight(buf, AI013x0xDecoder.HEADER_SIZE + AI01weightDecoder.GTIN_SIZE, AI013x0xDecoder.WEIGHT_SIZE); + return buf.toString(); + } + } + AI013x0xDecoder.HEADER_SIZE = 4 + 1; + AI013x0xDecoder.WEIGHT_SIZE = 15; + + class AI013103decoder extends AI013x0xDecoder { + constructor(information) { + super(information); + } + addWeightCode(buf, weight) { + buf.append('(3103)'); + } + checkWeight(weight) { + return weight; + } + } + + class AI01320xDecoder extends AI013x0xDecoder { + constructor(information) { + super(information); + } + addWeightCode(buf, weight) { + if (weight < 10000) { + buf.append('(3202)'); + } + else { + buf.append('(3203)'); + } + } + checkWeight(weight) { + if (weight < 10000) { + return weight; + } + return weight - 10000; + } + } + + class AI01392xDecoder extends AI01decoder { + constructor(information) { + super(information); + } + parseInformation() { + if (this.getInformation().getSize() < AI01392xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE) { + throw new NotFoundException(); + } + let buf = new StringBuilder(); + this.encodeCompressedGtin(buf, AI01392xDecoder.HEADER_SIZE); + let lastAIdigit = this.getGeneralDecoder().extractNumericValueFromBitArray(AI01392xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE, AI01392xDecoder.LAST_DIGIT_SIZE); + buf.append('(392'); + buf.append(lastAIdigit); + buf.append(')'); + let decodedInformation = this.getGeneralDecoder().decodeGeneralPurposeField(AI01392xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE + AI01392xDecoder.LAST_DIGIT_SIZE, null); + buf.append(decodedInformation.getNewString()); + return buf.toString(); + } + } + AI01392xDecoder.HEADER_SIZE = 5 + 1 + 2; + AI01392xDecoder.LAST_DIGIT_SIZE = 2; + + class AI01393xDecoder extends AI01decoder { + constructor(information) { + super(information); + } + parseInformation() { + if (this.getInformation().getSize() < AI01393xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE) { + throw new NotFoundException(); + } + let buf = new StringBuilder(); + this.encodeCompressedGtin(buf, AI01393xDecoder.HEADER_SIZE); + let lastAIdigit = this.getGeneralDecoder().extractNumericValueFromBitArray(AI01393xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE, AI01393xDecoder.LAST_DIGIT_SIZE); + buf.append('(393'); + buf.append(lastAIdigit); + buf.append(')'); + let firstThreeDigits = this.getGeneralDecoder().extractNumericValueFromBitArray(AI01393xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE + AI01393xDecoder.LAST_DIGIT_SIZE, AI01393xDecoder.FIRST_THREE_DIGITS_SIZE); + if (firstThreeDigits / 100 == 0) { + buf.append('0'); + } + if (firstThreeDigits / 10 == 0) { + buf.append('0'); + } + buf.append(firstThreeDigits); + let generalInformation = this.getGeneralDecoder().decodeGeneralPurposeField(AI01393xDecoder.HEADER_SIZE + AI01decoder.GTIN_SIZE + AI01393xDecoder.LAST_DIGIT_SIZE + AI01393xDecoder.FIRST_THREE_DIGITS_SIZE, null); + buf.append(generalInformation.getNewString()); + return buf.toString(); + } + } + AI01393xDecoder.HEADER_SIZE = 5 + 1 + 2; + AI01393xDecoder.LAST_DIGIT_SIZE = 2; + AI01393xDecoder.FIRST_THREE_DIGITS_SIZE = 10; + + class AI013x0x1xDecoder extends AI01weightDecoder { + constructor(information, firstAIdigits, dateCode) { + super(information); + this.dateCode = dateCode; + this.firstAIdigits = firstAIdigits; + } + parseInformation() { + if (this.getInformation().getSize() != AI013x0x1xDecoder.HEADER_SIZE + AI013x0x1xDecoder.GTIN_SIZE + AI013x0x1xDecoder.WEIGHT_SIZE + AI013x0x1xDecoder.DATE_SIZE) { + throw new NotFoundException(); + } + let buf = new StringBuilder(); + this.encodeCompressedGtin(buf, AI013x0x1xDecoder.HEADER_SIZE); + this.encodeCompressedWeight(buf, AI013x0x1xDecoder.HEADER_SIZE + AI013x0x1xDecoder.GTIN_SIZE, AI013x0x1xDecoder.WEIGHT_SIZE); + this.encodeCompressedDate(buf, AI013x0x1xDecoder.HEADER_SIZE + AI013x0x1xDecoder.GTIN_SIZE + AI013x0x1xDecoder.WEIGHT_SIZE); + return buf.toString(); + } + encodeCompressedDate(buf, currentPos) { + let numericDate = this.getGeneralDecoder().extractNumericValueFromBitArray(currentPos, AI013x0x1xDecoder.DATE_SIZE); + if (numericDate == 38400) { + return; + } + buf.append('('); + buf.append(this.dateCode); + buf.append(')'); + let day = numericDate % 32; + numericDate /= 32; + let month = numericDate % 12 + 1; + numericDate /= 12; + let year = numericDate; + if (year / 10 == 0) { + buf.append('0'); + } + buf.append(year); + if (month / 10 == 0) { + buf.append('0'); + } + buf.append(month); + if (day / 10 == 0) { + buf.append('0'); + } + buf.append(day); + } + addWeightCode(buf, weight) { + buf.append('('); + buf.append(this.firstAIdigits); + buf.append(weight / 100000); + buf.append(')'); + } + checkWeight(weight) { + return weight % 100000; + } + } + AI013x0x1xDecoder.HEADER_SIZE = 7 + 1; + AI013x0x1xDecoder.WEIGHT_SIZE = 20; + AI013x0x1xDecoder.DATE_SIZE = 16; + + function createDecoder(information) { + try { + if (information.get(1)) { + return new AI01AndOtherAIs(information); + } + if (!information.get(2)) { + return new AnyAIDecoder(information); + } + let fourBitEncodationMethod = GeneralAppIdDecoder.extractNumericValueFromBitArray(information, 1, 4); + switch (fourBitEncodationMethod) { + case 4: return new AI013103decoder(information); + case 5: return new AI01320xDecoder(information); + } + let fiveBitEncodationMethod = GeneralAppIdDecoder.extractNumericValueFromBitArray(information, 1, 5); + switch (fiveBitEncodationMethod) { + case 12: return new AI01392xDecoder(information); + case 13: return new AI01393xDecoder(information); + } + let sevenBitEncodationMethod = GeneralAppIdDecoder.extractNumericValueFromBitArray(information, 1, 7); + switch (sevenBitEncodationMethod) { + case 56: return new AI013x0x1xDecoder(information, '310', '11'); + case 57: return new AI013x0x1xDecoder(information, '320', '11'); + case 58: return new AI013x0x1xDecoder(information, '310', '13'); + case 59: return new AI013x0x1xDecoder(information, '320', '13'); + case 60: return new AI013x0x1xDecoder(information, '310', '15'); + case 61: return new AI013x0x1xDecoder(information, '320', '15'); + case 62: return new AI013x0x1xDecoder(information, '310', '17'); + case 63: return new AI013x0x1xDecoder(information, '320', '17'); + } + } + catch (e) { + console.log(e); + throw new IllegalStateException('unknown decoder: ' + information); + } + } + + class ExpandedPair { + constructor(leftChar, rightChar, finderPatter, mayBeLast) { + this.leftchar = leftChar; + this.rightchar = rightChar; + this.finderpattern = finderPatter; + this.maybeLast = mayBeLast; + } + mayBeLast() { + return this.maybeLast; + } + getLeftChar() { + return this.leftchar; + } + getRightChar() { + return this.rightchar; + } + getFinderPattern() { + return this.finderpattern; + } + mustBeLast() { + return this.rightchar == null; + } + toString() { + return '[ ' + this.leftchar + ', ' + this.rightchar + ' : ' + (this.finderpattern == null ? 'null' : this.finderpattern.getValue()) + ' ]'; + } + static equals(o1, o2) { + if (!(o1 instanceof ExpandedPair)) { + return false; + } + return ExpandedPair.equalsOrNull(o1.leftchar, o2.leftchar) && + ExpandedPair.equalsOrNull(o1.rightchar, o2.rightchar) && + ExpandedPair.equalsOrNull(o1.finderpattern, o2.finderpattern); + } + static equalsOrNull(o1, o2) { + return o1 === null ? o2 === null : ExpandedPair.equals(o1, o2); + } + hashCode() { + // return ExpandedPair.hashNotNull(leftChar) ^ hashNotNull(rightChar) ^ hashNotNull(finderPattern); + let value = this.leftchar.getValue() ^ this.rightchar.getValue() ^ this.finderpattern.getValue(); + return value; + } + } + + class ExpandedRow { + constructor(pairs, rowNumber, wasReversed) { + this.pairs = pairs; + this.rowNumber = rowNumber; + this.wasReversed = wasReversed; + } + getPairs() { + return this.pairs; + } + getRowNumber() { + return this.rowNumber; + } + isReversed() { + return this.wasReversed; + } + // check implementation + isEquivalent(otherPairs) { + return this.checkEqualitity(this, otherPairs); + } + // @Override + toString() { + return '{ ' + this.pairs + ' }'; + } + /** + * Two rows are equal if they contain the same pairs in the same order. + */ + // @Override + // check implementation + equals(o1, o2) { + if (!(o1 instanceof ExpandedRow)) { + return false; + } + return this.checkEqualitity(o1, o2) && o1.wasReversed === o2.wasReversed; + } + checkEqualitity(pair1, pair2) { + if (!pair1 || !pair2) + return; + let result; + pair1.forEach((e1, i) => { + pair2.forEach(e2 => { + if (e1.getLeftChar().getValue() === e2.getLeftChar().getValue() && e1.getRightChar().getValue() === e2.getRightChar().getValue() && e1.getFinderPatter().getValue() === e2.getFinderPatter().getValue()) { + result = true; + } + }); + }); + return result; + } + } + + // import java.util.ArrayList; + // import java.util.Iterator; + // import java.util.List; + // import java.util.Map; + // import java.util.Collections; + /** @experimental */ + class RSSExpandedReader extends AbstractRSSReader { + constructor() { + super(...arguments); + this.pairs = new Array(RSSExpandedReader.MAX_PAIRS); + this.rows = new Array(); + this.startEnd = [2]; + } + decodeRow(rowNumber, row, hints) { + // Rows can start with even pattern in case in prev rows there where odd number of patters. + // So lets try twice + // this.pairs.clear(); + this.pairs.length = 0; + this.startFromEven = false; + try { + return RSSExpandedReader.constructResult(this.decodeRow2pairs(rowNumber, row)); + } + catch (e) { + // OK + // console.log(e); + } + this.pairs.length = 0; + this.startFromEven = true; + return RSSExpandedReader.constructResult(this.decodeRow2pairs(rowNumber, row)); + } + reset() { + this.pairs.length = 0; + this.rows.length = 0; + } + // Not private for testing + decodeRow2pairs(rowNumber, row) { + let done = false; + while (!done) { + try { + this.pairs.push(this.retrieveNextPair(row, this.pairs, rowNumber)); + } + catch (error) { + if (error instanceof NotFoundException) { + if (!this.pairs.length) { + throw new NotFoundException(); + } + // exit this loop when retrieveNextPair() fails and throws + done = true; + } + } + } + // TODO: verify sequence of finder patterns as in checkPairSequence() + if (this.checkChecksum()) { + return this.pairs; + } + let tryStackedDecode; + if (this.rows.length) { + tryStackedDecode = true; + } + else { + tryStackedDecode = false; + } + // let tryStackedDecode = !this.rows.isEmpty(); + this.storeRow(rowNumber, false); // TODO: deal with reversed rows + if (tryStackedDecode) { + // When the image is 180-rotated, then rows are sorted in wrong direction. + // Try twice with both the directions. + let ps = this.checkRowsBoolean(false); + if (ps != null) { + return ps; + } + ps = this.checkRowsBoolean(true); + if (ps != null) { + return ps; + } + } + throw new NotFoundException(); + } + // Need to Verify + checkRowsBoolean(reverse) { + // Limit number of rows we are checking + // We use recursive algorithm with pure complexity and don't want it to take forever + // Stacked barcode can have up to 11 rows, so 25 seems reasonable enough + if (this.rows.length > 25) { + this.rows.length = 0; // We will never have a chance to get result, so clear it + return null; + } + this.pairs.length = 0; + if (reverse) { + this.rows = this.rows.reverse(); + // Collections.reverse(this.rows); + } + let ps = null; + try { + ps = this.checkRows(new Array(), 0); + } + catch (e) { + // OK + console.log(e); + } + if (reverse) { + this.rows = this.rows.reverse(); + // Collections.reverse(this.rows); + } + return ps; + } + // Try to construct a valid rows sequence + // Recursion is used to implement backtracking + checkRows(collectedRows, currentRow) { + for (let i = currentRow; i < this.rows.length; i++) { + let row = this.rows[i]; + this.pairs.length = 0; + for (let collectedRow of collectedRows) { + this.pairs.push(collectedRow.getPairs()); + } + this.pairs.push(row.getPairs()); + if (!RSSExpandedReader.isValidSequence(this.pairs)) { + continue; + } + if (this.checkChecksum()) { + return this.pairs; + } + let rs = new Array(collectedRows); + rs.push(row); + try { + // Recursion: try to add more rows + return this.checkRows(rs, i + 1); + } + catch (e) { + // We failed, try the next candidate + console.log(e); + } + } + throw new NotFoundException(); + } + // Whether the pairs form a valid find pattern sequence, + // either complete or a prefix + static isValidSequence(pairs) { + for (let sequence of RSSExpandedReader.FINDER_PATTERN_SEQUENCES) { + if (pairs.length > sequence.length) { + continue; + } + let stop = true; + for (let j = 0; j < pairs.length; j++) { + if (pairs[j].getFinderPattern().getValue() != sequence[j]) { + stop = false; + break; + } + } + if (stop) { + return true; + } + } + return false; + } + storeRow(rowNumber, wasReversed) { + // Discard if duplicate above or below; otherwise insert in order by row number. + let insertPos = 0; + let prevIsSame = false; + let nextIsSame = false; + while (insertPos < this.rows.length) { + let erow = this.rows[insertPos]; + if (erow.getRowNumber() > rowNumber) { + nextIsSame = erow.isEquivalent(this.pairs); + break; + } + prevIsSame = erow.isEquivalent(this.pairs); + insertPos++; + } + if (nextIsSame || prevIsSame) { + return; + } + // When the row was partially decoded (e.g. 2 pairs found instead of 3), + // it will prevent us from detecting the barcode. + // Try to merge partial rows + // Check whether the row is part of an allready detected row + if (RSSExpandedReader.isPartialRow(this.pairs, this.rows)) { + return; + } + this.rows.push(insertPos, new ExpandedRow(this.pairs, rowNumber, wasReversed)); + this.removePartialRows(this.pairs, this.rows); + } + // Remove all the rows that contains only specified pairs + removePartialRows(pairs, rows) { + // for (Iterator iterator = rows.iterator(); iterator.hasNext();) { + // ExpandedRow r = iterator.next(); + // if (r.getPairs().size() == pairs.size()) { + // continue; + // } + // boolean allFound = true; + // for (ExpandedPair p : r.getPairs()) { + // boolean found = false; + // for (ExpandedPair pp : pairs) { + // if (p.equals(pp)) { + // found = true; + // break; + // } + // } + // if (!found) { + // allFound = false; + // break; + // } + // } + // if (allFound) { + // // 'pairs' contains all the pairs from the row 'r' + // iterator.remove(); + // } + // } + for (let row of rows) { + if (row.getPairs().length === pairs.length) { + continue; + } + for (let p of row.getPairs()) { + for (let pp of pairs) { + if (ExpandedPair.equals(p, pp)) { + break; + } + } + } + } + } + // Returns true when one of the rows already contains all the pairs + static isPartialRow(pairs, rows) { + for (let r of rows) { + let allFound = true; + for (let p of pairs) { + let found = false; + for (let pp of r.getPairs()) { + if (p.equals(pp)) { + found = true; + break; + } + } + if (!found) { + allFound = false; + break; + } + } + if (allFound) { + // the row 'r' contain all the pairs from 'pairs' + return true; + } + } + return false; + } + // Only used for unit testing + getRows() { + return this.rows; + } + // Not private for unit testing + static constructResult(pairs) { + let binary = BitArrayBuilder.buildBitArray(pairs); + let decoder = createDecoder(binary); + let resultingString = decoder.parseInformation(); + let firstPoints = pairs[0].getFinderPattern().getResultPoints(); + let lastPoints = pairs[pairs.length - 1].getFinderPattern().getResultPoints(); + let points = [firstPoints[0], firstPoints[1], lastPoints[0], lastPoints[1]]; + return new Result(resultingString, null, null, points, BarcodeFormat$1.RSS_EXPANDED, null); + } + checkChecksum() { + let firstPair = this.pairs.get(0); + let checkCharacter = firstPair.getLeftChar(); + let firstCharacter = firstPair.getRightChar(); + if (firstCharacter == null) { + return false; + } + let checksum = firstCharacter.getChecksumPortion(); + let s = 2; + for (let i = 1; i < this.pairs.size(); ++i) { + let currentPair = this.pairs.get(i); + checksum += currentPair.getLeftChar().getChecksumPortion(); + s++; + let currentRightChar = currentPair.getRightChar(); + if (currentRightChar != null) { + checksum += currentRightChar.getChecksumPortion(); + s++; + } + } + checksum %= 211; + let checkCharacterValue = 211 * (s - 4) + checksum; + return checkCharacterValue == checkCharacter.getValue(); + } + static getNextSecondBar(row, initialPos) { + let currentPos; + if (row.get(initialPos)) { + currentPos = row.getNextUnset(initialPos); + currentPos = row.getNextSet(currentPos); + } + else { + currentPos = row.getNextSet(initialPos); + currentPos = row.getNextUnset(currentPos); + } + return currentPos; + } + // not private for testing + retrieveNextPair(row, previousPairs, rowNumber) { + let isOddPattern = previousPairs.length % 2 == 0; + if (this.startFromEven) { + isOddPattern = !isOddPattern; + } + let pattern; + let keepFinding = true; + let forcedOffset = -1; + do { + this.findNextPair(row, previousPairs, forcedOffset); + pattern = this.parseFoundFinderPattern(row, rowNumber, isOddPattern); + if (pattern == null) { + forcedOffset = RSSExpandedReader.getNextSecondBar(row, this.startEnd[0]); + } + else { + keepFinding = false; + } + } while (keepFinding); + // When stacked symbol is split over multiple rows, there's no way to guess if this pair can be last or not. + // boolean mayBeLast = checkPairSequence(previousPairs, pattern); + let leftChar = this.decodeDataCharacter(row, pattern, isOddPattern, true); + if (!this.isEmptyPair(previousPairs) && previousPairs[previousPairs.length - 1].mustBeLast()) { + throw new NotFoundException(); + } + let rightChar; + try { + rightChar = this.decodeDataCharacter(row, pattern, isOddPattern, false); + } + catch (e) { + rightChar = null; + console.log(e); + } + return new ExpandedPair(leftChar, rightChar, pattern, true); + } + isEmptyPair(pairs) { + if (pairs.length === 0) { + return true; + } + return false; + } + findNextPair(row, previousPairs, forcedOffset) { + let counters = this.getDecodeFinderCounters(); + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + let width = row.getSize(); + let rowOffset; + if (forcedOffset >= 0) { + rowOffset = forcedOffset; + } + else if (this.isEmptyPair(previousPairs)) { + rowOffset = 0; + } + else { + let lastPair = previousPairs[previousPairs.length - 1]; + rowOffset = lastPair.getFinderPattern().getStartEnd()[1]; + } + let searchingEvenPair = previousPairs.length % 2 != 0; + if (this.startFromEven) { + searchingEvenPair = !searchingEvenPair; + } + let isWhite = false; + while (rowOffset < width) { + isWhite = !row.get(rowOffset); + if (!isWhite) { + break; + } + rowOffset++; + } + let counterPosition = 0; + let patternStart = rowOffset; + for (let x = rowOffset; x < width; x++) { + if (row.get(x) != isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition == 3) { + if (searchingEvenPair) { + RSSExpandedReader.reverseCounters(counters); + } + if (RSSExpandedReader.isFinderPattern(counters)) { + this.startEnd[0] = patternStart; + this.startEnd[1] = x; + return; + } + if (searchingEvenPair) { + RSSExpandedReader.reverseCounters(counters); + } + patternStart += counters[0] + counters[1]; + counters[0] = counters[2]; + counters[1] = counters[3]; + counters[2] = 0; + counters[3] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + throw new NotFoundException(); + } + static reverseCounters(counters) { + let length = counters.length; + for (let i = 0; i < length / 2; ++i) { + let tmp = counters[i]; + counters[i] = counters[length - i - 1]; + counters[length - i - 1] = tmp; + } + } + parseFoundFinderPattern(row, rowNumber, oddPattern) { + // Actually we found elements 2-5. + let firstCounter; + let start; + let end; + if (oddPattern) { + // If pattern number is odd, we need to locate element 1 *before* the current block. + let firstElementStart = this.startEnd[0] - 1; + // Locate element 1 + while (firstElementStart >= 0 && !row.get(firstElementStart)) { + firstElementStart--; + } + firstElementStart++; + firstCounter = this.startEnd[0] - firstElementStart; + start = firstElementStart; + end = this.startEnd[1]; + } + else { + // If pattern number is even, the pattern is reversed, so we need to locate element 1 *after* the current block. + start = this.startEnd[0]; + end = row.getNextUnset(this.startEnd[1] + 1); + firstCounter = end - this.startEnd[1]; + } + // Make 'counters' hold 1-4 + let counters = this.getDecodeFinderCounters(); + System.arraycopy(counters, 0, counters, 1, counters.length - 1); + counters[0] = firstCounter; + let value; + try { + value = this.parseFinderValue(counters, RSSExpandedReader.FINDER_PATTERNS); + } + catch (e) { + return null; + } + // return new FinderPattern(value, new int[] { start, end }, start, end, rowNumber}); + return new FinderPattern(value, [start, end], start, end, rowNumber); + } + decodeDataCharacter(row, pattern, isOddPattern, leftChar) { + let counters = this.getDataCharacterCounters(); + for (let x = 0; x < counters.length; x++) { + counters[x] = 0; + } + if (leftChar) { + RSSExpandedReader.recordPatternInReverse(row, pattern.getStartEnd()[0], counters); + } + else { + RSSExpandedReader.recordPattern(row, pattern.getStartEnd()[1], counters); + // reverse it + for (let i = 0, j = counters.length - 1; i < j; i++, j--) { + let temp = counters[i]; + counters[i] = counters[j]; + counters[j] = temp; + } + } // counters[] has the pixels of the module + let numModules = 17; // left and right data characters have all the same length + let elementWidth = MathUtils.sum(new Int32Array(counters)) / numModules; + // Sanity check: element width for pattern and the character should match + let expectedElementWidth = (pattern.getStartEnd()[1] - pattern.getStartEnd()[0]) / 15.0; + if (Math.abs(elementWidth - expectedElementWidth) / expectedElementWidth > 0.3) { + throw new NotFoundException(); + } + let oddCounts = this.getOddCounts(); + let evenCounts = this.getEvenCounts(); + let oddRoundingErrors = this.getOddRoundingErrors(); + let evenRoundingErrors = this.getEvenRoundingErrors(); + for (let i = 0; i < counters.length; i++) { + let value = 1.0 * counters[i] / elementWidth; + let count = value + 0.5; // Round + if (count < 1) { + if (value < 0.3) { + throw new NotFoundException(); + } + count = 1; + } + else if (count > 8) { + if (value > 8.7) { + throw new NotFoundException(); + } + count = 8; + } + let offset = i / 2; + if ((i & 0x01) == 0) { + oddCounts[offset] = count; + oddRoundingErrors[offset] = value - count; + } + else { + evenCounts[offset] = count; + evenRoundingErrors[offset] = value - count; + } + } + this.adjustOddEvenCounts(numModules); + let weightRowNumber = 4 * pattern.getValue() + (isOddPattern ? 0 : 2) + (leftChar ? 0 : 1) - 1; + let oddSum = 0; + let oddChecksumPortion = 0; + for (let i = oddCounts.length - 1; i >= 0; i--) { + if (RSSExpandedReader.isNotA1left(pattern, isOddPattern, leftChar)) { + let weight = RSSExpandedReader.WEIGHTS[weightRowNumber][2 * i]; + oddChecksumPortion += oddCounts[i] * weight; + } + oddSum += oddCounts[i]; + } + let evenChecksumPortion = 0; + // int evenSum = 0; + for (let i = evenCounts.length - 1; i >= 0; i--) { + if (RSSExpandedReader.isNotA1left(pattern, isOddPattern, leftChar)) { + let weight = RSSExpandedReader.WEIGHTS[weightRowNumber][2 * i + 1]; + evenChecksumPortion += evenCounts[i] * weight; + } + // evenSum += evenCounts[i]; + } + let checksumPortion = oddChecksumPortion + evenChecksumPortion; + if ((oddSum & 0x01) != 0 || oddSum > 13 || oddSum < 4) { + throw new NotFoundException(); + } + let group = (13 - oddSum) / 2; + let oddWidest = RSSExpandedReader.SYMBOL_WIDEST[group]; + let evenWidest = 9 - oddWidest; + let vOdd = RSSUtils.getRSSvalue(oddCounts, oddWidest, true); + let vEven = RSSUtils.getRSSvalue(evenCounts, evenWidest, false); + let tEven = RSSExpandedReader.EVEN_TOTAL_SUBSET[group]; + let gSum = RSSExpandedReader.GSUM[group]; + let value = vOdd * tEven + vEven + gSum; + return new DataCharacter(value, checksumPortion); + } + static isNotA1left(pattern, isOddPattern, leftChar) { + // A1: pattern.getValue is 0 (A), and it's an oddPattern, and it is a left char + return !(pattern.getValue() == 0 && isOddPattern && leftChar); + } + adjustOddEvenCounts(numModules) { + let oddSum = MathUtils.sum(new Int32Array(this.getOddCounts())); + let evenSum = MathUtils.sum(new Int32Array(this.getEvenCounts())); + let incrementOdd = false; + let decrementOdd = false; + if (oddSum > 13) { + decrementOdd = true; + } + else if (oddSum < 4) { + incrementOdd = true; + } + let incrementEven = false; + let decrementEven = false; + if (evenSum > 13) { + decrementEven = true; + } + else if (evenSum < 4) { + incrementEven = true; + } + let mismatch = oddSum + evenSum - numModules; + let oddParityBad = (oddSum & 0x01) == 1; + let evenParityBad = (evenSum & 0x01) == 0; + if (mismatch == 1) { + if (oddParityBad) { + if (evenParityBad) { + throw new NotFoundException(); + } + decrementOdd = true; + } + else { + if (!evenParityBad) { + throw new NotFoundException(); + } + decrementEven = true; + } + } + else if (mismatch == -1) { + if (oddParityBad) { + if (evenParityBad) { + throw new NotFoundException(); + } + incrementOdd = true; + } + else { + if (!evenParityBad) { + throw new NotFoundException(); + } + incrementEven = true; + } + } + else if (mismatch == 0) { + if (oddParityBad) { + if (!evenParityBad) { + throw new NotFoundException(); + } + // Both bad + if (oddSum < evenSum) { + incrementOdd = true; + decrementEven = true; + } + else { + decrementOdd = true; + incrementEven = true; + } + } + else { + if (evenParityBad) { + throw new NotFoundException(); + } + // Nothing to do! + } + } + else { + throw new NotFoundException(); + } + if (incrementOdd) { + if (decrementOdd) { + throw new NotFoundException(); + } + RSSExpandedReader.increment(this.getOddCounts(), this.getOddRoundingErrors()); + } + if (decrementOdd) { + RSSExpandedReader.decrement(this.getOddCounts(), this.getOddRoundingErrors()); + } + if (incrementEven) { + if (decrementEven) { + throw new NotFoundException(); + } + RSSExpandedReader.increment(this.getEvenCounts(), this.getOddRoundingErrors()); + } + if (decrementEven) { + RSSExpandedReader.decrement(this.getEvenCounts(), this.getEvenRoundingErrors()); + } + } + } + RSSExpandedReader.SYMBOL_WIDEST = [7, 5, 4, 3, 1]; + RSSExpandedReader.EVEN_TOTAL_SUBSET = [4, 20, 52, 104, 204]; + RSSExpandedReader.GSUM = [0, 348, 1388, 2948, 3988]; + RSSExpandedReader.FINDER_PATTERNS = [ + Int32Array.from([1, 8, 4, 1]), + Int32Array.from([3, 6, 4, 1]), + Int32Array.from([3, 4, 6, 1]), + Int32Array.from([3, 2, 8, 1]), + Int32Array.from([2, 6, 5, 1]), + Int32Array.from([2, 2, 9, 1]) // F + ]; + RSSExpandedReader.WEIGHTS = [ + [1, 3, 9, 27, 81, 32, 96, 77], + [20, 60, 180, 118, 143, 7, 21, 63], + [189, 145, 13, 39, 117, 140, 209, 205], + [193, 157, 49, 147, 19, 57, 171, 91], + [62, 186, 136, 197, 169, 85, 44, 132], + [185, 133, 188, 142, 4, 12, 36, 108], + [113, 128, 173, 97, 80, 29, 87, 50], + [150, 28, 84, 41, 123, 158, 52, 156], + [46, 138, 203, 187, 139, 206, 196, 166], + [76, 17, 51, 153, 37, 111, 122, 155], + [43, 129, 176, 106, 107, 110, 119, 146], + [16, 48, 144, 10, 30, 90, 59, 177], + [109, 116, 137, 200, 178, 112, 125, 164], + [70, 210, 208, 202, 184, 130, 179, 115], + [134, 191, 151, 31, 93, 68, 204, 190], + [148, 22, 66, 198, 172, 94, 71, 2], + [6, 18, 54, 162, 64, 192, 154, 40], + [120, 149, 25, 75, 14, 42, 126, 167], + [79, 26, 78, 23, 69, 207, 199, 175], + [103, 98, 83, 38, 114, 131, 182, 124], + [161, 61, 183, 127, 170, 88, 53, 159], + [55, 165, 73, 8, 24, 72, 5, 15], + [45, 135, 194, 160, 58, 174, 100, 89] + ]; + RSSExpandedReader.FINDER_PAT_A = 0; + RSSExpandedReader.FINDER_PAT_B = 1; + RSSExpandedReader.FINDER_PAT_C = 2; + RSSExpandedReader.FINDER_PAT_D = 3; + RSSExpandedReader.FINDER_PAT_E = 4; + RSSExpandedReader.FINDER_PAT_F = 5; + RSSExpandedReader.FINDER_PATTERN_SEQUENCES = [ + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_A], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_B], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_D], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_C], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_F], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_F, RSSExpandedReader.FINDER_PAT_F], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_D], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_E], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_F, RSSExpandedReader.FINDER_PAT_F], + [RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_A, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_B, RSSExpandedReader.FINDER_PAT_C, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_D, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_E, RSSExpandedReader.FINDER_PAT_F, RSSExpandedReader.FINDER_PAT_F], + ]; + RSSExpandedReader.MAX_PAIRS = 11; + + class Pair extends DataCharacter { + constructor(value, checksumPortion, finderPattern) { + super(value, checksumPortion); + this.count = 0; + this.finderPattern = finderPattern; + } + getFinderPattern() { + return this.finderPattern; + } + getCount() { + return this.count; + } + incrementCount() { + this.count++; + } + } + + class RSS14Reader extends AbstractRSSReader { + constructor() { + super(...arguments); + this.possibleLeftPairs = []; + this.possibleRightPairs = []; + } + decodeRow(rowNumber, row, hints) { + const leftPair = this.decodePair(row, false, rowNumber, hints); + RSS14Reader.addOrTally(this.possibleLeftPairs, leftPair); + row.reverse(); + let rightPair = this.decodePair(row, true, rowNumber, hints); + RSS14Reader.addOrTally(this.possibleRightPairs, rightPair); + row.reverse(); + for (let left of this.possibleLeftPairs) { + if (left.getCount() > 1) { + for (let right of this.possibleRightPairs) { + if (right.getCount() > 1 && RSS14Reader.checkChecksum(left, right)) { + return RSS14Reader.constructResult(left, right); + } + } + } + } + throw new NotFoundException(); + } + static addOrTally(possiblePairs, pair) { + if (pair == null) { + return; + } + let found = false; + for (let other of possiblePairs) { + if (other.getValue() === pair.getValue()) { + other.incrementCount(); + found = true; + break; + } + } + if (!found) { + possiblePairs.push(pair); + } + } + reset() { + this.possibleLeftPairs.length = 0; + this.possibleRightPairs.length = 0; + } + static constructResult(leftPair, rightPair) { + let symbolValue = 4537077 * leftPair.getValue() + rightPair.getValue(); + let text = new String(symbolValue).toString(); + let buffer = new StringBuilder(); + for (let i = 13 - text.length; i > 0; i--) { + buffer.append('0'); + } + buffer.append(text); + let checkDigit = 0; + for (let i = 0; i < 13; i++) { + let digit = buffer.charAt(i).charCodeAt(0) - '0'.charCodeAt(0); + checkDigit += ((i & 0x01) === 0) ? 3 * digit : digit; + } + checkDigit = 10 - (checkDigit % 10); + if (checkDigit === 10) { + checkDigit = 0; + } + buffer.append(checkDigit.toString()); + let leftPoints = leftPair.getFinderPattern().getResultPoints(); + let rightPoints = rightPair.getFinderPattern().getResultPoints(); + return new Result(buffer.toString(), null, 0, [leftPoints[0], leftPoints[1], rightPoints[0], rightPoints[1]], BarcodeFormat$1.RSS_14, new Date().getTime()); + } + static checkChecksum(leftPair, rightPair) { + let checkValue = (leftPair.getChecksumPortion() + 16 * rightPair.getChecksumPortion()) % 79; + let targetCheckValue = 9 * leftPair.getFinderPattern().getValue() + rightPair.getFinderPattern().getValue(); + if (targetCheckValue > 72) { + targetCheckValue--; + } + if (targetCheckValue > 8) { + targetCheckValue--; + } + return checkValue === targetCheckValue; + } + decodePair(row, right, rowNumber, hints) { + try { + let startEnd = this.findFinderPattern(row, right); + let pattern = this.parseFoundFinderPattern(row, rowNumber, right, startEnd); + let resultPointCallback = hints == null ? null : hints.get(DecodeHintType$1.NEED_RESULT_POINT_CALLBACK); + if (resultPointCallback != null) { + let center = (startEnd[0] + startEnd[1]) / 2.0; + if (right) { + // row is actually reversed + center = row.getSize() - 1 - center; + } + resultPointCallback.foundPossibleResultPoint(new ResultPoint(center, rowNumber)); + } + let outside = this.decodeDataCharacter(row, pattern, true); + let inside = this.decodeDataCharacter(row, pattern, false); + return new Pair(1597 * outside.getValue() + inside.getValue(), outside.getChecksumPortion() + 4 * inside.getChecksumPortion(), pattern); + } + catch (err) { + return null; + } + } + decodeDataCharacter(row, pattern, outsideChar) { + let counters = this.getDataCharacterCounters(); + for (let x = 0; x < counters.length; x++) { + counters[x] = 0; + } + if (outsideChar) { + OneDReader.recordPatternInReverse(row, pattern.getStartEnd()[0], counters); + } + else { + OneDReader.recordPattern(row, pattern.getStartEnd()[1] + 1, counters); + // reverse it + for (let i = 0, j = counters.length - 1; i < j; i++, j--) { + let temp = counters[i]; + counters[i] = counters[j]; + counters[j] = temp; + } + } + let numModules = outsideChar ? 16 : 15; + let elementWidth = MathUtils.sum(new Int32Array(counters)) / numModules; + let oddCounts = this.getOddCounts(); + let evenCounts = this.getEvenCounts(); + let oddRoundingErrors = this.getOddRoundingErrors(); + let evenRoundingErrors = this.getEvenRoundingErrors(); + for (let i = 0; i < counters.length; i++) { + let value = counters[i] / elementWidth; + let count = Math.floor(value + 0.5); + if (count < 1) { + count = 1; + } + else if (count > 8) { + count = 8; + } + let offset = Math.floor(i / 2); + if ((i & 0x01) === 0) { + oddCounts[offset] = count; + oddRoundingErrors[offset] = value - count; + } + else { + evenCounts[offset] = count; + evenRoundingErrors[offset] = value - count; + } + } + this.adjustOddEvenCounts(outsideChar, numModules); + let oddSum = 0; + let oddChecksumPortion = 0; + for (let i = oddCounts.length - 1; i >= 0; i--) { + oddChecksumPortion *= 9; + oddChecksumPortion += oddCounts[i]; + oddSum += oddCounts[i]; + } + let evenChecksumPortion = 0; + let evenSum = 0; + for (let i = evenCounts.length - 1; i >= 0; i--) { + evenChecksumPortion *= 9; + evenChecksumPortion += evenCounts[i]; + evenSum += evenCounts[i]; + } + let checksumPortion = oddChecksumPortion + 3 * evenChecksumPortion; + if (outsideChar) { + if ((oddSum & 0x01) !== 0 || oddSum > 12 || oddSum < 4) { + throw new NotFoundException(); + } + let group = (12 - oddSum) / 2; + let oddWidest = RSS14Reader.OUTSIDE_ODD_WIDEST[group]; + let evenWidest = 9 - oddWidest; + let vOdd = RSSUtils.getRSSvalue(oddCounts, oddWidest, false); + let vEven = RSSUtils.getRSSvalue(evenCounts, evenWidest, true); + let tEven = RSS14Reader.OUTSIDE_EVEN_TOTAL_SUBSET[group]; + let gSum = RSS14Reader.OUTSIDE_GSUM[group]; + return new DataCharacter(vOdd * tEven + vEven + gSum, checksumPortion); + } + else { + if ((evenSum & 0x01) !== 0 || evenSum > 10 || evenSum < 4) { + throw new NotFoundException(); + } + let group = (10 - evenSum) / 2; + let oddWidest = RSS14Reader.INSIDE_ODD_WIDEST[group]; + let evenWidest = 9 - oddWidest; + let vOdd = RSSUtils.getRSSvalue(oddCounts, oddWidest, true); + let vEven = RSSUtils.getRSSvalue(evenCounts, evenWidest, false); + let tOdd = RSS14Reader.INSIDE_ODD_TOTAL_SUBSET[group]; + let gSum = RSS14Reader.INSIDE_GSUM[group]; + return new DataCharacter(vEven * tOdd + vOdd + gSum, checksumPortion); + } + } + findFinderPattern(row, rightFinderPattern) { + let counters = this.getDecodeFinderCounters(); + counters[0] = 0; + counters[1] = 0; + counters[2] = 0; + counters[3] = 0; + let width = row.getSize(); + let isWhite = false; + let rowOffset = 0; + while (rowOffset < width) { + isWhite = !row.get(rowOffset); + if (rightFinderPattern === isWhite) { + // Will encounter white first when searching for right finder pattern + break; + } + rowOffset++; + } + let counterPosition = 0; + let patternStart = rowOffset; + for (let x = rowOffset; x < width; x++) { + if (row.get(x) !== isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition === 3) { + if (AbstractRSSReader.isFinderPattern(counters)) { + return [patternStart, x]; + } + patternStart += counters[0] + counters[1]; + counters[0] = counters[2]; + counters[1] = counters[3]; + counters[2] = 0; + counters[3] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + throw new NotFoundException(); + } + parseFoundFinderPattern(row, rowNumber, right, startEnd) { + // Actually we found elements 2-5 + let firstIsBlack = row.get(startEnd[0]); + let firstElementStart = startEnd[0] - 1; + // Locate element 1 + while (firstElementStart >= 0 && firstIsBlack !== row.get(firstElementStart)) { + firstElementStart--; + } + firstElementStart++; + const firstCounter = startEnd[0] - firstElementStart; + // Make 'counters' hold 1-4 + const counters = this.getDecodeFinderCounters(); + const copy = new Int32Array(counters.length); + System.arraycopy(counters, 0, copy, 1, counters.length - 1); + copy[0] = firstCounter; + const value = this.parseFinderValue(copy, RSS14Reader.FINDER_PATTERNS); + let start = firstElementStart; + let end = startEnd[1]; + if (right) { + // row is actually reversed + start = row.getSize() - 1 - start; + end = row.getSize() - 1 - end; + } + return new FinderPattern(value, [firstElementStart, startEnd[1]], start, end, rowNumber); + } + adjustOddEvenCounts(outsideChar, numModules) { + let oddSum = MathUtils.sum(new Int32Array(this.getOddCounts())); + let evenSum = MathUtils.sum(new Int32Array(this.getEvenCounts())); + let incrementOdd = false; + let decrementOdd = false; + let incrementEven = false; + let decrementEven = false; + if (outsideChar) { + if (oddSum > 12) { + decrementOdd = true; + } + else if (oddSum < 4) { + incrementOdd = true; + } + if (evenSum > 12) { + decrementEven = true; + } + else if (evenSum < 4) { + incrementEven = true; + } + } + else { + if (oddSum > 11) { + decrementOdd = true; + } + else if (oddSum < 5) { + incrementOdd = true; + } + if (evenSum > 10) { + decrementEven = true; + } + else if (evenSum < 4) { + incrementEven = true; + } + } + let mismatch = oddSum + evenSum - numModules; + let oddParityBad = (oddSum & 0x01) === (outsideChar ? 1 : 0); + let evenParityBad = (evenSum & 0x01) === 1; + if (mismatch === 1) { + if (oddParityBad) { + if (evenParityBad) { + throw new NotFoundException(); + } + decrementOdd = true; + } + else { + if (!evenParityBad) { + throw new NotFoundException(); + } + decrementEven = true; + } + } + else if (mismatch === -1) { + if (oddParityBad) { + if (evenParityBad) { + throw new NotFoundException(); + } + incrementOdd = true; + } + else { + if (!evenParityBad) { + throw new NotFoundException(); + } + incrementEven = true; + } + } + else if (mismatch === 0) { + if (oddParityBad) { + if (!evenParityBad) { + throw new NotFoundException(); + } + // Both bad + if (oddSum < evenSum) { + incrementOdd = true; + decrementEven = true; + } + else { + decrementOdd = true; + incrementEven = true; + } + } + else { + if (evenParityBad) { + throw new NotFoundException(); + } + // Nothing to do! + } + } + else { + throw new NotFoundException(); + } + if (incrementOdd) { + if (decrementOdd) { + throw new NotFoundException(); + } + AbstractRSSReader.increment(this.getOddCounts(), this.getOddRoundingErrors()); + } + if (decrementOdd) { + AbstractRSSReader.decrement(this.getOddCounts(), this.getOddRoundingErrors()); + } + if (incrementEven) { + if (decrementEven) { + throw new NotFoundException(); + } + AbstractRSSReader.increment(this.getEvenCounts(), this.getOddRoundingErrors()); + } + if (decrementEven) { + AbstractRSSReader.decrement(this.getEvenCounts(), this.getEvenRoundingErrors()); + } + } + } + RSS14Reader.OUTSIDE_EVEN_TOTAL_SUBSET = [1, 10, 34, 70, 126]; + RSS14Reader.INSIDE_ODD_TOTAL_SUBSET = [4, 20, 48, 81]; + RSS14Reader.OUTSIDE_GSUM = [0, 161, 961, 2015, 2715]; + RSS14Reader.INSIDE_GSUM = [0, 336, 1036, 1516]; + RSS14Reader.OUTSIDE_ODD_WIDEST = [8, 6, 4, 3, 1]; + RSS14Reader.INSIDE_ODD_WIDEST = [2, 4, 6, 8]; + RSS14Reader.FINDER_PATTERNS = [ + Int32Array.from([3, 8, 2, 1]), + Int32Array.from([3, 5, 5, 1]), + Int32Array.from([3, 3, 7, 1]), + Int32Array.from([3, 1, 9, 1]), + Int32Array.from([2, 7, 4, 1]), + Int32Array.from([2, 5, 6, 1]), + Int32Array.from([2, 3, 8, 1]), + Int32Array.from([1, 5, 7, 1]), + Int32Array.from([1, 3, 9, 1]), + ]; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Daniel Switkin + * @author Sean Owen + */ + class MultiFormatOneDReader extends OneDReader { + constructor(hints) { + super(); + this.readers = []; + const possibleFormats = !hints ? null : hints.get(DecodeHintType$1.POSSIBLE_FORMATS); + const useCode39CheckDigit = hints && hints.get(DecodeHintType$1.ASSUME_CODE_39_CHECK_DIGIT) !== undefined; + if (possibleFormats) { + if (possibleFormats.includes(BarcodeFormat$1.EAN_13) || + possibleFormats.includes(BarcodeFormat$1.UPC_A) || + possibleFormats.includes(BarcodeFormat$1.EAN_8) || + possibleFormats.includes(BarcodeFormat$1.UPC_E)) { + this.readers.push(new MultiFormatUPCEANReader(hints)); + } + if (possibleFormats.includes(BarcodeFormat$1.CODE_39)) { + this.readers.push(new Code39Reader(useCode39CheckDigit)); + } + // if (possibleFormats.includes(BarcodeFormat.CODE_93)) { + // this.readers.push(new Code93Reader()); + // } + if (possibleFormats.includes(BarcodeFormat$1.CODE_128)) { + this.readers.push(new Code128Reader()); + } + if (possibleFormats.includes(BarcodeFormat$1.ITF)) { + this.readers.push(new ITFReader()); + } + // if (possibleFormats.includes(BarcodeFormat.CODABAR)) { + // this.readers.push(new CodaBarReader()); + // } + if (possibleFormats.includes(BarcodeFormat$1.RSS_14)) { + this.readers.push(new RSS14Reader()); + } + if (possibleFormats.includes(BarcodeFormat$1.RSS_EXPANDED)) { + console.warn('RSS Expanded reader IS NOT ready for production yet! use at your own risk.'); + this.readers.push(new RSSExpandedReader()); + } + } + if (this.readers.length === 0) { + this.readers.push(new MultiFormatUPCEANReader(hints)); + this.readers.push(new Code39Reader()); + // this.readers.push(new CodaBarReader()); + // this.readers.push(new Code93Reader()); + this.readers.push(new MultiFormatUPCEANReader(hints)); + this.readers.push(new Code128Reader()); + this.readers.push(new ITFReader()); + this.readers.push(new RSS14Reader()); + // this.readers.push(new RSSExpandedReader()); + } + } + // @Override + decodeRow(rowNumber, row, hints) { + for (let i = 0; i < this.readers.length; i++) { + try { + return this.readers[i].decodeRow(rowNumber, row, hints); + } + catch (re) { + // continue + } + } + throw new NotFoundException(); + } + // @Override + reset() { + this.readers.forEach(reader => reader.reset()); + } + } + + /** + * @deprecated Moving to @zxing/browser + * + * Barcode reader reader to use from browser. + */ + class BrowserBarcodeReader extends BrowserCodeReader { + /** + * Creates an instance of BrowserBarcodeReader. + * @param {number} [timeBetweenScansMillis=500] the time delay between subsequent decode tries + * @param {Map} hints + */ + constructor(timeBetweenScansMillis = 500, hints) { + super(new MultiFormatOneDReader(hints), timeBetweenScansMillis, hints); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates a set of error-correction blocks in one symbol version. Most versions will + * use blocks of differing sizes within one version, so, this encapsulates the parameters for + * each set of blocks. It also holds the number of error-correction codewords per block since it + * will be the same across all blocks within one version.

+ */ + class ECBlocks { + constructor(ecCodewords, ecBlocks1, ecBlocks2) { + this.ecCodewords = ecCodewords; + this.ecBlocks = [ecBlocks1]; + ecBlocks2 && this.ecBlocks.push(ecBlocks2); + } + getECCodewords() { + return this.ecCodewords; + } + getECBlocks() { + return this.ecBlocks; + } + } + /** + *

Encapsulates the parameters for one error-correction block in one symbol version. + * This includes the number of data codewords, and the number of times a block with these + * parameters is used consecutively in the Data Matrix code version's format.

+ */ + class ECB { + constructor(count, dataCodewords) { + this.count = count; + this.dataCodewords = dataCodewords; + } + getCount() { + return this.count; + } + getDataCodewords() { + return this.dataCodewords; + } + } + /** + * The Version object encapsulates attributes about a particular + * size Data Matrix Code. + * + * @author bbrown@google.com (Brian Brown) + */ + class Version { + constructor(versionNumber, symbolSizeRows, symbolSizeColumns, dataRegionSizeRows, dataRegionSizeColumns, ecBlocks) { + this.versionNumber = versionNumber; + this.symbolSizeRows = symbolSizeRows; + this.symbolSizeColumns = symbolSizeColumns; + this.dataRegionSizeRows = dataRegionSizeRows; + this.dataRegionSizeColumns = dataRegionSizeColumns; + this.ecBlocks = ecBlocks; + // Calculate the total number of codewords + let total = 0; + const ecCodewords = ecBlocks.getECCodewords(); + const ecbArray = ecBlocks.getECBlocks(); + for (let ecBlock of ecbArray) { + total += ecBlock.getCount() * (ecBlock.getDataCodewords() + ecCodewords); + } + this.totalCodewords = total; + } + getVersionNumber() { + return this.versionNumber; + } + getSymbolSizeRows() { + return this.symbolSizeRows; + } + getSymbolSizeColumns() { + return this.symbolSizeColumns; + } + getDataRegionSizeRows() { + return this.dataRegionSizeRows; + } + getDataRegionSizeColumns() { + return this.dataRegionSizeColumns; + } + getTotalCodewords() { + return this.totalCodewords; + } + getECBlocks() { + return this.ecBlocks; + } + /** + *

Deduces version information from Data Matrix dimensions.

+ * + * @param numRows Number of rows in modules + * @param numColumns Number of columns in modules + * @return Version for a Data Matrix Code of those dimensions + * @throws FormatException if dimensions do correspond to a valid Data Matrix size + */ + static getVersionForDimensions(numRows, numColumns) { + if ((numRows & 0x01) !== 0 || (numColumns & 0x01) !== 0) { + throw new FormatException(); + } + for (let version of Version.VERSIONS) { + if (version.symbolSizeRows === numRows && version.symbolSizeColumns === numColumns) { + return version; + } + } + throw new FormatException(); + } + // @Override + toString() { + return '' + this.versionNumber; + } + /** + * See ISO 16022:2006 5.5.1 Table 7 + */ + static buildVersions() { + return [ + new Version(1, 10, 10, 8, 8, new ECBlocks(5, new ECB(1, 3))), + new Version(2, 12, 12, 10, 10, new ECBlocks(7, new ECB(1, 5))), + new Version(3, 14, 14, 12, 12, new ECBlocks(10, new ECB(1, 8))), + new Version(4, 16, 16, 14, 14, new ECBlocks(12, new ECB(1, 12))), + new Version(5, 18, 18, 16, 16, new ECBlocks(14, new ECB(1, 18))), + new Version(6, 20, 20, 18, 18, new ECBlocks(18, new ECB(1, 22))), + new Version(7, 22, 22, 20, 20, new ECBlocks(20, new ECB(1, 30))), + new Version(8, 24, 24, 22, 22, new ECBlocks(24, new ECB(1, 36))), + new Version(9, 26, 26, 24, 24, new ECBlocks(28, new ECB(1, 44))), + new Version(10, 32, 32, 14, 14, new ECBlocks(36, new ECB(1, 62))), + new Version(11, 36, 36, 16, 16, new ECBlocks(42, new ECB(1, 86))), + new Version(12, 40, 40, 18, 18, new ECBlocks(48, new ECB(1, 114))), + new Version(13, 44, 44, 20, 20, new ECBlocks(56, new ECB(1, 144))), + new Version(14, 48, 48, 22, 22, new ECBlocks(68, new ECB(1, 174))), + new Version(15, 52, 52, 24, 24, new ECBlocks(42, new ECB(2, 102))), + new Version(16, 64, 64, 14, 14, new ECBlocks(56, new ECB(2, 140))), + new Version(17, 72, 72, 16, 16, new ECBlocks(36, new ECB(4, 92))), + new Version(18, 80, 80, 18, 18, new ECBlocks(48, new ECB(4, 114))), + new Version(19, 88, 88, 20, 20, new ECBlocks(56, new ECB(4, 144))), + new Version(20, 96, 96, 22, 22, new ECBlocks(68, new ECB(4, 174))), + new Version(21, 104, 104, 24, 24, new ECBlocks(56, new ECB(6, 136))), + new Version(22, 120, 120, 18, 18, new ECBlocks(68, new ECB(6, 175))), + new Version(23, 132, 132, 20, 20, new ECBlocks(62, new ECB(8, 163))), + new Version(24, 144, 144, 22, 22, new ECBlocks(62, new ECB(8, 156), new ECB(2, 155))), + new Version(25, 8, 18, 6, 16, new ECBlocks(7, new ECB(1, 5))), + new Version(26, 8, 32, 6, 14, new ECBlocks(11, new ECB(1, 10))), + new Version(27, 12, 26, 10, 24, new ECBlocks(14, new ECB(1, 16))), + new Version(28, 12, 36, 10, 16, new ECBlocks(18, new ECB(1, 22))), + new Version(29, 16, 36, 14, 16, new ECBlocks(24, new ECB(1, 32))), + new Version(30, 16, 48, 14, 22, new ECBlocks(28, new ECB(1, 49))) + ]; + } + } + Version.VERSIONS = Version.buildVersions(); + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author bbrown@google.com (Brian Brown) + */ + class BitMatrixParser { + /** + * @param bitMatrix {@link BitMatrix} to parse + * @throws FormatException if dimension is < 8 or > 144 or not 0 mod 2 + */ + constructor(bitMatrix) { + const dimension = bitMatrix.getHeight(); + if (dimension < 8 || dimension > 144 || (dimension & 0x01) !== 0) { + throw new FormatException(); + } + this.version = BitMatrixParser.readVersion(bitMatrix); + this.mappingBitMatrix = this.extractDataRegion(bitMatrix); + this.readMappingMatrix = new BitMatrix(this.mappingBitMatrix.getWidth(), this.mappingBitMatrix.getHeight()); + } + getVersion() { + return this.version; + } + /** + *

Creates the version object based on the dimension of the original bit matrix from + * the datamatrix code.

+ * + *

See ISO 16022:2006 Table 7 - ECC 200 symbol attributes

+ * + * @param bitMatrix Original {@link BitMatrix} including alignment patterns + * @return {@link Version} encapsulating the Data Matrix Code's "version" + * @throws FormatException if the dimensions of the mapping matrix are not valid + * Data Matrix dimensions. + */ + static readVersion(bitMatrix) { + const numRows = bitMatrix.getHeight(); + const numColumns = bitMatrix.getWidth(); + return Version.getVersionForDimensions(numRows, numColumns); + } + /** + *

Reads the bits in the {@link BitMatrix} representing the mapping matrix (No alignment patterns) + * in the correct order in order to reconstitute the codewords bytes contained within the + * Data Matrix Code.

+ * + * @return bytes encoded within the Data Matrix Code + * @throws FormatException if the exact number of bytes expected is not read + */ + readCodewords() { + const result = new Int8Array(this.version.getTotalCodewords()); + let resultOffset = 0; + let row = 4; + let column = 0; + const numRows = this.mappingBitMatrix.getHeight(); + const numColumns = this.mappingBitMatrix.getWidth(); + let corner1Read = false; + let corner2Read = false; + let corner3Read = false; + let corner4Read = false; + // Read all of the codewords + do { + // Check the four corner cases + if ((row === numRows) && (column === 0) && !corner1Read) { + result[resultOffset++] = this.readCorner1(numRows, numColumns) & 0xff; + row -= 2; + column += 2; + corner1Read = true; + } + else if ((row === numRows - 2) && (column === 0) && ((numColumns & 0x03) !== 0) && !corner2Read) { + result[resultOffset++] = this.readCorner2(numRows, numColumns) & 0xff; + row -= 2; + column += 2; + corner2Read = true; + } + else if ((row === numRows + 4) && (column === 2) && ((numColumns & 0x07) === 0) && !corner3Read) { + result[resultOffset++] = this.readCorner3(numRows, numColumns) & 0xff; + row -= 2; + column += 2; + corner3Read = true; + } + else if ((row === numRows - 2) && (column === 0) && ((numColumns & 0x07) === 4) && !corner4Read) { + result[resultOffset++] = this.readCorner4(numRows, numColumns) & 0xff; + row -= 2; + column += 2; + corner4Read = true; + } + else { + // Sweep upward diagonally to the right + do { + if ((row < numRows) && (column >= 0) && !this.readMappingMatrix.get(column, row)) { + result[resultOffset++] = this.readUtah(row, column, numRows, numColumns) & 0xff; + } + row -= 2; + column += 2; + } while ((row >= 0) && (column < numColumns)); + row += 1; + column += 3; + // Sweep downward diagonally to the left + do { + if ((row >= 0) && (column < numColumns) && !this.readMappingMatrix.get(column, row)) { + result[resultOffset++] = this.readUtah(row, column, numRows, numColumns) & 0xff; + } + row += 2; + column -= 2; + } while ((row < numRows) && (column >= 0)); + row += 3; + column += 1; + } + } while ((row < numRows) || (column < numColumns)); + if (resultOffset !== this.version.getTotalCodewords()) { + throw new FormatException(); + } + return result; + } + /** + *

Reads a bit of the mapping matrix accounting for boundary wrapping.

+ * + * @param row Row to read in the mapping matrix + * @param column Column to read in the mapping matrix + * @param numRows Number of rows in the mapping matrix + * @param numColumns Number of columns in the mapping matrix + * @return value of the given bit in the mapping matrix + */ + readModule(row, column, numRows, numColumns) { + // Adjust the row and column indices based on boundary wrapping + if (row < 0) { + row += numRows; + column += 4 - ((numRows + 4) & 0x07); + } + if (column < 0) { + column += numColumns; + row += 4 - ((numColumns + 4) & 0x07); + } + this.readMappingMatrix.set(column, row); + return this.mappingBitMatrix.get(column, row); + } + /** + *

Reads the 8 bits of the standard Utah-shaped pattern.

+ * + *

See ISO 16022:2006, 5.8.1 Figure 6

+ * + * @param row Current row in the mapping matrix, anchored at the 8th bit (LSB) of the pattern + * @param column Current column in the mapping matrix, anchored at the 8th bit (LSB) of the pattern + * @param numRows Number of rows in the mapping matrix + * @param numColumns Number of columns in the mapping matrix + * @return byte from the utah shape + */ + readUtah(row, column, numRows, numColumns) { + let currentByte = 0; + if (this.readModule(row - 2, column - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row - 2, column - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row - 1, column - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row - 1, column - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row - 1, column, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row, column - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row, column - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(row, column, numRows, numColumns)) { + currentByte |= 1; + } + return currentByte; + } + /** + *

Reads the 8 bits of the special corner condition 1.

+ * + *

See ISO 16022:2006, Figure F.3

+ * + * @param numRows Number of rows in the mapping matrix + * @param numColumns Number of columns in the mapping matrix + * @return byte from the Corner condition 1 + */ + readCorner1(numRows, numColumns) { + let currentByte = 0; + if (this.readModule(numRows - 1, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 1, 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 1, 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(1, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(2, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(3, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + return currentByte; + } + /** + *

Reads the 8 bits of the special corner condition 2.

+ * + *

See ISO 16022:2006, Figure F.4

+ * + * @param numRows Number of rows in the mapping matrix + * @param numColumns Number of columns in the mapping matrix + * @return byte from the Corner condition 2 + */ + readCorner2(numRows, numColumns) { + let currentByte = 0; + if (this.readModule(numRows - 3, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 2, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 1, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 4, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 3, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(1, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + return currentByte; + } + /** + *

Reads the 8 bits of the special corner condition 3.

+ * + *

See ISO 16022:2006, Figure F.5

+ * + * @param numRows Number of rows in the mapping matrix + * @param numColumns Number of columns in the mapping matrix + * @return byte from the Corner condition 3 + */ + readCorner3(numRows, numColumns) { + let currentByte = 0; + if (this.readModule(numRows - 1, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 1, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 3, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(1, numColumns - 3, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(1, numColumns - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(1, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + return currentByte; + } + /** + *

Reads the 8 bits of the special corner condition 4.

+ * + *

See ISO 16022:2006, Figure F.6

+ * + * @param numRows Number of rows in the mapping matrix + * @param numColumns Number of columns in the mapping matrix + * @return byte from the Corner condition 4 + */ + readCorner4(numRows, numColumns) { + let currentByte = 0; + if (this.readModule(numRows - 3, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 2, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(numRows - 1, 0, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 2, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(0, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(1, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(2, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + currentByte <<= 1; + if (this.readModule(3, numColumns - 1, numRows, numColumns)) { + currentByte |= 1; + } + return currentByte; + } + /** + *

Extracts the data region from a {@link BitMatrix} that contains + * alignment patterns.

+ * + * @param bitMatrix Original {@link BitMatrix} with alignment patterns + * @return BitMatrix that has the alignment patterns removed + */ + extractDataRegion(bitMatrix) { + const symbolSizeRows = this.version.getSymbolSizeRows(); + const symbolSizeColumns = this.version.getSymbolSizeColumns(); + if (bitMatrix.getHeight() !== symbolSizeRows) { + throw new IllegalArgumentException('Dimension of bitMatrix must match the version size'); + } + const dataRegionSizeRows = this.version.getDataRegionSizeRows(); + const dataRegionSizeColumns = this.version.getDataRegionSizeColumns(); + const numDataRegionsRow = symbolSizeRows / dataRegionSizeRows | 0; + const numDataRegionsColumn = symbolSizeColumns / dataRegionSizeColumns | 0; + const sizeDataRegionRow = numDataRegionsRow * dataRegionSizeRows; + const sizeDataRegionColumn = numDataRegionsColumn * dataRegionSizeColumns; + const bitMatrixWithoutAlignment = new BitMatrix(sizeDataRegionColumn, sizeDataRegionRow); + for (let dataRegionRow = 0; dataRegionRow < numDataRegionsRow; ++dataRegionRow) { + const dataRegionRowOffset = dataRegionRow * dataRegionSizeRows; + for (let dataRegionColumn = 0; dataRegionColumn < numDataRegionsColumn; ++dataRegionColumn) { + const dataRegionColumnOffset = dataRegionColumn * dataRegionSizeColumns; + for (let i = 0; i < dataRegionSizeRows; ++i) { + const readRowOffset = dataRegionRow * (dataRegionSizeRows + 2) + 1 + i; + const writeRowOffset = dataRegionRowOffset + i; + for (let j = 0; j < dataRegionSizeColumns; ++j) { + const readColumnOffset = dataRegionColumn * (dataRegionSizeColumns + 2) + 1 + j; + if (bitMatrix.get(readColumnOffset, readRowOffset)) { + const writeColumnOffset = dataRegionColumnOffset + j; + bitMatrixWithoutAlignment.set(writeColumnOffset, writeRowOffset); + } + } + } + } + } + return bitMatrixWithoutAlignment; + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates a block of data within a Data Matrix Code. Data Matrix Codes may split their data into + * multiple blocks, each of which is a unit of data and error-correction codewords. Each + * is represented by an instance of this class.

+ * + * @author bbrown@google.com (Brian Brown) + */ + class DataBlock { + constructor(numDataCodewords, codewords) { + this.numDataCodewords = numDataCodewords; + this.codewords = codewords; + } + /** + *

When Data Matrix Codes use multiple data blocks, they actually interleave the bytes of each of them. + * That is, the first byte of data block 1 to n is written, then the second bytes, and so on. This + * method will separate the data into original blocks.

+ * + * @param rawCodewords bytes as read directly from the Data Matrix Code + * @param version version of the Data Matrix Code + * @return DataBlocks containing original bytes, "de-interleaved" from representation in the + * Data Matrix Code + */ + static getDataBlocks(rawCodewords, version) { + // Figure out the number and size of data blocks used by this version + const ecBlocks = version.getECBlocks(); + // First count the total number of data blocks + let totalBlocks = 0; + const ecBlockArray = ecBlocks.getECBlocks(); + for (let ecBlock of ecBlockArray) { + totalBlocks += ecBlock.getCount(); + } + // Now establish DataBlocks of the appropriate size and number of data codewords + const result = new Array(totalBlocks); + let numResultBlocks = 0; + for (let ecBlock of ecBlockArray) { + for (let i = 0; i < ecBlock.getCount(); i++) { + const numDataCodewords = ecBlock.getDataCodewords(); + const numBlockCodewords = ecBlocks.getECCodewords() + numDataCodewords; + result[numResultBlocks++] = new DataBlock(numDataCodewords, new Uint8Array(numBlockCodewords)); + } + } + // All blocks have the same amount of data, except that the last n + // (where n may be 0) have 1 less byte. Figure out where these start. + // TODO(bbrown): There is only one case where there is a difference for Data Matrix for size 144 + const longerBlocksTotalCodewords = result[0].codewords.length; + // int shorterBlocksTotalCodewords = longerBlocksTotalCodewords - 1; + const longerBlocksNumDataCodewords = longerBlocksTotalCodewords - ecBlocks.getECCodewords(); + const shorterBlocksNumDataCodewords = longerBlocksNumDataCodewords - 1; + // The last elements of result may be 1 element shorter for 144 matrix + // first fill out as many elements as all of them have minus 1 + let rawCodewordsOffset = 0; + for (let i = 0; i < shorterBlocksNumDataCodewords; i++) { + for (let j = 0; j < numResultBlocks; j++) { + result[j].codewords[i] = rawCodewords[rawCodewordsOffset++]; + } + } + // Fill out the last data block in the longer ones + const specialVersion = version.getVersionNumber() === 24; + const numLongerBlocks = specialVersion ? 8 : numResultBlocks; + for (let j = 0; j < numLongerBlocks; j++) { + result[j].codewords[longerBlocksNumDataCodewords - 1] = rawCodewords[rawCodewordsOffset++]; + } + // Now add in error correction blocks + const max = result[0].codewords.length; + for (let i = longerBlocksNumDataCodewords; i < max; i++) { + for (let j = 0; j < numResultBlocks; j++) { + const jOffset = specialVersion ? (j + 8) % numResultBlocks : j; + const iOffset = specialVersion && jOffset > 7 ? i - 1 : i; + result[jOffset].codewords[iOffset] = rawCodewords[rawCodewordsOffset++]; + } + } + if (rawCodewordsOffset !== rawCodewords.length) { + throw new IllegalArgumentException(); + } + return result; + } + getNumDataCodewords() { + return this.numDataCodewords; + } + getCodewords() { + return this.codewords; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

This provides an easy abstraction to read bits at a time from a sequence of bytes, where the + * number of bits read is not often a multiple of 8.

+ * + *

This class is thread-safe but not reentrant -- unless the caller modifies the bytes array + * it passed in, in which case all bets are off.

+ * + * @author Sean Owen + */ + class BitSource { + /** + * @param bytes bytes from which this will read bits. Bits will be read from the first byte first. + * Bits are read within a byte from most-significant to least-significant bit. + */ + constructor(bytes) { + this.bytes = bytes; + this.byteOffset = 0; + this.bitOffset = 0; + } + /** + * @return index of next bit in current byte which would be read by the next call to {@link #readBits(int)}. + */ + getBitOffset() { + return this.bitOffset; + } + /** + * @return index of next byte in input byte array which would be read by the next call to {@link #readBits(int)}. + */ + getByteOffset() { + return this.byteOffset; + } + /** + * @param numBits number of bits to read + * @return int representing the bits read. The bits will appear as the least-significant + * bits of the int + * @throws IllegalArgumentException if numBits isn't in [1,32] or more than is available + */ + readBits(numBits /*int*/) { + if (numBits < 1 || numBits > 32 || numBits > this.available()) { + throw new IllegalArgumentException('' + numBits); + } + let result = 0; + let bitOffset = this.bitOffset; + let byteOffset = this.byteOffset; + const bytes = this.bytes; + // First, read remainder from current byte + if (bitOffset > 0) { + const bitsLeft = 8 - bitOffset; + const toRead = numBits < bitsLeft ? numBits : bitsLeft; + const bitsToNotRead = bitsLeft - toRead; + const mask = (0xFF >> (8 - toRead)) << bitsToNotRead; + result = (bytes[byteOffset] & mask) >> bitsToNotRead; + numBits -= toRead; + bitOffset += toRead; + if (bitOffset === 8) { + bitOffset = 0; + byteOffset++; + } + } + // Next read whole bytes + if (numBits > 0) { + while (numBits >= 8) { + result = (result << 8) | (bytes[byteOffset] & 0xFF); + byteOffset++; + numBits -= 8; + } + // Finally read a partial byte + if (numBits > 0) { + const bitsToNotRead = 8 - numBits; + const mask = (0xFF >> bitsToNotRead) << bitsToNotRead; + result = (result << numBits) | ((bytes[byteOffset] & mask) >> bitsToNotRead); + bitOffset += numBits; + } + } + this.bitOffset = bitOffset; + this.byteOffset = byteOffset; + return result; + } + /** + * @return number of bits that can be read successfully + */ + available() { + return 8 * (this.bytes.length - this.byteOffset) - this.bitOffset; + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + var Mode; + (function (Mode) { + Mode[Mode["PAD_ENCODE"] = 0] = "PAD_ENCODE"; + Mode[Mode["ASCII_ENCODE"] = 1] = "ASCII_ENCODE"; + Mode[Mode["C40_ENCODE"] = 2] = "C40_ENCODE"; + Mode[Mode["TEXT_ENCODE"] = 3] = "TEXT_ENCODE"; + Mode[Mode["ANSIX12_ENCODE"] = 4] = "ANSIX12_ENCODE"; + Mode[Mode["EDIFACT_ENCODE"] = 5] = "EDIFACT_ENCODE"; + Mode[Mode["BASE256_ENCODE"] = 6] = "BASE256_ENCODE"; + })(Mode || (Mode = {})); + /** + *

Data Matrix Codes can encode text as bits in one of several modes, and can use multiple modes + * in one Data Matrix Code. This class decodes the bits back into text.

+ * + *

See ISO 16022:2006, 5.2.1 - 5.2.9.2

+ * + * @author bbrown@google.com (Brian Brown) + * @author Sean Owen + */ + class DecodedBitStreamParser { + static decode(bytes) { + const bits = new BitSource(bytes); + const result = new StringBuilder(); + const resultTrailer = new StringBuilder(); + const byteSegments = new Array(); + let mode = Mode.ASCII_ENCODE; + do { + if (mode === Mode.ASCII_ENCODE) { + mode = this.decodeAsciiSegment(bits, result, resultTrailer); + } + else { + switch (mode) { + case Mode.C40_ENCODE: + this.decodeC40Segment(bits, result); + break; + case Mode.TEXT_ENCODE: + this.decodeTextSegment(bits, result); + break; + case Mode.ANSIX12_ENCODE: + this.decodeAnsiX12Segment(bits, result); + break; + case Mode.EDIFACT_ENCODE: + this.decodeEdifactSegment(bits, result); + break; + case Mode.BASE256_ENCODE: + this.decodeBase256Segment(bits, result, byteSegments); + break; + default: + throw new FormatException(); + } + mode = Mode.ASCII_ENCODE; + } + } while (mode !== Mode.PAD_ENCODE && bits.available() > 0); + if (resultTrailer.length() > 0) { + result.append(resultTrailer.toString()); + } + return new DecoderResult(bytes, result.toString(), byteSegments.length === 0 ? null : byteSegments, null); + } + /** + * See ISO 16022:2006, 5.2.3 and Annex C, Table C.2 + */ + static decodeAsciiSegment(bits, result, resultTrailer) { + let upperShift = false; + do { + let oneByte = bits.readBits(8); + if (oneByte === 0) { + throw new FormatException(); + } + else if (oneByte <= 128) { // ASCII data (ASCII value + 1) + if (upperShift) { + oneByte += 128; + // upperShift = false; + } + result.append(String.fromCharCode(oneByte - 1)); + return Mode.ASCII_ENCODE; + } + else if (oneByte === 129) { // Pad + return Mode.PAD_ENCODE; + } + else if (oneByte <= 229) { // 2-digit data 00-99 (Numeric Value + 130) + const value = oneByte - 130; + if (value < 10) { // pad with '0' for single digit values + result.append('0'); + } + result.append('' + value); + } + else { + switch (oneByte) { + case 230: // Latch to C40 encodation + return Mode.C40_ENCODE; + case 231: // Latch to Base 256 encodation + return Mode.BASE256_ENCODE; + case 232: // FNC1 + result.append(String.fromCharCode(29)); // translate as ASCII 29 + break; + case 233: // Structured Append + case 234: // Reader Programming + // Ignore these symbols for now + // throw ReaderException.getInstance(); + break; + case 235: // Upper Shift (shift to Extended ASCII) + upperShift = true; + break; + case 236: // 05 Macro + result.append('[)>\u001E05\u001D'); + resultTrailer.insert(0, '\u001E\u0004'); + break; + case 237: // 06 Macro + result.append('[)>\u001E06\u001D'); + resultTrailer.insert(0, '\u001E\u0004'); + break; + case 238: // Latch to ANSI X12 encodation + return Mode.ANSIX12_ENCODE; + case 239: // Latch to Text encodation + return Mode.TEXT_ENCODE; + case 240: // Latch to EDIFACT encodation + return Mode.EDIFACT_ENCODE; + case 241: // ECI Character + // TODO(bbrown): I think we need to support ECI + // throw ReaderException.getInstance(); + // Ignore this symbol for now + break; + default: + // Not to be used in ASCII encodation + // but work around encoders that end with 254, latch back to ASCII + if (oneByte !== 254 || bits.available() !== 0) { + throw new FormatException(); + } + break; + } + } + } while (bits.available() > 0); + return Mode.ASCII_ENCODE; + } + /** + * See ISO 16022:2006, 5.2.5 and Annex C, Table C.1 + */ + static decodeC40Segment(bits, result) { + // Three C40 values are encoded in a 16-bit value as + // (1600 * C1) + (40 * C2) + C3 + 1 + // TODO(bbrown): The Upper Shift with C40 doesn't work in the 4 value scenario all the time + let upperShift = false; + const cValues = []; + let shift = 0; + do { + // If there is only one byte left then it will be encoded as ASCII + if (bits.available() === 8) { + return; + } + const firstByte = bits.readBits(8); + if (firstByte === 254) { // Unlatch codeword + return; + } + this.parseTwoBytes(firstByte, bits.readBits(8), cValues); + for (let i = 0; i < 3; i++) { + const cValue = cValues[i]; + switch (shift) { + case 0: + if (cValue < 3) { + shift = cValue + 1; + } + else if (cValue < this.C40_BASIC_SET_CHARS.length) { + const c40char = this.C40_BASIC_SET_CHARS[cValue]; + if (upperShift) { + result.append(String.fromCharCode(c40char.charCodeAt(0) + 128)); + upperShift = false; + } + else { + result.append(c40char); + } + } + else { + throw new FormatException(); + } + break; + case 1: + if (upperShift) { + result.append(String.fromCharCode(cValue + 128)); + upperShift = false; + } + else { + result.append(String.fromCharCode(cValue)); + } + shift = 0; + break; + case 2: + if (cValue < this.C40_SHIFT2_SET_CHARS.length) { + const c40char = this.C40_SHIFT2_SET_CHARS[cValue]; + if (upperShift) { + result.append(String.fromCharCode(c40char.charCodeAt(0) + 128)); + upperShift = false; + } + else { + result.append(c40char); + } + } + else { + switch (cValue) { + case 27: // FNC1 + result.append(String.fromCharCode(29)); // translate as ASCII 29 + break; + case 30: // Upper Shift + upperShift = true; + break; + default: + throw new FormatException(); + } + } + shift = 0; + break; + case 3: + if (upperShift) { + result.append(String.fromCharCode(cValue + 224)); + upperShift = false; + } + else { + result.append(String.fromCharCode(cValue + 96)); + } + shift = 0; + break; + default: + throw new FormatException(); + } + } + } while (bits.available() > 0); + } + /** + * See ISO 16022:2006, 5.2.6 and Annex C, Table C.2 + */ + static decodeTextSegment(bits, result) { + // Three Text values are encoded in a 16-bit value as + // (1600 * C1) + (40 * C2) + C3 + 1 + // TODO(bbrown): The Upper Shift with Text doesn't work in the 4 value scenario all the time + let upperShift = false; + let cValues = []; + let shift = 0; + do { + // If there is only one byte left then it will be encoded as ASCII + if (bits.available() === 8) { + return; + } + const firstByte = bits.readBits(8); + if (firstByte === 254) { // Unlatch codeword + return; + } + this.parseTwoBytes(firstByte, bits.readBits(8), cValues); + for (let i = 0; i < 3; i++) { + const cValue = cValues[i]; + switch (shift) { + case 0: + if (cValue < 3) { + shift = cValue + 1; + } + else if (cValue < this.TEXT_BASIC_SET_CHARS.length) { + const textChar = this.TEXT_BASIC_SET_CHARS[cValue]; + if (upperShift) { + result.append(String.fromCharCode(textChar.charCodeAt(0) + 128)); + upperShift = false; + } + else { + result.append(textChar); + } + } + else { + throw new FormatException(); + } + break; + case 1: + if (upperShift) { + result.append(String.fromCharCode(cValue + 128)); + upperShift = false; + } + else { + result.append(String.fromCharCode(cValue)); + } + shift = 0; + break; + case 2: + // Shift 2 for Text is the same encoding as C40 + if (cValue < this.TEXT_SHIFT2_SET_CHARS.length) { + const textChar = this.TEXT_SHIFT2_SET_CHARS[cValue]; + if (upperShift) { + result.append(String.fromCharCode(textChar.charCodeAt(0) + 128)); + upperShift = false; + } + else { + result.append(textChar); + } + } + else { + switch (cValue) { + case 27: // FNC1 + result.append(String.fromCharCode(29)); // translate as ASCII 29 + break; + case 30: // Upper Shift + upperShift = true; + break; + default: + throw new FormatException(); + } + } + shift = 0; + break; + case 3: + if (cValue < this.TEXT_SHIFT3_SET_CHARS.length) { + const textChar = this.TEXT_SHIFT3_SET_CHARS[cValue]; + if (upperShift) { + result.append(String.fromCharCode(textChar.charCodeAt(0) + 128)); + upperShift = false; + } + else { + result.append(textChar); + } + shift = 0; + } + else { + throw new FormatException(); + } + break; + default: + throw new FormatException(); + } + } + } while (bits.available() > 0); + } + /** + * See ISO 16022:2006, 5.2.7 + */ + static decodeAnsiX12Segment(bits, result) { + // Three ANSI X12 values are encoded in a 16-bit value as + // (1600 * C1) + (40 * C2) + C3 + 1 + const cValues = []; + do { + // If there is only one byte left then it will be encoded as ASCII + if (bits.available() === 8) { + return; + } + const firstByte = bits.readBits(8); + if (firstByte === 254) { // Unlatch codeword + return; + } + this.parseTwoBytes(firstByte, bits.readBits(8), cValues); + for (let i = 0; i < 3; i++) { + const cValue = cValues[i]; + switch (cValue) { + case 0: // X12 segment terminator + result.append('\r'); + break; + case 1: // X12 segment separator * + result.append('*'); + break; + case 2: // X12 sub-element separator > + result.append('>'); + break; + case 3: // space + result.append(' '); + break; + default: + if (cValue < 14) { // 0 - 9 + result.append(String.fromCharCode(cValue + 44)); + } + else if (cValue < 40) { // A - Z + result.append(String.fromCharCode(cValue + 51)); + } + else { + throw new FormatException(); + } + break; + } + } + } while (bits.available() > 0); + } + static parseTwoBytes(firstByte, secondByte, result) { + let fullBitValue = (firstByte << 8) + secondByte - 1; + let temp = Math.floor(fullBitValue / 1600); + result[0] = temp; + fullBitValue -= temp * 1600; + temp = Math.floor(fullBitValue / 40); + result[1] = temp; + result[2] = fullBitValue - temp * 40; + } + /** + * See ISO 16022:2006, 5.2.8 and Annex C Table C.3 + */ + static decodeEdifactSegment(bits, result) { + do { + // If there is only two or less bytes left then it will be encoded as ASCII + if (bits.available() <= 16) { + return; + } + for (let i = 0; i < 4; i++) { + let edifactValue = bits.readBits(6); + // Check for the unlatch character + if (edifactValue === 0x1F) { // 011111 + // Read rest of byte, which should be 0, and stop + const bitsLeft = 8 - bits.getBitOffset(); + if (bitsLeft !== 8) { + bits.readBits(bitsLeft); + } + return; + } + if ((edifactValue & 0x20) === 0) { // no 1 in the leading (6th) bit + edifactValue |= 0x40; // Add a leading 01 to the 6 bit binary value + } + result.append(String.fromCharCode(edifactValue)); + } + } while (bits.available() > 0); + } + /** + * See ISO 16022:2006, 5.2.9 and Annex B, B.2 + */ + static decodeBase256Segment(bits, result, byteSegments) { + // Figure out how long the Base 256 Segment is. + let codewordPosition = 1 + bits.getByteOffset(); // position is 1-indexed + const d1 = this.unrandomize255State(bits.readBits(8), codewordPosition++); + let count; + if (d1 === 0) { // Read the remainder of the symbol + count = bits.available() / 8 | 0; + } + else if (d1 < 250) { + count = d1; + } + else { + count = 250 * (d1 - 249) + this.unrandomize255State(bits.readBits(8), codewordPosition++); + } + // We're seeing NegativeArraySizeException errors from users. + if (count < 0) { + throw new FormatException(); + } + const bytes = new Uint8Array(count); + for (let i = 0; i < count; i++) { + // Have seen this particular error in the wild, such as at + // http://www.bcgen.com/demo/IDAutomationStreamingDataMatrix.aspx?MODE=3&D=Fred&PFMT=3&PT=F&X=0.3&O=0&LM=0.2 + if (bits.available() < 8) { + throw new FormatException(); + } + bytes[i] = this.unrandomize255State(bits.readBits(8), codewordPosition++); + } + byteSegments.push(bytes); + try { + result.append(StringEncoding.decode(bytes, StringUtils.ISO88591)); + } + catch (uee) { + throw new IllegalStateException('Platform does not support required encoding: ' + uee.message); + } + } + /** + * See ISO 16022:2006, Annex B, B.2 + */ + static unrandomize255State(randomizedBase256Codeword, base256CodewordPosition) { + const pseudoRandomNumber = ((149 * base256CodewordPosition) % 255) + 1; + const tempVariable = randomizedBase256Codeword - pseudoRandomNumber; + return tempVariable >= 0 ? tempVariable : tempVariable + 256; + } + } + /** + * See ISO 16022:2006, Annex C Table C.1 + * The C40 Basic Character Set (*'s used for placeholders for the shift values) + */ + DecodedBitStreamParser.C40_BASIC_SET_CHARS = [ + '*', '*', '*', ' ', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', + 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', + 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' + ]; + DecodedBitStreamParser.C40_SHIFT2_SET_CHARS = [ + '!', '"', '#', '$', '%', '&', '\'', '(', ')', '*', '+', ',', '-', '.', + '/', ':', ';', '<', '=', '>', '?', '@', '[', '\\', ']', '^', '_' + ]; + /** + * See ISO 16022:2006, Annex C Table C.2 + * The Text Basic Character Set (*'s used for placeholders for the shift values) + */ + DecodedBitStreamParser.TEXT_BASIC_SET_CHARS = [ + '*', '*', '*', ' ', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', + 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', + 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z' + ]; + // Shift 2 for Text is the same encoding as C40 + DecodedBitStreamParser.TEXT_SHIFT2_SET_CHARS = DecodedBitStreamParser.C40_SHIFT2_SET_CHARS; + DecodedBitStreamParser.TEXT_SHIFT3_SET_CHARS = [ + '`', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', + 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '{', '|', '}', '~', String.fromCharCode(127) + ]; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

The main class which implements Data Matrix Code decoding -- as opposed to locating and extracting + * the Data Matrix Code from an image.

+ * + * @author bbrown@google.com (Brian Brown) + */ + class Decoder$1 { + constructor() { + this.rsDecoder = new ReedSolomonDecoder(GenericGF.DATA_MATRIX_FIELD_256); + } + /** + *

Decodes a Data Matrix Code represented as a {@link BitMatrix}. A 1 or "true" is taken + * to mean a black module.

+ * + * @param bits booleans representing white/black Data Matrix Code modules + * @return text and bytes encoded within the Data Matrix Code + * @throws FormatException if the Data Matrix Code cannot be decoded + * @throws ChecksumException if error correction fails + */ + decode(bits) { + // Construct a parser and read version, error-correction level + const parser = new BitMatrixParser(bits); + const version = parser.getVersion(); + // Read codewords + const codewords = parser.readCodewords(); + // Separate into data blocks + const dataBlocks = DataBlock.getDataBlocks(codewords, version); + // Count total number of data bytes + let totalBytes = 0; + for (let db of dataBlocks) { + totalBytes += db.getNumDataCodewords(); + } + const resultBytes = new Uint8Array(totalBytes); + const dataBlocksCount = dataBlocks.length; + // Error-correct and copy data blocks together into a stream of bytes + for (let j = 0; j < dataBlocksCount; j++) { + const dataBlock = dataBlocks[j]; + const codewordBytes = dataBlock.getCodewords(); + const numDataCodewords = dataBlock.getNumDataCodewords(); + this.correctErrors(codewordBytes, numDataCodewords); + for (let i = 0; i < numDataCodewords; i++) { + // De-interlace data blocks. + resultBytes[i * dataBlocksCount + j] = codewordBytes[i]; + } + } + // Decode the contents of that stream of bytes + return DecodedBitStreamParser.decode(resultBytes); + } + /** + *

Given data and error-correction codewords received, possibly corrupted by errors, attempts to + * correct the errors in-place using Reed-Solomon error correction.

+ * + * @param codewordBytes data and error correction codewords + * @param numDataCodewords number of codewords that are data bytes + * @throws ChecksumException if error correction fails + */ + correctErrors(codewordBytes, numDataCodewords) { + // const numCodewords = codewordBytes.length; + // First read into an array of ints + const codewordsInts = new Int32Array(codewordBytes); + // for (let i = 0; i < numCodewords; i++) { + // codewordsInts[i] = codewordBytes[i] & 0xFF; + // } + try { + this.rsDecoder.decode(codewordsInts, codewordBytes.length - numDataCodewords); + } + catch (ignored /* ReedSolomonException */) { + throw new ChecksumException(); + } + // Copy back into array of bytes -- only need to worry about the bytes that were data + // We don't care about errors in the error-correction codewords + for (let i = 0; i < numDataCodewords; i++) { + codewordBytes[i] = codewordsInts[i]; + } + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates logic that can detect a Data Matrix Code in an image, even if the Data Matrix Code + * is rotated or skewed, or partially obscured.

+ * + * @author Sean Owen + */ + class Detector$1 { + constructor(image) { + this.image = image; + this.rectangleDetector = new WhiteRectangleDetector(this.image); + } + /** + *

Detects a Data Matrix Code in an image.

+ * + * @return {@link DetectorResult} encapsulating results of detecting a Data Matrix Code + * @throws NotFoundException if no Data Matrix Code can be found + */ + detect() { + const cornerPoints = this.rectangleDetector.detect(); + let points = this.detectSolid1(cornerPoints); + points = this.detectSolid2(points); + points[3] = this.correctTopRight(points); + if (!points[3]) { + throw new NotFoundException(); + } + points = this.shiftToModuleCenter(points); + const topLeft = points[0]; + const bottomLeft = points[1]; + const bottomRight = points[2]; + const topRight = points[3]; + let dimensionTop = this.transitionsBetween(topLeft, topRight) + 1; + let dimensionRight = this.transitionsBetween(bottomRight, topRight) + 1; + if ((dimensionTop & 0x01) === 1) { + dimensionTop += 1; + } + if ((dimensionRight & 0x01) === 1) { + dimensionRight += 1; + } + if (4 * dimensionTop < 7 * dimensionRight && 4 * dimensionRight < 7 * dimensionTop) { + // The matrix is square + dimensionTop = dimensionRight = Math.max(dimensionTop, dimensionRight); + } + let bits = Detector$1.sampleGrid(this.image, topLeft, bottomLeft, bottomRight, topRight, dimensionTop, dimensionRight); + return new DetectorResult(bits, [topLeft, bottomLeft, bottomRight, topRight]); + } + static shiftPoint(point, to, div) { + let x = (to.getX() - point.getX()) / (div + 1); + let y = (to.getY() - point.getY()) / (div + 1); + return new ResultPoint(point.getX() + x, point.getY() + y); + } + static moveAway(point, fromX, fromY) { + let x = point.getX(); + let y = point.getY(); + if (x < fromX) { + x -= 1; + } + else { + x += 1; + } + if (y < fromY) { + y -= 1; + } + else { + y += 1; + } + return new ResultPoint(x, y); + } + /** + * Detect a solid side which has minimum transition. + */ + detectSolid1(cornerPoints) { + // 0 2 + // 1 3 + let pointA = cornerPoints[0]; + let pointB = cornerPoints[1]; + let pointC = cornerPoints[3]; + let pointD = cornerPoints[2]; + let trAB = this.transitionsBetween(pointA, pointB); + let trBC = this.transitionsBetween(pointB, pointC); + let trCD = this.transitionsBetween(pointC, pointD); + let trDA = this.transitionsBetween(pointD, pointA); + // 0..3 + // : : + // 1--2 + let min = trAB; + let points = [pointD, pointA, pointB, pointC]; + if (min > trBC) { + min = trBC; + points[0] = pointA; + points[1] = pointB; + points[2] = pointC; + points[3] = pointD; + } + if (min > trCD) { + min = trCD; + points[0] = pointB; + points[1] = pointC; + points[2] = pointD; + points[3] = pointA; + } + if (min > trDA) { + points[0] = pointC; + points[1] = pointD; + points[2] = pointA; + points[3] = pointB; + } + return points; + } + /** + * Detect a second solid side next to first solid side. + */ + detectSolid2(points) { + // A..D + // : : + // B--C + let pointA = points[0]; + let pointB = points[1]; + let pointC = points[2]; + let pointD = points[3]; + // Transition detection on the edge is not stable. + // To safely detect, shift the points to the module center. + let tr = this.transitionsBetween(pointA, pointD); + let pointBs = Detector$1.shiftPoint(pointB, pointC, (tr + 1) * 4); + let pointCs = Detector$1.shiftPoint(pointC, pointB, (tr + 1) * 4); + let trBA = this.transitionsBetween(pointBs, pointA); + let trCD = this.transitionsBetween(pointCs, pointD); + // 0..3 + // | : + // 1--2 + if (trBA < trCD) { + // solid sides: A-B-C + points[0] = pointA; + points[1] = pointB; + points[2] = pointC; + points[3] = pointD; + } + else { + // solid sides: B-C-D + points[0] = pointB; + points[1] = pointC; + points[2] = pointD; + points[3] = pointA; + } + return points; + } + /** + * Calculates the corner position of the white top right module. + */ + correctTopRight(points) { + // A..D + // | : + // B--C + let pointA = points[0]; + let pointB = points[1]; + let pointC = points[2]; + let pointD = points[3]; + // shift points for safe transition detection. + let trTop = this.transitionsBetween(pointA, pointD); + let trRight = this.transitionsBetween(pointB, pointD); + let pointAs = Detector$1.shiftPoint(pointA, pointB, (trRight + 1) * 4); + let pointCs = Detector$1.shiftPoint(pointC, pointB, (trTop + 1) * 4); + trTop = this.transitionsBetween(pointAs, pointD); + trRight = this.transitionsBetween(pointCs, pointD); + let candidate1 = new ResultPoint(pointD.getX() + (pointC.getX() - pointB.getX()) / (trTop + 1), pointD.getY() + (pointC.getY() - pointB.getY()) / (trTop + 1)); + let candidate2 = new ResultPoint(pointD.getX() + (pointA.getX() - pointB.getX()) / (trRight + 1), pointD.getY() + (pointA.getY() - pointB.getY()) / (trRight + 1)); + if (!this.isValid(candidate1)) { + if (this.isValid(candidate2)) { + return candidate2; + } + return null; + } + if (!this.isValid(candidate2)) { + return candidate1; + } + let sumc1 = this.transitionsBetween(pointAs, candidate1) + this.transitionsBetween(pointCs, candidate1); + let sumc2 = this.transitionsBetween(pointAs, candidate2) + this.transitionsBetween(pointCs, candidate2); + if (sumc1 > sumc2) { + return candidate1; + } + else { + return candidate2; + } + } + /** + * Shift the edge points to the module center. + */ + shiftToModuleCenter(points) { + // A..D + // | : + // B--C + let pointA = points[0]; + let pointB = points[1]; + let pointC = points[2]; + let pointD = points[3]; + // calculate pseudo dimensions + let dimH = this.transitionsBetween(pointA, pointD) + 1; + let dimV = this.transitionsBetween(pointC, pointD) + 1; + // shift points for safe dimension detection + let pointAs = Detector$1.shiftPoint(pointA, pointB, dimV * 4); + let pointCs = Detector$1.shiftPoint(pointC, pointB, dimH * 4); + // calculate more precise dimensions + dimH = this.transitionsBetween(pointAs, pointD) + 1; + dimV = this.transitionsBetween(pointCs, pointD) + 1; + if ((dimH & 0x01) === 1) { + dimH += 1; + } + if ((dimV & 0x01) === 1) { + dimV += 1; + } + // WhiteRectangleDetector returns points inside of the rectangle. + // I want points on the edges. + let centerX = (pointA.getX() + pointB.getX() + pointC.getX() + pointD.getX()) / 4; + let centerY = (pointA.getY() + pointB.getY() + pointC.getY() + pointD.getY()) / 4; + pointA = Detector$1.moveAway(pointA, centerX, centerY); + pointB = Detector$1.moveAway(pointB, centerX, centerY); + pointC = Detector$1.moveAway(pointC, centerX, centerY); + pointD = Detector$1.moveAway(pointD, centerX, centerY); + let pointBs; + let pointDs; + // shift points to the center of each modules + pointAs = Detector$1.shiftPoint(pointA, pointB, dimV * 4); + pointAs = Detector$1.shiftPoint(pointAs, pointD, dimH * 4); + pointBs = Detector$1.shiftPoint(pointB, pointA, dimV * 4); + pointBs = Detector$1.shiftPoint(pointBs, pointC, dimH * 4); + pointCs = Detector$1.shiftPoint(pointC, pointD, dimV * 4); + pointCs = Detector$1.shiftPoint(pointCs, pointB, dimH * 4); + pointDs = Detector$1.shiftPoint(pointD, pointC, dimV * 4); + pointDs = Detector$1.shiftPoint(pointDs, pointA, dimH * 4); + return [pointAs, pointBs, pointCs, pointDs]; + } + isValid(p) { + return p.getX() >= 0 && p.getX() < this.image.getWidth() && p.getY() > 0 && p.getY() < this.image.getHeight(); + } + static sampleGrid(image, topLeft, bottomLeft, bottomRight, topRight, dimensionX, dimensionY) { + const sampler = GridSamplerInstance.getInstance(); + return sampler.sampleGrid(image, dimensionX, dimensionY, 0.5, 0.5, dimensionX - 0.5, 0.5, dimensionX - 0.5, dimensionY - 0.5, 0.5, dimensionY - 0.5, topLeft.getX(), topLeft.getY(), topRight.getX(), topRight.getY(), bottomRight.getX(), bottomRight.getY(), bottomLeft.getX(), bottomLeft.getY()); + } + /** + * Counts the number of black/white transitions between two points, using something like Bresenham's algorithm. + */ + transitionsBetween(from, to) { + // See QR Code Detector, sizeOfBlackWhiteBlackRun() + let fromX = Math.trunc(from.getX()); + let fromY = Math.trunc(from.getY()); + let toX = Math.trunc(to.getX()); + let toY = Math.trunc(to.getY()); + let steep = Math.abs(toY - fromY) > Math.abs(toX - fromX); + if (steep) { + let temp = fromX; + fromX = fromY; + fromY = temp; + temp = toX; + toX = toY; + toY = temp; + } + let dx = Math.abs(toX - fromX); + let dy = Math.abs(toY - fromY); + let error = -dx / 2; + let ystep = fromY < toY ? 1 : -1; + let xstep = fromX < toX ? 1 : -1; + let transitions = 0; + let inBlack = this.image.get(steep ? fromY : fromX, steep ? fromX : fromY); + for (let x = fromX, y = fromY; x !== toX; x += xstep) { + let isBlack = this.image.get(steep ? y : x, steep ? x : y); + if (isBlack !== inBlack) { + transitions++; + inBlack = isBlack; + } + error += dy; + if (error > 0) { + if (y === toY) { + break; + } + y += ystep; + error -= dx; + } + } + return transitions; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This implementation can detect and decode Data Matrix codes in an image. + * + * @author bbrown@google.com (Brian Brown) + */ + class DataMatrixReader { + constructor() { + this.decoder = new Decoder$1(); + } + /** + * Locates and decodes a Data Matrix code in an image. + * + * @return a String representing the content encoded by the Data Matrix code + * @throws NotFoundException if a Data Matrix code cannot be found + * @throws FormatException if a Data Matrix code cannot be decoded + * @throws ChecksumException if error correction fails + */ + // @Override + // public Result decode(BinaryBitmap image) throws NotFoundException, ChecksumException, FormatException { + // return decode(image, null); + // } + // @Override + decode(image, hints = null) { + let decoderResult; + let points; + if (hints != null && hints.has(DecodeHintType$1.PURE_BARCODE)) { + const bits = DataMatrixReader.extractPureBits(image.getBlackMatrix()); + decoderResult = this.decoder.decode(bits); + points = DataMatrixReader.NO_POINTS; + } + else { + const detectorResult = new Detector$1(image.getBlackMatrix()).detect(); + decoderResult = this.decoder.decode(detectorResult.getBits()); + points = detectorResult.getPoints(); + } + const rawBytes = decoderResult.getRawBytes(); + const result = new Result(decoderResult.getText(), rawBytes, 8 * rawBytes.length, points, BarcodeFormat$1.DATA_MATRIX, System.currentTimeMillis()); + const byteSegments = decoderResult.getByteSegments(); + if (byteSegments != null) { + result.putMetadata(ResultMetadataType$1.BYTE_SEGMENTS, byteSegments); + } + const ecLevel = decoderResult.getECLevel(); + if (ecLevel != null) { + result.putMetadata(ResultMetadataType$1.ERROR_CORRECTION_LEVEL, ecLevel); + } + return result; + } + // @Override + reset() { + // do nothing + } + /** + * This method detects a code in a "pure" image -- that is, pure monochrome image + * which contains only an unrotated, unskewed, image of a code, with some white border + * around it. This is a specialized method that works exceptionally fast in this special + * case. + * + * @see com.google.zxing.qrcode.QRCodeReader#extractPureBits(BitMatrix) + */ + static extractPureBits(image) { + const leftTopBlack = image.getTopLeftOnBit(); + const rightBottomBlack = image.getBottomRightOnBit(); + if (leftTopBlack == null || rightBottomBlack == null) { + throw new NotFoundException(); + } + const moduleSize = this.moduleSize(leftTopBlack, image); + let top = leftTopBlack[1]; + const bottom = rightBottomBlack[1]; + let left = leftTopBlack[0]; + const right = rightBottomBlack[0]; + const matrixWidth = (right - left + 1) / moduleSize; + const matrixHeight = (bottom - top + 1) / moduleSize; + if (matrixWidth <= 0 || matrixHeight <= 0) { + throw new NotFoundException(); + } + // Push in the "border" by half the module width so that we start + // sampling in the middle of the module. Just in case the image is a + // little off, this will help recover. + const nudge = moduleSize / 2; + top += nudge; + left += nudge; + // Now just read off the bits + const bits = new BitMatrix(matrixWidth, matrixHeight); + for (let y = 0; y < matrixHeight; y++) { + const iOffset = top + y * moduleSize; + for (let x = 0; x < matrixWidth; x++) { + if (image.get(left + x * moduleSize, iOffset)) { + bits.set(x, y); + } + } + } + return bits; + } + static moduleSize(leftTopBlack, image) { + const width = image.getWidth(); + let x = leftTopBlack[0]; + const y = leftTopBlack[1]; + while (x < width && image.get(x, y)) { + x++; + } + if (x === width) { + throw new NotFoundException(); + } + const moduleSize = x - leftTopBlack[0]; + if (moduleSize === 0) { + throw new NotFoundException(); + } + return moduleSize; + } + } + DataMatrixReader.NO_POINTS = []; + + /** + * @deprecated Moving to @zxing/browser + * + * QR Code reader to use from browser. + */ + class BrowserDatamatrixCodeReader extends BrowserCodeReader { + /** + * Creates an instance of BrowserQRCodeReader. + * @param {number} [timeBetweenScansMillis=500] the time delay between subsequent decode tries + */ + constructor(timeBetweenScansMillis = 500) { + super(new DataMatrixReader(), timeBetweenScansMillis); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + var ErrorCorrectionLevelValues; + (function (ErrorCorrectionLevelValues) { + ErrorCorrectionLevelValues[ErrorCorrectionLevelValues["L"] = 0] = "L"; + ErrorCorrectionLevelValues[ErrorCorrectionLevelValues["M"] = 1] = "M"; + ErrorCorrectionLevelValues[ErrorCorrectionLevelValues["Q"] = 2] = "Q"; + ErrorCorrectionLevelValues[ErrorCorrectionLevelValues["H"] = 3] = "H"; + })(ErrorCorrectionLevelValues || (ErrorCorrectionLevelValues = {})); + /** + *

See ISO 18004:2006, 6.5.1. This enum encapsulates the four error correction levels + * defined by the QR code standard.

+ * + * @author Sean Owen + */ + class ErrorCorrectionLevel { + constructor(value, stringValue, bits /*int*/) { + this.value = value; + this.stringValue = stringValue; + this.bits = bits; + ErrorCorrectionLevel.FOR_BITS.set(bits, this); + ErrorCorrectionLevel.FOR_VALUE.set(value, this); + } + getValue() { + return this.value; + } + getBits() { + return this.bits; + } + static fromString(s) { + switch (s) { + case 'L': return ErrorCorrectionLevel.L; + case 'M': return ErrorCorrectionLevel.M; + case 'Q': return ErrorCorrectionLevel.Q; + case 'H': return ErrorCorrectionLevel.H; + default: throw new ArgumentException(s + 'not available'); + } + } + toString() { + return this.stringValue; + } + equals(o) { + if (!(o instanceof ErrorCorrectionLevel)) { + return false; + } + const other = o; + return this.value === other.value; + } + /** + * @param bits int containing the two bits encoding a QR Code's error correction level + * @return ErrorCorrectionLevel representing the encoded error correction level + */ + static forBits(bits /*int*/) { + if (bits < 0 || bits >= ErrorCorrectionLevel.FOR_BITS.size) { + throw new IllegalArgumentException(); + } + return ErrorCorrectionLevel.FOR_BITS.get(bits); + } + } + ErrorCorrectionLevel.FOR_BITS = new Map(); + ErrorCorrectionLevel.FOR_VALUE = new Map(); + /** L = ~7% correction */ + ErrorCorrectionLevel.L = new ErrorCorrectionLevel(ErrorCorrectionLevelValues.L, 'L', 0x01); + /** M = ~15% correction */ + ErrorCorrectionLevel.M = new ErrorCorrectionLevel(ErrorCorrectionLevelValues.M, 'M', 0x00); + /** Q = ~25% correction */ + ErrorCorrectionLevel.Q = new ErrorCorrectionLevel(ErrorCorrectionLevelValues.Q, 'Q', 0x03); + /** H = ~30% correction */ + ErrorCorrectionLevel.H = new ErrorCorrectionLevel(ErrorCorrectionLevelValues.H, 'H', 0x02); + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates a QR Code's format information, including the data mask used and + * error correction level.

+ * + * @author Sean Owen + * @see DataMask + * @see ErrorCorrectionLevel + */ + class FormatInformation { + constructor(formatInfo /*int*/) { + // Bits 3,4 + this.errorCorrectionLevel = ErrorCorrectionLevel.forBits((formatInfo >> 3) & 0x03); + // Bottom 3 bits + this.dataMask = /*(byte) */ (formatInfo & 0x07); + } + static numBitsDiffering(a /*int*/, b /*int*/) { + return Integer.bitCount(a ^ b); + } + /** + * @param maskedFormatInfo1 format info indicator, with mask still applied + * @param maskedFormatInfo2 second copy of same info; both are checked at the same time + * to establish best match + * @return information about the format it specifies, or {@code null} + * if doesn't seem to match any known pattern + */ + static decodeFormatInformation(maskedFormatInfo1 /*int*/, maskedFormatInfo2 /*int*/) { + const formatInfo = FormatInformation.doDecodeFormatInformation(maskedFormatInfo1, maskedFormatInfo2); + if (formatInfo !== null) { + return formatInfo; + } + // Should return null, but, some QR codes apparently + // do not mask this info. Try again by actually masking the pattern + // first + return FormatInformation.doDecodeFormatInformation(maskedFormatInfo1 ^ FormatInformation.FORMAT_INFO_MASK_QR, maskedFormatInfo2 ^ FormatInformation.FORMAT_INFO_MASK_QR); + } + static doDecodeFormatInformation(maskedFormatInfo1 /*int*/, maskedFormatInfo2 /*int*/) { + // Find the int in FORMAT_INFO_DECODE_LOOKUP with fewest bits differing + let bestDifference = Number.MAX_SAFE_INTEGER; + let bestFormatInfo = 0; + for (const decodeInfo of FormatInformation.FORMAT_INFO_DECODE_LOOKUP) { + const targetInfo = decodeInfo[0]; + if (targetInfo === maskedFormatInfo1 || targetInfo === maskedFormatInfo2) { + // Found an exact match + return new FormatInformation(decodeInfo[1]); + } + let bitsDifference = FormatInformation.numBitsDiffering(maskedFormatInfo1, targetInfo); + if (bitsDifference < bestDifference) { + bestFormatInfo = decodeInfo[1]; + bestDifference = bitsDifference; + } + if (maskedFormatInfo1 !== maskedFormatInfo2) { + // also try the other option + bitsDifference = FormatInformation.numBitsDiffering(maskedFormatInfo2, targetInfo); + if (bitsDifference < bestDifference) { + bestFormatInfo = decodeInfo[1]; + bestDifference = bitsDifference; + } + } + } + // Hamming distance of the 32 masked codes is 7, by construction, so <= 3 bits + // differing means we found a match + if (bestDifference <= 3) { + return new FormatInformation(bestFormatInfo); + } + return null; + } + getErrorCorrectionLevel() { + return this.errorCorrectionLevel; + } + getDataMask() { + return this.dataMask; + } + /*@Override*/ + hashCode() { + return (this.errorCorrectionLevel.getBits() << 3) | this.dataMask; + } + /*@Override*/ + equals(o) { + if (!(o instanceof FormatInformation)) { + return false; + } + const other = o; + return this.errorCorrectionLevel === other.errorCorrectionLevel && + this.dataMask === other.dataMask; + } + } + FormatInformation.FORMAT_INFO_MASK_QR = 0x5412; + /** + * See ISO 18004:2006, Annex C, Table C.1 + */ + FormatInformation.FORMAT_INFO_DECODE_LOOKUP = [ + Int32Array.from([0x5412, 0x00]), + Int32Array.from([0x5125, 0x01]), + Int32Array.from([0x5E7C, 0x02]), + Int32Array.from([0x5B4B, 0x03]), + Int32Array.from([0x45F9, 0x04]), + Int32Array.from([0x40CE, 0x05]), + Int32Array.from([0x4F97, 0x06]), + Int32Array.from([0x4AA0, 0x07]), + Int32Array.from([0x77C4, 0x08]), + Int32Array.from([0x72F3, 0x09]), + Int32Array.from([0x7DAA, 0x0A]), + Int32Array.from([0x789D, 0x0B]), + Int32Array.from([0x662F, 0x0C]), + Int32Array.from([0x6318, 0x0D]), + Int32Array.from([0x6C41, 0x0E]), + Int32Array.from([0x6976, 0x0F]), + Int32Array.from([0x1689, 0x10]), + Int32Array.from([0x13BE, 0x11]), + Int32Array.from([0x1CE7, 0x12]), + Int32Array.from([0x19D0, 0x13]), + Int32Array.from([0x0762, 0x14]), + Int32Array.from([0x0255, 0x15]), + Int32Array.from([0x0D0C, 0x16]), + Int32Array.from([0x083B, 0x17]), + Int32Array.from([0x355F, 0x18]), + Int32Array.from([0x3068, 0x19]), + Int32Array.from([0x3F31, 0x1A]), + Int32Array.from([0x3A06, 0x1B]), + Int32Array.from([0x24B4, 0x1C]), + Int32Array.from([0x2183, 0x1D]), + Int32Array.from([0x2EDA, 0x1E]), + Int32Array.from([0x2BED, 0x1F]), + ]; + + /** + *

Encapsulates a set of error-correction blocks in one symbol version. Most versions will + * use blocks of differing sizes within one version, so, this encapsulates the parameters for + * each set of blocks. It also holds the number of error-correction codewords per block since it + * will be the same across all blocks within one version.

+ */ + class ECBlocks$1 { + constructor(ecCodewordsPerBlock /*int*/, ...ecBlocks) { + this.ecCodewordsPerBlock = ecCodewordsPerBlock; + this.ecBlocks = ecBlocks; + } + getECCodewordsPerBlock() { + return this.ecCodewordsPerBlock; + } + getNumBlocks() { + let total = 0; + const ecBlocks = this.ecBlocks; + for (const ecBlock of ecBlocks) { + total += ecBlock.getCount(); + } + return total; + } + getTotalECCodewords() { + return this.ecCodewordsPerBlock * this.getNumBlocks(); + } + getECBlocks() { + return this.ecBlocks; + } + } + + /** + *

Encapsulates the parameters for one error-correction block in one symbol version. + * This includes the number of data codewords, and the number of times a block with these + * parameters is used consecutively in the QR code version's format.

+ */ + class ECB$1 { + constructor(count /*int*/, dataCodewords /*int*/) { + this.count = count; + this.dataCodewords = dataCodewords; + } + getCount() { + return this.count; + } + getDataCodewords() { + return this.dataCodewords; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * See ISO 18004:2006 Annex D + * + * @author Sean Owen + */ + class Version$1 { + constructor(versionNumber /*int*/, alignmentPatternCenters, ...ecBlocks) { + this.versionNumber = versionNumber; + this.alignmentPatternCenters = alignmentPatternCenters; + this.ecBlocks = ecBlocks; + let total = 0; + const ecCodewords = ecBlocks[0].getECCodewordsPerBlock(); + const ecbArray = ecBlocks[0].getECBlocks(); + for (const ecBlock of ecbArray) { + total += ecBlock.getCount() * (ecBlock.getDataCodewords() + ecCodewords); + } + this.totalCodewords = total; + } + getVersionNumber() { + return this.versionNumber; + } + getAlignmentPatternCenters() { + return this.alignmentPatternCenters; + } + getTotalCodewords() { + return this.totalCodewords; + } + getDimensionForVersion() { + return 17 + 4 * this.versionNumber; + } + getECBlocksForLevel(ecLevel) { + return this.ecBlocks[ecLevel.getValue()]; + // TYPESCRIPTPORT: original was using ordinal, and using the order of levels as defined in ErrorCorrectionLevel enum (LMQH) + // I will use the direct value from ErrorCorrectionLevelValues enum which in typescript goes to a number + } + /** + *

Deduces version information purely from QR Code dimensions.

+ * + * @param dimension dimension in modules + * @return Version for a QR Code of that dimension + * @throws FormatException if dimension is not 1 mod 4 + */ + static getProvisionalVersionForDimension(dimension /*int*/) { + if (dimension % 4 !== 1) { + throw new FormatException(); + } + try { + return this.getVersionForNumber((dimension - 17) / 4); + } + catch (ignored /*: IllegalArgumentException*/) { + throw new FormatException(); + } + } + static getVersionForNumber(versionNumber /*int*/) { + if (versionNumber < 1 || versionNumber > 40) { + throw new IllegalArgumentException(); + } + return Version$1.VERSIONS[versionNumber - 1]; + } + static decodeVersionInformation(versionBits /*int*/) { + let bestDifference = Number.MAX_SAFE_INTEGER; + let bestVersion = 0; + for (let i = 0; i < Version$1.VERSION_DECODE_INFO.length; i++) { + const targetVersion = Version$1.VERSION_DECODE_INFO[i]; + // Do the version info bits match exactly? done. + if (targetVersion === versionBits) { + return Version$1.getVersionForNumber(i + 7); + } + // Otherwise see if this is the closest to a real version info bit string + // we have seen so far + const bitsDifference = FormatInformation.numBitsDiffering(versionBits, targetVersion); + if (bitsDifference < bestDifference) { + bestVersion = i + 7; + bestDifference = bitsDifference; + } + } + // We can tolerate up to 3 bits of error since no two version info codewords will + // differ in less than 8 bits. + if (bestDifference <= 3) { + return Version$1.getVersionForNumber(bestVersion); + } + // If we didn't find a close enough match, fail + return null; + } + /** + * See ISO 18004:2006 Annex E + */ + buildFunctionPattern() { + const dimension = this.getDimensionForVersion(); + const bitMatrix = new BitMatrix(dimension); + // Top left finder pattern + separator + format + bitMatrix.setRegion(0, 0, 9, 9); + // Top right finder pattern + separator + format + bitMatrix.setRegion(dimension - 8, 0, 8, 9); + // Bottom left finder pattern + separator + format + bitMatrix.setRegion(0, dimension - 8, 9, 8); + // Alignment patterns + const max = this.alignmentPatternCenters.length; + for (let x = 0; x < max; x++) { + const i = this.alignmentPatternCenters[x] - 2; + for (let y = 0; y < max; y++) { + if ((x === 0 && (y === 0 || y === max - 1)) || (x === max - 1 && y === 0)) { + // No alignment patterns near the three finder patterns + continue; + } + bitMatrix.setRegion(this.alignmentPatternCenters[y] - 2, i, 5, 5); + } + } + // Vertical timing pattern + bitMatrix.setRegion(6, 9, 1, dimension - 17); + // Horizontal timing pattern + bitMatrix.setRegion(9, 6, dimension - 17, 1); + if (this.versionNumber > 6) { + // Version info, top right + bitMatrix.setRegion(dimension - 11, 0, 3, 6); + // Version info, bottom left + bitMatrix.setRegion(0, dimension - 11, 6, 3); + } + return bitMatrix; + } + /*@Override*/ + toString() { + return '' + this.versionNumber; + } + } + /** + * See ISO 18004:2006 Annex D. + * Element i represents the raw version bits that specify version i + 7 + */ + Version$1.VERSION_DECODE_INFO = Int32Array.from([ + 0x07C94, 0x085BC, 0x09A99, 0x0A4D3, 0x0BBF6, + 0x0C762, 0x0D847, 0x0E60D, 0x0F928, 0x10B78, + 0x1145D, 0x12A17, 0x13532, 0x149A6, 0x15683, + 0x168C9, 0x177EC, 0x18EC4, 0x191E1, 0x1AFAB, + 0x1B08E, 0x1CC1A, 0x1D33F, 0x1ED75, 0x1F250, + 0x209D5, 0x216F0, 0x228BA, 0x2379F, 0x24B0B, + 0x2542E, 0x26A64, 0x27541, 0x28C69 + ]); + /** + * See ISO 18004:2006 6.5.1 Table 9 + */ + Version$1.VERSIONS = [ + new Version$1(1, new Int32Array(0), new ECBlocks$1(7, new ECB$1(1, 19)), new ECBlocks$1(10, new ECB$1(1, 16)), new ECBlocks$1(13, new ECB$1(1, 13)), new ECBlocks$1(17, new ECB$1(1, 9))), + new Version$1(2, Int32Array.from([6, 18]), new ECBlocks$1(10, new ECB$1(1, 34)), new ECBlocks$1(16, new ECB$1(1, 28)), new ECBlocks$1(22, new ECB$1(1, 22)), new ECBlocks$1(28, new ECB$1(1, 16))), + new Version$1(3, Int32Array.from([6, 22]), new ECBlocks$1(15, new ECB$1(1, 55)), new ECBlocks$1(26, new ECB$1(1, 44)), new ECBlocks$1(18, new ECB$1(2, 17)), new ECBlocks$1(22, new ECB$1(2, 13))), + new Version$1(4, Int32Array.from([6, 26]), new ECBlocks$1(20, new ECB$1(1, 80)), new ECBlocks$1(18, new ECB$1(2, 32)), new ECBlocks$1(26, new ECB$1(2, 24)), new ECBlocks$1(16, new ECB$1(4, 9))), + new Version$1(5, Int32Array.from([6, 30]), new ECBlocks$1(26, new ECB$1(1, 108)), new ECBlocks$1(24, new ECB$1(2, 43)), new ECBlocks$1(18, new ECB$1(2, 15), new ECB$1(2, 16)), new ECBlocks$1(22, new ECB$1(2, 11), new ECB$1(2, 12))), + new Version$1(6, Int32Array.from([6, 34]), new ECBlocks$1(18, new ECB$1(2, 68)), new ECBlocks$1(16, new ECB$1(4, 27)), new ECBlocks$1(24, new ECB$1(4, 19)), new ECBlocks$1(28, new ECB$1(4, 15))), + new Version$1(7, Int32Array.from([6, 22, 38]), new ECBlocks$1(20, new ECB$1(2, 78)), new ECBlocks$1(18, new ECB$1(4, 31)), new ECBlocks$1(18, new ECB$1(2, 14), new ECB$1(4, 15)), new ECBlocks$1(26, new ECB$1(4, 13), new ECB$1(1, 14))), + new Version$1(8, Int32Array.from([6, 24, 42]), new ECBlocks$1(24, new ECB$1(2, 97)), new ECBlocks$1(22, new ECB$1(2, 38), new ECB$1(2, 39)), new ECBlocks$1(22, new ECB$1(4, 18), new ECB$1(2, 19)), new ECBlocks$1(26, new ECB$1(4, 14), new ECB$1(2, 15))), + new Version$1(9, Int32Array.from([6, 26, 46]), new ECBlocks$1(30, new ECB$1(2, 116)), new ECBlocks$1(22, new ECB$1(3, 36), new ECB$1(2, 37)), new ECBlocks$1(20, new ECB$1(4, 16), new ECB$1(4, 17)), new ECBlocks$1(24, new ECB$1(4, 12), new ECB$1(4, 13))), + new Version$1(10, Int32Array.from([6, 28, 50]), new ECBlocks$1(18, new ECB$1(2, 68), new ECB$1(2, 69)), new ECBlocks$1(26, new ECB$1(4, 43), new ECB$1(1, 44)), new ECBlocks$1(24, new ECB$1(6, 19), new ECB$1(2, 20)), new ECBlocks$1(28, new ECB$1(6, 15), new ECB$1(2, 16))), + new Version$1(11, Int32Array.from([6, 30, 54]), new ECBlocks$1(20, new ECB$1(4, 81)), new ECBlocks$1(30, new ECB$1(1, 50), new ECB$1(4, 51)), new ECBlocks$1(28, new ECB$1(4, 22), new ECB$1(4, 23)), new ECBlocks$1(24, new ECB$1(3, 12), new ECB$1(8, 13))), + new Version$1(12, Int32Array.from([6, 32, 58]), new ECBlocks$1(24, new ECB$1(2, 92), new ECB$1(2, 93)), new ECBlocks$1(22, new ECB$1(6, 36), new ECB$1(2, 37)), new ECBlocks$1(26, new ECB$1(4, 20), new ECB$1(6, 21)), new ECBlocks$1(28, new ECB$1(7, 14), new ECB$1(4, 15))), + new Version$1(13, Int32Array.from([6, 34, 62]), new ECBlocks$1(26, new ECB$1(4, 107)), new ECBlocks$1(22, new ECB$1(8, 37), new ECB$1(1, 38)), new ECBlocks$1(24, new ECB$1(8, 20), new ECB$1(4, 21)), new ECBlocks$1(22, new ECB$1(12, 11), new ECB$1(4, 12))), + new Version$1(14, Int32Array.from([6, 26, 46, 66]), new ECBlocks$1(30, new ECB$1(3, 115), new ECB$1(1, 116)), new ECBlocks$1(24, new ECB$1(4, 40), new ECB$1(5, 41)), new ECBlocks$1(20, new ECB$1(11, 16), new ECB$1(5, 17)), new ECBlocks$1(24, new ECB$1(11, 12), new ECB$1(5, 13))), + new Version$1(15, Int32Array.from([6, 26, 48, 70]), new ECBlocks$1(22, new ECB$1(5, 87), new ECB$1(1, 88)), new ECBlocks$1(24, new ECB$1(5, 41), new ECB$1(5, 42)), new ECBlocks$1(30, new ECB$1(5, 24), new ECB$1(7, 25)), new ECBlocks$1(24, new ECB$1(11, 12), new ECB$1(7, 13))), + new Version$1(16, Int32Array.from([6, 26, 50, 74]), new ECBlocks$1(24, new ECB$1(5, 98), new ECB$1(1, 99)), new ECBlocks$1(28, new ECB$1(7, 45), new ECB$1(3, 46)), new ECBlocks$1(24, new ECB$1(15, 19), new ECB$1(2, 20)), new ECBlocks$1(30, new ECB$1(3, 15), new ECB$1(13, 16))), + new Version$1(17, Int32Array.from([6, 30, 54, 78]), new ECBlocks$1(28, new ECB$1(1, 107), new ECB$1(5, 108)), new ECBlocks$1(28, new ECB$1(10, 46), new ECB$1(1, 47)), new ECBlocks$1(28, new ECB$1(1, 22), new ECB$1(15, 23)), new ECBlocks$1(28, new ECB$1(2, 14), new ECB$1(17, 15))), + new Version$1(18, Int32Array.from([6, 30, 56, 82]), new ECBlocks$1(30, new ECB$1(5, 120), new ECB$1(1, 121)), new ECBlocks$1(26, new ECB$1(9, 43), new ECB$1(4, 44)), new ECBlocks$1(28, new ECB$1(17, 22), new ECB$1(1, 23)), new ECBlocks$1(28, new ECB$1(2, 14), new ECB$1(19, 15))), + new Version$1(19, Int32Array.from([6, 30, 58, 86]), new ECBlocks$1(28, new ECB$1(3, 113), new ECB$1(4, 114)), new ECBlocks$1(26, new ECB$1(3, 44), new ECB$1(11, 45)), new ECBlocks$1(26, new ECB$1(17, 21), new ECB$1(4, 22)), new ECBlocks$1(26, new ECB$1(9, 13), new ECB$1(16, 14))), + new Version$1(20, Int32Array.from([6, 34, 62, 90]), new ECBlocks$1(28, new ECB$1(3, 107), new ECB$1(5, 108)), new ECBlocks$1(26, new ECB$1(3, 41), new ECB$1(13, 42)), new ECBlocks$1(30, new ECB$1(15, 24), new ECB$1(5, 25)), new ECBlocks$1(28, new ECB$1(15, 15), new ECB$1(10, 16))), + new Version$1(21, Int32Array.from([6, 28, 50, 72, 94]), new ECBlocks$1(28, new ECB$1(4, 116), new ECB$1(4, 117)), new ECBlocks$1(26, new ECB$1(17, 42)), new ECBlocks$1(28, new ECB$1(17, 22), new ECB$1(6, 23)), new ECBlocks$1(30, new ECB$1(19, 16), new ECB$1(6, 17))), + new Version$1(22, Int32Array.from([6, 26, 50, 74, 98]), new ECBlocks$1(28, new ECB$1(2, 111), new ECB$1(7, 112)), new ECBlocks$1(28, new ECB$1(17, 46)), new ECBlocks$1(30, new ECB$1(7, 24), new ECB$1(16, 25)), new ECBlocks$1(24, new ECB$1(34, 13))), + new Version$1(23, Int32Array.from([6, 30, 54, 78, 102]), new ECBlocks$1(30, new ECB$1(4, 121), new ECB$1(5, 122)), new ECBlocks$1(28, new ECB$1(4, 47), new ECB$1(14, 48)), new ECBlocks$1(30, new ECB$1(11, 24), new ECB$1(14, 25)), new ECBlocks$1(30, new ECB$1(16, 15), new ECB$1(14, 16))), + new Version$1(24, Int32Array.from([6, 28, 54, 80, 106]), new ECBlocks$1(30, new ECB$1(6, 117), new ECB$1(4, 118)), new ECBlocks$1(28, new ECB$1(6, 45), new ECB$1(14, 46)), new ECBlocks$1(30, new ECB$1(11, 24), new ECB$1(16, 25)), new ECBlocks$1(30, new ECB$1(30, 16), new ECB$1(2, 17))), + new Version$1(25, Int32Array.from([6, 32, 58, 84, 110]), new ECBlocks$1(26, new ECB$1(8, 106), new ECB$1(4, 107)), new ECBlocks$1(28, new ECB$1(8, 47), new ECB$1(13, 48)), new ECBlocks$1(30, new ECB$1(7, 24), new ECB$1(22, 25)), new ECBlocks$1(30, new ECB$1(22, 15), new ECB$1(13, 16))), + new Version$1(26, Int32Array.from([6, 30, 58, 86, 114]), new ECBlocks$1(28, new ECB$1(10, 114), new ECB$1(2, 115)), new ECBlocks$1(28, new ECB$1(19, 46), new ECB$1(4, 47)), new ECBlocks$1(28, new ECB$1(28, 22), new ECB$1(6, 23)), new ECBlocks$1(30, new ECB$1(33, 16), new ECB$1(4, 17))), + new Version$1(27, Int32Array.from([6, 34, 62, 90, 118]), new ECBlocks$1(30, new ECB$1(8, 122), new ECB$1(4, 123)), new ECBlocks$1(28, new ECB$1(22, 45), new ECB$1(3, 46)), new ECBlocks$1(30, new ECB$1(8, 23), new ECB$1(26, 24)), new ECBlocks$1(30, new ECB$1(12, 15), new ECB$1(28, 16))), + new Version$1(28, Int32Array.from([6, 26, 50, 74, 98, 122]), new ECBlocks$1(30, new ECB$1(3, 117), new ECB$1(10, 118)), new ECBlocks$1(28, new ECB$1(3, 45), new ECB$1(23, 46)), new ECBlocks$1(30, new ECB$1(4, 24), new ECB$1(31, 25)), new ECBlocks$1(30, new ECB$1(11, 15), new ECB$1(31, 16))), + new Version$1(29, Int32Array.from([6, 30, 54, 78, 102, 126]), new ECBlocks$1(30, new ECB$1(7, 116), new ECB$1(7, 117)), new ECBlocks$1(28, new ECB$1(21, 45), new ECB$1(7, 46)), new ECBlocks$1(30, new ECB$1(1, 23), new ECB$1(37, 24)), new ECBlocks$1(30, new ECB$1(19, 15), new ECB$1(26, 16))), + new Version$1(30, Int32Array.from([6, 26, 52, 78, 104, 130]), new ECBlocks$1(30, new ECB$1(5, 115), new ECB$1(10, 116)), new ECBlocks$1(28, new ECB$1(19, 47), new ECB$1(10, 48)), new ECBlocks$1(30, new ECB$1(15, 24), new ECB$1(25, 25)), new ECBlocks$1(30, new ECB$1(23, 15), new ECB$1(25, 16))), + new Version$1(31, Int32Array.from([6, 30, 56, 82, 108, 134]), new ECBlocks$1(30, new ECB$1(13, 115), new ECB$1(3, 116)), new ECBlocks$1(28, new ECB$1(2, 46), new ECB$1(29, 47)), new ECBlocks$1(30, new ECB$1(42, 24), new ECB$1(1, 25)), new ECBlocks$1(30, new ECB$1(23, 15), new ECB$1(28, 16))), + new Version$1(32, Int32Array.from([6, 34, 60, 86, 112, 138]), new ECBlocks$1(30, new ECB$1(17, 115)), new ECBlocks$1(28, new ECB$1(10, 46), new ECB$1(23, 47)), new ECBlocks$1(30, new ECB$1(10, 24), new ECB$1(35, 25)), new ECBlocks$1(30, new ECB$1(19, 15), new ECB$1(35, 16))), + new Version$1(33, Int32Array.from([6, 30, 58, 86, 114, 142]), new ECBlocks$1(30, new ECB$1(17, 115), new ECB$1(1, 116)), new ECBlocks$1(28, new ECB$1(14, 46), new ECB$1(21, 47)), new ECBlocks$1(30, new ECB$1(29, 24), new ECB$1(19, 25)), new ECBlocks$1(30, new ECB$1(11, 15), new ECB$1(46, 16))), + new Version$1(34, Int32Array.from([6, 34, 62, 90, 118, 146]), new ECBlocks$1(30, new ECB$1(13, 115), new ECB$1(6, 116)), new ECBlocks$1(28, new ECB$1(14, 46), new ECB$1(23, 47)), new ECBlocks$1(30, new ECB$1(44, 24), new ECB$1(7, 25)), new ECBlocks$1(30, new ECB$1(59, 16), new ECB$1(1, 17))), + new Version$1(35, Int32Array.from([6, 30, 54, 78, 102, 126, 150]), new ECBlocks$1(30, new ECB$1(12, 121), new ECB$1(7, 122)), new ECBlocks$1(28, new ECB$1(12, 47), new ECB$1(26, 48)), new ECBlocks$1(30, new ECB$1(39, 24), new ECB$1(14, 25)), new ECBlocks$1(30, new ECB$1(22, 15), new ECB$1(41, 16))), + new Version$1(36, Int32Array.from([6, 24, 50, 76, 102, 128, 154]), new ECBlocks$1(30, new ECB$1(6, 121), new ECB$1(14, 122)), new ECBlocks$1(28, new ECB$1(6, 47), new ECB$1(34, 48)), new ECBlocks$1(30, new ECB$1(46, 24), new ECB$1(10, 25)), new ECBlocks$1(30, new ECB$1(2, 15), new ECB$1(64, 16))), + new Version$1(37, Int32Array.from([6, 28, 54, 80, 106, 132, 158]), new ECBlocks$1(30, new ECB$1(17, 122), new ECB$1(4, 123)), new ECBlocks$1(28, new ECB$1(29, 46), new ECB$1(14, 47)), new ECBlocks$1(30, new ECB$1(49, 24), new ECB$1(10, 25)), new ECBlocks$1(30, new ECB$1(24, 15), new ECB$1(46, 16))), + new Version$1(38, Int32Array.from([6, 32, 58, 84, 110, 136, 162]), new ECBlocks$1(30, new ECB$1(4, 122), new ECB$1(18, 123)), new ECBlocks$1(28, new ECB$1(13, 46), new ECB$1(32, 47)), new ECBlocks$1(30, new ECB$1(48, 24), new ECB$1(14, 25)), new ECBlocks$1(30, new ECB$1(42, 15), new ECB$1(32, 16))), + new Version$1(39, Int32Array.from([6, 26, 54, 82, 110, 138, 166]), new ECBlocks$1(30, new ECB$1(20, 117), new ECB$1(4, 118)), new ECBlocks$1(28, new ECB$1(40, 47), new ECB$1(7, 48)), new ECBlocks$1(30, new ECB$1(43, 24), new ECB$1(22, 25)), new ECBlocks$1(30, new ECB$1(10, 15), new ECB$1(67, 16))), + new Version$1(40, Int32Array.from([6, 30, 58, 86, 114, 142, 170]), new ECBlocks$1(30, new ECB$1(19, 118), new ECB$1(6, 119)), new ECBlocks$1(28, new ECB$1(18, 47), new ECB$1(31, 48)), new ECBlocks$1(30, new ECB$1(34, 24), new ECB$1(34, 25)), new ECBlocks$1(30, new ECB$1(20, 15), new ECB$1(61, 16))) + ]; + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + var DataMaskValues; + (function (DataMaskValues) { + DataMaskValues[DataMaskValues["DATA_MASK_000"] = 0] = "DATA_MASK_000"; + DataMaskValues[DataMaskValues["DATA_MASK_001"] = 1] = "DATA_MASK_001"; + DataMaskValues[DataMaskValues["DATA_MASK_010"] = 2] = "DATA_MASK_010"; + DataMaskValues[DataMaskValues["DATA_MASK_011"] = 3] = "DATA_MASK_011"; + DataMaskValues[DataMaskValues["DATA_MASK_100"] = 4] = "DATA_MASK_100"; + DataMaskValues[DataMaskValues["DATA_MASK_101"] = 5] = "DATA_MASK_101"; + DataMaskValues[DataMaskValues["DATA_MASK_110"] = 6] = "DATA_MASK_110"; + DataMaskValues[DataMaskValues["DATA_MASK_111"] = 7] = "DATA_MASK_111"; + })(DataMaskValues || (DataMaskValues = {})); + /** + *

Encapsulates data masks for the data bits in a QR code, per ISO 18004:2006 6.8. Implementations + * of this class can un-mask a raw BitMatrix. For simplicity, they will unmask the entire BitMatrix, + * including areas used for finder patterns, timing patterns, etc. These areas should be unused + * after the point they are unmasked anyway.

+ * + *

Note that the diagram in section 6.8.1 is misleading since it indicates that i is column position + * and j is row position. In fact, as the text says, i is row position and j is column position.

+ * + * @author Sean Owen + */ + class DataMask { + // See ISO 18004:2006 6.8.1 + constructor(value, isMasked) { + this.value = value; + this.isMasked = isMasked; + } + // End of enum constants. + /** + *

Implementations of this method reverse the data masking process applied to a QR Code and + * make its bits ready to read.

+ * + * @param bits representation of QR Code bits + * @param dimension dimension of QR Code, represented by bits, being unmasked + */ + unmaskBitMatrix(bits, dimension /*int*/) { + for (let i = 0; i < dimension; i++) { + for (let j = 0; j < dimension; j++) { + if (this.isMasked(i, j)) { + bits.flip(j, i); + } + } + } + } + } + DataMask.values = new Map([ + /** + * 000: mask bits for which (x + y) mod 2 == 0 + */ + [DataMaskValues.DATA_MASK_000, new DataMask(DataMaskValues.DATA_MASK_000, (i /*int*/, j /*int*/) => { return ((i + j) & 0x01) === 0; })], + /** + * 001: mask bits for which x mod 2 == 0 + */ + [DataMaskValues.DATA_MASK_001, new DataMask(DataMaskValues.DATA_MASK_001, (i /*int*/, j /*int*/) => { return (i & 0x01) === 0; })], + /** + * 010: mask bits for which y mod 3 == 0 + */ + [DataMaskValues.DATA_MASK_010, new DataMask(DataMaskValues.DATA_MASK_010, (i /*int*/, j /*int*/) => { return j % 3 === 0; })], + /** + * 011: mask bits for which (x + y) mod 3 == 0 + */ + [DataMaskValues.DATA_MASK_011, new DataMask(DataMaskValues.DATA_MASK_011, (i /*int*/, j /*int*/) => { return (i + j) % 3 === 0; })], + /** + * 100: mask bits for which (x/2 + y/3) mod 2 == 0 + */ + [DataMaskValues.DATA_MASK_100, new DataMask(DataMaskValues.DATA_MASK_100, (i /*int*/, j /*int*/) => { return ((Math.floor(i / 2) + Math.floor(j / 3)) & 0x01) === 0; })], + /** + * 101: mask bits for which xy mod 2 + xy mod 3 == 0 + * equivalently, such that xy mod 6 == 0 + */ + [DataMaskValues.DATA_MASK_101, new DataMask(DataMaskValues.DATA_MASK_101, (i /*int*/, j /*int*/) => { return (i * j) % 6 === 0; })], + /** + * 110: mask bits for which (xy mod 2 + xy mod 3) mod 2 == 0 + * equivalently, such that xy mod 6 < 3 + */ + [DataMaskValues.DATA_MASK_110, new DataMask(DataMaskValues.DATA_MASK_110, (i /*int*/, j /*int*/) => { return ((i * j) % 6) < 3; })], + /** + * 111: mask bits for which ((x+y)mod 2 + xy mod 3) mod 2 == 0 + * equivalently, such that (x + y + xy mod 3) mod 2 == 0 + */ + [DataMaskValues.DATA_MASK_111, new DataMask(DataMaskValues.DATA_MASK_111, (i /*int*/, j /*int*/) => { return ((i + j + ((i * j) % 3)) & 0x01) === 0; })], + ]); + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Sean Owen + */ + class BitMatrixParser$1 { + /** + * @param bitMatrix {@link BitMatrix} to parse + * @throws FormatException if dimension is not >= 21 and 1 mod 4 + */ + constructor(bitMatrix) { + const dimension = bitMatrix.getHeight(); + if (dimension < 21 || (dimension & 0x03) !== 1) { + throw new FormatException(); + } + this.bitMatrix = bitMatrix; + } + /** + *

Reads format information from one of its two locations within the QR Code.

+ * + * @return {@link FormatInformation} encapsulating the QR Code's format info + * @throws FormatException if both format information locations cannot be parsed as + * the valid encoding of format information + */ + readFormatInformation() { + if (this.parsedFormatInfo !== null && this.parsedFormatInfo !== undefined) { + return this.parsedFormatInfo; + } + // Read top-left format info bits + let formatInfoBits1 = 0; + for (let i = 0; i < 6; i++) { + formatInfoBits1 = this.copyBit(i, 8, formatInfoBits1); + } + // .. and skip a bit in the timing pattern ... + formatInfoBits1 = this.copyBit(7, 8, formatInfoBits1); + formatInfoBits1 = this.copyBit(8, 8, formatInfoBits1); + formatInfoBits1 = this.copyBit(8, 7, formatInfoBits1); + // .. and skip a bit in the timing pattern ... + for (let j = 5; j >= 0; j--) { + formatInfoBits1 = this.copyBit(8, j, formatInfoBits1); + } + // Read the top-right/bottom-left pattern too + const dimension = this.bitMatrix.getHeight(); + let formatInfoBits2 = 0; + const jMin = dimension - 7; + for (let j = dimension - 1; j >= jMin; j--) { + formatInfoBits2 = this.copyBit(8, j, formatInfoBits2); + } + for (let i = dimension - 8; i < dimension; i++) { + formatInfoBits2 = this.copyBit(i, 8, formatInfoBits2); + } + this.parsedFormatInfo = FormatInformation.decodeFormatInformation(formatInfoBits1, formatInfoBits2); + if (this.parsedFormatInfo !== null) { + return this.parsedFormatInfo; + } + throw new FormatException(); + } + /** + *

Reads version information from one of its two locations within the QR Code.

+ * + * @return {@link Version} encapsulating the QR Code's version + * @throws FormatException if both version information locations cannot be parsed as + * the valid encoding of version information + */ + readVersion() { + if (this.parsedVersion !== null && this.parsedVersion !== undefined) { + return this.parsedVersion; + } + const dimension = this.bitMatrix.getHeight(); + const provisionalVersion = Math.floor((dimension - 17) / 4); + if (provisionalVersion <= 6) { + return Version$1.getVersionForNumber(provisionalVersion); + } + // Read top-right version info: 3 wide by 6 tall + let versionBits = 0; + const ijMin = dimension - 11; + for (let j = 5; j >= 0; j--) { + for (let i = dimension - 9; i >= ijMin; i--) { + versionBits = this.copyBit(i, j, versionBits); + } + } + let theParsedVersion = Version$1.decodeVersionInformation(versionBits); + if (theParsedVersion !== null && theParsedVersion.getDimensionForVersion() === dimension) { + this.parsedVersion = theParsedVersion; + return theParsedVersion; + } + // Hmm, failed. Try bottom left: 6 wide by 3 tall + versionBits = 0; + for (let i = 5; i >= 0; i--) { + for (let j = dimension - 9; j >= ijMin; j--) { + versionBits = this.copyBit(i, j, versionBits); + } + } + theParsedVersion = Version$1.decodeVersionInformation(versionBits); + if (theParsedVersion !== null && theParsedVersion.getDimensionForVersion() === dimension) { + this.parsedVersion = theParsedVersion; + return theParsedVersion; + } + throw new FormatException(); + } + copyBit(i /*int*/, j /*int*/, versionBits /*int*/) { + const bit = this.isMirror ? this.bitMatrix.get(j, i) : this.bitMatrix.get(i, j); + return bit ? (versionBits << 1) | 0x1 : versionBits << 1; + } + /** + *

Reads the bits in the {@link BitMatrix} representing the finder pattern in the + * correct order in order to reconstruct the codewords bytes contained within the + * QR Code.

+ * + * @return bytes encoded within the QR Code + * @throws FormatException if the exact number of bytes expected is not read + */ + readCodewords() { + const formatInfo = this.readFormatInformation(); + const version = this.readVersion(); + // Get the data mask for the format used in this QR Code. This will exclude + // some bits from reading as we wind through the bit matrix. + const dataMask = DataMask.values.get(formatInfo.getDataMask()); + const dimension = this.bitMatrix.getHeight(); + dataMask.unmaskBitMatrix(this.bitMatrix, dimension); + const functionPattern = version.buildFunctionPattern(); + let readingUp = true; + const result = new Uint8Array(version.getTotalCodewords()); + let resultOffset = 0; + let currentByte = 0; + let bitsRead = 0; + // Read columns in pairs, from right to left + for (let j = dimension - 1; j > 0; j -= 2) { + if (j === 6) { + // Skip whole column with vertical alignment pattern + // saves time and makes the other code proceed more cleanly + j--; + } + // Read alternatingly from bottom to top then top to bottom + for (let count = 0; count < dimension; count++) { + const i = readingUp ? dimension - 1 - count : count; + for (let col = 0; col < 2; col++) { + // Ignore bits covered by the function pattern + if (!functionPattern.get(j - col, i)) { + // Read a bit + bitsRead++; + currentByte <<= 1; + if (this.bitMatrix.get(j - col, i)) { + currentByte |= 1; + } + // If we've made a whole byte, save it off + if (bitsRead === 8) { + result[resultOffset++] = /*(byte) */ currentByte; + bitsRead = 0; + currentByte = 0; + } + } + } + } + readingUp = !readingUp; // readingUp ^= true; // readingUp = !readingUp; // switch directions + } + if (resultOffset !== version.getTotalCodewords()) { + throw new FormatException(); + } + return result; + } + /** + * Revert the mask removal done while reading the code words. The bit matrix should revert to its original state. + */ + remask() { + if (this.parsedFormatInfo === null) { + return; // We have no format information, and have no data mask + } + const dataMask = DataMask.values[this.parsedFormatInfo.getDataMask()]; + const dimension = this.bitMatrix.getHeight(); + dataMask.unmaskBitMatrix(this.bitMatrix, dimension); + } + /** + * Prepare the parser for a mirrored operation. + * This flag has effect only on the {@link #readFormatInformation()} and the + * {@link #readVersion()}. Before proceeding with {@link #readCodewords()} the + * {@link #mirror()} method should be called. + * + * @param mirror Whether to read version and format information mirrored. + */ + setMirror(isMirror) { + this.parsedVersion = null; + this.parsedFormatInfo = null; + this.isMirror = isMirror; + } + /** Mirror the bit matrix in order to attempt a second reading. */ + mirror() { + const bitMatrix = this.bitMatrix; + for (let x = 0, width = bitMatrix.getWidth(); x < width; x++) { + for (let y = x + 1, height = bitMatrix.getHeight(); y < height; y++) { + if (bitMatrix.get(x, y) !== bitMatrix.get(y, x)) { + bitMatrix.flip(y, x); + bitMatrix.flip(x, y); + } + } + } + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates a block of data within a QR Code. QR Codes may split their data into + * multiple blocks, each of which is a unit of data and error-correction codewords. Each + * is represented by an instance of this class.

+ * + * @author Sean Owen + */ + class DataBlock$1 { + constructor(numDataCodewords /*int*/, codewords) { + this.numDataCodewords = numDataCodewords; + this.codewords = codewords; + } + /** + *

When QR Codes use multiple data blocks, they are actually interleaved. + * That is, the first byte of data block 1 to n is written, then the second bytes, and so on. This + * method will separate the data into original blocks.

+ * + * @param rawCodewords bytes as read directly from the QR Code + * @param version version of the QR Code + * @param ecLevel error-correction level of the QR Code + * @return DataBlocks containing original bytes, "de-interleaved" from representation in the + * QR Code + */ + static getDataBlocks(rawCodewords, version, ecLevel) { + if (rawCodewords.length !== version.getTotalCodewords()) { + throw new IllegalArgumentException(); + } + // Figure out the number and size of data blocks used by this version and + // error correction level + const ecBlocks = version.getECBlocksForLevel(ecLevel); + // First count the total number of data blocks + let totalBlocks = 0; + const ecBlockArray = ecBlocks.getECBlocks(); + for (const ecBlock of ecBlockArray) { + totalBlocks += ecBlock.getCount(); + } + // Now establish DataBlocks of the appropriate size and number of data codewords + const result = new Array(totalBlocks); + let numResultBlocks = 0; + for (const ecBlock of ecBlockArray) { + for (let i = 0; i < ecBlock.getCount(); i++) { + const numDataCodewords = ecBlock.getDataCodewords(); + const numBlockCodewords = ecBlocks.getECCodewordsPerBlock() + numDataCodewords; + result[numResultBlocks++] = new DataBlock$1(numDataCodewords, new Uint8Array(numBlockCodewords)); + } + } + // All blocks have the same amount of data, except that the last n + // (where n may be 0) have 1 more byte. Figure out where these start. + const shorterBlocksTotalCodewords = result[0].codewords.length; + let longerBlocksStartAt = result.length - 1; + // TYPESCRIPTPORT: check length is correct here + while (longerBlocksStartAt >= 0) { + const numCodewords = result[longerBlocksStartAt].codewords.length; + if (numCodewords === shorterBlocksTotalCodewords) { + break; + } + longerBlocksStartAt--; + } + longerBlocksStartAt++; + const shorterBlocksNumDataCodewords = shorterBlocksTotalCodewords - ecBlocks.getECCodewordsPerBlock(); + // The last elements of result may be 1 element longer + // first fill out as many elements as all of them have + let rawCodewordsOffset = 0; + for (let i = 0; i < shorterBlocksNumDataCodewords; i++) { + for (let j = 0; j < numResultBlocks; j++) { + result[j].codewords[i] = rawCodewords[rawCodewordsOffset++]; + } + } + // Fill out the last data block in the longer ones + for (let j = longerBlocksStartAt; j < numResultBlocks; j++) { + result[j].codewords[shorterBlocksNumDataCodewords] = rawCodewords[rawCodewordsOffset++]; + } + // Now add in error correction blocks + const max = result[0].codewords.length; + for (let i = shorterBlocksNumDataCodewords; i < max; i++) { + for (let j = 0; j < numResultBlocks; j++) { + const iOffset = j < longerBlocksStartAt ? i : i + 1; + result[j].codewords[iOffset] = rawCodewords[rawCodewordsOffset++]; + } + } + return result; + } + getNumDataCodewords() { + return this.numDataCodewords; + } + getCodewords() { + return this.codewords; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + var ModeValues; + (function (ModeValues) { + ModeValues[ModeValues["TERMINATOR"] = 0] = "TERMINATOR"; + ModeValues[ModeValues["NUMERIC"] = 1] = "NUMERIC"; + ModeValues[ModeValues["ALPHANUMERIC"] = 2] = "ALPHANUMERIC"; + ModeValues[ModeValues["STRUCTURED_APPEND"] = 3] = "STRUCTURED_APPEND"; + ModeValues[ModeValues["BYTE"] = 4] = "BYTE"; + ModeValues[ModeValues["ECI"] = 5] = "ECI"; + ModeValues[ModeValues["KANJI"] = 6] = "KANJI"; + ModeValues[ModeValues["FNC1_FIRST_POSITION"] = 7] = "FNC1_FIRST_POSITION"; + ModeValues[ModeValues["FNC1_SECOND_POSITION"] = 8] = "FNC1_SECOND_POSITION"; + /** See GBT 18284-2000; "Hanzi" is a transliteration of this mode name. */ + ModeValues[ModeValues["HANZI"] = 9] = "HANZI"; + })(ModeValues || (ModeValues = {})); + /** + *

See ISO 18004:2006, 6.4.1, Tables 2 and 3. This enum encapsulates the various modes in which + * data can be encoded to bits in the QR code standard.

+ * + * @author Sean Owen + */ + class Mode$1 { + constructor(value, stringValue, characterCountBitsForVersions, bits /*int*/) { + this.value = value; + this.stringValue = stringValue; + this.characterCountBitsForVersions = characterCountBitsForVersions; + this.bits = bits; + Mode$1.FOR_BITS.set(bits, this); + Mode$1.FOR_VALUE.set(value, this); + } + /** + * @param bits four bits encoding a QR Code data mode + * @return Mode encoded by these bits + * @throws IllegalArgumentException if bits do not correspond to a known mode + */ + static forBits(bits /*int*/) { + const mode = Mode$1.FOR_BITS.get(bits); + if (undefined === mode) { + throw new IllegalArgumentException(); + } + return mode; + } + /** + * @param version version in question + * @return number of bits used, in this QR Code symbol {@link Version}, to encode the + * count of characters that will follow encoded in this Mode + */ + getCharacterCountBits(version) { + const versionNumber = version.getVersionNumber(); + let offset; + if (versionNumber <= 9) { + offset = 0; + } + else if (versionNumber <= 26) { + offset = 1; + } + else { + offset = 2; + } + return this.characterCountBitsForVersions[offset]; + } + getValue() { + return this.value; + } + getBits() { + return this.bits; + } + equals(o) { + if (!(o instanceof Mode$1)) { + return false; + } + const other = o; + return this.value === other.value; + } + toString() { + return this.stringValue; + } + } + Mode$1.FOR_BITS = new Map(); + Mode$1.FOR_VALUE = new Map(); + Mode$1.TERMINATOR = new Mode$1(ModeValues.TERMINATOR, 'TERMINATOR', Int32Array.from([0, 0, 0]), 0x00); // Not really a mode... + Mode$1.NUMERIC = new Mode$1(ModeValues.NUMERIC, 'NUMERIC', Int32Array.from([10, 12, 14]), 0x01); + Mode$1.ALPHANUMERIC = new Mode$1(ModeValues.ALPHANUMERIC, 'ALPHANUMERIC', Int32Array.from([9, 11, 13]), 0x02); + Mode$1.STRUCTURED_APPEND = new Mode$1(ModeValues.STRUCTURED_APPEND, 'STRUCTURED_APPEND', Int32Array.from([0, 0, 0]), 0x03); // Not supported + Mode$1.BYTE = new Mode$1(ModeValues.BYTE, 'BYTE', Int32Array.from([8, 16, 16]), 0x04); + Mode$1.ECI = new Mode$1(ModeValues.ECI, 'ECI', Int32Array.from([0, 0, 0]), 0x07); // character counts don't apply + Mode$1.KANJI = new Mode$1(ModeValues.KANJI, 'KANJI', Int32Array.from([8, 10, 12]), 0x08); + Mode$1.FNC1_FIRST_POSITION = new Mode$1(ModeValues.FNC1_FIRST_POSITION, 'FNC1_FIRST_POSITION', Int32Array.from([0, 0, 0]), 0x05); + Mode$1.FNC1_SECOND_POSITION = new Mode$1(ModeValues.FNC1_SECOND_POSITION, 'FNC1_SECOND_POSITION', Int32Array.from([0, 0, 0]), 0x09); + /** See GBT 18284-2000; "Hanzi" is a transliteration of this mode name. */ + Mode$1.HANZI = new Mode$1(ModeValues.HANZI, 'HANZI', Int32Array.from([8, 10, 12]), 0x0D); + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.io.UnsupportedEncodingException;*/ + /*import java.util.ArrayList;*/ + /*import java.util.Collection;*/ + /*import java.util.List;*/ + /*import java.util.Map;*/ + /** + *

QR Codes can encode text as bits in one of several modes, and can use multiple modes + * in one QR Code. This class decodes the bits back into text.

+ * + *

See ISO 18004:2006, 6.4.3 - 6.4.7

+ * + * @author Sean Owen + */ + class DecodedBitStreamParser$1 { + static decode(bytes, version, ecLevel, hints) { + const bits = new BitSource(bytes); + let result = new StringBuilder(); + const byteSegments = new Array(); // 1 + // TYPESCRIPTPORT: I do not use constructor with size 1 as in original Java means capacity and the array length is checked below + let symbolSequence = -1; + let parityData = -1; + try { + let currentCharacterSetECI = null; + let fc1InEffect = false; + let mode; + do { + // While still another segment to read... + if (bits.available() < 4) { + // OK, assume we're done. Really, a TERMINATOR mode should have been recorded here + mode = Mode$1.TERMINATOR; + } + else { + const modeBits = bits.readBits(4); + mode = Mode$1.forBits(modeBits); // mode is encoded by 4 bits + } + switch (mode) { + case Mode$1.TERMINATOR: + break; + case Mode$1.FNC1_FIRST_POSITION: + case Mode$1.FNC1_SECOND_POSITION: + // We do little with FNC1 except alter the parsed result a bit according to the spec + fc1InEffect = true; + break; + case Mode$1.STRUCTURED_APPEND: + if (bits.available() < 16) { + throw new FormatException(); + } + // sequence number and parity is added later to the result metadata + // Read next 8 bits (symbol sequence #) and 8 bits (data: parity), then continue + symbolSequence = bits.readBits(8); + parityData = bits.readBits(8); + break; + case Mode$1.ECI: + // Count doesn't apply to ECI + const value = DecodedBitStreamParser$1.parseECIValue(bits); + currentCharacterSetECI = CharacterSetECI.getCharacterSetECIByValue(value); + if (currentCharacterSetECI === null) { + throw new FormatException(); + } + break; + case Mode$1.HANZI: + // First handle Hanzi mode which does not start with character count + // Chinese mode contains a sub set indicator right after mode indicator + const subset = bits.readBits(4); + const countHanzi = bits.readBits(mode.getCharacterCountBits(version)); + if (subset === DecodedBitStreamParser$1.GB2312_SUBSET) { + DecodedBitStreamParser$1.decodeHanziSegment(bits, result, countHanzi); + } + break; + default: + // "Normal" QR code modes: + // How many characters will follow, encoded in this mode? + const count = bits.readBits(mode.getCharacterCountBits(version)); + switch (mode) { + case Mode$1.NUMERIC: + DecodedBitStreamParser$1.decodeNumericSegment(bits, result, count); + break; + case Mode$1.ALPHANUMERIC: + DecodedBitStreamParser$1.decodeAlphanumericSegment(bits, result, count, fc1InEffect); + break; + case Mode$1.BYTE: + DecodedBitStreamParser$1.decodeByteSegment(bits, result, count, currentCharacterSetECI, byteSegments, hints); + break; + case Mode$1.KANJI: + DecodedBitStreamParser$1.decodeKanjiSegment(bits, result, count); + break; + default: + throw new FormatException(); + } + break; + } + } while (mode !== Mode$1.TERMINATOR); + } + catch (iae /*: IllegalArgumentException*/) { + // from readBits() calls + throw new FormatException(); + } + return new DecoderResult(bytes, result.toString(), byteSegments.length === 0 ? null : byteSegments, ecLevel === null ? null : ecLevel.toString(), symbolSequence, parityData); + } + /** + * See specification GBT 18284-2000 + */ + static decodeHanziSegment(bits, result, count /*int*/) { + // Don't crash trying to read more bits than we have available. + if (count * 13 > bits.available()) { + throw new FormatException(); + } + // Each character will require 2 bytes. Read the characters as 2-byte pairs + // and decode as GB2312 afterwards + const buffer = new Uint8Array(2 * count); + let offset = 0; + while (count > 0) { + // Each 13 bits encodes a 2-byte character + const twoBytes = bits.readBits(13); + let assembledTwoBytes = (((twoBytes / 0x060) << 8) & 0xFFFFFFFF) | (twoBytes % 0x060); + if (assembledTwoBytes < 0x003BF) { + // In the 0xA1A1 to 0xAAFE range + assembledTwoBytes += 0x0A1A1; + } + else { + // In the 0xB0A1 to 0xFAFE range + assembledTwoBytes += 0x0A6A1; + } + buffer[offset] = /*(byte) */ ((assembledTwoBytes >> 8) & 0xFF); + buffer[offset + 1] = /*(byte) */ (assembledTwoBytes & 0xFF); + offset += 2; + count--; + } + try { + result.append(StringEncoding.decode(buffer, StringUtils.GB2312)); + // TYPESCRIPTPORT: TODO: implement GB2312 decode. StringView from MDN could be a starting point + } + catch (ignored /*: UnsupportedEncodingException*/) { + throw new FormatException(ignored); + } + } + static decodeKanjiSegment(bits, result, count /*int*/) { + // Don't crash trying to read more bits than we have available. + if (count * 13 > bits.available()) { + throw new FormatException(); + } + // Each character will require 2 bytes. Read the characters as 2-byte pairs + // and decode as Shift_JIS afterwards + const buffer = new Uint8Array(2 * count); + let offset = 0; + while (count > 0) { + // Each 13 bits encodes a 2-byte character + const twoBytes = bits.readBits(13); + let assembledTwoBytes = (((twoBytes / 0x0C0) << 8) & 0xFFFFFFFF) | (twoBytes % 0x0C0); + if (assembledTwoBytes < 0x01F00) { + // In the 0x8140 to 0x9FFC range + assembledTwoBytes += 0x08140; + } + else { + // In the 0xE040 to 0xEBBF range + assembledTwoBytes += 0x0C140; + } + buffer[offset] = /*(byte) */ (assembledTwoBytes >> 8); + buffer[offset + 1] = /*(byte) */ assembledTwoBytes; + offset += 2; + count--; + } + // Shift_JIS may not be supported in some environments: + try { + result.append(StringEncoding.decode(buffer, StringUtils.SHIFT_JIS)); + // TYPESCRIPTPORT: TODO: implement SHIFT_JIS decode. StringView from MDN could be a starting point + } + catch (ignored /*: UnsupportedEncodingException*/) { + throw new FormatException(ignored); + } + } + static decodeByteSegment(bits, result, count /*int*/, currentCharacterSetECI, byteSegments, hints) { + // Don't crash trying to read more bits than we have available. + if (8 * count > bits.available()) { + throw new FormatException(); + } + const readBytes = new Uint8Array(count); + for (let i = 0; i < count; i++) { + readBytes[i] = /*(byte) */ bits.readBits(8); + } + let encoding; + if (currentCharacterSetECI === null) { + // The spec isn't clear on this mode; see + // section 6.4.5: t does not say which encoding to assuming + // upon decoding. I have seen ISO-8859-1 used as well as + // Shift_JIS -- without anything like an ECI designator to + // give a hint. + encoding = StringUtils.guessEncoding(readBytes, hints); + } + else { + encoding = currentCharacterSetECI.getName(); + } + try { + result.append(StringEncoding.decode(readBytes, encoding)); + } + catch (ignored /*: UnsupportedEncodingException*/) { + throw new FormatException(ignored); + } + byteSegments.push(readBytes); + } + static toAlphaNumericChar(value /*int*/) { + if (value >= DecodedBitStreamParser$1.ALPHANUMERIC_CHARS.length) { + throw new FormatException(); + } + return DecodedBitStreamParser$1.ALPHANUMERIC_CHARS[value]; + } + static decodeAlphanumericSegment(bits, result, count /*int*/, fc1InEffect) { + // Read two characters at a time + const start = result.length(); + while (count > 1) { + if (bits.available() < 11) { + throw new FormatException(); + } + const nextTwoCharsBits = bits.readBits(11); + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(Math.floor(nextTwoCharsBits / 45))); + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(nextTwoCharsBits % 45)); + count -= 2; + } + if (count === 1) { + // special case: one character left + if (bits.available() < 6) { + throw new FormatException(); + } + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(bits.readBits(6))); + } + // See section 6.4.8.1, 6.4.8.2 + if (fc1InEffect) { + // We need to massage the result a bit if in an FNC1 mode: + for (let i = start; i < result.length(); i++) { + if (result.charAt(i) === '%') { + if (i < result.length() - 1 && result.charAt(i + 1) === '%') { + // %% is rendered as % + result.deleteCharAt(i + 1); + } + else { + // In alpha mode, % should be converted to FNC1 separator 0x1D + result.setCharAt(i, String.fromCharCode(0x1D)); + } + } + } + } + } + static decodeNumericSegment(bits, result, count /*int*/) { + // Read three digits at a time + while (count >= 3) { + // Each 10 bits encodes three digits + if (bits.available() < 10) { + throw new FormatException(); + } + const threeDigitsBits = bits.readBits(10); + if (threeDigitsBits >= 1000) { + throw new FormatException(); + } + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(Math.floor(threeDigitsBits / 100))); + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(Math.floor(threeDigitsBits / 10) % 10)); + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(threeDigitsBits % 10)); + count -= 3; + } + if (count === 2) { + // Two digits left over to read, encoded in 7 bits + if (bits.available() < 7) { + throw new FormatException(); + } + const twoDigitsBits = bits.readBits(7); + if (twoDigitsBits >= 100) { + throw new FormatException(); + } + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(Math.floor(twoDigitsBits / 10))); + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(twoDigitsBits % 10)); + } + else if (count === 1) { + // One digit left over to read + if (bits.available() < 4) { + throw new FormatException(); + } + const digitBits = bits.readBits(4); + if (digitBits >= 10) { + throw new FormatException(); + } + result.append(DecodedBitStreamParser$1.toAlphaNumericChar(digitBits)); + } + } + static parseECIValue(bits) { + const firstByte = bits.readBits(8); + if ((firstByte & 0x80) === 0) { + // just one byte + return firstByte & 0x7F; + } + if ((firstByte & 0xC0) === 0x80) { + // two bytes + const secondByte = bits.readBits(8); + return (((firstByte & 0x3F) << 8) & 0xFFFFFFFF) | secondByte; + } + if ((firstByte & 0xE0) === 0xC0) { + // three bytes + const secondThirdBytes = bits.readBits(16); + return (((firstByte & 0x1F) << 16) & 0xFFFFFFFF) | secondThirdBytes; + } + throw new FormatException(); + } + } + /** + * See ISO 18004:2006, 6.4.4 Table 5 + */ + DecodedBitStreamParser$1.ALPHANUMERIC_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:'; + DecodedBitStreamParser$1.GB2312_SUBSET = 1; + // function Uint8ArrayToString(a: Uint8Array): string { + // const CHUNK_SZ = 0x8000; + // const c = new StringBuilder(); + // for (let i = 0, length = a.length; i < length; i += CHUNK_SZ) { + // c.append(String.fromCharCode.apply(null, a.subarray(i, i + CHUNK_SZ))); + // } + // return c.toString(); + // } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Meta-data container for QR Code decoding. Instances of this class may be used to convey information back to the + * decoding caller. Callers are expected to process this. + * + * @see com.google.zxing.common.DecoderResult#getOther() + */ + class QRCodeDecoderMetaData { + constructor(mirrored) { + this.mirrored = mirrored; + } + /** + * @return true if the QR Code was mirrored. + */ + isMirrored() { + return this.mirrored; + } + /** + * Apply the result points' order correction due to mirroring. + * + * @param points Array of points to apply mirror correction to. + */ + applyMirroredCorrection(points) { + if (!this.mirrored || points === null || points.length < 3) { + return; + } + const bottomLeft = points[0]; + points[0] = points[2]; + points[2] = bottomLeft; + // No need to 'fix' top-left and alignment pattern. + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.Map;*/ + /** + *

The main class which implements QR Code decoding -- as opposed to locating and extracting + * the QR Code from an image.

+ * + * @author Sean Owen + */ + class Decoder$2 { + constructor() { + this.rsDecoder = new ReedSolomonDecoder(GenericGF.QR_CODE_FIELD_256); + } + // public decode(image: boolean[][]): DecoderResult /*throws ChecksumException, FormatException*/ { + // return decode(image, null) + // } + /** + *

Convenience method that can decode a QR Code represented as a 2D array of booleans. + * "true" is taken to mean a black module.

+ * + * @param image booleans representing white/black QR Code modules + * @param hints decoding hints that should be used to influence decoding + * @return text and bytes encoded within the QR Code + * @throws FormatException if the QR Code cannot be decoded + * @throws ChecksumException if error correction fails + */ + decodeBooleanArray(image, hints) { + return this.decodeBitMatrix(BitMatrix.parseFromBooleanArray(image), hints); + } + // public decodeBitMatrix(bits: BitMatrix): DecoderResult /*throws ChecksumException, FormatException*/ { + // return decode(bits, null) + // } + /** + *

Decodes a QR Code represented as a {@link BitMatrix}. A 1 or "true" is taken to mean a black module.

+ * + * @param bits booleans representing white/black QR Code modules + * @param hints decoding hints that should be used to influence decoding + * @return text and bytes encoded within the QR Code + * @throws FormatException if the QR Code cannot be decoded + * @throws ChecksumException if error correction fails + */ + decodeBitMatrix(bits, hints) { + // Construct a parser and read version, error-correction level + const parser = new BitMatrixParser$1(bits); + let ex = null; + try { + return this.decodeBitMatrixParser(parser, hints); + } + catch (e /*: FormatException, ChecksumException*/) { + ex = e; + } + try { + // Revert the bit matrix + parser.remask(); + // Will be attempting a mirrored reading of the version and format info. + parser.setMirror(true); + // Preemptively read the version. + parser.readVersion(); + // Preemptively read the format information. + parser.readFormatInformation(); + /* + * Since we're here, this means we have successfully detected some kind + * of version and format information when mirrored. This is a good sign, + * that the QR code may be mirrored, and we should try once more with a + * mirrored content. + */ + // Prepare for a mirrored reading. + parser.mirror(); + const result = this.decodeBitMatrixParser(parser, hints); + // Success! Notify the caller that the code was mirrored. + result.setOther(new QRCodeDecoderMetaData(true)); + return result; + } + catch (e /*FormatException | ChecksumException*/) { + // Throw the exception from the original reading + if (ex !== null) { + throw ex; + } + throw e; + } + } + decodeBitMatrixParser(parser, hints) { + const version = parser.readVersion(); + const ecLevel = parser.readFormatInformation().getErrorCorrectionLevel(); + // Read codewords + const codewords = parser.readCodewords(); + // Separate into data blocks + const dataBlocks = DataBlock$1.getDataBlocks(codewords, version, ecLevel); + // Count total number of data bytes + let totalBytes = 0; + for (const dataBlock of dataBlocks) { + totalBytes += dataBlock.getNumDataCodewords(); + } + const resultBytes = new Uint8Array(totalBytes); + let resultOffset = 0; + // Error-correct and copy data blocks together into a stream of bytes + for (const dataBlock of dataBlocks) { + const codewordBytes = dataBlock.getCodewords(); + const numDataCodewords = dataBlock.getNumDataCodewords(); + this.correctErrors(codewordBytes, numDataCodewords); + for (let i = 0; i < numDataCodewords; i++) { + resultBytes[resultOffset++] = codewordBytes[i]; + } + } + // Decode the contents of that stream of bytes + return DecodedBitStreamParser$1.decode(resultBytes, version, ecLevel, hints); + } + /** + *

Given data and error-correction codewords received, possibly corrupted by errors, attempts to + * correct the errors in-place using Reed-Solomon error correction.

+ * + * @param codewordBytes data and error correction codewords + * @param numDataCodewords number of codewords that are data bytes + * @throws ChecksumException if error correction fails + */ + correctErrors(codewordBytes, numDataCodewords /*int*/) { + // const numCodewords = codewordBytes.length; + // First read into an array of ints + const codewordsInts = new Int32Array(codewordBytes); + // TYPESCRIPTPORT: not realy necessary to transform to ints? could redesign everything to work with unsigned bytes? + // const codewordsInts = new Int32Array(numCodewords) + // for (let i = 0; i < numCodewords; i++) { + // codewordsInts[i] = codewordBytes[i] & 0xFF + // } + try { + this.rsDecoder.decode(codewordsInts, codewordBytes.length - numDataCodewords); + } + catch (ignored /*: ReedSolomonException*/) { + throw new ChecksumException(); + } + // Copy back into array of bytes -- only need to worry about the bytes that were data + // We don't care about errors in the error-correction codewords + for (let i = 0; i < numDataCodewords; i++) { + codewordBytes[i] = /*(byte) */ codewordsInts[i]; + } + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates an alignment pattern, which are the smaller square patterns found in + * all but the simplest QR Codes.

+ * + * @author Sean Owen + */ + class AlignmentPattern extends ResultPoint { + constructor(posX /*float*/, posY /*float*/, estimatedModuleSize /*float*/) { + super(posX, posY); + this.estimatedModuleSize = estimatedModuleSize; + } + /** + *

Determines if this alignment pattern "about equals" an alignment pattern at the stated + * position and size -- meaning, it is at nearly the same center with nearly the same size.

+ */ + aboutEquals(moduleSize /*float*/, i /*float*/, j /*float*/) { + if (Math.abs(i - this.getY()) <= moduleSize && Math.abs(j - this.getX()) <= moduleSize) { + const moduleSizeDiff = Math.abs(moduleSize - this.estimatedModuleSize); + return moduleSizeDiff <= 1.0 || moduleSizeDiff <= this.estimatedModuleSize; + } + return false; + } + /** + * Combines this object's current estimate of a finder pattern position and module size + * with a new estimate. It returns a new {@code FinderPattern} containing an average of the two. + */ + combineEstimate(i /*float*/, j /*float*/, newModuleSize /*float*/) { + const combinedX = (this.getX() + j) / 2.0; + const combinedY = (this.getY() + i) / 2.0; + const combinedModuleSize = (this.estimatedModuleSize + newModuleSize) / 2.0; + return new AlignmentPattern(combinedX, combinedY, combinedModuleSize); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.ArrayList;*/ + /*import java.util.List;*/ + /** + *

This class attempts to find alignment patterns in a QR Code. Alignment patterns look like finder + * patterns but are smaller and appear at regular intervals throughout the image.

+ * + *

At the moment this only looks for the bottom-right alignment pattern.

+ * + *

This is mostly a simplified copy of {@link FinderPatternFinder}. It is copied, + * pasted and stripped down here for maximum performance but does unfortunately duplicate + * some code.

+ * + *

This class is thread-safe but not reentrant. Each thread must allocate its own object.

+ * + * @author Sean Owen + */ + class AlignmentPatternFinder { + /** + *

Creates a finder that will look in a portion of the whole image.

+ * + * @param image image to search + * @param startX left column from which to start searching + * @param startY top row from which to start searching + * @param width width of region to search + * @param height height of region to search + * @param moduleSize estimated module size so far + */ + constructor(image, startX /*int*/, startY /*int*/, width /*int*/, height /*int*/, moduleSize /*float*/, resultPointCallback) { + this.image = image; + this.startX = startX; + this.startY = startY; + this.width = width; + this.height = height; + this.moduleSize = moduleSize; + this.resultPointCallback = resultPointCallback; + this.possibleCenters = []; // new Array(5)) + // TYPESCRIPTPORT: array initialization without size as the length is checked below + this.crossCheckStateCount = new Int32Array(3); + } + /** + *

This method attempts to find the bottom-right alignment pattern in the image. It is a bit messy since + * it's pretty performance-critical and so is written to be fast foremost.

+ * + * @return {@link AlignmentPattern} if found + * @throws NotFoundException if not found + */ + find() { + const startX = this.startX; + const height = this.height; + const width = this.width; + const maxJ = startX + width; + const middleI = this.startY + (height / 2); + // We are looking for black/white/black modules in 1:1:1 ratio + // this tracks the number of black/white/black modules seen so far + const stateCount = new Int32Array(3); + const image = this.image; + for (let iGen = 0; iGen < height; iGen++) { + // Search from middle outwards + const i = middleI + ((iGen & 0x01) === 0 ? Math.floor((iGen + 1) / 2) : -Math.floor((iGen + 1) / 2)); + stateCount[0] = 0; + stateCount[1] = 0; + stateCount[2] = 0; + let j = startX; + // Burn off leading white pixels before anything else; if we start in the middle of + // a white run, it doesn't make sense to count its length, since we don't know if the + // white run continued to the left of the start point + while (j < maxJ && !image.get(j, i)) { + j++; + } + let currentState = 0; + while (j < maxJ) { + if (image.get(j, i)) { + // Black pixel + if (currentState === 1) { // Counting black pixels + stateCount[1]++; + } + else { // Counting white pixels + if (currentState === 2) { // A winner? + if (this.foundPatternCross(stateCount)) { // Yes + const confirmed = this.handlePossibleCenter(stateCount, i, j); + if (confirmed !== null) { + return confirmed; + } + } + stateCount[0] = stateCount[2]; + stateCount[1] = 1; + stateCount[2] = 0; + currentState = 1; + } + else { + stateCount[++currentState]++; + } + } + } + else { // White pixel + if (currentState === 1) { // Counting black pixels + currentState++; + } + stateCount[currentState]++; + } + j++; + } + if (this.foundPatternCross(stateCount)) { + const confirmed = this.handlePossibleCenter(stateCount, i, maxJ); + if (confirmed !== null) { + return confirmed; + } + } + } + // Hmm, nothing we saw was observed and confirmed twice. If we had + // any guess at all, return it. + if (this.possibleCenters.length !== 0) { + return this.possibleCenters[0]; + } + throw new NotFoundException(); + } + /** + * Given a count of black/white/black pixels just seen and an end position, + * figures the location of the center of this black/white/black run. + */ + static centerFromEnd(stateCount, end /*int*/) { + return (end - stateCount[2]) - stateCount[1] / 2.0; + } + /** + * @param stateCount count of black/white/black pixels just read + * @return true iff the proportions of the counts is close enough to the 1/1/1 ratios + * used by alignment patterns to be considered a match + */ + foundPatternCross(stateCount) { + const moduleSize = this.moduleSize; + const maxVariance = moduleSize / 2.0; + for (let i = 0; i < 3; i++) { + if (Math.abs(moduleSize - stateCount[i]) >= maxVariance) { + return false; + } + } + return true; + } + /** + *

After a horizontal scan finds a potential alignment pattern, this method + * "cross-checks" by scanning down vertically through the center of the possible + * alignment pattern to see if the same proportion is detected.

+ * + * @param startI row where an alignment pattern was detected + * @param centerJ center of the section that appears to cross an alignment pattern + * @param maxCount maximum reasonable number of modules that should be + * observed in any reading state, based on the results of the horizontal scan + * @return vertical center of alignment pattern, or {@link Float#NaN} if not found + */ + crossCheckVertical(startI /*int*/, centerJ /*int*/, maxCount /*int*/, originalStateCountTotal /*int*/) { + const image = this.image; + const maxI = image.getHeight(); + const stateCount = this.crossCheckStateCount; + stateCount[0] = 0; + stateCount[1] = 0; + stateCount[2] = 0; + // Start counting up from center + let i = startI; + while (i >= 0 && image.get(centerJ, i) && stateCount[1] <= maxCount) { + stateCount[1]++; + i--; + } + // If already too many modules in this state or ran off the edge: + if (i < 0 || stateCount[1] > maxCount) { + return NaN; + } + while (i >= 0 && !image.get(centerJ, i) && stateCount[0] <= maxCount) { + stateCount[0]++; + i--; + } + if (stateCount[0] > maxCount) { + return NaN; + } + // Now also count down from center + i = startI + 1; + while (i < maxI && image.get(centerJ, i) && stateCount[1] <= maxCount) { + stateCount[1]++; + i++; + } + if (i === maxI || stateCount[1] > maxCount) { + return NaN; + } + while (i < maxI && !image.get(centerJ, i) && stateCount[2] <= maxCount) { + stateCount[2]++; + i++; + } + if (stateCount[2] > maxCount) { + return NaN; + } + const stateCountTotal = stateCount[0] + stateCount[1] + stateCount[2]; + if (5 * Math.abs(stateCountTotal - originalStateCountTotal) >= 2 * originalStateCountTotal) { + return NaN; + } + return this.foundPatternCross(stateCount) ? AlignmentPatternFinder.centerFromEnd(stateCount, i) : NaN; + } + /** + *

This is called when a horizontal scan finds a possible alignment pattern. It will + * cross check with a vertical scan, and if successful, will see if this pattern had been + * found on a previous horizontal scan. If so, we consider it confirmed and conclude we have + * found the alignment pattern.

+ * + * @param stateCount reading state module counts from horizontal scan + * @param i row where alignment pattern may be found + * @param j end of possible alignment pattern in row + * @return {@link AlignmentPattern} if we have found the same pattern twice, or null if not + */ + handlePossibleCenter(stateCount, i /*int*/, j /*int*/) { + const stateCountTotal = stateCount[0] + stateCount[1] + stateCount[2]; + const centerJ = AlignmentPatternFinder.centerFromEnd(stateCount, j); + const centerI = this.crossCheckVertical(i, /*(int) */ centerJ, 2 * stateCount[1], stateCountTotal); + if (!isNaN(centerI)) { + const estimatedModuleSize = (stateCount[0] + stateCount[1] + stateCount[2]) / 3.0; + for (const center of this.possibleCenters) { + // Look for about the same center and module size: + if (center.aboutEquals(estimatedModuleSize, centerI, centerJ)) { + return center.combineEstimate(centerI, centerJ, estimatedModuleSize); + } + } + // Hadn't found this before; save it + const point = new AlignmentPattern(centerJ, centerI, estimatedModuleSize); + this.possibleCenters.push(point); + if (this.resultPointCallback !== null && this.resultPointCallback !== undefined) { + this.resultPointCallback.foundPossibleResultPoint(point); + } + } + return null; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates a finder pattern, which are the three square patterns found in + * the corners of QR Codes. It also encapsulates a count of similar finder patterns, + * as a convenience to the finder's bookkeeping.

+ * + * @author Sean Owen + */ + class FinderPattern$1 extends ResultPoint { + // FinderPattern(posX: number/*float*/, posY: number/*float*/, estimatedModuleSize: number/*float*/) { + // this(posX, posY, estimatedModuleSize, 1) + // } + constructor(posX /*float*/, posY /*float*/, estimatedModuleSize /*float*/, count /*int*/) { + super(posX, posY); + this.estimatedModuleSize = estimatedModuleSize; + this.count = count; + if (undefined === count) { + this.count = 1; + } + } + getEstimatedModuleSize() { + return this.estimatedModuleSize; + } + getCount() { + return this.count; + } + /* + void incrementCount() { + this.count++ + } + */ + /** + *

Determines if this finder pattern "about equals" a finder pattern at the stated + * position and size -- meaning, it is at nearly the same center with nearly the same size.

+ */ + aboutEquals(moduleSize /*float*/, i /*float*/, j /*float*/) { + if (Math.abs(i - this.getY()) <= moduleSize && Math.abs(j - this.getX()) <= moduleSize) { + const moduleSizeDiff = Math.abs(moduleSize - this.estimatedModuleSize); + return moduleSizeDiff <= 1.0 || moduleSizeDiff <= this.estimatedModuleSize; + } + return false; + } + /** + * Combines this object's current estimate of a finder pattern position and module size + * with a new estimate. It returns a new {@code FinderPattern} containing a weighted average + * based on count. + */ + combineEstimate(i /*float*/, j /*float*/, newModuleSize /*float*/) { + const combinedCount = this.count + 1; + const combinedX = (this.count * this.getX() + j) / combinedCount; + const combinedY = (this.count * this.getY() + i) / combinedCount; + const combinedModuleSize = (this.count * this.estimatedModuleSize + newModuleSize) / combinedCount; + return new FinderPattern$1(combinedX, combinedY, combinedModuleSize, combinedCount); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Encapsulates information about finder patterns in an image, including the location of + * the three finder patterns, and their estimated module size.

+ * + * @author Sean Owen + */ + class FinderPatternInfo { + constructor(patternCenters) { + this.bottomLeft = patternCenters[0]; + this.topLeft = patternCenters[1]; + this.topRight = patternCenters[2]; + } + getBottomLeft() { + return this.bottomLeft; + } + getTopLeft() { + return this.topLeft; + } + getTopRight() { + return this.topRight; + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.io.Serializable;*/ + /*import java.util.ArrayList;*/ + /*import java.util.Collections;*/ + /*import java.util.Comparator;*/ + /*import java.util.List;*/ + /*import java.util.Map;*/ + /** + *

This class attempts to find finder patterns in a QR Code. Finder patterns are the square + * markers at three corners of a QR Code.

+ * + *

This class is thread-safe but not reentrant. Each thread must allocate its own object. + * + * @author Sean Owen + */ + class FinderPatternFinder { + /** + *

Creates a finder that will search the image for three finder patterns.

+ * + * @param image image to search + */ + // public constructor(image: BitMatrix) { + // this(image, null) + // } + constructor(image, resultPointCallback) { + this.image = image; + this.resultPointCallback = resultPointCallback; + this.possibleCenters = []; + this.crossCheckStateCount = new Int32Array(5); + this.resultPointCallback = resultPointCallback; + } + getImage() { + return this.image; + } + getPossibleCenters() { + return this.possibleCenters; + } + find(hints) { + const tryHarder = (hints !== null && hints !== undefined) && undefined !== hints.get(DecodeHintType$1.TRY_HARDER); + const pureBarcode = (hints !== null && hints !== undefined) && undefined !== hints.get(DecodeHintType$1.PURE_BARCODE); + const image = this.image; + const maxI = image.getHeight(); + const maxJ = image.getWidth(); + // We are looking for black/white/black/white/black modules in + // 1:1:3:1:1 ratio; this tracks the number of such modules seen so far + // Let's assume that the maximum version QR Code we support takes up 1/4 the height of the + // image, and then account for the center being 3 modules in size. This gives the smallest + // number of pixels the center could be, so skip this often. When trying harder, look for all + // QR versions regardless of how dense they are. + let iSkip = Math.floor((3 * maxI) / (4 * FinderPatternFinder.MAX_MODULES)); + if (iSkip < FinderPatternFinder.MIN_SKIP || tryHarder) { + iSkip = FinderPatternFinder.MIN_SKIP; + } + let done = false; + const stateCount = new Int32Array(5); + for (let i = iSkip - 1; i < maxI && !done; i += iSkip) { + // Get a row of black/white values + stateCount[0] = 0; + stateCount[1] = 0; + stateCount[2] = 0; + stateCount[3] = 0; + stateCount[4] = 0; + let currentState = 0; + for (let j = 0; j < maxJ; j++) { + if (image.get(j, i)) { + // Black pixel + if ((currentState & 1) === 1) { // Counting white pixels + currentState++; + } + stateCount[currentState]++; + } + else { // White pixel + if ((currentState & 1) === 0) { // Counting black pixels + if (currentState === 4) { // A winner? + if (FinderPatternFinder.foundPatternCross(stateCount)) { // Yes + const confirmed = this.handlePossibleCenter(stateCount, i, j, pureBarcode); + if (confirmed === true) { + // Start examining every other line. Checking each line turned out to be too + // expensive and didn't improve performance. + iSkip = 2; + if (this.hasSkipped === true) { + done = this.haveMultiplyConfirmedCenters(); + } + else { + const rowSkip = this.findRowSkip(); + if (rowSkip > stateCount[2]) { + // Skip rows between row of lower confirmed center + // and top of presumed third confirmed center + // but back up a bit to get a full chance of detecting + // it, entire width of center of finder pattern + // Skip by rowSkip, but back off by stateCount[2] (size of last center + // of pattern we saw) to be conservative, and also back off by iSkip which + // is about to be re-added + i += rowSkip - stateCount[2] - iSkip; + j = maxJ - 1; + } + } + } + else { + stateCount[0] = stateCount[2]; + stateCount[1] = stateCount[3]; + stateCount[2] = stateCount[4]; + stateCount[3] = 1; + stateCount[4] = 0; + currentState = 3; + continue; + } + // Clear state to start looking again + currentState = 0; + stateCount[0] = 0; + stateCount[1] = 0; + stateCount[2] = 0; + stateCount[3] = 0; + stateCount[4] = 0; + } + else { // No, shift counts back by two + stateCount[0] = stateCount[2]; + stateCount[1] = stateCount[3]; + stateCount[2] = stateCount[4]; + stateCount[3] = 1; + stateCount[4] = 0; + currentState = 3; + } + } + else { + stateCount[++currentState]++; + } + } + else { // Counting white pixels + stateCount[currentState]++; + } + } + } + if (FinderPatternFinder.foundPatternCross(stateCount)) { + const confirmed = this.handlePossibleCenter(stateCount, i, maxJ, pureBarcode); + if (confirmed === true) { + iSkip = stateCount[0]; + if (this.hasSkipped) { + // Found a third one + done = this.haveMultiplyConfirmedCenters(); + } + } + } + } + const patternInfo = this.selectBestPatterns(); + ResultPoint.orderBestPatterns(patternInfo); + return new FinderPatternInfo(patternInfo); + } + /** + * Given a count of black/white/black/white/black pixels just seen and an end position, + * figures the location of the center of this run. + */ + static centerFromEnd(stateCount, end /*int*/) { + return (end - stateCount[4] - stateCount[3]) - stateCount[2] / 2.0; + } + /** + * @param stateCount count of black/white/black/white/black pixels just read + * @return true iff the proportions of the counts is close enough to the 1/1/3/1/1 ratios + * used by finder patterns to be considered a match + */ + static foundPatternCross(stateCount) { + let totalModuleSize = 0; + for (let i = 0; i < 5; i++) { + const count = stateCount[i]; + if (count === 0) { + return false; + } + totalModuleSize += count; + } + if (totalModuleSize < 7) { + return false; + } + const moduleSize = totalModuleSize / 7.0; + const maxVariance = moduleSize / 2.0; + // Allow less than 50% variance from 1-1-3-1-1 proportions + return Math.abs(moduleSize - stateCount[0]) < maxVariance && + Math.abs(moduleSize - stateCount[1]) < maxVariance && + Math.abs(3.0 * moduleSize - stateCount[2]) < 3 * maxVariance && + Math.abs(moduleSize - stateCount[3]) < maxVariance && + Math.abs(moduleSize - stateCount[4]) < maxVariance; + } + getCrossCheckStateCount() { + const crossCheckStateCount = this.crossCheckStateCount; + crossCheckStateCount[0] = 0; + crossCheckStateCount[1] = 0; + crossCheckStateCount[2] = 0; + crossCheckStateCount[3] = 0; + crossCheckStateCount[4] = 0; + return crossCheckStateCount; + } + /** + * After a vertical and horizontal scan finds a potential finder pattern, this method + * "cross-cross-cross-checks" by scanning down diagonally through the center of the possible + * finder pattern to see if the same proportion is detected. + * + * @param startI row where a finder pattern was detected + * @param centerJ center of the section that appears to cross a finder pattern + * @param maxCount maximum reasonable number of modules that should be + * observed in any reading state, based on the results of the horizontal scan + * @param originalStateCountTotal The original state count total. + * @return true if proportions are withing expected limits + */ + crossCheckDiagonal(startI /*int*/, centerJ /*int*/, maxCount /*int*/, originalStateCountTotal /*int*/) { + const stateCount = this.getCrossCheckStateCount(); + // Start counting up, left from center finding black center mass + let i = 0; + const image = this.image; + while (startI >= i && centerJ >= i && image.get(centerJ - i, startI - i)) { + stateCount[2]++; + i++; + } + if (startI < i || centerJ < i) { + return false; + } + // Continue up, left finding white space + while (startI >= i && centerJ >= i && !image.get(centerJ - i, startI - i) && + stateCount[1] <= maxCount) { + stateCount[1]++; + i++; + } + // If already too many modules in this state or ran off the edge: + if (startI < i || centerJ < i || stateCount[1] > maxCount) { + return false; + } + // Continue up, left finding black border + while (startI >= i && centerJ >= i && image.get(centerJ - i, startI - i) && + stateCount[0] <= maxCount) { + stateCount[0]++; + i++; + } + if (stateCount[0] > maxCount) { + return false; + } + const maxI = image.getHeight(); + const maxJ = image.getWidth(); + // Now also count down, right from center + i = 1; + while (startI + i < maxI && centerJ + i < maxJ && image.get(centerJ + i, startI + i)) { + stateCount[2]++; + i++; + } + // Ran off the edge? + if (startI + i >= maxI || centerJ + i >= maxJ) { + return false; + } + while (startI + i < maxI && centerJ + i < maxJ && !image.get(centerJ + i, startI + i) && + stateCount[3] < maxCount) { + stateCount[3]++; + i++; + } + if (startI + i >= maxI || centerJ + i >= maxJ || stateCount[3] >= maxCount) { + return false; + } + while (startI + i < maxI && centerJ + i < maxJ && image.get(centerJ + i, startI + i) && + stateCount[4] < maxCount) { + stateCount[4]++; + i++; + } + if (stateCount[4] >= maxCount) { + return false; + } + // If we found a finder-pattern-like section, but its size is more than 100% different than + // the original, assume it's a false positive + const stateCountTotal = stateCount[0] + stateCount[1] + stateCount[2] + stateCount[3] + stateCount[4]; + return Math.abs(stateCountTotal - originalStateCountTotal) < 2 * originalStateCountTotal && + FinderPatternFinder.foundPatternCross(stateCount); + } + /** + *

After a horizontal scan finds a potential finder pattern, this method + * "cross-checks" by scanning down vertically through the center of the possible + * finder pattern to see if the same proportion is detected.

+ * + * @param startI row where a finder pattern was detected + * @param centerJ center of the section that appears to cross a finder pattern + * @param maxCount maximum reasonable number of modules that should be + * observed in any reading state, based on the results of the horizontal scan + * @return vertical center of finder pattern, or {@link Float#NaN} if not found + */ + crossCheckVertical(startI /*int*/, centerJ /*int*/, maxCount /*int*/, originalStateCountTotal /*int*/) { + const image = this.image; + const maxI = image.getHeight(); + const stateCount = this.getCrossCheckStateCount(); + // Start counting up from center + let i = startI; + while (i >= 0 && image.get(centerJ, i)) { + stateCount[2]++; + i--; + } + if (i < 0) { + return NaN; + } + while (i >= 0 && !image.get(centerJ, i) && stateCount[1] <= maxCount) { + stateCount[1]++; + i--; + } + // If already too many modules in this state or ran off the edge: + if (i < 0 || stateCount[1] > maxCount) { + return NaN; + } + while (i >= 0 && image.get(centerJ, i) && stateCount[0] <= maxCount) { + stateCount[0]++; + i--; + } + if (stateCount[0] > maxCount) { + return NaN; + } + // Now also count down from center + i = startI + 1; + while (i < maxI && image.get(centerJ, i)) { + stateCount[2]++; + i++; + } + if (i === maxI) { + return NaN; + } + while (i < maxI && !image.get(centerJ, i) && stateCount[3] < maxCount) { + stateCount[3]++; + i++; + } + if (i === maxI || stateCount[3] >= maxCount) { + return NaN; + } + while (i < maxI && image.get(centerJ, i) && stateCount[4] < maxCount) { + stateCount[4]++; + i++; + } + if (stateCount[4] >= maxCount) { + return NaN; + } + // If we found a finder-pattern-like section, but its size is more than 40% different than + // the original, assume it's a false positive + const stateCountTotal = stateCount[0] + stateCount[1] + stateCount[2] + stateCount[3] + + stateCount[4]; + if (5 * Math.abs(stateCountTotal - originalStateCountTotal) >= 2 * originalStateCountTotal) { + return NaN; + } + return FinderPatternFinder.foundPatternCross(stateCount) ? FinderPatternFinder.centerFromEnd(stateCount, i) : NaN; + } + /** + *

Like {@link #crossCheckVertical(int, int, int, int)}, and in fact is basically identical, + * except it reads horizontally instead of vertically. This is used to cross-cross + * check a vertical cross check and locate the real center of the alignment pattern.

+ */ + crossCheckHorizontal(startJ /*int*/, centerI /*int*/, maxCount /*int*/, originalStateCountTotal /*int*/) { + const image = this.image; + const maxJ = image.getWidth(); + const stateCount = this.getCrossCheckStateCount(); + let j = startJ; + while (j >= 0 && image.get(j, centerI)) { + stateCount[2]++; + j--; + } + if (j < 0) { + return NaN; + } + while (j >= 0 && !image.get(j, centerI) && stateCount[1] <= maxCount) { + stateCount[1]++; + j--; + } + if (j < 0 || stateCount[1] > maxCount) { + return NaN; + } + while (j >= 0 && image.get(j, centerI) && stateCount[0] <= maxCount) { + stateCount[0]++; + j--; + } + if (stateCount[0] > maxCount) { + return NaN; + } + j = startJ + 1; + while (j < maxJ && image.get(j, centerI)) { + stateCount[2]++; + j++; + } + if (j === maxJ) { + return NaN; + } + while (j < maxJ && !image.get(j, centerI) && stateCount[3] < maxCount) { + stateCount[3]++; + j++; + } + if (j === maxJ || stateCount[3] >= maxCount) { + return NaN; + } + while (j < maxJ && image.get(j, centerI) && stateCount[4] < maxCount) { + stateCount[4]++; + j++; + } + if (stateCount[4] >= maxCount) { + return NaN; + } + // If we found a finder-pattern-like section, but its size is significantly different than + // the original, assume it's a false positive + const stateCountTotal = stateCount[0] + stateCount[1] + stateCount[2] + stateCount[3] + + stateCount[4]; + if (5 * Math.abs(stateCountTotal - originalStateCountTotal) >= originalStateCountTotal) { + return NaN; + } + return FinderPatternFinder.foundPatternCross(stateCount) ? FinderPatternFinder.centerFromEnd(stateCount, j) : NaN; + } + /** + *

This is called when a horizontal scan finds a possible alignment pattern. It will + * cross check with a vertical scan, and if successful, will, ah, cross-cross-check + * with another horizontal scan. This is needed primarily to locate the real horizontal + * center of the pattern in cases of extreme skew. + * And then we cross-cross-cross check with another diagonal scan.

+ * + *

If that succeeds the finder pattern location is added to a list that tracks + * the number of times each location has been nearly-matched as a finder pattern. + * Each additional find is more evidence that the location is in fact a finder + * pattern center + * + * @param stateCount reading state module counts from horizontal scan + * @param i row where finder pattern may be found + * @param j end of possible finder pattern in row + * @param pureBarcode true if in "pure barcode" mode + * @return true if a finder pattern candidate was found this time + */ + handlePossibleCenter(stateCount, i /*int*/, j /*int*/, pureBarcode) { + const stateCountTotal = stateCount[0] + stateCount[1] + stateCount[2] + stateCount[3] + + stateCount[4]; + let centerJ = FinderPatternFinder.centerFromEnd(stateCount, j); + let centerI = this.crossCheckVertical(i, /*(int) */ Math.floor(centerJ), stateCount[2], stateCountTotal); + if (!isNaN(centerI)) { + // Re-cross check + centerJ = this.crossCheckHorizontal(/*(int) */ Math.floor(centerJ), /*(int) */ Math.floor(centerI), stateCount[2], stateCountTotal); + if (!isNaN(centerJ) && + (!pureBarcode || this.crossCheckDiagonal(/*(int) */ Math.floor(centerI), /*(int) */ Math.floor(centerJ), stateCount[2], stateCountTotal))) { + const estimatedModuleSize = stateCountTotal / 7.0; + let found = false; + const possibleCenters = this.possibleCenters; + for (let index = 0, length = possibleCenters.length; index < length; index++) { + const center = possibleCenters[index]; + // Look for about the same center and module size: + if (center.aboutEquals(estimatedModuleSize, centerI, centerJ)) { + possibleCenters[index] = center.combineEstimate(centerI, centerJ, estimatedModuleSize); + found = true; + break; + } + } + if (!found) { + const point = new FinderPattern$1(centerJ, centerI, estimatedModuleSize); + possibleCenters.push(point); + if (this.resultPointCallback !== null && this.resultPointCallback !== undefined) { + this.resultPointCallback.foundPossibleResultPoint(point); + } + } + return true; + } + } + return false; + } + /** + * @return number of rows we could safely skip during scanning, based on the first + * two finder patterns that have been located. In some cases their position will + * allow us to infer that the third pattern must lie below a certain point farther + * down in the image. + */ + findRowSkip() { + const max = this.possibleCenters.length; + if (max <= 1) { + return 0; + } + let firstConfirmedCenter = null; + for (const center of this.possibleCenters) { + if (center.getCount() >= FinderPatternFinder.CENTER_QUORUM) { + if (firstConfirmedCenter == null) { + firstConfirmedCenter = center; + } + else { + // We have two confirmed centers + // How far down can we skip before resuming looking for the next + // pattern? In the worst case, only the difference between the + // difference in the x / y coordinates of the two centers. + // This is the case where you find top left last. + this.hasSkipped = true; + return /*(int) */ Math.floor((Math.abs(firstConfirmedCenter.getX() - center.getX()) - + Math.abs(firstConfirmedCenter.getY() - center.getY())) / 2); + } + } + } + return 0; + } + /** + * @return true iff we have found at least 3 finder patterns that have been detected + * at least {@link #CENTER_QUORUM} times each, and, the estimated module size of the + * candidates is "pretty similar" + */ + haveMultiplyConfirmedCenters() { + let confirmedCount = 0; + let totalModuleSize = 0.0; + const max = this.possibleCenters.length; + for (const pattern of this.possibleCenters) { + if (pattern.getCount() >= FinderPatternFinder.CENTER_QUORUM) { + confirmedCount++; + totalModuleSize += pattern.getEstimatedModuleSize(); + } + } + if (confirmedCount < 3) { + return false; + } + // OK, we have at least 3 confirmed centers, but, it's possible that one is a "false positive" + // and that we need to keep looking. We detect this by asking if the estimated module sizes + // vary too much. We arbitrarily say that when the total deviation from average exceeds + // 5% of the total module size estimates, it's too much. + const average = totalModuleSize / max; + let totalDeviation = 0.0; + for (const pattern of this.possibleCenters) { + totalDeviation += Math.abs(pattern.getEstimatedModuleSize() - average); + } + return totalDeviation <= 0.05 * totalModuleSize; + } + /** + * @return the 3 best {@link FinderPattern}s from our list of candidates. The "best" are + * those that have been detected at least {@link #CENTER_QUORUM} times, and whose module + * size differs from the average among those patterns the least + * @throws NotFoundException if 3 such finder patterns do not exist + */ + selectBestPatterns() { + const startSize = this.possibleCenters.length; + if (startSize < 3) { + // Couldn't find enough finder patterns + throw new NotFoundException(); + } + const possibleCenters = this.possibleCenters; + let average; + // Filter outlier possibilities whose module size is too different + if (startSize > 3) { + // But we can only afford to do so if we have at least 4 possibilities to choose from + let totalModuleSize = 0.0; + let square = 0.0; + for (const center of this.possibleCenters) { + const size = center.getEstimatedModuleSize(); + totalModuleSize += size; + square += size * size; + } + average = totalModuleSize / startSize; + let stdDev = Math.sqrt(square / startSize - average * average); + possibleCenters.sort( + /** + *

Orders by furthest from average

+ */ + // FurthestFromAverageComparator implements Comparator + (center1, center2) => { + const dA = Math.abs(center2.getEstimatedModuleSize() - average); + const dB = Math.abs(center1.getEstimatedModuleSize() - average); + return dA < dB ? -1 : dA > dB ? 1 : 0; + }); + const limit = Math.max(0.2 * average, stdDev); + for (let i = 0; i < possibleCenters.length && possibleCenters.length > 3; i++) { + const pattern = possibleCenters[i]; + if (Math.abs(pattern.getEstimatedModuleSize() - average) > limit) { + possibleCenters.splice(i, 1); + i--; + } + } + } + if (possibleCenters.length > 3) { + // Throw away all but those first size candidate points we found. + let totalModuleSize = 0.0; + for (const possibleCenter of possibleCenters) { + totalModuleSize += possibleCenter.getEstimatedModuleSize(); + } + average = totalModuleSize / possibleCenters.length; + possibleCenters.sort( + /** + *

Orders by {@link FinderPattern#getCount()}, descending.

+ */ + // CenterComparator implements Comparator + (center1, center2) => { + if (center2.getCount() === center1.getCount()) { + const dA = Math.abs(center2.getEstimatedModuleSize() - average); + const dB = Math.abs(center1.getEstimatedModuleSize() - average); + return dA < dB ? 1 : dA > dB ? -1 : 0; + } + else { + return center2.getCount() - center1.getCount(); + } + }); + possibleCenters.splice(3); // this is not realy necessary as we only return first 3 anyway + } + return [ + possibleCenters[0], + possibleCenters[1], + possibleCenters[2] + ]; + } + } + FinderPatternFinder.CENTER_QUORUM = 2; + FinderPatternFinder.MIN_SKIP = 3; // 1 pixel/module times 3 modules/center + FinderPatternFinder.MAX_MODULES = 57; // support up to version 10 for mobile clients + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.Map;*/ + /** + *

Encapsulates logic that can detect a QR Code in an image, even if the QR Code + * is rotated or skewed, or partially obscured.

+ * + * @author Sean Owen + */ + class Detector$2 { + constructor(image) { + this.image = image; + } + getImage() { + return this.image; + } + getResultPointCallback() { + return this.resultPointCallback; + } + /** + *

Detects a QR Code in an image.

+ * + * @return {@link DetectorResult} encapsulating results of detecting a QR Code + * @throws NotFoundException if QR Code cannot be found + * @throws FormatException if a QR Code cannot be decoded + */ + // public detect(): DetectorResult /*throws NotFoundException, FormatException*/ { + // return detect(null) + // } + /** + *

Detects a QR Code in an image.

+ * + * @param hints optional hints to detector + * @return {@link DetectorResult} encapsulating results of detecting a QR Code + * @throws NotFoundException if QR Code cannot be found + * @throws FormatException if a QR Code cannot be decoded + */ + detect(hints) { + this.resultPointCallback = (hints === null || hints === undefined) ? null : + /*(ResultPointCallback) */ hints.get(DecodeHintType$1.NEED_RESULT_POINT_CALLBACK); + const finder = new FinderPatternFinder(this.image, this.resultPointCallback); + const info = finder.find(hints); + return this.processFinderPatternInfo(info); + } + processFinderPatternInfo(info) { + const topLeft = info.getTopLeft(); + const topRight = info.getTopRight(); + const bottomLeft = info.getBottomLeft(); + const moduleSize = this.calculateModuleSize(topLeft, topRight, bottomLeft); + if (moduleSize < 1.0) { + throw new NotFoundException('No pattern found in proccess finder.'); + } + const dimension = Detector$2.computeDimension(topLeft, topRight, bottomLeft, moduleSize); + const provisionalVersion = Version$1.getProvisionalVersionForDimension(dimension); + const modulesBetweenFPCenters = provisionalVersion.getDimensionForVersion() - 7; + let alignmentPattern = null; + // Anything above version 1 has an alignment pattern + if (provisionalVersion.getAlignmentPatternCenters().length > 0) { + // Guess where a "bottom right" finder pattern would have been + const bottomRightX = topRight.getX() - topLeft.getX() + bottomLeft.getX(); + const bottomRightY = topRight.getY() - topLeft.getY() + bottomLeft.getY(); + // Estimate that alignment pattern is closer by 3 modules + // from "bottom right" to known top left location + const correctionToTopLeft = 1.0 - 3.0 / modulesBetweenFPCenters; + const estAlignmentX = /*(int) */ Math.floor(topLeft.getX() + correctionToTopLeft * (bottomRightX - topLeft.getX())); + const estAlignmentY = /*(int) */ Math.floor(topLeft.getY() + correctionToTopLeft * (bottomRightY - topLeft.getY())); + // Kind of arbitrary -- expand search radius before giving up + for (let i = 4; i <= 16; i <<= 1) { + try { + alignmentPattern = this.findAlignmentInRegion(moduleSize, estAlignmentX, estAlignmentY, i); + break; + } + catch (re /*NotFoundException*/) { + if (!(re instanceof NotFoundException)) { + throw re; + } + // try next round + } + } + // If we didn't find alignment pattern... well try anyway without it + } + const transform = Detector$2.createTransform(topLeft, topRight, bottomLeft, alignmentPattern, dimension); + const bits = Detector$2.sampleGrid(this.image, transform, dimension); + let points; + if (alignmentPattern === null) { + points = [bottomLeft, topLeft, topRight]; + } + else { + points = [bottomLeft, topLeft, topRight, alignmentPattern]; + } + return new DetectorResult(bits, points); + } + static createTransform(topLeft, topRight, bottomLeft, alignmentPattern, dimension /*int*/) { + const dimMinusThree = dimension - 3.5; + let bottomRightX; /*float*/ + let bottomRightY; /*float*/ + let sourceBottomRightX; /*float*/ + let sourceBottomRightY; /*float*/ + if (alignmentPattern !== null) { + bottomRightX = alignmentPattern.getX(); + bottomRightY = alignmentPattern.getY(); + sourceBottomRightX = dimMinusThree - 3.0; + sourceBottomRightY = sourceBottomRightX; + } + else { + // Don't have an alignment pattern, just make up the bottom-right point + bottomRightX = (topRight.getX() - topLeft.getX()) + bottomLeft.getX(); + bottomRightY = (topRight.getY() - topLeft.getY()) + bottomLeft.getY(); + sourceBottomRightX = dimMinusThree; + sourceBottomRightY = dimMinusThree; + } + return PerspectiveTransform.quadrilateralToQuadrilateral(3.5, 3.5, dimMinusThree, 3.5, sourceBottomRightX, sourceBottomRightY, 3.5, dimMinusThree, topLeft.getX(), topLeft.getY(), topRight.getX(), topRight.getY(), bottomRightX, bottomRightY, bottomLeft.getX(), bottomLeft.getY()); + } + static sampleGrid(image, transform, dimension /*int*/) { + const sampler = GridSamplerInstance.getInstance(); + return sampler.sampleGridWithTransform(image, dimension, dimension, transform); + } + /** + *

Computes the dimension (number of modules on a size) of the QR Code based on the position + * of the finder patterns and estimated module size.

+ */ + static computeDimension(topLeft, topRight, bottomLeft, moduleSize /*float*/) { + const tltrCentersDimension = MathUtils.round(ResultPoint.distance(topLeft, topRight) / moduleSize); + const tlblCentersDimension = MathUtils.round(ResultPoint.distance(topLeft, bottomLeft) / moduleSize); + let dimension = Math.floor((tltrCentersDimension + tlblCentersDimension) / 2) + 7; + switch (dimension & 0x03) { // mod 4 + case 0: + dimension++; + break; + // 1? do nothing + case 2: + dimension--; + break; + case 3: + throw new NotFoundException('Dimensions could be not found.'); + } + return dimension; + } + /** + *

Computes an average estimated module size based on estimated derived from the positions + * of the three finder patterns.

+ * + * @param topLeft detected top-left finder pattern center + * @param topRight detected top-right finder pattern center + * @param bottomLeft detected bottom-left finder pattern center + * @return estimated module size + */ + calculateModuleSize(topLeft, topRight, bottomLeft) { + // Take the average + return (this.calculateModuleSizeOneWay(topLeft, topRight) + + this.calculateModuleSizeOneWay(topLeft, bottomLeft)) / 2.0; + } + /** + *

Estimates module size based on two finder patterns -- it uses + * {@link #sizeOfBlackWhiteBlackRunBothWays(int, int, int, int)} to figure the + * width of each, measuring along the axis between their centers.

+ */ + calculateModuleSizeOneWay(pattern, otherPattern) { + const moduleSizeEst1 = this.sizeOfBlackWhiteBlackRunBothWays(/*(int) */ Math.floor(pattern.getX()), + /*(int) */ Math.floor(pattern.getY()), + /*(int) */ Math.floor(otherPattern.getX()), + /*(int) */ Math.floor(otherPattern.getY())); + const moduleSizeEst2 = this.sizeOfBlackWhiteBlackRunBothWays(/*(int) */ Math.floor(otherPattern.getX()), + /*(int) */ Math.floor(otherPattern.getY()), + /*(int) */ Math.floor(pattern.getX()), + /*(int) */ Math.floor(pattern.getY())); + if (isNaN(moduleSizeEst1)) { + return moduleSizeEst2 / 7.0; + } + if (isNaN(moduleSizeEst2)) { + return moduleSizeEst1 / 7.0; + } + // Average them, and divide by 7 since we've counted the width of 3 black modules, + // and 1 white and 1 black module on either side. Ergo, divide sum by 14. + return (moduleSizeEst1 + moduleSizeEst2) / 14.0; + } + /** + * See {@link #sizeOfBlackWhiteBlackRun(int, int, int, int)}; computes the total width of + * a finder pattern by looking for a black-white-black run from the center in the direction + * of another point (another finder pattern center), and in the opposite direction too. + */ + sizeOfBlackWhiteBlackRunBothWays(fromX /*int*/, fromY /*int*/, toX /*int*/, toY /*int*/) { + let result = this.sizeOfBlackWhiteBlackRun(fromX, fromY, toX, toY); + // Now count other way -- don't run off image though of course + let scale = 1.0; + let otherToX = fromX - (toX - fromX); + if (otherToX < 0) { + scale = fromX / /*(float) */ (fromX - otherToX); + otherToX = 0; + } + else if (otherToX >= this.image.getWidth()) { + scale = (this.image.getWidth() - 1 - fromX) / /*(float) */ (otherToX - fromX); + otherToX = this.image.getWidth() - 1; + } + let otherToY = /*(int) */ Math.floor(fromY - (toY - fromY) * scale); + scale = 1.0; + if (otherToY < 0) { + scale = fromY / /*(float) */ (fromY - otherToY); + otherToY = 0; + } + else if (otherToY >= this.image.getHeight()) { + scale = (this.image.getHeight() - 1 - fromY) / /*(float) */ (otherToY - fromY); + otherToY = this.image.getHeight() - 1; + } + otherToX = /*(int) */ Math.floor(fromX + (otherToX - fromX) * scale); + result += this.sizeOfBlackWhiteBlackRun(fromX, fromY, otherToX, otherToY); + // Middle pixel is double-counted this way; subtract 1 + return result - 1.0; + } + /** + *

This method traces a line from a point in the image, in the direction towards another point. + * It begins in a black region, and keeps going until it finds white, then black, then white again. + * It reports the distance from the start to this point.

+ * + *

This is used when figuring out how wide a finder pattern is, when the finder pattern + * may be skewed or rotated.

+ */ + sizeOfBlackWhiteBlackRun(fromX /*int*/, fromY /*int*/, toX /*int*/, toY /*int*/) { + // Mild variant of Bresenham's algorithm + // see http://en.wikipedia.org/wiki/Bresenham's_line_algorithm + const steep = Math.abs(toY - fromY) > Math.abs(toX - fromX); + if (steep) { + let temp = fromX; + fromX = fromY; + fromY = temp; + temp = toX; + toX = toY; + toY = temp; + } + const dx = Math.abs(toX - fromX); + const dy = Math.abs(toY - fromY); + let error = -dx / 2; + const xstep = fromX < toX ? 1 : -1; + const ystep = fromY < toY ? 1 : -1; + // In black pixels, looking for white, first or second time. + let state = 0; + // Loop up until x == toX, but not beyond + const xLimit = toX + xstep; + for (let x = fromX, y = fromY; x !== xLimit; x += xstep) { + const realX = steep ? y : x; + const realY = steep ? x : y; + // Does current pixel mean we have moved white to black or vice versa? + // Scanning black in state 0,2 and white in state 1, so if we find the wrong + // color, advance to next state or end if we are in state 2 already + if ((state === 1) === this.image.get(realX, realY)) { + if (state === 2) { + return MathUtils.distance(x, y, fromX, fromY); + } + state++; + } + error += dy; + if (error > 0) { + if (y === toY) { + break; + } + y += ystep; + error -= dx; + } + } + // Found black-white-black; give the benefit of the doubt that the next pixel outside the image + // is "white" so this last point at (toX+xStep,toY) is the right ending. This is really a + // small approximation; (toX+xStep,toY+yStep) might be really correct. Ignore this. + if (state === 2) { + return MathUtils.distance(toX + xstep, toY, fromX, fromY); + } + // else we didn't find even black-white-black; no estimate is really possible + return NaN; + } + /** + *

Attempts to locate an alignment pattern in a limited region of the image, which is + * guessed to contain it. This method uses {@link AlignmentPattern}.

+ * + * @param overallEstModuleSize estimated module size so far + * @param estAlignmentX x coordinate of center of area probably containing alignment pattern + * @param estAlignmentY y coordinate of above + * @param allowanceFactor number of pixels in all directions to search from the center + * @return {@link AlignmentPattern} if found, or null otherwise + * @throws NotFoundException if an unexpected error occurs during detection + */ + findAlignmentInRegion(overallEstModuleSize /*float*/, estAlignmentX /*int*/, estAlignmentY /*int*/, allowanceFactor /*float*/) { + // Look for an alignment pattern (3 modules in size) around where it + // should be + const allowance = /*(int) */ Math.floor(allowanceFactor * overallEstModuleSize); + const alignmentAreaLeftX = Math.max(0, estAlignmentX - allowance); + const alignmentAreaRightX = Math.min(this.image.getWidth() - 1, estAlignmentX + allowance); + if (alignmentAreaRightX - alignmentAreaLeftX < overallEstModuleSize * 3) { + throw new NotFoundException('Alignment top exceeds estimated module size.'); + } + const alignmentAreaTopY = Math.max(0, estAlignmentY - allowance); + const alignmentAreaBottomY = Math.min(this.image.getHeight() - 1, estAlignmentY + allowance); + if (alignmentAreaBottomY - alignmentAreaTopY < overallEstModuleSize * 3) { + throw new NotFoundException('Alignment bottom exceeds estimated module size.'); + } + const alignmentFinder = new AlignmentPatternFinder(this.image, alignmentAreaLeftX, alignmentAreaTopY, alignmentAreaRightX - alignmentAreaLeftX, alignmentAreaBottomY - alignmentAreaTopY, overallEstModuleSize, this.resultPointCallback); + return alignmentFinder.find(); + } + } + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.List;*/ + /*import java.util.Map;*/ + /** + * This implementation can detect and decode QR Codes in an image. + * + * @author Sean Owen + */ + class QRCodeReader { + constructor() { + this.decoder = new Decoder$2(); + } + getDecoder() { + return this.decoder; + } + /** + * Locates and decodes a QR code in an image. + * + * @return a representing: string the content encoded by the QR code + * @throws NotFoundException if a QR code cannot be found + * @throws FormatException if a QR code cannot be decoded + * @throws ChecksumException if error correction fails + */ + /*@Override*/ + // public decode(image: BinaryBitmap): Result /*throws NotFoundException, ChecksumException, FormatException */ { + // return this.decode(image, null) + // } + /*@Override*/ + decode(image, hints) { + let decoderResult; + let points; + if (hints !== undefined && hints !== null && undefined !== hints.get(DecodeHintType$1.PURE_BARCODE)) { + const bits = QRCodeReader.extractPureBits(image.getBlackMatrix()); + decoderResult = this.decoder.decodeBitMatrix(bits, hints); + points = QRCodeReader.NO_POINTS; + } + else { + const detectorResult = new Detector$2(image.getBlackMatrix()).detect(hints); + decoderResult = this.decoder.decodeBitMatrix(detectorResult.getBits(), hints); + points = detectorResult.getPoints(); + } + // If the code was mirrored: swap the bottom-left and the top-right points. + if (decoderResult.getOther() instanceof QRCodeDecoderMetaData) { + decoderResult.getOther().applyMirroredCorrection(points); + } + const result = new Result(decoderResult.getText(), decoderResult.getRawBytes(), undefined, points, BarcodeFormat$1.QR_CODE, undefined); + const byteSegments = decoderResult.getByteSegments(); + if (byteSegments !== null) { + result.putMetadata(ResultMetadataType$1.BYTE_SEGMENTS, byteSegments); + } + const ecLevel = decoderResult.getECLevel(); + if (ecLevel !== null) { + result.putMetadata(ResultMetadataType$1.ERROR_CORRECTION_LEVEL, ecLevel); + } + if (decoderResult.hasStructuredAppend()) { + result.putMetadata(ResultMetadataType$1.STRUCTURED_APPEND_SEQUENCE, decoderResult.getStructuredAppendSequenceNumber()); + result.putMetadata(ResultMetadataType$1.STRUCTURED_APPEND_PARITY, decoderResult.getStructuredAppendParity()); + } + return result; + } + /*@Override*/ + reset() { + // do nothing + } + /** + * This method detects a code in a "pure" image -- that is, pure monochrome image + * which contains only an unrotated, unskewed, image of a code, with some white border + * around it. This is a specialized method that works exceptionally fast in this special + * case. + * + * @see com.google.zxing.datamatrix.DataMatrixReader#extractPureBits(BitMatrix) + */ + static extractPureBits(image) { + const leftTopBlack = image.getTopLeftOnBit(); + const rightBottomBlack = image.getBottomRightOnBit(); + if (leftTopBlack === null || rightBottomBlack === null) { + throw new NotFoundException(); + } + const moduleSize = this.moduleSize(leftTopBlack, image); + let top = leftTopBlack[1]; + let bottom = rightBottomBlack[1]; + let left = leftTopBlack[0]; + let right = rightBottomBlack[0]; + // Sanity check! + if (left >= right || top >= bottom) { + throw new NotFoundException(); + } + if (bottom - top !== right - left) { + // Special case, where bottom-right module wasn't black so we found something else in the last row + // Assume it's a square, so use height as the width + right = left + (bottom - top); + if (right >= image.getWidth()) { + // Abort if that would not make sense -- off image + throw new NotFoundException(); + } + } + const matrixWidth = Math.round((right - left + 1) / moduleSize); + const matrixHeight = Math.round((bottom - top + 1) / moduleSize); + if (matrixWidth <= 0 || matrixHeight <= 0) { + throw new NotFoundException(); + } + if (matrixHeight !== matrixWidth) { + // Only possibly decode square regions + throw new NotFoundException(); + } + // Push in the "border" by half the module width so that we start + // sampling in the middle of the module. Just in case the image is a + // little off, this will help recover. + const nudge = /*(int) */ Math.floor(moduleSize / 2.0); + top += nudge; + left += nudge; + // But careful that this does not sample off the edge + // "right" is the farthest-right valid pixel location -- right+1 is not necessarily + // This is positive by how much the inner x loop below would be too large + const nudgedTooFarRight = left + /*(int) */ Math.floor((matrixWidth - 1) * moduleSize) - right; + if (nudgedTooFarRight > 0) { + if (nudgedTooFarRight > nudge) { + // Neither way fits; abort + throw new NotFoundException(); + } + left -= nudgedTooFarRight; + } + // See logic above + const nudgedTooFarDown = top + /*(int) */ Math.floor((matrixHeight - 1) * moduleSize) - bottom; + if (nudgedTooFarDown > 0) { + if (nudgedTooFarDown > nudge) { + // Neither way fits; abort + throw new NotFoundException(); + } + top -= nudgedTooFarDown; + } + // Now just read off the bits + const bits = new BitMatrix(matrixWidth, matrixHeight); + for (let y = 0; y < matrixHeight; y++) { + const iOffset = top + /*(int) */ Math.floor(y * moduleSize); + for (let x = 0; x < matrixWidth; x++) { + if (image.get(left + /*(int) */ Math.floor(x * moduleSize), iOffset)) { + bits.set(x, y); + } + } + } + return bits; + } + static moduleSize(leftTopBlack, image) { + const height = image.getHeight(); + const width = image.getWidth(); + let x = leftTopBlack[0]; + let y = leftTopBlack[1]; + let inBlack = true; + let transitions = 0; + while (x < width && y < height) { + if (inBlack !== image.get(x, y)) { + if (++transitions === 5) { + break; + } + inBlack = !inBlack; + } + x++; + y++; + } + if (x === width || y === height) { + throw new NotFoundException(); + } + return (x - leftTopBlack[0]) / 7.0; + } + } + QRCodeReader.NO_POINTS = new Array(); + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author SITA Lab (kevin.osullivan@sita.aero) + * @author Guenther Grau + */ + /*public final*/ class PDF417Common { + PDF417Common() { + } + /** + * @param moduleBitCount values to sum + * @return sum of values + * @deprecated call {@link MathUtils#sum(int[])} + */ + // @Deprecated + static getBitCountSum(moduleBitCount) { + return MathUtils.sum(moduleBitCount); + } + static toIntArray(list) { + if (list == null || !list.length) { + return PDF417Common.EMPTY_INT_ARRAY; + } + const result = new Int32Array(list.length); + let i = 0; + for (const integer of list) { + result[i++] = integer; + } + return result; + } + /** + * @param symbol encoded symbol to translate to a codeword + * @return the codeword corresponding to the symbol. + */ + static getCodeword(symbol /*int*/) { + const i = Arrays.binarySearch(PDF417Common.SYMBOL_TABLE, symbol & 0x3FFFF); + if (i < 0) { + return -1; + } + return (PDF417Common.CODEWORD_TABLE[i] - 1) % PDF417Common.NUMBER_OF_CODEWORDS; + } + } + PDF417Common.NUMBER_OF_CODEWORDS = 929; + // Maximum Codewords (Data + Error). + PDF417Common.MAX_CODEWORDS_IN_BARCODE = PDF417Common.NUMBER_OF_CODEWORDS - 1; + PDF417Common.MIN_ROWS_IN_BARCODE = 3; + PDF417Common.MAX_ROWS_IN_BARCODE = 90; + // One left row indication column + max 30 data columns + one right row indicator column + // public static /*final*/ MAX_CODEWORDS_IN_ROW: /*int*/ number = 32; + PDF417Common.MODULES_IN_CODEWORD = 17; + PDF417Common.MODULES_IN_STOP_PATTERN = 18; + PDF417Common.BARS_IN_MODULE = 8; + PDF417Common.EMPTY_INT_ARRAY = new Int32Array([]); + /** + * The sorted table of all possible symbols. Extracted from the PDF417 + * specification. The index of a symbol in this table corresponds to the + * index into the codeword table. + */ + PDF417Common.SYMBOL_TABLE = Int32Array.from([ + 0x1025e, 0x1027a, 0x1029e, 0x102bc, 0x102f2, 0x102f4, 0x1032e, 0x1034e, 0x1035c, 0x10396, 0x103a6, 0x103ac, + 0x10422, 0x10428, 0x10436, 0x10442, 0x10444, 0x10448, 0x10450, 0x1045e, 0x10466, 0x1046c, 0x1047a, 0x10482, + 0x1049e, 0x104a0, 0x104bc, 0x104c6, 0x104d8, 0x104ee, 0x104f2, 0x104f4, 0x10504, 0x10508, 0x10510, 0x1051e, + 0x10520, 0x1053c, 0x10540, 0x10578, 0x10586, 0x1058c, 0x10598, 0x105b0, 0x105be, 0x105ce, 0x105dc, 0x105e2, + 0x105e4, 0x105e8, 0x105f6, 0x1062e, 0x1064e, 0x1065c, 0x1068e, 0x1069c, 0x106b8, 0x106de, 0x106fa, 0x10716, + 0x10726, 0x1072c, 0x10746, 0x1074c, 0x10758, 0x1076e, 0x10792, 0x10794, 0x107a2, 0x107a4, 0x107a8, 0x107b6, + 0x10822, 0x10828, 0x10842, 0x10848, 0x10850, 0x1085e, 0x10866, 0x1086c, 0x1087a, 0x10882, 0x10884, 0x10890, + 0x1089e, 0x108a0, 0x108bc, 0x108c6, 0x108cc, 0x108d8, 0x108ee, 0x108f2, 0x108f4, 0x10902, 0x10908, 0x1091e, + 0x10920, 0x1093c, 0x10940, 0x10978, 0x10986, 0x10998, 0x109b0, 0x109be, 0x109ce, 0x109dc, 0x109e2, 0x109e4, + 0x109e8, 0x109f6, 0x10a08, 0x10a10, 0x10a1e, 0x10a20, 0x10a3c, 0x10a40, 0x10a78, 0x10af0, 0x10b06, 0x10b0c, + 0x10b18, 0x10b30, 0x10b3e, 0x10b60, 0x10b7c, 0x10b8e, 0x10b9c, 0x10bb8, 0x10bc2, 0x10bc4, 0x10bc8, 0x10bd0, + 0x10bde, 0x10be6, 0x10bec, 0x10c2e, 0x10c4e, 0x10c5c, 0x10c62, 0x10c64, 0x10c68, 0x10c76, 0x10c8e, 0x10c9c, + 0x10cb8, 0x10cc2, 0x10cc4, 0x10cc8, 0x10cd0, 0x10cde, 0x10ce6, 0x10cec, 0x10cfa, 0x10d0e, 0x10d1c, 0x10d38, + 0x10d70, 0x10d7e, 0x10d82, 0x10d84, 0x10d88, 0x10d90, 0x10d9e, 0x10da0, 0x10dbc, 0x10dc6, 0x10dcc, 0x10dd8, + 0x10dee, 0x10df2, 0x10df4, 0x10e16, 0x10e26, 0x10e2c, 0x10e46, 0x10e58, 0x10e6e, 0x10e86, 0x10e8c, 0x10e98, + 0x10eb0, 0x10ebe, 0x10ece, 0x10edc, 0x10f0a, 0x10f12, 0x10f14, 0x10f22, 0x10f28, 0x10f36, 0x10f42, 0x10f44, + 0x10f48, 0x10f50, 0x10f5e, 0x10f66, 0x10f6c, 0x10fb2, 0x10fb4, 0x11022, 0x11028, 0x11042, 0x11048, 0x11050, + 0x1105e, 0x1107a, 0x11082, 0x11084, 0x11090, 0x1109e, 0x110a0, 0x110bc, 0x110c6, 0x110cc, 0x110d8, 0x110ee, + 0x110f2, 0x110f4, 0x11102, 0x1111e, 0x11120, 0x1113c, 0x11140, 0x11178, 0x11186, 0x11198, 0x111b0, 0x111be, + 0x111ce, 0x111dc, 0x111e2, 0x111e4, 0x111e8, 0x111f6, 0x11208, 0x1121e, 0x11220, 0x11278, 0x112f0, 0x1130c, + 0x11330, 0x1133e, 0x11360, 0x1137c, 0x1138e, 0x1139c, 0x113b8, 0x113c2, 0x113c8, 0x113d0, 0x113de, 0x113e6, + 0x113ec, 0x11408, 0x11410, 0x1141e, 0x11420, 0x1143c, 0x11440, 0x11478, 0x114f0, 0x115e0, 0x1160c, 0x11618, + 0x11630, 0x1163e, 0x11660, 0x1167c, 0x116c0, 0x116f8, 0x1171c, 0x11738, 0x11770, 0x1177e, 0x11782, 0x11784, + 0x11788, 0x11790, 0x1179e, 0x117a0, 0x117bc, 0x117c6, 0x117cc, 0x117d8, 0x117ee, 0x1182e, 0x11834, 0x1184e, + 0x1185c, 0x11862, 0x11864, 0x11868, 0x11876, 0x1188e, 0x1189c, 0x118b8, 0x118c2, 0x118c8, 0x118d0, 0x118de, + 0x118e6, 0x118ec, 0x118fa, 0x1190e, 0x1191c, 0x11938, 0x11970, 0x1197e, 0x11982, 0x11984, 0x11990, 0x1199e, + 0x119a0, 0x119bc, 0x119c6, 0x119cc, 0x119d8, 0x119ee, 0x119f2, 0x119f4, 0x11a0e, 0x11a1c, 0x11a38, 0x11a70, + 0x11a7e, 0x11ae0, 0x11afc, 0x11b08, 0x11b10, 0x11b1e, 0x11b20, 0x11b3c, 0x11b40, 0x11b78, 0x11b8c, 0x11b98, + 0x11bb0, 0x11bbe, 0x11bce, 0x11bdc, 0x11be2, 0x11be4, 0x11be8, 0x11bf6, 0x11c16, 0x11c26, 0x11c2c, 0x11c46, + 0x11c4c, 0x11c58, 0x11c6e, 0x11c86, 0x11c98, 0x11cb0, 0x11cbe, 0x11cce, 0x11cdc, 0x11ce2, 0x11ce4, 0x11ce8, + 0x11cf6, 0x11d06, 0x11d0c, 0x11d18, 0x11d30, 0x11d3e, 0x11d60, 0x11d7c, 0x11d8e, 0x11d9c, 0x11db8, 0x11dc4, + 0x11dc8, 0x11dd0, 0x11dde, 0x11de6, 0x11dec, 0x11dfa, 0x11e0a, 0x11e12, 0x11e14, 0x11e22, 0x11e24, 0x11e28, + 0x11e36, 0x11e42, 0x11e44, 0x11e50, 0x11e5e, 0x11e66, 0x11e6c, 0x11e82, 0x11e84, 0x11e88, 0x11e90, 0x11e9e, + 0x11ea0, 0x11ebc, 0x11ec6, 0x11ecc, 0x11ed8, 0x11eee, 0x11f1a, 0x11f2e, 0x11f32, 0x11f34, 0x11f4e, 0x11f5c, + 0x11f62, 0x11f64, 0x11f68, 0x11f76, 0x12048, 0x1205e, 0x12082, 0x12084, 0x12090, 0x1209e, 0x120a0, 0x120bc, + 0x120d8, 0x120f2, 0x120f4, 0x12108, 0x1211e, 0x12120, 0x1213c, 0x12140, 0x12178, 0x12186, 0x12198, 0x121b0, + 0x121be, 0x121e2, 0x121e4, 0x121e8, 0x121f6, 0x12204, 0x12210, 0x1221e, 0x12220, 0x12278, 0x122f0, 0x12306, + 0x1230c, 0x12330, 0x1233e, 0x12360, 0x1237c, 0x1238e, 0x1239c, 0x123b8, 0x123c2, 0x123c8, 0x123d0, 0x123e6, + 0x123ec, 0x1241e, 0x12420, 0x1243c, 0x124f0, 0x125e0, 0x12618, 0x1263e, 0x12660, 0x1267c, 0x126c0, 0x126f8, + 0x12738, 0x12770, 0x1277e, 0x12782, 0x12784, 0x12790, 0x1279e, 0x127a0, 0x127bc, 0x127c6, 0x127cc, 0x127d8, + 0x127ee, 0x12820, 0x1283c, 0x12840, 0x12878, 0x128f0, 0x129e0, 0x12bc0, 0x12c18, 0x12c30, 0x12c3e, 0x12c60, + 0x12c7c, 0x12cc0, 0x12cf8, 0x12df0, 0x12e1c, 0x12e38, 0x12e70, 0x12e7e, 0x12ee0, 0x12efc, 0x12f04, 0x12f08, + 0x12f10, 0x12f20, 0x12f3c, 0x12f40, 0x12f78, 0x12f86, 0x12f8c, 0x12f98, 0x12fb0, 0x12fbe, 0x12fce, 0x12fdc, + 0x1302e, 0x1304e, 0x1305c, 0x13062, 0x13068, 0x1308e, 0x1309c, 0x130b8, 0x130c2, 0x130c8, 0x130d0, 0x130de, + 0x130ec, 0x130fa, 0x1310e, 0x13138, 0x13170, 0x1317e, 0x13182, 0x13184, 0x13190, 0x1319e, 0x131a0, 0x131bc, + 0x131c6, 0x131cc, 0x131d8, 0x131f2, 0x131f4, 0x1320e, 0x1321c, 0x13270, 0x1327e, 0x132e0, 0x132fc, 0x13308, + 0x1331e, 0x13320, 0x1333c, 0x13340, 0x13378, 0x13386, 0x13398, 0x133b0, 0x133be, 0x133ce, 0x133dc, 0x133e2, + 0x133e4, 0x133e8, 0x133f6, 0x1340e, 0x1341c, 0x13438, 0x13470, 0x1347e, 0x134e0, 0x134fc, 0x135c0, 0x135f8, + 0x13608, 0x13610, 0x1361e, 0x13620, 0x1363c, 0x13640, 0x13678, 0x136f0, 0x1370c, 0x13718, 0x13730, 0x1373e, + 0x13760, 0x1377c, 0x1379c, 0x137b8, 0x137c2, 0x137c4, 0x137c8, 0x137d0, 0x137de, 0x137e6, 0x137ec, 0x13816, + 0x13826, 0x1382c, 0x13846, 0x1384c, 0x13858, 0x1386e, 0x13874, 0x13886, 0x13898, 0x138b0, 0x138be, 0x138ce, + 0x138dc, 0x138e2, 0x138e4, 0x138e8, 0x13906, 0x1390c, 0x13930, 0x1393e, 0x13960, 0x1397c, 0x1398e, 0x1399c, + 0x139b8, 0x139c8, 0x139d0, 0x139de, 0x139e6, 0x139ec, 0x139fa, 0x13a06, 0x13a0c, 0x13a18, 0x13a30, 0x13a3e, + 0x13a60, 0x13a7c, 0x13ac0, 0x13af8, 0x13b0e, 0x13b1c, 0x13b38, 0x13b70, 0x13b7e, 0x13b88, 0x13b90, 0x13b9e, + 0x13ba0, 0x13bbc, 0x13bcc, 0x13bd8, 0x13bee, 0x13bf2, 0x13bf4, 0x13c12, 0x13c14, 0x13c22, 0x13c24, 0x13c28, + 0x13c36, 0x13c42, 0x13c48, 0x13c50, 0x13c5e, 0x13c66, 0x13c6c, 0x13c82, 0x13c84, 0x13c90, 0x13c9e, 0x13ca0, + 0x13cbc, 0x13cc6, 0x13ccc, 0x13cd8, 0x13cee, 0x13d02, 0x13d04, 0x13d08, 0x13d10, 0x13d1e, 0x13d20, 0x13d3c, + 0x13d40, 0x13d78, 0x13d86, 0x13d8c, 0x13d98, 0x13db0, 0x13dbe, 0x13dce, 0x13ddc, 0x13de4, 0x13de8, 0x13df6, + 0x13e1a, 0x13e2e, 0x13e32, 0x13e34, 0x13e4e, 0x13e5c, 0x13e62, 0x13e64, 0x13e68, 0x13e76, 0x13e8e, 0x13e9c, + 0x13eb8, 0x13ec2, 0x13ec4, 0x13ec8, 0x13ed0, 0x13ede, 0x13ee6, 0x13eec, 0x13f26, 0x13f2c, 0x13f3a, 0x13f46, + 0x13f4c, 0x13f58, 0x13f6e, 0x13f72, 0x13f74, 0x14082, 0x1409e, 0x140a0, 0x140bc, 0x14104, 0x14108, 0x14110, + 0x1411e, 0x14120, 0x1413c, 0x14140, 0x14178, 0x1418c, 0x14198, 0x141b0, 0x141be, 0x141e2, 0x141e4, 0x141e8, + 0x14208, 0x14210, 0x1421e, 0x14220, 0x1423c, 0x14240, 0x14278, 0x142f0, 0x14306, 0x1430c, 0x14318, 0x14330, + 0x1433e, 0x14360, 0x1437c, 0x1438e, 0x143c2, 0x143c4, 0x143c8, 0x143d0, 0x143e6, 0x143ec, 0x14408, 0x14410, + 0x1441e, 0x14420, 0x1443c, 0x14440, 0x14478, 0x144f0, 0x145e0, 0x1460c, 0x14618, 0x14630, 0x1463e, 0x14660, + 0x1467c, 0x146c0, 0x146f8, 0x1471c, 0x14738, 0x14770, 0x1477e, 0x14782, 0x14784, 0x14788, 0x14790, 0x147a0, + 0x147bc, 0x147c6, 0x147cc, 0x147d8, 0x147ee, 0x14810, 0x14820, 0x1483c, 0x14840, 0x14878, 0x148f0, 0x149e0, + 0x14bc0, 0x14c30, 0x14c3e, 0x14c60, 0x14c7c, 0x14cc0, 0x14cf8, 0x14df0, 0x14e38, 0x14e70, 0x14e7e, 0x14ee0, + 0x14efc, 0x14f04, 0x14f08, 0x14f10, 0x14f1e, 0x14f20, 0x14f3c, 0x14f40, 0x14f78, 0x14f86, 0x14f8c, 0x14f98, + 0x14fb0, 0x14fce, 0x14fdc, 0x15020, 0x15040, 0x15078, 0x150f0, 0x151e0, 0x153c0, 0x15860, 0x1587c, 0x158c0, + 0x158f8, 0x159f0, 0x15be0, 0x15c70, 0x15c7e, 0x15ce0, 0x15cfc, 0x15dc0, 0x15df8, 0x15e08, 0x15e10, 0x15e20, + 0x15e40, 0x15e78, 0x15ef0, 0x15f0c, 0x15f18, 0x15f30, 0x15f60, 0x15f7c, 0x15f8e, 0x15f9c, 0x15fb8, 0x1604e, + 0x1605c, 0x1608e, 0x1609c, 0x160b8, 0x160c2, 0x160c4, 0x160c8, 0x160de, 0x1610e, 0x1611c, 0x16138, 0x16170, + 0x1617e, 0x16184, 0x16188, 0x16190, 0x1619e, 0x161a0, 0x161bc, 0x161c6, 0x161cc, 0x161d8, 0x161f2, 0x161f4, + 0x1620e, 0x1621c, 0x16238, 0x16270, 0x1627e, 0x162e0, 0x162fc, 0x16304, 0x16308, 0x16310, 0x1631e, 0x16320, + 0x1633c, 0x16340, 0x16378, 0x16386, 0x1638c, 0x16398, 0x163b0, 0x163be, 0x163ce, 0x163dc, 0x163e2, 0x163e4, + 0x163e8, 0x163f6, 0x1640e, 0x1641c, 0x16438, 0x16470, 0x1647e, 0x164e0, 0x164fc, 0x165c0, 0x165f8, 0x16610, + 0x1661e, 0x16620, 0x1663c, 0x16640, 0x16678, 0x166f0, 0x16718, 0x16730, 0x1673e, 0x16760, 0x1677c, 0x1678e, + 0x1679c, 0x167b8, 0x167c2, 0x167c4, 0x167c8, 0x167d0, 0x167de, 0x167e6, 0x167ec, 0x1681c, 0x16838, 0x16870, + 0x168e0, 0x168fc, 0x169c0, 0x169f8, 0x16bf0, 0x16c10, 0x16c1e, 0x16c20, 0x16c3c, 0x16c40, 0x16c78, 0x16cf0, + 0x16de0, 0x16e18, 0x16e30, 0x16e3e, 0x16e60, 0x16e7c, 0x16ec0, 0x16ef8, 0x16f1c, 0x16f38, 0x16f70, 0x16f7e, + 0x16f84, 0x16f88, 0x16f90, 0x16f9e, 0x16fa0, 0x16fbc, 0x16fc6, 0x16fcc, 0x16fd8, 0x17026, 0x1702c, 0x17046, + 0x1704c, 0x17058, 0x1706e, 0x17086, 0x1708c, 0x17098, 0x170b0, 0x170be, 0x170ce, 0x170dc, 0x170e8, 0x17106, + 0x1710c, 0x17118, 0x17130, 0x1713e, 0x17160, 0x1717c, 0x1718e, 0x1719c, 0x171b8, 0x171c2, 0x171c4, 0x171c8, + 0x171d0, 0x171de, 0x171e6, 0x171ec, 0x171fa, 0x17206, 0x1720c, 0x17218, 0x17230, 0x1723e, 0x17260, 0x1727c, + 0x172c0, 0x172f8, 0x1730e, 0x1731c, 0x17338, 0x17370, 0x1737e, 0x17388, 0x17390, 0x1739e, 0x173a0, 0x173bc, + 0x173cc, 0x173d8, 0x173ee, 0x173f2, 0x173f4, 0x1740c, 0x17418, 0x17430, 0x1743e, 0x17460, 0x1747c, 0x174c0, + 0x174f8, 0x175f0, 0x1760e, 0x1761c, 0x17638, 0x17670, 0x1767e, 0x176e0, 0x176fc, 0x17708, 0x17710, 0x1771e, + 0x17720, 0x1773c, 0x17740, 0x17778, 0x17798, 0x177b0, 0x177be, 0x177dc, 0x177e2, 0x177e4, 0x177e8, 0x17822, + 0x17824, 0x17828, 0x17836, 0x17842, 0x17844, 0x17848, 0x17850, 0x1785e, 0x17866, 0x1786c, 0x17882, 0x17884, + 0x17888, 0x17890, 0x1789e, 0x178a0, 0x178bc, 0x178c6, 0x178cc, 0x178d8, 0x178ee, 0x178f2, 0x178f4, 0x17902, + 0x17904, 0x17908, 0x17910, 0x1791e, 0x17920, 0x1793c, 0x17940, 0x17978, 0x17986, 0x1798c, 0x17998, 0x179b0, + 0x179be, 0x179ce, 0x179dc, 0x179e2, 0x179e4, 0x179e8, 0x179f6, 0x17a04, 0x17a08, 0x17a10, 0x17a1e, 0x17a20, + 0x17a3c, 0x17a40, 0x17a78, 0x17af0, 0x17b06, 0x17b0c, 0x17b18, 0x17b30, 0x17b3e, 0x17b60, 0x17b7c, 0x17b8e, + 0x17b9c, 0x17bb8, 0x17bc4, 0x17bc8, 0x17bd0, 0x17bde, 0x17be6, 0x17bec, 0x17c2e, 0x17c32, 0x17c34, 0x17c4e, + 0x17c5c, 0x17c62, 0x17c64, 0x17c68, 0x17c76, 0x17c8e, 0x17c9c, 0x17cb8, 0x17cc2, 0x17cc4, 0x17cc8, 0x17cd0, + 0x17cde, 0x17ce6, 0x17cec, 0x17d0e, 0x17d1c, 0x17d38, 0x17d70, 0x17d82, 0x17d84, 0x17d88, 0x17d90, 0x17d9e, + 0x17da0, 0x17dbc, 0x17dc6, 0x17dcc, 0x17dd8, 0x17dee, 0x17e26, 0x17e2c, 0x17e3a, 0x17e46, 0x17e4c, 0x17e58, + 0x17e6e, 0x17e72, 0x17e74, 0x17e86, 0x17e8c, 0x17e98, 0x17eb0, 0x17ece, 0x17edc, 0x17ee2, 0x17ee4, 0x17ee8, + 0x17ef6, 0x1813a, 0x18172, 0x18174, 0x18216, 0x18226, 0x1823a, 0x1824c, 0x18258, 0x1826e, 0x18272, 0x18274, + 0x18298, 0x182be, 0x182e2, 0x182e4, 0x182e8, 0x182f6, 0x1835e, 0x1837a, 0x183ae, 0x183d6, 0x18416, 0x18426, + 0x1842c, 0x1843a, 0x18446, 0x18458, 0x1846e, 0x18472, 0x18474, 0x18486, 0x184b0, 0x184be, 0x184ce, 0x184dc, + 0x184e2, 0x184e4, 0x184e8, 0x184f6, 0x18506, 0x1850c, 0x18518, 0x18530, 0x1853e, 0x18560, 0x1857c, 0x1858e, + 0x1859c, 0x185b8, 0x185c2, 0x185c4, 0x185c8, 0x185d0, 0x185de, 0x185e6, 0x185ec, 0x185fa, 0x18612, 0x18614, + 0x18622, 0x18628, 0x18636, 0x18642, 0x18650, 0x1865e, 0x1867a, 0x18682, 0x18684, 0x18688, 0x18690, 0x1869e, + 0x186a0, 0x186bc, 0x186c6, 0x186cc, 0x186d8, 0x186ee, 0x186f2, 0x186f4, 0x1872e, 0x1874e, 0x1875c, 0x18796, + 0x187a6, 0x187ac, 0x187d2, 0x187d4, 0x18826, 0x1882c, 0x1883a, 0x18846, 0x1884c, 0x18858, 0x1886e, 0x18872, + 0x18874, 0x18886, 0x18898, 0x188b0, 0x188be, 0x188ce, 0x188dc, 0x188e2, 0x188e4, 0x188e8, 0x188f6, 0x1890c, + 0x18930, 0x1893e, 0x18960, 0x1897c, 0x1898e, 0x189b8, 0x189c2, 0x189c8, 0x189d0, 0x189de, 0x189e6, 0x189ec, + 0x189fa, 0x18a18, 0x18a30, 0x18a3e, 0x18a60, 0x18a7c, 0x18ac0, 0x18af8, 0x18b1c, 0x18b38, 0x18b70, 0x18b7e, + 0x18b82, 0x18b84, 0x18b88, 0x18b90, 0x18b9e, 0x18ba0, 0x18bbc, 0x18bc6, 0x18bcc, 0x18bd8, 0x18bee, 0x18bf2, + 0x18bf4, 0x18c22, 0x18c24, 0x18c28, 0x18c36, 0x18c42, 0x18c48, 0x18c50, 0x18c5e, 0x18c66, 0x18c7a, 0x18c82, + 0x18c84, 0x18c90, 0x18c9e, 0x18ca0, 0x18cbc, 0x18ccc, 0x18cf2, 0x18cf4, 0x18d04, 0x18d08, 0x18d10, 0x18d1e, + 0x18d20, 0x18d3c, 0x18d40, 0x18d78, 0x18d86, 0x18d98, 0x18dce, 0x18de2, 0x18de4, 0x18de8, 0x18e2e, 0x18e32, + 0x18e34, 0x18e4e, 0x18e5c, 0x18e62, 0x18e64, 0x18e68, 0x18e8e, 0x18e9c, 0x18eb8, 0x18ec2, 0x18ec4, 0x18ec8, + 0x18ed0, 0x18efa, 0x18f16, 0x18f26, 0x18f2c, 0x18f46, 0x18f4c, 0x18f58, 0x18f6e, 0x18f8a, 0x18f92, 0x18f94, + 0x18fa2, 0x18fa4, 0x18fa8, 0x18fb6, 0x1902c, 0x1903a, 0x19046, 0x1904c, 0x19058, 0x19072, 0x19074, 0x19086, + 0x19098, 0x190b0, 0x190be, 0x190ce, 0x190dc, 0x190e2, 0x190e8, 0x190f6, 0x19106, 0x1910c, 0x19130, 0x1913e, + 0x19160, 0x1917c, 0x1918e, 0x1919c, 0x191b8, 0x191c2, 0x191c8, 0x191d0, 0x191de, 0x191e6, 0x191ec, 0x191fa, + 0x19218, 0x1923e, 0x19260, 0x1927c, 0x192c0, 0x192f8, 0x19338, 0x19370, 0x1937e, 0x19382, 0x19384, 0x19390, + 0x1939e, 0x193a0, 0x193bc, 0x193c6, 0x193cc, 0x193d8, 0x193ee, 0x193f2, 0x193f4, 0x19430, 0x1943e, 0x19460, + 0x1947c, 0x194c0, 0x194f8, 0x195f0, 0x19638, 0x19670, 0x1967e, 0x196e0, 0x196fc, 0x19702, 0x19704, 0x19708, + 0x19710, 0x19720, 0x1973c, 0x19740, 0x19778, 0x19786, 0x1978c, 0x19798, 0x197b0, 0x197be, 0x197ce, 0x197dc, + 0x197e2, 0x197e4, 0x197e8, 0x19822, 0x19824, 0x19842, 0x19848, 0x19850, 0x1985e, 0x19866, 0x1987a, 0x19882, + 0x19884, 0x19890, 0x1989e, 0x198a0, 0x198bc, 0x198cc, 0x198f2, 0x198f4, 0x19902, 0x19908, 0x1991e, 0x19920, + 0x1993c, 0x19940, 0x19978, 0x19986, 0x19998, 0x199ce, 0x199e2, 0x199e4, 0x199e8, 0x19a08, 0x19a10, 0x19a1e, + 0x19a20, 0x19a3c, 0x19a40, 0x19a78, 0x19af0, 0x19b18, 0x19b3e, 0x19b60, 0x19b9c, 0x19bc2, 0x19bc4, 0x19bc8, + 0x19bd0, 0x19be6, 0x19c2e, 0x19c34, 0x19c4e, 0x19c5c, 0x19c62, 0x19c64, 0x19c68, 0x19c8e, 0x19c9c, 0x19cb8, + 0x19cc2, 0x19cc8, 0x19cd0, 0x19ce6, 0x19cfa, 0x19d0e, 0x19d1c, 0x19d38, 0x19d70, 0x19d7e, 0x19d82, 0x19d84, + 0x19d88, 0x19d90, 0x19da0, 0x19dcc, 0x19df2, 0x19df4, 0x19e16, 0x19e26, 0x19e2c, 0x19e46, 0x19e4c, 0x19e58, + 0x19e74, 0x19e86, 0x19e8c, 0x19e98, 0x19eb0, 0x19ebe, 0x19ece, 0x19ee2, 0x19ee4, 0x19ee8, 0x19f0a, 0x19f12, + 0x19f14, 0x19f22, 0x19f24, 0x19f28, 0x19f42, 0x19f44, 0x19f48, 0x19f50, 0x19f5e, 0x19f6c, 0x19f9a, 0x19fae, + 0x19fb2, 0x19fb4, 0x1a046, 0x1a04c, 0x1a072, 0x1a074, 0x1a086, 0x1a08c, 0x1a098, 0x1a0b0, 0x1a0be, 0x1a0e2, + 0x1a0e4, 0x1a0e8, 0x1a0f6, 0x1a106, 0x1a10c, 0x1a118, 0x1a130, 0x1a13e, 0x1a160, 0x1a17c, 0x1a18e, 0x1a19c, + 0x1a1b8, 0x1a1c2, 0x1a1c4, 0x1a1c8, 0x1a1d0, 0x1a1de, 0x1a1e6, 0x1a1ec, 0x1a218, 0x1a230, 0x1a23e, 0x1a260, + 0x1a27c, 0x1a2c0, 0x1a2f8, 0x1a31c, 0x1a338, 0x1a370, 0x1a37e, 0x1a382, 0x1a384, 0x1a388, 0x1a390, 0x1a39e, + 0x1a3a0, 0x1a3bc, 0x1a3c6, 0x1a3cc, 0x1a3d8, 0x1a3ee, 0x1a3f2, 0x1a3f4, 0x1a418, 0x1a430, 0x1a43e, 0x1a460, + 0x1a47c, 0x1a4c0, 0x1a4f8, 0x1a5f0, 0x1a61c, 0x1a638, 0x1a670, 0x1a67e, 0x1a6e0, 0x1a6fc, 0x1a702, 0x1a704, + 0x1a708, 0x1a710, 0x1a71e, 0x1a720, 0x1a73c, 0x1a740, 0x1a778, 0x1a786, 0x1a78c, 0x1a798, 0x1a7b0, 0x1a7be, + 0x1a7ce, 0x1a7dc, 0x1a7e2, 0x1a7e4, 0x1a7e8, 0x1a830, 0x1a860, 0x1a87c, 0x1a8c0, 0x1a8f8, 0x1a9f0, 0x1abe0, + 0x1ac70, 0x1ac7e, 0x1ace0, 0x1acfc, 0x1adc0, 0x1adf8, 0x1ae04, 0x1ae08, 0x1ae10, 0x1ae20, 0x1ae3c, 0x1ae40, + 0x1ae78, 0x1aef0, 0x1af06, 0x1af0c, 0x1af18, 0x1af30, 0x1af3e, 0x1af60, 0x1af7c, 0x1af8e, 0x1af9c, 0x1afb8, + 0x1afc4, 0x1afc8, 0x1afd0, 0x1afde, 0x1b042, 0x1b05e, 0x1b07a, 0x1b082, 0x1b084, 0x1b088, 0x1b090, 0x1b09e, + 0x1b0a0, 0x1b0bc, 0x1b0cc, 0x1b0f2, 0x1b0f4, 0x1b102, 0x1b104, 0x1b108, 0x1b110, 0x1b11e, 0x1b120, 0x1b13c, + 0x1b140, 0x1b178, 0x1b186, 0x1b198, 0x1b1ce, 0x1b1e2, 0x1b1e4, 0x1b1e8, 0x1b204, 0x1b208, 0x1b210, 0x1b21e, + 0x1b220, 0x1b23c, 0x1b240, 0x1b278, 0x1b2f0, 0x1b30c, 0x1b33e, 0x1b360, 0x1b39c, 0x1b3c2, 0x1b3c4, 0x1b3c8, + 0x1b3d0, 0x1b3e6, 0x1b410, 0x1b41e, 0x1b420, 0x1b43c, 0x1b440, 0x1b478, 0x1b4f0, 0x1b5e0, 0x1b618, 0x1b660, + 0x1b67c, 0x1b6c0, 0x1b738, 0x1b782, 0x1b784, 0x1b788, 0x1b790, 0x1b79e, 0x1b7a0, 0x1b7cc, 0x1b82e, 0x1b84e, + 0x1b85c, 0x1b88e, 0x1b89c, 0x1b8b8, 0x1b8c2, 0x1b8c4, 0x1b8c8, 0x1b8d0, 0x1b8e6, 0x1b8fa, 0x1b90e, 0x1b91c, + 0x1b938, 0x1b970, 0x1b97e, 0x1b982, 0x1b984, 0x1b988, 0x1b990, 0x1b99e, 0x1b9a0, 0x1b9cc, 0x1b9f2, 0x1b9f4, + 0x1ba0e, 0x1ba1c, 0x1ba38, 0x1ba70, 0x1ba7e, 0x1bae0, 0x1bafc, 0x1bb08, 0x1bb10, 0x1bb20, 0x1bb3c, 0x1bb40, + 0x1bb98, 0x1bbce, 0x1bbe2, 0x1bbe4, 0x1bbe8, 0x1bc16, 0x1bc26, 0x1bc2c, 0x1bc46, 0x1bc4c, 0x1bc58, 0x1bc72, + 0x1bc74, 0x1bc86, 0x1bc8c, 0x1bc98, 0x1bcb0, 0x1bcbe, 0x1bcce, 0x1bce2, 0x1bce4, 0x1bce8, 0x1bd06, 0x1bd0c, + 0x1bd18, 0x1bd30, 0x1bd3e, 0x1bd60, 0x1bd7c, 0x1bd9c, 0x1bdc2, 0x1bdc4, 0x1bdc8, 0x1bdd0, 0x1bde6, 0x1bdfa, + 0x1be12, 0x1be14, 0x1be22, 0x1be24, 0x1be28, 0x1be42, 0x1be44, 0x1be48, 0x1be50, 0x1be5e, 0x1be66, 0x1be82, + 0x1be84, 0x1be88, 0x1be90, 0x1be9e, 0x1bea0, 0x1bebc, 0x1becc, 0x1bef4, 0x1bf1a, 0x1bf2e, 0x1bf32, 0x1bf34, + 0x1bf4e, 0x1bf5c, 0x1bf62, 0x1bf64, 0x1bf68, 0x1c09a, 0x1c0b2, 0x1c0b4, 0x1c11a, 0x1c132, 0x1c134, 0x1c162, + 0x1c164, 0x1c168, 0x1c176, 0x1c1ba, 0x1c21a, 0x1c232, 0x1c234, 0x1c24e, 0x1c25c, 0x1c262, 0x1c264, 0x1c268, + 0x1c276, 0x1c28e, 0x1c2c2, 0x1c2c4, 0x1c2c8, 0x1c2d0, 0x1c2de, 0x1c2e6, 0x1c2ec, 0x1c2fa, 0x1c316, 0x1c326, + 0x1c33a, 0x1c346, 0x1c34c, 0x1c372, 0x1c374, 0x1c41a, 0x1c42e, 0x1c432, 0x1c434, 0x1c44e, 0x1c45c, 0x1c462, + 0x1c464, 0x1c468, 0x1c476, 0x1c48e, 0x1c49c, 0x1c4b8, 0x1c4c2, 0x1c4c8, 0x1c4d0, 0x1c4de, 0x1c4e6, 0x1c4ec, + 0x1c4fa, 0x1c51c, 0x1c538, 0x1c570, 0x1c57e, 0x1c582, 0x1c584, 0x1c588, 0x1c590, 0x1c59e, 0x1c5a0, 0x1c5bc, + 0x1c5c6, 0x1c5cc, 0x1c5d8, 0x1c5ee, 0x1c5f2, 0x1c5f4, 0x1c616, 0x1c626, 0x1c62c, 0x1c63a, 0x1c646, 0x1c64c, + 0x1c658, 0x1c66e, 0x1c672, 0x1c674, 0x1c686, 0x1c68c, 0x1c698, 0x1c6b0, 0x1c6be, 0x1c6ce, 0x1c6dc, 0x1c6e2, + 0x1c6e4, 0x1c6e8, 0x1c712, 0x1c714, 0x1c722, 0x1c728, 0x1c736, 0x1c742, 0x1c744, 0x1c748, 0x1c750, 0x1c75e, + 0x1c766, 0x1c76c, 0x1c77a, 0x1c7ae, 0x1c7d6, 0x1c7ea, 0x1c81a, 0x1c82e, 0x1c832, 0x1c834, 0x1c84e, 0x1c85c, + 0x1c862, 0x1c864, 0x1c868, 0x1c876, 0x1c88e, 0x1c89c, 0x1c8b8, 0x1c8c2, 0x1c8c8, 0x1c8d0, 0x1c8de, 0x1c8e6, + 0x1c8ec, 0x1c8fa, 0x1c90e, 0x1c938, 0x1c970, 0x1c97e, 0x1c982, 0x1c984, 0x1c990, 0x1c99e, 0x1c9a0, 0x1c9bc, + 0x1c9c6, 0x1c9cc, 0x1c9d8, 0x1c9ee, 0x1c9f2, 0x1c9f4, 0x1ca38, 0x1ca70, 0x1ca7e, 0x1cae0, 0x1cafc, 0x1cb02, + 0x1cb04, 0x1cb08, 0x1cb10, 0x1cb20, 0x1cb3c, 0x1cb40, 0x1cb78, 0x1cb86, 0x1cb8c, 0x1cb98, 0x1cbb0, 0x1cbbe, + 0x1cbce, 0x1cbdc, 0x1cbe2, 0x1cbe4, 0x1cbe8, 0x1cbf6, 0x1cc16, 0x1cc26, 0x1cc2c, 0x1cc3a, 0x1cc46, 0x1cc58, + 0x1cc72, 0x1cc74, 0x1cc86, 0x1ccb0, 0x1ccbe, 0x1ccce, 0x1cce2, 0x1cce4, 0x1cce8, 0x1cd06, 0x1cd0c, 0x1cd18, + 0x1cd30, 0x1cd3e, 0x1cd60, 0x1cd7c, 0x1cd9c, 0x1cdc2, 0x1cdc4, 0x1cdc8, 0x1cdd0, 0x1cdde, 0x1cde6, 0x1cdfa, + 0x1ce22, 0x1ce28, 0x1ce42, 0x1ce50, 0x1ce5e, 0x1ce66, 0x1ce7a, 0x1ce82, 0x1ce84, 0x1ce88, 0x1ce90, 0x1ce9e, + 0x1cea0, 0x1cebc, 0x1cecc, 0x1cef2, 0x1cef4, 0x1cf2e, 0x1cf32, 0x1cf34, 0x1cf4e, 0x1cf5c, 0x1cf62, 0x1cf64, + 0x1cf68, 0x1cf96, 0x1cfa6, 0x1cfac, 0x1cfca, 0x1cfd2, 0x1cfd4, 0x1d02e, 0x1d032, 0x1d034, 0x1d04e, 0x1d05c, + 0x1d062, 0x1d064, 0x1d068, 0x1d076, 0x1d08e, 0x1d09c, 0x1d0b8, 0x1d0c2, 0x1d0c4, 0x1d0c8, 0x1d0d0, 0x1d0de, + 0x1d0e6, 0x1d0ec, 0x1d0fa, 0x1d11c, 0x1d138, 0x1d170, 0x1d17e, 0x1d182, 0x1d184, 0x1d188, 0x1d190, 0x1d19e, + 0x1d1a0, 0x1d1bc, 0x1d1c6, 0x1d1cc, 0x1d1d8, 0x1d1ee, 0x1d1f2, 0x1d1f4, 0x1d21c, 0x1d238, 0x1d270, 0x1d27e, + 0x1d2e0, 0x1d2fc, 0x1d302, 0x1d304, 0x1d308, 0x1d310, 0x1d31e, 0x1d320, 0x1d33c, 0x1d340, 0x1d378, 0x1d386, + 0x1d38c, 0x1d398, 0x1d3b0, 0x1d3be, 0x1d3ce, 0x1d3dc, 0x1d3e2, 0x1d3e4, 0x1d3e8, 0x1d3f6, 0x1d470, 0x1d47e, + 0x1d4e0, 0x1d4fc, 0x1d5c0, 0x1d5f8, 0x1d604, 0x1d608, 0x1d610, 0x1d620, 0x1d640, 0x1d678, 0x1d6f0, 0x1d706, + 0x1d70c, 0x1d718, 0x1d730, 0x1d73e, 0x1d760, 0x1d77c, 0x1d78e, 0x1d79c, 0x1d7b8, 0x1d7c2, 0x1d7c4, 0x1d7c8, + 0x1d7d0, 0x1d7de, 0x1d7e6, 0x1d7ec, 0x1d826, 0x1d82c, 0x1d83a, 0x1d846, 0x1d84c, 0x1d858, 0x1d872, 0x1d874, + 0x1d886, 0x1d88c, 0x1d898, 0x1d8b0, 0x1d8be, 0x1d8ce, 0x1d8e2, 0x1d8e4, 0x1d8e8, 0x1d8f6, 0x1d90c, 0x1d918, + 0x1d930, 0x1d93e, 0x1d960, 0x1d97c, 0x1d99c, 0x1d9c2, 0x1d9c4, 0x1d9c8, 0x1d9d0, 0x1d9e6, 0x1d9fa, 0x1da0c, + 0x1da18, 0x1da30, 0x1da3e, 0x1da60, 0x1da7c, 0x1dac0, 0x1daf8, 0x1db38, 0x1db82, 0x1db84, 0x1db88, 0x1db90, + 0x1db9e, 0x1dba0, 0x1dbcc, 0x1dbf2, 0x1dbf4, 0x1dc22, 0x1dc42, 0x1dc44, 0x1dc48, 0x1dc50, 0x1dc5e, 0x1dc66, + 0x1dc7a, 0x1dc82, 0x1dc84, 0x1dc88, 0x1dc90, 0x1dc9e, 0x1dca0, 0x1dcbc, 0x1dccc, 0x1dcf2, 0x1dcf4, 0x1dd04, + 0x1dd08, 0x1dd10, 0x1dd1e, 0x1dd20, 0x1dd3c, 0x1dd40, 0x1dd78, 0x1dd86, 0x1dd98, 0x1ddce, 0x1dde2, 0x1dde4, + 0x1dde8, 0x1de2e, 0x1de32, 0x1de34, 0x1de4e, 0x1de5c, 0x1de62, 0x1de64, 0x1de68, 0x1de8e, 0x1de9c, 0x1deb8, + 0x1dec2, 0x1dec4, 0x1dec8, 0x1ded0, 0x1dee6, 0x1defa, 0x1df16, 0x1df26, 0x1df2c, 0x1df46, 0x1df4c, 0x1df58, + 0x1df72, 0x1df74, 0x1df8a, 0x1df92, 0x1df94, 0x1dfa2, 0x1dfa4, 0x1dfa8, 0x1e08a, 0x1e092, 0x1e094, 0x1e0a2, + 0x1e0a4, 0x1e0a8, 0x1e0b6, 0x1e0da, 0x1e10a, 0x1e112, 0x1e114, 0x1e122, 0x1e124, 0x1e128, 0x1e136, 0x1e142, + 0x1e144, 0x1e148, 0x1e150, 0x1e166, 0x1e16c, 0x1e17a, 0x1e19a, 0x1e1b2, 0x1e1b4, 0x1e20a, 0x1e212, 0x1e214, + 0x1e222, 0x1e224, 0x1e228, 0x1e236, 0x1e242, 0x1e248, 0x1e250, 0x1e25e, 0x1e266, 0x1e26c, 0x1e27a, 0x1e282, + 0x1e284, 0x1e288, 0x1e290, 0x1e2a0, 0x1e2bc, 0x1e2c6, 0x1e2cc, 0x1e2d8, 0x1e2ee, 0x1e2f2, 0x1e2f4, 0x1e31a, + 0x1e332, 0x1e334, 0x1e35c, 0x1e362, 0x1e364, 0x1e368, 0x1e3ba, 0x1e40a, 0x1e412, 0x1e414, 0x1e422, 0x1e428, + 0x1e436, 0x1e442, 0x1e448, 0x1e450, 0x1e45e, 0x1e466, 0x1e46c, 0x1e47a, 0x1e482, 0x1e484, 0x1e490, 0x1e49e, + 0x1e4a0, 0x1e4bc, 0x1e4c6, 0x1e4cc, 0x1e4d8, 0x1e4ee, 0x1e4f2, 0x1e4f4, 0x1e502, 0x1e504, 0x1e508, 0x1e510, + 0x1e51e, 0x1e520, 0x1e53c, 0x1e540, 0x1e578, 0x1e586, 0x1e58c, 0x1e598, 0x1e5b0, 0x1e5be, 0x1e5ce, 0x1e5dc, + 0x1e5e2, 0x1e5e4, 0x1e5e8, 0x1e5f6, 0x1e61a, 0x1e62e, 0x1e632, 0x1e634, 0x1e64e, 0x1e65c, 0x1e662, 0x1e668, + 0x1e68e, 0x1e69c, 0x1e6b8, 0x1e6c2, 0x1e6c4, 0x1e6c8, 0x1e6d0, 0x1e6e6, 0x1e6fa, 0x1e716, 0x1e726, 0x1e72c, + 0x1e73a, 0x1e746, 0x1e74c, 0x1e758, 0x1e772, 0x1e774, 0x1e792, 0x1e794, 0x1e7a2, 0x1e7a4, 0x1e7a8, 0x1e7b6, + 0x1e812, 0x1e814, 0x1e822, 0x1e824, 0x1e828, 0x1e836, 0x1e842, 0x1e844, 0x1e848, 0x1e850, 0x1e85e, 0x1e866, + 0x1e86c, 0x1e87a, 0x1e882, 0x1e884, 0x1e888, 0x1e890, 0x1e89e, 0x1e8a0, 0x1e8bc, 0x1e8c6, 0x1e8cc, 0x1e8d8, + 0x1e8ee, 0x1e8f2, 0x1e8f4, 0x1e902, 0x1e904, 0x1e908, 0x1e910, 0x1e920, 0x1e93c, 0x1e940, 0x1e978, 0x1e986, + 0x1e98c, 0x1e998, 0x1e9b0, 0x1e9be, 0x1e9ce, 0x1e9dc, 0x1e9e2, 0x1e9e4, 0x1e9e8, 0x1e9f6, 0x1ea04, 0x1ea08, + 0x1ea10, 0x1ea20, 0x1ea40, 0x1ea78, 0x1eaf0, 0x1eb06, 0x1eb0c, 0x1eb18, 0x1eb30, 0x1eb3e, 0x1eb60, 0x1eb7c, + 0x1eb8e, 0x1eb9c, 0x1ebb8, 0x1ebc2, 0x1ebc4, 0x1ebc8, 0x1ebd0, 0x1ebde, 0x1ebe6, 0x1ebec, 0x1ec1a, 0x1ec2e, + 0x1ec32, 0x1ec34, 0x1ec4e, 0x1ec5c, 0x1ec62, 0x1ec64, 0x1ec68, 0x1ec8e, 0x1ec9c, 0x1ecb8, 0x1ecc2, 0x1ecc4, + 0x1ecc8, 0x1ecd0, 0x1ece6, 0x1ecfa, 0x1ed0e, 0x1ed1c, 0x1ed38, 0x1ed70, 0x1ed7e, 0x1ed82, 0x1ed84, 0x1ed88, + 0x1ed90, 0x1ed9e, 0x1eda0, 0x1edcc, 0x1edf2, 0x1edf4, 0x1ee16, 0x1ee26, 0x1ee2c, 0x1ee3a, 0x1ee46, 0x1ee4c, + 0x1ee58, 0x1ee6e, 0x1ee72, 0x1ee74, 0x1ee86, 0x1ee8c, 0x1ee98, 0x1eeb0, 0x1eebe, 0x1eece, 0x1eedc, 0x1eee2, + 0x1eee4, 0x1eee8, 0x1ef12, 0x1ef22, 0x1ef24, 0x1ef28, 0x1ef36, 0x1ef42, 0x1ef44, 0x1ef48, 0x1ef50, 0x1ef5e, + 0x1ef66, 0x1ef6c, 0x1ef7a, 0x1efae, 0x1efb2, 0x1efb4, 0x1efd6, 0x1f096, 0x1f0a6, 0x1f0ac, 0x1f0ba, 0x1f0ca, + 0x1f0d2, 0x1f0d4, 0x1f116, 0x1f126, 0x1f12c, 0x1f13a, 0x1f146, 0x1f14c, 0x1f158, 0x1f16e, 0x1f172, 0x1f174, + 0x1f18a, 0x1f192, 0x1f194, 0x1f1a2, 0x1f1a4, 0x1f1a8, 0x1f1da, 0x1f216, 0x1f226, 0x1f22c, 0x1f23a, 0x1f246, + 0x1f258, 0x1f26e, 0x1f272, 0x1f274, 0x1f286, 0x1f28c, 0x1f298, 0x1f2b0, 0x1f2be, 0x1f2ce, 0x1f2dc, 0x1f2e2, + 0x1f2e4, 0x1f2e8, 0x1f2f6, 0x1f30a, 0x1f312, 0x1f314, 0x1f322, 0x1f328, 0x1f342, 0x1f344, 0x1f348, 0x1f350, + 0x1f35e, 0x1f366, 0x1f37a, 0x1f39a, 0x1f3ae, 0x1f3b2, 0x1f3b4, 0x1f416, 0x1f426, 0x1f42c, 0x1f43a, 0x1f446, + 0x1f44c, 0x1f458, 0x1f46e, 0x1f472, 0x1f474, 0x1f486, 0x1f48c, 0x1f498, 0x1f4b0, 0x1f4be, 0x1f4ce, 0x1f4dc, + 0x1f4e2, 0x1f4e4, 0x1f4e8, 0x1f4f6, 0x1f506, 0x1f50c, 0x1f518, 0x1f530, 0x1f53e, 0x1f560, 0x1f57c, 0x1f58e, + 0x1f59c, 0x1f5b8, 0x1f5c2, 0x1f5c4, 0x1f5c8, 0x1f5d0, 0x1f5de, 0x1f5e6, 0x1f5ec, 0x1f5fa, 0x1f60a, 0x1f612, + 0x1f614, 0x1f622, 0x1f624, 0x1f628, 0x1f636, 0x1f642, 0x1f644, 0x1f648, 0x1f650, 0x1f65e, 0x1f666, 0x1f67a, + 0x1f682, 0x1f684, 0x1f688, 0x1f690, 0x1f69e, 0x1f6a0, 0x1f6bc, 0x1f6cc, 0x1f6f2, 0x1f6f4, 0x1f71a, 0x1f72e, + 0x1f732, 0x1f734, 0x1f74e, 0x1f75c, 0x1f762, 0x1f764, 0x1f768, 0x1f776, 0x1f796, 0x1f7a6, 0x1f7ac, 0x1f7ba, + 0x1f7d2, 0x1f7d4, 0x1f89a, 0x1f8ae, 0x1f8b2, 0x1f8b4, 0x1f8d6, 0x1f8ea, 0x1f91a, 0x1f92e, 0x1f932, 0x1f934, + 0x1f94e, 0x1f95c, 0x1f962, 0x1f964, 0x1f968, 0x1f976, 0x1f996, 0x1f9a6, 0x1f9ac, 0x1f9ba, 0x1f9ca, 0x1f9d2, + 0x1f9d4, 0x1fa1a, 0x1fa2e, 0x1fa32, 0x1fa34, 0x1fa4e, 0x1fa5c, 0x1fa62, 0x1fa64, 0x1fa68, 0x1fa76, 0x1fa8e, + 0x1fa9c, 0x1fab8, 0x1fac2, 0x1fac4, 0x1fac8, 0x1fad0, 0x1fade, 0x1fae6, 0x1faec, 0x1fb16, 0x1fb26, 0x1fb2c, + 0x1fb3a, 0x1fb46, 0x1fb4c, 0x1fb58, 0x1fb6e, 0x1fb72, 0x1fb74, 0x1fb8a, 0x1fb92, 0x1fb94, 0x1fba2, 0x1fba4, + 0x1fba8, 0x1fbb6, 0x1fbda + ]); + /** + * This table contains to codewords for all symbols. + */ + PDF417Common.CODEWORD_TABLE = Int32Array.from([ + 2627, 1819, 2622, 2621, 1813, 1812, 2729, 2724, 2723, 2779, 2774, 2773, 902, 896, 908, 868, 865, 861, 859, 2511, + 873, 871, 1780, 835, 2493, 825, 2491, 842, 837, 844, 1764, 1762, 811, 810, 809, 2483, 807, 2482, 806, 2480, 815, + 814, 813, 812, 2484, 817, 816, 1745, 1744, 1742, 1746, 2655, 2637, 2635, 2626, 2625, 2623, 2628, 1820, 2752, + 2739, 2737, 2728, 2727, 2725, 2730, 2785, 2783, 2778, 2777, 2775, 2780, 787, 781, 747, 739, 736, 2413, 754, 752, + 1719, 692, 689, 681, 2371, 678, 2369, 700, 697, 694, 703, 1688, 1686, 642, 638, 2343, 631, 2341, 627, 2338, 651, + 646, 643, 2345, 654, 652, 1652, 1650, 1647, 1654, 601, 599, 2322, 596, 2321, 594, 2319, 2317, 611, 610, 608, 606, + 2324, 603, 2323, 615, 614, 612, 1617, 1616, 1614, 1612, 616, 1619, 1618, 2575, 2538, 2536, 905, 901, 898, 909, + 2509, 2507, 2504, 870, 867, 864, 860, 2512, 875, 872, 1781, 2490, 2489, 2487, 2485, 1748, 836, 834, 832, 830, + 2494, 827, 2492, 843, 841, 839, 845, 1765, 1763, 2701, 2676, 2674, 2653, 2648, 2656, 2634, 2633, 2631, 2629, + 1821, 2638, 2636, 2770, 2763, 2761, 2750, 2745, 2753, 2736, 2735, 2733, 2731, 1848, 2740, 2738, 2786, 2784, 591, + 588, 576, 569, 566, 2296, 1590, 537, 534, 526, 2276, 522, 2274, 545, 542, 539, 548, 1572, 1570, 481, 2245, 466, + 2242, 462, 2239, 492, 485, 482, 2249, 496, 494, 1534, 1531, 1528, 1538, 413, 2196, 406, 2191, 2188, 425, 419, + 2202, 415, 2199, 432, 430, 427, 1472, 1467, 1464, 433, 1476, 1474, 368, 367, 2160, 365, 2159, 362, 2157, 2155, + 2152, 378, 377, 375, 2166, 372, 2165, 369, 2162, 383, 381, 379, 2168, 1419, 1418, 1416, 1414, 385, 1411, 384, + 1423, 1422, 1420, 1424, 2461, 802, 2441, 2439, 790, 786, 783, 794, 2409, 2406, 2403, 750, 742, 738, 2414, 756, + 753, 1720, 2367, 2365, 2362, 2359, 1663, 693, 691, 684, 2373, 680, 2370, 702, 699, 696, 704, 1690, 1687, 2337, + 2336, 2334, 2332, 1624, 2329, 1622, 640, 637, 2344, 634, 2342, 630, 2340, 650, 648, 645, 2346, 655, 653, 1653, + 1651, 1649, 1655, 2612, 2597, 2595, 2571, 2568, 2565, 2576, 2534, 2529, 2526, 1787, 2540, 2537, 907, 904, 900, + 910, 2503, 2502, 2500, 2498, 1768, 2495, 1767, 2510, 2508, 2506, 869, 866, 863, 2513, 876, 874, 1782, 2720, 2713, + 2711, 2697, 2694, 2691, 2702, 2672, 2670, 2664, 1828, 2678, 2675, 2647, 2646, 2644, 2642, 1823, 2639, 1822, 2654, + 2652, 2650, 2657, 2771, 1855, 2765, 2762, 1850, 1849, 2751, 2749, 2747, 2754, 353, 2148, 344, 342, 336, 2142, + 332, 2140, 345, 1375, 1373, 306, 2130, 299, 2128, 295, 2125, 319, 314, 311, 2132, 1354, 1352, 1349, 1356, 262, + 257, 2101, 253, 2096, 2093, 274, 273, 267, 2107, 263, 2104, 280, 278, 275, 1316, 1311, 1308, 1320, 1318, 2052, + 202, 2050, 2044, 2040, 219, 2063, 212, 2060, 208, 2055, 224, 221, 2066, 1260, 1258, 1252, 231, 1248, 229, 1266, + 1264, 1261, 1268, 155, 1998, 153, 1996, 1994, 1991, 1988, 165, 164, 2007, 162, 2006, 159, 2003, 2000, 172, 171, + 169, 2012, 166, 2010, 1186, 1184, 1182, 1179, 175, 1176, 173, 1192, 1191, 1189, 1187, 176, 1194, 1193, 2313, + 2307, 2305, 592, 589, 2294, 2292, 2289, 578, 572, 568, 2297, 580, 1591, 2272, 2267, 2264, 1547, 538, 536, 529, + 2278, 525, 2275, 547, 544, 541, 1574, 1571, 2237, 2235, 2229, 1493, 2225, 1489, 478, 2247, 470, 2244, 465, 2241, + 493, 488, 484, 2250, 498, 495, 1536, 1533, 1530, 1539, 2187, 2186, 2184, 2182, 1432, 2179, 1430, 2176, 1427, 414, + 412, 2197, 409, 2195, 405, 2193, 2190, 426, 424, 421, 2203, 418, 2201, 431, 429, 1473, 1471, 1469, 1466, 434, + 1477, 1475, 2478, 2472, 2470, 2459, 2457, 2454, 2462, 803, 2437, 2432, 2429, 1726, 2443, 2440, 792, 789, 785, + 2401, 2399, 2393, 1702, 2389, 1699, 2411, 2408, 2405, 745, 741, 2415, 758, 755, 1721, 2358, 2357, 2355, 2353, + 1661, 2350, 1660, 2347, 1657, 2368, 2366, 2364, 2361, 1666, 690, 687, 2374, 683, 2372, 701, 698, 705, 1691, 1689, + 2619, 2617, 2610, 2608, 2605, 2613, 2593, 2588, 2585, 1803, 2599, 2596, 2563, 2561, 2555, 1797, 2551, 1795, 2573, + 2570, 2567, 2577, 2525, 2524, 2522, 2520, 1786, 2517, 1785, 2514, 1783, 2535, 2533, 2531, 2528, 1788, 2541, 2539, + 906, 903, 911, 2721, 1844, 2715, 2712, 1838, 1836, 2699, 2696, 2693, 2703, 1827, 1826, 1824, 2673, 2671, 2669, + 2666, 1829, 2679, 2677, 1858, 1857, 2772, 1854, 1853, 1851, 1856, 2766, 2764, 143, 1987, 139, 1986, 135, 133, + 131, 1984, 128, 1983, 125, 1981, 138, 137, 136, 1985, 1133, 1132, 1130, 112, 110, 1974, 107, 1973, 104, 1971, + 1969, 122, 121, 119, 117, 1977, 114, 1976, 124, 1115, 1114, 1112, 1110, 1117, 1116, 84, 83, 1953, 81, 1952, 78, + 1950, 1948, 1945, 94, 93, 91, 1959, 88, 1958, 85, 1955, 99, 97, 95, 1961, 1086, 1085, 1083, 1081, 1078, 100, + 1090, 1089, 1087, 1091, 49, 47, 1917, 44, 1915, 1913, 1910, 1907, 59, 1926, 56, 1925, 53, 1922, 1919, 66, 64, + 1931, 61, 1929, 1042, 1040, 1038, 71, 1035, 70, 1032, 68, 1048, 1047, 1045, 1043, 1050, 1049, 12, 10, 1869, 1867, + 1864, 1861, 21, 1880, 19, 1877, 1874, 1871, 28, 1888, 25, 1886, 22, 1883, 982, 980, 977, 974, 32, 30, 991, 989, + 987, 984, 34, 995, 994, 992, 2151, 2150, 2147, 2146, 2144, 356, 355, 354, 2149, 2139, 2138, 2136, 2134, 1359, + 343, 341, 338, 2143, 335, 2141, 348, 347, 346, 1376, 1374, 2124, 2123, 2121, 2119, 1326, 2116, 1324, 310, 308, + 305, 2131, 302, 2129, 298, 2127, 320, 318, 316, 313, 2133, 322, 321, 1355, 1353, 1351, 1357, 2092, 2091, 2089, + 2087, 1276, 2084, 1274, 2081, 1271, 259, 2102, 256, 2100, 252, 2098, 2095, 272, 269, 2108, 266, 2106, 281, 279, + 277, 1317, 1315, 1313, 1310, 282, 1321, 1319, 2039, 2037, 2035, 2032, 1203, 2029, 1200, 1197, 207, 2053, 205, + 2051, 201, 2049, 2046, 2043, 220, 218, 2064, 215, 2062, 211, 2059, 228, 226, 223, 2069, 1259, 1257, 1254, 232, + 1251, 230, 1267, 1265, 1263, 2316, 2315, 2312, 2311, 2309, 2314, 2304, 2303, 2301, 2299, 1593, 2308, 2306, 590, + 2288, 2287, 2285, 2283, 1578, 2280, 1577, 2295, 2293, 2291, 579, 577, 574, 571, 2298, 582, 581, 1592, 2263, 2262, + 2260, 2258, 1545, 2255, 1544, 2252, 1541, 2273, 2271, 2269, 2266, 1550, 535, 532, 2279, 528, 2277, 546, 543, 549, + 1575, 1573, 2224, 2222, 2220, 1486, 2217, 1485, 2214, 1482, 1479, 2238, 2236, 2234, 2231, 1496, 2228, 1492, 480, + 477, 2248, 473, 2246, 469, 2243, 490, 487, 2251, 497, 1537, 1535, 1532, 2477, 2476, 2474, 2479, 2469, 2468, 2466, + 2464, 1730, 2473, 2471, 2453, 2452, 2450, 2448, 1729, 2445, 1728, 2460, 2458, 2456, 2463, 805, 804, 2428, 2427, + 2425, 2423, 1725, 2420, 1724, 2417, 1722, 2438, 2436, 2434, 2431, 1727, 2444, 2442, 793, 791, 788, 795, 2388, + 2386, 2384, 1697, 2381, 1696, 2378, 1694, 1692, 2402, 2400, 2398, 2395, 1703, 2392, 1701, 2412, 2410, 2407, 751, + 748, 744, 2416, 759, 757, 1807, 2620, 2618, 1806, 1805, 2611, 2609, 2607, 2614, 1802, 1801, 1799, 2594, 2592, + 2590, 2587, 1804, 2600, 2598, 1794, 1793, 1791, 1789, 2564, 2562, 2560, 2557, 1798, 2554, 1796, 2574, 2572, 2569, + 2578, 1847, 1846, 2722, 1843, 1842, 1840, 1845, 2716, 2714, 1835, 1834, 1832, 1830, 1839, 1837, 2700, 2698, 2695, + 2704, 1817, 1811, 1810, 897, 862, 1777, 829, 826, 838, 1760, 1758, 808, 2481, 1741, 1740, 1738, 1743, 2624, 1818, + 2726, 2776, 782, 740, 737, 1715, 686, 679, 695, 1682, 1680, 639, 628, 2339, 647, 644, 1645, 1643, 1640, 1648, + 602, 600, 597, 595, 2320, 593, 2318, 609, 607, 604, 1611, 1610, 1608, 1606, 613, 1615, 1613, 2328, 926, 924, 892, + 886, 899, 857, 850, 2505, 1778, 824, 823, 821, 819, 2488, 818, 2486, 833, 831, 828, 840, 1761, 1759, 2649, 2632, + 2630, 2746, 2734, 2732, 2782, 2781, 570, 567, 1587, 531, 527, 523, 540, 1566, 1564, 476, 467, 463, 2240, 486, + 483, 1524, 1521, 1518, 1529, 411, 403, 2192, 399, 2189, 423, 416, 1462, 1457, 1454, 428, 1468, 1465, 2210, 366, + 363, 2158, 360, 2156, 357, 2153, 376, 373, 370, 2163, 1410, 1409, 1407, 1405, 382, 1402, 380, 1417, 1415, 1412, + 1421, 2175, 2174, 777, 774, 771, 784, 732, 725, 722, 2404, 743, 1716, 676, 674, 668, 2363, 665, 2360, 685, 1684, + 1681, 626, 624, 622, 2335, 620, 2333, 617, 2330, 641, 635, 649, 1646, 1644, 1642, 2566, 928, 925, 2530, 2527, + 894, 891, 888, 2501, 2499, 2496, 858, 856, 854, 851, 1779, 2692, 2668, 2665, 2645, 2643, 2640, 2651, 2768, 2759, + 2757, 2744, 2743, 2741, 2748, 352, 1382, 340, 337, 333, 1371, 1369, 307, 300, 296, 2126, 315, 312, 1347, 1342, + 1350, 261, 258, 250, 2097, 246, 2094, 271, 268, 264, 1306, 1301, 1298, 276, 1312, 1309, 2115, 203, 2048, 195, + 2045, 191, 2041, 213, 209, 2056, 1246, 1244, 1238, 225, 1234, 222, 1256, 1253, 1249, 1262, 2080, 2079, 154, 1997, + 150, 1995, 147, 1992, 1989, 163, 160, 2004, 156, 2001, 1175, 1174, 1172, 1170, 1167, 170, 1164, 167, 1185, 1183, + 1180, 1177, 174, 1190, 1188, 2025, 2024, 2022, 587, 586, 564, 559, 556, 2290, 573, 1588, 520, 518, 512, 2268, + 508, 2265, 530, 1568, 1565, 461, 457, 2233, 450, 2230, 446, 2226, 479, 471, 489, 1526, 1523, 1520, 397, 395, + 2185, 392, 2183, 389, 2180, 2177, 410, 2194, 402, 422, 1463, 1461, 1459, 1456, 1470, 2455, 799, 2433, 2430, 779, + 776, 773, 2397, 2394, 2390, 734, 728, 724, 746, 1717, 2356, 2354, 2351, 2348, 1658, 677, 675, 673, 670, 667, 688, + 1685, 1683, 2606, 2589, 2586, 2559, 2556, 2552, 927, 2523, 2521, 2518, 2515, 1784, 2532, 895, 893, 890, 2718, + 2709, 2707, 2689, 2687, 2684, 2663, 2662, 2660, 2658, 1825, 2667, 2769, 1852, 2760, 2758, 142, 141, 1139, 1138, + 134, 132, 129, 126, 1982, 1129, 1128, 1126, 1131, 113, 111, 108, 105, 1972, 101, 1970, 120, 118, 115, 1109, 1108, + 1106, 1104, 123, 1113, 1111, 82, 79, 1951, 75, 1949, 72, 1946, 92, 89, 86, 1956, 1077, 1076, 1074, 1072, 98, + 1069, 96, 1084, 1082, 1079, 1088, 1968, 1967, 48, 45, 1916, 42, 1914, 39, 1911, 1908, 60, 57, 54, 1923, 50, 1920, + 1031, 1030, 1028, 1026, 67, 1023, 65, 1020, 62, 1041, 1039, 1036, 1033, 69, 1046, 1044, 1944, 1943, 1941, 11, 9, + 1868, 7, 1865, 1862, 1859, 20, 1878, 16, 1875, 13, 1872, 970, 968, 966, 963, 29, 960, 26, 23, 983, 981, 978, 975, + 33, 971, 31, 990, 988, 985, 1906, 1904, 1902, 993, 351, 2145, 1383, 331, 330, 328, 326, 2137, 323, 2135, 339, + 1372, 1370, 294, 293, 291, 289, 2122, 286, 2120, 283, 2117, 309, 303, 317, 1348, 1346, 1344, 245, 244, 242, 2090, + 239, 2088, 236, 2085, 2082, 260, 2099, 249, 270, 1307, 1305, 1303, 1300, 1314, 189, 2038, 186, 2036, 183, 2033, + 2030, 2026, 206, 198, 2047, 194, 216, 1247, 1245, 1243, 1240, 227, 1237, 1255, 2310, 2302, 2300, 2286, 2284, + 2281, 565, 563, 561, 558, 575, 1589, 2261, 2259, 2256, 2253, 1542, 521, 519, 517, 514, 2270, 511, 533, 1569, + 1567, 2223, 2221, 2218, 2215, 1483, 2211, 1480, 459, 456, 453, 2232, 449, 474, 491, 1527, 1525, 1522, 2475, 2467, + 2465, 2451, 2449, 2446, 801, 800, 2426, 2424, 2421, 2418, 1723, 2435, 780, 778, 775, 2387, 2385, 2382, 2379, + 1695, 2375, 1693, 2396, 735, 733, 730, 727, 749, 1718, 2616, 2615, 2604, 2603, 2601, 2584, 2583, 2581, 2579, + 1800, 2591, 2550, 2549, 2547, 2545, 1792, 2542, 1790, 2558, 929, 2719, 1841, 2710, 2708, 1833, 1831, 2690, 2688, + 2686, 1815, 1809, 1808, 1774, 1756, 1754, 1737, 1736, 1734, 1739, 1816, 1711, 1676, 1674, 633, 629, 1638, 1636, + 1633, 1641, 598, 1605, 1604, 1602, 1600, 605, 1609, 1607, 2327, 887, 853, 1775, 822, 820, 1757, 1755, 1584, 524, + 1560, 1558, 468, 464, 1514, 1511, 1508, 1519, 408, 404, 400, 1452, 1447, 1444, 417, 1458, 1455, 2208, 364, 361, + 358, 2154, 1401, 1400, 1398, 1396, 374, 1393, 371, 1408, 1406, 1403, 1413, 2173, 2172, 772, 726, 723, 1712, 672, + 669, 666, 682, 1678, 1675, 625, 623, 621, 618, 2331, 636, 632, 1639, 1637, 1635, 920, 918, 884, 880, 889, 849, + 848, 847, 846, 2497, 855, 852, 1776, 2641, 2742, 2787, 1380, 334, 1367, 1365, 301, 297, 1340, 1338, 1335, 1343, + 255, 251, 247, 1296, 1291, 1288, 265, 1302, 1299, 2113, 204, 196, 192, 2042, 1232, 1230, 1224, 214, 1220, 210, + 1242, 1239, 1235, 1250, 2077, 2075, 151, 148, 1993, 144, 1990, 1163, 1162, 1160, 1158, 1155, 161, 1152, 157, + 1173, 1171, 1168, 1165, 168, 1181, 1178, 2021, 2020, 2018, 2023, 585, 560, 557, 1585, 516, 509, 1562, 1559, 458, + 447, 2227, 472, 1516, 1513, 1510, 398, 396, 393, 390, 2181, 386, 2178, 407, 1453, 1451, 1449, 1446, 420, 1460, + 2209, 769, 764, 720, 712, 2391, 729, 1713, 664, 663, 661, 659, 2352, 656, 2349, 671, 1679, 1677, 2553, 922, 919, + 2519, 2516, 885, 883, 881, 2685, 2661, 2659, 2767, 2756, 2755, 140, 1137, 1136, 130, 127, 1125, 1124, 1122, 1127, + 109, 106, 102, 1103, 1102, 1100, 1098, 116, 1107, 1105, 1980, 80, 76, 73, 1947, 1068, 1067, 1065, 1063, 90, 1060, + 87, 1075, 1073, 1070, 1080, 1966, 1965, 46, 43, 40, 1912, 36, 1909, 1019, 1018, 1016, 1014, 58, 1011, 55, 1008, + 51, 1029, 1027, 1024, 1021, 63, 1037, 1034, 1940, 1939, 1937, 1942, 8, 1866, 4, 1863, 1, 1860, 956, 954, 952, + 949, 946, 17, 14, 969, 967, 964, 961, 27, 957, 24, 979, 976, 972, 1901, 1900, 1898, 1896, 986, 1905, 1903, 350, + 349, 1381, 329, 327, 324, 1368, 1366, 292, 290, 287, 284, 2118, 304, 1341, 1339, 1337, 1345, 243, 240, 237, 2086, + 233, 2083, 254, 1297, 1295, 1293, 1290, 1304, 2114, 190, 187, 184, 2034, 180, 2031, 177, 2027, 199, 1233, 1231, + 1229, 1226, 217, 1223, 1241, 2078, 2076, 584, 555, 554, 552, 550, 2282, 562, 1586, 507, 506, 504, 502, 2257, 499, + 2254, 515, 1563, 1561, 445, 443, 441, 2219, 438, 2216, 435, 2212, 460, 454, 475, 1517, 1515, 1512, 2447, 798, + 797, 2422, 2419, 770, 768, 766, 2383, 2380, 2376, 721, 719, 717, 714, 731, 1714, 2602, 2582, 2580, 2548, 2546, + 2543, 923, 921, 2717, 2706, 2705, 2683, 2682, 2680, 1771, 1752, 1750, 1733, 1732, 1731, 1735, 1814, 1707, 1670, + 1668, 1631, 1629, 1626, 1634, 1599, 1598, 1596, 1594, 1603, 1601, 2326, 1772, 1753, 1751, 1581, 1554, 1552, 1504, + 1501, 1498, 1509, 1442, 1437, 1434, 401, 1448, 1445, 2206, 1392, 1391, 1389, 1387, 1384, 359, 1399, 1397, 1394, + 1404, 2171, 2170, 1708, 1672, 1669, 619, 1632, 1630, 1628, 1773, 1378, 1363, 1361, 1333, 1328, 1336, 1286, 1281, + 1278, 248, 1292, 1289, 2111, 1218, 1216, 1210, 197, 1206, 193, 1228, 1225, 1221, 1236, 2073, 2071, 1151, 1150, + 1148, 1146, 152, 1143, 149, 1140, 145, 1161, 1159, 1156, 1153, 158, 1169, 1166, 2017, 2016, 2014, 2019, 1582, + 510, 1556, 1553, 452, 448, 1506, 1500, 394, 391, 387, 1443, 1441, 1439, 1436, 1450, 2207, 765, 716, 713, 1709, + 662, 660, 657, 1673, 1671, 916, 914, 879, 878, 877, 882, 1135, 1134, 1121, 1120, 1118, 1123, 1097, 1096, 1094, + 1092, 103, 1101, 1099, 1979, 1059, 1058, 1056, 1054, 77, 1051, 74, 1066, 1064, 1061, 1071, 1964, 1963, 1007, + 1006, 1004, 1002, 999, 41, 996, 37, 1017, 1015, 1012, 1009, 52, 1025, 1022, 1936, 1935, 1933, 1938, 942, 940, + 938, 935, 932, 5, 2, 955, 953, 950, 947, 18, 943, 15, 965, 962, 958, 1895, 1894, 1892, 1890, 973, 1899, 1897, + 1379, 325, 1364, 1362, 288, 285, 1334, 1332, 1330, 241, 238, 234, 1287, 1285, 1283, 1280, 1294, 2112, 188, 185, + 181, 178, 2028, 1219, 1217, 1215, 1212, 200, 1209, 1227, 2074, 2072, 583, 553, 551, 1583, 505, 503, 500, 513, + 1557, 1555, 444, 442, 439, 436, 2213, 455, 451, 1507, 1505, 1502, 796, 763, 762, 760, 767, 711, 710, 708, 706, + 2377, 718, 715, 1710, 2544, 917, 915, 2681, 1627, 1597, 1595, 2325, 1769, 1749, 1747, 1499, 1438, 1435, 2204, + 1390, 1388, 1385, 1395, 2169, 2167, 1704, 1665, 1662, 1625, 1623, 1620, 1770, 1329, 1282, 1279, 2109, 1214, 1207, + 1222, 2068, 2065, 1149, 1147, 1144, 1141, 146, 1157, 1154, 2013, 2011, 2008, 2015, 1579, 1549, 1546, 1495, 1487, + 1433, 1431, 1428, 1425, 388, 1440, 2205, 1705, 658, 1667, 1664, 1119, 1095, 1093, 1978, 1057, 1055, 1052, 1062, + 1962, 1960, 1005, 1003, 1000, 997, 38, 1013, 1010, 1932, 1930, 1927, 1934, 941, 939, 936, 933, 6, 930, 3, 951, + 948, 944, 1889, 1887, 1884, 1881, 959, 1893, 1891, 35, 1377, 1360, 1358, 1327, 1325, 1322, 1331, 1277, 1275, + 1272, 1269, 235, 1284, 2110, 1205, 1204, 1201, 1198, 182, 1195, 179, 1213, 2070, 2067, 1580, 501, 1551, 1548, + 440, 437, 1497, 1494, 1490, 1503, 761, 709, 707, 1706, 913, 912, 2198, 1386, 2164, 2161, 1621, 1766, 2103, 1208, + 2058, 2054, 1145, 1142, 2005, 2002, 1999, 2009, 1488, 1429, 1426, 2200, 1698, 1659, 1656, 1975, 1053, 1957, 1954, + 1001, 998, 1924, 1921, 1918, 1928, 937, 934, 931, 1879, 1876, 1873, 1870, 945, 1885, 1882, 1323, 1273, 1270, + 2105, 1202, 1199, 1196, 1211, 2061, 2057, 1576, 1543, 1540, 1484, 1481, 1478, 1491, 1700 + ]); + + /* + * Copyright 2007 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.List; + /** + * @author Guenther Grau + */ + /*public final*/ class PDF417DetectorResult { + constructor(bits, points) { + this.bits = bits; + this.points = points; + } + getBits() { + return this.bits; + } + getPoints() { + return this.points; + } + } + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.ArrayList; + // import java.util.Arrays; + // import java.util.List; + // import java.util.Map; + /** + *

Encapsulates logic that can detect a PDF417 Code in an image, even if the + * PDF417 Code is rotated or skewed, or partially obscured.

+ * + * @author SITA Lab (kevin.osullivan@sita.aero) + * @author dswitkin@google.com (Daniel Switkin) + * @author Guenther Grau + */ + /*public*/ /*final*/ class Detector$3 { + /** + *

Detects a PDF417 Code in an image. Only checks 0 and 180 degree rotations.

+ * + * @param image barcode image to decode + * @param hints optional hints to detector + * @param multiple if true, then the image is searched for multiple codes. If false, then at most one code will + * be found and returned + * @return {@link PDF417DetectorResult} encapsulating results of detecting a PDF417 code + * @throws NotFoundException if no PDF417 Code can be found + */ + static detectMultiple(image, hints, multiple) { + // TODO detection improvement, tryHarder could try several different luminance thresholds/blackpoints or even + // different binarizers + // boolean tryHarder = hints != null && hints.containsKey(DecodeHintType.TRY_HARDER); + let bitMatrix = image.getBlackMatrix(); + let barcodeCoordinates = Detector$3.detect(multiple, bitMatrix); + if (!barcodeCoordinates.length) { + bitMatrix = bitMatrix.clone(); + bitMatrix.rotate180(); + barcodeCoordinates = Detector$3.detect(multiple, bitMatrix); + } + return new PDF417DetectorResult(bitMatrix, barcodeCoordinates); + } + /** + * Detects PDF417 codes in an image. Only checks 0 degree rotation + * @param multiple if true, then the image is searched for multiple codes. If false, then at most one code will + * be found and returned + * @param bitMatrix bit matrix to detect barcodes in + * @return List of ResultPoint arrays containing the coordinates of found barcodes + */ + static detect(multiple, bitMatrix) { + const barcodeCoordinates = new Array(); + let row = 0; + let column = 0; + let foundBarcodeInRow = false; + while (row < bitMatrix.getHeight()) { + const vertices = Detector$3.findVertices(bitMatrix, row, column); + if (vertices[0] == null && vertices[3] == null) { + if (!foundBarcodeInRow) { + // we didn't find any barcode so that's the end of searching + break; + } + // we didn't find a barcode starting at the given column and row. Try again from the first column and slightly + // below the lowest barcode we found so far. + foundBarcodeInRow = false; + column = 0; + for (const barcodeCoordinate of barcodeCoordinates) { + if (barcodeCoordinate[1] != null) { + row = Math.trunc(Math.max(row, barcodeCoordinate[1].getY())); + } + if (barcodeCoordinate[3] != null) { + row = Math.max(row, Math.trunc(barcodeCoordinate[3].getY())); + } + } + row += Detector$3.ROW_STEP; + continue; + } + foundBarcodeInRow = true; + barcodeCoordinates.push(vertices); + if (!multiple) { + break; + } + // if we didn't find a right row indicator column, then continue the search for the next barcode after the + // start pattern of the barcode just found. + if (vertices[2] != null) { + column = Math.trunc(vertices[2].getX()); + row = Math.trunc(vertices[2].getY()); + } + else { + column = Math.trunc(vertices[4].getX()); + row = Math.trunc(vertices[4].getY()); + } + } + return barcodeCoordinates; + } + /** + * Locate the vertices and the codewords area of a black blob using the Start + * and Stop patterns as locators. + * + * @param matrix the scanned barcode image. + * @return an array containing the vertices: + * vertices[0] x, y top left barcode + * vertices[1] x, y bottom left barcode + * vertices[2] x, y top right barcode + * vertices[3] x, y bottom right barcode + * vertices[4] x, y top left codeword area + * vertices[5] x, y bottom left codeword area + * vertices[6] x, y top right codeword area + * vertices[7] x, y bottom right codeword area + */ + static findVertices(matrix, startRow, startColumn) { + const height = matrix.getHeight(); + const width = matrix.getWidth(); + // const result = new ResultPoint[8]; + const result = new Array(8); + Detector$3.copyToResult(result, Detector$3.findRowsWithPattern(matrix, height, width, startRow, startColumn, Detector$3.START_PATTERN), Detector$3.INDEXES_START_PATTERN); + if (result[4] != null) { + startColumn = Math.trunc(result[4].getX()); + startRow = Math.trunc(result[4].getY()); + } + Detector$3.copyToResult(result, Detector$3.findRowsWithPattern(matrix, height, width, startRow, startColumn, Detector$3.STOP_PATTERN), Detector$3.INDEXES_STOP_PATTERN); + return result; + } + static copyToResult(result, tmpResult, destinationIndexes) { + for (let i = 0; i < destinationIndexes.length; i++) { + result[destinationIndexes[i]] = tmpResult[i]; + } + } + static findRowsWithPattern(matrix, height, width, startRow, startColumn, pattern) { + // const result = new ResultPoint[4]; + const result = new Array(4); + let found = false; + const counters = new Int32Array(pattern.length); + for (; startRow < height; startRow += Detector$3.ROW_STEP) { + let loc = Detector$3.findGuardPattern(matrix, startColumn, startRow, width, false, pattern, counters); + if (loc != null) { + while (startRow > 0) { + const previousRowLoc = Detector$3.findGuardPattern(matrix, startColumn, --startRow, width, false, pattern, counters); + if (previousRowLoc != null) { + loc = previousRowLoc; + } + else { + startRow++; + break; + } + } + result[0] = new ResultPoint(loc[0], startRow); + result[1] = new ResultPoint(loc[1], startRow); + found = true; + break; + } + } + let stopRow = startRow + 1; + // Last row of the current symbol that contains pattern + if (found) { + let skippedRowCount = 0; + let previousRowLoc = Int32Array.from([Math.trunc(result[0].getX()), Math.trunc(result[1].getX())]); + for (; stopRow < height; stopRow++) { + const loc = Detector$3.findGuardPattern(matrix, previousRowLoc[0], stopRow, width, false, pattern, counters); + // a found pattern is only considered to belong to the same barcode if the start and end positions + // don't differ too much. Pattern drift should be not bigger than two for consecutive rows. With + // a higher number of skipped rows drift could be larger. To keep it simple for now, we allow a slightly + // larger drift and don't check for skipped rows. + if (loc != null && + Math.abs(previousRowLoc[0] - loc[0]) < Detector$3.MAX_PATTERN_DRIFT && + Math.abs(previousRowLoc[1] - loc[1]) < Detector$3.MAX_PATTERN_DRIFT) { + previousRowLoc = loc; + skippedRowCount = 0; + } + else { + if (skippedRowCount > Detector$3.SKIPPED_ROW_COUNT_MAX) { + break; + } + else { + skippedRowCount++; + } + } + } + stopRow -= skippedRowCount + 1; + result[2] = new ResultPoint(previousRowLoc[0], stopRow); + result[3] = new ResultPoint(previousRowLoc[1], stopRow); + } + if (stopRow - startRow < Detector$3.BARCODE_MIN_HEIGHT) { + Arrays.fill(result, null); + } + return result; + } + /** + * @param matrix row of black/white values to search + * @param column x position to start search + * @param row y position to start search + * @param width the number of pixels to search on this row + * @param pattern pattern of counts of number of black and white pixels that are + * being searched for as a pattern + * @param counters array of counters, as long as pattern, to re-use + * @return start/end horizontal offset of guard pattern, as an array of two ints. + */ + static findGuardPattern(matrix, column, row, width, whiteFirst, pattern, counters) { + Arrays.fillWithin(counters, 0, counters.length, 0); + let patternStart = column; + let pixelDrift = 0; + // if there are black pixels left of the current pixel shift to the left, but only for MAX_PIXEL_DRIFT pixels + while (matrix.get(patternStart, row) && patternStart > 0 && pixelDrift++ < Detector$3.MAX_PIXEL_DRIFT) { + patternStart--; + } + let x = patternStart; + let counterPosition = 0; + let patternLength = pattern.length; + for (let isWhite = whiteFirst; x < width; x++) { + let pixel = matrix.get(x, row); + if (pixel !== isWhite) { + counters[counterPosition]++; + } + else { + if (counterPosition === patternLength - 1) { + if (Detector$3.patternMatchVariance(counters, pattern, Detector$3.MAX_INDIVIDUAL_VARIANCE) < Detector$3.MAX_AVG_VARIANCE) { + return new Int32Array([patternStart, x]); + } + patternStart += counters[0] + counters[1]; + System.arraycopy(counters, 2, counters, 0, counterPosition - 1); + counters[counterPosition - 1] = 0; + counters[counterPosition] = 0; + counterPosition--; + } + else { + counterPosition++; + } + counters[counterPosition] = 1; + isWhite = !isWhite; + } + } + if (counterPosition === patternLength - 1 && + Detector$3.patternMatchVariance(counters, pattern, Detector$3.MAX_INDIVIDUAL_VARIANCE) < Detector$3.MAX_AVG_VARIANCE) { + return new Int32Array([patternStart, x - 1]); + } + return null; + } + /** + * Determines how closely a set of observed counts of runs of black/white + * values matches a given target pattern. This is reported as the ratio of + * the total variance from the expected pattern proportions across all + * pattern elements, to the length of the pattern. + * + * @param counters observed counters + * @param pattern expected pattern + * @param maxIndividualVariance The most any counter can differ before we give up + * @return ratio of total variance between counters and pattern compared to total pattern size + */ + static patternMatchVariance(counters, pattern, maxIndividualVariance) { + let numCounters = counters.length; + let total = 0; + let patternLength = 0; + for (let i = 0; i < numCounters; i++) { + total += counters[i]; + patternLength += pattern[i]; + } + if (total < patternLength) { + // If we don't even have one pixel per unit of bar width, assume this + // is too small to reliably match, so fail: + return /*Float.POSITIVE_INFINITY*/ Infinity; + } + // We're going to fake floating-point math in integers. We just need to use more bits. + // Scale up patternLength so that intermediate values below like scaledCounter will have + // more "significant digits". + let unitBarWidth = total / patternLength; + maxIndividualVariance *= unitBarWidth; + let totalVariance = 0.0; + for (let x = 0; x < numCounters; x++) { + let counter = counters[x]; + let scaledPattern = pattern[x] * unitBarWidth; + let variance = counter > scaledPattern ? counter - scaledPattern : scaledPattern - counter; + if (variance > maxIndividualVariance) { + return /*Float.POSITIVE_INFINITY*/ Infinity; + } + totalVariance += variance; + } + return totalVariance / total; + } + } + Detector$3.INDEXES_START_PATTERN = Int32Array.from([0, 4, 1, 5]); + Detector$3.INDEXES_STOP_PATTERN = Int32Array.from([6, 2, 7, 3]); + Detector$3.MAX_AVG_VARIANCE = 0.42; + Detector$3.MAX_INDIVIDUAL_VARIANCE = 0.8; + // B S B S B S B S Bar/Space pattern + // 11111111 0 1 0 1 0 1 000 + Detector$3.START_PATTERN = Int32Array.from([8, 1, 1, 1, 1, 1, 1, 3]); + // 1111111 0 1 000 1 0 1 00 1 + Detector$3.STOP_PATTERN = Int32Array.from([7, 1, 1, 3, 1, 1, 1, 2, 1]); + Detector$3.MAX_PIXEL_DRIFT = 3; + Detector$3.MAX_PATTERN_DRIFT = 5; + // if we set the value too low, then we don't detect the correct height of the bar if the start patterns are damaged. + // if we set the value too high, then we might detect the start pattern from a neighbor barcode. + Detector$3.SKIPPED_ROW_COUNT_MAX = 25; + // A PDF471 barcode should have at least 3 rows, with each row being >= 3 times the module width. Therefore it should be at least + // 9 pixels tall. To be conservative, we use about half the size to ensure we don't miss it. + Detector$3.ROW_STEP = 5; + Detector$3.BARCODE_MIN_HEIGHT = 10; + + /* + * Copyright 2012 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Sean Owen + * @see com.google.zxing.common.reedsolomon.GenericGFPoly + */ + /*final*/ class ModulusPoly { + constructor(field, coefficients) { + if (coefficients.length === 0) { + throw new IllegalArgumentException(); + } + this.field = field; + let coefficientsLength = /*int*/ coefficients.length; + if (coefficientsLength > 1 && coefficients[0] === 0) { + // Leading term must be non-zero for anything except the constant polynomial "0" + let firstNonZero = /*int*/ 1; + while (firstNonZero < coefficientsLength && coefficients[firstNonZero] === 0) { + firstNonZero++; + } + if (firstNonZero === coefficientsLength) { + this.coefficients = new Int32Array([0]); + } + else { + this.coefficients = new Int32Array(coefficientsLength - firstNonZero); + System.arraycopy(coefficients, firstNonZero, this.coefficients, 0, this.coefficients.length); + } + } + else { + this.coefficients = coefficients; + } + } + getCoefficients() { + return this.coefficients; + } + /** + * @return degree of this polynomial + */ + getDegree() { + return this.coefficients.length - 1; + } + /** + * @return true iff this polynomial is the monomial "0" + */ + isZero() { + return this.coefficients[0] === 0; + } + /** + * @return coefficient of x^degree term in this polynomial + */ + getCoefficient(degree) { + return this.coefficients[this.coefficients.length - 1 - degree]; + } + /** + * @return evaluation of this polynomial at a given point + */ + evaluateAt(a) { + if (a === 0) { + // Just return the x^0 coefficient + return this.getCoefficient(0); + } + if (a === 1) { + // Just the sum of the coefficients + let sum = /*int*/ 0; + for (let coefficient /*int*/ of this.coefficients) { + sum = this.field.add(sum, coefficient); + } + return sum; + } + let result = /*int*/ this.coefficients[0]; + let size = /*int*/ this.coefficients.length; + for (let i /*int*/ = 1; i < size; i++) { + result = this.field.add(this.field.multiply(a, result), this.coefficients[i]); + } + return result; + } + add(other) { + if (!this.field.equals(other.field)) { + throw new IllegalArgumentException('ModulusPolys do not have same ModulusGF field'); + } + if (this.isZero()) { + return other; + } + if (other.isZero()) { + return this; + } + let smallerCoefficients = this.coefficients; + let largerCoefficients = other.coefficients; + if (smallerCoefficients.length > largerCoefficients.length) { + let temp = smallerCoefficients; + smallerCoefficients = largerCoefficients; + largerCoefficients = temp; + } + let sumDiff = new Int32Array(largerCoefficients.length); + let lengthDiff = /*int*/ largerCoefficients.length - smallerCoefficients.length; + // Copy high-order terms only found in higher-degree polynomial's coefficients + System.arraycopy(largerCoefficients, 0, sumDiff, 0, lengthDiff); + for (let i /*int*/ = lengthDiff; i < largerCoefficients.length; i++) { + sumDiff[i] = this.field.add(smallerCoefficients[i - lengthDiff], largerCoefficients[i]); + } + return new ModulusPoly(this.field, sumDiff); + } + subtract(other) { + if (!this.field.equals(other.field)) { + throw new IllegalArgumentException('ModulusPolys do not have same ModulusGF field'); + } + if (other.isZero()) { + return this; + } + return this.add(other.negative()); + } + multiply(other) { + if (other instanceof ModulusPoly) { + return this.multiplyOther(other); + } + return this.multiplyScalar(other); + } + multiplyOther(other) { + if (!this.field.equals(other.field)) { + throw new IllegalArgumentException('ModulusPolys do not have same ModulusGF field'); + } + if (this.isZero() || other.isZero()) { + // return this.field.getZero(); + return new ModulusPoly(this.field, new Int32Array([0])); + } + let aCoefficients = this.coefficients; + let aLength = /*int*/ aCoefficients.length; + let bCoefficients = other.coefficients; + let bLength = /*int*/ bCoefficients.length; + let product = new Int32Array(aLength + bLength - 1); + for (let i /*int*/ = 0; i < aLength; i++) { + let aCoeff = /*int*/ aCoefficients[i]; + for (let j /*int*/ = 0; j < bLength; j++) { + product[i + j] = this.field.add(product[i + j], this.field.multiply(aCoeff, bCoefficients[j])); + } + } + return new ModulusPoly(this.field, product); + } + negative() { + let size = /*int*/ this.coefficients.length; + let negativeCoefficients = new Int32Array(size); + for (let i /*int*/ = 0; i < size; i++) { + negativeCoefficients[i] = this.field.subtract(0, this.coefficients[i]); + } + return new ModulusPoly(this.field, negativeCoefficients); + } + multiplyScalar(scalar) { + if (scalar === 0) { + return new ModulusPoly(this.field, new Int32Array([0])); + } + if (scalar === 1) { + return this; + } + let size = /*int*/ this.coefficients.length; + let product = new Int32Array(size); + for (let i /*int*/ = 0; i < size; i++) { + product[i] = this.field.multiply(this.coefficients[i], scalar); + } + return new ModulusPoly(this.field, product); + } + multiplyByMonomial(degree, coefficient) { + if (degree < 0) { + throw new IllegalArgumentException(); + } + if (coefficient === 0) { + return new ModulusPoly(this.field, new Int32Array([0])); + } + let size = /*int*/ this.coefficients.length; + let product = new Int32Array(size + degree); + for (let i /*int*/ = 0; i < size; i++) { + product[i] = this.field.multiply(this.coefficients[i], coefficient); + } + return new ModulusPoly(this.field, product); + } + /* + ModulusPoly[] divide(other: ModulusPoly) { + if (!field.equals(other.field)) { + throw new IllegalArgumentException("ModulusPolys do not have same ModulusGF field"); + } + if (other.isZero()) { + throw new IllegalArgumentException("Divide by 0"); + } + + let quotient: ModulusPoly = field.getZero(); + let remainder: ModulusPoly = this; + + let denominatorLeadingTerm: /*int/ number = other.getCoefficient(other.getDegree()); + let inverseDenominatorLeadingTerm: /*int/ number = field.inverse(denominatorLeadingTerm); + + while (remainder.getDegree() >= other.getDegree() && !remainder.isZero()) { + let degreeDifference: /*int/ number = remainder.getDegree() - other.getDegree(); + let scale: /*int/ number = field.multiply(remainder.getCoefficient(remainder.getDegree()), inverseDenominatorLeadingTerm); + let term: ModulusPoly = other.multiplyByMonomial(degreeDifference, scale); + let iterationQuotient: ModulusPoly = field.buildMonomial(degreeDifference, scale); + quotient = quotient.add(iterationQuotient); + remainder = remainder.subtract(term); + } + + return new ModulusPoly[] { quotient, remainder }; + } + */ + // @Override + toString() { + let result = new StringBuilder( /*8 * this.getDegree()*/); // dynamic string size in JS + for (let degree /*int*/ = this.getDegree(); degree >= 0; degree--) { + let coefficient = /*int*/ this.getCoefficient(degree); + if (coefficient !== 0) { + if (coefficient < 0) { + result.append(' - '); + coefficient = -coefficient; + } + else { + if (result.length() > 0) { + result.append(' + '); + } + } + if (degree === 0 || coefficient !== 1) { + result.append(coefficient); + } + if (degree !== 0) { + if (degree === 1) { + result.append('x'); + } + else { + result.append('x^'); + result.append(degree); + } + } + } + } + return result.toString(); + } + } + + class ModulusBase { + add(a, b) { + return (a + b) % this.modulus; + } + subtract(a, b) { + return (this.modulus + a - b) % this.modulus; + } + exp(a) { + return this.expTable[a]; + } + log(a) { + if (a === 0) { + throw new IllegalArgumentException(); + } + return this.logTable[a]; + } + inverse(a) { + if (a === 0) { + throw new ArithmeticException(); + } + return this.expTable[this.modulus - this.logTable[a] - 1]; + } + multiply(a, b) { + if (a === 0 || b === 0) { + return 0; + } + return this.expTable[(this.logTable[a] + this.logTable[b]) % (this.modulus - 1)]; + } + getSize() { + return this.modulus; + } + equals(o) { + return o === this; + } + } + + /* + * Copyright 2012 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

A field based on powers of a generator integer, modulo some modulus.

+ * + * @author Sean Owen + * @see com.google.zxing.common.reedsolomon.GenericGF + */ + /*public final*/ class ModulusGF extends ModulusBase { + // private /*final*/ modulus: /*int*/ number; + constructor(modulus, generator) { + super(); + this.modulus = modulus; + this.expTable = new Int32Array(modulus); + this.logTable = new Int32Array(modulus); + let x = /*int*/ 1; + for (let i /*int*/ = 0; i < modulus; i++) { + this.expTable[i] = x; + x = (x * generator) % modulus; + } + for (let i /*int*/ = 0; i < modulus - 1; i++) { + this.logTable[this.expTable[i]] = i; + } + // logTable[0] == 0 but this should never be used + this.zero = new ModulusPoly(this, new Int32Array([0])); + this.one = new ModulusPoly(this, new Int32Array([1])); + } + getZero() { + return this.zero; + } + getOne() { + return this.one; + } + buildMonomial(degree, coefficient) { + if (degree < 0) { + throw new IllegalArgumentException(); + } + if (coefficient === 0) { + return this.zero; + } + let coefficients = new Int32Array(degree + 1); + coefficients[0] = coefficient; + return new ModulusPoly(this, coefficients); + } + } + ModulusGF.PDF417_GF = new ModulusGF(PDF417Common.NUMBER_OF_CODEWORDS, 3); + + /* + * Copyright 2012 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

PDF417 error correction implementation.

+ * + *

This example + * is quite useful in understanding the algorithm.

+ * + * @author Sean Owen + * @see com.google.zxing.common.reedsolomon.ReedSolomonDecoder + */ + /*public final*/ class ErrorCorrection { + constructor() { + this.field = ModulusGF.PDF417_GF; + } + /** + * @param received received codewords + * @param numECCodewords number of those codewords used for EC + * @param erasures location of erasures + * @return number of errors + * @throws ChecksumException if errors cannot be corrected, maybe because of too many errors + */ + decode(received, numECCodewords, erasures) { + let poly = new ModulusPoly(this.field, received); + let S = new Int32Array(numECCodewords); + let error = false; + for (let i /*int*/ = numECCodewords; i > 0; i--) { + let evaluation = poly.evaluateAt(this.field.exp(i)); + S[numECCodewords - i] = evaluation; + if (evaluation !== 0) { + error = true; + } + } + if (!error) { + return 0; + } + let knownErrors = this.field.getOne(); + if (erasures != null) { + for (const erasure of erasures) { + let b = this.field.exp(received.length - 1 - erasure); + // Add (1 - bx) term: + let term = new ModulusPoly(this.field, new Int32Array([this.field.subtract(0, b), 1])); + knownErrors = knownErrors.multiply(term); + } + } + let syndrome = new ModulusPoly(this.field, S); + // syndrome = syndrome.multiply(knownErrors); + let sigmaOmega = this.runEuclideanAlgorithm(this.field.buildMonomial(numECCodewords, 1), syndrome, numECCodewords); + let sigma = sigmaOmega[0]; + let omega = sigmaOmega[1]; + // sigma = sigma.multiply(knownErrors); + let errorLocations = this.findErrorLocations(sigma); + let errorMagnitudes = this.findErrorMagnitudes(omega, sigma, errorLocations); + for (let i /*int*/ = 0; i < errorLocations.length; i++) { + let position = received.length - 1 - this.field.log(errorLocations[i]); + if (position < 0) { + throw ChecksumException.getChecksumInstance(); + } + received[position] = this.field.subtract(received[position], errorMagnitudes[i]); + } + return errorLocations.length; + } + /** + * + * @param ModulusPoly + * @param a + * @param ModulusPoly + * @param b + * @param int + * @param R + * @throws ChecksumException + */ + runEuclideanAlgorithm(a, b, R) { + // Assume a's degree is >= b's + if (a.getDegree() < b.getDegree()) { + let temp = a; + a = b; + b = temp; + } + let rLast = a; + let r = b; + let tLast = this.field.getZero(); + let t = this.field.getOne(); + // Run Euclidean algorithm until r's degree is less than R/2 + while (r.getDegree() >= Math.round(R / 2)) { + let rLastLast = rLast; + let tLastLast = tLast; + rLast = r; + tLast = t; + // Divide rLastLast by rLast, with quotient in q and remainder in r + if (rLast.isZero()) { + // Oops, Euclidean algorithm already terminated? + throw ChecksumException.getChecksumInstance(); + } + r = rLastLast; + let q = this.field.getZero(); + let denominatorLeadingTerm = rLast.getCoefficient(rLast.getDegree()); + let dltInverse = this.field.inverse(denominatorLeadingTerm); + while (r.getDegree() >= rLast.getDegree() && !r.isZero()) { + let degreeDiff = r.getDegree() - rLast.getDegree(); + let scale = this.field.multiply(r.getCoefficient(r.getDegree()), dltInverse); + q = q.add(this.field.buildMonomial(degreeDiff, scale)); + r = r.subtract(rLast.multiplyByMonomial(degreeDiff, scale)); + } + t = q.multiply(tLast).subtract(tLastLast).negative(); + } + let sigmaTildeAtZero = t.getCoefficient(0); + if (sigmaTildeAtZero === 0) { + throw ChecksumException.getChecksumInstance(); + } + let inverse = this.field.inverse(sigmaTildeAtZero); + let sigma = t.multiply(inverse); + let omega = r.multiply(inverse); + return [sigma, omega]; + } + /** + * + * @param errorLocator + * @throws ChecksumException + */ + findErrorLocations(errorLocator) { + // This is a direct application of Chien's search + let numErrors = errorLocator.getDegree(); + let result = new Int32Array(numErrors); + let e = 0; + for (let i /*int*/ = 1; i < this.field.getSize() && e < numErrors; i++) { + if (errorLocator.evaluateAt(i) === 0) { + result[e] = this.field.inverse(i); + e++; + } + } + if (e !== numErrors) { + throw ChecksumException.getChecksumInstance(); + } + return result; + } + findErrorMagnitudes(errorEvaluator, errorLocator, errorLocations) { + let errorLocatorDegree = errorLocator.getDegree(); + let formalDerivativeCoefficients = new Int32Array(errorLocatorDegree); + for (let i /*int*/ = 1; i <= errorLocatorDegree; i++) { + formalDerivativeCoefficients[errorLocatorDegree - i] = + this.field.multiply(i, errorLocator.getCoefficient(i)); + } + let formalDerivative = new ModulusPoly(this.field, formalDerivativeCoefficients); + // This is directly applying Forney's Formula + let s = errorLocations.length; + let result = new Int32Array(s); + for (let i /*int*/ = 0; i < s; i++) { + let xiInverse = this.field.inverse(errorLocations[i]); + let numerator = this.field.subtract(0, errorEvaluator.evaluateAt(xiInverse)); + let denominator = this.field.inverse(formalDerivative.evaluateAt(xiInverse)); + result[i] = this.field.multiply(numerator, denominator); + } + return result; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Guenther Grau + */ + /*final*/ class BoundingBox { + constructor(image, topLeft, bottomLeft, topRight, bottomRight) { + if (image instanceof BoundingBox) { + this.constructor_2(image); + } + else { + this.constructor_1(image, topLeft, bottomLeft, topRight, bottomRight); + } + } + /** + * + * @param image + * @param topLeft + * @param bottomLeft + * @param topRight + * @param bottomRight + * + * @throws NotFoundException + */ + constructor_1(image, topLeft, bottomLeft, topRight, bottomRight) { + const leftUnspecified = topLeft == null || bottomLeft == null; + const rightUnspecified = topRight == null || bottomRight == null; + if (leftUnspecified && rightUnspecified) { + throw new NotFoundException(); + } + if (leftUnspecified) { + topLeft = new ResultPoint(0, topRight.getY()); + bottomLeft = new ResultPoint(0, bottomRight.getY()); + } + else if (rightUnspecified) { + topRight = new ResultPoint(image.getWidth() - 1, topLeft.getY()); + bottomRight = new ResultPoint(image.getWidth() - 1, bottomLeft.getY()); + } + this.image = image; + this.topLeft = topLeft; + this.bottomLeft = bottomLeft; + this.topRight = topRight; + this.bottomRight = bottomRight; + this.minX = Math.trunc(Math.min(topLeft.getX(), bottomLeft.getX())); + this.maxX = Math.trunc(Math.max(topRight.getX(), bottomRight.getX())); + this.minY = Math.trunc(Math.min(topLeft.getY(), topRight.getY())); + this.maxY = Math.trunc(Math.max(bottomLeft.getY(), bottomRight.getY())); + } + constructor_2(boundingBox) { + this.image = boundingBox.image; + this.topLeft = boundingBox.getTopLeft(); + this.bottomLeft = boundingBox.getBottomLeft(); + this.topRight = boundingBox.getTopRight(); + this.bottomRight = boundingBox.getBottomRight(); + this.minX = boundingBox.getMinX(); + this.maxX = boundingBox.getMaxX(); + this.minY = boundingBox.getMinY(); + this.maxY = boundingBox.getMaxY(); + } + /** + * @throws NotFoundException + */ + static merge(leftBox, rightBox) { + if (leftBox == null) { + return rightBox; + } + if (rightBox == null) { + return leftBox; + } + return new BoundingBox(leftBox.image, leftBox.topLeft, leftBox.bottomLeft, rightBox.topRight, rightBox.bottomRight); + } + /** + * @throws NotFoundException + */ + addMissingRows(missingStartRows, missingEndRows, isLeft) { + let newTopLeft = this.topLeft; + let newBottomLeft = this.bottomLeft; + let newTopRight = this.topRight; + let newBottomRight = this.bottomRight; + if (missingStartRows > 0) { + let top = isLeft ? this.topLeft : this.topRight; + let newMinY = Math.trunc(top.getY() - missingStartRows); + if (newMinY < 0) { + newMinY = 0; + } + let newTop = new ResultPoint(top.getX(), newMinY); + if (isLeft) { + newTopLeft = newTop; + } + else { + newTopRight = newTop; + } + } + if (missingEndRows > 0) { + let bottom = isLeft ? this.bottomLeft : this.bottomRight; + let newMaxY = Math.trunc(bottom.getY() + missingEndRows); + if (newMaxY >= this.image.getHeight()) { + newMaxY = this.image.getHeight() - 1; + } + let newBottom = new ResultPoint(bottom.getX(), newMaxY); + if (isLeft) { + newBottomLeft = newBottom; + } + else { + newBottomRight = newBottom; + } + } + return new BoundingBox(this.image, newTopLeft, newBottomLeft, newTopRight, newBottomRight); + } + getMinX() { + return this.minX; + } + getMaxX() { + return this.maxX; + } + getMinY() { + return this.minY; + } + getMaxY() { + return this.maxY; + } + getTopLeft() { + return this.topLeft; + } + getTopRight() { + return this.topRight; + } + getBottomLeft() { + return this.bottomLeft; + } + getBottomRight() { + return this.bottomRight; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // package com.google.zxing.pdf417.decoder; + /** + * @author Guenther Grau + */ + /*final*/ class BarcodeMetadata { + constructor(columnCount, rowCountUpperPart, rowCountLowerPart, errorCorrectionLevel) { + this.columnCount = columnCount; + this.errorCorrectionLevel = errorCorrectionLevel; + this.rowCountUpperPart = rowCountUpperPart; + this.rowCountLowerPart = rowCountLowerPart; + this.rowCount = rowCountUpperPart + rowCountLowerPart; + } + getColumnCount() { + return this.columnCount; + } + getErrorCorrectionLevel() { + return this.errorCorrectionLevel; + } + getRowCount() { + return this.rowCount; + } + getRowCountUpperPart() { + return this.rowCountUpperPart; + } + getRowCountLowerPart() { + return this.rowCountLowerPart; + } + } + + /** + * Java Formatter class polyfill that works in the JS way. + */ + class Formatter { + constructor() { + this.buffer = ''; + } + /** + * + * @see https://stackoverflow.com/a/13439711/4367683 + * + * @param str + * @param arr + */ + static form(str, arr) { + let i = -1; + function callback(exp, p0, p1, p2, p3, p4) { + if (exp === '%%') + return '%'; + if (arr[++i] === undefined) + return undefined; + exp = p2 ? parseInt(p2.substr(1)) : undefined; + let base = p3 ? parseInt(p3.substr(1)) : undefined; + let val; + switch (p4) { + case 's': + val = arr[i]; + break; + case 'c': + val = arr[i][0]; + break; + case 'f': + val = parseFloat(arr[i]).toFixed(exp); + break; + case 'p': + val = parseFloat(arr[i]).toPrecision(exp); + break; + case 'e': + val = parseFloat(arr[i]).toExponential(exp); + break; + case 'x': + val = parseInt(arr[i]).toString(base ? base : 16); + break; + case 'd': + val = parseFloat(parseInt(arr[i], base ? base : 10).toPrecision(exp)).toFixed(0); + break; + } + val = typeof val === 'object' ? JSON.stringify(val) : (+val).toString(base); + let size = parseInt(p1); /* padding size */ + let ch = p1 && (p1[0] + '') === '0' ? '0' : ' '; /* isnull? */ + while (val.length < size) + val = p0 !== undefined ? val + ch : ch + val; /* isminus? */ + return val; + } + let regex = /%(-)?(0?[0-9]+)?([.][0-9]+)?([#][0-9]+)?([scfpexd%])/g; + return str.replace(regex, callback); + } + /** + * + * @param append The new string to append. + * @param args Argumets values to be formated. + */ + format(append, ...args) { + this.buffer += Formatter.form(append, args); + } + /** + * Returns the Formatter string value. + */ + toString() { + return this.buffer; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Guenther Grau + */ + class DetectionResultColumn { + constructor(boundingBox) { + this.boundingBox = new BoundingBox(boundingBox); + // this.codewords = new Codeword[boundingBox.getMaxY() - boundingBox.getMinY() + 1]; + this.codewords = new Array(boundingBox.getMaxY() - boundingBox.getMinY() + 1); + } + /*final*/ getCodewordNearby(imageRow) { + let codeword = this.getCodeword(imageRow); + if (codeword != null) { + return codeword; + } + for (let i = 1; i < DetectionResultColumn.MAX_NEARBY_DISTANCE; i++) { + let nearImageRow = this.imageRowToCodewordIndex(imageRow) - i; + if (nearImageRow >= 0) { + codeword = this.codewords[nearImageRow]; + if (codeword != null) { + return codeword; + } + } + nearImageRow = this.imageRowToCodewordIndex(imageRow) + i; + if (nearImageRow < this.codewords.length) { + codeword = this.codewords[nearImageRow]; + if (codeword != null) { + return codeword; + } + } + } + return null; + } + /*final int*/ imageRowToCodewordIndex(imageRow) { + return imageRow - this.boundingBox.getMinY(); + } + /*final void*/ setCodeword(imageRow, codeword) { + this.codewords[this.imageRowToCodewordIndex(imageRow)] = codeword; + } + /*final*/ getCodeword(imageRow) { + return this.codewords[this.imageRowToCodewordIndex(imageRow)]; + } + /*final*/ getBoundingBox() { + return this.boundingBox; + } + /*final*/ getCodewords() { + return this.codewords; + } + // @Override + toString() { + const formatter = new Formatter(); + let row = 0; + for (const codeword of this.codewords) { + if (codeword == null) { + formatter.format('%3d: | %n', row++); + continue; + } + formatter.format('%3d: %3d|%3d%n', row++, codeword.getRowNumber(), codeword.getValue()); + } + return formatter.toString(); + } + } + DetectionResultColumn.MAX_NEARBY_DISTANCE = 5; + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.ArrayList; + // import java.util.Collection; + // import java.util.HashMap; + // import java.util.Map; + // import java.util.Map.Entry; + /** + * @author Guenther Grau + */ + /*final*/ class BarcodeValue { + constructor() { + this.values = new Map(); + } + /** + * Add an occurrence of a value + */ + setValue(value) { + value = Math.trunc(value); + let confidence = this.values.get(value); + if (confidence == null) { + confidence = 0; + } + confidence++; + this.values.set(value, confidence); + } + /** + * Determines the maximum occurrence of a set value and returns all values which were set with this occurrence. + * @return an array of int, containing the values with the highest occurrence, or null, if no value was set + */ + getValue() { + let maxConfidence = -1; + let result = new Array(); + for (const [key, value] of this.values.entries()) { + const entry = { + getKey: () => key, + getValue: () => value, + }; + if (entry.getValue() > maxConfidence) { + maxConfidence = entry.getValue(); + result = []; + result.push(entry.getKey()); + } + else if (entry.getValue() === maxConfidence) { + result.push(entry.getKey()); + } + } + return PDF417Common.toIntArray(result); + } + getConfidence(value) { + return this.values.get(value); + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Guenther Grau + */ + /*final*/ class DetectionResultRowIndicatorColumn extends DetectionResultColumn { + constructor(boundingBox, isLeft) { + super(boundingBox); + this._isLeft = isLeft; + } + setRowNumbers() { + for (let codeword /*Codeword*/ of this.getCodewords()) { + if (codeword != null) { + codeword.setRowNumberAsRowIndicatorColumn(); + } + } + } + // TODO implement properly + // TODO maybe we should add missing codewords to store the correct row number to make + // finding row numbers for other columns easier + // use row height count to make detection of invalid row numbers more reliable + adjustCompleteIndicatorColumnRowNumbers(barcodeMetadata) { + let codewords = this.getCodewords(); + this.setRowNumbers(); + this.removeIncorrectCodewords(codewords, barcodeMetadata); + let boundingBox = this.getBoundingBox(); + let top = this._isLeft ? boundingBox.getTopLeft() : boundingBox.getTopRight(); + let bottom = this._isLeft ? boundingBox.getBottomLeft() : boundingBox.getBottomRight(); + let firstRow = this.imageRowToCodewordIndex(Math.trunc(top.getY())); + let lastRow = this.imageRowToCodewordIndex(Math.trunc(bottom.getY())); + // We need to be careful using the average row height. Barcode could be skewed so that we have smaller and + // taller rows + // float averageRowHeight = (lastRow - firstRow) / /*(float)*/ barcodeMetadata.getRowCount(); + let barcodeRow = -1; + let maxRowHeight = 1; + let currentRowHeight = 0; + for (let codewordsRow /*int*/ = firstRow; codewordsRow < lastRow; codewordsRow++) { + if (codewords[codewordsRow] == null) { + continue; + } + let codeword = codewords[codewordsRow]; + // float expectedRowNumber = (codewordsRow - firstRow) / averageRowHeight; + // if (Math.abs(codeword.getRowNumber() - expectedRowNumber) > 2) { + // SimpleLog.log(LEVEL.WARNING, + // "Removing codeword, rowNumberSkew too high, codeword[" + codewordsRow + "]: Expected Row: " + + // expectedRowNumber + ", RealRow: " + codeword.getRowNumber() + ", value: " + codeword.getValue()); + // codewords[codewordsRow] = null; + // } + let rowDifference = codeword.getRowNumber() - barcodeRow; + // TODO improve handling with case where first row indicator doesn't start with 0 + if (rowDifference === 0) { + currentRowHeight++; + } + else if (rowDifference === 1) { + maxRowHeight = Math.max(maxRowHeight, currentRowHeight); + currentRowHeight = 1; + barcodeRow = codeword.getRowNumber(); + } + else if (rowDifference < 0 || + codeword.getRowNumber() >= barcodeMetadata.getRowCount() || + rowDifference > codewordsRow) { + codewords[codewordsRow] = null; + } + else { + let checkedRows; + if (maxRowHeight > 2) { + checkedRows = (maxRowHeight - 2) * rowDifference; + } + else { + checkedRows = rowDifference; + } + let closePreviousCodewordFound = checkedRows >= codewordsRow; + for (let i /*int*/ = 1; i <= checkedRows && !closePreviousCodewordFound; i++) { + // there must be (height * rowDifference) number of codewords missing. For now we assume height = 1. + // This should hopefully get rid of most problems already. + closePreviousCodewordFound = codewords[codewordsRow - i] != null; + } + if (closePreviousCodewordFound) { + codewords[codewordsRow] = null; + } + else { + barcodeRow = codeword.getRowNumber(); + currentRowHeight = 1; + } + } + } + // return (int) (averageRowHeight + 0.5); + } + getRowHeights() { + let barcodeMetadata = this.getBarcodeMetadata(); + if (barcodeMetadata == null) { + return null; + } + this.adjustIncompleteIndicatorColumnRowNumbers(barcodeMetadata); + let result = new Int32Array(barcodeMetadata.getRowCount()); + for (let codeword /*Codeword*/ of this.getCodewords()) { + if (codeword != null) { + let rowNumber = codeword.getRowNumber(); + if (rowNumber >= result.length) { + // We have more rows than the barcode metadata allows for, ignore them. + continue; + } + result[rowNumber]++; + } // else throw exception? + } + return result; + } + // TODO maybe we should add missing codewords to store the correct row number to make + // finding row numbers for other columns easier + // use row height count to make detection of invalid row numbers more reliable + adjustIncompleteIndicatorColumnRowNumbers(barcodeMetadata) { + let boundingBox = this.getBoundingBox(); + let top = this._isLeft ? boundingBox.getTopLeft() : boundingBox.getTopRight(); + let bottom = this._isLeft ? boundingBox.getBottomLeft() : boundingBox.getBottomRight(); + let firstRow = this.imageRowToCodewordIndex(Math.trunc(top.getY())); + let lastRow = this.imageRowToCodewordIndex(Math.trunc(bottom.getY())); + // float averageRowHeight = (lastRow - firstRow) / /*(float)*/ barcodeMetadata.getRowCount(); + let codewords = this.getCodewords(); + let barcodeRow = -1; + for (let codewordsRow /*int*/ = firstRow; codewordsRow < lastRow; codewordsRow++) { + if (codewords[codewordsRow] == null) { + continue; + } + let codeword = codewords[codewordsRow]; + codeword.setRowNumberAsRowIndicatorColumn(); + let rowDifference = codeword.getRowNumber() - barcodeRow; + // TODO improve handling with case where first row indicator doesn't start with 0 + if (rowDifference === 0) ; + else if (rowDifference === 1) { + barcodeRow = codeword.getRowNumber(); + } + else if (codeword.getRowNumber() >= barcodeMetadata.getRowCount()) { + codewords[codewordsRow] = null; + } + else { + barcodeRow = codeword.getRowNumber(); + } + } + // return (int) (averageRowHeight + 0.5); + } + getBarcodeMetadata() { + let codewords = this.getCodewords(); + let barcodeColumnCount = new BarcodeValue(); + let barcodeRowCountUpperPart = new BarcodeValue(); + let barcodeRowCountLowerPart = new BarcodeValue(); + let barcodeECLevel = new BarcodeValue(); + for (let codeword /*Codeword*/ of codewords) { + if (codeword == null) { + continue; + } + codeword.setRowNumberAsRowIndicatorColumn(); + let rowIndicatorValue = codeword.getValue() % 30; + let codewordRowNumber = codeword.getRowNumber(); + if (!this._isLeft) { + codewordRowNumber += 2; + } + switch (codewordRowNumber % 3) { + case 0: + barcodeRowCountUpperPart.setValue(rowIndicatorValue * 3 + 1); + break; + case 1: + barcodeECLevel.setValue(rowIndicatorValue / 3); + barcodeRowCountLowerPart.setValue(rowIndicatorValue % 3); + break; + case 2: + barcodeColumnCount.setValue(rowIndicatorValue + 1); + break; + } + } + // Maybe we should check if we have ambiguous values? + if ((barcodeColumnCount.getValue().length === 0) || + (barcodeRowCountUpperPart.getValue().length === 0) || + (barcodeRowCountLowerPart.getValue().length === 0) || + (barcodeECLevel.getValue().length === 0) || + barcodeColumnCount.getValue()[0] < 1 || + barcodeRowCountUpperPart.getValue()[0] + barcodeRowCountLowerPart.getValue()[0] < PDF417Common.MIN_ROWS_IN_BARCODE || + barcodeRowCountUpperPart.getValue()[0] + barcodeRowCountLowerPart.getValue()[0] > PDF417Common.MAX_ROWS_IN_BARCODE) { + return null; + } + let barcodeMetadata = new BarcodeMetadata(barcodeColumnCount.getValue()[0], barcodeRowCountUpperPart.getValue()[0], barcodeRowCountLowerPart.getValue()[0], barcodeECLevel.getValue()[0]); + this.removeIncorrectCodewords(codewords, barcodeMetadata); + return barcodeMetadata; + } + removeIncorrectCodewords(codewords, barcodeMetadata) { + // Remove codewords which do not match the metadata + // TODO Maybe we should keep the incorrect codewords for the start and end positions? + for (let codewordRow /*int*/ = 0; codewordRow < codewords.length; codewordRow++) { + let codeword = codewords[codewordRow]; + if (codewords[codewordRow] == null) { + continue; + } + let rowIndicatorValue = codeword.getValue() % 30; + let codewordRowNumber = codeword.getRowNumber(); + if (codewordRowNumber > barcodeMetadata.getRowCount()) { + codewords[codewordRow] = null; + continue; + } + if (!this._isLeft) { + codewordRowNumber += 2; + } + switch (codewordRowNumber % 3) { + case 0: + if (rowIndicatorValue * 3 + 1 !== barcodeMetadata.getRowCountUpperPart()) { + codewords[codewordRow] = null; + } + break; + case 1: + if (Math.trunc(rowIndicatorValue / 3) !== barcodeMetadata.getErrorCorrectionLevel() || + rowIndicatorValue % 3 !== barcodeMetadata.getRowCountLowerPart()) { + codewords[codewordRow] = null; + } + break; + case 2: + if (rowIndicatorValue + 1 !== barcodeMetadata.getColumnCount()) { + codewords[codewordRow] = null; + } + break; + } + } + } + isLeft() { + return this._isLeft; + } + // @Override + toString() { + return 'IsLeft: ' + this._isLeft + '\n' + super.toString(); + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Guenther Grau + */ + /*final*/ class DetectionResult { + constructor(barcodeMetadata, boundingBox) { + /*final*/ this.ADJUST_ROW_NUMBER_SKIP = 2; + this.barcodeMetadata = barcodeMetadata; + this.barcodeColumnCount = barcodeMetadata.getColumnCount(); + this.boundingBox = boundingBox; + // this.detectionResultColumns = new DetectionResultColumn[this.barcodeColumnCount + 2]; + this.detectionResultColumns = new Array(this.barcodeColumnCount + 2); + } + getDetectionResultColumns() { + this.adjustIndicatorColumnRowNumbers(this.detectionResultColumns[0]); + this.adjustIndicatorColumnRowNumbers(this.detectionResultColumns[this.barcodeColumnCount + 1]); + let unadjustedCodewordCount = PDF417Common.MAX_CODEWORDS_IN_BARCODE; + let previousUnadjustedCount; + do { + previousUnadjustedCount = unadjustedCodewordCount; + unadjustedCodewordCount = this.adjustRowNumbersAndGetCount(); + } while (unadjustedCodewordCount > 0 && unadjustedCodewordCount < previousUnadjustedCount); + return this.detectionResultColumns; + } + adjustIndicatorColumnRowNumbers(detectionResultColumn) { + if (detectionResultColumn != null) { + detectionResultColumn + .adjustCompleteIndicatorColumnRowNumbers(this.barcodeMetadata); + } + } + // TODO ensure that no detected codewords with unknown row number are left + // we should be able to estimate the row height and use it as a hint for the row number + // we should also fill the rows top to bottom and bottom to top + /** + * @return number of codewords which don't have a valid row number. Note that the count is not accurate as codewords + * will be counted several times. It just serves as an indicator to see when we can stop adjusting row numbers + */ + adjustRowNumbersAndGetCount() { + let unadjustedCount = this.adjustRowNumbersByRow(); + if (unadjustedCount === 0) { + return 0; + } + for (let barcodeColumn /*int*/ = 1; barcodeColumn < this.barcodeColumnCount + 1; barcodeColumn++) { + let codewords = this.detectionResultColumns[barcodeColumn].getCodewords(); + for (let codewordsRow /*int*/ = 0; codewordsRow < codewords.length; codewordsRow++) { + if (codewords[codewordsRow] == null) { + continue; + } + if (!codewords[codewordsRow].hasValidRowNumber()) { + this.adjustRowNumbers(barcodeColumn, codewordsRow, codewords); + } + } + } + return unadjustedCount; + } + adjustRowNumbersByRow() { + this.adjustRowNumbersFromBothRI(); + // TODO we should only do full row adjustments if row numbers of left and right row indicator column match. + // Maybe it's even better to calculated the height (rows: d) and divide it by the number of barcode + // rows. This, together with the LRI and RRI row numbers should allow us to get a good estimate where a row + // number starts and ends. + let unadjustedCount = this.adjustRowNumbersFromLRI(); + return unadjustedCount + this.adjustRowNumbersFromRRI(); + } + adjustRowNumbersFromBothRI() { + if (this.detectionResultColumns[0] == null || this.detectionResultColumns[this.barcodeColumnCount + 1] == null) { + return; + } + let LRIcodewords = this.detectionResultColumns[0].getCodewords(); + let RRIcodewords = this.detectionResultColumns[this.barcodeColumnCount + 1].getCodewords(); + for (let codewordsRow /*int*/ = 0; codewordsRow < LRIcodewords.length; codewordsRow++) { + if (LRIcodewords[codewordsRow] != null && + RRIcodewords[codewordsRow] != null && + LRIcodewords[codewordsRow].getRowNumber() === RRIcodewords[codewordsRow].getRowNumber()) { + for (let barcodeColumn /*int*/ = 1; barcodeColumn <= this.barcodeColumnCount; barcodeColumn++) { + let codeword = this.detectionResultColumns[barcodeColumn].getCodewords()[codewordsRow]; + if (codeword == null) { + continue; + } + codeword.setRowNumber(LRIcodewords[codewordsRow].getRowNumber()); + if (!codeword.hasValidRowNumber()) { + this.detectionResultColumns[barcodeColumn].getCodewords()[codewordsRow] = null; + } + } + } + } + } + adjustRowNumbersFromRRI() { + if (this.detectionResultColumns[this.barcodeColumnCount + 1] == null) { + return 0; + } + let unadjustedCount = 0; + let codewords = this.detectionResultColumns[this.barcodeColumnCount + 1].getCodewords(); + for (let codewordsRow /*int*/ = 0; codewordsRow < codewords.length; codewordsRow++) { + if (codewords[codewordsRow] == null) { + continue; + } + let rowIndicatorRowNumber = codewords[codewordsRow].getRowNumber(); + let invalidRowCounts = 0; + for (let barcodeColumn /*int*/ = this.barcodeColumnCount + 1; barcodeColumn > 0 && invalidRowCounts < this.ADJUST_ROW_NUMBER_SKIP; barcodeColumn--) { + let codeword = this.detectionResultColumns[barcodeColumn].getCodewords()[codewordsRow]; + if (codeword != null) { + invalidRowCounts = DetectionResult.adjustRowNumberIfValid(rowIndicatorRowNumber, invalidRowCounts, codeword); + if (!codeword.hasValidRowNumber()) { + unadjustedCount++; + } + } + } + } + return unadjustedCount; + } + adjustRowNumbersFromLRI() { + if (this.detectionResultColumns[0] == null) { + return 0; + } + let unadjustedCount = 0; + let codewords = this.detectionResultColumns[0].getCodewords(); + for (let codewordsRow /*int*/ = 0; codewordsRow < codewords.length; codewordsRow++) { + if (codewords[codewordsRow] == null) { + continue; + } + let rowIndicatorRowNumber = codewords[codewordsRow].getRowNumber(); + let invalidRowCounts = 0; + for (let barcodeColumn /*int*/ = 1; barcodeColumn < this.barcodeColumnCount + 1 && invalidRowCounts < this.ADJUST_ROW_NUMBER_SKIP; barcodeColumn++) { + let codeword = this.detectionResultColumns[barcodeColumn].getCodewords()[codewordsRow]; + if (codeword != null) { + invalidRowCounts = DetectionResult.adjustRowNumberIfValid(rowIndicatorRowNumber, invalidRowCounts, codeword); + if (!codeword.hasValidRowNumber()) { + unadjustedCount++; + } + } + } + } + return unadjustedCount; + } + static adjustRowNumberIfValid(rowIndicatorRowNumber, invalidRowCounts, codeword) { + if (codeword == null) { + return invalidRowCounts; + } + if (!codeword.hasValidRowNumber()) { + if (codeword.isValidRowNumber(rowIndicatorRowNumber)) { + codeword.setRowNumber(rowIndicatorRowNumber); + invalidRowCounts = 0; + } + else { + ++invalidRowCounts; + } + } + return invalidRowCounts; + } + adjustRowNumbers(barcodeColumn, codewordsRow, codewords) { + let codeword = codewords[codewordsRow]; + let previousColumnCodewords = this.detectionResultColumns[barcodeColumn - 1].getCodewords(); + let nextColumnCodewords = previousColumnCodewords; + if (this.detectionResultColumns[barcodeColumn + 1] != null) { + nextColumnCodewords = this.detectionResultColumns[barcodeColumn + 1].getCodewords(); + } + // let otherCodewords: Codeword[] = new Codeword[14]; + let otherCodewords = new Array(14); + otherCodewords[2] = previousColumnCodewords[codewordsRow]; + otherCodewords[3] = nextColumnCodewords[codewordsRow]; + if (codewordsRow > 0) { + otherCodewords[0] = codewords[codewordsRow - 1]; + otherCodewords[4] = previousColumnCodewords[codewordsRow - 1]; + otherCodewords[5] = nextColumnCodewords[codewordsRow - 1]; + } + if (codewordsRow > 1) { + otherCodewords[8] = codewords[codewordsRow - 2]; + otherCodewords[10] = previousColumnCodewords[codewordsRow - 2]; + otherCodewords[11] = nextColumnCodewords[codewordsRow - 2]; + } + if (codewordsRow < codewords.length - 1) { + otherCodewords[1] = codewords[codewordsRow + 1]; + otherCodewords[6] = previousColumnCodewords[codewordsRow + 1]; + otherCodewords[7] = nextColumnCodewords[codewordsRow + 1]; + } + if (codewordsRow < codewords.length - 2) { + otherCodewords[9] = codewords[codewordsRow + 2]; + otherCodewords[12] = previousColumnCodewords[codewordsRow + 2]; + otherCodewords[13] = nextColumnCodewords[codewordsRow + 2]; + } + for (let otherCodeword of otherCodewords) { + if (DetectionResult.adjustRowNumber(codeword, otherCodeword)) { + return; + } + } + } + /** + * @return true, if row number was adjusted, false otherwise + */ + static adjustRowNumber(codeword, otherCodeword) { + if (otherCodeword == null) { + return false; + } + if (otherCodeword.hasValidRowNumber() && otherCodeword.getBucket() === codeword.getBucket()) { + codeword.setRowNumber(otherCodeword.getRowNumber()); + return true; + } + return false; + } + getBarcodeColumnCount() { + return this.barcodeColumnCount; + } + getBarcodeRowCount() { + return this.barcodeMetadata.getRowCount(); + } + getBarcodeECLevel() { + return this.barcodeMetadata.getErrorCorrectionLevel(); + } + setBoundingBox(boundingBox) { + this.boundingBox = boundingBox; + } + getBoundingBox() { + return this.boundingBox; + } + setDetectionResultColumn(barcodeColumn, detectionResultColumn) { + this.detectionResultColumns[barcodeColumn] = detectionResultColumn; + } + getDetectionResultColumn(barcodeColumn) { + return this.detectionResultColumns[barcodeColumn]; + } + // @Override + toString() { + let rowIndicatorColumn = this.detectionResultColumns[0]; + if (rowIndicatorColumn == null) { + rowIndicatorColumn = this.detectionResultColumns[this.barcodeColumnCount + 1]; + } + // try ( + let formatter = new Formatter(); + // ) { + for (let codewordsRow /*int*/ = 0; codewordsRow < rowIndicatorColumn.getCodewords().length; codewordsRow++) { + formatter.format('CW %3d:', codewordsRow); + for (let barcodeColumn /*int*/ = 0; barcodeColumn < this.barcodeColumnCount + 2; barcodeColumn++) { + if (this.detectionResultColumns[barcodeColumn] == null) { + formatter.format(' | '); + continue; + } + let codeword = this.detectionResultColumns[barcodeColumn].getCodewords()[codewordsRow]; + if (codeword == null) { + formatter.format(' | '); + continue; + } + formatter.format(' %3d|%3d', codeword.getRowNumber(), codeword.getValue()); + } + formatter.format('%n'); + } + return formatter.toString(); + // } + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // package com.google.zxing.pdf417.decoder; + /** + * @author Guenther Grau + */ + /*final*/ class Codeword { + constructor(startX, endX, bucket, value) { + this.rowNumber = Codeword.BARCODE_ROW_UNKNOWN; + this.startX = Math.trunc(startX); + this.endX = Math.trunc(endX); + this.bucket = Math.trunc(bucket); + this.value = Math.trunc(value); + } + hasValidRowNumber() { + return this.isValidRowNumber(this.rowNumber); + } + isValidRowNumber(rowNumber) { + return rowNumber !== Codeword.BARCODE_ROW_UNKNOWN && this.bucket === (rowNumber % 3) * 3; + } + setRowNumberAsRowIndicatorColumn() { + this.rowNumber = Math.trunc((Math.trunc(this.value / 30)) * 3 + Math.trunc(this.bucket / 3)); + } + getWidth() { + return this.endX - this.startX; + } + getStartX() { + return this.startX; + } + getEndX() { + return this.endX; + } + getBucket() { + return this.bucket; + } + getValue() { + return this.value; + } + getRowNumber() { + return this.rowNumber; + } + setRowNumber(rowNumber) { + this.rowNumber = rowNumber; + } + // @Override + toString() { + return this.rowNumber + '|' + this.value; + } + } + Codeword.BARCODE_ROW_UNKNOWN = -1; + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Guenther Grau + * @author creatale GmbH (christoph.schulz@creatale.de) + */ + /*final*/ class PDF417CodewordDecoder { + /* @note + * this action have to be performed before first use of class + * - static constructor + * working with 32bit float (based from Java logic) + */ + static initialize() { + // Pre-computes the symbol ratio table. + for ( /*int*/let i = 0; i < PDF417Common.SYMBOL_TABLE.length; i++) { + let currentSymbol = PDF417Common.SYMBOL_TABLE[i]; + let currentBit = currentSymbol & 0x1; + for ( /*int*/let j = 0; j < PDF417Common.BARS_IN_MODULE; j++) { + let size = 0.0; + while ((currentSymbol & 0x1) === currentBit) { + size += 1.0; + currentSymbol >>= 1; + } + currentBit = currentSymbol & 0x1; + if (!PDF417CodewordDecoder.RATIOS_TABLE[i]) { + PDF417CodewordDecoder.RATIOS_TABLE[i] = new Array(PDF417Common.BARS_IN_MODULE); + } + PDF417CodewordDecoder.RATIOS_TABLE[i][PDF417Common.BARS_IN_MODULE - j - 1] = Math.fround(size / PDF417Common.MODULES_IN_CODEWORD); + } + } + this.bSymbolTableReady = true; + } + static getDecodedValue(moduleBitCount) { + let decodedValue = PDF417CodewordDecoder.getDecodedCodewordValue(PDF417CodewordDecoder.sampleBitCounts(moduleBitCount)); + if (decodedValue !== -1) { + return decodedValue; + } + return PDF417CodewordDecoder.getClosestDecodedValue(moduleBitCount); + } + static sampleBitCounts(moduleBitCount) { + let bitCountSum = MathUtils.sum(moduleBitCount); + let result = new Int32Array(PDF417Common.BARS_IN_MODULE); + let bitCountIndex = 0; + let sumPreviousBits = 0; + for ( /*int*/let i = 0; i < PDF417Common.MODULES_IN_CODEWORD; i++) { + let sampleIndex = bitCountSum / (2 * PDF417Common.MODULES_IN_CODEWORD) + + (i * bitCountSum) / PDF417Common.MODULES_IN_CODEWORD; + if (sumPreviousBits + moduleBitCount[bitCountIndex] <= sampleIndex) { + sumPreviousBits += moduleBitCount[bitCountIndex]; + bitCountIndex++; + } + result[bitCountIndex]++; + } + return result; + } + static getDecodedCodewordValue(moduleBitCount) { + let decodedValue = PDF417CodewordDecoder.getBitValue(moduleBitCount); + return PDF417Common.getCodeword(decodedValue) === -1 ? -1 : decodedValue; + } + static getBitValue(moduleBitCount) { + let result = /*long*/ 0; + for (let /*int*/ i = 0; i < moduleBitCount.length; i++) { + for ( /*int*/let bit = 0; bit < moduleBitCount[i]; bit++) { + result = (result << 1) | (i % 2 === 0 ? 1 : 0); + } + } + return Math.trunc(result); + } + // working with 32bit float (as in Java) + static getClosestDecodedValue(moduleBitCount) { + let bitCountSum = MathUtils.sum(moduleBitCount); + let bitCountRatios = new Array(PDF417Common.BARS_IN_MODULE); + if (bitCountSum > 1) { + for (let /*int*/ i = 0; i < bitCountRatios.length; i++) { + bitCountRatios[i] = Math.fround(moduleBitCount[i] / bitCountSum); + } + } + let bestMatchError = Float.MAX_VALUE; + let bestMatch = -1; + if (!this.bSymbolTableReady) { + PDF417CodewordDecoder.initialize(); + } + for ( /*int*/let j = 0; j < PDF417CodewordDecoder.RATIOS_TABLE.length; j++) { + let error = 0.0; + let ratioTableRow = PDF417CodewordDecoder.RATIOS_TABLE[j]; + for ( /*int*/let k = 0; k < PDF417Common.BARS_IN_MODULE; k++) { + let diff = Math.fround(ratioTableRow[k] - bitCountRatios[k]); + error += Math.fround(diff * diff); + if (error >= bestMatchError) { + break; + } + } + if (error < bestMatchError) { + bestMatchError = error; + bestMatch = PDF417Common.SYMBOL_TABLE[j]; + } + } + return bestMatch; + } + } + // flag that the table is ready for use + PDF417CodewordDecoder.bSymbolTableReady = false; + PDF417CodewordDecoder.RATIOS_TABLE = new Array(PDF417Common.SYMBOL_TABLE.length).map(x => x = new Array(PDF417Common.BARS_IN_MODULE)); + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // package com.google.zxing.pdf417; + /** + * @author Guenther Grau + */ + /*public final*/ class PDF417ResultMetadata { + constructor() { + this.segmentCount = -1; + this.fileSize = -1; + this.timestamp = -1; + this.checksum = -1; + } + /** + * The Segment ID represents the segment of the whole file distributed over different symbols. + * + * @return File segment index + */ + getSegmentIndex() { + return this.segmentIndex; + } + setSegmentIndex(segmentIndex) { + this.segmentIndex = segmentIndex; + } + /** + * Is the same for each related PDF417 symbol + * + * @return File ID + */ + getFileId() { + return this.fileId; + } + setFileId(fileId) { + this.fileId = fileId; + } + /** + * @return always null + * @deprecated use dedicated already parsed fields + */ + // @Deprecated + getOptionalData() { + return this.optionalData; + } + /** + * @param optionalData old optional data format as int array + * @deprecated parse and use new fields + */ + // @Deprecated + setOptionalData(optionalData) { + this.optionalData = optionalData; + } + /** + * @return true if it is the last segment + */ + isLastSegment() { + return this.lastSegment; + } + setLastSegment(lastSegment) { + this.lastSegment = lastSegment; + } + /** + * @return count of segments, -1 if not set + */ + getSegmentCount() { + return this.segmentCount; + } + setSegmentCount(segmentCount /*int*/) { + this.segmentCount = segmentCount; + } + getSender() { + return this.sender || null; + } + setSender(sender) { + this.sender = sender; + } + getAddressee() { + return this.addressee || null; + } + setAddressee(addressee) { + this.addressee = addressee; + } + /** + * Filename of the encoded file + * + * @return filename + */ + getFileName() { + return this.fileName; + } + setFileName(fileName) { + this.fileName = fileName; + } + /** + * filesize in bytes of the encoded file + * + * @return filesize in bytes, -1 if not set + */ + getFileSize() { + return this.fileSize; + } + setFileSize(fileSize /*long*/) { + this.fileSize = fileSize; + } + /** + * 16-bit CRC checksum using CCITT-16 + * + * @return crc checksum, -1 if not set + */ + getChecksum() { + return this.checksum; + } + setChecksum(checksum /*int*/) { + this.checksum = checksum; + } + /** + * unix epock timestamp, elapsed seconds since 1970-01-01 + * + * @return elapsed seconds, -1 if not set + */ + getTimestamp() { + return this.timestamp; + } + setTimestamp(timestamp /*long*/) { + this.timestamp = timestamp; + } + } + + /** + * Ponyfill for Java's Long class. + */ + class Long { + /** + * Parses a string to a number, since JS has no really Int64. + * + * @param num Numeric string. + * @param radix Destination radix. + */ + static parseLong(num, radix = undefined) { + return parseInt(num, radix); + } + } + + /** + * Custom Error class of type Exception. + */ + class NullPointerException extends Exception { + } + NullPointerException.kind = 'NullPointerException'; + + /* + * Copyright (c) 1994, 2004, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + // package java.io; + /** + * This abstract class is the superclass of all classes representing + * an output stream of bytes. An output stream accepts output bytes + * and sends them to some sink. + *

+ * Applications that need to define a subclass of + * OutputStream must always provide at least a method + * that writes one byte of output. + * + * @author Arthur van Hoff + * @see java.io.BufferedOutputStream + * @see java.io.ByteArrayOutputStream + * @see java.io.DataOutputStream + * @see java.io.FilterOutputStream + * @see java.io.InputStream + * @see java.io.OutputStream#write(int) + * @since JDK1.0 + */ + /*public*/ class OutputStream /*implements Closeable, Flushable*/ { + /** + * Writes b.length bytes from the specified byte array + * to this output stream. The general contract for write(b) + * is that it should have exactly the same effect as the call + * write(b, 0, b.length). + * + * @param b the data. + * @exception IOException if an I/O error occurs. + * @see java.io.OutputStream#write(byte[], int, int) + */ + writeBytes(b) { + this.writeBytesOffset(b, 0, b.length); + } + /** + * Writes len bytes from the specified byte array + * starting at offset off to this output stream. + * The general contract for write(b, off, len) is that + * some of the bytes in the array b are written to the + * output stream in order; element b[off] is the first + * byte written and b[off+len-1] is the last byte written + * by this operation. + *

+ * The write method of OutputStream calls + * the write method of one argument on each of the bytes to be + * written out. Subclasses are encouraged to override this method and + * provide a more efficient implementation. + *

+ * If b is null, a + * NullPointerException is thrown. + *

+ * If off is negative, or len is negative, or + * off+len is greater than the length of the array + * b, then an IndexOutOfBoundsException is thrown. + * + * @param b the data. + * @param off the start offset in the data. + * @param len the number of bytes to write. + * @exception IOException if an I/O error occurs. In particular, + * an IOException is thrown if the output + * stream is closed. + */ + writeBytesOffset(b, off, len) { + if (b == null) { + throw new NullPointerException(); + } + else if ((off < 0) || (off > b.length) || (len < 0) || + ((off + len) > b.length) || ((off + len) < 0)) { + throw new IndexOutOfBoundsException(); + } + else if (len === 0) { + return; + } + for (let i = 0; i < len; i++) { + this.write(b[off + i]); + } + } + /** + * Flushes this output stream and forces any buffered output bytes + * to be written out. The general contract of flush is + * that calling it is an indication that, if any bytes previously + * written have been buffered by the implementation of the output + * stream, such bytes should immediately be written to their + * intended destination. + *

+ * If the intended destination of this stream is an abstraction provided by + * the underlying operating system, for example a file, then flushing the + * stream guarantees only that bytes previously written to the stream are + * passed to the operating system for writing; it does not guarantee that + * they are actually written to a physical device such as a disk drive. + *

+ * The flush method of OutputStream does nothing. + * + * @exception IOException if an I/O error occurs. + */ + flush() { + } + /** + * Closes this output stream and releases any system resources + * associated with this stream. The general contract of close + * is that it closes the output stream. A closed stream cannot perform + * output operations and cannot be reopened. + *

+ * The close method of OutputStream does nothing. + * + * @exception IOException if an I/O error occurs. + */ + close() { + } + } + + /** + * Custom Error class of type Exception. + */ + class OutOfMemoryError extends Exception { + } + + /* + * Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + /** + * This class implements an output stream in which the data is + * written into a byte array. The buffer automatically grows as data + * is written to it. + * The data can be retrieved using toByteArray() and + * toString(). + *

+ * Closing a ByteArrayOutputStream has no effect. The methods in + * this class can be called after the stream has been closed without + * generating an IOException. + * + * @author Arthur van Hoff + * @since JDK1.0 + */ + /*public*/ class ByteArrayOutputStream extends OutputStream { + /** + * Creates a new byte array output stream. The buffer capacity is + * initially 32 bytes, though its size increases if necessary. + */ + // public constructor() { + // this(32); + // } + /** + * Creates a new byte array output stream, with a buffer capacity of + * the specified size, in bytes. + * + * @param size the initial size. + * @exception IllegalArgumentException if size is negative. + */ + constructor(size = 32) { + super(); + /** + * The number of valid bytes in the buffer. + */ + this.count = 0; + if (size < 0) { + throw new IllegalArgumentException('Negative initial size: ' + + size); + } + this.buf = new Uint8Array(size); + } + /** + * Increases the capacity if necessary to ensure that it can hold + * at least the number of elements specified by the minimum + * capacity argument. + * + * @param minCapacity the desired minimum capacity + * @throws OutOfMemoryError if {@code minCapacity < 0}. This is + * interpreted as a request for the unsatisfiably large capacity + * {@code (long) Integer.MAX_VALUE + (minCapacity - Integer.MAX_VALUE)}. + */ + ensureCapacity(minCapacity) { + // overflow-conscious code + if (minCapacity - this.buf.length > 0) + this.grow(minCapacity); + } + /** + * Increases the capacity to ensure that it can hold at least the + * number of elements specified by the minimum capacity argument. + * + * @param minCapacity the desired minimum capacity + */ + grow(minCapacity) { + // overflow-conscious code + let oldCapacity = this.buf.length; + let newCapacity = oldCapacity << 1; + if (newCapacity - minCapacity < 0) + newCapacity = minCapacity; + if (newCapacity < 0) { + if (minCapacity < 0) // overflow + throw new OutOfMemoryError(); + newCapacity = Integer.MAX_VALUE; + } + this.buf = Arrays.copyOfUint8Array(this.buf, newCapacity); + } + /** + * Writes the specified byte to this byte array output stream. + * + * @param b the byte to be written. + */ + write(b) { + this.ensureCapacity(this.count + 1); + this.buf[this.count] = /*(byte)*/ b; + this.count += 1; + } + /** + * Writes len bytes from the specified byte array + * starting at offset off to this byte array output stream. + * + * @param b the data. + * @param off the start offset in the data. + * @param len the number of bytes to write. + */ + writeBytesOffset(b, off, len) { + if ((off < 0) || (off > b.length) || (len < 0) || + ((off + len) - b.length > 0)) { + throw new IndexOutOfBoundsException(); + } + this.ensureCapacity(this.count + len); + System.arraycopy(b, off, this.buf, this.count, len); + this.count += len; + } + /** + * Writes the complete contents of this byte array output stream to + * the specified output stream argument, as if by calling the output + * stream's write method using out.write(buf, 0, count). + * + * @param out the output stream to which to write the data. + * @exception IOException if an I/O error occurs. + */ + writeTo(out) { + out.writeBytesOffset(this.buf, 0, this.count); + } + /** + * Resets the count field of this byte array output + * stream to zero, so that all currently accumulated output in the + * output stream is discarded. The output stream can be used again, + * reusing the already allocated buffer space. + * + * @see java.io.ByteArrayInputStream#count + */ + reset() { + this.count = 0; + } + /** + * Creates a newly allocated byte array. Its size is the current + * size of this output stream and the valid contents of the buffer + * have been copied into it. + * + * @return the current contents of this output stream, as a byte array. + * @see java.io.ByteArrayOutputStream#size() + */ + toByteArray() { + return Arrays.copyOfUint8Array(this.buf, this.count); + } + /** + * Returns the current size of the buffer. + * + * @return the value of the count field, which is the number + * of valid bytes in this output stream. + * @see java.io.ByteArrayOutputStream#count + */ + size() { + return this.count; + } + toString(param) { + if (!param) { + return this.toString_void(); + } + if (typeof param === 'string') { + return this.toString_string(param); + } + return this.toString_number(param); + } + /** + * Converts the buffer's contents into a string decoding bytes using the + * platform's default character set. The length of the new String + * is a function of the character set, and hence may not be equal to the + * size of the buffer. + * + *

This method always replaces malformed-input and unmappable-character + * sequences with the default replacement string for the platform's + * default character set. The {@linkplain java.nio.charset.CharsetDecoder} + * class should be used when more control over the decoding process is + * required. + * + * @return String decoded from the buffer's contents. + * @since JDK1.1 + */ + toString_void() { + return new String(this.buf /*, 0, this.count*/).toString(); + } + /** + * Converts the buffer's contents into a string by decoding the bytes using + * the specified {@link java.nio.charset.Charset charsetName}. The length of + * the new String is a function of the charset, and hence may not be + * equal to the length of the byte array. + * + *

This method always replaces malformed-input and unmappable-character + * sequences with this charset's default replacement string. The {@link + * java.nio.charset.CharsetDecoder} class should be used when more control + * over the decoding process is required. + * + * @param charsetName the name of a supported + * {@linkplain java.nio.charset.Charset charset} + * @return String decoded from the buffer's contents. + * @exception UnsupportedEncodingException + * If the named charset is not supported + * @since JDK1.1 + */ + toString_string(charsetName) { + return new String(this.buf /*, 0, this.count, charsetName*/).toString(); + } + /** + * Creates a newly allocated string. Its size is the current size of + * the output stream and the valid contents of the buffer have been + * copied into it. Each character c in the resulting string is + * constructed from the corresponding element b in the byte + * array such that: + * 

+         *     c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))
+         *
+ * + * @deprecated This method does not properly convert bytes into characters. + * As of JDK 1.1, the preferred way to do this is via the + * toString(String enc) method, which takes an encoding-name + * argument, or the toString() method, which uses the + * platform's default character encoding. + * + * @param hibyte the high byte of each resulting Unicode character. + * @return the current contents of the output stream, as a string. + * @see java.io.ByteArrayOutputStream#size() + * @see java.io.ByteArrayOutputStream#toString(String) + * @see java.io.ByteArrayOutputStream#toString() + */ + // @Deprecated + toString_number(hibyte) { + return new String(this.buf /*, hibyte, 0, this.count*/).toString(); + } + /** + * Closing a ByteArrayOutputStream has no effect. The methods in + * this class can be called after the stream has been closed without + * generating an IOException. + *

+ * + * @throws IOException + */ + close() { + } + } + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*private*/ var Mode$2; + (function (Mode) { + Mode[Mode["ALPHA"] = 0] = "ALPHA"; + Mode[Mode["LOWER"] = 1] = "LOWER"; + Mode[Mode["MIXED"] = 2] = "MIXED"; + Mode[Mode["PUNCT"] = 3] = "PUNCT"; + Mode[Mode["ALPHA_SHIFT"] = 4] = "ALPHA_SHIFT"; + Mode[Mode["PUNCT_SHIFT"] = 5] = "PUNCT_SHIFT"; + })(Mode$2 || (Mode$2 = {})); + /** + * Indirectly access the global BigInt constructor, it + * allows browsers that doesn't support BigInt to run + * the library without breaking due to "undefined BigInt" + * errors. + */ + function getBigIntConstructor() { + if (typeof window !== 'undefined') { + return window['BigInt'] || null; + } + if (typeof global !== 'undefined') { + return global['BigInt'] || null; + } + if (typeof self !== 'undefined') { + return self['BigInt'] || null; + } + throw new Error('Can\'t search globals for BigInt!'); + } + /** + * Used to store the BigInt constructor. + */ + let BigInteger; + /** + * This function creates a bigint value. It allows browsers + * that doesn't support BigInt to run the rest of the library + * by not directly accessing the BigInt constructor. + */ + function createBigInt(num) { + if (typeof BigInteger === 'undefined') { + BigInteger = getBigIntConstructor(); + } + if (BigInteger === null) { + throw new Error('BigInt is not supported!'); + } + return BigInteger(num); + } + function getEXP900() { + // in Java - array with length = 16 + let EXP900 = []; + EXP900[0] = createBigInt(1); + let nineHundred = createBigInt(900); + EXP900[1] = nineHundred; + // in Java - array with length = 16 + for (let i /*int*/ = 2; i < 16; i++) { + EXP900[i] = EXP900[i - 1] * nineHundred; + } + return EXP900; + } + /** + *

This class contains the methods for decoding the PDF417 codewords.

+ * + * @author SITA Lab (kevin.osullivan@sita.aero) + * @author Guenther Grau + */ + /*final*/ class DecodedBitStreamParser$2 { + // private DecodedBitStreamParser() { + // } + /** + * + * @param codewords + * @param ecLevel + * + * @throws FormatException + */ + static decode(codewords, ecLevel) { + // pass encoding to result (will be used for decode symbols in byte mode) + let result = new StringBuilder(''); + // let encoding: Charset = StandardCharsets.ISO_8859_1; + let encoding = CharacterSetECI.ISO8859_1; + /** + * @note the next command is specific from this TypeScript library + * because TS can't properly cast some values to char and + * convert it to string later correctly due to encoding + * differences from Java version. As reported here: + * https://github.com/zxing-js/library/pull/264/files#r382831593 + */ + result.enableDecoding(encoding); + // Get compaction mode + let codeIndex = 1; + let code = codewords[codeIndex++]; + let resultMetadata = new PDF417ResultMetadata(); + while (codeIndex < codewords[0]) { + switch (code) { + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + codeIndex = DecodedBitStreamParser$2.textCompaction(codewords, codeIndex, result); + break; + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6: + codeIndex = DecodedBitStreamParser$2.byteCompaction(code, codewords, encoding, codeIndex, result); + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + result.append(/*(char)*/ codewords[codeIndex++]); + break; + case DecodedBitStreamParser$2.NUMERIC_COMPACTION_MODE_LATCH: + codeIndex = DecodedBitStreamParser$2.numericCompaction(codewords, codeIndex, result); + break; + case DecodedBitStreamParser$2.ECI_CHARSET: + let charsetECI = CharacterSetECI.getCharacterSetECIByValue(codewords[codeIndex++]); + // encoding = Charset.forName(charsetECI.getName()); + break; + case DecodedBitStreamParser$2.ECI_GENERAL_PURPOSE: + // Can't do anything with generic ECI; skip its 2 characters + codeIndex += 2; + break; + case DecodedBitStreamParser$2.ECI_USER_DEFINED: + // Can't do anything with user ECI; skip its 1 character + codeIndex++; + break; + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_CONTROL_BLOCK: + codeIndex = DecodedBitStreamParser$2.decodeMacroBlock(codewords, codeIndex, resultMetadata); + break; + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD: + case DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR: + // Should not see these outside a macro block + throw new FormatException(); + default: + // Default to text compaction. During testing numerous barcodes + // appeared to be missing the starting mode. In these cases defaulting + // to text compaction seems to work. + codeIndex--; + codeIndex = DecodedBitStreamParser$2.textCompaction(codewords, codeIndex, result); + break; + } + if (codeIndex < codewords.length) { + code = codewords[codeIndex++]; + } + else { + throw FormatException.getFormatInstance(); + } + } + if (result.length() === 0) { + throw FormatException.getFormatInstance(); + } + let decoderResult = new DecoderResult(null, result.toString(), null, ecLevel); + decoderResult.setOther(resultMetadata); + return decoderResult; + } + /** + * + * @param int + * @param param1 + * @param codewords + * @param int + * @param codeIndex + * @param PDF417ResultMetadata + * @param resultMetadata + * + * @throws FormatException + */ + // @SuppressWarnings("deprecation") + static decodeMacroBlock(codewords, codeIndex, resultMetadata) { + if (codeIndex + DecodedBitStreamParser$2.NUMBER_OF_SEQUENCE_CODEWORDS > codewords[0]) { + // we must have at least two bytes left for the segment index + throw FormatException.getFormatInstance(); + } + let segmentIndexArray = new Int32Array(DecodedBitStreamParser$2.NUMBER_OF_SEQUENCE_CODEWORDS); + for (let i /*int*/ = 0; i < DecodedBitStreamParser$2.NUMBER_OF_SEQUENCE_CODEWORDS; i++, codeIndex++) { + segmentIndexArray[i] = codewords[codeIndex]; + } + resultMetadata.setSegmentIndex(Integer.parseInt(DecodedBitStreamParser$2.decodeBase900toBase10(segmentIndexArray, DecodedBitStreamParser$2.NUMBER_OF_SEQUENCE_CODEWORDS))); + let fileId = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.textCompaction(codewords, codeIndex, fileId); + resultMetadata.setFileId(fileId.toString()); + let optionalFieldsStart = -1; + if (codewords[codeIndex] === DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD) { + optionalFieldsStart = codeIndex + 1; + } + while (codeIndex < codewords[0]) { + switch (codewords[codeIndex]) { + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD: + codeIndex++; + switch (codewords[codeIndex]) { + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_FILE_NAME: + let fileName = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.textCompaction(codewords, codeIndex + 1, fileName); + resultMetadata.setFileName(fileName.toString()); + break; + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_SENDER: + let sender = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.textCompaction(codewords, codeIndex + 1, sender); + resultMetadata.setSender(sender.toString()); + break; + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_ADDRESSEE: + let addressee = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.textCompaction(codewords, codeIndex + 1, addressee); + resultMetadata.setAddressee(addressee.toString()); + break; + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_SEGMENT_COUNT: + let segmentCount = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.numericCompaction(codewords, codeIndex + 1, segmentCount); + resultMetadata.setSegmentCount(Integer.parseInt(segmentCount.toString())); + break; + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_TIME_STAMP: + let timestamp = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.numericCompaction(codewords, codeIndex + 1, timestamp); + resultMetadata.setTimestamp(Long.parseLong(timestamp.toString())); + break; + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_CHECKSUM: + let checksum = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.numericCompaction(codewords, codeIndex + 1, checksum); + resultMetadata.setChecksum(Integer.parseInt(checksum.toString())); + break; + case DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_FILE_SIZE: + let fileSize = new StringBuilder(); + codeIndex = DecodedBitStreamParser$2.numericCompaction(codewords, codeIndex + 1, fileSize); + resultMetadata.setFileSize(Long.parseLong(fileSize.toString())); + break; + default: + throw FormatException.getFormatInstance(); + } + break; + case DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR: + codeIndex++; + resultMetadata.setLastSegment(true); + break; + default: + throw FormatException.getFormatInstance(); + } + } + // copy optional fields to additional options + if (optionalFieldsStart !== -1) { + let optionalFieldsLength = codeIndex - optionalFieldsStart; + if (resultMetadata.isLastSegment()) { + // do not include terminator + optionalFieldsLength--; + } + resultMetadata.setOptionalData(Arrays.copyOfRange(codewords, optionalFieldsStart, optionalFieldsStart + optionalFieldsLength)); + } + return codeIndex; + } + /** + * Text Compaction mode (see 5.4.1.5) permits all printable ASCII characters to be + * encoded, i.e. values 32 - 126 inclusive in accordance with ISO/IEC 646 (IRV), as + * well as selected control characters. + * + * @param codewords The array of codewords (data + error) + * @param codeIndex The current index into the codeword array. + * @param result The decoded data is appended to the result. + * @return The next index into the codeword array. + */ + static textCompaction(codewords, codeIndex, result) { + // 2 character per codeword + let textCompactionData = new Int32Array((codewords[0] - codeIndex) * 2); + // Used to hold the byte compaction value if there is a mode shift + let byteCompactionData = new Int32Array((codewords[0] - codeIndex) * 2); + let index = 0; + let end = false; + while ((codeIndex < codewords[0]) && !end) { + let code = codewords[codeIndex++]; + if (code < DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH) { + textCompactionData[index] = code / 30; + textCompactionData[index + 1] = code % 30; + index += 2; + } + else { + switch (code) { + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + // reinitialize text compaction mode to alpha sub mode + textCompactionData[index++] = DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH; + break; + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6: + case DecodedBitStreamParser$2.NUMERIC_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_CONTROL_BLOCK: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD: + case DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR: + codeIndex--; + end = true; + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + // The Mode Shift codeword 913 shall cause a temporary + // switch from Text Compaction mode to Byte Compaction mode. + // This switch shall be in effect for only the next codeword, + // after which the mode shall revert to the prevailing sub-mode + // of the Text Compaction mode. Codeword 913 is only available + // in Text Compaction mode; its use is described in 5.4.2.4. + textCompactionData[index] = DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE; + code = codewords[codeIndex++]; + byteCompactionData[index] = code; + index++; + break; + } + } + } + DecodedBitStreamParser$2.decodeTextCompaction(textCompactionData, byteCompactionData, index, result); + return codeIndex; + } + /** + * The Text Compaction mode includes all the printable ASCII characters + * (i.e. values from 32 to 126) and three ASCII control characters: HT or tab + * (9: e), LF or line feed (10: e), and CR or carriage + * return (13: e). The Text Compaction mode also includes various latch + * and shift characters which are used exclusively within the mode. The Text + * Compaction mode encodes up to 2 characters per codeword. The compaction rules + * for converting data into PDF417 codewords are defined in 5.4.2.2. The sub-mode + * switches are defined in 5.4.2.3. + * + * @param textCompactionData The text compaction data. + * @param byteCompactionData The byte compaction data if there + * was a mode shift. + * @param length The size of the text compaction and byte compaction data. + * @param result The decoded data is appended to the result. + */ + static decodeTextCompaction(textCompactionData, byteCompactionData, length, result) { + // Beginning from an initial state of the Alpha sub-mode + // The default compaction mode for PDF417 in effect at the start of each symbol shall always be Text + // Compaction mode Alpha sub-mode (alphabetic: uppercase). A latch codeword from another mode to the Text + // Compaction mode shall always switch to the Text Compaction Alpha sub-mode. + let subMode = Mode$2.ALPHA; + let priorToShiftMode = Mode$2.ALPHA; + let i = 0; + while (i < length) { + let subModeCh = textCompactionData[i]; + let ch = /*char*/ ''; + switch (subMode) { + case Mode$2.ALPHA: + // Alpha (alphabetic: uppercase) + if (subModeCh < 26) { + // Upper case Alpha Character + // Note: 65 = 'A' ASCII -> there is byte code of symbol + ch = /*(char)('A' + subModeCh) */ String.fromCharCode(65 + subModeCh); + } + else { + switch (subModeCh) { + case 26: + ch = ' '; + break; + case DecodedBitStreamParser$2.LL: + subMode = Mode$2.LOWER; + break; + case DecodedBitStreamParser$2.ML: + subMode = Mode$2.MIXED; + break; + case DecodedBitStreamParser$2.PS: + // Shift to punctuation + priorToShiftMode = subMode; + subMode = Mode$2.PUNCT_SHIFT; + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + result.append(/*(char)*/ byteCompactionData[i]); + break; + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + subMode = Mode$2.ALPHA; + break; + } + } + break; + case Mode$2.LOWER: + // Lower (alphabetic: lowercase) + if (subModeCh < 26) { + ch = /*(char)('a' + subModeCh)*/ String.fromCharCode(97 + subModeCh); + } + else { + switch (subModeCh) { + case 26: + ch = ' '; + break; + case DecodedBitStreamParser$2.AS: + // Shift to alpha + priorToShiftMode = subMode; + subMode = Mode$2.ALPHA_SHIFT; + break; + case DecodedBitStreamParser$2.ML: + subMode = Mode$2.MIXED; + break; + case DecodedBitStreamParser$2.PS: + // Shift to punctuation + priorToShiftMode = subMode; + subMode = Mode$2.PUNCT_SHIFT; + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + // TODO Does this need to use the current character encoding? See other occurrences below + result.append(/*(char)*/ byteCompactionData[i]); + break; + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + subMode = Mode$2.ALPHA; + break; + } + } + break; + case Mode$2.MIXED: + // Mixed (punctuation: e) + if (subModeCh < DecodedBitStreamParser$2.PL) { + ch = DecodedBitStreamParser$2.MIXED_CHARS[subModeCh]; + } + else { + switch (subModeCh) { + case DecodedBitStreamParser$2.PL: + subMode = Mode$2.PUNCT; + break; + case 26: + ch = ' '; + break; + case DecodedBitStreamParser$2.LL: + subMode = Mode$2.LOWER; + break; + case DecodedBitStreamParser$2.AL: + subMode = Mode$2.ALPHA; + break; + case DecodedBitStreamParser$2.PS: + // Shift to punctuation + priorToShiftMode = subMode; + subMode = Mode$2.PUNCT_SHIFT; + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + result.append(/*(char)*/ byteCompactionData[i]); + break; + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + subMode = Mode$2.ALPHA; + break; + } + } + break; + case Mode$2.PUNCT: + // Punctuation + if (subModeCh < DecodedBitStreamParser$2.PAL) { + ch = DecodedBitStreamParser$2.PUNCT_CHARS[subModeCh]; + } + else { + switch (subModeCh) { + case DecodedBitStreamParser$2.PAL: + subMode = Mode$2.ALPHA; + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + result.append(/*(char)*/ byteCompactionData[i]); + break; + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + subMode = Mode$2.ALPHA; + break; + } + } + break; + case Mode$2.ALPHA_SHIFT: + // Restore sub-mode + subMode = priorToShiftMode; + if (subModeCh < 26) { + ch = /*(char)('A' + subModeCh)*/ String.fromCharCode(65 + subModeCh); + } + else { + switch (subModeCh) { + case 26: + ch = ' '; + break; + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + subMode = Mode$2.ALPHA; + break; + } + } + break; + case Mode$2.PUNCT_SHIFT: + // Restore sub-mode + subMode = priorToShiftMode; + if (subModeCh < DecodedBitStreamParser$2.PAL) { + ch = DecodedBitStreamParser$2.PUNCT_CHARS[subModeCh]; + } + else { + switch (subModeCh) { + case DecodedBitStreamParser$2.PAL: + subMode = Mode$2.ALPHA; + break; + case DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE: + // PS before Shift-to-Byte is used as a padding character, + // see 5.4.2.4 of the specification + result.append(/*(char)*/ byteCompactionData[i]); + break; + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + subMode = Mode$2.ALPHA; + break; + } + } + break; + } + // if (ch !== 0) { + if (ch !== '') { + // Append decoded character to result + result.append(ch); + } + i++; + } + } + /** + * Byte Compaction mode (see 5.4.3) permits all 256 possible 8-bit byte values to be encoded. + * This includes all ASCII characters value 0 to 127 inclusive and provides for international + * character set support. + * + * @param mode The byte compaction mode i.e. 901 or 924 + * @param codewords The array of codewords (data + error) + * @param encoding Currently active character encoding + * @param codeIndex The current index into the codeword array. + * @param result The decoded data is appended to the result. + * @return The next index into the codeword array. + */ + static /*int*/ byteCompaction(mode, codewords, encoding, codeIndex, result) { + let decodedBytes = new ByteArrayOutputStream(); + let count = 0; + let value = /*long*/ 0; + let end = false; + switch (mode) { + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH: + // Total number of Byte Compaction characters to be encoded + // is not a multiple of 6 + let byteCompactedCodewords = new Int32Array(6); + let nextCode = codewords[codeIndex++]; + while ((codeIndex < codewords[0]) && !end) { + byteCompactedCodewords[count++] = nextCode; + // Base 900 + value = 900 * value + nextCode; + nextCode = codewords[codeIndex++]; + // perhaps it should be ok to check only nextCode >= TEXT_COMPACTION_MODE_LATCH + switch (nextCode) { + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.NUMERIC_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_CONTROL_BLOCK: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD: + case DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR: + codeIndex--; + end = true; + break; + default: + if ((count % 5 === 0) && (count > 0)) { + // Decode every 5 codewords + // Convert to Base 256 + for (let j /*int*/ = 0; j < 6; ++j) { + /* @note + * JavaScript stores numbers as 64 bits floating point numbers, but all bitwise operations are performed on 32 bits binary numbers. + * So the next bitwise operation could not be done with simple numbers + */ + decodedBytes.write(/*(byte)*/ Number(createBigInt(value) >> createBigInt(8 * (5 - j)))); + } + value = 0; + count = 0; + } + break; + } + } + // if the end of all codewords is reached the last codeword needs to be added + if (codeIndex === codewords[0] && nextCode < DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH) { + byteCompactedCodewords[count++] = nextCode; + } + // If Byte Compaction mode is invoked with codeword 901, + // the last group of codewords is interpreted directly + // as one byte per codeword, without compaction. + for (let i /*int*/ = 0; i < count; i++) { + decodedBytes.write(/*(byte)*/ byteCompactedCodewords[i]); + } + break; + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6: + // Total number of Byte Compaction characters to be encoded + // is an integer multiple of 6 + while (codeIndex < codewords[0] && !end) { + let code = codewords[codeIndex++]; + if (code < DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH) { + count++; + // Base 900 + value = 900 * value + code; + } + else { + switch (code) { + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.NUMERIC_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_CONTROL_BLOCK: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD: + case DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR: + codeIndex--; + end = true; + break; + } + } + if ((count % 5 === 0) && (count > 0)) { + // Decode every 5 codewords + // Convert to Base 256 + /* @note + * JavaScript stores numbers as 64 bits floating point numbers, but all bitwise operations are performed on 32 bits binary numbers. + * So the next bitwise operation could not be done with simple numbers + */ + for (let j /*int*/ = 0; j < 6; ++j) { + decodedBytes.write(/*(byte)*/ Number(createBigInt(value) >> createBigInt(8 * (5 - j)))); + } + value = 0; + count = 0; + } + } + break; + } + result.append(StringEncoding.decode(decodedBytes.toByteArray(), encoding)); + return codeIndex; + } + /** + * Numeric Compaction mode (see 5.4.4) permits efficient encoding of numeric data strings. + * + * @param codewords The array of codewords (data + error) + * @param codeIndex The current index into the codeword array. + * @param result The decoded data is appended to the result. + * @return The next index into the codeword array. + * + * @throws FormatException + */ + static numericCompaction(codewords, codeIndex /*int*/, result) { + let count = 0; + let end = false; + let numericCodewords = new Int32Array(DecodedBitStreamParser$2.MAX_NUMERIC_CODEWORDS); + while (codeIndex < codewords[0] && !end) { + let code = codewords[codeIndex++]; + if (codeIndex === codewords[0]) { + end = true; + } + if (code < DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH) { + numericCodewords[count] = code; + count++; + } + else { + switch (code) { + case DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH: + case DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_CONTROL_BLOCK: + case DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD: + case DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR: + codeIndex--; + end = true; + break; + } + } + if ((count % DecodedBitStreamParser$2.MAX_NUMERIC_CODEWORDS === 0 || code === DecodedBitStreamParser$2.NUMERIC_COMPACTION_MODE_LATCH || end) && count > 0) { + // Re-invoking Numeric Compaction mode (by using codeword 902 + // while in Numeric Compaction mode) serves to terminate the + // current Numeric Compaction mode grouping as described in 5.4.4.2, + // and then to start a new one grouping. + result.append(DecodedBitStreamParser$2.decodeBase900toBase10(numericCodewords, count)); + count = 0; + } + } + return codeIndex; + } + /** + * Convert a list of Numeric Compacted codewords from Base 900 to Base 10. + * + * @param codewords The array of codewords + * @param count The number of codewords + * @return The decoded string representing the Numeric data. + * + * EXAMPLE + * Encode the fifteen digit numeric string 000213298174000 + * Prefix the numeric string with a 1 and set the initial value of + * t = 1 000 213 298 174 000 + * Calculate codeword 0 + * d0 = 1 000 213 298 174 000 mod 900 = 200 + * + * t = 1 000 213 298 174 000 div 900 = 1 111 348 109 082 + * Calculate codeword 1 + * d1 = 1 111 348 109 082 mod 900 = 282 + * + * t = 1 111 348 109 082 div 900 = 1 234 831 232 + * Calculate codeword 2 + * d2 = 1 234 831 232 mod 900 = 632 + * + * t = 1 234 831 232 div 900 = 1 372 034 + * Calculate codeword 3 + * d3 = 1 372 034 mod 900 = 434 + * + * t = 1 372 034 div 900 = 1 524 + * Calculate codeword 4 + * d4 = 1 524 mod 900 = 624 + * + * t = 1 524 div 900 = 1 + * Calculate codeword 5 + * d5 = 1 mod 900 = 1 + * t = 1 div 900 = 0 + * Codeword sequence is: 1, 624, 434, 632, 282, 200 + * + * Decode the above codewords involves + * 1 x 900 power of 5 + 624 x 900 power of 4 + 434 x 900 power of 3 + + * 632 x 900 power of 2 + 282 x 900 power of 1 + 200 x 900 power of 0 = 1000213298174000 + * + * Remove leading 1 => Result is 000213298174000 + * + * @throws FormatException + */ + static decodeBase900toBase10(codewords, count) { + let result = createBigInt(0); + for (let i /*int*/ = 0; i < count; i++) { + result += DecodedBitStreamParser$2.EXP900[count - i - 1] * createBigInt(codewords[i]); + } + let resultString = result.toString(); + if (resultString.charAt(0) !== '1') { + throw new FormatException(); + } + return resultString.substring(1); + } + } + DecodedBitStreamParser$2.TEXT_COMPACTION_MODE_LATCH = 900; + DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH = 901; + DecodedBitStreamParser$2.NUMERIC_COMPACTION_MODE_LATCH = 902; + DecodedBitStreamParser$2.BYTE_COMPACTION_MODE_LATCH_6 = 924; + DecodedBitStreamParser$2.ECI_USER_DEFINED = 925; + DecodedBitStreamParser$2.ECI_GENERAL_PURPOSE = 926; + DecodedBitStreamParser$2.ECI_CHARSET = 927; + DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_CONTROL_BLOCK = 928; + DecodedBitStreamParser$2.BEGIN_MACRO_PDF417_OPTIONAL_FIELD = 923; + DecodedBitStreamParser$2.MACRO_PDF417_TERMINATOR = 922; + DecodedBitStreamParser$2.MODE_SHIFT_TO_BYTE_COMPACTION_MODE = 913; + DecodedBitStreamParser$2.MAX_NUMERIC_CODEWORDS = 15; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_FILE_NAME = 0; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_SEGMENT_COUNT = 1; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_TIME_STAMP = 2; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_SENDER = 3; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_ADDRESSEE = 4; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_FILE_SIZE = 5; + DecodedBitStreamParser$2.MACRO_PDF417_OPTIONAL_FIELD_CHECKSUM = 6; + DecodedBitStreamParser$2.PL = 25; + DecodedBitStreamParser$2.LL = 27; + DecodedBitStreamParser$2.AS = 27; + DecodedBitStreamParser$2.ML = 28; + DecodedBitStreamParser$2.AL = 28; + DecodedBitStreamParser$2.PS = 29; + DecodedBitStreamParser$2.PAL = 29; + DecodedBitStreamParser$2.PUNCT_CHARS = ';<>@[\\]_`~!\r\t,:\n-.$/"|*()?{}\''; + DecodedBitStreamParser$2.MIXED_CHARS = '0123456789&\r\t,:#-.$/+%*=^'; + /** + * Table containing values for the exponent of 900. + * This is used in the numeric compaction decode algorithm. + */ + DecodedBitStreamParser$2.EXP900 = getBigIntConstructor() ? getEXP900() : []; + DecodedBitStreamParser$2.NUMBER_OF_SEQUENCE_CODEWORDS = 2; + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.ArrayList; + // import java.util.Collection; + // import java.util.Formatter; + // import java.util.List; + /** + * @author Guenther Grau + */ + /*public final*/ class PDF417ScanningDecoder { + constructor() { } + /** + * @TODO don't pass in minCodewordWidth and maxCodewordWidth, pass in barcode columns for start and stop pattern + * + * columns. That way width can be deducted from the pattern column. + * This approach also allows to detect more details about the barcode, e.g. if a bar type (white or black) is wider + * than it should be. This can happen if the scanner used a bad blackpoint. + * + * @param BitMatrix + * @param image + * @param ResultPoint + * @param imageTopLeft + * @param ResultPoint + * @param imageBottomLeft + * @param ResultPoint + * @param imageTopRight + * @param ResultPoint + * @param imageBottomRight + * @param int + * @param minCodewordWidth + * @param int + * @param maxCodewordWidth + * + * @throws NotFoundException + * @throws FormatException + * @throws ChecksumException + */ + static decode(image, imageTopLeft, imageBottomLeft, imageTopRight, imageBottomRight, minCodewordWidth, maxCodewordWidth) { + let boundingBox = new BoundingBox(image, imageTopLeft, imageBottomLeft, imageTopRight, imageBottomRight); + let leftRowIndicatorColumn = null; + let rightRowIndicatorColumn = null; + let detectionResult; + for (let firstPass /*boolean*/ = true;; firstPass = false) { + if (imageTopLeft != null) { + leftRowIndicatorColumn = PDF417ScanningDecoder.getRowIndicatorColumn(image, boundingBox, imageTopLeft, true, minCodewordWidth, maxCodewordWidth); + } + if (imageTopRight != null) { + rightRowIndicatorColumn = PDF417ScanningDecoder.getRowIndicatorColumn(image, boundingBox, imageTopRight, false, minCodewordWidth, maxCodewordWidth); + } + detectionResult = PDF417ScanningDecoder.merge(leftRowIndicatorColumn, rightRowIndicatorColumn); + if (detectionResult == null) { + throw NotFoundException.getNotFoundInstance(); + } + let resultBox = detectionResult.getBoundingBox(); + if (firstPass && resultBox != null && + (resultBox.getMinY() < boundingBox.getMinY() || resultBox.getMaxY() > boundingBox.getMaxY())) { + boundingBox = resultBox; + } + else { + break; + } + } + detectionResult.setBoundingBox(boundingBox); + let maxBarcodeColumn = detectionResult.getBarcodeColumnCount() + 1; + detectionResult.setDetectionResultColumn(0, leftRowIndicatorColumn); + detectionResult.setDetectionResultColumn(maxBarcodeColumn, rightRowIndicatorColumn); + let leftToRight = leftRowIndicatorColumn != null; + for (let barcodeColumnCount /*int*/ = 1; barcodeColumnCount <= maxBarcodeColumn; barcodeColumnCount++) { + let barcodeColumn = leftToRight ? barcodeColumnCount : maxBarcodeColumn - barcodeColumnCount; + if (detectionResult.getDetectionResultColumn(barcodeColumn) !== /* null */ undefined) { + // This will be the case for the opposite row indicator column, which doesn't need to be decoded again. + continue; + } + let detectionResultColumn; + if (barcodeColumn === 0 || barcodeColumn === maxBarcodeColumn) { + detectionResultColumn = new DetectionResultRowIndicatorColumn(boundingBox, barcodeColumn === 0); + } + else { + detectionResultColumn = new DetectionResultColumn(boundingBox); + } + detectionResult.setDetectionResultColumn(barcodeColumn, detectionResultColumn); + let startColumn = -1; + let previousStartColumn = startColumn; + // TODO start at a row for which we know the start position, then detect upwards and downwards from there. + for (let imageRow /*int*/ = boundingBox.getMinY(); imageRow <= boundingBox.getMaxY(); imageRow++) { + startColumn = PDF417ScanningDecoder.getStartColumn(detectionResult, barcodeColumn, imageRow, leftToRight); + if (startColumn < 0 || startColumn > boundingBox.getMaxX()) { + if (previousStartColumn === -1) { + continue; + } + startColumn = previousStartColumn; + } + let codeword = PDF417ScanningDecoder.detectCodeword(image, boundingBox.getMinX(), boundingBox.getMaxX(), leftToRight, startColumn, imageRow, minCodewordWidth, maxCodewordWidth); + if (codeword != null) { + detectionResultColumn.setCodeword(imageRow, codeword); + previousStartColumn = startColumn; + minCodewordWidth = Math.min(minCodewordWidth, codeword.getWidth()); + maxCodewordWidth = Math.max(maxCodewordWidth, codeword.getWidth()); + } + } + } + return PDF417ScanningDecoder.createDecoderResult(detectionResult); + } + /** + * + * @param leftRowIndicatorColumn + * @param rightRowIndicatorColumn + * + * @throws NotFoundException + */ + static merge(leftRowIndicatorColumn, rightRowIndicatorColumn) { + if (leftRowIndicatorColumn == null && rightRowIndicatorColumn == null) { + return null; + } + let barcodeMetadata = PDF417ScanningDecoder.getBarcodeMetadata(leftRowIndicatorColumn, rightRowIndicatorColumn); + if (barcodeMetadata == null) { + return null; + } + let boundingBox = BoundingBox.merge(PDF417ScanningDecoder.adjustBoundingBox(leftRowIndicatorColumn), PDF417ScanningDecoder.adjustBoundingBox(rightRowIndicatorColumn)); + return new DetectionResult(barcodeMetadata, boundingBox); + } + /** + * + * @param rowIndicatorColumn + * + * @throws NotFoundException + */ + static adjustBoundingBox(rowIndicatorColumn) { + if (rowIndicatorColumn == null) { + return null; + } + let rowHeights = rowIndicatorColumn.getRowHeights(); + if (rowHeights == null) { + return null; + } + let maxRowHeight = PDF417ScanningDecoder.getMax(rowHeights); + let missingStartRows = 0; + for (let rowHeight /*int*/ of rowHeights) { + missingStartRows += maxRowHeight - rowHeight; + if (rowHeight > 0) { + break; + } + } + let codewords = rowIndicatorColumn.getCodewords(); + for (let row /*int*/ = 0; missingStartRows > 0 && codewords[row] == null; row++) { + missingStartRows--; + } + let missingEndRows = 0; + for (let row /*int*/ = rowHeights.length - 1; row >= 0; row--) { + missingEndRows += maxRowHeight - rowHeights[row]; + if (rowHeights[row] > 0) { + break; + } + } + for (let row /*int*/ = codewords.length - 1; missingEndRows > 0 && codewords[row] == null; row--) { + missingEndRows--; + } + return rowIndicatorColumn.getBoundingBox().addMissingRows(missingStartRows, missingEndRows, rowIndicatorColumn.isLeft()); + } + static getMax(values) { + let maxValue = -1; + for (let value /*int*/ of values) { + maxValue = Math.max(maxValue, value); + } + return maxValue; + } + static getBarcodeMetadata(leftRowIndicatorColumn, rightRowIndicatorColumn) { + let leftBarcodeMetadata; + if (leftRowIndicatorColumn == null || + (leftBarcodeMetadata = leftRowIndicatorColumn.getBarcodeMetadata()) == null) { + return rightRowIndicatorColumn == null ? null : rightRowIndicatorColumn.getBarcodeMetadata(); + } + let rightBarcodeMetadata; + if (rightRowIndicatorColumn == null || + (rightBarcodeMetadata = rightRowIndicatorColumn.getBarcodeMetadata()) == null) { + return leftBarcodeMetadata; + } + if (leftBarcodeMetadata.getColumnCount() !== rightBarcodeMetadata.getColumnCount() && + leftBarcodeMetadata.getErrorCorrectionLevel() !== rightBarcodeMetadata.getErrorCorrectionLevel() && + leftBarcodeMetadata.getRowCount() !== rightBarcodeMetadata.getRowCount()) { + return null; + } + return leftBarcodeMetadata; + } + static getRowIndicatorColumn(image, boundingBox, startPoint, leftToRight, minCodewordWidth, maxCodewordWidth) { + let rowIndicatorColumn = new DetectionResultRowIndicatorColumn(boundingBox, leftToRight); + for (let i /*int*/ = 0; i < 2; i++) { + let increment = i === 0 ? 1 : -1; + let startColumn = Math.trunc(Math.trunc(startPoint.getX())); + for (let imageRow /*int*/ = Math.trunc(Math.trunc(startPoint.getY())); imageRow <= boundingBox.getMaxY() && + imageRow >= boundingBox.getMinY(); imageRow += increment) { + let codeword = PDF417ScanningDecoder.detectCodeword(image, 0, image.getWidth(), leftToRight, startColumn, imageRow, minCodewordWidth, maxCodewordWidth); + if (codeword != null) { + rowIndicatorColumn.setCodeword(imageRow, codeword); + if (leftToRight) { + startColumn = codeword.getStartX(); + } + else { + startColumn = codeword.getEndX(); + } + } + } + } + return rowIndicatorColumn; + } + /** + * + * @param detectionResult + * @param BarcodeValue + * @param param2 + * @param param3 + * @param barcodeMatrix + * + * @throws NotFoundException + */ + static adjustCodewordCount(detectionResult, barcodeMatrix) { + let barcodeMatrix01 = barcodeMatrix[0][1]; + let numberOfCodewords = barcodeMatrix01.getValue(); + let calculatedNumberOfCodewords = detectionResult.getBarcodeColumnCount() * + detectionResult.getBarcodeRowCount() - + PDF417ScanningDecoder.getNumberOfECCodeWords(detectionResult.getBarcodeECLevel()); + if (numberOfCodewords.length === 0) { + if (calculatedNumberOfCodewords < 1 || calculatedNumberOfCodewords > PDF417Common.MAX_CODEWORDS_IN_BARCODE) { + throw NotFoundException.getNotFoundInstance(); + } + barcodeMatrix01.setValue(calculatedNumberOfCodewords); + } + else if (numberOfCodewords[0] !== calculatedNumberOfCodewords) { + // The calculated one is more reliable as it is derived from the row indicator columns + barcodeMatrix01.setValue(calculatedNumberOfCodewords); + } + } + /** + * + * @param detectionResult + * + * @throws FormatException + * @throws ChecksumException + * @throws NotFoundException + */ + static createDecoderResult(detectionResult) { + let barcodeMatrix = PDF417ScanningDecoder.createBarcodeMatrix(detectionResult); + PDF417ScanningDecoder.adjustCodewordCount(detectionResult, barcodeMatrix); + let erasures /*Collection*/ = new Array(); + let codewords = new Int32Array(detectionResult.getBarcodeRowCount() * detectionResult.getBarcodeColumnCount()); + let ambiguousIndexValuesList = /*List*/ []; + let ambiguousIndexesList = /*Collection*/ new Array(); + for (let row /*int*/ = 0; row < detectionResult.getBarcodeRowCount(); row++) { + for (let column /*int*/ = 0; column < detectionResult.getBarcodeColumnCount(); column++) { + let values = barcodeMatrix[row][column + 1].getValue(); + let codewordIndex = row * detectionResult.getBarcodeColumnCount() + column; + if (values.length === 0) { + erasures.push(codewordIndex); + } + else if (values.length === 1) { + codewords[codewordIndex] = values[0]; + } + else { + ambiguousIndexesList.push(codewordIndex); + ambiguousIndexValuesList.push(values); + } + } + } + let ambiguousIndexValues = new Array(ambiguousIndexValuesList.length); + for (let i /*int*/ = 0; i < ambiguousIndexValues.length; i++) { + ambiguousIndexValues[i] = ambiguousIndexValuesList[i]; + } + return PDF417ScanningDecoder.createDecoderResultFromAmbiguousValues(detectionResult.getBarcodeECLevel(), codewords, PDF417Common.toIntArray(erasures), PDF417Common.toIntArray(ambiguousIndexesList), ambiguousIndexValues); + } + /** + * This method deals with the fact, that the decoding process doesn't always yield a single most likely value. The + * current error correction implementation doesn't deal with erasures very well, so it's better to provide a value + * for these ambiguous codewords instead of treating it as an erasure. The problem is that we don't know which of + * the ambiguous values to choose. We try decode using the first value, and if that fails, we use another of the + * ambiguous values and try to decode again. This usually only happens on very hard to read and decode barcodes, + * so decoding the normal barcodes is not affected by this. + * + * @param erasureArray contains the indexes of erasures + * @param ambiguousIndexes array with the indexes that have more than one most likely value + * @param ambiguousIndexValues two dimensional array that contains the ambiguous values. The first dimension must + * be the same length as the ambiguousIndexes array + * + * @throws FormatException + * @throws ChecksumException + */ + static createDecoderResultFromAmbiguousValues(ecLevel, codewords, erasureArray, ambiguousIndexes, ambiguousIndexValues) { + let ambiguousIndexCount = new Int32Array(ambiguousIndexes.length); + let tries = 100; + while (tries-- > 0) { + for (let i /*int*/ = 0; i < ambiguousIndexCount.length; i++) { + codewords[ambiguousIndexes[i]] = ambiguousIndexValues[i][ambiguousIndexCount[i]]; + } + try { + return PDF417ScanningDecoder.decodeCodewords(codewords, ecLevel, erasureArray); + } + catch (err) { + let ignored = err instanceof ChecksumException; + if (!ignored) { + throw err; + } + } + if (ambiguousIndexCount.length === 0) { + throw ChecksumException.getChecksumInstance(); + } + for (let i /*int*/ = 0; i < ambiguousIndexCount.length; i++) { + if (ambiguousIndexCount[i] < ambiguousIndexValues[i].length - 1) { + ambiguousIndexCount[i]++; + break; + } + else { + ambiguousIndexCount[i] = 0; + if (i === ambiguousIndexCount.length - 1) { + throw ChecksumException.getChecksumInstance(); + } + } + } + } + throw ChecksumException.getChecksumInstance(); + } + static createBarcodeMatrix(detectionResult) { + // let barcodeMatrix: BarcodeValue[][] = + // new BarcodeValue[detectionResult.getBarcodeRowCount()][detectionResult.getBarcodeColumnCount() + 2]; + let barcodeMatrix = Array.from({ length: detectionResult.getBarcodeRowCount() }, () => new Array(detectionResult.getBarcodeColumnCount() + 2)); + for (let row /*int*/ = 0; row < barcodeMatrix.length; row++) { + for (let column /*int*/ = 0; column < barcodeMatrix[row].length; column++) { + barcodeMatrix[row][column] = new BarcodeValue(); + } + } + let column = 0; + for (let detectionResultColumn /*DetectionResultColumn*/ of detectionResult.getDetectionResultColumns()) { + if (detectionResultColumn != null) { + for (let codeword /*Codeword*/ of detectionResultColumn.getCodewords()) { + if (codeword != null) { + let rowNumber = codeword.getRowNumber(); + if (rowNumber >= 0) { + if (rowNumber >= barcodeMatrix.length) { + // We have more rows than the barcode metadata allows for, ignore them. + continue; + } + barcodeMatrix[rowNumber][column].setValue(codeword.getValue()); + } + } + } + } + column++; + } + return barcodeMatrix; + } + static isValidBarcodeColumn(detectionResult, barcodeColumn) { + return barcodeColumn >= 0 && barcodeColumn <= detectionResult.getBarcodeColumnCount() + 1; + } + static getStartColumn(detectionResult, barcodeColumn, imageRow, leftToRight) { + let offset = leftToRight ? 1 : -1; + let codeword = null; + if (PDF417ScanningDecoder.isValidBarcodeColumn(detectionResult, barcodeColumn - offset)) { + codeword = detectionResult.getDetectionResultColumn(barcodeColumn - offset).getCodeword(imageRow); + } + if (codeword != null) { + return leftToRight ? codeword.getEndX() : codeword.getStartX(); + } + codeword = detectionResult.getDetectionResultColumn(barcodeColumn).getCodewordNearby(imageRow); + if (codeword != null) { + return leftToRight ? codeword.getStartX() : codeword.getEndX(); + } + if (PDF417ScanningDecoder.isValidBarcodeColumn(detectionResult, barcodeColumn - offset)) { + codeword = detectionResult.getDetectionResultColumn(barcodeColumn - offset).getCodewordNearby(imageRow); + } + if (codeword != null) { + return leftToRight ? codeword.getEndX() : codeword.getStartX(); + } + let skippedColumns = 0; + while (PDF417ScanningDecoder.isValidBarcodeColumn(detectionResult, barcodeColumn - offset)) { + barcodeColumn -= offset; + for (let previousRowCodeword /*Codeword*/ of detectionResult.getDetectionResultColumn(barcodeColumn).getCodewords()) { + if (previousRowCodeword != null) { + return (leftToRight ? previousRowCodeword.getEndX() : previousRowCodeword.getStartX()) + + offset * + skippedColumns * + (previousRowCodeword.getEndX() - previousRowCodeword.getStartX()); + } + } + skippedColumns++; + } + return leftToRight ? detectionResult.getBoundingBox().getMinX() : detectionResult.getBoundingBox().getMaxX(); + } + static detectCodeword(image, minColumn, maxColumn, leftToRight, startColumn, imageRow, minCodewordWidth, maxCodewordWidth) { + startColumn = PDF417ScanningDecoder.adjustCodewordStartColumn(image, minColumn, maxColumn, leftToRight, startColumn, imageRow); + // we usually know fairly exact now how long a codeword is. We should provide minimum and maximum expected length + // and try to adjust the read pixels, e.g. remove single pixel errors or try to cut off exceeding pixels. + // min and maxCodewordWidth should not be used as they are calculated for the whole barcode an can be inaccurate + // for the current position + let moduleBitCount = PDF417ScanningDecoder.getModuleBitCount(image, minColumn, maxColumn, leftToRight, startColumn, imageRow); + if (moduleBitCount == null) { + return null; + } + let endColumn; + let codewordBitCount = MathUtils.sum(moduleBitCount); + if (leftToRight) { + endColumn = startColumn + codewordBitCount; + } + else { + for (let i /*int*/ = 0; i < moduleBitCount.length / 2; i++) { + let tmpCount = moduleBitCount[i]; + moduleBitCount[i] = moduleBitCount[moduleBitCount.length - 1 - i]; + moduleBitCount[moduleBitCount.length - 1 - i] = tmpCount; + } + endColumn = startColumn; + startColumn = endColumn - codewordBitCount; + } + // TODO implement check for width and correction of black and white bars + // use start (and maybe stop pattern) to determine if black bars are wider than white bars. If so, adjust. + // should probably done only for codewords with a lot more than 17 bits. + // The following fixes 10-1.png, which has wide black bars and small white bars + // for (let i /*int*/ = 0; i < moduleBitCount.length; i++) { + // if (i % 2 === 0) { + // moduleBitCount[i]--; + // } else { + // moduleBitCount[i]++; + // } + // } + // We could also use the width of surrounding codewords for more accurate results, but this seems + // sufficient for now + if (!PDF417ScanningDecoder.checkCodewordSkew(codewordBitCount, minCodewordWidth, maxCodewordWidth)) { + // We could try to use the startX and endX position of the codeword in the same column in the previous row, + // create the bit count from it and normalize it to 8. This would help with single pixel errors. + return null; + } + let decodedValue = PDF417CodewordDecoder.getDecodedValue(moduleBitCount); + let codeword = PDF417Common.getCodeword(decodedValue); + if (codeword === -1) { + return null; + } + return new Codeword(startColumn, endColumn, PDF417ScanningDecoder.getCodewordBucketNumber(decodedValue), codeword); + } + static getModuleBitCount(image, minColumn, maxColumn, leftToRight, startColumn, imageRow) { + let imageColumn = startColumn; + let moduleBitCount = new Int32Array(8); + let moduleNumber = 0; + let increment = leftToRight ? 1 : -1; + let previousPixelValue = leftToRight; + while ((leftToRight ? imageColumn < maxColumn : imageColumn >= minColumn) && + moduleNumber < moduleBitCount.length) { + if (image.get(imageColumn, imageRow) === previousPixelValue) { + moduleBitCount[moduleNumber]++; + imageColumn += increment; + } + else { + moduleNumber++; + previousPixelValue = !previousPixelValue; + } + } + if (moduleNumber === moduleBitCount.length || + ((imageColumn === (leftToRight ? maxColumn : minColumn)) && + moduleNumber === moduleBitCount.length - 1)) { + return moduleBitCount; + } + return null; + } + static getNumberOfECCodeWords(barcodeECLevel) { + return 2 << barcodeECLevel; + } + static adjustCodewordStartColumn(image, minColumn, maxColumn, leftToRight, codewordStartColumn, imageRow) { + let correctedStartColumn = codewordStartColumn; + let increment = leftToRight ? -1 : 1; + // there should be no black pixels before the start column. If there are, then we need to start earlier. + for (let i /*int*/ = 0; i < 2; i++) { + while ((leftToRight ? correctedStartColumn >= minColumn : correctedStartColumn < maxColumn) && + leftToRight === image.get(correctedStartColumn, imageRow)) { + if (Math.abs(codewordStartColumn - correctedStartColumn) > PDF417ScanningDecoder.CODEWORD_SKEW_SIZE) { + return codewordStartColumn; + } + correctedStartColumn += increment; + } + increment = -increment; + leftToRight = !leftToRight; + } + return correctedStartColumn; + } + static checkCodewordSkew(codewordSize, minCodewordWidth, maxCodewordWidth) { + return minCodewordWidth - PDF417ScanningDecoder.CODEWORD_SKEW_SIZE <= codewordSize && + codewordSize <= maxCodewordWidth + PDF417ScanningDecoder.CODEWORD_SKEW_SIZE; + } + /** + * @throws FormatException, + * @throws ChecksumException + */ + static decodeCodewords(codewords, ecLevel, erasures) { + if (codewords.length === 0) { + throw FormatException.getFormatInstance(); + } + let numECCodewords = 1 << (ecLevel + 1); + let correctedErrorsCount = PDF417ScanningDecoder.correctErrors(codewords, erasures, numECCodewords); + PDF417ScanningDecoder.verifyCodewordCount(codewords, numECCodewords); + // Decode the codewords + let decoderResult = DecodedBitStreamParser$2.decode(codewords, '' + ecLevel); + decoderResult.setErrorsCorrected(correctedErrorsCount); + decoderResult.setErasures(erasures.length); + return decoderResult; + } + /** + *

Given data and error-correction codewords received, possibly corrupted by errors, attempts to + * correct the errors in-place.

+ * + * @param codewords data and error correction codewords + * @param erasures positions of any known erasures + * @param numECCodewords number of error correction codewords that are available in codewords + * @throws ChecksumException if error correction fails + */ + static correctErrors(codewords, erasures, numECCodewords) { + if (erasures != null && + erasures.length > numECCodewords / 2 + PDF417ScanningDecoder.MAX_ERRORS || + numECCodewords < 0 || + numECCodewords > PDF417ScanningDecoder.MAX_EC_CODEWORDS) { + // Too many errors or EC Codewords is corrupted + throw ChecksumException.getChecksumInstance(); + } + return PDF417ScanningDecoder.errorCorrection.decode(codewords, numECCodewords, erasures); + } + /** + * Verify that all is OK with the codeword array. + * @throws FormatException + */ + static verifyCodewordCount(codewords, numECCodewords) { + if (codewords.length < 4) { + // Codeword array size should be at least 4 allowing for + // Count CW, At least one Data CW, Error Correction CW, Error Correction CW + throw FormatException.getFormatInstance(); + } + // The first codeword, the Symbol Length Descriptor, shall always encode the total number of data + // codewords in the symbol, including the Symbol Length Descriptor itself, data codewords and pad + // codewords, but excluding the number of error correction codewords. + let numberOfCodewords = codewords[0]; + if (numberOfCodewords > codewords.length) { + throw FormatException.getFormatInstance(); + } + if (numberOfCodewords === 0) { + // Reset to the length of the array - 8 (Allow for at least level 3 Error Correction (8 Error Codewords) + if (numECCodewords < codewords.length) { + codewords[0] = codewords.length - numECCodewords; + } + else { + throw FormatException.getFormatInstance(); + } + } + } + static getBitCountForCodeword(codeword) { + let result = new Int32Array(8); + let previousValue = 0; + let i = result.length - 1; + while (true) { + if ((codeword & 0x1) !== previousValue) { + previousValue = codeword & 0x1; + i--; + if (i < 0) { + break; + } + } + result[i]++; + codeword >>= 1; + } + return result; + } + static getCodewordBucketNumber(codeword) { + if (codeword instanceof Int32Array) { + return this.getCodewordBucketNumber_Int32Array(codeword); + } + return this.getCodewordBucketNumber_number(codeword); + } + static getCodewordBucketNumber_number(codeword) { + return PDF417ScanningDecoder.getCodewordBucketNumber(PDF417ScanningDecoder.getBitCountForCodeword(codeword)); + } + static getCodewordBucketNumber_Int32Array(moduleBitCount) { + return (moduleBitCount[0] - moduleBitCount[2] + moduleBitCount[4] - moduleBitCount[6] + 9) % 9; + } + static toString(barcodeMatrix) { + let formatter = new Formatter(); + // try (let formatter = new Formatter()) { + for (let row /*int*/ = 0; row < barcodeMatrix.length; row++) { + formatter.format('Row %2d: ', row); + for (let column /*int*/ = 0; column < barcodeMatrix[row].length; column++) { + let barcodeValue = barcodeMatrix[row][column]; + if (barcodeValue.getValue().length === 0) { + formatter.format(' ', null); + } + else { + formatter.format('%4d(%2d)', barcodeValue.getValue()[0], barcodeValue.getConfidence(barcodeValue.getValue()[0])); + } + } + formatter.format('%n'); + } + return formatter.toString(); + // } + } + } + /*final*/ PDF417ScanningDecoder.CODEWORD_SKEW_SIZE = 2; + /*final*/ PDF417ScanningDecoder.MAX_ERRORS = 3; + /*final*/ PDF417ScanningDecoder.MAX_EC_CODEWORDS = 512; + /*final*/ PDF417ScanningDecoder.errorCorrection = new ErrorCorrection(); + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // import java.util.ArrayList; + // import java.util.List; + // import java.util.Map; + /** + * This implementation can detect and decode PDF417 codes in an image. + * + * @author Guenther Grau + */ + /*public final*/ class PDF417Reader { + // private static /*final Result[]*/ EMPTY_RESULT_ARRAY: Result[] = new Result([0]); + /** + * Locates and decodes a PDF417 code in an image. + * + * @return a String representing the content encoded by the PDF417 code + * @throws NotFoundException if a PDF417 code cannot be found, + * @throws FormatException if a PDF417 cannot be decoded + * @throws ChecksumException + */ + // @Override + decode(image, hints = null) { + let result = PDF417Reader.decode(image, hints, false); + if (result == null || result.length === 0 || result[0] == null) { + throw NotFoundException.getNotFoundInstance(); + } + return result[0]; + } + /** + * + * @param BinaryBitmap + * @param image + * @throws NotFoundException + */ + // @Override + decodeMultiple(image, hints = null) { + try { + return PDF417Reader.decode(image, hints, true); + } + catch (ignored) { + if (ignored instanceof FormatException || ignored instanceof ChecksumException) { + throw NotFoundException.getNotFoundInstance(); + } + throw ignored; + } + } + /** + * + * @param image + * @param hints + * @param multiple + * + * @throws NotFoundException + * @throws FormatExceptionß + * @throws ChecksumException + */ + static decode(image, hints, multiple) { + const results = new Array(); + const detectorResult = Detector$3.detectMultiple(image, hints, multiple); + for (const points of detectorResult.getPoints()) { + const decoderResult = PDF417ScanningDecoder.decode(detectorResult.getBits(), points[4], points[5], points[6], points[7], PDF417Reader.getMinCodewordWidth(points), PDF417Reader.getMaxCodewordWidth(points)); + const result = new Result(decoderResult.getText(), decoderResult.getRawBytes(), undefined, points, BarcodeFormat$1.PDF_417); + result.putMetadata(ResultMetadataType$1.ERROR_CORRECTION_LEVEL, decoderResult.getECLevel()); + const pdf417ResultMetadata = decoderResult.getOther(); + if (pdf417ResultMetadata != null) { + result.putMetadata(ResultMetadataType$1.PDF417_EXTRA_METADATA, pdf417ResultMetadata); + } + results.push(result); + } + return results.map(x => x); + } + static getMaxWidth(p1, p2) { + if (p1 == null || p2 == null) { + return 0; + } + return Math.trunc(Math.abs(p1.getX() - p2.getX())); + } + static getMinWidth(p1, p2) { + if (p1 == null || p2 == null) { + return Integer.MAX_VALUE; + } + return Math.trunc(Math.abs(p1.getX() - p2.getX())); + } + static getMaxCodewordWidth(p) { + return Math.floor(Math.max(Math.max(PDF417Reader.getMaxWidth(p[0], p[4]), PDF417Reader.getMaxWidth(p[6], p[2]) * PDF417Common.MODULES_IN_CODEWORD / + PDF417Common.MODULES_IN_STOP_PATTERN), Math.max(PDF417Reader.getMaxWidth(p[1], p[5]), PDF417Reader.getMaxWidth(p[7], p[3]) * PDF417Common.MODULES_IN_CODEWORD / + PDF417Common.MODULES_IN_STOP_PATTERN))); + } + static getMinCodewordWidth(p) { + return Math.floor(Math.min(Math.min(PDF417Reader.getMinWidth(p[0], p[4]), PDF417Reader.getMinWidth(p[6], p[2]) * PDF417Common.MODULES_IN_CODEWORD / + PDF417Common.MODULES_IN_STOP_PATTERN), Math.min(PDF417Reader.getMinWidth(p[1], p[5]), PDF417Reader.getMinWidth(p[7], p[3]) * PDF417Common.MODULES_IN_CODEWORD / + PDF417Common.MODULES_IN_STOP_PATTERN))); + } + // @Override + reset() { + // nothing needs to be reset + } + } + + /** + * Custom Error class of type Exception. + */ + class ReaderException extends Exception { + } + ReaderException.kind = 'ReaderException'; + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * MultiFormatReader is a convenience class and the main entry point into the library for most uses. + * By default it attempts to decode all barcode formats that the library supports. Optionally, you + * can provide a hints object to request different behavior, for example only decoding QR codes. + * + * @author Sean Owen + * @author dswitkin@google.com (Daniel Switkin) + */ + class MultiFormatReader { + /** + * This version of decode honors the intent of Reader.decode(BinaryBitmap) in that it + * passes null as a hint to the decoders. However, that makes it inefficient to call repeatedly. + * Use setHints() followed by decodeWithState() for continuous scan applications. + * + * @param image The pixel data to decode + * @return The contents of the image + * + * @throws NotFoundException Any errors which occurred + */ + /*@Override*/ + // public decode(image: BinaryBitmap): Result { + // setHints(null) + // return decodeInternal(image) + // } + /** + * Decode an image using the hints provided. Does not honor existing state. + * + * @param image The pixel data to decode + * @param hints The hints to use, clearing the previous state. + * @return The contents of the image + * + * @throws NotFoundException Any errors which occurred + */ + /*@Override*/ + decode(image, hints) { + this.setHints(hints); + return this.decodeInternal(image); + } + /** + * Decode an image using the state set up by calling setHints() previously. Continuous scan + * clients will get a large speed increase by using this instead of decode(). + * + * @param image The pixel data to decode + * @return The contents of the image + * + * @throws NotFoundException Any errors which occurred + */ + decodeWithState(image) { + // Make sure to set up the default state so we don't crash + if (this.readers === null || this.readers === undefined) { + this.setHints(null); + } + return this.decodeInternal(image); + } + /** + * This method adds state to the MultiFormatReader. By setting the hints once, subsequent calls + * to decodeWithState(image) can reuse the same set of readers without reallocating memory. This + * is important for performance in continuous scan clients. + * + * @param hints The set of hints to use for subsequent calls to decode(image) + */ + setHints(hints) { + this.hints = hints; + const tryHarder = hints !== null && hints !== undefined && undefined !== hints.get(DecodeHintType$1.TRY_HARDER); + /*@SuppressWarnings("unchecked")*/ + const formats = hints === null || hints === undefined ? null : hints.get(DecodeHintType$1.POSSIBLE_FORMATS); + const readers = new Array(); + if (formats !== null && formats !== undefined) { + const addOneDReader = formats.some(f => f === BarcodeFormat$1.UPC_A || + f === BarcodeFormat$1.UPC_E || + f === BarcodeFormat$1.EAN_13 || + f === BarcodeFormat$1.EAN_8 || + f === BarcodeFormat$1.CODABAR || + f === BarcodeFormat$1.CODE_39 || + f === BarcodeFormat$1.CODE_93 || + f === BarcodeFormat$1.CODE_128 || + f === BarcodeFormat$1.ITF || + f === BarcodeFormat$1.RSS_14 || + f === BarcodeFormat$1.RSS_EXPANDED); + // Put 1D readers upfront in "normal" mode + // TYPESCRIPTPORT: TODO: uncomment below as they are ported + if (addOneDReader && !tryHarder) { + readers.push(new MultiFormatOneDReader(hints)); + } + if (formats.includes(BarcodeFormat$1.QR_CODE)) { + readers.push(new QRCodeReader()); + } + if (formats.includes(BarcodeFormat$1.DATA_MATRIX)) { + readers.push(new DataMatrixReader()); + } + if (formats.includes(BarcodeFormat$1.AZTEC)) { + readers.push(new AztecReader()); + } + if (formats.includes(BarcodeFormat$1.PDF_417)) { + readers.push(new PDF417Reader()); + } + // if (formats.includes(BarcodeFormat.MAXICODE)) { + // readers.push(new MaxiCodeReader()) + // } + // At end in "try harder" mode + if (addOneDReader && tryHarder) { + readers.push(new MultiFormatOneDReader(hints)); + } + } + if (readers.length === 0) { + if (!tryHarder) { + readers.push(new MultiFormatOneDReader(hints)); + } + readers.push(new QRCodeReader()); + readers.push(new DataMatrixReader()); + readers.push(new AztecReader()); + readers.push(new PDF417Reader()); + // readers.push(new MaxiCodeReader()) + if (tryHarder) { + readers.push(new MultiFormatOneDReader(hints)); + } + } + this.readers = readers; // .toArray(new Reader[readers.size()]) + } + /*@Override*/ + reset() { + if (this.readers !== null) { + for (const reader of this.readers) { + reader.reset(); + } + } + } + /** + * @throws NotFoundException + */ + decodeInternal(image) { + if (this.readers === null) { + throw new ReaderException('No readers where selected, nothing can be read.'); + } + for (const reader of this.readers) { + // Trying to decode with ${reader} reader. + try { + return reader.decode(image, this.hints); + } + catch (ex) { + if (ex instanceof ReaderException) { + continue; + } + // Bad Exception. + } + } + throw new NotFoundException('No MultiFormat Readers were able to detect the code.'); + } + } + + class BrowserMultiFormatReader extends BrowserCodeReader { + constructor(hints = null, timeBetweenScansMillis = 500) { + const reader = new MultiFormatReader(); + reader.setHints(hints); + super(reader, timeBetweenScansMillis); + } + /** + * Overwrite decodeBitmap to call decodeWithState, which will pay + * attention to the hints set in the constructor function + */ + decodeBitmap(binaryBitmap) { + return this.reader.decodeWithState(binaryBitmap); + } + } + + /** + * @deprecated Moving to @zxing/browser + * + * QR Code reader to use from browser. + */ + class BrowserPDF417Reader extends BrowserCodeReader { + /** + * Creates an instance of BrowserPDF417Reader. + * @param {number} [timeBetweenScansMillis=500] the time delay between subsequent decode tries + */ + constructor(timeBetweenScansMillis = 500) { + super(new PDF417Reader(), timeBetweenScansMillis); + } + } + + /** + * @deprecated Moving to @zxing/browser + * + * QR Code reader to use from browser. + */ + class BrowserQRCodeReader extends BrowserCodeReader { + /** + * Creates an instance of BrowserQRCodeReader. + * @param {number} [timeBetweenScansMillis=500] the time delay between subsequent decode tries + */ + constructor(timeBetweenScansMillis = 500) { + super(new QRCodeReader(), timeBetweenScansMillis); + } + } + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing {*/ + /** + * These are a set of hints that you may pass to Writers to specify their behavior. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + var EncodeHintType; + (function (EncodeHintType) { + /** + * Specifies what degree of error correction to use, for example in QR Codes. + * Type depends on the encoder. For example for QR codes it's type + * {@link com.google.zxing.qrcode.decoder.ErrorCorrectionLevel ErrorCorrectionLevel}. + * For Aztec it is of type {@link Integer}, representing the minimal percentage of error correction words. + * For PDF417 it is of type {@link Integer}, valid values being 0 to 8. + * In all cases, it can also be a {@link String} representation of the desired value as well. + * Note: an Aztec symbol should have a minimum of 25% EC words. + */ + EncodeHintType[EncodeHintType["ERROR_CORRECTION"] = 0] = "ERROR_CORRECTION"; + /** + * Specifies what character encoding to use where applicable (type {@link String}) + */ + EncodeHintType[EncodeHintType["CHARACTER_SET"] = 1] = "CHARACTER_SET"; + /** + * Specifies the matrix shape for Data Matrix (type {@link com.google.zxing.datamatrix.encoder.SymbolShapeHint}) + */ + EncodeHintType[EncodeHintType["DATA_MATRIX_SHAPE"] = 2] = "DATA_MATRIX_SHAPE"; + /** + * Specifies a minimum barcode size (type {@link Dimension}). Only applicable to Data Matrix now. + * + * @deprecated use width/height params in + * {@link com.google.zxing.datamatrix.DataMatrixWriter#encode(String, BarcodeFormat, int, int)} + */ + /*@Deprecated*/ + EncodeHintType[EncodeHintType["MIN_SIZE"] = 3] = "MIN_SIZE"; + /** + * Specifies a maximum barcode size (type {@link Dimension}). Only applicable to Data Matrix now. + * + * @deprecated without replacement + */ + /*@Deprecated*/ + EncodeHintType[EncodeHintType["MAX_SIZE"] = 4] = "MAX_SIZE"; + /** + * Specifies margin, in pixels, to use when generating the barcode. The meaning can vary + * by format; for example it controls margin before and after the barcode horizontally for + * most 1D formats. (Type {@link Integer}, or {@link String} representation of the integer value). + */ + EncodeHintType[EncodeHintType["MARGIN"] = 5] = "MARGIN"; + /** + * Specifies whether to use compact mode for PDF417 (type {@link Boolean}, or "true" or "false" + * {@link String} value). + */ + EncodeHintType[EncodeHintType["PDF417_COMPACT"] = 6] = "PDF417_COMPACT"; + /** + * Specifies what compaction mode to use for PDF417 (type + * {@link com.google.zxing.pdf417.encoder.Compaction Compaction} or {@link String} value of one of its + * enum values). + */ + EncodeHintType[EncodeHintType["PDF417_COMPACTION"] = 7] = "PDF417_COMPACTION"; + /** + * Specifies the minimum and maximum number of rows and columns for PDF417 (type + * {@link com.google.zxing.pdf417.encoder.Dimensions Dimensions}). + */ + EncodeHintType[EncodeHintType["PDF417_DIMENSIONS"] = 8] = "PDF417_DIMENSIONS"; + /** + * Specifies the required number of layers for an Aztec code. + * A negative number (-1, -2, -3, -4) specifies a compact Aztec code. + * 0 indicates to use the minimum number of layers (the default). + * A positive number (1, 2, .. 32) specifies a normal (non-compact) Aztec code. + * (Type {@link Integer}, or {@link String} representation of the integer value). + */ + EncodeHintType[EncodeHintType["AZTEC_LAYERS"] = 9] = "AZTEC_LAYERS"; + /** + * Specifies the exact version of QR code to be encoded. + * (Type {@link Integer}, or {@link String} representation of the integer value). + */ + EncodeHintType[EncodeHintType["QR_VERSION"] = 10] = "QR_VERSION"; + })(EncodeHintType || (EncodeHintType = {})); + var EncodeHintType$1 = EncodeHintType; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + *

Implements Reed-Solomon encoding, as the name implies.

+ * + * @author Sean Owen + * @author William Rucklidge + */ + class ReedSolomonEncoder { + /** + * A reed solomon error-correcting encoding constructor is created by + * passing as Galois Field with of size equal to the number of code + * words (symbols) in the alphabet (the number of values in each + * element of arrays that are encoded/decoded). + * @param field A galois field with a number of elements equal to the size + * of the alphabet of symbols to encode. + */ + constructor(field) { + this.field = field; + this.cachedGenerators = []; + this.cachedGenerators.push(new GenericGFPoly(field, Int32Array.from([1]))); + } + buildGenerator(degree /*int*/) { + const cachedGenerators = this.cachedGenerators; + if (degree >= cachedGenerators.length) { + let lastGenerator = cachedGenerators[cachedGenerators.length - 1]; + const field = this.field; + for (let d = cachedGenerators.length; d <= degree; d++) { + const nextGenerator = lastGenerator.multiply(new GenericGFPoly(field, Int32Array.from([1, field.exp(d - 1 + field.getGeneratorBase())]))); + cachedGenerators.push(nextGenerator); + lastGenerator = nextGenerator; + } + } + return cachedGenerators[degree]; + } + /** + *

Encode a sequence of code words (symbols) using Reed-Solomon to allow decoders + * to detect and correct errors that may have been introduced when the resulting + * data is stored or transmitted.

+ * + * @param toEncode array used for both and output. Caller initializes the array with + * the code words (symbols) to be encoded followed by empty elements allocated to make + * space for error-correction code words in the encoded output. The array contains + * the encdoded output when encode returns. Code words are encoded as numbers from + * 0 to n-1, where n is the number of possible code words (symbols), as determined + * by the size of the Galois Field passed in the constructor of this object. + * @param ecBytes the number of elements reserved in the array (first parameter) + * to store error-correction code words. Thus, the number of code words (symbols) + * to encode in the first parameter is thus toEncode.length - ecBytes. + * Note, the use of "bytes" in the name of this parameter is misleading, as there may + * be more or fewer than 256 symbols being encoded, as determined by the number of + * elements in the Galois Field passed as a constructor to this object. + * @throws IllegalArgumentException thrown in response to validation errros. + */ + encode(toEncode, ecBytes /*int*/) { + if (ecBytes === 0) { + throw new IllegalArgumentException('No error correction bytes'); + } + const dataBytes = toEncode.length - ecBytes; + if (dataBytes <= 0) { + throw new IllegalArgumentException('No data bytes provided'); + } + const generator = this.buildGenerator(ecBytes); + const infoCoefficients = new Int32Array(dataBytes); + System.arraycopy(toEncode, 0, infoCoefficients, 0, dataBytes); + let info = new GenericGFPoly(this.field, infoCoefficients); + info = info.multiplyByMonomial(ecBytes, 1); + const remainder = info.divide(generator)[1]; + const coefficients = remainder.getCoefficients(); + const numZeroCoefficients = ecBytes - coefficients.length; + for (let i = 0; i < numZeroCoefficients; i++) { + toEncode[dataBytes + i] = 0; + } + System.arraycopy(coefficients, 0, toEncode, dataBytes + numZeroCoefficients, coefficients.length); + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author Satoru Takabayashi + * @author Daniel Switkin + * @author Sean Owen + */ + class MaskUtil { + constructor() { + // do nothing + } + /** + * Apply mask penalty rule 1 and return the penalty. Find repetitive cells with the same color and + * give penalty to them. Example: 00000 or 11111. + */ + static applyMaskPenaltyRule1(matrix) { + return MaskUtil.applyMaskPenaltyRule1Internal(matrix, true) + MaskUtil.applyMaskPenaltyRule1Internal(matrix, false); + } + /** + * Apply mask penalty rule 2 and return the penalty. Find 2x2 blocks with the same color and give + * penalty to them. This is actually equivalent to the spec's rule, which is to find MxN blocks and give a + * penalty proportional to (M-1)x(N-1), because this is the number of 2x2 blocks inside such a block. + */ + static applyMaskPenaltyRule2(matrix) { + let penalty = 0; + const array = matrix.getArray(); + const width = matrix.getWidth(); + const height = matrix.getHeight(); + for (let y = 0; y < height - 1; y++) { + const arrayY = array[y]; + for (let x = 0; x < width - 1; x++) { + const value = arrayY[x]; + if (value === arrayY[x + 1] && value === array[y + 1][x] && value === array[y + 1][x + 1]) { + penalty++; + } + } + } + return MaskUtil.N2 * penalty; + } + /** + * Apply mask penalty rule 3 and return the penalty. Find consecutive runs of 1:1:3:1:1:4 + * starting with black, or 4:1:1:3:1:1 starting with white, and give penalty to them. If we + * find patterns like 000010111010000, we give penalty once. + */ + static applyMaskPenaltyRule3(matrix) { + let numPenalties = 0; + const array = matrix.getArray(); + const width = matrix.getWidth(); + const height = matrix.getHeight(); + for (let y = 0; y < height; y++) { + for (let x = 0; x < width; x++) { + const arrayY = array[y]; // We can at least optimize this access + if (x + 6 < width && + arrayY[x] === 1 && + arrayY[x + 1] === 0 && + arrayY[x + 2] === 1 && + arrayY[x + 3] === 1 && + arrayY[x + 4] === 1 && + arrayY[x + 5] === 0 && + arrayY[x + 6] === 1 && + (MaskUtil.isWhiteHorizontal(arrayY, x - 4, x) || MaskUtil.isWhiteHorizontal(arrayY, x + 7, x + 11))) { + numPenalties++; + } + if (y + 6 < height && + array[y][x] === 1 && + array[y + 1][x] === 0 && + array[y + 2][x] === 1 && + array[y + 3][x] === 1 && + array[y + 4][x] === 1 && + array[y + 5][x] === 0 && + array[y + 6][x] === 1 && + (MaskUtil.isWhiteVertical(array, x, y - 4, y) || MaskUtil.isWhiteVertical(array, x, y + 7, y + 11))) { + numPenalties++; + } + } + } + return numPenalties * MaskUtil.N3; + } + static isWhiteHorizontal(rowArray, from /*int*/, to /*int*/) { + from = Math.max(from, 0); + to = Math.min(to, rowArray.length); + for (let i = from; i < to; i++) { + if (rowArray[i] === 1) { + return false; + } + } + return true; + } + static isWhiteVertical(array, col /*int*/, from /*int*/, to /*int*/) { + from = Math.max(from, 0); + to = Math.min(to, array.length); + for (let i = from; i < to; i++) { + if (array[i][col] === 1) { + return false; + } + } + return true; + } + /** + * Apply mask penalty rule 4 and return the penalty. Calculate the ratio of dark cells and give + * penalty if the ratio is far from 50%. It gives 10 penalty for 5% distance. + */ + static applyMaskPenaltyRule4(matrix) { + let numDarkCells = 0; + const array = matrix.getArray(); + const width = matrix.getWidth(); + const height = matrix.getHeight(); + for (let y = 0; y < height; y++) { + const arrayY = array[y]; + for (let x = 0; x < width; x++) { + if (arrayY[x] === 1) { + numDarkCells++; + } + } + } + const numTotalCells = matrix.getHeight() * matrix.getWidth(); + const fivePercentVariances = Math.floor(Math.abs(numDarkCells * 2 - numTotalCells) * 10 / numTotalCells); + return fivePercentVariances * MaskUtil.N4; + } + /** + * Return the mask bit for "getMaskPattern" at "x" and "y". See 8.8 of JISX0510:2004 for mask + * pattern conditions. + */ + static getDataMaskBit(maskPattern /*int*/, x /*int*/, y /*int*/) { + let intermediate; /*int*/ + let temp; /*int*/ + switch (maskPattern) { + case 0: + intermediate = (y + x) & 0x1; + break; + case 1: + intermediate = y & 0x1; + break; + case 2: + intermediate = x % 3; + break; + case 3: + intermediate = (y + x) % 3; + break; + case 4: + intermediate = (Math.floor(y / 2) + Math.floor(x / 3)) & 0x1; + break; + case 5: + temp = y * x; + intermediate = (temp & 0x1) + (temp % 3); + break; + case 6: + temp = y * x; + intermediate = ((temp & 0x1) + (temp % 3)) & 0x1; + break; + case 7: + temp = y * x; + intermediate = ((temp % 3) + ((y + x) & 0x1)) & 0x1; + break; + default: + throw new IllegalArgumentException('Invalid mask pattern: ' + maskPattern); + } + return intermediate === 0; + } + /** + * Helper function for applyMaskPenaltyRule1. We need this for doing this calculation in both + * vertical and horizontal orders respectively. + */ + static applyMaskPenaltyRule1Internal(matrix, isHorizontal) { + let penalty = 0; + const iLimit = isHorizontal ? matrix.getHeight() : matrix.getWidth(); + const jLimit = isHorizontal ? matrix.getWidth() : matrix.getHeight(); + const array = matrix.getArray(); + for (let i = 0; i < iLimit; i++) { + let numSameBitCells = 0; + let prevBit = -1; + for (let j = 0; j < jLimit; j++) { + const bit = isHorizontal ? array[i][j] : array[j][i]; + if (bit === prevBit) { + numSameBitCells++; + } + else { + if (numSameBitCells >= 5) { + penalty += MaskUtil.N1 + (numSameBitCells - 5); + } + numSameBitCells = 1; // Include the cell itself. + prevBit = bit; + } + } + if (numSameBitCells >= 5) { + penalty += MaskUtil.N1 + (numSameBitCells - 5); + } + } + return penalty; + } + } + // Penalty weights from section 6.8.2.1 + MaskUtil.N1 = 3; + MaskUtil.N2 = 3; + MaskUtil.N3 = 40; + MaskUtil.N4 = 10; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * JAVAPORT: The original code was a 2D array of ints, but since it only ever gets assigned + * -1, 0, and 1, I'm going to use less memory and go with bytes. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class ByteMatrix { + constructor(width /*int*/, height /*int*/) { + this.width = width; + this.height = height; + const bytes = new Array(height); // [height][width] + for (let i = 0; i !== height; i++) { + bytes[i] = new Uint8Array(width); + } + this.bytes = bytes; + } + getHeight() { + return this.height; + } + getWidth() { + return this.width; + } + get(x /*int*/, y /*int*/) { + return this.bytes[y][x]; + } + /** + * @return an internal representation as bytes, in row-major order. array[y][x] represents point (x,y) + */ + getArray() { + return this.bytes; + } + // TYPESCRIPTPORT: preffer to let two methods instead of override to avoid type comparison inside + setNumber(x /*int*/, y /*int*/, value /*byte|int*/) { + this.bytes[y][x] = value; + } + // public set(x: number /*int*/, y: number /*int*/, value: number /*int*/): void { + // bytes[y][x] = (byte) value + // } + setBoolean(x /*int*/, y /*int*/, value) { + this.bytes[y][x] = /*(byte) */ (value ? 1 : 0); + } + clear(value /*byte*/) { + for (const aByte of this.bytes) { + Arrays.fill(aByte, value); + } + } + equals(o) { + if (!(o instanceof ByteMatrix)) { + return false; + } + const other = o; + if (this.width !== other.width) { + return false; + } + if (this.height !== other.height) { + return false; + } + for (let y = 0, height = this.height; y < height; ++y) { + const bytesY = this.bytes[y]; + const otherBytesY = other.bytes[y]; + for (let x = 0, width = this.width; x < width; ++x) { + if (bytesY[x] !== otherBytesY[x]) { + return false; + } + } + } + return true; + } + /*@Override*/ + toString() { + const result = new StringBuilder(); // (2 * width * height + 2) + for (let y = 0, height = this.height; y < height; ++y) { + const bytesY = this.bytes[y]; + for (let x = 0, width = this.width; x < width; ++x) { + switch (bytesY[x]) { + case 0: + result.append(' 0'); + break; + case 1: + result.append(' 1'); + break; + default: + result.append(' '); + break; + } + } + result.append('\n'); + } + return result.toString(); + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author satorux@google.com (Satoru Takabayashi) - creator + * @author dswitkin@google.com (Daniel Switkin) - ported from C++ + */ + class QRCode { + constructor() { + this.maskPattern = -1; + } + getMode() { + return this.mode; + } + getECLevel() { + return this.ecLevel; + } + getVersion() { + return this.version; + } + getMaskPattern() { + return this.maskPattern; + } + getMatrix() { + return this.matrix; + } + /*@Override*/ + toString() { + const result = new StringBuilder(); // (200) + result.append('<<\n'); + result.append(' mode: '); + result.append(this.mode ? this.mode.toString() : 'null'); + result.append('\n ecLevel: '); + result.append(this.ecLevel ? this.ecLevel.toString() : 'null'); + result.append('\n version: '); + result.append(this.version ? this.version.toString() : 'null'); + result.append('\n maskPattern: '); + result.append(this.maskPattern.toString()); + if (this.matrix) { + result.append('\n matrix:\n'); + result.append(this.matrix.toString()); + } + else { + result.append('\n matrix: null\n'); + } + result.append('>>\n'); + return result.toString(); + } + setMode(value) { + this.mode = value; + } + setECLevel(value) { + this.ecLevel = value; + } + setVersion(version) { + this.version = version; + } + setMaskPattern(value /*int*/) { + this.maskPattern = value; + } + setMatrix(value) { + this.matrix = value; + } + // Check if "mask_pattern" is valid. + static isValidMaskPattern(maskPattern /*int*/) { + return maskPattern >= 0 && maskPattern < QRCode.NUM_MASK_PATTERNS; + } + } + QRCode.NUM_MASK_PATTERNS = 8; + + /** + * Custom Error class of type Exception. + */ + class WriterException extends Exception { + } + WriterException.kind = 'WriterException'; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * @author satorux@google.com (Satoru Takabayashi) - creator + * @author dswitkin@google.com (Daniel Switkin) - ported from C++ + */ + class MatrixUtil { + constructor() { + // do nothing + } + // Set all cells to -1 (TYPESCRIPTPORT: 255). -1 (TYPESCRIPTPORT: 255) means that the cell is empty (not set yet). + // + // JAVAPORT: We shouldn't need to do this at all. The code should be rewritten to begin encoding + // with the ByteMatrix initialized all to zero. + static clearMatrix(matrix) { + // TYPESCRIPTPORT: we use UintArray se changed here from -1 to 255 + matrix.clear(/*(byte) */ /*-1*/ 255); + } + // Build 2D matrix of QR Code from "dataBits" with "ecLevel", "version" and "getMaskPattern". On + // success, store the result in "matrix" and return true. + static buildMatrix(dataBits, ecLevel, version, maskPattern /*int*/, matrix) { + MatrixUtil.clearMatrix(matrix); + MatrixUtil.embedBasicPatterns(version, matrix); + // Type information appear with any version. + MatrixUtil.embedTypeInfo(ecLevel, maskPattern, matrix); + // Version info appear if version >= 7. + MatrixUtil.maybeEmbedVersionInfo(version, matrix); + // Data should be embedded at end. + MatrixUtil.embedDataBits(dataBits, maskPattern, matrix); + } + // Embed basic patterns. On success, modify the matrix and return true. + // The basic patterns are: + // - Position detection patterns + // - Timing patterns + // - Dark dot at the left bottom corner + // - Position adjustment patterns, if need be + static embedBasicPatterns(version, matrix) { + // Let's get started with embedding big squares at corners. + MatrixUtil.embedPositionDetectionPatternsAndSeparators(matrix); + // Then, embed the dark dot at the left bottom corner. + MatrixUtil.embedDarkDotAtLeftBottomCorner(matrix); + // Position adjustment patterns appear if version >= 2. + MatrixUtil.maybeEmbedPositionAdjustmentPatterns(version, matrix); + // Timing patterns should be embedded after position adj. patterns. + MatrixUtil.embedTimingPatterns(matrix); + } + // Embed type information. On success, modify the matrix. + static embedTypeInfo(ecLevel, maskPattern /*int*/, matrix) { + const typeInfoBits = new BitArray(); + MatrixUtil.makeTypeInfoBits(ecLevel, maskPattern, typeInfoBits); + for (let i = 0, size = typeInfoBits.getSize(); i < size; ++i) { + // Place bits in LSB to MSB order. LSB (least significant bit) is the last value in + // "typeInfoBits". + const bit = typeInfoBits.get(typeInfoBits.getSize() - 1 - i); + // Type info bits at the left top corner. See 8.9 of JISX0510:2004 (p.46). + const coordinates = MatrixUtil.TYPE_INFO_COORDINATES[i]; + const x1 = coordinates[0]; + const y1 = coordinates[1]; + matrix.setBoolean(x1, y1, bit); + if (i < 8) { + // Right top corner. + const x2 = matrix.getWidth() - i - 1; + const y2 = 8; + matrix.setBoolean(x2, y2, bit); + } + else { + // Left bottom corner. + const x2 = 8; + const y2 = matrix.getHeight() - 7 + (i - 8); + matrix.setBoolean(x2, y2, bit); + } + } + } + // Embed version information if need be. On success, modify the matrix and return true. + // See 8.10 of JISX0510:2004 (p.47) for how to embed version information. + static maybeEmbedVersionInfo(version, matrix) { + if (version.getVersionNumber() < 7) { // Version info is necessary if version >= 7. + return; // Don't need version info. + } + const versionInfoBits = new BitArray(); + MatrixUtil.makeVersionInfoBits(version, versionInfoBits); + let bitIndex = 6 * 3 - 1; // It will decrease from 17 to 0. + for (let i = 0; i < 6; ++i) { + for (let j = 0; j < 3; ++j) { + // Place bits in LSB (least significant bit) to MSB order. + const bit = versionInfoBits.get(bitIndex); + bitIndex--; + // Left bottom corner. + matrix.setBoolean(i, matrix.getHeight() - 11 + j, bit); + // Right bottom corner. + matrix.setBoolean(matrix.getHeight() - 11 + j, i, bit); + } + } + } + // Embed "dataBits" using "getMaskPattern". On success, modify the matrix and return true. + // For debugging purposes, it skips masking process if "getMaskPattern" is -1(TYPESCRIPTPORT: 255). + // See 8.7 of JISX0510:2004 (p.38) for how to embed data bits. + static embedDataBits(dataBits, maskPattern /*int*/, matrix) { + let bitIndex = 0; + let direction = -1; + // Start from the right bottom cell. + let x = matrix.getWidth() - 1; + let y = matrix.getHeight() - 1; + while (x > 0) { + // Skip the vertical timing pattern. + if (x === 6) { + x -= 1; + } + while (y >= 0 && y < matrix.getHeight()) { + for (let i = 0; i < 2; ++i) { + const xx = x - i; + // Skip the cell if it's not empty. + if (!MatrixUtil.isEmpty(matrix.get(xx, y))) { + continue; + } + let bit; + if (bitIndex < dataBits.getSize()) { + bit = dataBits.get(bitIndex); + ++bitIndex; + } + else { + // Padding bit. If there is no bit left, we'll fill the left cells with 0, as described + // in 8.4.9 of JISX0510:2004 (p. 24). + bit = false; + } + // Skip masking if mask_pattern is -1 (TYPESCRIPTPORT: 255). + if (maskPattern !== 255 && MaskUtil.getDataMaskBit(maskPattern, xx, y)) { + bit = !bit; + } + matrix.setBoolean(xx, y, bit); + } + y += direction; + } + direction = -direction; // Reverse the direction. + y += direction; + x -= 2; // Move to the left. + } + // All bits should be consumed. + if (bitIndex !== dataBits.getSize()) { + throw new WriterException('Not all bits consumed: ' + bitIndex + '/' + dataBits.getSize()); + } + } + // Return the position of the most significant bit set (one: to) in the "value". The most + // significant bit is position 32. If there is no bit set, return 0. Examples: + // - findMSBSet(0) => 0 + // - findMSBSet(1) => 1 + // - findMSBSet(255) => 8 + static findMSBSet(value /*int*/) { + return 32 - Integer.numberOfLeadingZeros(value); + } + // Calculate BCH (Bose-Chaudhuri-Hocquenghem) code for "value" using polynomial "poly". The BCH + // code is used for encoding type information and version information. + // Example: Calculation of version information of 7. + // f(x) is created from 7. + // - 7 = 000111 in 6 bits + // - f(x) = x^2 + x^1 + x^0 + // g(x) is given by the standard (p. 67) + // - g(x) = x^12 + x^11 + x^10 + x^9 + x^8 + x^5 + x^2 + 1 + // Multiply f(x) by x^(18 - 6) + // - f'(x) = f(x) * x^(18 - 6) + // - f'(x) = x^14 + x^13 + x^12 + // Calculate the remainder of f'(x) / g(x) + // x^2 + // __________________________________________________ + // g(x) )x^14 + x^13 + x^12 + // x^14 + x^13 + x^12 + x^11 + x^10 + x^7 + x^4 + x^2 + // -------------------------------------------------- + // x^11 + x^10 + x^7 + x^4 + x^2 + // + // The remainder is x^11 + x^10 + x^7 + x^4 + x^2 + // Encode it in binary: 110010010100 + // The return value is 0xc94 (1100 1001 0100) + // + // Since all coefficients in the polynomials are 1 or 0, we can do the calculation by bit + // operations. We don't care if coefficients are positive or negative. + static calculateBCHCode(value /*int*/, poly /*int*/) { + if (poly === 0) { + throw new IllegalArgumentException('0 polynomial'); + } + // If poly is "1 1111 0010 0101" (version info poly), msbSetInPoly is 13. We'll subtract 1 + // from 13 to make it 12. + const msbSetInPoly = MatrixUtil.findMSBSet(poly); + value <<= msbSetInPoly - 1; + // Do the division business using exclusive-or operations. + while (MatrixUtil.findMSBSet(value) >= msbSetInPoly) { + value ^= poly << (MatrixUtil.findMSBSet(value) - msbSetInPoly); + } + // Now the "value" is the remainder (i.e. the BCH code) + return value; + } + // Make bit vector of type information. On success, store the result in "bits" and return true. + // Encode error correction level and mask pattern. See 8.9 of + // JISX0510:2004 (p.45) for details. + static makeTypeInfoBits(ecLevel, maskPattern /*int*/, bits) { + if (!QRCode.isValidMaskPattern(maskPattern)) { + throw new WriterException('Invalid mask pattern'); + } + const typeInfo = (ecLevel.getBits() << 3) | maskPattern; + bits.appendBits(typeInfo, 5); + const bchCode = MatrixUtil.calculateBCHCode(typeInfo, MatrixUtil.TYPE_INFO_POLY); + bits.appendBits(bchCode, 10); + const maskBits = new BitArray(); + maskBits.appendBits(MatrixUtil.TYPE_INFO_MASK_PATTERN, 15); + bits.xor(maskBits); + if (bits.getSize() !== 15) { // Just in case. + throw new WriterException('should not happen but we got: ' + bits.getSize()); + } + } + // Make bit vector of version information. On success, store the result in "bits" and return true. + // See 8.10 of JISX0510:2004 (p.45) for details. + static makeVersionInfoBits(version, bits) { + bits.appendBits(version.getVersionNumber(), 6); + const bchCode = MatrixUtil.calculateBCHCode(version.getVersionNumber(), MatrixUtil.VERSION_INFO_POLY); + bits.appendBits(bchCode, 12); + if (bits.getSize() !== 18) { // Just in case. + throw new WriterException('should not happen but we got: ' + bits.getSize()); + } + } + // Check if "value" is empty. + static isEmpty(value /*int*/) { + return value === 255; // -1 + } + static embedTimingPatterns(matrix) { + // -8 is for skipping position detection patterns (7: size), and two horizontal/vertical + // separation patterns (1: size). Thus, 8 = 7 + 1. + for (let i = 8; i < matrix.getWidth() - 8; ++i) { + const bit = (i + 1) % 2; + // Horizontal line. + if (MatrixUtil.isEmpty(matrix.get(i, 6))) { + matrix.setNumber(i, 6, bit); + } + // Vertical line. + if (MatrixUtil.isEmpty(matrix.get(6, i))) { + matrix.setNumber(6, i, bit); + } + } + } + // Embed the lonely dark dot at left bottom corner. JISX0510:2004 (p.46) + static embedDarkDotAtLeftBottomCorner(matrix) { + if (matrix.get(8, matrix.getHeight() - 8) === 0) { + throw new WriterException(); + } + matrix.setNumber(8, matrix.getHeight() - 8, 1); + } + static embedHorizontalSeparationPattern(xStart /*int*/, yStart /*int*/, matrix) { + for (let x = 0; x < 8; ++x) { + if (!MatrixUtil.isEmpty(matrix.get(xStart + x, yStart))) { + throw new WriterException(); + } + matrix.setNumber(xStart + x, yStart, 0); + } + } + static embedVerticalSeparationPattern(xStart /*int*/, yStart /*int*/, matrix) { + for (let y = 0; y < 7; ++y) { + if (!MatrixUtil.isEmpty(matrix.get(xStart, yStart + y))) { + throw new WriterException(); + } + matrix.setNumber(xStart, yStart + y, 0); + } + } + static embedPositionAdjustmentPattern(xStart /*int*/, yStart /*int*/, matrix) { + for (let y = 0; y < 5; ++y) { + const patternY = MatrixUtil.POSITION_ADJUSTMENT_PATTERN[y]; + for (let x = 0; x < 5; ++x) { + matrix.setNumber(xStart + x, yStart + y, patternY[x]); + } + } + } + static embedPositionDetectionPattern(xStart /*int*/, yStart /*int*/, matrix) { + for (let y = 0; y < 7; ++y) { + const patternY = MatrixUtil.POSITION_DETECTION_PATTERN[y]; + for (let x = 0; x < 7; ++x) { + matrix.setNumber(xStart + x, yStart + y, patternY[x]); + } + } + } + // Embed position detection patterns and surrounding vertical/horizontal separators. + static embedPositionDetectionPatternsAndSeparators(matrix) { + // Embed three big squares at corners. + const pdpWidth = MatrixUtil.POSITION_DETECTION_PATTERN[0].length; + // Left top corner. + MatrixUtil.embedPositionDetectionPattern(0, 0, matrix); + // Right top corner. + MatrixUtil.embedPositionDetectionPattern(matrix.getWidth() - pdpWidth, 0, matrix); + // Left bottom corner. + MatrixUtil.embedPositionDetectionPattern(0, matrix.getWidth() - pdpWidth, matrix); + // Embed horizontal separation patterns around the squares. + const hspWidth = 8; + // Left top corner. + MatrixUtil.embedHorizontalSeparationPattern(0, hspWidth - 1, matrix); + // Right top corner. + MatrixUtil.embedHorizontalSeparationPattern(matrix.getWidth() - hspWidth, hspWidth - 1, matrix); + // Left bottom corner. + MatrixUtil.embedHorizontalSeparationPattern(0, matrix.getWidth() - hspWidth, matrix); + // Embed vertical separation patterns around the squares. + const vspSize = 7; + // Left top corner. + MatrixUtil.embedVerticalSeparationPattern(vspSize, 0, matrix); + // Right top corner. + MatrixUtil.embedVerticalSeparationPattern(matrix.getHeight() - vspSize - 1, 0, matrix); + // Left bottom corner. + MatrixUtil.embedVerticalSeparationPattern(vspSize, matrix.getHeight() - vspSize, matrix); + } + // Embed position adjustment patterns if need be. + static maybeEmbedPositionAdjustmentPatterns(version, matrix) { + if (version.getVersionNumber() < 2) { // The patterns appear if version >= 2 + return; + } + const index = version.getVersionNumber() - 1; + const coordinates = MatrixUtil.POSITION_ADJUSTMENT_PATTERN_COORDINATE_TABLE[index]; + for (let i = 0, length = coordinates.length; i !== length; i++) { + const y = coordinates[i]; + if (y >= 0) { + for (let j = 0; j !== length; j++) { + const x = coordinates[j]; + if (x >= 0 && MatrixUtil.isEmpty(matrix.get(x, y))) { + // If the cell is unset, we embed the position adjustment pattern here. + // -2 is necessary since the x/y coordinates point to the center of the pattern, not the + // left top corner. + MatrixUtil.embedPositionAdjustmentPattern(x - 2, y - 2, matrix); + } + } + } + } + } + } + MatrixUtil.POSITION_DETECTION_PATTERN = Array.from([ + Int32Array.from([1, 1, 1, 1, 1, 1, 1]), + Int32Array.from([1, 0, 0, 0, 0, 0, 1]), + Int32Array.from([1, 0, 1, 1, 1, 0, 1]), + Int32Array.from([1, 0, 1, 1, 1, 0, 1]), + Int32Array.from([1, 0, 1, 1, 1, 0, 1]), + Int32Array.from([1, 0, 0, 0, 0, 0, 1]), + Int32Array.from([1, 1, 1, 1, 1, 1, 1]), + ]); + MatrixUtil.POSITION_ADJUSTMENT_PATTERN = Array.from([ + Int32Array.from([1, 1, 1, 1, 1]), + Int32Array.from([1, 0, 0, 0, 1]), + Int32Array.from([1, 0, 1, 0, 1]), + Int32Array.from([1, 0, 0, 0, 1]), + Int32Array.from([1, 1, 1, 1, 1]), + ]); + // From Appendix E. Table 1, JIS0510X:2004 (71: p). The table was double-checked by komatsu. + MatrixUtil.POSITION_ADJUSTMENT_PATTERN_COORDINATE_TABLE = Array.from([ + Int32Array.from([-1, -1, -1, -1, -1, -1, -1]), + Int32Array.from([6, 18, -1, -1, -1, -1, -1]), + Int32Array.from([6, 22, -1, -1, -1, -1, -1]), + Int32Array.from([6, 26, -1, -1, -1, -1, -1]), + Int32Array.from([6, 30, -1, -1, -1, -1, -1]), + Int32Array.from([6, 34, -1, -1, -1, -1, -1]), + Int32Array.from([6, 22, 38, -1, -1, -1, -1]), + Int32Array.from([6, 24, 42, -1, -1, -1, -1]), + Int32Array.from([6, 26, 46, -1, -1, -1, -1]), + Int32Array.from([6, 28, 50, -1, -1, -1, -1]), + Int32Array.from([6, 30, 54, -1, -1, -1, -1]), + Int32Array.from([6, 32, 58, -1, -1, -1, -1]), + Int32Array.from([6, 34, 62, -1, -1, -1, -1]), + Int32Array.from([6, 26, 46, 66, -1, -1, -1]), + Int32Array.from([6, 26, 48, 70, -1, -1, -1]), + Int32Array.from([6, 26, 50, 74, -1, -1, -1]), + Int32Array.from([6, 30, 54, 78, -1, -1, -1]), + Int32Array.from([6, 30, 56, 82, -1, -1, -1]), + Int32Array.from([6, 30, 58, 86, -1, -1, -1]), + Int32Array.from([6, 34, 62, 90, -1, -1, -1]), + Int32Array.from([6, 28, 50, 72, 94, -1, -1]), + Int32Array.from([6, 26, 50, 74, 98, -1, -1]), + Int32Array.from([6, 30, 54, 78, 102, -1, -1]), + Int32Array.from([6, 28, 54, 80, 106, -1, -1]), + Int32Array.from([6, 32, 58, 84, 110, -1, -1]), + Int32Array.from([6, 30, 58, 86, 114, -1, -1]), + Int32Array.from([6, 34, 62, 90, 118, -1, -1]), + Int32Array.from([6, 26, 50, 74, 98, 122, -1]), + Int32Array.from([6, 30, 54, 78, 102, 126, -1]), + Int32Array.from([6, 26, 52, 78, 104, 130, -1]), + Int32Array.from([6, 30, 56, 82, 108, 134, -1]), + Int32Array.from([6, 34, 60, 86, 112, 138, -1]), + Int32Array.from([6, 30, 58, 86, 114, 142, -1]), + Int32Array.from([6, 34, 62, 90, 118, 146, -1]), + Int32Array.from([6, 30, 54, 78, 102, 126, 150]), + Int32Array.from([6, 24, 50, 76, 102, 128, 154]), + Int32Array.from([6, 28, 54, 80, 106, 132, 158]), + Int32Array.from([6, 32, 58, 84, 110, 136, 162]), + Int32Array.from([6, 26, 54, 82, 110, 138, 166]), + Int32Array.from([6, 30, 58, 86, 114, 142, 170]), + ]); + // Type info cells at the left top corner. + MatrixUtil.TYPE_INFO_COORDINATES = Array.from([ + Int32Array.from([8, 0]), + Int32Array.from([8, 1]), + Int32Array.from([8, 2]), + Int32Array.from([8, 3]), + Int32Array.from([8, 4]), + Int32Array.from([8, 5]), + Int32Array.from([8, 7]), + Int32Array.from([8, 8]), + Int32Array.from([7, 8]), + Int32Array.from([5, 8]), + Int32Array.from([4, 8]), + Int32Array.from([3, 8]), + Int32Array.from([2, 8]), + Int32Array.from([1, 8]), + Int32Array.from([0, 8]), + ]); + // From Appendix D in JISX0510:2004 (p. 67) + MatrixUtil.VERSION_INFO_POLY = 0x1f25; // 1 1111 0010 0101 + // From Appendix C in JISX0510:2004 (p.65). + MatrixUtil.TYPE_INFO_POLY = 0x537; + MatrixUtil.TYPE_INFO_MASK_PATTERN = 0x5412; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*namespace com.google.zxing.qrcode.encoder {*/ + class BlockPair { + constructor(dataBytes, errorCorrectionBytes) { + this.dataBytes = dataBytes; + this.errorCorrectionBytes = errorCorrectionBytes; + } + getDataBytes() { + return this.dataBytes; + } + getErrorCorrectionBytes() { + return this.errorCorrectionBytes; + } + } + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.io.UnsupportedEncodingException;*/ + /*import java.util.ArrayList;*/ + /*import java.util.Collection;*/ + /*import java.util.Map;*/ + /** + * @author satorux@google.com (Satoru Takabayashi) - creator + * @author dswitkin@google.com (Daniel Switkin) - ported from C++ + */ + class Encoder { + // TYPESCRIPTPORT: changed to UTF8, the default for js + constructor() { } + // The mask penalty calculation is complicated. See Table 21 of JISX0510:2004 (p.45) for details. + // Basically it applies four rules and summate all penalties. + static calculateMaskPenalty(matrix) { + return MaskUtil.applyMaskPenaltyRule1(matrix) + + MaskUtil.applyMaskPenaltyRule2(matrix) + + MaskUtil.applyMaskPenaltyRule3(matrix) + + MaskUtil.applyMaskPenaltyRule4(matrix); + } + /** + * @param content text to encode + * @param ecLevel error correction level to use + * @return {@link QRCode} representing the encoded QR code + * @throws WriterException if encoding can't succeed, because of for example invalid content + * or configuration + */ + // public static encode(content: string, ecLevel: ErrorCorrectionLevel): QRCode /*throws WriterException*/ { + // return encode(content, ecLevel, null) + // } + static encode(content, ecLevel, hints = null) { + // Determine what character encoding has been specified by the caller, if any + let encoding = Encoder.DEFAULT_BYTE_MODE_ENCODING; + const hasEncodingHint = hints !== null && undefined !== hints.get(EncodeHintType$1.CHARACTER_SET); + if (hasEncodingHint) { + encoding = hints.get(EncodeHintType$1.CHARACTER_SET).toString(); + } + // Pick an encoding mode appropriate for the content. Note that this will not attempt to use + // multiple modes / segments even if that were more efficient. Twould be nice. + const mode = this.chooseMode(content, encoding); + // This will store the header information, like mode and + // length, as well as "header" segments like an ECI segment. + const headerBits = new BitArray(); + // Append ECI segment if applicable + if (mode === Mode$1.BYTE && (hasEncodingHint || Encoder.DEFAULT_BYTE_MODE_ENCODING !== encoding)) { + const eci = CharacterSetECI.getCharacterSetECIByName(encoding); + if (eci !== undefined) { + this.appendECI(eci, headerBits); + } + } + // (With ECI in place,) Write the mode marker + this.appendModeInfo(mode, headerBits); + // Collect data within the main segment, separately, to count its size if needed. Don't add it to + // main payload yet. + const dataBits = new BitArray(); + this.appendBytes(content, mode, dataBits, encoding); + let version; + if (hints !== null && undefined !== hints.get(EncodeHintType$1.QR_VERSION)) { + const versionNumber = Number.parseInt(hints.get(EncodeHintType$1.QR_VERSION).toString(), 10); + version = Version$1.getVersionForNumber(versionNumber); + const bitsNeeded = this.calculateBitsNeeded(mode, headerBits, dataBits, version); + if (!this.willFit(bitsNeeded, version, ecLevel)) { + throw new WriterException('Data too big for requested version'); + } + } + else { + version = this.recommendVersion(ecLevel, mode, headerBits, dataBits); + } + const headerAndDataBits = new BitArray(); + headerAndDataBits.appendBitArray(headerBits); + // Find "length" of main segment and write it + const numLetters = mode === Mode$1.BYTE ? dataBits.getSizeInBytes() : content.length; + this.appendLengthInfo(numLetters, version, mode, headerAndDataBits); + // Put data together into the overall payload + headerAndDataBits.appendBitArray(dataBits); + const ecBlocks = version.getECBlocksForLevel(ecLevel); + const numDataBytes = version.getTotalCodewords() - ecBlocks.getTotalECCodewords(); + // Terminate the bits properly. + this.terminateBits(numDataBytes, headerAndDataBits); + // Interleave data bits with error correction code. + const finalBits = this.interleaveWithECBytes(headerAndDataBits, version.getTotalCodewords(), numDataBytes, ecBlocks.getNumBlocks()); + const qrCode = new QRCode(); + qrCode.setECLevel(ecLevel); + qrCode.setMode(mode); + qrCode.setVersion(version); + // Choose the mask pattern and set to "qrCode". + const dimension = version.getDimensionForVersion(); + const matrix = new ByteMatrix(dimension, dimension); + const maskPattern = this.chooseMaskPattern(finalBits, ecLevel, version, matrix); + qrCode.setMaskPattern(maskPattern); + // Build the matrix and set it to "qrCode". + MatrixUtil.buildMatrix(finalBits, ecLevel, version, maskPattern, matrix); + qrCode.setMatrix(matrix); + return qrCode; + } + /** + * Decides the smallest version of QR code that will contain all of the provided data. + * + * @throws WriterException if the data cannot fit in any version + */ + static recommendVersion(ecLevel, mode, headerBits, dataBits) { + // Hard part: need to know version to know how many bits length takes. But need to know how many + // bits it takes to know version. First we take a guess at version by assuming version will be + // the minimum, 1: + const provisionalBitsNeeded = this.calculateBitsNeeded(mode, headerBits, dataBits, Version$1.getVersionForNumber(1)); + const provisionalVersion = this.chooseVersion(provisionalBitsNeeded, ecLevel); + // Use that guess to calculate the right version. I am still not sure this works in 100% of cases. + const bitsNeeded = this.calculateBitsNeeded(mode, headerBits, dataBits, provisionalVersion); + return this.chooseVersion(bitsNeeded, ecLevel); + } + static calculateBitsNeeded(mode, headerBits, dataBits, version) { + return headerBits.getSize() + mode.getCharacterCountBits(version) + dataBits.getSize(); + } + /** + * @return the code point of the table used in alphanumeric mode or + * -1 if there is no corresponding code in the table. + */ + static getAlphanumericCode(code /*int*/) { + if (code < Encoder.ALPHANUMERIC_TABLE.length) { + return Encoder.ALPHANUMERIC_TABLE[code]; + } + return -1; + } + // public static chooseMode(content: string): Mode { + // return chooseMode(content, null); + // } + /** + * Choose the best mode by examining the content. Note that 'encoding' is used as a hint; + * if it is Shift_JIS, and the input is only double-byte Kanji, then we return {@link Mode#KANJI}. + */ + static chooseMode(content, encoding = null) { + if (CharacterSetECI.SJIS.getName() === encoding && this.isOnlyDoubleByteKanji(content)) { + // Choose Kanji mode if all input are double-byte characters + return Mode$1.KANJI; + } + let hasNumeric = false; + let hasAlphanumeric = false; + for (let i = 0, length = content.length; i < length; ++i) { + const c = content.charAt(i); + if (Encoder.isDigit(c)) { + hasNumeric = true; + } + else if (this.getAlphanumericCode(c.charCodeAt(0)) !== -1) { + hasAlphanumeric = true; + } + else { + return Mode$1.BYTE; + } + } + if (hasAlphanumeric) { + return Mode$1.ALPHANUMERIC; + } + if (hasNumeric) { + return Mode$1.NUMERIC; + } + return Mode$1.BYTE; + } + static isOnlyDoubleByteKanji(content) { + let bytes; + try { + bytes = StringEncoding.encode(content, CharacterSetECI.SJIS); // content.getBytes("Shift_JIS")) + } + catch (ignored /*: UnsupportedEncodingException*/) { + return false; + } + const length = bytes.length; + if (length % 2 !== 0) { + return false; + } + for (let i = 0; i < length; i += 2) { + const byte1 = bytes[i] & 0xFF; + if ((byte1 < 0x81 || byte1 > 0x9F) && (byte1 < 0xE0 || byte1 > 0xEB)) { + return false; + } + } + return true; + } + static chooseMaskPattern(bits, ecLevel, version, matrix) { + let minPenalty = Number.MAX_SAFE_INTEGER; // Lower penalty is better. + let bestMaskPattern = -1; + // We try all mask patterns to choose the best one. + for (let maskPattern = 0; maskPattern < QRCode.NUM_MASK_PATTERNS; maskPattern++) { + MatrixUtil.buildMatrix(bits, ecLevel, version, maskPattern, matrix); + let penalty = this.calculateMaskPenalty(matrix); + if (penalty < minPenalty) { + minPenalty = penalty; + bestMaskPattern = maskPattern; + } + } + return bestMaskPattern; + } + static chooseVersion(numInputBits /*int*/, ecLevel) { + for (let versionNum = 1; versionNum <= 40; versionNum++) { + const version = Version$1.getVersionForNumber(versionNum); + if (Encoder.willFit(numInputBits, version, ecLevel)) { + return version; + } + } + throw new WriterException('Data too big'); + } + /** + * @return true if the number of input bits will fit in a code with the specified version and + * error correction level. + */ + static willFit(numInputBits /*int*/, version, ecLevel) { + // In the following comments, we use numbers of Version 7-H. + // numBytes = 196 + const numBytes = version.getTotalCodewords(); + // getNumECBytes = 130 + const ecBlocks = version.getECBlocksForLevel(ecLevel); + const numEcBytes = ecBlocks.getTotalECCodewords(); + // getNumDataBytes = 196 - 130 = 66 + const numDataBytes = numBytes - numEcBytes; + const totalInputBytes = (numInputBits + 7) / 8; + return numDataBytes >= totalInputBytes; + } + /** + * Terminate bits as described in 8.4.8 and 8.4.9 of JISX0510:2004 (p.24). + */ + static terminateBits(numDataBytes /*int*/, bits) { + const capacity = numDataBytes * 8; + if (bits.getSize() > capacity) { + throw new WriterException('data bits cannot fit in the QR Code' + bits.getSize() + ' > ' + + capacity); + } + for (let i = 0; i < 4 && bits.getSize() < capacity; ++i) { + bits.appendBit(false); + } + // Append termination bits. See 8.4.8 of JISX0510:2004 (p.24) for details. + // If the last byte isn't 8-bit aligned, we'll add padding bits. + const numBitsInLastByte = bits.getSize() & 0x07; + if (numBitsInLastByte > 0) { + for (let i = numBitsInLastByte; i < 8; i++) { + bits.appendBit(false); + } + } + // If we have more space, we'll fill the space with padding patterns defined in 8.4.9 (p.24). + const numPaddingBytes = numDataBytes - bits.getSizeInBytes(); + for (let i = 0; i < numPaddingBytes; ++i) { + bits.appendBits((i & 0x01) === 0 ? 0xEC : 0x11, 8); + } + if (bits.getSize() !== capacity) { + throw new WriterException('Bits size does not equal capacity'); + } + } + /** + * Get number of data bytes and number of error correction bytes for block id "blockID". Store + * the result in "numDataBytesInBlock", and "numECBytesInBlock". See table 12 in 8.5.1 of + * JISX0510:2004 (p.30) + */ + static getNumDataBytesAndNumECBytesForBlockID(numTotalBytes /*int*/, numDataBytes /*int*/, numRSBlocks /*int*/, blockID /*int*/, numDataBytesInBlock, numECBytesInBlock) { + if (blockID >= numRSBlocks) { + throw new WriterException('Block ID too large'); + } + // numRsBlocksInGroup2 = 196 % 5 = 1 + const numRsBlocksInGroup2 = numTotalBytes % numRSBlocks; + // numRsBlocksInGroup1 = 5 - 1 = 4 + const numRsBlocksInGroup1 = numRSBlocks - numRsBlocksInGroup2; + // numTotalBytesInGroup1 = 196 / 5 = 39 + const numTotalBytesInGroup1 = Math.floor(numTotalBytes / numRSBlocks); + // numTotalBytesInGroup2 = 39 + 1 = 40 + const numTotalBytesInGroup2 = numTotalBytesInGroup1 + 1; + // numDataBytesInGroup1 = 66 / 5 = 13 + const numDataBytesInGroup1 = Math.floor(numDataBytes / numRSBlocks); + // numDataBytesInGroup2 = 13 + 1 = 14 + const numDataBytesInGroup2 = numDataBytesInGroup1 + 1; + // numEcBytesInGroup1 = 39 - 13 = 26 + const numEcBytesInGroup1 = numTotalBytesInGroup1 - numDataBytesInGroup1; + // numEcBytesInGroup2 = 40 - 14 = 26 + const numEcBytesInGroup2 = numTotalBytesInGroup2 - numDataBytesInGroup2; + // Sanity checks. + // 26 = 26 + if (numEcBytesInGroup1 !== numEcBytesInGroup2) { + throw new WriterException('EC bytes mismatch'); + } + // 5 = 4 + 1. + if (numRSBlocks !== numRsBlocksInGroup1 + numRsBlocksInGroup2) { + throw new WriterException('RS blocks mismatch'); + } + // 196 = (13 + 26) * 4 + (14 + 26) * 1 + if (numTotalBytes !== + ((numDataBytesInGroup1 + numEcBytesInGroup1) * + numRsBlocksInGroup1) + + ((numDataBytesInGroup2 + numEcBytesInGroup2) * + numRsBlocksInGroup2)) { + throw new WriterException('Total bytes mismatch'); + } + if (blockID < numRsBlocksInGroup1) { + numDataBytesInBlock[0] = numDataBytesInGroup1; + numECBytesInBlock[0] = numEcBytesInGroup1; + } + else { + numDataBytesInBlock[0] = numDataBytesInGroup2; + numECBytesInBlock[0] = numEcBytesInGroup2; + } + } + /** + * Interleave "bits" with corresponding error correction bytes. On success, store the result in + * "result". The interleave rule is complicated. See 8.6 of JISX0510:2004 (p.37) for details. + */ + static interleaveWithECBytes(bits, numTotalBytes /*int*/, numDataBytes /*int*/, numRSBlocks /*int*/) { + // "bits" must have "getNumDataBytes" bytes of data. + if (bits.getSizeInBytes() !== numDataBytes) { + throw new WriterException('Number of bits and data bytes does not match'); + } + // Step 1. Divide data bytes into blocks and generate error correction bytes for them. We'll + // store the divided data bytes blocks and error correction bytes blocks into "blocks". + let dataBytesOffset = 0; + let maxNumDataBytes = 0; + let maxNumEcBytes = 0; + // Since, we know the number of reedsolmon blocks, we can initialize the vector with the number. + const blocks = new Array(); // new Array(numRSBlocks) + for (let i = 0; i < numRSBlocks; ++i) { + const numDataBytesInBlock = new Int32Array(1); + const numEcBytesInBlock = new Int32Array(1); + Encoder.getNumDataBytesAndNumECBytesForBlockID(numTotalBytes, numDataBytes, numRSBlocks, i, numDataBytesInBlock, numEcBytesInBlock); + const size = numDataBytesInBlock[0]; + const dataBytes = new Uint8Array(size); + bits.toBytes(8 * dataBytesOffset, dataBytes, 0, size); + const ecBytes = Encoder.generateECBytes(dataBytes, numEcBytesInBlock[0]); + blocks.push(new BlockPair(dataBytes, ecBytes)); + maxNumDataBytes = Math.max(maxNumDataBytes, size); + maxNumEcBytes = Math.max(maxNumEcBytes, ecBytes.length); + dataBytesOffset += numDataBytesInBlock[0]; + } + if (numDataBytes !== dataBytesOffset) { + throw new WriterException('Data bytes does not match offset'); + } + const result = new BitArray(); + // First, place data blocks. + for (let i = 0; i < maxNumDataBytes; ++i) { + for (const block of blocks) { + const dataBytes = block.getDataBytes(); + if (i < dataBytes.length) { + result.appendBits(dataBytes[i], 8); + } + } + } + // Then, place error correction blocks. + for (let i = 0; i < maxNumEcBytes; ++i) { + for (const block of blocks) { + const ecBytes = block.getErrorCorrectionBytes(); + if (i < ecBytes.length) { + result.appendBits(ecBytes[i], 8); + } + } + } + if (numTotalBytes !== result.getSizeInBytes()) { // Should be same. + throw new WriterException('Interleaving error: ' + numTotalBytes + ' and ' + + result.getSizeInBytes() + ' differ.'); + } + return result; + } + static generateECBytes(dataBytes, numEcBytesInBlock /*int*/) { + const numDataBytes = dataBytes.length; + const toEncode = new Int32Array(numDataBytes + numEcBytesInBlock); // int[numDataBytes + numEcBytesInBlock] + for (let i = 0; i < numDataBytes; i++) { + toEncode[i] = dataBytes[i] & 0xFF; + } + new ReedSolomonEncoder(GenericGF.QR_CODE_FIELD_256).encode(toEncode, numEcBytesInBlock); + const ecBytes = new Uint8Array(numEcBytesInBlock); + for (let i = 0; i < numEcBytesInBlock; i++) { + ecBytes[i] = /*(byte) */ toEncode[numDataBytes + i]; + } + return ecBytes; + } + /** + * Append mode info. On success, store the result in "bits". + */ + static appendModeInfo(mode, bits) { + bits.appendBits(mode.getBits(), 4); + } + /** + * Append length info. On success, store the result in "bits". + */ + static appendLengthInfo(numLetters /*int*/, version, mode, bits) { + const numBits = mode.getCharacterCountBits(version); + if (numLetters >= (1 << numBits)) { + throw new WriterException(numLetters + ' is bigger than ' + ((1 << numBits) - 1)); + } + bits.appendBits(numLetters, numBits); + } + /** + * Append "bytes" in "mode" mode (encoding) into "bits". On success, store the result in "bits". + */ + static appendBytes(content, mode, bits, encoding) { + switch (mode) { + case Mode$1.NUMERIC: + Encoder.appendNumericBytes(content, bits); + break; + case Mode$1.ALPHANUMERIC: + Encoder.appendAlphanumericBytes(content, bits); + break; + case Mode$1.BYTE: + Encoder.append8BitBytes(content, bits, encoding); + break; + case Mode$1.KANJI: + Encoder.appendKanjiBytes(content, bits); + break; + default: + throw new WriterException('Invalid mode: ' + mode); + } + } + static getDigit(singleCharacter) { + return singleCharacter.charCodeAt(0) - 48; + } + static isDigit(singleCharacter) { + const cn = Encoder.getDigit(singleCharacter); + return cn >= 0 && cn <= 9; + } + static appendNumericBytes(content, bits) { + const length = content.length; + let i = 0; + while (i < length) { + const num1 = Encoder.getDigit(content.charAt(i)); + if (i + 2 < length) { + // Encode three numeric letters in ten bits. + const num2 = Encoder.getDigit(content.charAt(i + 1)); + const num3 = Encoder.getDigit(content.charAt(i + 2)); + bits.appendBits(num1 * 100 + num2 * 10 + num3, 10); + i += 3; + } + else if (i + 1 < length) { + // Encode two numeric letters in seven bits. + const num2 = Encoder.getDigit(content.charAt(i + 1)); + bits.appendBits(num1 * 10 + num2, 7); + i += 2; + } + else { + // Encode one numeric letter in four bits. + bits.appendBits(num1, 4); + i++; + } + } + } + static appendAlphanumericBytes(content, bits) { + const length = content.length; + let i = 0; + while (i < length) { + const code1 = Encoder.getAlphanumericCode(content.charCodeAt(i)); + if (code1 === -1) { + throw new WriterException(); + } + if (i + 1 < length) { + const code2 = Encoder.getAlphanumericCode(content.charCodeAt(i + 1)); + if (code2 === -1) { + throw new WriterException(); + } + // Encode two alphanumeric letters in 11 bits. + bits.appendBits(code1 * 45 + code2, 11); + i += 2; + } + else { + // Encode one alphanumeric letter in six bits. + bits.appendBits(code1, 6); + i++; + } + } + } + static append8BitBytes(content, bits, encoding) { + let bytes; + try { + bytes = StringEncoding.encode(content, encoding); + } + catch (uee /*: UnsupportedEncodingException*/) { + throw new WriterException(uee); + } + for (let i = 0, length = bytes.length; i !== length; i++) { + const b = bytes[i]; + bits.appendBits(b, 8); + } + } + /** + * @throws WriterException + */ + static appendKanjiBytes(content, bits) { + let bytes; + try { + bytes = StringEncoding.encode(content, CharacterSetECI.SJIS); + } + catch (uee /*: UnsupportedEncodingException*/) { + throw new WriterException(uee); + } + const length = bytes.length; + for (let i = 0; i < length; i += 2) { + const byte1 = bytes[i] & 0xFF; + const byte2 = bytes[i + 1] & 0xFF; + const code = ((byte1 << 8) & 0xFFFFFFFF) | byte2; + let subtracted = -1; + if (code >= 0x8140 && code <= 0x9ffc) { + subtracted = code - 0x8140; + } + else if (code >= 0xe040 && code <= 0xebbf) { + subtracted = code - 0xc140; + } + if (subtracted === -1) { + throw new WriterException('Invalid byte sequence'); + } + const encoded = ((subtracted >> 8) * 0xc0) + (subtracted & 0xff); + bits.appendBits(encoded, 13); + } + } + static appendECI(eci, bits) { + bits.appendBits(Mode$1.ECI.getBits(), 4); + // This is correct for values up to 127, which is all we need now. + bits.appendBits(eci.getValue(), 8); + } + } + // The original table is defined in the table 5 of JISX0510:2004 (p.19). + Encoder.ALPHANUMERIC_TABLE = Int32Array.from([ + -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, + -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, + 36, -1, -1, -1, 37, 38, -1, -1, -1, -1, 39, 40, -1, 41, 42, 43, + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 44, -1, -1, -1, -1, -1, + -1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, + 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, -1, -1, -1, -1, -1, + ]); + Encoder.DEFAULT_BYTE_MODE_ENCODING = CharacterSetECI.UTF8.getName(); // "ISO-8859-1" + + /** + * @deprecated Moving to @zxing/browser + */ + class BrowserQRCodeSvgWriter { + /** + * Writes and renders a QRCode SVG element. + * + * @param contents + * @param width + * @param height + * @param hints + */ + write(contents, width, height, hints = null) { + if (contents.length === 0) { + throw new IllegalArgumentException('Found empty contents'); + } + // if (format != BarcodeFormat.QR_CODE) { + // throw new IllegalArgumentException("Can only encode QR_CODE, but got " + format) + // } + if (width < 0 || height < 0) { + throw new IllegalArgumentException('Requested dimensions are too small: ' + width + 'x' + height); + } + let errorCorrectionLevel = ErrorCorrectionLevel.L; + let quietZone = BrowserQRCodeSvgWriter.QUIET_ZONE_SIZE; + if (hints !== null) { + if (undefined !== hints.get(EncodeHintType$1.ERROR_CORRECTION)) { + errorCorrectionLevel = ErrorCorrectionLevel.fromString(hints.get(EncodeHintType$1.ERROR_CORRECTION).toString()); + } + if (undefined !== hints.get(EncodeHintType$1.MARGIN)) { + quietZone = Number.parseInt(hints.get(EncodeHintType$1.MARGIN).toString(), 10); + } + } + const code = Encoder.encode(contents, errorCorrectionLevel, hints); + return this.renderResult(code, width, height, quietZone); + } + /** + * Renders the result and then appends it to the DOM. + */ + writeToDom(containerElement, contents, width, height, hints = null) { + if (typeof containerElement === 'string') { + containerElement = document.querySelector(containerElement); + } + const svgElement = this.write(contents, width, height, hints); + if (containerElement) + containerElement.appendChild(svgElement); + } + /** + * Note that the input matrix uses 0 == white, 1 == black. + * The output matrix uses 0 == black, 255 == white (i.e. an 8 bit greyscale bitmap). + */ + renderResult(code, width /*int*/, height /*int*/, quietZone /*int*/) { + const input = code.getMatrix(); + if (input === null) { + throw new IllegalStateException(); + } + const inputWidth = input.getWidth(); + const inputHeight = input.getHeight(); + const qrWidth = inputWidth + (quietZone * 2); + const qrHeight = inputHeight + (quietZone * 2); + const outputWidth = Math.max(width, qrWidth); + const outputHeight = Math.max(height, qrHeight); + const multiple = Math.min(Math.floor(outputWidth / qrWidth), Math.floor(outputHeight / qrHeight)); + // Padding includes both the quiet zone and the extra white pixels to accommodate the requested + // dimensions. For example, if input is 25x25 the QR will be 33x33 including the quiet zone. + // If the requested size is 200x160, the multiple will be 4, for a QR of 132x132. These will + // handle all the padding from 100x100 (the actual QR) up to 200x160. + const leftPadding = Math.floor((outputWidth - (inputWidth * multiple)) / 2); + const topPadding = Math.floor((outputHeight - (inputHeight * multiple)) / 2); + const svgElement = this.createSVGElement(outputWidth, outputHeight); + for (let inputY = 0, outputY = topPadding; inputY < inputHeight; inputY++, outputY += multiple) { + // Write the contents of this row of the barcode + for (let inputX = 0, outputX = leftPadding; inputX < inputWidth; inputX++, outputX += multiple) { + if (input.get(inputX, inputY) === 1) { + const svgRectElement = this.createSvgRectElement(outputX, outputY, multiple, multiple); + svgElement.appendChild(svgRectElement); + } + } + } + return svgElement; + } + /** + * Creates a SVG element. + * + * @param w SVG's width attribute + * @param h SVG's height attribute + */ + createSVGElement(w, h) { + const svgElement = document.createElementNS(BrowserQRCodeSvgWriter.SVG_NS, 'svg'); + svgElement.setAttributeNS(null, 'height', w.toString()); + svgElement.setAttributeNS(null, 'width', h.toString()); + return svgElement; + } + /** + * Creates a SVG rect element. + * + * @param x Element's x coordinate + * @param y Element's y coordinate + * @param w Element's width attribute + * @param h Element's height attribute + */ + createSvgRectElement(x, y, w, h) { + const rect = document.createElementNS(BrowserQRCodeSvgWriter.SVG_NS, 'rect'); + rect.setAttributeNS(null, 'x', x.toString()); + rect.setAttributeNS(null, 'y', y.toString()); + rect.setAttributeNS(null, 'height', w.toString()); + rect.setAttributeNS(null, 'width', h.toString()); + rect.setAttributeNS(null, 'fill', '#000000'); + return rect; + } + } + BrowserQRCodeSvgWriter.QUIET_ZONE_SIZE = 4; + /** + * SVG markup NameSpace + */ + BrowserQRCodeSvgWriter.SVG_NS = 'http://www.w3.org/2000/svg'; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.Map;*/ + /** + * This object renders a QR Code as a BitMatrix 2D array of greyscale values. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class QRCodeWriter { + /*@Override*/ + // public encode(contents: string, format: BarcodeFormat, width: number /*int*/, height: number /*int*/): BitMatrix + // /*throws WriterException */ { + // return encode(contents, format, width, height, null) + // } + /*@Override*/ + encode(contents, format, width /*int*/, height /*int*/, hints) { + if (contents.length === 0) { + throw new IllegalArgumentException('Found empty contents'); + } + if (format !== BarcodeFormat$1.QR_CODE) { + throw new IllegalArgumentException('Can only encode QR_CODE, but got ' + format); + } + if (width < 0 || height < 0) { + throw new IllegalArgumentException(`Requested dimensions are too small: ${width}x${height}`); + } + let errorCorrectionLevel = ErrorCorrectionLevel.L; + let quietZone = QRCodeWriter.QUIET_ZONE_SIZE; + if (hints !== null) { + if (undefined !== hints.get(EncodeHintType$1.ERROR_CORRECTION)) { + errorCorrectionLevel = ErrorCorrectionLevel.fromString(hints.get(EncodeHintType$1.ERROR_CORRECTION).toString()); + } + if (undefined !== hints.get(EncodeHintType$1.MARGIN)) { + quietZone = Number.parseInt(hints.get(EncodeHintType$1.MARGIN).toString(), 10); + } + } + const code = Encoder.encode(contents, errorCorrectionLevel, hints); + return QRCodeWriter.renderResult(code, width, height, quietZone); + } + // Note that the input matrix uses 0 == white, 1 == black, while the output matrix uses + // 0 == black, 255 == white (i.e. an 8 bit greyscale bitmap). + static renderResult(code, width /*int*/, height /*int*/, quietZone /*int*/) { + const input = code.getMatrix(); + if (input === null) { + throw new IllegalStateException(); + } + const inputWidth = input.getWidth(); + const inputHeight = input.getHeight(); + const qrWidth = inputWidth + (quietZone * 2); + const qrHeight = inputHeight + (quietZone * 2); + const outputWidth = Math.max(width, qrWidth); + const outputHeight = Math.max(height, qrHeight); + const multiple = Math.min(Math.floor(outputWidth / qrWidth), Math.floor(outputHeight / qrHeight)); + // Padding includes both the quiet zone and the extra white pixels to accommodate the requested + // dimensions. For example, if input is 25x25 the QR will be 33x33 including the quiet zone. + // If the requested size is 200x160, the multiple will be 4, for a QR of 132x132. These will + // handle all the padding from 100x100 (the actual QR) up to 200x160. + const leftPadding = Math.floor((outputWidth - (inputWidth * multiple)) / 2); + const topPadding = Math.floor((outputHeight - (inputHeight * multiple)) / 2); + const output = new BitMatrix(outputWidth, outputHeight); + for (let inputY = 0, outputY = topPadding; inputY < inputHeight; inputY++, outputY += multiple) { + // Write the contents of this row of the barcode + for (let inputX = 0, outputX = leftPadding; inputX < inputWidth; inputX++, outputX += multiple) { + if (input.get(inputX, inputY) === 1) { + output.setRegion(outputX, outputY, multiple, multiple); + } + } + } + return output; + } + } + QRCodeWriter.QUIET_ZONE_SIZE = 4; + + /* + * Copyright 2008 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*import java.util.Map;*/ + /** + * This is a factory class which finds the appropriate Writer subclass for the BarcodeFormat + * requested and encodes the barcode with the supplied contents. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class MultiFormatWriter { + /*@Override*/ + // public encode(contents: string, + // format: BarcodeFormat, + // width: number /*int*/, + // height: number /*int*/): BitMatrix /*throws WriterException */ { + // return encode(contents, format, width, height, null) + // } + /*@Override*/ + encode(contents, format, width /*int*/, height /*int*/, hints) { + let writer; + switch (format) { + // case BarcodeFormat.EAN_8: + // writer = new EAN8Writer() + // break + // case BarcodeFormat.UPC_E: + // writer = new UPCEWriter() + // break + // case BarcodeFormat.EAN_13: + // writer = new EAN13Writer() + // break + // case BarcodeFormat.UPC_A: + // writer = new UPCAWriter() + // break + case BarcodeFormat$1.QR_CODE: + writer = new QRCodeWriter(); + break; + // case BarcodeFormat.CODE_39: + // writer = new Code39Writer() + // break + // case BarcodeFormat.CODE_93: + // writer = new Code93Writer() + // break + // case BarcodeFormat.CODE_128: + // writer = new Code128Writer() + // break + // case BarcodeFormat.ITF: + // writer = new ITFWriter() + // break + // case BarcodeFormat.PDF_417: + // writer = new PDF417Writer() + // break + // case BarcodeFormat.CODABAR: + // writer = new CodaBarWriter() + // break + // case BarcodeFormat.DATA_MATRIX: + // writer = new DataMatrixWriter() + // break + // case BarcodeFormat.AZTEC: + // writer = new AztecWriter() + // break + default: + throw new IllegalArgumentException('No encoder available for format ' + format); + } + return writer.encode(contents, format, width, height, hints); + } + } + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This object extends LuminanceSource around an array of YUV data returned from the camera driver, + * with the option to crop to a rectangle within the full data. This can be used to exclude + * superfluous pixels around the perimeter and speed up decoding. + * + * It works for any pixel format where the Y channel is planar and appears first, including + * YCbCr_420_SP and YCbCr_422_SP. + * + * @author dswitkin@google.com (Daniel Switkin) + */ + class PlanarYUVLuminanceSource extends LuminanceSource { + constructor(yuvData, dataWidth /*int*/, dataHeight /*int*/, left /*int*/, top /*int*/, width /*int*/, height /*int*/, reverseHorizontal) { + super(width, height); + this.yuvData = yuvData; + this.dataWidth = dataWidth; + this.dataHeight = dataHeight; + this.left = left; + this.top = top; + if (left + width > dataWidth || top + height > dataHeight) { + throw new IllegalArgumentException('Crop rectangle does not fit within image data.'); + } + if (reverseHorizontal) { + this.reverseHorizontal(width, height); + } + } + /*@Override*/ + getRow(y /*int*/, row) { + if (y < 0 || y >= this.getHeight()) { + throw new IllegalArgumentException('Requested row is outside the image: ' + y); + } + const width = this.getWidth(); + if (row === null || row === undefined || row.length < width) { + row = new Uint8ClampedArray(width); + } + const offset = (y + this.top) * this.dataWidth + this.left; + System.arraycopy(this.yuvData, offset, row, 0, width); + return row; + } + /*@Override*/ + getMatrix() { + const width = this.getWidth(); + const height = this.getHeight(); + // If the caller asks for the entire underlying image, save the copy and give them the + // original data. The docs specifically warn that result.length must be ignored. + if (width === this.dataWidth && height === this.dataHeight) { + return this.yuvData; + } + const area = width * height; + const matrix = new Uint8ClampedArray(area); + let inputOffset = this.top * this.dataWidth + this.left; + // If the width matches the full width of the underlying data, perform a single copy. + if (width === this.dataWidth) { + System.arraycopy(this.yuvData, inputOffset, matrix, 0, area); + return matrix; + } + // Otherwise copy one cropped row at a time. + for (let y = 0; y < height; y++) { + const outputOffset = y * width; + System.arraycopy(this.yuvData, inputOffset, matrix, outputOffset, width); + inputOffset += this.dataWidth; + } + return matrix; + } + /*@Override*/ + isCropSupported() { + return true; + } + /*@Override*/ + crop(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + return new PlanarYUVLuminanceSource(this.yuvData, this.dataWidth, this.dataHeight, this.left + left, this.top + top, width, height, false); + } + renderThumbnail() { + const width = this.getWidth() / PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR; + const height = this.getHeight() / PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR; + const pixels = new Int32Array(width * height); + const yuv = this.yuvData; + let inputOffset = this.top * this.dataWidth + this.left; + for (let y = 0; y < height; y++) { + const outputOffset = y * width; + for (let x = 0; x < width; x++) { + const grey = yuv[inputOffset + x * PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR] & 0xff; + pixels[outputOffset + x] = 0xFF000000 | (grey * 0x00010101); + } + inputOffset += this.dataWidth * PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR; + } + return pixels; + } + /** + * @return width of image from {@link #renderThumbnail()} + */ + getThumbnailWidth() { + return this.getWidth() / PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR; + } + /** + * @return height of image from {@link #renderThumbnail()} + */ + getThumbnailHeight() { + return this.getHeight() / PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR; + } + reverseHorizontal(width /*int*/, height /*int*/) { + const yuvData = this.yuvData; + for (let y = 0, rowStart = this.top * this.dataWidth + this.left; y < height; y++, rowStart += this.dataWidth) { + const middle = rowStart + width / 2; + for (let x1 = rowStart, x2 = rowStart + width - 1; x1 < middle; x1++, x2--) { + const temp = yuvData[x1]; + yuvData[x1] = yuvData[x2]; + yuvData[x2] = temp; + } + } + } + invert() { + return new InvertedLuminanceSource(this); + } + } + PlanarYUVLuminanceSource.THUMBNAIL_SCALE_FACTOR = 2; + + /* + * Copyright 2009 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This class is used to help decode images from files which arrive as RGB data from + * an ARGB pixel array. It does not support rotation. + * + * @author dswitkin@google.com (Daniel Switkin) + * @author Betaminos + */ + class RGBLuminanceSource extends LuminanceSource { + constructor(luminances, width /*int*/, height /*int*/, dataWidth /*int*/, dataHeight /*int*/, left /*int*/, top /*int*/) { + super(width, height); + this.dataWidth = dataWidth; + this.dataHeight = dataHeight; + this.left = left; + this.top = top; + if (luminances.BYTES_PER_ELEMENT === 4) { // Int32Array + const size = width * height; + const luminancesUint8Array = new Uint8ClampedArray(size); + for (let offset = 0; offset < size; offset++) { + const pixel = luminances[offset]; + const r = (pixel >> 16) & 0xff; // red + const g2 = (pixel >> 7) & 0x1fe; // 2 * green + const b = pixel & 0xff; // blue + // Calculate green-favouring average cheaply + luminancesUint8Array[offset] = /*(byte) */ ((r + g2 + b) / 4) & 0xFF; + } + this.luminances = luminancesUint8Array; + } + else { + this.luminances = luminances; + } + if (undefined === dataWidth) { + this.dataWidth = width; + } + if (undefined === dataHeight) { + this.dataHeight = height; + } + if (undefined === left) { + this.left = 0; + } + if (undefined === top) { + this.top = 0; + } + if (this.left + width > this.dataWidth || this.top + height > this.dataHeight) { + throw new IllegalArgumentException('Crop rectangle does not fit within image data.'); + } + } + /*@Override*/ + getRow(y /*int*/, row) { + if (y < 0 || y >= this.getHeight()) { + throw new IllegalArgumentException('Requested row is outside the image: ' + y); + } + const width = this.getWidth(); + if (row === null || row === undefined || row.length < width) { + row = new Uint8ClampedArray(width); + } + const offset = (y + this.top) * this.dataWidth + this.left; + System.arraycopy(this.luminances, offset, row, 0, width); + return row; + } + /*@Override*/ + getMatrix() { + const width = this.getWidth(); + const height = this.getHeight(); + // If the caller asks for the entire underlying image, save the copy and give them the + // original data. The docs specifically warn that result.length must be ignored. + if (width === this.dataWidth && height === this.dataHeight) { + return this.luminances; + } + const area = width * height; + const matrix = new Uint8ClampedArray(area); + let inputOffset = this.top * this.dataWidth + this.left; + // If the width matches the full width of the underlying data, perform a single copy. + if (width === this.dataWidth) { + System.arraycopy(this.luminances, inputOffset, matrix, 0, area); + return matrix; + } + // Otherwise copy one cropped row at a time. + for (let y = 0; y < height; y++) { + const outputOffset = y * width; + System.arraycopy(this.luminances, inputOffset, matrix, outputOffset, width); + inputOffset += this.dataWidth; + } + return matrix; + } + /*@Override*/ + isCropSupported() { + return true; + } + /*@Override*/ + crop(left /*int*/, top /*int*/, width /*int*/, height /*int*/) { + return new RGBLuminanceSource(this.luminances, width, height, this.dataWidth, this.dataHeight, this.left + left, this.top + top); + } + invert() { + return new InvertedLuminanceSource(this); + } + } + + /** + * Just to make a shortcut between Java code and TS code. + */ + class Charset extends CharacterSetECI { + static forName(name) { + return this.getCharacterSetECIByName(name); + } + } + + /** + * Just to make a shortcut between Java code and TS code. + */ + class StandardCharsets { + } + StandardCharsets.ISO_8859_1 = CharacterSetECI.ISO8859_1; + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Aztec 2D code representation + * + * @author Rustam Abdullaev + */ + /*public final*/ class AztecCode { + /** + * @return {@code true} if compact instead of full mode + */ + isCompact() { + return this.compact; + } + setCompact(compact) { + this.compact = compact; + } + /** + * @return size in pixels (width and height) + */ + getSize() { + return this.size; + } + setSize(size) { + this.size = size; + } + /** + * @return number of levels + */ + getLayers() { + return this.layers; + } + setLayers(layers) { + this.layers = layers; + } + /** + * @return number of data codewords + */ + getCodeWords() { + return this.codeWords; + } + setCodeWords(codeWords) { + this.codeWords = codeWords; + } + /** + * @return the symbol image + */ + getMatrix() { + return this.matrix; + } + setMatrix(matrix) { + this.matrix = matrix; + } + } + + class Collections { + /** + * The singletonList(T) method is used to return an immutable list containing only the specified object. + */ + static singletonList(item) { + return [item]; + } + /** + * The min(Collection, Comparator) method is used to return the minimum element of the given collection, according to the order induced by the specified comparator. + */ + static min(collection, comparator) { + return collection.sort(comparator)[0]; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + class Token { + constructor(previous) { + this.previous = previous; + } + getPrevious() { + return this.previous; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*final*/ class SimpleToken extends Token { + constructor(previous, value, bitCount) { + super(previous); + this.value = value; + this.bitCount = bitCount; + } + /** + * @Override + */ + appendTo(bitArray, text) { + bitArray.appendBits(this.value, this.bitCount); + } + add(value, bitCount) { + return new SimpleToken(this, value, bitCount); + } + addBinaryShift(start, byteCount) { + // no-op can't binary shift a simple token + console.warn('addBinaryShift on SimpleToken, this simply returns a copy of this token'); + return new SimpleToken(this, start, byteCount); + } + /** + * @Override + */ + toString() { + let value = this.value & ((1 << this.bitCount) - 1); + value |= 1 << this.bitCount; + return '<' + Integer.toBinaryString(value | (1 << this.bitCount)).substring(1) + '>'; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /*final*/ class BinaryShiftToken extends SimpleToken { + constructor(previous, binaryShiftStart, binaryShiftByteCount) { + super(previous, 0, 0); + this.binaryShiftStart = binaryShiftStart; + this.binaryShiftByteCount = binaryShiftByteCount; + } + /** + * @Override + */ + appendTo(bitArray, text) { + for (let i = 0; i < this.binaryShiftByteCount; i++) { + if (i === 0 || (i === 31 && this.binaryShiftByteCount <= 62)) { + // We need a header before the first character, and before + // character 31 when the total byte code is <= 62 + bitArray.appendBits(31, 5); // BINARY_SHIFT + if (this.binaryShiftByteCount > 62) { + bitArray.appendBits(this.binaryShiftByteCount - 31, 16); + } + else if (i === 0) { + // 1 <= binaryShiftByteCode <= 62 + bitArray.appendBits(Math.min(this.binaryShiftByteCount, 31), 5); + } + else { + // 32 <= binaryShiftCount <= 62 and i == 31 + bitArray.appendBits(this.binaryShiftByteCount - 31, 5); + } + } + bitArray.appendBits(text[this.binaryShiftStart + i], 8); + } + } + addBinaryShift(start, byteCount) { + // int bitCount = (byteCount * 8) + (byteCount <= 31 ? 10 : byteCount <= 62 ? 20 : 21); + return new BinaryShiftToken(this, start, byteCount); + } + /** + * @Override + */ + toString() { + return '<' + this.binaryShiftStart + '::' + (this.binaryShiftStart + this.binaryShiftByteCount - 1) + '>'; + } + } + + function addBinaryShift(token, start, byteCount) { + // int bitCount = (byteCount * 8) + (byteCount <= 31 ? 10 : byteCount <= 62 ? 20 : 21); + return new BinaryShiftToken(token, start, byteCount); + } + function add(token, value, bitCount) { + return new SimpleToken(token, value, bitCount); + } + + const /*final*/ MODE_NAMES = [ + 'UPPER', + 'LOWER', + 'DIGIT', + 'MIXED', + 'PUNCT' + ]; + const /*final*/ MODE_UPPER = 0; // 5 bits + const /*final*/ MODE_LOWER = 1; // 5 bits + const /*final*/ MODE_DIGIT = 2; // 4 bits + const /*final*/ MODE_MIXED = 3; // 5 bits + const /*final*/ MODE_PUNCT = 4; // 5 bits + const EMPTY_TOKEN = new SimpleToken(null, 0, 0); + + // The Latch Table shows, for each pair of Modes, the optimal method for + // getting from one mode to another. In the worst possible case, this can + // be up to 14 bits. In the best possible case, we are already there! + // The high half-word of each entry gives the number of bits. + // The low half-word of each entry are the actual bits necessary to change + const LATCH_TABLE = [ + Int32Array.from([ + 0, + (5 << 16) + 28, + (5 << 16) + 30, + (5 << 16) + 29, + (10 << 16) + (29 << 5) + 30 // UPPER -> MIXED -> PUNCT + ]), + Int32Array.from([ + (9 << 16) + (30 << 4) + 14, + 0, + (5 << 16) + 30, + (5 << 16) + 29, + (10 << 16) + (29 << 5) + 30 // LOWER -> MIXED -> PUNCT + ]), + Int32Array.from([ + (4 << 16) + 14, + (9 << 16) + (14 << 5) + 28, + 0, + (9 << 16) + (14 << 5) + 29, + (14 << 16) + (14 << 10) + (29 << 5) + 30 + // DIGIT -> UPPER -> MIXED -> PUNCT + ]), + Int32Array.from([ + (5 << 16) + 29, + (5 << 16) + 28, + (10 << 16) + (29 << 5) + 30, + 0, + (5 << 16) + 30 // MIXED -> PUNCT + ]), + Int32Array.from([ + (5 << 16) + 31, + (10 << 16) + (31 << 5) + 28, + (10 << 16) + (31 << 5) + 30, + (10 << 16) + (31 << 5) + 29, + 0 + ]) + ]; + + function static_SHIFT_TABLE(SHIFT_TABLE) { + for (let table /*Int32Array*/ of SHIFT_TABLE) { + Arrays.fill(table, -1); + } + SHIFT_TABLE[MODE_UPPER][MODE_PUNCT] = 0; + SHIFT_TABLE[MODE_LOWER][MODE_PUNCT] = 0; + SHIFT_TABLE[MODE_LOWER][MODE_UPPER] = 28; + SHIFT_TABLE[MODE_MIXED][MODE_PUNCT] = 0; + SHIFT_TABLE[MODE_DIGIT][MODE_PUNCT] = 0; + SHIFT_TABLE[MODE_DIGIT][MODE_UPPER] = 15; + return SHIFT_TABLE; + } + const /*final*/ SHIFT_TABLE = static_SHIFT_TABLE(Arrays.createInt32Array(6, 6)); // mode shift codes, per table + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * State represents all information about a sequence necessary to generate the current output. + * Note that a state is immutable. + */ + /*final*/ class State { + constructor(token, mode, binaryBytes, bitCount) { + this.token = token; + this.mode = mode; + this.binaryShiftByteCount = binaryBytes; + this.bitCount = bitCount; + // Make sure we match the token + // int binaryShiftBitCount = (binaryShiftByteCount * 8) + + // (binaryShiftByteCount === 0 ? 0 : + // binaryShiftByteCount <= 31 ? 10 : + // binaryShiftByteCount <= 62 ? 20 : 21); + // assert this.bitCount === token.getTotalBitCount() + binaryShiftBitCount; + } + getMode() { + return this.mode; + } + getToken() { + return this.token; + } + getBinaryShiftByteCount() { + return this.binaryShiftByteCount; + } + getBitCount() { + return this.bitCount; + } + // Create a new state representing this state with a latch to a (not + // necessary different) mode, and then a code. + latchAndAppend(mode, value) { + // assert binaryShiftByteCount === 0; + let bitCount = this.bitCount; + let token = this.token; + if (mode !== this.mode) { + let latch = LATCH_TABLE[this.mode][mode]; + token = add(token, latch & 0xffff, latch >> 16); + bitCount += latch >> 16; + } + let latchModeBitCount = mode === MODE_DIGIT ? 4 : 5; + token = add(token, value, latchModeBitCount); + return new State(token, mode, 0, bitCount + latchModeBitCount); + } + // Create a new state representing this state, with a temporary shift + // to a different mode to output a single value. + shiftAndAppend(mode, value) { + // assert binaryShiftByteCount === 0 && this.mode !== mode; + let token = this.token; + let thisModeBitCount = this.mode === MODE_DIGIT ? 4 : 5; + // Shifts exist only to UPPER and PUNCT, both with tokens size 5. + token = add(token, SHIFT_TABLE[this.mode][mode], thisModeBitCount); + token = add(token, value, 5); + return new State(token, this.mode, 0, this.bitCount + thisModeBitCount + 5); + } + // Create a new state representing this state, but an additional character + // output in Binary Shift mode. + addBinaryShiftChar(index) { + let token = this.token; + let mode = this.mode; + let bitCount = this.bitCount; + if (this.mode === MODE_PUNCT || this.mode === MODE_DIGIT) { + // assert binaryShiftByteCount === 0; + let latch = LATCH_TABLE[mode][MODE_UPPER]; + token = add(token, latch & 0xffff, latch >> 16); + bitCount += latch >> 16; + mode = MODE_UPPER; + } + let deltaBitCount = this.binaryShiftByteCount === 0 || this.binaryShiftByteCount === 31 + ? 18 + : this.binaryShiftByteCount === 62 + ? 9 + : 8; + let result = new State(token, mode, this.binaryShiftByteCount + 1, bitCount + deltaBitCount); + if (result.binaryShiftByteCount === 2047 + 31) { + // The string is as long as it's allowed to be. We should end it. + result = result.endBinaryShift(index + 1); + } + return result; + } + // Create the state identical to this one, but we are no longer in + // Binary Shift mode. + endBinaryShift(index) { + if (this.binaryShiftByteCount === 0) { + return this; + } + let token = this.token; + token = addBinaryShift(token, index - this.binaryShiftByteCount, this.binaryShiftByteCount); + // assert token.getTotalBitCount() === this.bitCount; + return new State(token, this.mode, 0, this.bitCount); + } + // Returns true if "this" state is better (equal: or) to be in than "that" + // state under all possible circumstances. + isBetterThanOrEqualTo(other) { + let newModeBitCount = this.bitCount + (LATCH_TABLE[this.mode][other.mode] >> 16); + if (this.binaryShiftByteCount < other.binaryShiftByteCount) { + // add additional B/S encoding cost of other, if any + newModeBitCount += + State.calculateBinaryShiftCost(other) - + State.calculateBinaryShiftCost(this); + } + else if (this.binaryShiftByteCount > other.binaryShiftByteCount && + other.binaryShiftByteCount > 0) { + // maximum possible additional cost (it: h) + newModeBitCount += 10; + } + return newModeBitCount <= other.bitCount; + } + toBitArray(text) { + // Reverse the tokens, so that they are in the order that they should + // be output + let symbols = []; + for (let token = this.endBinaryShift(text.length).token; token !== null; token = token.getPrevious()) { + symbols.unshift(token); + } + let bitArray = new BitArray(); + // Add each token to the result. + for (const symbol of symbols) { + symbol.appendTo(bitArray, text); + } + // assert bitArray.getSize() === this.bitCount; + return bitArray; + } + /** + * @Override + */ + toString() { + return StringUtils.format('%s bits=%d bytes=%d', MODE_NAMES[this.mode], this.bitCount, this.binaryShiftByteCount); + } + static calculateBinaryShiftCost(state) { + if (state.binaryShiftByteCount > 62) { + return 21; // B/S with extended length + } + if (state.binaryShiftByteCount > 31) { + return 20; // two B/S + } + if (state.binaryShiftByteCount > 0) { + return 10; // one B/S + } + return 0; + } + } + State.INITIAL_STATE = new State(EMPTY_TOKEN, MODE_UPPER, 0, 0); + + function static_CHAR_MAP(CHAR_MAP) { + const spaceCharCode = StringUtils.getCharCode(' '); + const pointCharCode = StringUtils.getCharCode('.'); + const commaCharCode = StringUtils.getCharCode(','); + CHAR_MAP[MODE_UPPER][spaceCharCode] = 1; + const zUpperCharCode = StringUtils.getCharCode('Z'); + const aUpperCharCode = StringUtils.getCharCode('A'); + for (let c = aUpperCharCode; c <= zUpperCharCode; c++) { + CHAR_MAP[MODE_UPPER][c] = c - aUpperCharCode + 2; + } + CHAR_MAP[MODE_LOWER][spaceCharCode] = 1; + const zLowerCharCode = StringUtils.getCharCode('z'); + const aLowerCharCode = StringUtils.getCharCode('a'); + for (let c = aLowerCharCode; c <= zLowerCharCode; c++) { + CHAR_MAP[MODE_LOWER][c] = c - aLowerCharCode + 2; + } + CHAR_MAP[MODE_DIGIT][spaceCharCode] = 1; + const nineCharCode = StringUtils.getCharCode('9'); + const zeroCharCode = StringUtils.getCharCode('0'); + for (let c = zeroCharCode; c <= nineCharCode; c++) { + CHAR_MAP[MODE_DIGIT][c] = c - zeroCharCode + 2; + } + CHAR_MAP[MODE_DIGIT][commaCharCode] = 12; + CHAR_MAP[MODE_DIGIT][pointCharCode] = 13; + const mixedTable = [ + '\x00', + ' ', + '\x01', + '\x02', + '\x03', + '\x04', + '\x05', + '\x06', + '\x07', + '\b', + '\t', + '\n', + '\x0b', + '\f', + '\r', + '\x1b', + '\x1c', + '\x1d', + '\x1e', + '\x1f', + '@', + '\\', + '^', + '_', + '`', + '|', + '~', + '\x7f' + ]; + for (let i = 0; i < mixedTable.length; i++) { + CHAR_MAP[MODE_MIXED][StringUtils.getCharCode(mixedTable[i])] = i; + } + const punctTable = [ + '\x00', + '\r', + '\x00', + '\x00', + '\x00', + '\x00', + '!', + '\'', + '#', + '$', + '%', + '&', + '\'', + '(', + ')', + '*', + '+', + ',', + '-', + '.', + '/', + ':', + ';', + '<', + '=', + '>', + '?', + '[', + ']', + '{', + '}' + ]; + for (let i = 0; i < punctTable.length; i++) { + if (StringUtils.getCharCode(punctTable[i]) > 0) { + CHAR_MAP[MODE_PUNCT][StringUtils.getCharCode(punctTable[i])] = i; + } + } + return CHAR_MAP; + } + const CHAR_MAP = static_CHAR_MAP(Arrays.createInt32Array(5, 256)); + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * This produces nearly optimal encodings of text into the first-level of + * encoding used by Aztec code. + * + * It uses a dynamic algorithm. For each prefix of the string, it determines + * a set of encodings that could lead to this prefix. We repeatedly add a + * character and generate a new set of optimal encodings until we have read + * through the entire input. + * + * @author Frank Yellin + * @author Rustam Abdullaev + */ + /*public final*/ class HighLevelEncoder { + constructor(text) { + this.text = text; + } + /** + * @return text represented by this encoder encoded as a {@link BitArray} + */ + encode() { + const spaceCharCode = StringUtils.getCharCode(' '); + const lineBreakCharCode = StringUtils.getCharCode('\n'); + let states = Collections.singletonList(State.INITIAL_STATE); + for (let index = 0; index < this.text.length; index++) { + let pairCode; + let nextChar = index + 1 < this.text.length ? this.text[index + 1] : 0; + switch (this.text[index]) { + case StringUtils.getCharCode('\r'): + pairCode = nextChar === lineBreakCharCode ? 2 : 0; + break; + case StringUtils.getCharCode('.'): + pairCode = nextChar === spaceCharCode ? 3 : 0; + break; + case StringUtils.getCharCode(','): + pairCode = nextChar === spaceCharCode ? 4 : 0; + break; + case StringUtils.getCharCode(':'): + pairCode = nextChar === spaceCharCode ? 5 : 0; + break; + default: + pairCode = 0; + } + if (pairCode > 0) { + // We have one of the four special PUNCT pairs. Treat them specially. + // Get a new set of states for the two new characters. + states = HighLevelEncoder.updateStateListForPair(states, index, pairCode); + index++; + } + else { + // Get a new set of states for the new character. + states = this.updateStateListForChar(states, index); + } + } + // We are left with a set of states. Find the shortest one. + const minState = Collections.min(states, (a, b) => { + return a.getBitCount() - b.getBitCount(); + }); + // Convert it to a bit array, and return. + return minState.toBitArray(this.text); + } + // We update a set of states for a new character by updating each state + // for the new character, merging the results, and then removing the + // non-optimal states. + updateStateListForChar(states, index) { + const result = []; + for (let state /*State*/ of states) { + this.updateStateForChar(state, index, result); + } + return HighLevelEncoder.simplifyStates(result); + } + // Return a set of states that represent the possible ways of updating this + // state for the next character. The resulting set of states are added to + // the "result" list. + updateStateForChar(state, index, result) { + let ch = (this.text[index] & 0xff); + let charInCurrentTable = CHAR_MAP[state.getMode()][ch] > 0; + let stateNoBinary = null; + for (let mode /*int*/ = 0; mode <= MODE_PUNCT; mode++) { + let charInMode = CHAR_MAP[mode][ch]; + if (charInMode > 0) { + if (stateNoBinary == null) { + // Only create stateNoBinary the first time it's required. + stateNoBinary = state.endBinaryShift(index); + } + // Try generating the character by latching to its mode + if (!charInCurrentTable || + mode === state.getMode() || + mode === MODE_DIGIT) { + // If the character is in the current table, we don't want to latch to + // any other mode except possibly digit (which uses only 4 bits). Any + // other latch would be equally successful *after* this character, and + // so wouldn't save any bits. + const latchState = stateNoBinary.latchAndAppend(mode, charInMode); + result.push(latchState); + } + // Try generating the character by switching to its mode. + if (!charInCurrentTable && + SHIFT_TABLE[state.getMode()][mode] >= 0) { + // It never makes sense to temporarily shift to another mode if the + // character exists in the current mode. That can never save bits. + const shiftState = stateNoBinary.shiftAndAppend(mode, charInMode); + result.push(shiftState); + } + } + } + if (state.getBinaryShiftByteCount() > 0 || + CHAR_MAP[state.getMode()][ch] === 0) { + // It's never worthwhile to go into binary shift mode if you're not already + // in binary shift mode, and the character exists in your current mode. + // That can never save bits over just outputting the char in the current mode. + let binaryState = state.addBinaryShiftChar(index); + result.push(binaryState); + } + } + static updateStateListForPair(states, index, pairCode) { + const result = []; + for (let state /*State*/ of states) { + this.updateStateForPair(state, index, pairCode, result); + } + return this.simplifyStates(result); + } + static updateStateForPair(state, index, pairCode, result) { + let stateNoBinary = state.endBinaryShift(index); + // Possibility 1. Latch to C.MODE_PUNCT, and then append this code + result.push(stateNoBinary.latchAndAppend(MODE_PUNCT, pairCode)); + if (state.getMode() !== MODE_PUNCT) { + // Possibility 2. Shift to C.MODE_PUNCT, and then append this code. + // Every state except C.MODE_PUNCT (handled above) can shift + result.push(stateNoBinary.shiftAndAppend(MODE_PUNCT, pairCode)); + } + if (pairCode === 3 || pairCode === 4) { + // both characters are in DIGITS. Sometimes better to just add two digits + let digitState = stateNoBinary + .latchAndAppend(MODE_DIGIT, 16 - pairCode) // period or comma in DIGIT + .latchAndAppend(MODE_DIGIT, 1); // space in DIGIT + result.push(digitState); + } + if (state.getBinaryShiftByteCount() > 0) { + // It only makes sense to do the characters as binary if we're already + // in binary mode. + let binaryState = state + .addBinaryShiftChar(index) + .addBinaryShiftChar(index + 1); + result.push(binaryState); + } + } + static simplifyStates(states) { + let result = []; + for (const newState of states) { + let add = true; + for (const oldState of result) { + if (oldState.isBetterThanOrEqualTo(newState)) { + add = false; + break; + } + if (newState.isBetterThanOrEqualTo(oldState)) { + // iterator.remove(); + result = result.filter(x => x !== oldState); // remove old state + } + } + if (add) { + result.push(newState); + } + } + return result; + } + } + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + // package com.google.zxing.aztec.encoder; + // import com.google.zxing.common.BitArray; + // import com.google.zxing.common.BitMatrix; + // import com.google.zxing.common.reedsolomon.GenericGF; + // import com.google.zxing.common.reedsolomon.ReedSolomonEncoder; + /** + * Generates Aztec 2D barcodes. + * + * @author Rustam Abdullaev + */ + /*public final*/ class Encoder$1 { + constructor() { + } + /** + * Encodes the given binary content as an Aztec symbol + * + * @param data input data string + * @return Aztec symbol matrix with metadata + */ + static encodeBytes(data) { + return Encoder$1.encode(data, Encoder$1.DEFAULT_EC_PERCENT, Encoder$1.DEFAULT_AZTEC_LAYERS); + } + /** + * Encodes the given binary content as an Aztec symbol + * + * @param data input data string + * @param minECCPercent minimal percentage of error check words (According to ISO/IEC 24778:2008, + * a minimum of 23% + 3 words is recommended) + * @param userSpecifiedLayers if non-zero, a user-specified value for the number of layers + * @return Aztec symbol matrix with metadata + */ + static encode(data, minECCPercent, userSpecifiedLayers) { + // High-level encode + let bits = new HighLevelEncoder(data).encode(); + // stuff bits and choose symbol size + let eccBits = Integer.truncDivision((bits.getSize() * minECCPercent), 100) + 11; + let totalSizeBits = bits.getSize() + eccBits; + let compact; + let layers; + let totalBitsInLayer; + let wordSize; + let stuffedBits; + if (userSpecifiedLayers !== Encoder$1.DEFAULT_AZTEC_LAYERS) { + compact = userSpecifiedLayers < 0; + layers = Math.abs(userSpecifiedLayers); + if (layers > (compact ? Encoder$1.MAX_NB_BITS_COMPACT : Encoder$1.MAX_NB_BITS)) { + throw new IllegalArgumentException(StringUtils.format('Illegal value %s for layers', userSpecifiedLayers)); + } + totalBitsInLayer = Encoder$1.totalBitsInLayer(layers, compact); + wordSize = Encoder$1.WORD_SIZE[layers]; + let usableBitsInLayers = totalBitsInLayer - (totalBitsInLayer % wordSize); + stuffedBits = Encoder$1.stuffBits(bits, wordSize); + if (stuffedBits.getSize() + eccBits > usableBitsInLayers) { + throw new IllegalArgumentException('Data to large for user specified layer'); + } + if (compact && stuffedBits.getSize() > wordSize * 64) { + // Compact format only allows 64 data words, though C4 can hold more words than that + throw new IllegalArgumentException('Data to large for user specified layer'); + } + } + else { + wordSize = 0; + stuffedBits = null; + // We look at the possible table sizes in the order Compact1, Compact2, Compact3, + // Compact4, Normal4,... Normal(i) for i < 4 isn't typically used since Compact(i+1) + // is the same size, but has more data. + for (let i /*int*/ = 0;; i++) { + if (i > Encoder$1.MAX_NB_BITS) { + throw new IllegalArgumentException('Data too large for an Aztec code'); + } + compact = i <= 3; + layers = compact ? i + 1 : i; + totalBitsInLayer = Encoder$1.totalBitsInLayer(layers, compact); + if (totalSizeBits > totalBitsInLayer) { + continue; + } + // [Re]stuff the bits if this is the first opportunity, or if the + // wordSize has changed + if (stuffedBits == null || wordSize !== Encoder$1.WORD_SIZE[layers]) { + wordSize = Encoder$1.WORD_SIZE[layers]; + stuffedBits = Encoder$1.stuffBits(bits, wordSize); + } + let usableBitsInLayers = totalBitsInLayer - (totalBitsInLayer % wordSize); + if (compact && stuffedBits.getSize() > wordSize * 64) { + // Compact format only allows 64 data words, though C4 can hold more words than that + continue; + } + if (stuffedBits.getSize() + eccBits <= usableBitsInLayers) { + break; + } + } + } + let messageBits = Encoder$1.generateCheckWords(stuffedBits, totalBitsInLayer, wordSize); + // generate mode message + let messageSizeInWords = stuffedBits.getSize() / wordSize; + let modeMessage = Encoder$1.generateModeMessage(compact, layers, messageSizeInWords); + // allocate symbol + let baseMatrixSize = (compact ? 11 : 14) + layers * 4; // not including alignment lines + let alignmentMap = new Int32Array(baseMatrixSize); + let matrixSize; + if (compact) { + // no alignment marks in compact mode, alignmentMap is a no-op + matrixSize = baseMatrixSize; + for (let i /*int*/ = 0; i < alignmentMap.length; i++) { + alignmentMap[i] = i; + } + } + else { + matrixSize = baseMatrixSize + 1 + 2 * Integer.truncDivision((Integer.truncDivision(baseMatrixSize, 2) - 1), 15); + let origCenter = Integer.truncDivision(baseMatrixSize, 2); + let center = Integer.truncDivision(matrixSize, 2); + for (let i /*int*/ = 0; i < origCenter; i++) { + let newOffset = i + Integer.truncDivision(i, 15); + alignmentMap[origCenter - i - 1] = center - newOffset - 1; + alignmentMap[origCenter + i] = center + newOffset + 1; + } + } + let matrix = new BitMatrix(matrixSize); + // draw data bits + for (let i /*int*/ = 0, rowOffset = 0; i < layers; i++) { + let rowSize = (layers - i) * 4 + (compact ? 9 : 12); + for (let j /*int*/ = 0; j < rowSize; j++) { + let columnOffset = j * 2; + for (let k /*int*/ = 0; k < 2; k++) { + if (messageBits.get(rowOffset + columnOffset + k)) { + matrix.set(alignmentMap[i * 2 + k], alignmentMap[i * 2 + j]); + } + if (messageBits.get(rowOffset + rowSize * 2 + columnOffset + k)) { + matrix.set(alignmentMap[i * 2 + j], alignmentMap[baseMatrixSize - 1 - i * 2 - k]); + } + if (messageBits.get(rowOffset + rowSize * 4 + columnOffset + k)) { + matrix.set(alignmentMap[baseMatrixSize - 1 - i * 2 - k], alignmentMap[baseMatrixSize - 1 - i * 2 - j]); + } + if (messageBits.get(rowOffset + rowSize * 6 + columnOffset + k)) { + matrix.set(alignmentMap[baseMatrixSize - 1 - i * 2 - j], alignmentMap[i * 2 + k]); + } + } + } + rowOffset += rowSize * 8; + } + // draw mode message + Encoder$1.drawModeMessage(matrix, compact, matrixSize, modeMessage); + // draw alignment marks + if (compact) { + Encoder$1.drawBullsEye(matrix, Integer.truncDivision(matrixSize, 2), 5); + } + else { + Encoder$1.drawBullsEye(matrix, Integer.truncDivision(matrixSize, 2), 7); + for (let i /*int*/ = 0, j = 0; i < Integer.truncDivision(baseMatrixSize, 2) - 1; i += 15, j += 16) { + for (let k /*int*/ = Integer.truncDivision(matrixSize, 2) & 1; k < matrixSize; k += 2) { + matrix.set(Integer.truncDivision(matrixSize, 2) - j, k); + matrix.set(Integer.truncDivision(matrixSize, 2) + j, k); + matrix.set(k, Integer.truncDivision(matrixSize, 2) - j); + matrix.set(k, Integer.truncDivision(matrixSize, 2) + j); + } + } + } + let aztec = new AztecCode(); + aztec.setCompact(compact); + aztec.setSize(matrixSize); + aztec.setLayers(layers); + aztec.setCodeWords(messageSizeInWords); + aztec.setMatrix(matrix); + return aztec; + } + static drawBullsEye(matrix, center, size) { + for (let i /*int*/ = 0; i < size; i += 2) { + for (let j /*int*/ = center - i; j <= center + i; j++) { + matrix.set(j, center - i); + matrix.set(j, center + i); + matrix.set(center - i, j); + matrix.set(center + i, j); + } + } + matrix.set(center - size, center - size); + matrix.set(center - size + 1, center - size); + matrix.set(center - size, center - size + 1); + matrix.set(center + size, center - size); + matrix.set(center + size, center - size + 1); + matrix.set(center + size, center + size - 1); + } + static generateModeMessage(compact, layers, messageSizeInWords) { + let modeMessage = new BitArray(); + if (compact) { + modeMessage.appendBits(layers - 1, 2); + modeMessage.appendBits(messageSizeInWords - 1, 6); + modeMessage = Encoder$1.generateCheckWords(modeMessage, 28, 4); + } + else { + modeMessage.appendBits(layers - 1, 5); + modeMessage.appendBits(messageSizeInWords - 1, 11); + modeMessage = Encoder$1.generateCheckWords(modeMessage, 40, 4); + } + return modeMessage; + } + static drawModeMessage(matrix, compact, matrixSize, modeMessage) { + let center = Integer.truncDivision(matrixSize, 2); + if (compact) { + for (let i /*int*/ = 0; i < 7; i++) { + let offset = center - 3 + i; + if (modeMessage.get(i)) { + matrix.set(offset, center - 5); + } + if (modeMessage.get(i + 7)) { + matrix.set(center + 5, offset); + } + if (modeMessage.get(20 - i)) { + matrix.set(offset, center + 5); + } + if (modeMessage.get(27 - i)) { + matrix.set(center - 5, offset); + } + } + } + else { + for (let i /*int*/ = 0; i < 10; i++) { + let offset = center - 5 + i + Integer.truncDivision(i, 5); + if (modeMessage.get(i)) { + matrix.set(offset, center - 7); + } + if (modeMessage.get(i + 10)) { + matrix.set(center + 7, offset); + } + if (modeMessage.get(29 - i)) { + matrix.set(offset, center + 7); + } + if (modeMessage.get(39 - i)) { + matrix.set(center - 7, offset); + } + } + } + } + static generateCheckWords(bitArray, totalBits, wordSize) { + // bitArray is guaranteed to be a multiple of the wordSize, so no padding needed + let messageSizeInWords = bitArray.getSize() / wordSize; + let rs = new ReedSolomonEncoder(Encoder$1.getGF(wordSize)); + let totalWords = Integer.truncDivision(totalBits, wordSize); + let messageWords = Encoder$1.bitsToWords(bitArray, wordSize, totalWords); + rs.encode(messageWords, totalWords - messageSizeInWords); + let startPad = totalBits % wordSize; + let messageBits = new BitArray(); + messageBits.appendBits(0, startPad); + for (const messageWord /*: int*/ of Array.from(messageWords)) { + messageBits.appendBits(messageWord, wordSize); + } + return messageBits; + } + static bitsToWords(stuffedBits, wordSize, totalWords) { + let message = new Int32Array(totalWords); + let i; + let n; + for (i = 0, n = stuffedBits.getSize() / wordSize; i < n; i++) { + let value = 0; + for (let j /*int*/ = 0; j < wordSize; j++) { + value |= stuffedBits.get(i * wordSize + j) ? (1 << wordSize - j - 1) : 0; + } + message[i] = value; + } + return message; + } + static getGF(wordSize) { + switch (wordSize) { + case 4: + return GenericGF.AZTEC_PARAM; + case 6: + return GenericGF.AZTEC_DATA_6; + case 8: + return GenericGF.AZTEC_DATA_8; + case 10: + return GenericGF.AZTEC_DATA_10; + case 12: + return GenericGF.AZTEC_DATA_12; + default: + throw new IllegalArgumentException('Unsupported word size ' + wordSize); + } + } + static stuffBits(bits, wordSize) { + let out = new BitArray(); + let n = bits.getSize(); + let mask = (1 << wordSize) - 2; + for (let i /*int*/ = 0; i < n; i += wordSize) { + let word = 0; + for (let j /*int*/ = 0; j < wordSize; j++) { + if (i + j >= n || bits.get(i + j)) { + word |= 1 << (wordSize - 1 - j); + } + } + if ((word & mask) === mask) { + out.appendBits(word & mask, wordSize); + i--; + } + else if ((word & mask) === 0) { + out.appendBits(word | 1, wordSize); + i--; + } + else { + out.appendBits(word, wordSize); + } + } + return out; + } + static totalBitsInLayer(layers, compact) { + return ((compact ? 88 : 112) + 16 * layers) * layers; + } + } + Encoder$1.DEFAULT_EC_PERCENT = 33; // default minimal percentage of error check words + Encoder$1.DEFAULT_AZTEC_LAYERS = 0; + Encoder$1.MAX_NB_BITS = 32; + Encoder$1.MAX_NB_BITS_COMPACT = 4; + Encoder$1.WORD_SIZE = Int32Array.from([ + 4, 6, 6, 8, 8, 8, 8, 8, 8, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, + 12, 12, 12, 12, 12, 12, 12, 12, 12, 12 + ]); + + /* + * Copyright 2013 ZXing authors + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + /** + * Renders an Aztec code as a {@link BitMatrix}. + */ + /*public final*/ class AztecWriter { + // @Override + encode(contents, format, width, height) { + return this.encodeWithHints(contents, format, width, height, null); + } + // @Override + encodeWithHints(contents, format, width, height, hints) { + let charset = StandardCharsets.ISO_8859_1; + let eccPercent = Encoder$1.DEFAULT_EC_PERCENT; + let layers = Encoder$1.DEFAULT_AZTEC_LAYERS; + if (hints != null) { + if (hints.has(EncodeHintType$1.CHARACTER_SET)) { + charset = Charset.forName(hints.get(EncodeHintType$1.CHARACTER_SET).toString()); + } + if (hints.has(EncodeHintType$1.ERROR_CORRECTION)) { + eccPercent = Integer.parseInt(hints.get(EncodeHintType$1.ERROR_CORRECTION).toString()); + } + if (hints.has(EncodeHintType$1.AZTEC_LAYERS)) { + layers = Integer.parseInt(hints.get(EncodeHintType$1.AZTEC_LAYERS).toString()); + } + } + return AztecWriter.encodeLayers(contents, format, width, height, charset, eccPercent, layers); + } + static encodeLayers(contents, format, width, height, charset, eccPercent, layers) { + if (format !== BarcodeFormat$1.AZTEC) { + throw new IllegalArgumentException('Can only encode AZTEC, but got ' + format); + } + let aztec = Encoder$1.encode(StringUtils.getBytes(contents, charset), eccPercent, layers); + return AztecWriter.renderResult(aztec, width, height); + } + static renderResult(code, width, height) { + let input = code.getMatrix(); + if (input == null) { + throw new IllegalStateException(); + } + let inputWidth = input.getWidth(); + let inputHeight = input.getHeight(); + let outputWidth = Math.max(width, inputWidth); + let outputHeight = Math.max(height, inputHeight); + let multiple = Math.min(outputWidth / inputWidth, outputHeight / inputHeight); + let leftPadding = (outputWidth - (inputWidth * multiple)) / 2; + let topPadding = (outputHeight - (inputHeight * multiple)) / 2; + let output = new BitMatrix(outputWidth, outputHeight); + for (let inputY /*int*/ = 0, outputY = topPadding; inputY < inputHeight; inputY++, outputY += multiple) { + // Write the contents of this row of the barcode + for (let inputX /*int*/ = 0, outputX = leftPadding; inputX < inputWidth; inputX++, outputX += multiple) { + if (input.get(inputX, inputY)) { + output.setRegion(outputX, outputY, multiple, multiple); + } + } + } + return output; + } + } + + exports.AbstractExpandedDecoder = AbstractExpandedDecoder; + exports.ArgumentException = ArgumentException; + exports.ArithmeticException = ArithmeticException; + exports.AztecCode = AztecCode; + exports.AztecCodeReader = AztecReader; + exports.AztecCodeWriter = AztecWriter; + exports.AztecDecoder = Decoder; + exports.AztecDetector = Detector; + exports.AztecDetectorResult = AztecDetectorResult; + exports.AztecEncoder = Encoder$1; + exports.AztecHighLevelEncoder = HighLevelEncoder; + exports.AztecPoint = Point; + exports.BarcodeFormat = BarcodeFormat$1; + exports.Binarizer = Binarizer; + exports.BinaryBitmap = BinaryBitmap; + exports.BitArray = BitArray; + exports.BitMatrix = BitMatrix; + exports.BitSource = BitSource; + exports.BrowserAztecCodeReader = BrowserAztecCodeReader; + exports.BrowserBarcodeReader = BrowserBarcodeReader; + exports.BrowserCodeReader = BrowserCodeReader; + exports.BrowserDatamatrixCodeReader = BrowserDatamatrixCodeReader; + exports.BrowserMultiFormatReader = BrowserMultiFormatReader; + exports.BrowserPDF417Reader = BrowserPDF417Reader; + exports.BrowserQRCodeReader = BrowserQRCodeReader; + exports.BrowserQRCodeSvgWriter = BrowserQRCodeSvgWriter; + exports.CharacterSetECI = CharacterSetECI; + exports.ChecksumException = ChecksumException; + exports.Code128Reader = Code128Reader; + exports.Code39Reader = Code39Reader; + exports.DataMatrixDecodedBitStreamParser = DecodedBitStreamParser; + exports.DataMatrixReader = DataMatrixReader; + exports.DecodeHintType = DecodeHintType$1; + exports.DecoderResult = DecoderResult; + exports.DefaultGridSampler = DefaultGridSampler; + exports.DetectorResult = DetectorResult; + exports.EAN13Reader = EAN13Reader; + exports.EncodeHintType = EncodeHintType$1; + exports.Exception = Exception; + exports.FormatException = FormatException; + exports.GenericGF = GenericGF; + exports.GenericGFPoly = GenericGFPoly; + exports.GlobalHistogramBinarizer = GlobalHistogramBinarizer; + exports.GridSampler = GridSampler; + exports.GridSamplerInstance = GridSamplerInstance; + exports.HTMLCanvasElementLuminanceSource = HTMLCanvasElementLuminanceSource; + exports.HybridBinarizer = HybridBinarizer; + exports.ITFReader = ITFReader; + exports.IllegalArgumentException = IllegalArgumentException; + exports.IllegalStateException = IllegalStateException; + exports.InvertedLuminanceSource = InvertedLuminanceSource; + exports.LuminanceSource = LuminanceSource; + exports.MathUtils = MathUtils; + exports.MultiFormatOneDReader = MultiFormatOneDReader; + exports.MultiFormatReader = MultiFormatReader; + exports.MultiFormatWriter = MultiFormatWriter; + exports.NotFoundException = NotFoundException; + exports.OneDReader = OneDReader; + exports.PDF417DecodedBitStreamParser = DecodedBitStreamParser$2; + exports.PDF417DecoderErrorCorrection = ErrorCorrection; + exports.PDF417Reader = PDF417Reader; + exports.PDF417ResultMetadata = PDF417ResultMetadata; + exports.PerspectiveTransform = PerspectiveTransform; + exports.PlanarYUVLuminanceSource = PlanarYUVLuminanceSource; + exports.QRCodeByteMatrix = ByteMatrix; + exports.QRCodeDataMask = DataMask; + exports.QRCodeDecodedBitStreamParser = DecodedBitStreamParser$1; + exports.QRCodeDecoderErrorCorrectionLevel = ErrorCorrectionLevel; + exports.QRCodeDecoderFormatInformation = FormatInformation; + exports.QRCodeEncoder = Encoder; + exports.QRCodeEncoderQRCode = QRCode; + exports.QRCodeMaskUtil = MaskUtil; + exports.QRCodeMatrixUtil = MatrixUtil; + exports.QRCodeMode = Mode$1; + exports.QRCodeReader = QRCodeReader; + exports.QRCodeVersion = Version$1; + exports.QRCodeWriter = QRCodeWriter; + exports.RGBLuminanceSource = RGBLuminanceSource; + exports.RSS14Reader = RSS14Reader; + exports.RSSExpandedReader = RSSExpandedReader; + exports.ReaderException = ReaderException; + exports.ReedSolomonDecoder = ReedSolomonDecoder; + exports.ReedSolomonEncoder = ReedSolomonEncoder; + exports.ReedSolomonException = ReedSolomonException; + exports.Result = Result; + exports.ResultMetadataType = ResultMetadataType$1; + exports.ResultPoint = ResultPoint; + exports.StringUtils = StringUtils; + exports.UnsupportedOperationException = UnsupportedOperationException; + exports.VideoInputDevice = VideoInputDevice; + exports.WhiteRectangleDetector = WhiteRectangleDetector; + exports.WriterException = WriterException; + exports.ZXingArrays = Arrays; + exports.ZXingCharset = Charset; + exports.ZXingInteger = Integer; + exports.ZXingStandardCharsets = StandardCharsets; + exports.ZXingStringBuilder = StringBuilder; + exports.ZXingStringEncoding = StringEncoding; + exports.ZXingSystem = System; + exports.createAbstractExpandedDecoder = createDecoder; + + Object.defineProperty(exports, '__esModule', { value: true }); + +}))); diff --git a/pos_receipt_extend/static/src/xml/OrderReceipt.xml b/pos_receipt_extend/static/src/xml/OrderReceipt.xml new file mode 100755 index 000000000..b3c9673ff --- /dev/null +++ b/pos_receipt_extend/static/src/xml/OrderReceipt.xml @@ -0,0 +1,42 @@ + + + + + + + + Name: +
+ + + Address: +
+ + + Mobile: +
+ + + Phone: +
+ + + Email: +
+ + + Invoice no: +
+ + + VAT no: +
+ + +
+ +
+ + + diff --git a/pos_receipt_extend/views/assets.xml b/pos_receipt_extend/views/assets.xml new file mode 100644 index 000000000..6f3bdeb46 --- /dev/null +++ b/pos_receipt_extend/views/assets.xml @@ -0,0 +1,10 @@ + + +