kfb-view 3.0.8 → 3.0.9

package/src/plugin/openseadragon/openseadragon.js

@@ -1,6 +1,6 @@
-//! openseadragon 4.0.0
-//! Built on 2022-12-16
-//! Git commit: v4.0.0-0-8e6196a
+//! openseadragon 4.1.0
+//! Built on 2023-05-25
+//! Git commit: v4.1.0-0-8849681
 //! http://openseadragon.github.io
 //! License: http://openseadragon.github.io/license/
 
@@ -87,14 +87,16 @@
  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
 
+
 /**
  * @namespace OpenSeadragon
- * @version openseadragon 4.0.0
+ * @version openseadragon 4.1.0
  * @classdesc The root namespace for OpenSeadragon.  All utility methods
  * and classes are defined on or below this namespace.
  *
  */
 
+
 // Typedefs
 
 /**
@@ -499,6 +501,12 @@
  * @property {Number} [timeout=30000]
  *     The max number of milliseconds that an image job may take to complete.
  *
+ * @property {Number} [tileRetryMax=0]
+ *     The max number of retries when a tile download fails. By default it's 0, so retries are disabled.
+ *
+ * @property {Number} [tileRetryDelay=2500]
+ *     Milliseconds to wait after each tile retry if tileRetryMax is set.
+ *
  * @property {Boolean} [useCanvas=true]
  *     Set to false to not use an HTML canvas element for image rendering even if canvas is supported.
  *
@@ -563,50 +571,50 @@
  *     viewing the first image and the 'next' button will wrap to the first
  *     image when viewing the last image.
  *
- * @property {String} zoomInButton
- *     Set the id of the custom 'Zoom in' button to use.
+ *@property {String|Element} zoomInButton
+ *     Set the id or element of the custom 'Zoom in' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} zoomOutButton
- *     Set the id of the custom 'Zoom out' button to use.
+ * @property {String|Element} zoomOutButton
+ *     Set the id or element of the custom 'Zoom out' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} homeButton
- *     Set the id of the custom 'Go home' button to use.
+ * @property {String|Element} homeButton
+ *     Set the id or element of the custom 'Go home' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} fullPageButton
- *     Set the id of the custom 'Toggle full page' button to use.
+ * @property {String|Element} fullPageButton
+ *     Set the id or element of the custom 'Toggle full page' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} rotateLeftButton
- *     Set the id of the custom 'Rotate left' button to use.
+ * @property {String|Element} rotateLeftButton
+ *     Set the id or element of the custom 'Rotate left' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} rotateRightButton
- *     Set the id of the custom 'Rotate right' button to use.
+ * @property {String|Element} rotateRightButton
+ *     Set the id or element of the custom 'Rotate right' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} previousButton
- *     Set the id of the custom 'Previous page' button to use.
+ * @property {String|Element} previousButton
+ *     Set the id or element of the custom 'Previous page' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
  *
- * @property {String} nextButton
- *     Set the id of the custom 'Next page' button to use.
+ * @property {String|Element} nextButton
+ *     Set the id or element of the custom 'Next page' button to use.
  *     This is useful to have a custom button anywhere in the web page.<br>
  *     To only change the button images, consider using
  *     {@link OpenSeadragon.Options.navImages}
@@ -805,6 +813,7 @@ function OpenSeadragon(options) {
 
 (function($) {
 
+
   /**
    * The OpenSeadragon version.
    *
@@ -816,12 +825,13 @@ function OpenSeadragon(options) {
    * @since 1.0.0
    */
   $.version = {
-    versionStr: '4.0.0',
+    versionStr: '4.1.0',
     major: parseInt('4', 10),
-    minor: parseInt('0', 10),
+    minor: parseInt('1', 10),
     revision: parseInt('0', 10),
   };
 
+
   /**
    * Taken from jquery 1.6.1
    * [[Class]] -> type pairs
@@ -832,6 +842,8 @@ function OpenSeadragon(options) {
       '[object Number]': 'number',
       '[object String]': 'string',
       '[object Function]': 'function',
+      '[object AsyncFunction]': 'function',
+      '[object Promise]': 'promise',
       '[object Array]': 'array',
       '[object Date]': 'date',
       '[object RegExp]': 'regexp',
@@ -861,6 +873,7 @@ function OpenSeadragon(options) {
     return $.type(obj) === 'array';
   };
 
+
   /**
    * A crude way of determining if an object is a window.
    * Taken from jQuery 1.6.1
@@ -872,6 +885,7 @@ function OpenSeadragon(options) {
     return obj && typeof obj === 'object' && 'setInterval' in obj;
   };
 
+
   /**
    * Taken from jQuery 1.6.1
    * @function type
@@ -884,6 +898,7 @@ function OpenSeadragon(options) {
       class2type[toString.call(obj)] || 'object';
   };
 
+
   /**
    * Taken from jQuery 1.6.1
    * @function isPlainObject
@@ -917,6 +932,7 @@ function OpenSeadragon(options) {
     return lastKey === undefined || hasOwn.call(obj, lastKey);
   };
 
+
   /**
    * Taken from jQuery 1.6.1
    * @function isEmptyObject
@@ -1355,6 +1371,8 @@ function OpenSeadragon(options) {
       maxImageCacheCount: 200,
       timeout: 30000,
       useCanvas: true,  // Use canvas element for drawing if available
+      tileRetryMax: 0,
+      tileRetryDelay: 2500,
 
       //INTERFACE RESOURCE SETTINGS
       prefixUrl: '/images/',
@@ -1431,6 +1449,7 @@ function OpenSeadragon(options) {
 
     },
 
+
     /**
      * TODO: get rid of this.  I can't see how it's required at all.  Looks
      *       like an early legacy code artifact.
@@ -1439,6 +1458,7 @@ function OpenSeadragon(options) {
      */
     SIGNAL: '----seadragon----',
 
+
     /**
      * Returns a function which invokes the method as if it were a method belonging to the object.
      * @function
@@ -1456,6 +1476,7 @@ function OpenSeadragon(options) {
       };
     },
 
+
     /**
      * An enumeration of Browser vendors.
      * @static
@@ -1528,6 +1549,7 @@ function OpenSeadragon(options) {
       return element;
     },
 
+
     /**
      * Determines the position of the upper-left corner of the element.
      * @function
@@ -1560,6 +1582,7 @@ function OpenSeadragon(options) {
       return result;
     },
 
+
     /**
      * Determines the position of the upper-left corner of the element adjusted for current page and/or element scroll.
      * @function
@@ -1598,6 +1621,7 @@ function OpenSeadragon(options) {
       );
     },
 
+
     /**
      * Determines the height and width of the given element.
      * @function
@@ -1613,6 +1637,7 @@ function OpenSeadragon(options) {
       );
     },
 
+
     /**
      * Returns the CSSStyle object for the given element.
      * @function
@@ -1690,6 +1715,7 @@ function OpenSeadragon(options) {
       return result;
     },
 
+
     /**
      * Determines if a point is within the bounding rectangle of the given element (hit-test).
      * @function
@@ -1705,6 +1731,7 @@ function OpenSeadragon(options) {
         offset.y + size.y && point.y >= offset.y;
     },
 
+
     /**
      * Gets the position of the mouse on the screen for a given event.
      * @function
@@ -1746,6 +1773,7 @@ function OpenSeadragon(options) {
       return $.getMousePosition(event);
     },
 
+
     /**
      * Determines the page's current scroll position.
      * @function
@@ -1872,6 +1900,7 @@ function OpenSeadragon(options) {
       return $.getWindowSize();
     },
 
+
     /**
      * Wraps the given element in a nest of divs so that the element can
      * be easily centered using CSS tables
@@ -1918,6 +1947,7 @@ function OpenSeadragon(options) {
       return wrappers[0];
     },
 
+
     /**
      * Creates an easily positionable element of the given type that therefor
      * serves as an excellent container element.
@@ -1938,6 +1968,7 @@ function OpenSeadragon(options) {
       return element;
     },
 
+
     /**
      * Returns the current milliseconds, using Date.now() if available
      * @function
@@ -1954,6 +1985,7 @@ function OpenSeadragon(options) {
       return $.now();
     },
 
+
     /**
      * Ensures an image is loaded correctly to support alpha transparency.
      * @function
@@ -1968,6 +2000,7 @@ function OpenSeadragon(options) {
       return img;
     },
 
+
     /**
      * Sets the opacity of the specified element.
      * @function
@@ -1999,6 +2032,7 @@ function OpenSeadragon(options) {
       }
     },
 
+
     /**
      * Sets the specified element's touch-action style attribute to 'none'.
      * @function
@@ -2013,6 +2047,7 @@ function OpenSeadragon(options) {
       }
     },
 
+
     /**
      * Sets the specified element's pointer-events style attribute to the passed value.
      * @function
@@ -2027,6 +2062,7 @@ function OpenSeadragon(options) {
       }
     },
 
+
     /**
      * Sets the specified element's pointer-events style attribute to 'none'.
      * @function
@@ -2036,6 +2072,7 @@ function OpenSeadragon(options) {
       $.setElementPointerEvents(element, 'none');
     },
 
+
     /**
      * Add the specified CSS class to the element if not present.
      * @function
@@ -2180,6 +2217,7 @@ function OpenSeadragon(options) {
       }
     }()),
 
+
     /**
      * Remove a given event listener for the given element, event type and
      * handler.
@@ -2207,6 +2245,7 @@ function OpenSeadragon(options) {
       }
     }()),
 
+
     /**
      * Cancels the default browser behavior had the event propagated all
      * the way up the DOM to the window object.
@@ -2217,6 +2256,7 @@ function OpenSeadragon(options) {
       event.preventDefault();
     },
 
+
     /**
      * Returns true if {@link OpenSeadragon.cancelEvent|cancelEvent} has been called on
      * the event, otherwise returns false.
@@ -2227,6 +2267,7 @@ function OpenSeadragon(options) {
       return event.defaultPrevented;
     },
 
+
     /**
      * Stops the propagation of the event through the DOM in the capturing and bubbling phases.
      * @function
@@ -2236,6 +2277,7 @@ function OpenSeadragon(options) {
       event.stopPropagation();
     },
 
+
     /**
      * Similar to OpenSeadragon.delegate, but it does not immediately call
      * the method on the object, returning a function which can be called
@@ -2271,6 +2313,7 @@ function OpenSeadragon(options) {
       };
     },
 
+
     /**
      * Retrieves the value of a url parameter from the window.location string.
      * @function
@@ -2521,6 +2564,7 @@ function OpenSeadragon(options) {
 
     },
 
+
     /**
      * Fully deprecated. Will throw an error.
      * @function
@@ -2617,6 +2661,7 @@ function OpenSeadragon(options) {
 
   });
 
+
   //TODO: $.console is often used inside a try/catch block which generally
   //      prevents allowings errors to occur with detection until a debugger
   //      is attached.  Although I've been guilty of the same anti-pattern
@@ -2641,6 +2686,7 @@ function OpenSeadragon(options) {
     assert: nullfunction,
   };
 
+
   /**
    * The current browser vendor, version, and related information regarding detected features.
    * @member {Object} Browser
@@ -2657,6 +2703,7 @@ function OpenSeadragon(options) {
     alpha: true,
   };
 
+
   var FILEFORMATS = {
       bmp: false,
       jpeg: true,
@@ -2770,6 +2817,7 @@ function OpenSeadragon(options) {
     }
   })();
 
+
   // Adding support for HTML5's requestAnimationFrame as suggested by acdha.
   // Implementation taken from matt synder's post here:
   // http://mattsnider.com/cross-browser-and-legacy-supported-requestframeanimation/
@@ -2874,6 +2922,7 @@ function OpenSeadragon(options) {
 
 }(OpenSeadragon));
 
+
 // Universal Module Definition, supports CommonJS, AMD and simple script tag
 (function(root, factory) {
   if (typeof define === 'function' && define.amd) {
@@ -3088,6 +3137,7 @@ function OpenSeadragon(options) {
    * @param {Object} event - See individual events for event-specific properties.
    */
 
