/* * QRious v4.0.2 * Copyright (C) 2017 Alasdair Mercer * Copyright (C) 2010 Tom Zerucha * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ (function (global, factory) { typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() : typeof define === 'function' && define.amd ? define(factory) : (global.QRious = factory()); }(this, (function () { 'use strict'; /* * Copyright (C) 2017 Alasdair Mercer, !ninja * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ /** * A bare-bones constructor for surrogate prototype swapping. * * @private * @constructor */ var Constructor = /* istanbul ignore next */ function() {}; /** * A reference to Object.prototype.hasOwnProperty. * * @private * @type {Function} */ var hasOwnProperty = Object.prototype.hasOwnProperty; /** * A reference to Array.prototype.slice. * * @private * @type {Function} */ var slice = Array.prototype.slice; /** * Creates an object which inherits the given prototype. * * Optionally, the created object can be extended further with the specified properties. * * @param {Object} prototype - the prototype to be inherited by the created object * @param {Object} [properties] - the optional properties to be extended by the created object * @return {Object} The newly created object. * @private */ function createObject(prototype, properties) { var result; /* istanbul ignore next */ if (typeof Object.create === 'function') { result = Object.create(prototype); } else { Constructor.prototype = prototype; result = new Constructor(); Constructor.prototype = null; } if (properties) { extendObject(true, result, properties); } return result; } /** * Extends the constructor to which this method is associated with the prototype and/or * statics provided. * * If name is provided, it will be used as the class name and can be accessed via a special * class_ property on the child constructor, otherwise the class name of the super constructor will be used * instead. The class name may also be used string representation for instances of the child constructor (via * toString), but this is not applicable to the lite version of Nevis. * * If constructor is provided, it will be used as the constructor for the child, otherwise a simple * constructor which only calls the super constructor will be used instead. * * The super constructor can be accessed via a special super_ property on the child constructor. * * @param {string} [name=this.class_] - the class name to be used for the child constructor * @param {Function} [constructor] - the constructor for the child * @param {Object} [prototype] - the prototype properties to be defined for the child * @param {Object} [statics] - the static properties to be defined for the child * @return {Function} The child constructor provided or the one created if none was given. * @public */ function extend(name, constructor, prototype, statics) { var superConstructor = this; if (typeof name !== 'string') { statics = prototype; prototype = constructor; constructor = name; name = null; } if (typeof constructor !== 'function') { statics = prototype; prototype = constructor; constructor = function() { return superConstructor.apply(this, arguments); }; } extendObject(false, constructor, superConstructor, statics); constructor.prototype = createObject(superConstructor.prototype, prototype); constructor.prototype.constructor = constructor; constructor.class_ = name || superConstructor.class_; constructor.super_ = superConstructor; return constructor; } /** * Extends the specified target object with the properties in each of the sources provided. * * if any source is null it will be ignored. * * @param {boolean} own - true to only copy own properties from sources onto * target; otherwise false * @param {Object} target - the target object which should be extended * @param {...Object} [sources] - the source objects whose properties are to be copied onto target * @return {void} * @private */ function extendObject(own, target, sources) { sources = slice.call(arguments, 2); var property; var source; for (var i = 0, length = sources.length; i < length; i++) { source = sources[i]; for (property in source) { if (!own || hasOwnProperty.call(source, property)) { target[property] = source[property]; } } } } var extend_1 = extend; /** * The base class from which all others should extend. * * @public * @constructor */ function Nevis() {} Nevis.class_ = 'Nevis'; Nevis.super_ = Object; /** * Extends the constructor to which this method is associated with the prototype and/or * statics provided. * * If name is provided, it will be used as the class name and can be accessed via a special * class_ property on the child constructor, otherwise the class name of the super constructor will be used * instead. The class name may also be used string representation for instances of the child constructor (via * toString), but this is not applicable to the lite version of Nevis. * * If constructor is provided, it will be used as the constructor for the child, otherwise a simple * constructor which only calls the super constructor will be used instead. * * The super constructor can be accessed via a special super_ property on the child constructor. * * @param {string} [name=this.class_] - the class name to be used for the child constructor * @param {Function} [constructor] - the constructor for the child * @param {Object} [prototype] - the prototype properties to be defined for the child * @param {Object} [statics] - the static properties to be defined for the child * @return {Function} The child constructor provided or the one created if none was given. * @public * @static * @memberof Nevis */ Nevis.extend = extend_1; var nevis = Nevis; var lite = nevis; /** * Responsible for rendering a QR code {@link Frame} on a specific type of element. * * A renderer may be dependant on the rendering of another element, so the ordering of their execution is important. * * The rendering of a element can be deferred by disabling the renderer initially, however, any attempt get the element * from the renderer will result in it being immediately enabled and the element being rendered. * * @param {QRious} qrious - the {@link QRious} instance to be used * @param {*} element - the element onto which the QR code is to be rendered * @param {boolean} [enabled] - true this {@link Renderer} is enabled; otherwise false. * @public * @class * @extends Nevis */ var Renderer = lite.extend(function(qrious, element, enabled) { /** * The {@link QRious} instance. * * @protected * @type {QRious} * @memberof Renderer# */ this.qrious = qrious; /** * The element onto which this {@link Renderer} is rendering the QR code. * * @protected * @type {*} * @memberof Renderer# */ this.element = element; this.element.qrious = qrious; /** * Whether this {@link Renderer} is enabled. * * @protected * @type {boolean} * @memberof Renderer# */ this.enabled = Boolean(enabled); }, { /** * Draws the specified QR code frame on the underlying element. * * Implementations of {@link Renderer} must override this method with their own specific logic. * * @param {Frame} frame - the {@link Frame} to be drawn * @return {void} * @protected * @abstract * @memberof Renderer# */ draw: function(frame) {}, /** * Returns the element onto which this {@link Renderer} is rendering the QR code. * * If this method is called while this {@link Renderer} is disabled, it will be immediately enabled and rendered * before the element is returned. * * @return {*} The element. * @public * @memberof Renderer# */ getElement: function() { if (!this.enabled) { this.enabled = true; this.render(); } return this.element; }, /** * Calculates the size (in pixel units) to represent an individual module within the QR code based on the * frame provided. * * Any configured padding will be excluded from the returned size. * * The returned value will be at least one, even in cases where the size of the QR code does not fit its contents. * This is done so that the inevitable clipping is handled more gracefully since this way at least something is * displayed instead of just a blank space filled by the background color. * * @param {Frame} frame - the {@link Frame} from which the module size is to be derived * @return {number} The pixel size for each module in the QR code which will be no less than one. * @protected * @memberof Renderer# */ getModuleSize: function(frame) { var qrious = this.qrious; var padding = qrious.padding || 0; var pixels = Math.floor((qrious.size - (padding * 2)) / frame.width); return Math.max(1, pixels); }, /** * Calculates the offset/padding (in pixel units) to be inserted before the QR code based on the frame * provided. * * The returned value will be zero if there is no available offset or if the size of the QR code does not fit its * contents. It will never be a negative value. This is done so that the inevitable clipping appears more naturally * and it is not clipped from all directions. * * @param {Frame} frame - the {@link Frame} from which the offset is to be derived * @return {number} The pixel offset for the QR code which will be no less than zero. * @protected * @memberof Renderer# */ getOffset: function(frame) { var qrious = this.qrious; var padding = qrious.padding; if (padding != null) { return padding; } var moduleSize = this.getModuleSize(frame); var offset = Math.floor((qrious.size - (moduleSize * frame.width)) / 2); return Math.max(0, offset); }, /** * Renders a QR code on the underlying element based on the frame provided. * * @param {Frame} frame - the {@link Frame} to be rendered * @return {void} * @public * @memberof Renderer# */ render: function(frame) { if (this.enabled) { this.reset(); this.draw(frame); } }, /** * Resets the underlying element, effectively clearing any previously rendered QR code. * * Implementations of {@link Renderer} must override this method with their own specific logic. * * @return {void} * @protected * @abstract * @memberof Renderer# */ reset: function() {}, /** * Ensures that the size of the underlying element matches that defined on the associated {@link QRious} instance. * * Implementations of {@link Renderer} must override this method with their own specific logic. * * @return {void} * @protected * @abstract * @memberof Renderer# */ resize: function() {} }); var Renderer_1 = Renderer; /** * An implementation of {@link Renderer} for working with canvas elements. * * @public * @class * @extends Renderer */ var CanvasRenderer = Renderer_1.extend({ /** * @override */ draw: function(frame) { var i, j; var qrious = this.qrious; var moduleSize = this.getModuleSize(frame); var offset = this.getOffset(frame); var context = this.element.getContext('2d'); context.fillStyle = qrious.foreground; context.globalAlpha = qrious.foregroundAlpha; for (i = 0; i < frame.width; i++) { for (j = 0; j < frame.width; j++) { if (frame.buffer[(j * frame.width) + i]) { context.fillRect((moduleSize * i) + offset, (moduleSize * j) + offset, moduleSize, moduleSize); } } } }, /** * @override */ reset: function() { var qrious = this.qrious; var context = this.element.getContext('2d'); var size = qrious.size; context.lineWidth = 1; context.clearRect(0, 0, size, size); context.fillStyle = qrious.background; context.globalAlpha = qrious.backgroundAlpha; context.fillRect(0, 0, size, size); }, /** * @override */ resize: function() { var element = this.element; element.width = element.height = this.qrious.size; } }); var CanvasRenderer_1 = CanvasRenderer; /* eslint no-multi-spaces: "off" */ /** * Contains alignment pattern information. * * @public * @class * @extends Nevis */ var Alignment = lite.extend(null, { /** * The alignment pattern block. * * @public * @static * @type {number[]} * @memberof Alignment */ BLOCK: [ 0, 11, 15, 19, 23, 27, 31, 16, 18, 20, 22, 24, 26, 28, 20, 22, 24, 24, 26, 28, 28, 22, 24, 24, 26, 26, 28, 28, 24, 24, 26, 26, 26, 28, 28, 24, 26, 26, 26, 28, 28 ] }); var Alignment_1 = Alignment; /* eslint no-multi-spaces: "off" */ /** * Contains error correction information. * * @public * @class * @extends Nevis */ var ErrorCorrection = lite.extend(null, { /** * The error correction blocks. * * There are four elements per version. The first two indicate the number of blocks, then the data width, and finally * the ECC width. * * @public * @static * @type {number[]} * @memberof ErrorCorrection */ BLOCKS: [ 1, 0, 19, 7, 1, 0, 16, 10, 1, 0, 13, 13, 1, 0, 9, 17, 1, 0, 34, 10, 1, 0, 28, 16, 1, 0, 22, 22, 1, 0, 16, 28, 1, 0, 55, 15, 1, 0, 44, 26, 2, 0, 17, 18, 2, 0, 13, 22, 1, 0, 80, 20, 2, 0, 32, 18, 2, 0, 24, 26, 4, 0, 9, 16, 1, 0, 108, 26, 2, 0, 43, 24, 2, 2, 15, 18, 2, 2, 11, 22, 2, 0, 68, 18, 4, 0, 27, 16, 4, 0, 19, 24, 4, 0, 15, 28, 2, 0, 78, 20, 4, 0, 31, 18, 2, 4, 14, 18, 4, 1, 13, 26, 2, 0, 97, 24, 2, 2, 38, 22, 4, 2, 18, 22, 4, 2, 14, 26, 2, 0, 116, 30, 3, 2, 36, 22, 4, 4, 16, 20, 4, 4, 12, 24, 2, 2, 68, 18, 4, 1, 43, 26, 6, 2, 19, 24, 6, 2, 15, 28, 4, 0, 81, 20, 1, 4, 50, 30, 4, 4, 22, 28, 3, 8, 12, 24, 2, 2, 92, 24, 6, 2, 36, 22, 4, 6, 20, 26, 7, 4, 14, 28, 4, 0, 107, 26, 8, 1, 37, 22, 8, 4, 20, 24, 12, 4, 11, 22, 3, 1, 115, 30, 4, 5, 40, 24, 11, 5, 16, 20, 11, 5, 12, 24, 5, 1, 87, 22, 5, 5, 41, 24, 5, 7, 24, 30, 11, 7, 12, 24, 5, 1, 98, 24, 7, 3, 45, 28, 15, 2, 19, 24, 3, 13, 15, 30, 1, 5, 107, 28, 10, 1, 46, 28, 1, 15, 22, 28, 2, 17, 14, 28, 5, 1, 120, 30, 9, 4, 43, 26, 17, 1, 22, 28, 2, 19, 14, 28, 3, 4, 113, 28, 3, 11, 44, 26, 17, 4, 21, 26, 9, 16, 13, 26, 3, 5, 107, 28, 3, 13, 41, 26, 15, 5, 24, 30, 15, 10, 15, 28, 4, 4, 116, 28, 17, 0, 42, 26, 17, 6, 22, 28, 19, 6, 16, 30, 2, 7, 111, 28, 17, 0, 46, 28, 7, 16, 24, 30, 34, 0, 13, 24, 4, 5, 121, 30, 4, 14, 47, 28, 11, 14, 24, 30, 16, 14, 15, 30, 6, 4, 117, 30, 6, 14, 45, 28, 11, 16, 24, 30, 30, 2, 16, 30, 8, 4, 106, 26, 8, 13, 47, 28, 7, 22, 24, 30, 22, 13, 15, 30, 10, 2, 114, 28, 19, 4, 46, 28, 28, 6, 22, 28, 33, 4, 16, 30, 8, 4, 122, 30, 22, 3, 45, 28, 8, 26, 23, 30, 12, 28, 15, 30, 3, 10, 117, 30, 3, 23, 45, 28, 4, 31, 24, 30, 11, 31, 15, 30, 7, 7, 116, 30, 21, 7, 45, 28, 1, 37, 23, 30, 19, 26, 15, 30, 5, 10, 115, 30, 19, 10, 47, 28, 15, 25, 24, 30, 23, 25, 15, 30, 13, 3, 115, 30, 2, 29, 46, 28, 42, 1, 24, 30, 23, 28, 15, 30, 17, 0, 115, 30, 10, 23, 46, 28, 10, 35, 24, 30, 19, 35, 15, 30, 17, 1, 115, 30, 14, 21, 46, 28, 29, 19, 24, 30, 11, 46, 15, 30, 13, 6, 115, 30, 14, 23, 46, 28, 44, 7, 24, 30, 59, 1, 16, 30, 12, 7, 121, 30, 12, 26, 47, 28, 39, 14, 24, 30, 22, 41, 15, 30, 6, 14, 121, 30, 6, 34, 47, 28, 46, 10, 24, 30, 2, 64, 15, 30, 17, 4, 122, 30, 29, 14, 46, 28, 49, 10, 24, 30, 24, 46, 15, 30, 4, 18, 122, 30, 13, 32, 46, 28, 48, 14, 24, 30, 42, 32, 15, 30, 20, 4, 117, 30, 40, 7, 47, 28, 43, 22, 24, 30, 10, 67, 15, 30, 19, 6, 118, 30, 18, 31, 47, 28, 34, 34, 24, 30, 20, 61, 15, 30 ], /** * The final format bits with mask (level << 3 | mask). * * @public * @static * @type {number[]} * @memberof ErrorCorrection */ FINAL_FORMAT: [ // L 0x77c4, 0x72f3, 0x7daa, 0x789d, 0x662f, 0x6318, 0x6c41, 0x6976, // M 0x5412, 0x5125, 0x5e7c, 0x5b4b, 0x45f9, 0x40ce, 0x4f97, 0x4aa0, // Q 0x355f, 0x3068, 0x3f31, 0x3a06, 0x24b4, 0x2183, 0x2eda, 0x2bed, // H 0x1689, 0x13be, 0x1ce7, 0x19d0, 0x0762, 0x0255, 0x0d0c, 0x083b ], /** * A map of human-readable ECC levels. * * @public * @static * @type {Object.} * @memberof ErrorCorrection */ LEVELS: { L: 1, M: 2, Q: 3, H: 4 } }); var ErrorCorrection_1 = ErrorCorrection; /** * Contains Galois field information. * * @public * @class * @extends Nevis */ var Galois = lite.extend(null, { /** * The Galois field exponent table. * * @public * @static * @type {number[]} * @memberof Galois */ EXPONENT: [ 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x1d, 0x3a, 0x74, 0xe8, 0xcd, 0x87, 0x13, 0x26, 0x4c, 0x98, 0x2d, 0x5a, 0xb4, 0x75, 0xea, 0xc9, 0x8f, 0x03, 0x06, 0x0c, 0x18, 0x30, 0x60, 0xc0, 0x9d, 0x27, 0x4e, 0x9c, 0x25, 0x4a, 0x94, 0x35, 0x6a, 0xd4, 0xb5, 0x77, 0xee, 0xc1, 0x9f, 0x23, 0x46, 0x8c, 0x05, 0x0a, 0x14, 0x28, 0x50, 0xa0, 0x5d, 0xba, 0x69, 0xd2, 0xb9, 0x6f, 0xde, 0xa1, 0x5f, 0xbe, 0x61, 0xc2, 0x99, 0x2f, 0x5e, 0xbc, 0x65, 0xca, 0x89, 0x0f, 0x1e, 0x3c, 0x78, 0xf0, 0xfd, 0xe7, 0xd3, 0xbb, 0x6b, 0xd6, 0xb1, 0x7f, 0xfe, 0xe1, 0xdf, 0xa3, 0x5b, 0xb6, 0x71, 0xe2, 0xd9, 0xaf, 0x43, 0x86, 0x11, 0x22, 0x44, 0x88, 0x0d, 0x1a, 0x34, 0x68, 0xd0, 0xbd, 0x67, 0xce, 0x81, 0x1f, 0x3e, 0x7c, 0xf8, 0xed, 0xc7, 0x93, 0x3b, 0x76, 0xec, 0xc5, 0x97, 0x33, 0x66, 0xcc, 0x85, 0x17, 0x2e, 0x5c, 0xb8, 0x6d, 0xda, 0xa9, 0x4f, 0x9e, 0x21, 0x42, 0x84, 0x15, 0x2a, 0x54, 0xa8, 0x4d, 0x9a, 0x29, 0x52, 0xa4, 0x55, 0xaa, 0x49, 0x92, 0x39, 0x72, 0xe4, 0xd5, 0xb7, 0x73, 0xe6, 0xd1, 0xbf, 0x63, 0xc6, 0x91, 0x3f, 0x7e, 0xfc, 0xe5, 0xd7, 0xb3, 0x7b, 0xf6, 0xf1, 0xff, 0xe3, 0xdb, 0xab, 0x4b, 0x96, 0x31, 0x62, 0xc4, 0x95, 0x37, 0x6e, 0xdc, 0xa5, 0x57, 0xae, 0x41, 0x82, 0x19, 0x32, 0x64, 0xc8, 0x8d, 0x07, 0x0e, 0x1c, 0x38, 0x70, 0xe0, 0xdd, 0xa7, 0x53, 0xa6, 0x51, 0xa2, 0x59, 0xb2, 0x79, 0xf2, 0xf9, 0xef, 0xc3, 0x9b, 0x2b, 0x56, 0xac, 0x45, 0x8a, 0x09, 0x12, 0x24, 0x48, 0x90, 0x3d, 0x7a, 0xf4, 0xf5, 0xf7, 0xf3, 0xfb, 0xeb, 0xcb, 0x8b, 0x0b, 0x16, 0x2c, 0x58, 0xb0, 0x7d, 0xfa, 0xe9, 0xcf, 0x83, 0x1b, 0x36, 0x6c, 0xd8, 0xad, 0x47, 0x8e, 0x00 ], /** * The Galois field log table. * * @public * @static * @type {number[]} * @memberof Galois */ LOG: [ 0xff, 0x00, 0x01, 0x19, 0x02, 0x32, 0x1a, 0xc6, 0x03, 0xdf, 0x33, 0xee, 0x1b, 0x68, 0xc7, 0x4b, 0x04, 0x64, 0xe0, 0x0e, 0x34, 0x8d, 0xef, 0x81, 0x1c, 0xc1, 0x69, 0xf8, 0xc8, 0x08, 0x4c, 0x71, 0x05, 0x8a, 0x65, 0x2f, 0xe1, 0x24, 0x0f, 0x21, 0x35, 0x93, 0x8e, 0xda, 0xf0, 0x12, 0x82, 0x45, 0x1d, 0xb5, 0xc2, 0x7d, 0x6a, 0x27, 0xf9, 0xb9, 0xc9, 0x9a, 0x09, 0x78, 0x4d, 0xe4, 0x72, 0xa6, 0x06, 0xbf, 0x8b, 0x62, 0x66, 0xdd, 0x30, 0xfd, 0xe2, 0x98, 0x25, 0xb3, 0x10, 0x91, 0x22, 0x88, 0x36, 0xd0, 0x94, 0xce, 0x8f, 0x96, 0xdb, 0xbd, 0xf1, 0xd2, 0x13, 0x5c, 0x83, 0x38, 0x46, 0x40, 0x1e, 0x42, 0xb6, 0xa3, 0xc3, 0x48, 0x7e, 0x6e, 0x6b, 0x3a, 0x28, 0x54, 0xfa, 0x85, 0xba, 0x3d, 0xca, 0x5e, 0x9b, 0x9f, 0x0a, 0x15, 0x79, 0x2b, 0x4e, 0xd4, 0xe5, 0xac, 0x73, 0xf3, 0xa7, 0x57, 0x07, 0x70, 0xc0, 0xf7, 0x8c, 0x80, 0x63, 0x0d, 0x67, 0x4a, 0xde, 0xed, 0x31, 0xc5, 0xfe, 0x18, 0xe3, 0xa5, 0x99, 0x77, 0x26, 0xb8, 0xb4, 0x7c, 0x11, 0x44, 0x92, 0xd9, 0x23, 0x20, 0x89, 0x2e, 0x37, 0x3f, 0xd1, 0x5b, 0x95, 0xbc, 0xcf, 0xcd, 0x90, 0x87, 0x97, 0xb2, 0xdc, 0xfc, 0xbe, 0x61, 0xf2, 0x56, 0xd3, 0xab, 0x14, 0x2a, 0x5d, 0x9e, 0x84, 0x3c, 0x39, 0x53, 0x47, 0x6d, 0x41, 0xa2, 0x1f, 0x2d, 0x43, 0xd8, 0xb7, 0x7b, 0xa4, 0x76, 0xc4, 0x17, 0x49, 0xec, 0x7f, 0x0c, 0x6f, 0xf6, 0x6c, 0xa1, 0x3b, 0x52, 0x29, 0x9d, 0x55, 0xaa, 0xfb, 0x60, 0x86, 0xb1, 0xbb, 0xcc, 0x3e, 0x5a, 0xcb, 0x59, 0x5f, 0xb0, 0x9c, 0xa9, 0xa0, 0x51, 0x0b, 0xf5, 0x16, 0xeb, 0x7a, 0x75, 0x2c, 0xd7, 0x4f, 0xae, 0xd5, 0xe9, 0xe6, 0xe7, 0xad, 0xe8, 0x74, 0xd6, 0xf4, 0xea, 0xa8, 0x50, 0x58, 0xaf ] }); var Galois_1 = Galois; /** * Contains version pattern information. * * @public * @class * @extends Nevis */ var Version = lite.extend(null, { /** * The version pattern block. * * @public * @static * @type {number[]} * @memberof Version */ BLOCK: [ 0xc94, 0x5bc, 0xa99, 0x4d3, 0xbf6, 0x762, 0x847, 0x60d, 0x928, 0xb78, 0x45d, 0xa17, 0x532, 0x9a6, 0x683, 0x8c9, 0x7ec, 0xec4, 0x1e1, 0xfab, 0x08e, 0xc1a, 0x33f, 0xd75, 0x250, 0x9d5, 0x6f0, 0x8ba, 0x79f, 0xb0b, 0x42e, 0xa64, 0x541, 0xc69 ] }); var Version_1 = Version; /** * Generates information for a QR code frame based on a specific value to be encoded. * * @param {Frame~Options} options - the options to be used * @public * @class * @extends Nevis */ var Frame = lite.extend(function(options) { var dataBlock, eccBlock, index, neccBlock1, neccBlock2; var valueLength = options.value.length; this._badness = []; this._level = ErrorCorrection_1.LEVELS[options.level]; this._polynomial = []; this._value = options.value; this._version = 0; this._stringBuffer = []; while (this._version < 40) { this._version++; index = ((this._level - 1) * 4) + ((this._version - 1) * 16); neccBlock1 = ErrorCorrection_1.BLOCKS[index++]; neccBlock2 = ErrorCorrection_1.BLOCKS[index++]; dataBlock = ErrorCorrection_1.BLOCKS[index++]; eccBlock = ErrorCorrection_1.BLOCKS[index]; index = (dataBlock * (neccBlock1 + neccBlock2)) + neccBlock2 - 3 + (this._version <= 9); if (valueLength <= index) { break; } } this._dataBlock = dataBlock; this._eccBlock = eccBlock; this._neccBlock1 = neccBlock1; this._neccBlock2 = neccBlock2; /** * The data width is based on version. * * @public * @type {number} * @memberof Frame# */ // FIXME: Ensure that it fits instead of being truncated. var width = this.width = 17 + (4 * this._version); /** * The image buffer. * * @public * @type {number[]} * @memberof Frame# */ this.buffer = Frame._createArray(width * width); this._ecc = Frame._createArray(dataBlock + ((dataBlock + eccBlock) * (neccBlock1 + neccBlock2)) + neccBlock2); this._mask = Frame._createArray(((width * (width + 1)) + 1) / 2); this._insertFinders(); this._insertAlignments(); // Insert single foreground cell. this.buffer[8 + (width * (width - 8))] = 1; this._insertTimingGap(); this._reverseMask(); this._insertTimingRowAndColumn(); this._insertVersion(); this._syncMask(); this._convertBitStream(valueLength); this._calculatePolynomial(); this._appendEccToData(); this._interleaveBlocks(); this._pack(); this._finish(); }, { _addAlignment: function(x, y) { var i; var buffer = this.buffer; var width = this.width; buffer[x + (width * y)] = 1; for (i = -2; i < 2; i++) { buffer[x + i + (width * (y - 2))] = 1; buffer[x - 2 + (width * (y + i + 1))] = 1; buffer[x + 2 + (width * (y + i))] = 1; buffer[x + i + 1 + (width * (y + 2))] = 1; } for (i = 0; i < 2; i++) { this._setMask(x - 1, y + i); this._setMask(x + 1, y - i); this._setMask(x - i, y - 1); this._setMask(x + i, y + 1); } }, _appendData: function(data, dataLength, ecc, eccLength) { var bit, i, j; var polynomial = this._polynomial; var stringBuffer = this._stringBuffer; for (i = 0; i < eccLength; i++) { stringBuffer[ecc + i] = 0; } for (i = 0; i < dataLength; i++) { bit = Galois_1.LOG[stringBuffer[data + i] ^ stringBuffer[ecc]]; if (bit !== 255) { for (j = 1; j < eccLength; j++) { stringBuffer[ecc + j - 1] = stringBuffer[ecc + j] ^ Galois_1.EXPONENT[Frame._modN(bit + polynomial[eccLength - j])]; } } else { for (j = ecc; j < ecc + eccLength; j++) { stringBuffer[j] = stringBuffer[j + 1]; } } stringBuffer[ecc + eccLength - 1] = bit === 255 ? 0 : Galois_1.EXPONENT[Frame._modN(bit + polynomial[0])]; } }, _appendEccToData: function() { var i; var data = 0; var dataBlock = this._dataBlock; var ecc = this._calculateMaxLength(); var eccBlock = this._eccBlock; for (i = 0; i < this._neccBlock1; i++) { this._appendData(data, dataBlock, ecc, eccBlock); data += dataBlock; ecc += eccBlock; } for (i = 0; i < this._neccBlock2; i++) { this._appendData(data, dataBlock + 1, ecc, eccBlock); data += dataBlock + 1; ecc += eccBlock; } }, _applyMask: function(mask) { var r3x, r3y, x, y; var buffer = this.buffer; var width = this.width; switch (mask) { case 0: for (y = 0; y < width; y++) { for (x = 0; x < width; x++) { if (!((x + y) & 1) && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 1: for (y = 0; y < width; y++) { for (x = 0; x < width; x++) { if (!(y & 1) && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 2: for (y = 0; y < width; y++) { for (r3x = 0, x = 0; x < width; x++, r3x++) { if (r3x === 3) { r3x = 0; } if (!r3x && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 3: for (r3y = 0, y = 0; y < width; y++, r3y++) { if (r3y === 3) { r3y = 0; } for (r3x = r3y, x = 0; x < width; x++, r3x++) { if (r3x === 3) { r3x = 0; } if (!r3x && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 4: for (y = 0; y < width; y++) { for (r3x = 0, r3y = (y >> 1) & 1, x = 0; x < width; x++, r3x++) { if (r3x === 3) { r3x = 0; r3y = !r3y; } if (!r3y && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 5: for (r3y = 0, y = 0; y < width; y++, r3y++) { if (r3y === 3) { r3y = 0; } for (r3x = 0, x = 0; x < width; x++, r3x++) { if (r3x === 3) { r3x = 0; } if (!((x & y & 1) + !(!r3x | !r3y)) && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 6: for (r3y = 0, y = 0; y < width; y++, r3y++) { if (r3y === 3) { r3y = 0; } for (r3x = 0, x = 0; x < width; x++, r3x++) { if (r3x === 3) { r3x = 0; } if (!((x & y & 1) + (r3x && r3x === r3y) & 1) && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; case 7: for (r3y = 0, y = 0; y < width; y++, r3y++) { if (r3y === 3) { r3y = 0; } for (r3x = 0, x = 0; x < width; x++, r3x++) { if (r3x === 3) { r3x = 0; } if (!((r3x && r3x === r3y) + (x + y & 1) & 1) && !this._isMasked(x, y)) { buffer[x + (y * width)] ^= 1; } } } break; } }, _calculateMaxLength: function() { return (this._dataBlock * (this._neccBlock1 + this._neccBlock2)) + this._neccBlock2; }, _calculatePolynomial: function() { var i, j; var eccBlock = this._eccBlock; var polynomial = this._polynomial; polynomial[0] = 1; for (i = 0; i < eccBlock; i++) { polynomial[i + 1] = 1; for (j = i; j > 0; j--) { polynomial[j] = polynomial[j] ? polynomial[j - 1] ^ Galois_1.EXPONENT[Frame._modN(Galois_1.LOG[polynomial[j]] + i)] : polynomial[j - 1]; } polynomial[0] = Galois_1.EXPONENT[Frame._modN(Galois_1.LOG[polynomial[0]] + i)]; } // Use logs for generator polynomial to save calculation step. for (i = 0; i <= eccBlock; i++) { polynomial[i] = Galois_1.LOG[polynomial[i]]; } }, _checkBadness: function() { var b, b1, h, x, y; var bad = 0; var badness = this._badness; var buffer = this.buffer; var width = this.width; // Blocks of same colour. for (y = 0; y < width - 1; y++) { for (x = 0; x < width - 1; x++) { // All foreground colour. if ((buffer[x + (width * y)] && buffer[x + 1 + (width * y)] && buffer[x + (width * (y + 1))] && buffer[x + 1 + (width * (y + 1))]) || // All background colour. !(buffer[x + (width * y)] || buffer[x + 1 + (width * y)] || buffer[x + (width * (y + 1))] || buffer[x + 1 + (width * (y + 1))])) { bad += Frame.N2; } } } var bw = 0; // X runs. for (y = 0; y < width; y++) { h = 0; badness[0] = 0; for (b = 0, x = 0; x < width; x++) { b1 = buffer[x + (width * y)]; if (b === b1) { badness[h]++; } else { badness[++h] = 1; } b = b1; bw += b ? 1 : -1; } bad += this._getBadness(h); } if (bw < 0) { bw = -bw; } var count = 0; var big = bw; big += big << 2; big <<= 1; while (big > width * width) { big -= width * width; count++; } bad += count * Frame.N4; // Y runs. for (x = 0; x < width; x++) { h = 0; badness[0] = 0; for (b = 0, y = 0; y < width; y++) { b1 = buffer[x + (width * y)]; if (b === b1) { badness[h]++; } else { badness[++h] = 1; } b = b1; } bad += this._getBadness(h); } return bad; }, _convertBitStream: function(length) { var bit, i; var ecc = this._ecc; var version = this._version; // Convert string to bit stream. 8-bit data to QR-coded 8-bit data (numeric, alphanumeric, or kanji not supported). for (i = 0; i < length; i++) { ecc[i] = this._value.charCodeAt(i); } var stringBuffer = this._stringBuffer = ecc.slice(); var maxLength = this._calculateMaxLength(); if (length >= maxLength - 2) { length = maxLength - 2; if (version > 9) { length--; } } // Shift and re-pack to insert length prefix. var index = length; if (version > 9) { stringBuffer[index + 2] = 0; stringBuffer[index + 3] = 0; while (index--) { bit = stringBuffer[index]; stringBuffer[index + 3] |= 255 & (bit << 4); stringBuffer[index + 2] = bit >> 4; } stringBuffer[2] |= 255 & (length << 4); stringBuffer[1] = length >> 4; stringBuffer[0] = 0x40 | (length >> 12); } else { stringBuffer[index + 1] = 0; stringBuffer[index + 2] = 0; while (index--) { bit = stringBuffer[index]; stringBuffer[index + 2] |= 255 & (bit << 4); stringBuffer[index + 1] = bit >> 4; } stringBuffer[1] |= 255 & (length << 4); stringBuffer[0] = 0x40 | (length >> 4); } // Fill to end with pad pattern. index = length + 3 - (version < 10); while (index < maxLength) { stringBuffer[index++] = 0xec; stringBuffer[index++] = 0x11; } }, _getBadness: function(length) { var i; var badRuns = 0; var badness = this._badness; for (i = 0; i <= length; i++) { if (badness[i] >= 5) { badRuns += Frame.N1 + badness[i] - 5; } } // FBFFFBF as in finder. for (i = 3; i < length - 1; i += 2) { if (badness[i - 2] === badness[i + 2] && badness[i + 2] === badness[i - 1] && badness[i - 1] === badness[i + 1] && badness[i - 1] * 3 === badness[i] && // Background around the foreground pattern? Not part of the specs. (badness[i - 3] === 0 || i + 3 > length || badness[i - 3] * 3 >= badness[i] * 4 || badness[i + 3] * 3 >= badness[i] * 4)) { badRuns += Frame.N3; } } return badRuns; }, _finish: function() { // Save pre-mask copy of frame. this._stringBuffer = this.buffer.slice(); var currentMask, i; var bit = 0; var mask = 30000; /* * Using for instead of while since in original Arduino code if an early mask was "good enough" it wouldn't try for * a better one since they get more complex and take longer. */ for (i = 0; i < 8; i++) { // Returns foreground-background imbalance. this._applyMask(i); currentMask = this._checkBadness(); // Is current mask better than previous best? if (currentMask < mask) { mask = currentMask; bit = i; } // Don't increment "i" to a void redoing mask. if (bit === 7) { break; } // Reset for next pass. this.buffer = this._stringBuffer.slice(); } // Redo best mask as none were "good enough" (i.e. last wasn't bit). if (bit !== i) { this._applyMask(bit); } // Add in final mask/ECC level bytes. mask = ErrorCorrection_1.FINAL_FORMAT[bit + (this._level - 1 << 3)]; var buffer = this.buffer; var width = this.width; // Low byte. for (i = 0; i < 8; i++, mask >>= 1) { if (mask & 1) { buffer[width - 1 - i + (width * 8)] = 1; if (i < 6) { buffer[8 + (width * i)] = 1; } else { buffer[8 + (width * (i + 1))] = 1; } } } // High byte. for (i = 0; i < 7; i++, mask >>= 1) { if (mask & 1) { buffer[8 + (width * (width - 7 + i))] = 1; if (i) { buffer[6 - i + (width * 8)] = 1; } else { buffer[7 + (width * 8)] = 1; } } } }, _interleaveBlocks: function() { var i, j; var dataBlock = this._dataBlock; var ecc = this._ecc; var eccBlock = this._eccBlock; var k = 0; var maxLength = this._calculateMaxLength(); var neccBlock1 = this._neccBlock1; var neccBlock2 = this._neccBlock2; var stringBuffer = this._stringBuffer; for (i = 0; i < dataBlock; i++) { for (j = 0; j < neccBlock1; j++) { ecc[k++] = stringBuffer[i + (j * dataBlock)]; } for (j = 0; j < neccBlock2; j++) { ecc[k++] = stringBuffer[(neccBlock1 * dataBlock) + i + (j * (dataBlock + 1))]; } } for (j = 0; j < neccBlock2; j++) { ecc[k++] = stringBuffer[(neccBlock1 * dataBlock) + i + (j * (dataBlock + 1))]; } for (i = 0; i < eccBlock; i++) { for (j = 0; j < neccBlock1 + neccBlock2; j++) { ecc[k++] = stringBuffer[maxLength + i + (j * eccBlock)]; } } this._stringBuffer = ecc; }, _insertAlignments: function() { var i, x, y; var version = this._version; var width = this.width; if (version > 1) { i = Alignment_1.BLOCK[version]; y = width - 7; for (;;) { x = width - 7; while (x > i - 3) { this._addAlignment(x, y); if (x < i) { break; } x -= i; } if (y <= i + 9) { break; } y -= i; this._addAlignment(6, y); this._addAlignment(y, 6); } } }, _insertFinders: function() { var i, j, x, y; var buffer = this.buffer; var width = this.width; for (i = 0; i < 3; i++) { j = 0; y = 0; if (i === 1) { j = width - 7; } if (i === 2) { y = width - 7; } buffer[y + 3 + (width * (j + 3))] = 1; for (x = 0; x < 6; x++) { buffer[y + x + (width * j)] = 1; buffer[y + (width * (j + x + 1))] = 1; buffer[y + 6 + (width * (j + x))] = 1; buffer[y + x + 1 + (width * (j + 6))] = 1; } for (x = 1; x < 5; x++) { this._setMask(y + x, j + 1); this._setMask(y + 1, j + x + 1); this._setMask(y + 5, j + x); this._setMask(y + x + 1, j + 5); } for (x = 2; x < 4; x++) { buffer[y + x + (width * (j + 2))] = 1; buffer[y + 2 + (width * (j + x + 1))] = 1; buffer[y + 4 + (width * (j + x))] = 1; buffer[y + x + 1 + (width * (j + 4))] = 1; } } }, _insertTimingGap: function() { var x, y; var width = this.width; for (y = 0; y < 7; y++) { this._setMask(7, y); this._setMask(width - 8, y); this._setMask(7, y + width - 7); } for (x = 0; x < 8; x++) { this._setMask(x, 7); this._setMask(x + width - 8, 7); this._setMask(x, width - 8); } }, _insertTimingRowAndColumn: function() { var x; var buffer = this.buffer; var width = this.width; for (x = 0; x < width - 14; x++) { if (x & 1) { this._setMask(8 + x, 6); this._setMask(6, 8 + x); } else { buffer[8 + x + (width * 6)] = 1; buffer[6 + (width * (8 + x))] = 1; } } }, _insertVersion: function() { var i, j, x, y; var buffer = this.buffer; var version = this._version; var width = this.width; if (version > 6) { i = Version_1.BLOCK[version - 7]; j = 17; for (x = 0; x < 6; x++) { for (y = 0; y < 3; y++, j--) { if (1 & (j > 11 ? version >> j - 12 : i >> j)) { buffer[5 - x + (width * (2 - y + width - 11))] = 1; buffer[2 - y + width - 11 + (width * (5 - x))] = 1; } else { this._setMask(5 - x, 2 - y + width - 11); this._setMask(2 - y + width - 11, 5 - x); } } } } }, _isMasked: function(x, y) { var bit = Frame._getMaskBit(x, y); return this._mask[bit] === 1; }, _pack: function() { var bit, i, j; var k = 1; var v = 1; var width = this.width; var x = width - 1; var y = width - 1; // Interleaved data and ECC codes. var length = ((this._dataBlock + this._eccBlock) * (this._neccBlock1 + this._neccBlock2)) + this._neccBlock2; for (i = 0; i < length; i++) { bit = this._stringBuffer[i]; for (j = 0; j < 8; j++, bit <<= 1) { if (0x80 & bit) { this.buffer[x + (width * y)] = 1; } // Find next fill position. do { if (v) { x--; } else { x++; if (k) { if (y !== 0) { y--; } else { x -= 2; k = !k; if (x === 6) { x--; y = 9; } } } else if (y !== width - 1) { y++; } else { x -= 2; k = !k; if (x === 6) { x--; y -= 8; } } } v = !v; } while (this._isMasked(x, y)); } } }, _reverseMask: function() { var x, y; var width = this.width; for (x = 0; x < 9; x++) { this._setMask(x, 8); } for (x = 0; x < 8; x++) { this._setMask(x + width - 8, 8); this._setMask(8, x); } for (y = 0; y < 7; y++) { this._setMask(8, y + width - 7); } }, _setMask: function(x, y) { var bit = Frame._getMaskBit(x, y); this._mask[bit] = 1; }, _syncMask: function() { var x, y; var width = this.width; for (y = 0; y < width; y++) { for (x = 0; x <= y; x++) { if (this.buffer[x + (width * y)]) { this._setMask(x, y); } } } } }, { _createArray: function(length) { var i; var array = []; for (i = 0; i < length; i++) { array[i] = 0; } return array; }, _getMaskBit: function(x, y) { var bit; if (x > y) { bit = x; x = y; y = bit; } bit = y; bit += y * y; bit >>= 1; bit += x; return bit; }, _modN: function(x) { while (x >= 255) { x -= 255; x = (x >> 8) + (x & 255); } return x; }, // *Badness* coefficients. N1: 3, N2: 3, N3: 40, N4: 10 }); var Frame_1 = Frame; /** * The options used by {@link Frame}. * * @typedef {Object} Frame~Options * @property {string} level - The ECC level to be used. * @property {string} value - The value to be encoded. */ /** * An implementation of {@link Renderer} for working with img elements. * * This depends on {@link CanvasRenderer} being executed first as this implementation simply applies the data URL from * the rendered canvas element as the src for the img element being rendered. * * @public * @class * @extends Renderer */ var ImageRenderer = Renderer_1.extend({ /** * @override */ draw: function() { this.element.src = this.qrious.toDataURL(); }, /** * @override */ reset: function() { this.element.src = ''; }, /** * @override */ resize: function() { var element = this.element; element.width = element.height = this.qrious.size; } }); var ImageRenderer_1 = ImageRenderer; /** * Defines an available option while also configuring how values are applied to the target object. * * Optionally, a default value can be specified as well a value transformer for greater control over how the option * value is applied. * * If no value transformer is specified, then any specified option will be applied directly. All values are maintained * on the target object itself as a field using the option name prefixed with a single underscore. * * When an option is specified as modifiable, the {@link OptionManager} will be required to include a setter for the * property that is defined on the target object that uses the option name. * * @param {string} name - the name to be used * @param {boolean} [modifiable] - true if the property defined on target objects should include a setter; * otherwise false * @param {*} [defaultValue] - the default value to be used * @param {Option~ValueTransformer} [valueTransformer] - the value transformer to be used * @public * @class * @extends Nevis */ var Option = lite.extend(function(name, modifiable, defaultValue, valueTransformer) { /** * The name for this {@link Option}. * * @public * @type {string} * @memberof Option# */ this.name = name; /** * Whether a setter should be included on the property defined on target objects for this {@link Option}. * * @public * @type {boolean} * @memberof Option# */ this.modifiable = Boolean(modifiable); /** * The default value for this {@link Option}. * * @public * @type {*} * @memberof Option# */ this.defaultValue = defaultValue; this._valueTransformer = valueTransformer; }, { /** * Transforms the specified value so that it can be applied for this {@link Option}. * * If a value transformer has been specified for this {@link Option}, it will be called upon to transform * value. Otherwise, value will be returned directly. * * @param {*} value - the value to be transformed * @return {*} The transformed value or value if no value transformer is specified. * @public * @memberof Option# */ transform: function(value) { var transformer = this._valueTransformer; if (typeof transformer === 'function') { return transformer(value, this); } return value; } }); var Option_1 = Option; /** * Returns a transformed value for the specified value to be applied for the option provided. * * @callback Option~ValueTransformer * @param {*} value - the value to be transformed * @param {Option} option - the {@link Option} for which value is being transformed * @return {*} The transform value. */ /** * Contains utility methods that are useful throughout the library. * * @public * @class * @extends Nevis */ var Utilities = lite.extend(null, { /** * Returns the absolute value of a given number. * * This method is simply a convenient shorthand for Math.abs while ensuring that nulls are returned as * null instead of zero. * * @param {number} value - the number whose absolute value is to be returned * @return {number} The absolute value of value or null if value is * null. * @public * @static * @memberof Utilities */ abs: function(value) { return value != null ? Math.abs(value) : null; }, /** * Returns whether the specified object has a property with the specified name as an own * (not inherited) property. * * @param {Object} object - the object on which the property is to be checked * @param {string} name - the name of the property to be checked * @return {boolean} true if object has an own property with name. * @public * @static * @memberof Utilities */ hasOwn: function(object, name) { return Object.prototype.hasOwnProperty.call(object, name); }, /** * A non-operation method that does absolutely nothing. * * @return {void} * @public * @static * @memberof Utilities */ noop: function() {}, /** * Transforms the specified string to upper case while remaining null-safe. * * @param {string} string - the string to be transformed to upper case * @return {string} string transformed to upper case if string is not null. * @public * @static * @memberof Utilities */ toUpperCase: function(string) { return string != null ? string.toUpperCase() : null; } }); var Utilities_1 = Utilities; /** * Manages multiple {@link Option} instances that are intended to be used by multiple implementations. * * Although the option definitions are shared between targets, the values are maintained on the targets themselves. * * @param {Option[]} options - the options to be used * @public * @class * @extends Nevis */ var OptionManager = lite.extend(function(options) { /** * The available options for this {@link OptionManager}. * * @public * @type {Object.} * @memberof OptionManager# */ this.options = {}; options.forEach(function(option) { this.options[option.name] = option; }, this); }, { /** * Returns whether an option with the specified name is available. * * @param {string} name - the name of the {@link Option} whose existence is to be checked * @return {boolean} true if an {@link Option} exists with name; otherwise * false. * @public * @memberof OptionManager# */ exists: function(name) { return this.options[name] != null; }, /** * Returns the value of the option with the specified name on the target object provided. * * @param {string} name - the name of the {@link Option} whose value on target is to be returned * @param {Object} target - the object from which the value of the named {@link Option} is to be returned * @return {*} The value of the {@link Option} with name on target. * @public * @memberof OptionManager# */ get: function(name, target) { return OptionManager._get(this.options[name], target); }, /** * Returns a copy of all of the available options on the target object provided. * * @param {Object} target - the object from which the option name/value pairs are to be returned * @return {Object.} A hash containing the name/value pairs of all options on target. * @public * @memberof OptionManager# */ getAll: function(target) { var name; var options = this.options; var result = {}; for (name in options) { if (Utilities_1.hasOwn(options, name)) { result[name] = OptionManager._get(options[name], target); } } return result; }, /** * Initializes the available options for the target object provided and then applies the initial values * within the speciifed options. * * This method will throw an error if any of the names within options does not match an available option. * * This involves setting the default values and defining properties for all of the available options on * target before finally calling {@link OptionMananger#setAll} with options and * target. Any options that are configured to be modifiable will have a setter included in their defined * property that will allow its corresponding value to be modified. * * If a change handler is specified, it will be called whenever the value changes on target for a * modifiable option, but only when done so via the defined property's setter. * * @param {Object.} options - the name/value pairs of the initial options to be set * @param {Object} target - the object on which the options are to be initialized * @param {Function} [changeHandler] - the function to be called whenever the value of an modifiable option changes on * target * @return {void} * @throws {Error} If options contains an invalid option name. * @public * @memberof OptionManager# */ init: function(options, target, changeHandler) { if (typeof changeHandler !== 'function') { changeHandler = Utilities_1.noop; } var name, option; for (name in this.options) { if (Utilities_1.hasOwn(this.options, name)) { option = this.options[name]; OptionManager._set(option, option.defaultValue, target); OptionManager._createAccessor(option, target, changeHandler); } } this._setAll(options, target, true); }, /** * Sets the value of the option with the specified name on the target object provided to * value. * * This method will throw an error if name does not match an available option or matches an option that * cannot be modified. * * If value is null and the {@link Option} has a default value configured, then that default * value will be used instead. If the {@link Option} also has a value transformer configured, it will be used to * transform whichever value was determined to be used. * * This method returns whether the value of the underlying field on target was changed as a result. * * @param {string} name - the name of the {@link Option} whose value is to be set * @param {*} value - the value to be set for the named {@link Option} on target * @param {Object} target - the object on which value is to be set for the named {@link Option} * @return {boolean} true if the underlying field on target was changed; otherwise * false. * @throws {Error} If name is invalid or is for an option that cannot be modified. * @public * @memberof OptionManager# */ set: function(name, value, target) { return this._set(name, value, target); }, /** * Sets all of the specified options on the target object provided to their corresponding * values. * * This method will throw an error if any of the names within options does not match an available option * or matches an option that cannot be modified. * * If any value within options is null and the corresponding {@link Option} has a default * value configured, then that default value will be used instead. If an {@link Option} also has a value transformer * configured, it will be used to transform whichever value was determined to be used. * * This method returns whether the value for any of the underlying fields on target were changed as a * result. * * @param {Object.} options - the name/value pairs of options to be set * @param {Object} target - the object on which the options are to be set * @return {boolean} true if any of the underlying fields on target were changed; otherwise * false. * @throws {Error} If options contains an invalid option name or an option that cannot be modiifed. * @public * @memberof OptionManager# */ setAll: function(options, target) { return this._setAll(options, target); }, _set: function(name, value, target, allowUnmodifiable) { var option = this.options[name]; if (!option) { throw new Error('Invalid option: ' + name); } if (!option.modifiable && !allowUnmodifiable) { throw new Error('Option cannot be modified: ' + name); } return OptionManager._set(option, value, target); }, _setAll: function(options, target, allowUnmodifiable) { if (!options) { return false; } var name; var changed = false; for (name in options) { if (Utilities_1.hasOwn(options, name) && this._set(name, options[name], target, allowUnmodifiable)) { changed = true; } } return changed; } }, { _createAccessor: function(option, target, changeHandler) { var descriptor = { get: function() { return OptionManager._get(option, target); } }; if (option.modifiable) { descriptor.set = function(value) { if (OptionManager._set(option, value, target)) { changeHandler(value, option); } }; } Object.defineProperty(target, option.name, descriptor); }, _get: function(option, target) { return target['_' + option.name]; }, _set: function(option, value, target) { var fieldName = '_' + option.name; var oldValue = target[fieldName]; var newValue = option.transform(value != null ? value : option.defaultValue); target[fieldName] = newValue; return newValue !== oldValue; } }); var OptionManager_1 = OptionManager; /** * Called whenever the value of a modifiable {@link Option} is changed on a target object via the defined property's * setter. * * @callback OptionManager~ChangeHandler * @param {*} value - the new value for option on the target object * @param {Option} option - the modifable {@link Option} whose value has changed on the target object. * @return {void} */ /** * A basic manager for {@link Service} implementations that are mapped to simple names. * * @public * @class * @extends Nevis */ var ServiceManager = lite.extend(function() { this._services = {}; }, { /** * Returns the {@link Service} being managed with the specified name. * * @param {string} name - the name of the {@link Service} to be returned * @return {Service} The {@link Service} is being managed with name. * @throws {Error} If no {@link Service} is being managed with name. * @public * @memberof ServiceManager# */ getService: function(name) { var service = this._services[name]; if (!service) { throw new Error('Service is not being managed with name: ' + name); } return service; }, /** * Sets the {@link Service} implementation to be managed for the specified name to the * service provided. * * @param {string} name - the name of the {@link Service} to be managed with name * @param {Service} service - the {@link Service} implementation to be managed * @return {void} * @throws {Error} If a {@link Service} is already being managed with the same name. * @public * @memberof ServiceManager# */ setService: function(name, service) { if (this._services[name]) { throw new Error('Service is already managed with name: ' + name); } if (service) { this._services[name] = service; } } }); var ServiceManager_1 = ServiceManager; var optionManager = new OptionManager_1([ new Option_1('background', true, 'white'), new Option_1('backgroundAlpha', true, 1, Utilities_1.abs), new Option_1('element'), new Option_1('foreground', true, 'black'), new Option_1('foregroundAlpha', true, 1, Utilities_1.abs), new Option_1('level', true, 'L', Utilities_1.toUpperCase), new Option_1('mime', true, 'image/png'), new Option_1('padding', true, null, Utilities_1.abs), new Option_1('size', true, 100, Utilities_1.abs), new Option_1('value', true, '') ]); var serviceManager = new ServiceManager_1(); /** * Enables configuration of a QR code generator which uses HTML5 canvas for rendering. * * @param {QRious~Options} [options] - the options to be used * @throws {Error} If any options are invalid. * @public * @class * @extends Nevis */ var QRious = lite.extend(function(options) { optionManager.init(options, this, this.update.bind(this)); var element = optionManager.get('element', this); var elementService = serviceManager.getService('element'); var canvas = element && elementService.isCanvas(element) ? element : elementService.createCanvas(); var image = element && elementService.isImage(element) ? element : elementService.createImage(); this._canvasRenderer = new CanvasRenderer_1(this, canvas, true); this._imageRenderer = new ImageRenderer_1(this, image, image === element); this.update(); }, { /** * Returns all of the options configured for this {@link QRious}. * * Any changes made to the returned object will not be reflected in the options themselves or their corresponding * underlying fields. * * @return {Object.} A copy of the applied options. * @public * @memberof QRious# */ get: function() { return optionManager.getAll(this); }, /** * Sets all of the specified options and automatically updates this {@link QRious} if any of the * underlying fields are changed as a result. * * This is the preferred method for updating multiple options at one time to avoid unnecessary updates between * changes. * * @param {QRious~Options} options - the options to be set * @return {void} * @throws {Error} If any options are invalid or cannot be modified. * @public * @memberof QRious# */ set: function(options) { if (optionManager.setAll(options, this)) { this.update(); } }, /** * Returns the image data URI for the generated QR code using the mime provided. * * @param {string} [mime] - the MIME type for the image * @return {string} The image data URI for the QR code. * @public * @memberof QRious# */ toDataURL: function(mime) { return this.canvas.toDataURL(mime || this.mime); }, /** * Updates this {@link QRious} by generating a new {@link Frame} and re-rendering the QR code. * * @return {void} * @protected * @memberof QRious# */ update: function() { var frame = new Frame_1({ level: this.level, value: this.value }); this._canvasRenderer.render(frame); this._imageRenderer.render(frame); } }, { /** * Configures the service provided to be used by all {@link QRious} instances. * * @param {Service} service - the {@link Service} to be configured * @return {void} * @throws {Error} If a {@link Service} has already been configured with the same name. * @public * @static * @memberof QRious */ use: function(service) { serviceManager.setService(service.getName(), service); } }); Object.defineProperties(QRious.prototype, { canvas: { /** * Returns the canvas element being used to render the QR code for this {@link QRious}. * * @return {*} The canvas element. * @public * @memberof QRious# * @alias canvas */ get: function() { return this._canvasRenderer.getElement(); } }, image: { /** * Returns the img element being used to render the QR code for this {@link QRious}. * * @return {*} The img element. * @public * @memberof QRious# * @alias image */ get: function() { return this._imageRenderer.getElement(); } } }); var QRious_1$2 = QRious; /** * The options used by {@link QRious}. * * @typedef {Object} QRious~Options * @property {string} [background="white"] - The background color to be applied to the QR code. * @property {number} [backgroundAlpha=1] - The background alpha to be applied to the QR code. * @property {*} [element] - The element to be used to render the QR code which may either be an canvas or * img. The element(s) will be created if needed. * @property {string} [foreground="black"] - The foreground color to be applied to the QR code. * @property {number} [foregroundAlpha=1] - The foreground alpha to be applied to the QR code. * @property {string} [level="L"] - The error correction level to be applied to the QR code. * @property {string} [mime="image/png"] - The MIME type to be used to render the image for the QR code. * @property {number} [padding] - The padding for the QR code in pixels. * @property {number} [size=100] - The size of the QR code in pixels. * @property {string} [value=""] - The value to be encoded within the QR code. */ var index = QRious_1$2; /** * Defines a service contract that must be met by all implementations. * * @public * @class * @extends Nevis */ var Service = lite.extend({ /** * Returns the name of this {@link Service}. * * @return {string} The service name. * @public * @abstract * @memberof Service# */ getName: function() {} }); var Service_1 = Service; /** * A service for working with elements. * * @public * @class * @extends Service */ var ElementService = Service_1.extend({ /** * Creates an instance of a canvas element. * * Implementations of {@link ElementService} must override this method with their own specific logic. * * @return {*} The newly created canvas element. * @public * @abstract * @memberof ElementService# */ createCanvas: function() {}, /** * Creates an instance of a image element. * * Implementations of {@link ElementService} must override this method with their own specific logic. * * @return {*} The newly created image element. * @public * @abstract * @memberof ElementService# */ createImage: function() {}, /** * @override */ getName: function() { return 'element'; }, /** * Returns whether the specified element is a canvas. * * Implementations of {@link ElementService} must override this method with their own specific logic. * * @param {*} element - the element to be checked * @return {boolean} true if element is a canvas; otherwise false. * @public * @abstract * @memberof ElementService# */ isCanvas: function(element) {}, /** * Returns whether the specified element is an image. * * Implementations of {@link ElementService} must override this method with their own specific logic. * * @param {*} element - the element to be checked * @return {boolean} true if element is an image; otherwise false. * @public * @abstract * @memberof ElementService# */ isImage: function(element) {} }); var ElementService_1 = ElementService; /** * An implementation of {@link ElementService} intended for use within a browser environment. * * @public * @class * @extends ElementService */ var BrowserElementService = ElementService_1.extend({ /** * @override */ createCanvas: function() { return document.createElement('canvas'); }, /** * @override */ createImage: function() { return document.createElement('img'); }, /** * @override */ isCanvas: function(element) { return element instanceof HTMLCanvasElement; }, /** * @override */ isImage: function(element) { return element instanceof HTMLImageElement; } }); var BrowserElementService_1 = BrowserElementService; index.use(new BrowserElementService_1()); var QRious_1 = index; return QRious_1; })));