+
   /**
    * @class EventSource
    * @classdesc For use by classes which want to support custom, non-browser events.
@@ -3103,7 +3153,7 @@ function OpenSeadragon(options) {
 
     /**
      * Add an event handler to be triggered only once (or a given number of times)
-     * for a given event.
+     * for a given event. It is not removable with removeHandler().
      * @function
      * @param {String} eventName - Name of event to register.
      * @param {OpenSeadragon.EventHandler} handler - Function to call when event
@@ -3112,8 +3162,9 @@ function OpenSeadragon(options) {
      * to the handler.
      * @param {Number} [times=1] - The number of times to handle the event
      * before removing it.
+     * @param {Number} [priority=0] - Handler priority. By default, all priorities are 0. Higher number = priority.
      */
-    addOnceHandler: function(eventName, handler, userData, times) {
+    addOnceHandler: function(eventName, handler, userData, times, priority) {
       var self = this;
       times = times || 1;
       var count = 0;
@@ -3122,9 +3173,9 @@ function OpenSeadragon(options) {
         if (count === times) {
           self.removeHandler(eventName, onceHandler);
         }
-        handler(event);
+        return handler(event);
       };
-      this.addHandler(eventName, onceHandler, userData);
+      this.addHandler(eventName, onceHandler, userData, priority);
     },
 
     /**
@@ -3133,14 +3184,27 @@ function OpenSeadragon(options) {
      * @param {String} eventName - Name of event to register.
      * @param {OpenSeadragon.EventHandler} handler - Function to call when event is triggered.
      * @param {Object} [userData=null] - Arbitrary object to be passed unchanged to the handler.
+     * @param {Number} [priority=0] - Handler priority. By default, all priorities are 0. Higher number = priority.
      */
-    addHandler: function(eventName, handler, userData) {
+    addHandler: function(eventName, handler, userData, priority) {
       var events = this.events[eventName];
       if (!events) {
         this.events[eventName] = events = [];
       }
       if (handler && $.isFunction(handler)) {
-        events[events.length] = {handler: handler, userData: userData || null};
+        var index = events.length,
+          event = {
+            handler: handler,
+            userData: userData || null,
+            priority: priority || 0,
+          };
+        events[index] = event;
+        while (index > 0 && events[index - 1].priority <
+        events[index].priority) {
+          events[index] = events[index - 1];
+          events[index - 1] = event;
+          index--;
+        }
       }
     },
 
@@ -3231,15 +3295,12 @@ function OpenSeadragon(options) {
     raiseEvent: function(eventName, eventArgs) {
       //uncomment if you want to get a log of all events
       //$.console.log( eventName );
-      var handler = this.getHandler(eventName);
 
+      var handler = this.getHandler(eventName);
       if (handler) {
-        if (!eventArgs) {
-          eventArgs = {};
-        }
-
-        handler(this, eventArgs);
+        return handler(this, eventArgs || {});
       }
+      return undefined;
     },
   };
 
@@ -3287,6 +3348,7 @@ function OpenSeadragon(options) {
   // dictionary from hash to private properties
   var THIS = {};
 
+
   /**
    * @class MouseTracker
    * @classdesc Provides simplified handling of common pointer device (mouse, touch, pen, etc.) gestures
@@ -4458,6 +4520,7 @@ function OpenSeadragon(options) {
     };
   })();
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Pointer event model and feature detection
 ///////////////////////////////////////////////////////////////////////////////
@@ -4539,6 +4602,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Classes and typedefs
 ///////////////////////////////////////////////////////////////////////////////
@@ -4586,6 +4650,7 @@ function OpenSeadragon(options) {
    *      Arbitrary user-defined object.
    */
 
+
   /**
    * Represents a point of contact on the screen made by a mouse cursor, pen, touch, or other pointer device.
    *
@@ -4622,6 +4687,7 @@ function OpenSeadragon(options) {
    *     The current pointer contact time, in milliseconds.
    */
 
+
   /**
    * @class GesturePointList
    * @classdesc Provides an abstraction for a set of active {@link OpenSeadragon.MouseTracker.GesturePoint|GesturePoint} objects for a given pointer device type.
@@ -4776,6 +4842,7 @@ function OpenSeadragon(options) {
     },
   };
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Utility functions
 ///////////////////////////////////////////////////////////////////////////////
@@ -4965,6 +5032,7 @@ function OpenSeadragon(options) {
     updatePointerCaptured(tracker, gPoint, true);
   }
 
+
   /**
    * Stop capturing pointer events to the tracked element.
    * @private
@@ -5026,6 +5094,7 @@ function OpenSeadragon(options) {
     updatePointerCaptured(tracker, gPoint, false);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5038,6 +5107,7 @@ function OpenSeadragon(options) {
       $.MouseTracker.mousePointerId;
   }
 
+
   /**
    * Gets a W3C Pointer Events model compatible pointer type string from a DOM pointer event.
    * IE10 used a long integer value, but the W3C specification (and IE11+) use a string "mouse", "touch", "pen", etc.
@@ -5059,6 +5129,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5069,6 +5140,7 @@ function OpenSeadragon(options) {
     return ($.MouseTracker.havePointerEvents) ? event.isPrimary : true;
   }
 
+
   /**
    * @private
    * @inner
@@ -5102,6 +5174,7 @@ function OpenSeadragon(options) {
     return new $.Point((point1.x + point2.x) / 2, (point1.y + point2.y) / 2);
   }
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Device-specific DOM event handlers
 ///////////////////////////////////////////////////////////////////////////////
@@ -5129,6 +5202,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5152,6 +5226,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5194,6 +5269,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5237,6 +5313,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5280,6 +5357,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5309,6 +5387,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5338,6 +5417,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5379,6 +5459,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Handler for 'wheel' events
    *
@@ -5389,6 +5470,7 @@ function OpenSeadragon(options) {
     handleWheelEvent(tracker, event, event);
   }
 
+
   /**
    * Handler for 'mousewheel', 'DOMMouseScroll', and 'MozMousePixelScroll' events
    *
@@ -5421,6 +5503,7 @@ function OpenSeadragon(options) {
     handleWheelEvent(tracker, simulatedEvent, event);
   }
 
+
   /**
    * Handles 'wheel' events.
    * The event may be simulated by the legacy mouse wheel event handler (onMouseWheel()).
@@ -5463,6 +5546,7 @@ function OpenSeadragon(options) {
         userData: tracker.userData,
       };
 
+
       tracker.scrollHandler(eventArgs);
     }
 
@@ -5475,6 +5559,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * TODO Never actually seen this event fired, and documentation is tough to find
    * @private
@@ -5505,6 +5590,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5559,6 +5645,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5605,6 +5692,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5644,6 +5732,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5678,6 +5767,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5689,6 +5779,7 @@ function OpenSeadragon(options) {
     return false;
   }
 
+
   /**
    * @private
    * @inner
@@ -5700,6 +5791,7 @@ function OpenSeadragon(options) {
     return false;
   }
 
+
   /**
    * @private
    * @inner
@@ -5728,6 +5820,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -5756,6 +5849,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5788,6 +5882,7 @@ function OpenSeadragon(options) {
     updatePointerEnter(tracker, eventInfo, gPoint);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5820,6 +5915,7 @@ function OpenSeadragon(options) {
     updatePointerLeave(tracker, eventInfo, gPoint);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5856,6 +5952,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5892,6 +5989,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5946,6 +6044,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5957,6 +6056,7 @@ function OpenSeadragon(options) {
     handlePointerUp(tracker, event);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -5975,6 +6075,7 @@ function OpenSeadragon(options) {
     $.stopEvent(event);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -6024,6 +6125,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -6035,6 +6137,7 @@ function OpenSeadragon(options) {
     handlePointerMove(tracker, event);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -6053,6 +6156,7 @@ function OpenSeadragon(options) {
     $.stopEvent(event);
   }
 
+
   /**
    * Note: Called for both pointer events and legacy mouse events
    *         ($.MouseTracker.havePointerEvents determines which)
@@ -6089,6 +6193,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -6117,6 +6222,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Device-agnostic DOM event handlers
 ///////////////////////////////////////////////////////////////////////////////
@@ -6143,6 +6249,7 @@ function OpenSeadragon(options) {
     return pointsList.add(gPoint);
   }
 
+
   /**
    * @function
    * @private
@@ -6180,6 +6287,7 @@ function OpenSeadragon(options) {
     return listLength;
   }
 
+
   /**
    * @function
    * @private
@@ -6264,6 +6372,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Sets up for and calls preProcessEventHandler. Call with the following parameters -
    * this function will fill in the rest of the preProcessEventHandler event object
@@ -6297,6 +6406,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Sets or resets the captured property on the tracked pointer matching the passed gPoint's id/type
    *
@@ -6332,6 +6442,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @function
    * @private
@@ -6386,6 +6497,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @function
    * @private
@@ -6450,6 +6562,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @function
    * @private
@@ -6542,6 +6655,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @function
    * @private
@@ -6687,6 +6801,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @function
    * @private
@@ -6947,6 +7062,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * Call when pointer(s) change coordinates, button state, pressure, tilt, or contact geometry (e.g. width and height)
    *
@@ -7106,6 +7222,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @function
    * @private
@@ -7128,6 +7245,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -7514,6 +7632,7 @@ function OpenSeadragon(options) {
       element.style.display = 'inline-block';
     },
 
+
     /**
      * @function
      * @returns {OpenSeadragon.ControlDock} Chainable.
@@ -7542,6 +7661,7 @@ function OpenSeadragon(options) {
       return this;
     },
 
+
     /**
      * @function
      * @returns {Boolean}
@@ -7558,6 +7678,7 @@ function OpenSeadragon(options) {
       return false;
     },
 
+
     /**
      * @function
      * @returns {OpenSeadragon.ControlDock} Chainable.
@@ -7574,6 +7695,7 @@ function OpenSeadragon(options) {
 
   };
 
+
   ///////////////////////////////////////////////////////////////////////////////
   // Utility methods
   ///////////////////////////////////////////////////////////////////////////////
@@ -7801,6 +7923,7 @@ function OpenSeadragon(options) {
       _this = this,
       i;
 
+
     //backward compatibility for positional args while preferring more
     //idiomatic javascript options object as the only argument
     if (!$.isPlainObject(options)) {
@@ -8044,6 +8167,8 @@ function OpenSeadragon(options) {
       nonPrimaryReleaseHandler: $.delegate(this, onCanvasNonPrimaryRelease),
       scrollHandler: $.delegate(this, onCanvasScroll),
       pinchHandler: $.delegate(this, onCanvasPinch),
+      focusHandler: $.delegate(this, onCanvasFocus),
+      blurHandler: $.delegate(this, onCanvasBlur),
     });
 
     this.outerTracker = new $.MouseTracker({
@@ -8145,6 +8270,8 @@ function OpenSeadragon(options) {
     this.imageLoader = new $.ImageLoader({
       jobLimit: this.imageLoaderLimit,
       timeout: options.timeout,
+      tileRetryMax: this.tileRetryMax,
+      tileRetryDelay: this.tileRetryDelay,
     });
 
     // Create the tile cache
@@ -8243,6 +8370,7 @@ function OpenSeadragon(options) {
   $.extend($.Viewer.prototype, $.EventSource.prototype, $.ControlDock.prototype, /** @lends OpenSeadragon.Viewer.prototype */
     {
 
+
       /**
        * @function
        * @returns {Boolean}
@@ -8458,6 +8586,7 @@ function OpenSeadragon(options) {
         return this;
       },
 
+
       /**
        * @function
        * @returns {OpenSeadragon.Viewer} Chainable.
@@ -8499,6 +8628,7 @@ function OpenSeadragon(options) {
         return this;
       },
 
+
       /**
        * Function to destroy the viewer and clean up everything created by OpenSeadragon.
        *
@@ -8567,6 +8697,7 @@ function OpenSeadragon(options) {
           this.navigator = null;
         }
 
+
         if (this.buttonGroup) {
           this.buttonGroup.destroy();
         } else if (this.customButtons) {
@@ -8657,6 +8788,7 @@ function OpenSeadragon(options) {
         return this;
       },
 
+
       /**
        * @function
        * @returns {Boolean}
@@ -8670,6 +8802,7 @@ function OpenSeadragon(options) {
         return enabled;
       },
 
+
       /**
        * Shows or hides the controls (e.g. the default navigation buttons).
        *
@@ -8702,7 +8835,7 @@ function OpenSeadragon(options) {
        * Turns debugging mode on or off for this viewer.
        *
        * @function
-       * @param {Boolean} true to turn debug on, false to turn debug off.
+       * @param {Boolean} debugMode true to turn debug on, false to turn debug off.
        */
       setDebugMode: function(debugMode) {
 
@@ -8714,6 +8847,65 @@ function OpenSeadragon(options) {
         this.forceRedraw();
       },
 
+      /**
+       * Update headers to include when making AJAX requests.
+       *
+       * Unless `propagate` is set to false (which is likely only useful in rare circumstances),
+       * the updated headers are propagated to all tiled images, each of which will subsequently
+       * propagate the changed headers to all their tiles.
+       * If applicable, the headers of the viewer's navigator and reference strip will also be updated.
+       *
+       * Note that the rules for merging headers still apply, i.e. headers returned by
+       * {@link OpenSeadragon.TileSource#getTileAjaxHeaders} take precedence over
+       * `TiledImage.ajaxHeaders`, which take precedence over the headers here in the viewer.
+       *
+       * @function
+       * @param {Object} ajaxHeaders Updated AJAX headers.
+       * @param {Boolean} [propagate=true] Whether to propagate updated headers to tiled images, etc.
+       */
+      setAjaxHeaders: function(ajaxHeaders, propagate) {
+        if (ajaxHeaders === null) {
+          ajaxHeaders = {};
+        }
+        if (!$.isPlainObject(ajaxHeaders)) {
+          console.error(
+            '[Viewer.setAjaxHeaders] Ignoring invalid headers, must be a plain object');
+          return;
+        }
+        if (propagate === undefined) {
+          propagate = true;
+        }
+
+        this.ajaxHeaders = ajaxHeaders;
+
+        if (propagate) {
+          for (var i = 0; i < this.world.getItemCount(); i++) {
+            this.world.getItemAt(i)._updateAjaxHeaders(true);
+          }
+
+          if (this.navigator) {
+            this.navigator.setAjaxHeaders(this.ajaxHeaders, true);
+          }
+
+          if (this.referenceStrip && this.referenceStrip.miniViewers) {
+            for (var key in this.referenceStrip.miniViewers) {
+              this.referenceStrip.miniViewers[key].setAjaxHeaders(
+                this.ajaxHeaders, true);
+            }
+          }
+        }
+      },
+
+      /**
+       * Adds the given button to this viewer.
+       *
+       * @function
+       * @param {OpenSeadragon.Button} button
+       */
+      addButton: function(button) {
+        this.buttonGroup.addButton(button);
+      },
+
       /**
        * @function
        * @returns {Boolean}
@@ -8722,6 +8914,7 @@ function OpenSeadragon(options) {
         return THIS[this.hash].fullPage;
       },
 
+
       /**
        * Toggle full page mode.
        * @function
@@ -9046,6 +9239,7 @@ function OpenSeadragon(options) {
         return this.container.style.visibility !== 'hidden';
       },
 
+
       //
       /**
        * @function
@@ -9129,7 +9323,6 @@ function OpenSeadragon(options) {
        *      A set of headers to include when making tile AJAX requests.
        *      Note that these headers will be merged over any headers specified in {@link OpenSeadragon.Options}.
        *      Specifying a falsy value for a header will clear its existing value set at the Viewer level (if any).
-       * requests.
        * @param {Function} [options.success] A function that gets called when the image is
        * successfully added. It's passed the event object which contains a single property:
        * "item", which is the resulting instance of TiledImage.
@@ -9182,12 +9375,8 @@ function OpenSeadragon(options) {
         if (options.loadTilesWithAjax === undefined) {
           options.loadTilesWithAjax = this.loadTilesWithAjax;
         }
-        if (options.ajaxHeaders === undefined || options.ajaxHeaders === null) {
-          options.ajaxHeaders = this.ajaxHeaders;
-        } else if ($.isPlainObject(options.ajaxHeaders) &&
-          $.isPlainObject(this.ajaxHeaders)) {
-          options.ajaxHeaders = $.extend({}, this.ajaxHeaders,
-            options.ajaxHeaders);
+        if (!$.isPlainObject(options.ajaxHeaders)) {
+          options.ajaxHeaders = {};
         }
 
         var myQueueItem = {
@@ -9555,6 +9744,7 @@ function OpenSeadragon(options) {
         return this;
       },
 
+
       /**
        * @function
        * @returns {OpenSeadragon.Viewer} Chainable.
@@ -9579,6 +9769,7 @@ function OpenSeadragon(options) {
           buttons = [],
           useGroup = true;
 
+
         if (this.showNavigationControl) {
 
           if (this.zoomInButton || this.zoomOutButton ||
@@ -10205,6 +10396,7 @@ function OpenSeadragon(options) {
       },
     });
 
+
   /**
    * _getSafeElemSize is like getElementSize(), but refuses to return 0 for x or y,
    * which was causing some calling operations to return NaN.
@@ -10220,6 +10412,7 @@ function OpenSeadragon(options) {
     );
   }
 
+
   /**
    * @function
    * @private
@@ -10409,6 +10602,7 @@ function OpenSeadragon(options) {
     });
   }
 
+
 //provides a sequence in the fade animation
   function scheduleControlsFade(viewer) {
     $.requestAnimationFrame(function() {
@@ -10416,6 +10610,7 @@ function OpenSeadragon(options) {
     });
   }
 
+
 //initiates an animation to hide the controls
   function beginControlsAutoHide(viewer) {
     if (!viewer.autoHideControls) {
@@ -10431,6 +10626,7 @@ function OpenSeadragon(options) {
     }, viewer.controlsFadeDelay);
   }
 
+
 //determines if fade animation is done or continues the animation
   function updateControlsFade(viewer) {
     var currentTime,
@@ -10458,6 +10654,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
 //stop the fade animation on the controls and show them
   function abortControlsAutoHide(viewer) {
     var i;
@@ -10467,6 +10664,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Default view event handlers.
 ///////////////////////////////////////////////////////////////////////////////
@@ -10532,7 +10730,7 @@ function OpenSeadragon(options) {
     if (!canvasKeyDownEventArgs.preventDefaultAction && !event.ctrl &&
       !event.alt && !event.meta) {
       switch (event.keyCode) {
-        case 38://up arrow
+        case 38://up arrow/shift uparrow
           if (!canvasKeyDownEventArgs.preventVerticalPan) {
             if (event.shift) {
               this.viewport.zoomBy(1.1);
@@ -10544,7 +10742,7 @@ function OpenSeadragon(options) {
           }
           event.preventDefault = true;
           break;
-        case 40://down arrow
+        case 40://down arrow/shift downarrow
           if (!canvasKeyDownEventArgs.preventVerticalPan) {
             if (event.shift) {
               this.viewport.zoomBy(0.9);
@@ -10572,37 +10770,12 @@ function OpenSeadragon(options) {
           }
           event.preventDefault = true;
           break;
-        default:
-          //console.log( 'navigator keycode %s', event.keyCode );
-          event.preventDefault = false;
-          break;
-      }
-    } else {
-      event.preventDefault = false;
-    }
-  }
-
-  function onCanvasKeyPress(event) {
-    var canvasKeyPressEventArgs = {
-      originalEvent: event.originalEvent,
-      preventDefaultAction: false,
-      preventVerticalPan: event.preventVerticalPan || !this.panVertical,
-      preventHorizontalPan: event.preventHorizontalPan || !this.panHorizontal,
-    };
-
-    // This event is documented in onCanvasKeyDown
-    this.raiseEvent('canvas-key', canvasKeyPressEventArgs);
-
-    if (!canvasKeyPressEventArgs.preventDefaultAction && !event.ctrl &&
-      !event.alt && !event.meta) {
-      switch (event.keyCode) {
-        case 43://=|+
-        case 61://=|+
+        case 187://=|+
           this.viewport.zoomBy(1.1);
           this.viewport.applyConstraints();
           event.preventDefault = true;
           break;
-        case 45://-|_
+        case 189://-|_
           this.viewport.zoomBy(0.9);
           this.viewport.applyConstraints();
           event.preventDefault = true;
@@ -10612,9 +10785,8 @@ function OpenSeadragon(options) {
           this.viewport.applyConstraints();
           event.preventDefault = true;
           break;
-        case 119://w
-        case 87://W
-          if (!canvasKeyPressEventArgs.preventVerticalPan) {
+        case 87://W/w
+          if (!canvasKeyDownEventArgs.preventVerticalPan) {
             if (event.shift) {
               this.viewport.zoomBy(1.1);
             } else {
@@ -10625,9 +10797,8 @@ function OpenSeadragon(options) {
           }
           event.preventDefault = true;
           break;
-        case 115://s
-        case 83://S
-          if (!canvasKeyPressEventArgs.preventVerticalPan) {
+        case 83://S/s
+          if (!canvasKeyDownEventArgs.preventVerticalPan) {
             if (event.shift) {
               this.viewport.zoomBy(0.9);
             } else {
@@ -10638,56 +10809,55 @@ function OpenSeadragon(options) {
           }
           event.preventDefault = true;
           break;
-        case 97://a
-          if (!canvasKeyPressEventArgs.preventHorizontalPan) {
+        case 65://a/A
+          if (!canvasKeyDownEventArgs.preventHorizontalPan) {
             this.viewport.panBy(
               this.viewport.deltaPointsFromPixels(new $.Point(-40, 0)));
             this.viewport.applyConstraints();
           }
           event.preventDefault = true;
           break;
-        case 100://d
-          if (!canvasKeyPressEventArgs.preventHorizontalPan) {
+        case 68://d/D
+          if (!canvasKeyDownEventArgs.preventHorizontalPan) {
             this.viewport.panBy(
               this.viewport.deltaPointsFromPixels(new $.Point(40, 0)));
             this.viewport.applyConstraints();
           }
           event.preventDefault = true;
           break;
-        case 114: //r - clockwise rotation
-          if (this.viewport.flipped) {
-            this.viewport.setRotation(
-              this.viewport.getRotation() - this.rotationIncrement);
-          } else {
-            this.viewport.setRotation(
-              this.viewport.getRotation() + this.rotationIncrement);
-          }
-          this.viewport.applyConstraints();
-          event.preventDefault = true;
-          break;
-        case 82: //R - counterclockwise  rotation
-          if (this.viewport.flipped) {
-            this.viewport.setRotation(
-              this.viewport.getRotation() + this.rotationIncrement);
+        case 82: //r - clockwise rotation/R - counterclockwise rotation
+          if (event.shift) {
+            if (this.viewport.flipped) {
+              this.viewport.setRotation(
+                this.viewport.getRotation() + this.rotationIncrement);
+            } else {
+              this.viewport.setRotation(
+                this.viewport.getRotation() - this.rotationIncrement);
+            }
           } else {
-            this.viewport.setRotation(
-              this.viewport.getRotation() - this.rotationIncrement);
+            if (this.viewport.flipped) {
+              this.viewport.setRotation(
+                this.viewport.getRotation() - this.rotationIncrement);
+            } else {
+              this.viewport.setRotation(
+                this.viewport.getRotation() + this.rotationIncrement);
+            }
           }
           this.viewport.applyConstraints();
           event.preventDefault = true;
           break;
-        case 102: //f
+        case 70: //f/F
           this.viewport.toggleFlip();
           event.preventDefault = true;
           break;
-        case 106: //j - previous image source
+        case 74: //j - previous image source
           this.goToPreviousPage();
           break;
-        case 107: //k - next image source
+        case 75: //k - next image source
           this.goToNextPage();
           break;
         default:
-          // console.log( 'navigator keycode %s', event.keyCode );
+          //console.log( 'navigator keycode %s', event.keyCode );
           event.preventDefault = false;
           break;
       }
@@ -10696,6 +10866,25 @@ function OpenSeadragon(options) {
     }
   }
 
+  function onCanvasKeyPress(event) {
+    var canvasKeyPressEventArgs = {
+      originalEvent: event.originalEvent,
+    };
+
+    /**
+     * Raised when a keyboard key is pressed and the focus is on the {@link OpenSeadragon.Viewer#canvas} element.
+     *
+     * @event canvas-key-press
+     * @memberof OpenSeadragon.Viewer
+     * @type {object}
+     * @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
+     * @property {Object} originalEvent - The original DOM event.
+     * @property {?Object} userData - Arbitrary subscriber-defined object.
+     */
+
+    this.raiseEvent('canvas-key-press', canvasKeyPressEventArgs);
+  }
+
   function onCanvasClick(event) {
     var gestureSettings;
 
@@ -10738,6 +10927,7 @@ function OpenSeadragon(options) {
 
     this.raiseEvent('canvas-click', canvasClickEventArgs);
 
+
     if (!canvasClickEventArgs.preventDefaultAction && this.viewport &&
       event.quick) {
       gestureSettings = this.gestureSettingsByDeviceType(event.pointerType);
@@ -10944,11 +11134,13 @@ function OpenSeadragon(options) {
       this.viewport.applyConstraints();
     }
 
+
     if (gestureSettings.dblClickDragToZoom && THIS[this.hash].draggingToZoom ===
       true) {
       THIS[this.hash].draggingToZoom = false;
     }
 
+
   }
 
   function onCanvasEnter(event) {
@@ -11038,6 +11230,7 @@ function OpenSeadragon(options) {
       originalEvent: event.originalEvent,
     });
 
+
     gestureSettings = this.gestureSettingsByDeviceType(event.pointerType);
     if (gestureSettings.dblClickDragToZoom) {
       var lastClickTime = THIS[this.hash].lastClickTime;
@@ -11216,12 +11409,50 @@ function OpenSeadragon(options) {
         var angle2 = Math.atan2(
           event.gesturePoints[0].lastPos.y - event.gesturePoints[1].lastPos.y,
           event.gesturePoints[0].lastPos.x - event.gesturePoints[1].lastPos.x);
-        this.viewport.setRotation(
-          this.viewport.getRotation() + ((angle1 - angle2) * (180 / Math.PI)));
+        centerPt = this.viewport.pointFromPixel(event.center, true);
+        this.viewport.rotateTo(this.viewport.getRotation(true) +
+          ((angle1 - angle2) * (180 / Math.PI)), centerPt, true);
       }
     }
   }
 
+  function onCanvasFocus(event) {
+
+    /**
+     * Raised when the {@link OpenSeadragon.Viewer#canvas} element gets keyboard focus.
+     *
+     * @event canvas-focus
+     * @memberof OpenSeadragon.Viewer
+     * @type {object}
+     * @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
+     * @property {OpenSeadragon.MouseTracker} tracker - A reference to the MouseTracker which originated this event.
+     * @property {Object} originalEvent - The original DOM event.
+     * @property {?Object} userData - Arbitrary subscriber-defined object.
+     */
+    this.raiseEvent('canvas-focus', {
+      tracker: event.eventSource,
+      originalEvent: event.originalEvent,
+    });
+  }
+
+  function onCanvasBlur(event) {
+    /**
+     * Raised when the {@link OpenSeadragon.Viewer#canvas} element loses keyboard focus.
+     *
+     * @event canvas-blur
+     * @memberof OpenSeadragon.Viewer
+     * @type {object}
+     * @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
+     * @property {OpenSeadragon.MouseTracker} tracker - A reference to the MouseTracker which originated this event.
+     * @property {Object} originalEvent - The original DOM event.
+     * @property {?Object} userData - Arbitrary subscriber-defined object.
+     */
+    this.raiseEvent('canvas-blur', {
+      tracker: event.eventSource,
+      originalEvent: event.originalEvent,
+    });
+  }
+
   function onCanvasScroll(event) {
     var canvasScrollEventArgs,
       gestureSettings,
@@ -11358,6 +11589,7 @@ function OpenSeadragon(options) {
     });
   }
 
+
 ///////////////////////////////////////////////////////////////////////////////
 // Page update routines ( aka Views - for future reference )
 ///////////////////////////////////////////////////////////////////////////////
@@ -11421,6 +11653,7 @@ function OpenSeadragon(options) {
 
     }
 
+
     var viewportChange = viewer.viewport.update();
     var animated = viewer.world.update() || viewportChange;
 
@@ -11535,6 +11768,7 @@ function OpenSeadragon(options) {
     return prefix ? prefix + url : url;
   }
 
+
   function beginZoomingIn() {
     THIS[this.hash].lastZoomTime = $.now();
     THIS[this.hash].zoomFactor = this.zoomPerSecond;
@@ -11542,6 +11776,7 @@ function OpenSeadragon(options) {
     scheduleZoom(this);
   }
 
+
   function beginZoomingOut() {
     THIS[this.hash].lastZoomTime = $.now();
     THIS[this.hash].zoomFactor = 1.0 / this.zoomPerSecond;
@@ -11549,14 +11784,17 @@ function OpenSeadragon(options) {
     scheduleZoom(this);
   }
 
+
   function endZooming() {
     THIS[this.hash].zooming = false;
   }
 
+
   function scheduleZoom(viewer) {
     $.requestAnimationFrame($.delegate(viewer, doZoom));
   }
 
+
   function doZoom() {
     var currentTime,
       deltaTime,
@@ -11574,6 +11812,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   function doSingleZoomIn() {
     if (this.viewport) {
       THIS[this.hash].zooming = false;
@@ -11584,6 +11823,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   function doSingleZoomOut() {
     if (this.viewport) {
       THIS[this.hash].zooming = false;
@@ -11594,6 +11834,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   function lightUp() {
     if (this.buttonGroup) {
       this.buttonGroup.emulateEnter();
@@ -11601,12 +11842,14 @@ function OpenSeadragon(options) {
     }
   }
 
+
   function onHome() {
     if (this.viewport) {
       this.viewport.goHome();
     }
   }
 
+
   function onFullScreen() {
     if (this.isFullPage() && !$.isFullScreen()) {
       // Is fullPage but not fullScreen
@@ -11808,6 +12051,7 @@ function OpenSeadragon(options) {
     this.totalBorderWidths = new $.Point(this.borderWidth * 2,
       this.borderWidth * 2).minus(this.fudge);
 
+
     if (options.controlOptions.anchor !== $.ControlAnchor.NONE) {
       (function(style, borderWidth) {
         style.margin = '0px';
@@ -11846,6 +12090,7 @@ function OpenSeadragon(options) {
       style.styleFloat = 'left'; //IE
       style.zIndex = 999999999;
       style.cursor = 'default';
+      style.boxSizing = 'content-box';
     }(this.displayRegion.style, this.borderWidth));
     $.setElementPointerEventsNone(this.displayRegion);
     $.setElementTouchActionNone(this.displayRegion);
@@ -11890,10 +12135,10 @@ function OpenSeadragon(options) {
     this.element.getElementsByTagName('div')[0].appendChild(
       this.displayRegionContainer);
 
-    function rotate(degrees) {
+    function rotate(degrees, immediately) {
       _setTransformRotate(_this.displayRegionContainer, degrees);
       _setTransformRotate(_this.displayRegion, -degrees);
-      _this.viewport.setRotation(degrees);
+      _this.viewport.setRotation(degrees, immediately);
     }
 
     if (options.navigatorRotate) {
@@ -11901,12 +12146,13 @@ function OpenSeadragon(options) {
         options.viewer.viewport.getRotation() :
         options.viewer.degrees || 0;
 
-      rotate(degrees);
+      rotate(degrees, true);
       options.viewer.addHandler('rotate', function(args) {
-        rotate(args.degrees);
+        rotate(args.degrees, args.immediately);
       });
     }
 
+
     // Remove the base class' (Viewer's) innerTracker and replace it with our own
     this.innerTracker.destroy();
     this.innerTracker = new $.MouseTracker({
@@ -11995,6 +12241,7 @@ function OpenSeadragon(options) {
           (width + 'px') :
           width;
         this._resizeWithViewer = false;
+        this.updateSize();
       },
 
       /**
@@ -12007,6 +12254,7 @@ function OpenSeadragon(options) {
           (height + 'px') :
           height;
         this._resizeWithViewer = false;
+        this.updateSize();
       },
 
       /**
@@ -12072,15 +12320,20 @@ function OpenSeadragon(options) {
           bottomright = this.viewport.pixelFromPointNoRotate(
             bounds.getBottomRight(), false).minus(this.totalBorderWidths);
 
+          if (!this.navigatorRotate) {
+            var degrees = viewport.getRotation(true);
+            _setTransformRotate(this.displayRegion, -degrees);
+          }
+
           //update style for navigator-box
           var style = this.displayRegion.style;
           style.display = this.world.getItemCount() ? 'block' : 'none';
 
-          style.top = Math.round(topleft.y) + 'px';
-          style.left = Math.round(topleft.x) + 'px';
+          style.top = topleft.y.toFixed(2) + 'px';
+          style.left = topleft.x.toFixed(2) + 'px';
 
-          var width = Math.abs(topleft.x - bottomright.x);
-          var height = Math.abs(topleft.y - bottomright.y);
+          var width = bottomright.x - topleft.x;
+          var height = bottomright.y - topleft.y;
           // make sure width and height are non-negative so IE doesn't throw
           style.width = Math.round(Math.max(width, 0)) + 'px';
           style.height = Math.round(Math.max(height, 0)) + 'px';
@@ -12165,6 +12418,7 @@ function OpenSeadragon(options) {
       },
     });
 
+
   /**
    * @private
    * @inner
@@ -12275,6 +12529,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -12286,6 +12541,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -12746,6 +13002,7 @@ function OpenSeadragon(options) {
 
 (function($) {
 
+
   /**
    * @class TileSource
    * @classdesc The TileSource contains the most basic implementation required to create a
@@ -12947,6 +13204,7 @@ function OpenSeadragon(options) {
       }
     }
 
+
   };
 
   /** @lends OpenSeadragon.TileSource.prototype */
@@ -13053,6 +13311,7 @@ function OpenSeadragon(options) {
       return new $.Point(rx, ry);
     },
 
+
     /**
      * @function
      * @returns {Number} The highest level in this tile source that can be contained in a single tile.
@@ -13132,6 +13391,7 @@ function OpenSeadragon(options) {
       return new $.Rect(px * scale, py * scale, sx * scale, sy * scale);
     },
 
+
     /**
      * Responsible for retrieving, and caching the
      * image metadata pertinent to this TileSources implementation.
@@ -13149,6 +13409,7 @@ function OpenSeadragon(options) {
         filename,
         lastDot;
 
+
       if (url) {
         urlParts = url.split('/');
         filename = urlParts[urlParts.length - 1];
@@ -13376,6 +13637,11 @@ function OpenSeadragon(options) {
      * The headers returned here will override headers specified at the Viewer or TiledImage level.
      * Specifying a falsy value for a header will clear its existing value set at the Viewer or
      * TiledImage level (if any).
+     *
+     * Note that the headers of existing tiles don't automatically change when this function
+     * returns updated headers. To do that, you need to call {@link OpenSeadragon.Viewer#setAjaxHeaders}
+     * and propagate the changes.
+     *
      * @function
      * @param {Number} level
      * @param {Number} x
@@ -13625,8 +13891,10 @@ function OpenSeadragon(options) {
     },
   };
 
+
   $.extend(true, $.TileSource.prototype, $.EventSource.prototype);
 
+
   /**
    * Decides whether to try to process the response as xml, json, or hand back
    * the text
@@ -13651,7 +13919,7 @@ function OpenSeadragon(options) {
       throw new Error($.getString('Errors.Status', status, statusText));
     }
 
-    if (responseText.match(/\s*<.*/)) {
+    if (responseText.match(/^\s*<.*/)) {
       try {
         data = (xhr.responseXML && xhr.responseXML.documentElement) ?
           xhr.responseXML :
@@ -13671,6 +13939,7 @@ function OpenSeadragon(options) {
     return data;
   }
 
+
   /**
    * Determines the TileSource Implementation by introspection of OpenSeadragon
    * namespace, calling each TileSource implementation of 'isType'
@@ -13698,6 +13967,7 @@ function OpenSeadragon(options) {
     return null;
   };
 
+
 }(OpenSeadragon));
 
 /*
@@ -13800,6 +14070,7 @@ function OpenSeadragon(options) {
   $.extend($.DziTileSource.prototype,
     $.TileSource.prototype, /** @lends OpenSeadragon.DziTileSource.prototype */{
 
+
       /**
        * Determine if the data and/or url imply the image service is supported by
        * this tile source.
@@ -13860,6 +14131,7 @@ function OpenSeadragon(options) {
         return options;
       },
 
+
       /**
        * @function
        * @param {Number} level
@@ -13879,6 +14151,7 @@ function OpenSeadragon(options) {
           this.queryParams].join('');
       },
 
+
       /**
        * @function
        * @param {Number} level
@@ -13931,6 +14204,7 @@ function OpenSeadragon(options) {
       },
     });
 
+
   /**
    * @private
    * @inner
@@ -14094,7 +14368,7 @@ function OpenSeadragon(options) {
  * OpenSeadragon - IIIFTileSource
  *
  * Copyright (C) 2009 CodePlex Foundation
- * Copyright (C) 2010-2022 OpenSeadragon contributors
+ * Copyright (C) 2010-2023 OpenSeadragon contributors
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
@@ -14236,6 +14510,19 @@ function OpenSeadragon(options) {
       }
     }
 
+    // Create an array with our exact resolution sizes if these have been supplied
+    if (this.sizes) {
+      var sizeLength = this.sizes.length;
+      if ((sizeLength === options.maxLevel) ||
+        (sizeLength === options.maxLevel + 1)) {
+        this.levelSizes = this.sizes;
+        // Need to take into account that the list may or may not include the full resolution size
+        if (sizeLength === options.maxLevel) {
+          this.levelSizes.push({width: this.width, height: this.height});
+        }
+      }
+    }
+
     $.TileSource.apply(this, [options]);
   };
 
@@ -14440,9 +14727,20 @@ function OpenSeadragon(options) {
           }
         }
 
-        return $.TileSource.prototype.getNumTiles.call(this, level);
+        // Use supplied list of scaled resolution sizes if these exist
+        if (this.levelSizes) {
+          var levelSize = this.levelSizes[level];
+          var x = Math.ceil(levelSize.width / this.getTileWidth(level)),
+            y = Math.ceil(levelSize.height / this.getTileHeight(level));
+          return new $.Point(x, y);
+        }
+        // Otherwise call default TileSource->getNumTiles() function
+        else {
+          return $.TileSource.prototype.getNumTiles.call(this, level);
+        }
       },
 
+
       /**
        * @function
        * @param {Number} level
@@ -14454,9 +14752,39 @@ function OpenSeadragon(options) {
           return new $.Point(0, 0);
         }
 
+        // Use supplied list of scaled resolution sizes if these exist
+        if (this.levelSizes) {
+
+          var validPoint = point.x >= 0 && point.x <= 1 &&
+            point.y >= 0 && point.y <= 1 / this.aspectRatio;
+          $.console.assert(validPoint,
+            '[TileSource.getTileAtPoint] must be called with a valid point.');
+
+          var widthScaled = this.levelSizes[level].width;
+          var pixelX = point.x * widthScaled;
+          var pixelY = point.y * widthScaled;
+
+          var x = Math.floor(pixelX / this.getTileWidth(level));
+          var y = Math.floor(pixelY / this.getTileHeight(level));
+
+          // When point.x == 1 or point.y == 1 / this.aspectRatio we want to
+          // return the last tile of the row/column
+          if (point.x >= 1) {
+            x = this.getNumTiles(level).x - 1;
+          }
+          var EPSILON = 1e-15;
+          if (point.y >= 1 / this.aspectRatio - EPSILON) {
+            y = this.getNumTiles(level).y - 1;
+          }
+
+          return new $.Point(x, y);
+        }
+
+        // Otherwise call default TileSource->getTileAtPoint() function
         return $.TileSource.prototype.getTileAtPoint.call(this, level, point);
       },
 
+
       /**
        * Responsible for retrieving the url which will return an image for the
        * region specified by the given x, y, and level components.
@@ -14481,10 +14809,9 @@ function OpenSeadragon(options) {
         var IIIF_ROTATION = '0',
           //## get the scale (level as a decimal)
           scale = Math.pow(0.5, this.maxLevel - level),
-
           //# image dimensions at this level
-          levelWidth = Math.round(this.width * scale),
-          levelHeight = Math.round(this.height * scale),
+          levelWidth,
+          levelHeight,
 
           //## iiif region
           tileWidth,
@@ -14502,6 +14829,17 @@ function OpenSeadragon(options) {
           iiifQuality,
           uri;
 
+        // Use supplied list of scaled resolution sizes if these exist
+        if (this.levelSizes) {
+          levelWidth = this.levelSizes[level].width;
+          levelHeight = this.levelSizes[level].height;
+        }
+        // Otherwise calculate the sizes ourselves
+        else {
+          levelWidth = Math.ceil(this.width * scale);
+          levelHeight = Math.ceil(this.height * scale);
+        }
+
         tileWidth = this.getTileWidth(level);
         tileHeight = this.getTileHeight(level);
         iiifTileSizeWidth = Math.round(tileWidth / scale);
@@ -14534,8 +14872,8 @@ function OpenSeadragon(options) {
           } else {
             iiifRegion = [iiifTileX, iiifTileY, iiifTileW, iiifTileH].join(',');
           }
-          iiifSizeW = Math.round(iiifTileW * scale);
-          iiifSizeH = Math.round(iiifTileH * scale);
+          iiifSizeW = Math.min(tileWidth, levelWidth - (x * tileWidth));
+          iiifSizeH = Math.min(tileHeight, levelHeight - (y * tileHeight));
           if (this.version === 2 && iiifSizeW === this.width) {
             iiifSize = 'full';
           } else if (this.version === 3 && iiifSizeW === this.width &&
@@ -14616,6 +14954,7 @@ function OpenSeadragon(options) {
     });
   }
 
+
   function configureFromXml10(xmlDoc) {
     //parse the xml
     if (!xmlDoc || !xmlDoc.documentElement) {
@@ -14664,6 +15003,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
 }(OpenSeadragon));
 
 /*
@@ -14707,6 +15047,7 @@ function OpenSeadragon(options) {
  * see <https://github.com/openseadragon/openseadragon/issues/58>.
  */
 
+
 (function($) {
 
   /**
@@ -14770,6 +15111,7 @@ function OpenSeadragon(options) {
   $.extend($.OsmTileSource.prototype,
     $.TileSource.prototype, /** @lends OpenSeadragon.OsmTileSource.prototype */{
 
+
       /**
        * Determine if the data and/or url imply the image service is supported by
        * this tile source.
@@ -14797,6 +15139,7 @@ function OpenSeadragon(options) {
         return data;
       },
 
+
       /**
        * @function
        * @param {Number} level
@@ -14808,6 +15151,7 @@ function OpenSeadragon(options) {
       },
     });
 
+
 }(OpenSeadragon));
 
 /*
@@ -14851,6 +15195,7 @@ function OpenSeadragon(options) {
  * see <https://github.com/openseadragon/openseadragon/issues/58>.
  */
 
+
 (function($) {
 
   /**
@@ -14906,6 +15251,7 @@ function OpenSeadragon(options) {
   $.extend($.TmsTileSource.prototype,
     $.TileSource.prototype, /** @lends OpenSeadragon.TmsTileSource.prototype */{
 
+
       /**
        * Determine if the data and/or url imply the image service is supported by
        * this tile source.
@@ -14930,6 +15276,7 @@ function OpenSeadragon(options) {
         return data;
       },
 
+
       /**
        * @function
        * @param {Number} level
@@ -14944,6 +15291,7 @@ function OpenSeadragon(options) {
       },
     });
 
+
 }(OpenSeadragon));
 
 (function($) {
@@ -15104,6 +15452,7 @@ function OpenSeadragon(options) {
 
 }(OpenSeadragon));
 
+
 /*
  * OpenSeadragon - LegacyTileSource
  *
@@ -15223,6 +15572,7 @@ function OpenSeadragon(options) {
         );
       },
 
+
       /**
        *
        * @function
@@ -15626,6 +15976,7 @@ function OpenSeadragon(options) {
         var currentWidth = this._image.naturalWidth;
         var currentHeight = this._image.naturalHeight;
 
+
         var bigCanvas = document.createElement('canvas');
         var bigContext = bigCanvas.getContext('2d');
 
@@ -15909,6 +16260,7 @@ function OpenSeadragon(options) {
       this.element.appendChild(this.imgDown);
     }
 
+
     this.addHandler('press', this.onPress);
     this.addHandler('release', this.onRelease);
     this.addHandler('click', this.onClick);
@@ -16165,6 +16517,7 @@ function OpenSeadragon(options) {
 
     });
 
+
   function scheduleFade(button) {
     $.requestAnimationFrame(function() {
       updateFade(button);
@@ -16237,6 +16590,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   function outTo(button, newState) {
 
     if (button.element.disabled) {
@@ -16266,6 +16620,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
 }(OpenSeadragon));
 
 /*
@@ -16382,6 +16737,17 @@ function OpenSeadragon(options) {
   /** @lends OpenSeadragon.ButtonGroup.prototype */
   $.ButtonGroup.prototype = {
 
+    /**
+     * Adds the given button to this button group.
+     *
+     * @function
+     * @param {OpenSeadragon.Button} button
+     */
+    addButton: function(button) {
+      this.buttons.push(button);
+      this.element.appendChild(button.element);
+    },
+
     /**
      * TODO: Figure out why this is used on the public API and if a more useful
      * api can be created.
@@ -16413,6 +16779,7 @@ function OpenSeadragon(options) {
     },
   };
 
+
 }(OpenSeadragon));
 
 /*
@@ -16977,6 +17344,7 @@ function OpenSeadragon(options) {
     },
   };
 
+
 }(OpenSeadragon));
 
 /*
@@ -17272,6 +17640,7 @@ function OpenSeadragon(options) {
 
   };
 
+
   /**
    * @private
    * @inner
@@ -17282,7 +17651,8 @@ function OpenSeadragon(options) {
       var page;
 
       if ('horizontal' === this.scroll) {
-        page = Math.floor(event.position.x / this.panelWidth);
+        // +4px fix to solve problem with precision on thumbnail selection if there is a lot of them
+        page = Math.floor(event.position.x / (this.panelWidth + 4));
       } else {
         page = Math.floor(event.position.y / this.panelHeight);
       }
@@ -17293,6 +17663,7 @@ function OpenSeadragon(options) {
     this.element.focus();
   }
 
+
   /**
    * @private
    * @inner
@@ -17345,6 +17716,7 @@ function OpenSeadragon(options) {
 
   }
 
+
   /**
    * @private
    * @inner
@@ -17396,6 +17768,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   function loadPanels(strip, viewerSize, scroll) {
     var panelSize,
       activePanelsStart,
@@ -17460,6 +17833,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -17486,6 +17860,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -17508,6 +17883,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -17564,6 +17940,7 @@ function OpenSeadragon(options) {
     }
   }
 
+
   /**
    * @private
    * @inner
@@ -18033,17 +18410,19 @@ function OpenSeadragon(options) {
    * @param {Function} [options.callback] - Called once image has been downloaded.
    * @param {Function} [options.abort] - Called when this image job is aborted.
    * @param {Number} [options.timeout] - The max number of milliseconds that this image job may take to complete.
+   * @param {Number} [options.tries] - Actual number of the current try.
    */
   $.ImageJob = function(options) {
 
     $.extend(true, this, {
       timeout: $.DEFAULT_SETTINGS.timeout,
       jobId: null,
+      tries: 0,
     }, options);
 
     /**
      * Data object which will contain downloaded image data.
-     * @member {Image|*} image data object, by default an Image object (depends on TileSource)
+     * @member {Image|*} data data object, by default an Image object (depends on TileSource)
      * @memberof OpenSeadragon.ImageJob#
      */
     this.data = null;
@@ -18070,6 +18449,8 @@ function OpenSeadragon(options) {
      * @method
      */
     start: function() {
+      this.tries++;
+
       var self = this;
       var selfAbort = this.abort;
 
@@ -18122,6 +18503,7 @@ function OpenSeadragon(options) {
       jobLimit: $.DEFAULT_SETTINGS.imageLoaderLimit,
       timeout: $.DEFAULT_SETTINGS.timeout,
       jobQueue: [],
+      failedTiles: [],
       jobsInProgress: 0,
     }, options);
 
@@ -18204,7 +18586,8 @@ function OpenSeadragon(options) {
   };
 
   /**
-   * Cleans up ImageJob once completed.
+   * Cleans up ImageJob once completed. Restarts job after tileRetryDelay seconds if failed
+   * but max tileRetryMax times
    * @method
    * @private
    * @param loader - ImageLoader used to start job.
@@ -18212,6 +18595,10 @@ function OpenSeadragon(options) {
    * @param callback - Called once cleanup is finished.
    */
   function completeJob(loader, job, callback) {
+    if (job.errorMsg !== '' && (job.data === null || job.data === undefined) &&
+      job.tries < 1 + loader.tileRetryMax) {
+      loader.failedTiles.push(job);
+    }
     var nextJob;
 
     loader.jobsInProgress--;
@@ -18223,6 +18610,17 @@ function OpenSeadragon(options) {
       loader.jobsInProgress++;
     }
 
+    if (loader.tileRetryMax > 0 && loader.jobQueue.length === 0) {
+      if ((!loader.jobLimit || loader.jobsInProgress < loader.jobLimit) &&
+        loader.failedTiles.length > 0) {
+        nextJob = loader.failedTiles.shift();
+        setTimeout(function() {
+          nextJob.start();
+        }, loader.tileRetryDelay);
+        loader.jobsInProgress++;
+      }
+    }
+
     callback(job.data, job.errorMsg, job.request);
   }
 
@@ -20120,6 +20518,7 @@ function OpenSeadragon(options) {
 
 (function($) {
 
+
   /**
    * @class Viewport
    * @memberof OpenSeadragon
@@ -20815,6 +21214,8 @@ function OpenSeadragon(options) {
 
       if (constraints) {
         this.panTo(center, false);
+
+        newZoom = this._applyZoomConstraints(newZoom);
         this.zoomTo(newZoom, null, false);
 
         var constrainedBounds = this.getConstrainedBounds();
@@ -20901,6 +21302,7 @@ function OpenSeadragon(options) {
       return this.fitBounds(box, immediately);
     },
 
+
     /**
      * Returns bounds taking constraints into account
      * Added to improve constrained panning
@@ -21186,7 +21588,10 @@ function OpenSeadragon(options) {
 
       if (this.viewer) {
         /**
-         * Raised when the viewer is resized (see {@link OpenSeadragon.Viewport#resize}).
+         * Raised when a viewer resize operation is initiated (see {@link OpenSeadragon.Viewport#resize}).
+         * This event happens before the viewport bounds have been updated.
+         * See also {@link OpenSeadragon.Viewer#after-resize} which reflects
+         * the new viewport bounds following the resize action.
          *
          * @event resize
          * @memberof OpenSeadragon.Viewer
@@ -21202,7 +21607,29 @@ function OpenSeadragon(options) {
         });
       }
 
-      return this.fitBounds(newBounds, true);
+      var output = this.fitBounds(newBounds, true);
+
+      if (this.viewer) {
+        /**
+         * Raised after the viewer is resized (see {@link OpenSeadragon.Viewport#resize}).
+         * See also {@link OpenSeadragon.Viewer#resize} event which happens
+         * before the new bounds have been calculated and applied.
+         *
+         * @event after-resize
+         * @memberof OpenSeadragon.Viewer
+         * @type {object}
+         * @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
+         * @property {OpenSeadragon.Point} newContainerSize
+         * @property {Boolean} maintain
+         * @property {?Object} userData - Arbitrary subscriber-defined object.
+         */
+        this.viewer.raiseEvent('after-resize', {
+          newContainerSize: newContainerSize,
+          maintain: maintain,
+        });
+      }
+
+      return output;
     },
 
     // private
@@ -21237,11 +21664,13 @@ function OpenSeadragon(options) {
         this.degreesSpring.update();
       }
 
+
       var changed = this.centerSpringX.current.value !== this._oldCenterX ||
         this.centerSpringY.current.value !== this._oldCenterY ||
         this.zoomSpring.current.value !== this._oldZoom ||
         this.degreesSpring.current.value !== this._oldDegrees;
 
+
       this._oldCenterX = this.centerSpringX.current.value;
       this._oldCenterY = this.centerSpringY.current.value;
       this._oldZoom = this.zoomSpring.current.value;
@@ -22031,6 +22460,9 @@ function OpenSeadragon(options) {
     var degrees = options.degrees || 0;
     delete options.degrees;
 
+    var ajaxHeaders = options.ajaxHeaders;
+    delete options.ajaxHeaders;
+
     $.extend(true, this, {
 
       //internal state properties
@@ -22122,6 +22554,9 @@ function OpenSeadragon(options) {
         tiledImage: _this,
       }, args));
     };
+
+    this._ownAjaxHeaders = {};
+    this.setAjaxHeaders(ajaxHeaders, false);
   };
 
   $.extend($.TiledImage.prototype,
@@ -22908,6 +23343,96 @@ function OpenSeadragon(options) {
         });
       },
 
+      /**
+       * Update headers to include when making AJAX requests.
+       *
+       * Unless `propagate` is set to false (which is likely only useful in rare circumstances),
+       * the updated headers are propagated to all tiles and queued image loader jobs.
+       *
+       * Note that the rules for merging headers still apply, i.e. headers returned by
+       * {@link OpenSeadragon.TileSource#getTileAjaxHeaders} take precedence over
+       * the headers here in the tiled image (`TiledImage.ajaxHeaders`).
+       *
+       * @function
+       * @param {Object} ajaxHeaders Updated AJAX headers, which will be merged over any headers specified in {@link OpenSeadragon.Options}.
+       * @param {Boolean} [propagate=true] Whether to propagate updated headers to existing tiles and queued image loader jobs.
+       */
+      setAjaxHeaders: function(ajaxHeaders, propagate) {
+        if (ajaxHeaders === null) {
+          ajaxHeaders = {};
+        }
+        if (!$.isPlainObject(ajaxHeaders)) {
+          console.error(
+            '[TiledImage.setAjaxHeaders] Ignoring invalid headers, must be a plain object');
+          return;
+        }
+
+        this._ownAjaxHeaders = ajaxHeaders;
+        this._updateAjaxHeaders(propagate);
+      },
+
+      /**
+       * Update headers to include when making AJAX requests.
+       *
+       * This function has the same effect as calling {@link OpenSeadragon.TiledImage#setAjaxHeaders},
+       * except that the headers for this tiled image do not change. This is especially useful
+       * for propagating updated headers from {@link OpenSeadragon.TileSource#getTileAjaxHeaders}
+       * to existing tiles.
+       *
+       * @private
+       * @function
+       * @param {Boolean} [propagate=true] Whether to propagate updated headers to existing tiles and queued image loader jobs.
+       */
+      _updateAjaxHeaders: function(propagate) {
+        if (propagate === undefined) {
+          propagate = true;
+        }
+
+        // merge with viewer's headers
+        if ($.isPlainObject(this.viewer.ajaxHeaders)) {
+          this.ajaxHeaders = $.extend({}, this.viewer.ajaxHeaders,
+            this._ownAjaxHeaders);
+        } else {
+          this.ajaxHeaders = this._ownAjaxHeaders;
+        }
+
+        // propagate header updates to all tiles and queued image loader jobs
+        if (propagate) {
+          var numTiles, xMod, yMod, tile;
+
+          for (var level in this.tilesMatrix) {
+            numTiles = this.source.getNumTiles(level);
+
+            for (var x in this.tilesMatrix[level]) {
+              xMod = (numTiles.x + (x % numTiles.x)) % numTiles.x;
+
+              for (var y in this.tilesMatrix[level][x]) {
+                yMod = (numTiles.y + (y % numTiles.y)) % numTiles.y;
+                tile = this.tilesMatrix[level][x][y];
+
+                tile.loadWithAjax = this.loadTilesWithAjax;
+                if (tile.loadWithAjax) {
+                  var tileAjaxHeaders = this.source.getTileAjaxHeaders(level,
+                    xMod, yMod);
+                  tile.ajaxHeaders = $.extend({}, this.ajaxHeaders,
+                    tileAjaxHeaders);
+                } else {
+                  tile.ajaxHeaders = null;
+                }
+              }
+            }
+          }
+
+          for (var i = 0; i < this._imageLoader.jobQueue.length; i++) {
+            var job = this._imageLoader.jobQueue[i];
+            job.loadWithAjax = job.tile.loadWithAjax;
+            job.ajaxHeaders = job.tile.loadWithAjax ?
+              job.tile.ajaxHeaders :
+              null;
+          }
+        }
+      },
+
       // private
       _setScale: function(scale, immediately) {
         var sameTarget = (this._scaleSpring.target.value === scale);
@@ -23542,6 +24067,8 @@ function OpenSeadragon(options) {
           tile.loading = false;
           tile.exists = false;
           return;
+        } else {
+          tile.exists = true;
         }
 
         if (time < this.lastResetTime) {
@@ -23578,9 +24105,15 @@ function OpenSeadragon(options) {
        */
       _setTileLoaded: function(tile, data, cutoff, tileRequest) {
         var increment = 0,
+          eventFinished = false,
           _this = this;
 
         function getCompletionCallback() {
+          if (eventFinished) {
+            $.console.error(
+              'Event \'tile-loaded\' argument getCompletionCallback must be called synchronously. ' +
+              'Its return value should be called asynchronously.');
+          }
           increment++;
           return completionCallback;
         }
@@ -23622,6 +24155,8 @@ function OpenSeadragon(options) {
          * marked as entirely loaded when the callback has been called once for each
          * call to getCompletionCallback.
          */
+
+        var fallbackCompletion = getCompletionCallback();
         this.viewer.raiseEvent('tile-loaded', {
           tile: tile,
           tiledImage: this,
@@ -23634,8 +24169,9 @@ function OpenSeadragon(options) {
           data: data,
           getCompletionCallback: getCompletionCallback,
         });
+        eventFinished = true;
         // In case the completion callback is never called, we at least force it once.
-        getCompletionCallback()();
+        fallbackCompletion();
       },
 
       /**
@@ -23734,6 +24270,7 @@ function OpenSeadragon(options) {
         return false;
       },
 
+
       /**
        * @private
        * @inner
@@ -23883,6 +24420,9 @@ function OpenSeadragon(options) {
                 if (sketchScale) {
                   clipPoint = clipPoint.times(sketchScale);
                 }
+                if (sketchTranslate) {
+                  clipPoint = clipPoint.plus(sketchTranslate);
+                }
                 return clipPoint;
               });
             });
@@ -24147,6 +24687,7 @@ function OpenSeadragon(options) {
       },
     });
 
+
   /**
    * @private
    * @inner