mirror of
https://github.com/openseadragon/openseadragon.git
synced 2024-11-23 21:56:10 +03:00
396fcb33a5
An outer div has been added to the internal HTML of the overlay element to allow for independent flipping of the content. Flipping will invert the `scaleX` value of the transform property for the style of the element. By setting the value `overlayContentFlipped: true` in the OSD config we can flip the content in the opposite direction to the overlay, but by setting this to false we can flip the content along with the overlay. This allows for some people who are using images in their overlay to flip the images along with the overlay.
3954 lines
154 KiB
JavaScript
3954 lines
154 KiB
JavaScript
/*
|
|
* OpenSeadragon - Viewer
|
|
*
|
|
* Copyright (C) 2009 CodePlex Foundation
|
|
* 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
|
|
* met:
|
|
*
|
|
* - Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* - Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* - Neither the name of CodePlex Foundation nor the names of its
|
|
* contributors may be used to endorse or promote products derived from
|
|
* this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
|
|
* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
|
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
(function( $ ){
|
|
|
|
// dictionary from hash to private properties
|
|
var THIS = {};
|
|
var nextHash = 1;
|
|
|
|
/**
|
|
*
|
|
* The main point of entry into creating a zoomable image on the page.<br>
|
|
* <br>
|
|
* We have provided an idiomatic javascript constructor which takes
|
|
* a single object, but still support the legacy positional arguments.<br>
|
|
* <br>
|
|
* The options below are given in order that they appeared in the constructor
|
|
* as arguments and we translate a positional call into an idiomatic call.<br>
|
|
* <br>
|
|
* To create a viewer, you can use either of this methods:<br>
|
|
* <ul>
|
|
* <li><code>var viewer = new OpenSeadragon.Viewer(options);</code></li>
|
|
* <li><code>var viewer = OpenSeadragon(options);</code></li>
|
|
* </ul>
|
|
* @class Viewer
|
|
* @classdesc The main OpenSeadragon viewer class.
|
|
*
|
|
* @memberof OpenSeadragon
|
|
* @extends OpenSeadragon.EventSource
|
|
* @extends OpenSeadragon.ControlDock
|
|
* @param {OpenSeadragon.Options} options - Viewer options.
|
|
*
|
|
**/
|
|
$.Viewer = function( options ) {
|
|
|
|
var args = arguments,
|
|
_this = this,
|
|
i;
|
|
|
|
|
|
//backward compatibility for positional args while preferring more
|
|
//idiomatic javascript options object as the only argument
|
|
if( !$.isPlainObject( options ) ){
|
|
options = {
|
|
id: args[ 0 ],
|
|
xmlPath: args.length > 1 ? args[ 1 ] : undefined,
|
|
prefixUrl: args.length > 2 ? args[ 2 ] : undefined,
|
|
controls: args.length > 3 ? args[ 3 ] : undefined,
|
|
overlays: args.length > 4 ? args[ 4 ] : undefined
|
|
};
|
|
}
|
|
|
|
//options.config and the general config argument are deprecated
|
|
//in favor of the more direct specification of optional settings
|
|
//being pass directly on the options object
|
|
if ( options.config ){
|
|
$.extend( true, options, options.config );
|
|
delete options.config;
|
|
}
|
|
|
|
//Public properties
|
|
//Allow the options object to override global defaults
|
|
$.extend( true, this, {
|
|
|
|
//internal state and dom identifiers
|
|
id: options.id,
|
|
hash: options.hash || nextHash++,
|
|
/**
|
|
* Index for page to be shown first next time open() is called (only used in sequenceMode).
|
|
* @member {Number} initialPage
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
initialPage: 0,
|
|
|
|
//dom nodes
|
|
/**
|
|
* The parent element of this Viewer instance, passed in when the Viewer was created.
|
|
* @member {Element} element
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
element: null,
|
|
/**
|
|
* A <div> element (provided by {@link OpenSeadragon.ControlDock}), the base element of this Viewer instance.<br><br>
|
|
* Child element of {@link OpenSeadragon.Viewer#element}.
|
|
* @member {Element} container
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
container: null,
|
|
/**
|
|
* A <div> element, the element where user-input events are handled for panning and zooming.<br><br>
|
|
* Child element of {@link OpenSeadragon.Viewer#container},
|
|
* positioned on top of {@link OpenSeadragon.Viewer#keyboardCommandArea}.<br><br>
|
|
* The parent of {@link OpenSeadragon.Drawer#canvas} instances.
|
|
* @member {Element} canvas
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
canvas: null,
|
|
|
|
// Overlays list. An overlay allows to add html on top of the viewer.
|
|
overlays: [],
|
|
// Container inside the canvas where overlays are drawn.
|
|
overlaysContainer: null,
|
|
|
|
//private state properties
|
|
previousBody: [],
|
|
|
|
//This was originally initialized in the constructor and so could never
|
|
//have anything in it. now it can because we allow it to be specified
|
|
//in the options and is only empty by default if not specified. Also
|
|
//this array was returned from get_controls which I find confusing
|
|
//since this object has a controls property which is treated in other
|
|
//functions like clearControls. I'm removing the accessors.
|
|
customControls: [],
|
|
|
|
//These are originally not part options but declared as members
|
|
//in initialize. It's still considered idiomatic to put them here
|
|
//source is here for backwards compatibility. It is not an official
|
|
//part of the API and should not be relied upon.
|
|
source: null,
|
|
/**
|
|
* Handles rendering of tiles in the viewer. Created for each TileSource opened.
|
|
* @member {OpenSeadragon.Drawer} drawer
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
drawer: null,
|
|
/**
|
|
* Keeps track of all of the tiled images in the scene.
|
|
* @member {OpenSeadragon.World} world
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
world: null,
|
|
/**
|
|
* Handles coordinate-related functionality - zoom, pan, rotation, etc. Created for each TileSource opened.
|
|
* @member {OpenSeadragon.Viewport} viewport
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
viewport: null,
|
|
/**
|
|
* @member {OpenSeadragon.Navigator} navigator
|
|
* @memberof OpenSeadragon.Viewer#
|
|
*/
|
|
navigator: null,
|
|
|
|
//A collection viewport is a separate viewport used to provide
|
|
//simultaneous rendering of sets of tiles
|
|
collectionViewport: null,
|
|
collectionDrawer: null,
|
|
|
|
//UI image resources
|
|
//TODO: rename navImages to uiImages
|
|
navImages: null,
|
|
|
|
//interface button controls
|
|
buttonGroup: null,
|
|
|
|
//TODO: this is defunct so safely remove it
|
|
profiler: null
|
|
|
|
}, $.DEFAULT_SETTINGS, options );
|
|
|
|
if ( typeof ( this.hash) === "undefined" ) {
|
|
throw new Error("A hash must be defined, either by specifying options.id or options.hash.");
|
|
}
|
|
if ( typeof ( THIS[ this.hash ] ) !== "undefined" ) {
|
|
// We don't want to throw an error here, as the user might have discarded
|
|
// the previous viewer with the same hash and now want to recreate it.
|
|
$.console.warn("Hash " + this.hash + " has already been used.");
|
|
}
|
|
|
|
//Private state properties
|
|
THIS[ this.hash ] = {
|
|
fsBoundsDelta: new $.Point( 1, 1 ),
|
|
prevContainerSize: null,
|
|
animating: false,
|
|
forceRedraw: false,
|
|
needsResize: false,
|
|
forceResize: false,
|
|
mouseInside: false,
|
|
group: null,
|
|
// whether we should be continuously zooming
|
|
zooming: false,
|
|
// how much we should be continuously zooming by
|
|
zoomFactor: null,
|
|
lastZoomTime: null,
|
|
fullPage: false,
|
|
onfullscreenchange: null,
|
|
lastClickTime: null,
|
|
draggingToZoom: false,
|
|
};
|
|
|
|
this._sequenceIndex = 0;
|
|
this._firstOpen = true;
|
|
this._updateRequestId = null;
|
|
this._loadQueue = [];
|
|
this.currentOverlays = [];
|
|
this._updatePixelDensityRatioBind = null;
|
|
|
|
this._lastScrollTime = $.now(); // variable used to help normalize the scroll event speed of different devices
|
|
|
|
//Inherit some behaviors and properties
|
|
$.EventSource.call( this );
|
|
|
|
this.addHandler( 'open-failed', function ( event ) {
|
|
var msg = $.getString( "Errors.OpenFailed", event.eventSource, event.message);
|
|
_this._showMessage( msg );
|
|
});
|
|
|
|
$.ControlDock.call( this, options );
|
|
|
|
//Deal with tile sources
|
|
if (this.xmlPath) {
|
|
//Deprecated option. Now it is preferred to use the tileSources option
|
|
this.tileSources = [ this.xmlPath ];
|
|
}
|
|
|
|
this.element = this.element || document.getElementById( this.id );
|
|
this.canvas = $.makeNeutralElement( "div" );
|
|
|
|
this.canvas.className = "openseadragon-canvas";
|
|
(function( style ){
|
|
style.width = "100%";
|
|
style.height = "100%";
|
|
style.overflow = "hidden";
|
|
style.position = "absolute";
|
|
style.top = "0px";
|
|
style.left = "0px";
|
|
}(this.canvas.style));
|
|
$.setElementTouchActionNone( this.canvas );
|
|
if (options.tabIndex !== "") {
|
|
this.canvas.tabIndex = (options.tabIndex === undefined ? 0 : options.tabIndex);
|
|
}
|
|
|
|
//the container is created through applying the ControlDock constructor above
|
|
this.container.className = "openseadragon-container";
|
|
(function( style ){
|
|
style.width = "100%";
|
|
style.height = "100%";
|
|
style.position = "relative";
|
|
style.overflow = "hidden";
|
|
style.left = "0px";
|
|
style.top = "0px";
|
|
style.textAlign = "left"; // needed to protect against
|
|
}( this.container.style ));
|
|
$.setElementTouchActionNone( this.container );
|
|
|
|
this.container.insertBefore( this.canvas, this.container.firstChild );
|
|
this.element.appendChild( this.container );
|
|
|
|
//Used for toggling between fullscreen and default container size
|
|
//TODO: these can be closure private and shared across Viewer
|
|
// instances.
|
|
this.bodyWidth = document.body.style.width;
|
|
this.bodyHeight = document.body.style.height;
|
|
this.bodyOverflow = document.body.style.overflow;
|
|
this.docOverflow = document.documentElement.style.overflow;
|
|
|
|
this.innerTracker = new $.MouseTracker({
|
|
userData: 'Viewer.innerTracker',
|
|
element: this.canvas,
|
|
startDisabled: !this.mouseNavEnabled,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
dblClickTimeThreshold: this.dblClickTimeThreshold,
|
|
dblClickDistThreshold: this.dblClickDistThreshold,
|
|
contextMenuHandler: $.delegate( this, onCanvasContextMenu ),
|
|
keyDownHandler: $.delegate( this, onCanvasKeyDown ),
|
|
keyHandler: $.delegate( this, onCanvasKeyPress ),
|
|
clickHandler: $.delegate( this, onCanvasClick ),
|
|
dblClickHandler: $.delegate( this, onCanvasDblClick ),
|
|
dragHandler: $.delegate( this, onCanvasDrag ),
|
|
dragEndHandler: $.delegate( this, onCanvasDragEnd ),
|
|
enterHandler: $.delegate( this, onCanvasEnter ),
|
|
leaveHandler: $.delegate( this, onCanvasLeave ),
|
|
pressHandler: $.delegate( this, onCanvasPress ),
|
|
releaseHandler: $.delegate( this, onCanvasRelease ),
|
|
nonPrimaryPressHandler: $.delegate( this, onCanvasNonPrimaryPress ),
|
|
nonPrimaryReleaseHandler: $.delegate( this, onCanvasNonPrimaryRelease ),
|
|
scrollHandler: $.delegate( this, onCanvasScroll ),
|
|
pinchHandler: $.delegate( this, onCanvasPinch ),
|
|
focusHandler: $.delegate( this, onCanvasFocus ),
|
|
blurHandler: $.delegate( this, onCanvasBlur ),
|
|
});
|
|
|
|
this.outerTracker = new $.MouseTracker({
|
|
userData: 'Viewer.outerTracker',
|
|
element: this.container,
|
|
startDisabled: !this.mouseNavEnabled,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
dblClickTimeThreshold: this.dblClickTimeThreshold,
|
|
dblClickDistThreshold: this.dblClickDistThreshold,
|
|
enterHandler: $.delegate( this, onContainerEnter ),
|
|
leaveHandler: $.delegate( this, onContainerLeave )
|
|
});
|
|
|
|
if( this.toolbar ){
|
|
this.toolbar = new $.ControlDock({ element: this.toolbar });
|
|
}
|
|
|
|
this.bindStandardControls();
|
|
|
|
THIS[ this.hash ].prevContainerSize = _getSafeElemSize( this.container );
|
|
|
|
if(window.ResizeObserver){
|
|
this._autoResizePolling = false;
|
|
this._resizeObserver = new ResizeObserver(function(){
|
|
THIS[_this.hash].needsResize = true;
|
|
});
|
|
|
|
this._resizeObserver.observe(this.container, {});
|
|
} else {
|
|
this._autoResizePolling = true;
|
|
}
|
|
|
|
// Create the world
|
|
this.world = new $.World({
|
|
viewer: this
|
|
});
|
|
|
|
this.world.addHandler('add-item', function(event) {
|
|
// For backwards compatibility, we maintain the source property
|
|
_this.source = _this.world.getItemAt(0).source;
|
|
|
|
THIS[ _this.hash ].forceRedraw = true;
|
|
|
|
if (!_this._updateRequestId) {
|
|
_this._updateRequestId = scheduleUpdate( _this, updateMulti );
|
|
}
|
|
});
|
|
|
|
this.world.addHandler('remove-item', function(event) {
|
|
// For backwards compatibility, we maintain the source property
|
|
if (_this.world.getItemCount()) {
|
|
_this.source = _this.world.getItemAt(0).source;
|
|
} else {
|
|
_this.source = null;
|
|
}
|
|
|
|
THIS[ _this.hash ].forceRedraw = true;
|
|
});
|
|
|
|
this.world.addHandler('metrics-change', function(event) {
|
|
if (_this.viewport) {
|
|
_this.viewport._setContentBounds(_this.world.getHomeBounds(), _this.world.getContentFactor());
|
|
}
|
|
});
|
|
|
|
this.world.addHandler('item-index-change', function(event) {
|
|
// For backwards compatibility, we maintain the source property
|
|
_this.source = _this.world.getItemAt(0).source;
|
|
});
|
|
|
|
// Create the viewport
|
|
this.viewport = new $.Viewport({
|
|
containerSize: THIS[ this.hash ].prevContainerSize,
|
|
springStiffness: this.springStiffness,
|
|
animationTime: this.animationTime,
|
|
minZoomImageRatio: this.minZoomImageRatio,
|
|
maxZoomPixelRatio: this.maxZoomPixelRatio,
|
|
visibilityRatio: this.visibilityRatio,
|
|
wrapHorizontal: this.wrapHorizontal,
|
|
wrapVertical: this.wrapVertical,
|
|
defaultZoomLevel: this.defaultZoomLevel,
|
|
minZoomLevel: this.minZoomLevel,
|
|
maxZoomLevel: this.maxZoomLevel,
|
|
viewer: this,
|
|
degrees: this.degrees,
|
|
flipped: this.flipped,
|
|
overlayContentFlipped: this.overlayContentFlipped,
|
|
navigatorRotate: this.navigatorRotate,
|
|
homeFillsViewer: this.homeFillsViewer,
|
|
margins: this.viewportMargins,
|
|
silenceMultiImageWarnings: this.silenceMultiImageWarnings
|
|
});
|
|
|
|
this.viewport._setContentBounds(this.world.getHomeBounds(), this.world.getContentFactor());
|
|
|
|
// Create the image loader
|
|
this.imageLoader = new $.ImageLoader({
|
|
jobLimit: this.imageLoaderLimit,
|
|
timeout: options.timeout,
|
|
tileRetryMax: this.tileRetryMax,
|
|
tileRetryDelay: this.tileRetryDelay
|
|
});
|
|
|
|
// Create the tile cache
|
|
this.tileCache = new $.TileCache({
|
|
maxImageCacheCount: this.maxImageCacheCount
|
|
});
|
|
|
|
// Create the drawer
|
|
this.drawer = new $.Drawer({
|
|
viewer: this,
|
|
viewport: this.viewport,
|
|
element: this.canvas,
|
|
debugGridColor: this.debugGridColor
|
|
});
|
|
|
|
// Overlay container
|
|
this.overlaysContainer = $.makeNeutralElement( "div" );
|
|
this.canvas.appendChild( this.overlaysContainer );
|
|
|
|
// Now that we have a drawer, see if it supports rotate. If not we need to remove the rotate buttons
|
|
if (!this.drawer.canRotate()) {
|
|
// Disable/remove the rotate left/right buttons since they aren't supported
|
|
if (this.rotateLeft) {
|
|
i = this.buttonGroup.buttons.indexOf(this.rotateLeft);
|
|
this.buttonGroup.buttons.splice(i, 1);
|
|
this.buttonGroup.element.removeChild(this.rotateLeft.element);
|
|
}
|
|
if (this.rotateRight) {
|
|
i = this.buttonGroup.buttons.indexOf(this.rotateRight);
|
|
this.buttonGroup.buttons.splice(i, 1);
|
|
this.buttonGroup.element.removeChild(this.rotateRight.element);
|
|
}
|
|
}
|
|
|
|
this._addUpdatePixelDensityRatioEvent();
|
|
|
|
//Instantiate a navigator if configured
|
|
if ( this.showNavigator){
|
|
this.navigator = new $.Navigator({
|
|
element: this.navigatorElement,
|
|
id: this.navigatorId,
|
|
position: this.navigatorPosition,
|
|
sizeRatio: this.navigatorSizeRatio,
|
|
maintainSizeRatio: this.navigatorMaintainSizeRatio,
|
|
top: this.navigatorTop,
|
|
left: this.navigatorLeft,
|
|
width: this.navigatorWidth,
|
|
height: this.navigatorHeight,
|
|
autoResize: this.navigatorAutoResize,
|
|
autoFade: this.navigatorAutoFade,
|
|
prefixUrl: this.prefixUrl,
|
|
viewer: this,
|
|
navigatorRotate: this.navigatorRotate,
|
|
background: this.navigatorBackground,
|
|
opacity: this.navigatorOpacity,
|
|
borderColor: this.navigatorBorderColor,
|
|
displayRegionColor: this.navigatorDisplayRegionColor,
|
|
crossOriginPolicy: this.crossOriginPolicy,
|
|
animationTime: this.animationTime,
|
|
});
|
|
}
|
|
|
|
// Sequence mode
|
|
if (this.sequenceMode) {
|
|
this.bindSequenceControls();
|
|
}
|
|
|
|
// Open initial tilesources
|
|
if (this.tileSources) {
|
|
this.open( this.tileSources );
|
|
}
|
|
|
|
// Add custom controls
|
|
for ( i = 0; i < this.customControls.length; i++ ) {
|
|
this.addControl(
|
|
this.customControls[ i ].id,
|
|
{anchor: this.customControls[ i ].anchor}
|
|
);
|
|
}
|
|
|
|
// Initial fade out
|
|
$.requestAnimationFrame( function(){
|
|
beginControlsAutoHide( _this );
|
|
} );
|
|
|
|
// Initial canvas options
|
|
if ( this.imageSmoothingEnabled !== undefined && !this.imageSmoothingEnabled){
|
|
this.drawer.setImageSmoothingEnabled(this.imageSmoothingEnabled);
|
|
}
|
|
|
|
// Register the viewer
|
|
$._viewers.set(this.element, this);
|
|
};
|
|
|
|
$.extend( $.Viewer.prototype, $.EventSource.prototype, $.ControlDock.prototype, /** @lends OpenSeadragon.Viewer.prototype */{
|
|
|
|
|
|
/**
|
|
* @function
|
|
* @returns {Boolean}
|
|
*/
|
|
isOpen: function () {
|
|
return !!this.world.getItemCount();
|
|
},
|
|
|
|
// deprecated
|
|
openDzi: function ( dzi ) {
|
|
$.console.error( "[Viewer.openDzi] this function is deprecated; use Viewer.open() instead." );
|
|
return this.open( dzi );
|
|
},
|
|
|
|
// deprecated
|
|
openTileSource: function ( tileSource ) {
|
|
$.console.error( "[Viewer.openTileSource] this function is deprecated; use Viewer.open() instead." );
|
|
return this.open( tileSource );
|
|
},
|
|
|
|
//deprecated
|
|
get buttons () {
|
|
$.console.warn('Viewer.buttons is deprecated; Please use Viewer.buttonGroup');
|
|
return this.buttonGroup;
|
|
},
|
|
|
|
/**
|
|
* Open tiled images into the viewer, closing any others.
|
|
* To get the TiledImage instance created by open, add an event listener for
|
|
* {@link OpenSeadragon.Viewer.html#.event:open}, which when fired can be used to get access
|
|
* to the instance, i.e., viewer.world.getItemAt(0).
|
|
* @function
|
|
* @param {Array|String|Object|Function} tileSources - This can be a TiledImage
|
|
* specifier, a TileSource specifier, or an array of either. A TiledImage specifier
|
|
* is the same as the options parameter for {@link OpenSeadragon.Viewer#addTiledImage},
|
|
* except for the index property; images are added in sequence.
|
|
* A TileSource specifier is anything you could pass as the tileSource property
|
|
* of the options parameter for {@link OpenSeadragon.Viewer#addTiledImage}.
|
|
* @param {Number} initialPage - If sequenceMode is true, display this page initially
|
|
* for the given tileSources. If specified, will overwrite the Viewer's existing initialPage property.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:open
|
|
* @fires OpenSeadragon.Viewer.event:open-failed
|
|
*/
|
|
open: function (tileSources, initialPage) {
|
|
var _this = this;
|
|
|
|
this.close();
|
|
|
|
if (!tileSources) {
|
|
return this;
|
|
}
|
|
|
|
if (this.sequenceMode && $.isArray(tileSources)) {
|
|
if (this.referenceStrip) {
|
|
this.referenceStrip.destroy();
|
|
this.referenceStrip = null;
|
|
}
|
|
|
|
if (typeof initialPage !== 'undefined' && !isNaN(initialPage)) {
|
|
this.initialPage = initialPage;
|
|
}
|
|
|
|
this.tileSources = tileSources;
|
|
this._sequenceIndex = Math.max(0, Math.min(this.tileSources.length - 1, this.initialPage));
|
|
if (this.tileSources.length) {
|
|
this.open(this.tileSources[this._sequenceIndex]);
|
|
|
|
if ( this.showReferenceStrip ){
|
|
this.addReferenceStrip();
|
|
}
|
|
}
|
|
|
|
this._updateSequenceButtons( this._sequenceIndex );
|
|
return this;
|
|
}
|
|
|
|
if (!$.isArray(tileSources)) {
|
|
tileSources = [tileSources];
|
|
}
|
|
|
|
if (!tileSources.length) {
|
|
return this;
|
|
}
|
|
|
|
this._opening = true;
|
|
|
|
var expected = tileSources.length;
|
|
var successes = 0;
|
|
var failures = 0;
|
|
var failEvent;
|
|
|
|
var checkCompletion = function() {
|
|
if (successes + failures === expected) {
|
|
if (successes) {
|
|
if (_this._firstOpen || !_this.preserveViewport) {
|
|
_this.viewport.goHome( true );
|
|
_this.viewport.update();
|
|
}
|
|
|
|
_this._firstOpen = false;
|
|
|
|
var source = tileSources[0];
|
|
if (source.tileSource) {
|
|
source = source.tileSource;
|
|
}
|
|
|
|
// Global overlays
|
|
if( _this.overlays && !_this.preserveOverlays ){
|
|
for ( var i = 0; i < _this.overlays.length; i++ ) {
|
|
_this.currentOverlays[ i ] = getOverlayObject( _this, _this.overlays[ i ] );
|
|
}
|
|
}
|
|
|
|
_this._drawOverlays();
|
|
_this._opening = false;
|
|
|
|
/**
|
|
* Raised when the viewer has opened and loaded one or more TileSources.
|
|
*
|
|
* @event open
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {OpenSeadragon.TileSource} source - The tile source that was opened.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
// TODO: what if there are multiple sources?
|
|
_this.raiseEvent( 'open', { source: source } );
|
|
} else {
|
|
_this._opening = false;
|
|
|
|
/**
|
|
* Raised when an error occurs loading a TileSource.
|
|
*
|
|
* @event open-failed
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {String} message - Information about what failed.
|
|
* @property {String} source - The tile source that failed.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
_this.raiseEvent( 'open-failed', failEvent );
|
|
}
|
|
}
|
|
};
|
|
|
|
var doOne = function(options) {
|
|
if (!$.isPlainObject(options) || !options.tileSource) {
|
|
options = {
|
|
tileSource: options
|
|
};
|
|
}
|
|
|
|
if (options.index !== undefined) {
|
|
$.console.error('[Viewer.open] setting indexes here is not supported; use addTiledImage instead');
|
|
delete options.index;
|
|
}
|
|
|
|
if (options.collectionImmediately === undefined) {
|
|
options.collectionImmediately = true;
|
|
}
|
|
|
|
var originalSuccess = options.success;
|
|
options.success = function(event) {
|
|
successes++;
|
|
|
|
// TODO: now that options has other things besides tileSource, the overlays
|
|
// should probably be at the options level, not the tileSource level.
|
|
if (options.tileSource.overlays) {
|
|
for (var i = 0; i < options.tileSource.overlays.length; i++) {
|
|
_this.addOverlay(options.tileSource.overlays[i]);
|
|
}
|
|
}
|
|
|
|
if (originalSuccess) {
|
|
originalSuccess(event);
|
|
}
|
|
|
|
checkCompletion();
|
|
};
|
|
|
|
var originalError = options.error;
|
|
options.error = function(event) {
|
|
failures++;
|
|
|
|
if (!failEvent) {
|
|
failEvent = event;
|
|
}
|
|
|
|
if (originalError) {
|
|
originalError(event);
|
|
}
|
|
|
|
checkCompletion();
|
|
};
|
|
|
|
_this.addTiledImage(options);
|
|
};
|
|
|
|
// TileSources
|
|
for (var i = 0; i < tileSources.length; i++) {
|
|
doOne(tileSources[i]);
|
|
}
|
|
|
|
return this;
|
|
},
|
|
|
|
|
|
/**
|
|
* @function
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:close
|
|
*/
|
|
close: function ( ) {
|
|
if ( !THIS[ this.hash ] ) {
|
|
//this viewer has already been destroyed: returning immediately
|
|
return this;
|
|
}
|
|
|
|
this._opening = false;
|
|
|
|
if ( this.navigator ) {
|
|
this.navigator.close();
|
|
}
|
|
|
|
if (!this.preserveOverlays) {
|
|
this.clearOverlays();
|
|
this.overlaysContainer.innerHTML = "";
|
|
}
|
|
|
|
THIS[ this.hash ].animating = false;
|
|
|
|
this.world.removeAll();
|
|
this.imageLoader.clear();
|
|
|
|
/**
|
|
* Raised when the viewer is closed (see {@link OpenSeadragon.Viewer#close}).
|
|
*
|
|
* @event close
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'close' );
|
|
|
|
return this;
|
|
},
|
|
|
|
|
|
/**
|
|
* Function to destroy the viewer and clean up everything created by OpenSeadragon.
|
|
*
|
|
* Example:
|
|
* var viewer = OpenSeadragon({
|
|
* [...]
|
|
* });
|
|
*
|
|
* //when you are done with the viewer:
|
|
* viewer.destroy();
|
|
* viewer = null; //important
|
|
*
|
|
* @function
|
|
* @fires OpenSeadragon.Viewer.event:before-destroy
|
|
* @fires OpenSeadragon.Viewer.event:destroy
|
|
*/
|
|
destroy: function( ) {
|
|
if ( !THIS[ this.hash ] ) {
|
|
//this viewer has already been destroyed: returning immediately
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* Raised when the viewer is about to be destroyed (see {@link OpenSeadragon.Viewer#before-destroy}).
|
|
*
|
|
* @event before-destroy
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'before-destroy' );
|
|
|
|
this._removeUpdatePixelDensityRatioEvent();
|
|
|
|
this.close();
|
|
|
|
this.clearOverlays();
|
|
this.overlaysContainer.innerHTML = "";
|
|
|
|
//TODO: implement this...
|
|
//this.unbindSequenceControls()
|
|
//this.unbindStandardControls()
|
|
if (this._resizeObserver){
|
|
this._resizeObserver.disconnect();
|
|
}
|
|
|
|
if (this.referenceStrip) {
|
|
this.referenceStrip.destroy();
|
|
this.referenceStrip = null;
|
|
}
|
|
|
|
if ( this._updateRequestId !== null ) {
|
|
$.cancelAnimationFrame( this._updateRequestId );
|
|
this._updateRequestId = null;
|
|
}
|
|
|
|
if ( this.drawer ) {
|
|
this.drawer.destroy();
|
|
}
|
|
|
|
if ( this.navigator ) {
|
|
this.navigator.destroy();
|
|
THIS[ this.navigator.hash ] = null;
|
|
delete THIS[ this.navigator.hash ];
|
|
this.navigator = null;
|
|
}
|
|
|
|
|
|
if (this.buttonGroup) {
|
|
this.buttonGroup.destroy();
|
|
} else if (this.customButtons) {
|
|
while (this.customButtons.length) {
|
|
this.customButtons.pop().destroy();
|
|
}
|
|
}
|
|
|
|
if (this.paging) {
|
|
this.paging.destroy();
|
|
}
|
|
|
|
// Go through top element (passed to us) and remove all children
|
|
// Use removeChild to make sure it handles SVG or any non-html
|
|
// also it performs better - http://jsperf.com/innerhtml-vs-removechild/15
|
|
if (this.element){
|
|
while (this.element.firstChild) {
|
|
this.element.removeChild(this.element.firstChild);
|
|
}
|
|
}
|
|
|
|
this.container.onsubmit = null;
|
|
this.clearControls();
|
|
|
|
// destroy the mouse trackers
|
|
if (this.innerTracker){
|
|
this.innerTracker.destroy();
|
|
}
|
|
if (this.outerTracker){
|
|
this.outerTracker.destroy();
|
|
}
|
|
|
|
THIS[ this.hash ] = null;
|
|
delete THIS[ this.hash ];
|
|
|
|
// clear all our references to dom objects
|
|
this.canvas = null;
|
|
this.container = null;
|
|
|
|
// Unregister the viewer
|
|
$._viewers.delete(this.element);
|
|
|
|
// clear our reference to the main element - they will need to pass it in again, creating a new viewer
|
|
this.element = null;
|
|
|
|
/**
|
|
* Raised when the viewer is destroyed (see {@link OpenSeadragon.Viewer#destroy}).
|
|
*
|
|
* @event destroy
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'destroy' );
|
|
|
|
this.removeAllHandlers();
|
|
},
|
|
|
|
/**
|
|
* @function
|
|
* @returns {Boolean}
|
|
*/
|
|
isMouseNavEnabled: function () {
|
|
return this.innerTracker.isTracking();
|
|
},
|
|
|
|
/**
|
|
* @function
|
|
* @param {Boolean} enabled - true to enable, false to disable
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:mouse-enabled
|
|
*/
|
|
setMouseNavEnabled: function( enabled ){
|
|
this.innerTracker.setTracking( enabled );
|
|
this.outerTracker.setTracking( enabled );
|
|
/**
|
|
* Raised when mouse/touch navigation is enabled or disabled (see {@link OpenSeadragon.Viewer#setMouseNavEnabled}).
|
|
*
|
|
* @event mouse-enabled
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} enabled
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'mouse-enabled', { enabled: enabled } );
|
|
return this;
|
|
},
|
|
|
|
|
|
/**
|
|
* @function
|
|
* @returns {Boolean}
|
|
*/
|
|
areControlsEnabled: function () {
|
|
var enabled = this.controls.length,
|
|
i;
|
|
for( i = 0; i < this.controls.length; i++ ){
|
|
enabled = enabled && this.controls[ i ].isVisible();
|
|
}
|
|
return enabled;
|
|
},
|
|
|
|
|
|
/**
|
|
* Shows or hides the controls (e.g. the default navigation buttons).
|
|
*
|
|
* @function
|
|
* @param {Boolean} true to show, false to hide.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:controls-enabled
|
|
*/
|
|
setControlsEnabled: function( enabled ) {
|
|
if( enabled ){
|
|
abortControlsAutoHide( this );
|
|
} else {
|
|
beginControlsAutoHide( this );
|
|
}
|
|
/**
|
|
* Raised when the navigation controls are shown or hidden (see {@link OpenSeadragon.Viewer#setControlsEnabled}).
|
|
*
|
|
* @event controls-enabled
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} enabled
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'controls-enabled', { enabled: enabled } );
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Turns debugging mode on or off for this viewer.
|
|
*
|
|
* @function
|
|
* @param {Boolean} debugMode true to turn debug on, false to turn debug off.
|
|
*/
|
|
setDebugMode: function(debugMode){
|
|
|
|
for (var i = 0; i < this.world.getItemCount(); i++) {
|
|
this.world.getItemAt(i).debugMode = debugMode;
|
|
}
|
|
|
|
this.debugMode = debugMode;
|
|
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}
|
|
*/
|
|
isFullPage: function () {
|
|
return THIS[ this.hash ].fullPage;
|
|
},
|
|
|
|
|
|
/**
|
|
* Toggle full page mode.
|
|
* @function
|
|
* @param {Boolean} fullPage
|
|
* If true, enter full page mode. If false, exit full page mode.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:pre-full-page
|
|
* @fires OpenSeadragon.Viewer.event:full-page
|
|
*/
|
|
setFullPage: function( fullPage ) {
|
|
|
|
var body = document.body,
|
|
bodyStyle = body.style,
|
|
docStyle = document.documentElement.style,
|
|
_this = this,
|
|
nodes,
|
|
i;
|
|
|
|
//don't bother modifying the DOM if we are already in full page mode.
|
|
if ( fullPage === this.isFullPage() ) {
|
|
return this;
|
|
}
|
|
|
|
var fullPageEventArgs = {
|
|
fullPage: fullPage,
|
|
preventDefaultAction: false
|
|
};
|
|
/**
|
|
* Raised when the viewer is about to change to/from full-page mode (see {@link OpenSeadragon.Viewer#setFullPage}).
|
|
*
|
|
* @event pre-full-page
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} fullPage - True if entering full-page mode, false if exiting full-page mode.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent full-page mode change. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'pre-full-page', fullPageEventArgs );
|
|
if ( fullPageEventArgs.preventDefaultAction ) {
|
|
return this;
|
|
}
|
|
|
|
if ( fullPage ) {
|
|
|
|
this.elementSize = $.getElementSize( this.element );
|
|
this.pageScroll = $.getPageScroll();
|
|
|
|
this.elementMargin = this.element.style.margin;
|
|
this.element.style.margin = "0";
|
|
this.elementPadding = this.element.style.padding;
|
|
this.element.style.padding = "0";
|
|
|
|
this.bodyMargin = bodyStyle.margin;
|
|
this.docMargin = docStyle.margin;
|
|
bodyStyle.margin = "0";
|
|
docStyle.margin = "0";
|
|
|
|
this.bodyPadding = bodyStyle.padding;
|
|
this.docPadding = docStyle.padding;
|
|
bodyStyle.padding = "0";
|
|
docStyle.padding = "0";
|
|
|
|
this.bodyWidth = bodyStyle.width;
|
|
this.docWidth = docStyle.width;
|
|
bodyStyle.width = "100%";
|
|
docStyle.width = "100%";
|
|
|
|
this.bodyHeight = bodyStyle.height;
|
|
this.docHeight = docStyle.height;
|
|
bodyStyle.height = "100%";
|
|
docStyle.height = "100%";
|
|
|
|
this.bodyDisplay = bodyStyle.display;
|
|
bodyStyle.display = "block";
|
|
|
|
//when entering full screen on the ipad it wasn't sufficient to leave
|
|
//the body intact as only only the top half of the screen would
|
|
//respond to touch events on the canvas, while the bottom half treated
|
|
//them as touch events on the document body. Thus we remove and store
|
|
//the bodies elements and replace them when we leave full screen.
|
|
this.previousBody = [];
|
|
THIS[ this.hash ].prevElementParent = this.element.parentNode;
|
|
THIS[ this.hash ].prevNextSibling = this.element.nextSibling;
|
|
THIS[ this.hash ].prevElementWidth = this.element.style.width;
|
|
THIS[ this.hash ].prevElementHeight = this.element.style.height;
|
|
nodes = body.childNodes.length;
|
|
for ( i = 0; i < nodes; i++ ) {
|
|
this.previousBody.push( body.childNodes[ 0 ] );
|
|
body.removeChild( body.childNodes[ 0 ] );
|
|
}
|
|
|
|
//If we've got a toolbar, we need to enable the user to use css to
|
|
//preserve it in fullpage mode
|
|
if ( this.toolbar && this.toolbar.element ) {
|
|
//save a reference to the parent so we can put it back
|
|
//in the long run we need a better strategy
|
|
this.toolbar.parentNode = this.toolbar.element.parentNode;
|
|
this.toolbar.nextSibling = this.toolbar.element.nextSibling;
|
|
body.appendChild( this.toolbar.element );
|
|
|
|
//Make sure the user has some ability to style the toolbar based
|
|
//on the mode
|
|
$.addClass( this.toolbar.element, 'fullpage' );
|
|
}
|
|
|
|
$.addClass( this.element, 'fullpage' );
|
|
body.appendChild( this.element );
|
|
|
|
this.element.style.height = '100vh';
|
|
this.element.style.width = '100vw';
|
|
|
|
if ( this.toolbar && this.toolbar.element ) {
|
|
this.element.style.height = (
|
|
$.getElementSize( this.element ).y - $.getElementSize( this.toolbar.element ).y
|
|
) + 'px';
|
|
}
|
|
|
|
THIS[ this.hash ].fullPage = true;
|
|
|
|
// mouse will be inside container now
|
|
$.delegate( this, onContainerEnter )( {} );
|
|
|
|
} else {
|
|
|
|
this.element.style.margin = this.elementMargin;
|
|
this.element.style.padding = this.elementPadding;
|
|
|
|
bodyStyle.margin = this.bodyMargin;
|
|
docStyle.margin = this.docMargin;
|
|
|
|
bodyStyle.padding = this.bodyPadding;
|
|
docStyle.padding = this.docPadding;
|
|
|
|
bodyStyle.width = this.bodyWidth;
|
|
docStyle.width = this.docWidth;
|
|
|
|
bodyStyle.height = this.bodyHeight;
|
|
docStyle.height = this.docHeight;
|
|
|
|
bodyStyle.display = this.bodyDisplay;
|
|
|
|
body.removeChild( this.element );
|
|
nodes = this.previousBody.length;
|
|
for ( i = 0; i < nodes; i++ ) {
|
|
body.appendChild( this.previousBody.shift() );
|
|
}
|
|
|
|
$.removeClass( this.element, 'fullpage' );
|
|
THIS[ this.hash ].prevElementParent.insertBefore(
|
|
this.element,
|
|
THIS[ this.hash ].prevNextSibling
|
|
);
|
|
|
|
//If we've got a toolbar, we need to enable the user to use css to
|
|
//reset it to its original state
|
|
if ( this.toolbar && this.toolbar.element ) {
|
|
body.removeChild( this.toolbar.element );
|
|
|
|
//Make sure the user has some ability to style the toolbar based
|
|
//on the mode
|
|
$.removeClass( this.toolbar.element, 'fullpage' );
|
|
|
|
this.toolbar.parentNode.insertBefore(
|
|
this.toolbar.element,
|
|
this.toolbar.nextSibling
|
|
);
|
|
delete this.toolbar.parentNode;
|
|
delete this.toolbar.nextSibling;
|
|
}
|
|
|
|
this.element.style.width = THIS[ this.hash ].prevElementWidth;
|
|
this.element.style.height = THIS[ this.hash ].prevElementHeight;
|
|
|
|
// After exiting fullPage or fullScreen, it can take some time
|
|
// before the browser can actually set the scroll.
|
|
var restoreScrollCounter = 0;
|
|
var restoreScroll = function() {
|
|
$.setPageScroll( _this.pageScroll );
|
|
var pageScroll = $.getPageScroll();
|
|
restoreScrollCounter++;
|
|
if (restoreScrollCounter < 10 &&
|
|
(pageScroll.x !== _this.pageScroll.x ||
|
|
pageScroll.y !== _this.pageScroll.y)) {
|
|
$.requestAnimationFrame( restoreScroll );
|
|
}
|
|
};
|
|
$.requestAnimationFrame( restoreScroll );
|
|
|
|
THIS[ this.hash ].fullPage = false;
|
|
|
|
// mouse will likely be outside now
|
|
$.delegate( this, onContainerLeave )( { } );
|
|
|
|
}
|
|
|
|
if ( this.navigator && this.viewport ) {
|
|
this.navigator.update( this.viewport );
|
|
}
|
|
|
|
/**
|
|
* Raised when the viewer has changed to/from full-page mode (see {@link OpenSeadragon.Viewer#setFullPage}).
|
|
*
|
|
* @event full-page
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} fullPage - True if changed to full-page mode, false if exited full-page mode.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'full-page', { fullPage: fullPage } );
|
|
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Toggle full screen mode if supported. Toggle full page mode otherwise.
|
|
* @function
|
|
* @param {Boolean} fullScreen
|
|
* If true, enter full screen mode. If false, exit full screen mode.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:pre-full-screen
|
|
* @fires OpenSeadragon.Viewer.event:full-screen
|
|
*/
|
|
setFullScreen: function( fullScreen ) {
|
|
var _this = this;
|
|
|
|
if ( !$.supportsFullScreen ) {
|
|
return this.setFullPage( fullScreen );
|
|
}
|
|
|
|
if ( $.isFullScreen() === fullScreen ) {
|
|
return this;
|
|
}
|
|
|
|
var fullScreeEventArgs = {
|
|
fullScreen: fullScreen,
|
|
preventDefaultAction: false
|
|
};
|
|
/**
|
|
* Raised when the viewer is about to change to/from full-screen mode (see {@link OpenSeadragon.Viewer#setFullScreen}).
|
|
* Note: the pre-full-screen event is not raised when the user is exiting
|
|
* full-screen mode by pressing the Esc key. In that case, consider using
|
|
* the full-screen, pre-full-page or full-page events.
|
|
*
|
|
* @event pre-full-screen
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} fullScreen - True if entering full-screen mode, false if exiting full-screen mode.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent full-screen mode change. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'pre-full-screen', fullScreeEventArgs );
|
|
if ( fullScreeEventArgs.preventDefaultAction ) {
|
|
return this;
|
|
}
|
|
|
|
if ( fullScreen ) {
|
|
|
|
this.setFullPage( true );
|
|
// If the full page mode is not actually entered, we need to prevent
|
|
// the full screen mode.
|
|
if ( !this.isFullPage() ) {
|
|
return this;
|
|
}
|
|
|
|
this.fullPageStyleWidth = this.element.style.width;
|
|
this.fullPageStyleHeight = this.element.style.height;
|
|
this.element.style.width = '100%';
|
|
this.element.style.height = '100%';
|
|
|
|
var onFullScreenChange = function() {
|
|
var isFullScreen = $.isFullScreen();
|
|
if ( !isFullScreen ) {
|
|
$.removeEvent( document, $.fullScreenEventName, onFullScreenChange );
|
|
$.removeEvent( document, $.fullScreenErrorEventName, onFullScreenChange );
|
|
|
|
_this.setFullPage( false );
|
|
if ( _this.isFullPage() ) {
|
|
_this.element.style.width = _this.fullPageStyleWidth;
|
|
_this.element.style.height = _this.fullPageStyleHeight;
|
|
}
|
|
}
|
|
if ( _this.navigator && _this.viewport ) {
|
|
//09/08/2018 - Fabroh : Fix issue #1504 : Ensure to get the navigator updated on fullscreen out with custom location with a timeout
|
|
setTimeout(function(){
|
|
_this.navigator.update( _this.viewport );
|
|
});
|
|
}
|
|
/**
|
|
* Raised when the viewer has changed to/from full-screen mode (see {@link OpenSeadragon.Viewer#setFullScreen}).
|
|
*
|
|
* @event full-screen
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} fullScreen - True if changed to full-screen mode, false if exited full-screen mode.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
_this.raiseEvent( 'full-screen', { fullScreen: isFullScreen } );
|
|
};
|
|
$.addEvent( document, $.fullScreenEventName, onFullScreenChange );
|
|
$.addEvent( document, $.fullScreenErrorEventName, onFullScreenChange );
|
|
|
|
$.requestFullScreen( document.body );
|
|
|
|
} else {
|
|
$.exitFullScreen();
|
|
}
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* @function
|
|
* @returns {Boolean}
|
|
*/
|
|
isVisible: function () {
|
|
return this.container.style.visibility !== "hidden";
|
|
},
|
|
|
|
|
|
//
|
|
/**
|
|
* @function
|
|
* @returns {Boolean} returns true if the viewer is in fullscreen
|
|
*/
|
|
isFullScreen: function () {
|
|
return $.isFullScreen() && this.isFullPage();
|
|
},
|
|
|
|
/**
|
|
* @function
|
|
* @param {Boolean} visible
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:visible
|
|
*/
|
|
setVisible: function( visible ){
|
|
this.container.style.visibility = visible ? "" : "hidden";
|
|
/**
|
|
* Raised when the viewer is shown or hidden (see {@link OpenSeadragon.Viewer#setVisible}).
|
|
*
|
|
* @event visible
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Boolean} visible
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'visible', { visible: visible } );
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Add a tiled image to the viewer.
|
|
* options.tileSource can be anything that {@link OpenSeadragon.Viewer#open}
|
|
* supports except arrays of images.
|
|
* Note that you can specify options.width or options.height, but not both.
|
|
* The other dimension will be calculated according to the item's aspect ratio.
|
|
* If collectionMode is on (see {@link OpenSeadragon.Options}), the new image is
|
|
* automatically arranged with the others.
|
|
* @function
|
|
* @param {Object} options
|
|
* @param {String|Object|Function} options.tileSource - The TileSource specifier.
|
|
* A String implies a url used to determine the tileSource implementation
|
|
* based on the file extension of url. JSONP is implied by *.js,
|
|
* otherwise the url is retrieved as text and the resulting text is
|
|
* introspected to determine if its json, xml, or text and parsed.
|
|
* An Object implies an inline configuration which has a single
|
|
* property sufficient for being able to determine tileSource
|
|
* implementation. If the object has a property which is a function
|
|
* named 'getTileUrl', it is treated as a custom TileSource.
|
|
* @param {Number} [options.index] The index of the item. Added on top of
|
|
* all other items if not specified.
|
|
* @param {Boolean} [options.replace=false] If true, the item at options.index will be
|
|
* removed and the new item is added in its place. options.tileSource will be
|
|
* interpreted and fetched if necessary before the old item is removed to avoid leaving
|
|
* a gap in the world.
|
|
* @param {Number} [options.x=0] The X position for the image in viewport coordinates.
|
|
* @param {Number} [options.y=0] The Y position for the image in viewport coordinates.
|
|
* @param {Number} [options.width=1] The width for the image in viewport coordinates.
|
|
* @param {Number} [options.height] The height for the image in viewport coordinates.
|
|
* @param {OpenSeadragon.Rect} [options.fitBounds] The bounds in viewport coordinates
|
|
* to fit the image into. If specified, x, y, width and height get ignored.
|
|
* @param {OpenSeadragon.Placement} [options.fitBoundsPlacement=OpenSeadragon.Placement.CENTER]
|
|
* How to anchor the image in the bounds if options.fitBounds is set.
|
|
* @param {OpenSeadragon.Rect} [options.clip] - An area, in image pixels, to clip to
|
|
* (portions of the image outside of this area will not be visible). Only works on
|
|
* browsers that support the HTML5 canvas.
|
|
* @param {Number} [options.opacity=1] Proportional opacity of the tiled images (1=opaque, 0=hidden)
|
|
* @param {Boolean} [options.preload=false] Default switch for loading hidden images (true loads, false blocks)
|
|
* @param {Number} [options.degrees=0] Initial rotation of the tiled image around
|
|
* its top left corner in degrees.
|
|
* @param {Boolean} [options.flipped=false] Whether to horizontally flip the image.
|
|
* @param {String} [options.compositeOperation] How the image is composited onto other images.
|
|
* @param {String} [options.crossOriginPolicy] The crossOriginPolicy for this specific image,
|
|
* overriding viewer.crossOriginPolicy.
|
|
* @param {Boolean} [options.ajaxWithCredentials] Whether to set withCredentials on tile AJAX
|
|
* @param {Boolean} [options.loadTilesWithAjax]
|
|
* Whether to load tile data using AJAX requests.
|
|
* Defaults to the setting in {@link OpenSeadragon.Options}.
|
|
* @param {Object} [options.ajaxHeaders]
|
|
* 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).
|
|
* @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.
|
|
* @param {Function} [options.error] A function that gets called if the image is
|
|
* unable to be added. It's passed the error event object, which contains "message"
|
|
* and "source" properties.
|
|
* @param {Boolean} [options.collectionImmediately=false] If collectionMode is on,
|
|
* specifies whether to snap to the new arrangement immediately or to animate to it.
|
|
* @param {String|CanvasGradient|CanvasPattern|Function} [options.placeholderFillStyle] - See {@link OpenSeadragon.Options}.
|
|
* @fires OpenSeadragon.World.event:add-item
|
|
* @fires OpenSeadragon.Viewer.event:add-item-failed
|
|
*/
|
|
addTiledImage: function( options ) {
|
|
$.console.assert(options, "[Viewer.addTiledImage] options is required");
|
|
$.console.assert(options.tileSource, "[Viewer.addTiledImage] options.tileSource is required");
|
|
$.console.assert(!options.replace || (options.index > -1 && options.index < this.world.getItemCount()),
|
|
"[Viewer.addTiledImage] if options.replace is used, options.index must be a valid index in Viewer.world");
|
|
|
|
var _this = this;
|
|
|
|
if (options.replace) {
|
|
options.replaceItem = _this.world.getItemAt(options.index);
|
|
}
|
|
|
|
this._hideMessage();
|
|
|
|
if (options.placeholderFillStyle === undefined) {
|
|
options.placeholderFillStyle = this.placeholderFillStyle;
|
|
}
|
|
if (options.opacity === undefined) {
|
|
options.opacity = this.opacity;
|
|
}
|
|
if (options.preload === undefined) {
|
|
options.preload = this.preload;
|
|
}
|
|
if (options.compositeOperation === undefined) {
|
|
options.compositeOperation = this.compositeOperation;
|
|
}
|
|
if (options.crossOriginPolicy === undefined) {
|
|
options.crossOriginPolicy = options.tileSource.crossOriginPolicy !== undefined ? options.tileSource.crossOriginPolicy : this.crossOriginPolicy;
|
|
}
|
|
if (options.ajaxWithCredentials === undefined) {
|
|
options.ajaxWithCredentials = this.ajaxWithCredentials;
|
|
}
|
|
if (options.loadTilesWithAjax === undefined) {
|
|
options.loadTilesWithAjax = this.loadTilesWithAjax;
|
|
}
|
|
if (!$.isPlainObject(options.ajaxHeaders)) {
|
|
options.ajaxHeaders = {};
|
|
}
|
|
|
|
var myQueueItem = {
|
|
options: options
|
|
};
|
|
|
|
function raiseAddItemFailed( event ) {
|
|
for (var i = 0; i < _this._loadQueue.length; i++) {
|
|
if (_this._loadQueue[i] === myQueueItem) {
|
|
_this._loadQueue.splice(i, 1);
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (_this._loadQueue.length === 0) {
|
|
refreshWorld(myQueueItem);
|
|
}
|
|
|
|
/**
|
|
* Raised when an error occurs while adding a item.
|
|
* @event add-item-failed
|
|
* @memberOf OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {String} message
|
|
* @property {String} source
|
|
* @property {Object} options The options passed to the addTiledImage method.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
_this.raiseEvent( 'add-item-failed', event );
|
|
|
|
if (options.error) {
|
|
options.error(event);
|
|
}
|
|
}
|
|
|
|
function refreshWorld(theItem) {
|
|
if (_this.collectionMode) {
|
|
_this.world.arrange({
|
|
immediately: theItem.options.collectionImmediately,
|
|
rows: _this.collectionRows,
|
|
columns: _this.collectionColumns,
|
|
layout: _this.collectionLayout,
|
|
tileSize: _this.collectionTileSize,
|
|
tileMargin: _this.collectionTileMargin
|
|
});
|
|
_this.world.setAutoRefigureSizes(true);
|
|
}
|
|
}
|
|
|
|
if ($.isArray(options.tileSource)) {
|
|
setTimeout(function() {
|
|
raiseAddItemFailed({
|
|
message: "[Viewer.addTiledImage] Sequences can not be added; add them one at a time instead.",
|
|
source: options.tileSource,
|
|
options: options
|
|
});
|
|
});
|
|
return;
|
|
}
|
|
|
|
this._loadQueue.push(myQueueItem);
|
|
|
|
function processReadyItems() {
|
|
var queueItem, tiledImage, optionsClone;
|
|
while (_this._loadQueue.length) {
|
|
queueItem = _this._loadQueue[0];
|
|
if (!queueItem.tileSource) {
|
|
break;
|
|
}
|
|
|
|
_this._loadQueue.splice(0, 1);
|
|
|
|
if (queueItem.options.replace) {
|
|
var newIndex = _this.world.getIndexOfItem(queueItem.options.replaceItem);
|
|
if (newIndex !== -1) {
|
|
queueItem.options.index = newIndex;
|
|
}
|
|
_this.world.removeItem(queueItem.options.replaceItem);
|
|
}
|
|
|
|
tiledImage = new $.TiledImage({
|
|
viewer: _this,
|
|
source: queueItem.tileSource,
|
|
viewport: _this.viewport,
|
|
drawer: _this.drawer,
|
|
tileCache: _this.tileCache,
|
|
imageLoader: _this.imageLoader,
|
|
x: queueItem.options.x,
|
|
y: queueItem.options.y,
|
|
width: queueItem.options.width,
|
|
height: queueItem.options.height,
|
|
fitBounds: queueItem.options.fitBounds,
|
|
fitBoundsPlacement: queueItem.options.fitBoundsPlacement,
|
|
clip: queueItem.options.clip,
|
|
placeholderFillStyle: queueItem.options.placeholderFillStyle,
|
|
opacity: queueItem.options.opacity,
|
|
preload: queueItem.options.preload,
|
|
degrees: queueItem.options.degrees,
|
|
flipped: queueItem.options.flipped,
|
|
compositeOperation: queueItem.options.compositeOperation,
|
|
springStiffness: _this.springStiffness,
|
|
animationTime: _this.animationTime,
|
|
minZoomImageRatio: _this.minZoomImageRatio,
|
|
wrapHorizontal: _this.wrapHorizontal,
|
|
wrapVertical: _this.wrapVertical,
|
|
maxTilesPerFrame: _this.maxTilesPerFrame,
|
|
immediateRender: _this.immediateRender,
|
|
blendTime: _this.blendTime,
|
|
alwaysBlend: _this.alwaysBlend,
|
|
minPixelRatio: _this.minPixelRatio,
|
|
smoothTileEdgesMinZoom: _this.smoothTileEdgesMinZoom,
|
|
iOSDevice: _this.iOSDevice,
|
|
crossOriginPolicy: queueItem.options.crossOriginPolicy,
|
|
ajaxWithCredentials: queueItem.options.ajaxWithCredentials,
|
|
loadTilesWithAjax: queueItem.options.loadTilesWithAjax,
|
|
ajaxHeaders: queueItem.options.ajaxHeaders,
|
|
debugMode: _this.debugMode,
|
|
subPixelRoundingForTransparency: _this.subPixelRoundingForTransparency
|
|
});
|
|
|
|
if (_this.collectionMode) {
|
|
_this.world.setAutoRefigureSizes(false);
|
|
}
|
|
|
|
if (_this.navigator) {
|
|
optionsClone = $.extend({}, queueItem.options, {
|
|
replace: false, // navigator already removed the layer, nothing to replace
|
|
originalTiledImage: tiledImage,
|
|
tileSource: queueItem.tileSource
|
|
});
|
|
|
|
_this.navigator.addTiledImage(optionsClone);
|
|
}
|
|
|
|
_this.world.addItem( tiledImage, {
|
|
index: queueItem.options.index
|
|
});
|
|
|
|
if (_this._loadQueue.length === 0) {
|
|
//this restores the autoRefigureSizes flag to true.
|
|
refreshWorld(queueItem);
|
|
}
|
|
|
|
if (_this.world.getItemCount() === 1 && !_this.preserveViewport) {
|
|
_this.viewport.goHome(true);
|
|
}
|
|
|
|
if (queueItem.options.success) {
|
|
queueItem.options.success({
|
|
item: tiledImage
|
|
});
|
|
}
|
|
}
|
|
}
|
|
|
|
getTileSourceImplementation( this, options.tileSource, options, function( tileSource ) {
|
|
|
|
myQueueItem.tileSource = tileSource;
|
|
|
|
// add everybody at the front of the queue that's ready to go
|
|
processReadyItems();
|
|
}, function( event ) {
|
|
event.options = options;
|
|
raiseAddItemFailed(event);
|
|
|
|
// add everybody at the front of the queue that's ready to go
|
|
processReadyItems();
|
|
} );
|
|
},
|
|
|
|
/**
|
|
* Add a simple image to the viewer.
|
|
* The options are the same as the ones in {@link OpenSeadragon.Viewer#addTiledImage}
|
|
* except for options.tileSource which is replaced by options.url.
|
|
* @function
|
|
* @param {Object} options - See {@link OpenSeadragon.Viewer#addTiledImage}
|
|
* for all the options
|
|
* @param {String} options.url - The URL of the image to add.
|
|
* @fires OpenSeadragon.World.event:add-item
|
|
* @fires OpenSeadragon.Viewer.event:add-item-failed
|
|
*/
|
|
addSimpleImage: function(options) {
|
|
$.console.assert(options, "[Viewer.addSimpleImage] options is required");
|
|
$.console.assert(options.url, "[Viewer.addSimpleImage] options.url is required");
|
|
|
|
var opts = $.extend({}, options, {
|
|
tileSource: {
|
|
type: 'image',
|
|
url: options.url
|
|
}
|
|
});
|
|
delete opts.url;
|
|
this.addTiledImage(opts);
|
|
},
|
|
|
|
// deprecated
|
|
addLayer: function( options ) {
|
|
var _this = this;
|
|
|
|
$.console.error( "[Viewer.addLayer] this function is deprecated; use Viewer.addTiledImage() instead." );
|
|
|
|
var optionsClone = $.extend({}, options, {
|
|
success: function(event) {
|
|
_this.raiseEvent("add-layer", {
|
|
options: options,
|
|
drawer: event.item
|
|
});
|
|
},
|
|
error: function(event) {
|
|
_this.raiseEvent("add-layer-failed", event);
|
|
}
|
|
});
|
|
|
|
this.addTiledImage(optionsClone);
|
|
return this;
|
|
},
|
|
|
|
// deprecated
|
|
getLayerAtLevel: function( level ) {
|
|
$.console.error( "[Viewer.getLayerAtLevel] this function is deprecated; use World.getItemAt() instead." );
|
|
return this.world.getItemAt(level);
|
|
},
|
|
|
|
// deprecated
|
|
getLevelOfLayer: function( drawer ) {
|
|
$.console.error( "[Viewer.getLevelOfLayer] this function is deprecated; use World.getIndexOfItem() instead." );
|
|
return this.world.getIndexOfItem(drawer);
|
|
},
|
|
|
|
// deprecated
|
|
getLayersCount: function() {
|
|
$.console.error( "[Viewer.getLayersCount] this function is deprecated; use World.getItemCount() instead." );
|
|
return this.world.getItemCount();
|
|
},
|
|
|
|
// deprecated
|
|
setLayerLevel: function( drawer, level ) {
|
|
$.console.error( "[Viewer.setLayerLevel] this function is deprecated; use World.setItemIndex() instead." );
|
|
return this.world.setItemIndex(drawer, level);
|
|
},
|
|
|
|
// deprecated
|
|
removeLayer: function( drawer ) {
|
|
$.console.error( "[Viewer.removeLayer] this function is deprecated; use World.removeItem() instead." );
|
|
return this.world.removeItem(drawer);
|
|
},
|
|
|
|
/**
|
|
* Force the viewer to redraw its contents.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
*/
|
|
forceRedraw: function() {
|
|
THIS[ this.hash ].forceRedraw = true;
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Force the viewer to reset its size to match its container.
|
|
*/
|
|
forceResize: function() {
|
|
THIS[this.hash].needsResize = true;
|
|
THIS[this.hash].forceResize = true;
|
|
},
|
|
|
|
/**
|
|
* @function
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
*/
|
|
bindSequenceControls: function(){
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
// Image Sequence Controls
|
|
//////////////////////////////////////////////////////////////////////////
|
|
var onFocusHandler = $.delegate( this, onFocus ),
|
|
onBlurHandler = $.delegate( this, onBlur ),
|
|
onNextHandler = $.delegate( this, this.goToNextPage ),
|
|
onPreviousHandler = $.delegate( this, this.goToPreviousPage ),
|
|
navImages = this.navImages,
|
|
useGroup = true;
|
|
|
|
if( this.showSequenceControl ){
|
|
|
|
if( this.previousButton || this.nextButton ){
|
|
//if we are binding to custom buttons then layout and
|
|
//grouping is the responsibility of the page author
|
|
useGroup = false;
|
|
}
|
|
|
|
this.previousButton = new $.Button({
|
|
element: this.previousButton ? $.getElement( this.previousButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.PreviousPage" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.previous.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.previous.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.previous.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.previous.DOWN ),
|
|
onRelease: onPreviousHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
});
|
|
|
|
this.nextButton = new $.Button({
|
|
element: this.nextButton ? $.getElement( this.nextButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.NextPage" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.next.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.next.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.next.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.next.DOWN ),
|
|
onRelease: onNextHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
});
|
|
|
|
if( !this.navPrevNextWrap ){
|
|
this.previousButton.disable();
|
|
}
|
|
|
|
if (!this.tileSources || !this.tileSources.length) {
|
|
this.nextButton.disable();
|
|
}
|
|
|
|
if( useGroup ){
|
|
this.paging = new $.ButtonGroup({
|
|
buttons: [
|
|
this.previousButton,
|
|
this.nextButton
|
|
],
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold
|
|
});
|
|
|
|
this.pagingControl = this.paging.element;
|
|
|
|
if( this.toolbar ){
|
|
this.toolbar.addControl(
|
|
this.pagingControl,
|
|
{anchor: $.ControlAnchor.BOTTOM_RIGHT}
|
|
);
|
|
}else{
|
|
this.addControl(
|
|
this.pagingControl,
|
|
{anchor: this.sequenceControlAnchor || $.ControlAnchor.TOP_LEFT}
|
|
);
|
|
}
|
|
}
|
|
}
|
|
return this;
|
|
},
|
|
|
|
|
|
/**
|
|
* @function
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
*/
|
|
bindStandardControls: function(){
|
|
//////////////////////////////////////////////////////////////////////////
|
|
// Navigation Controls
|
|
//////////////////////////////////////////////////////////////////////////
|
|
var beginZoomingInHandler = $.delegate( this, beginZoomingIn ),
|
|
endZoomingHandler = $.delegate( this, endZooming ),
|
|
doSingleZoomInHandler = $.delegate( this, doSingleZoomIn ),
|
|
beginZoomingOutHandler = $.delegate( this, beginZoomingOut ),
|
|
doSingleZoomOutHandler = $.delegate( this, doSingleZoomOut ),
|
|
onHomeHandler = $.delegate( this, onHome ),
|
|
onFullScreenHandler = $.delegate( this, onFullScreen ),
|
|
onRotateLeftHandler = $.delegate( this, onRotateLeft ),
|
|
onRotateRightHandler = $.delegate( this, onRotateRight ),
|
|
onFlipHandler = $.delegate( this, onFlip),
|
|
onFocusHandler = $.delegate( this, onFocus ),
|
|
onBlurHandler = $.delegate( this, onBlur ),
|
|
navImages = this.navImages,
|
|
buttons = [],
|
|
useGroup = true;
|
|
|
|
|
|
if ( this.showNavigationControl ) {
|
|
|
|
if( this.zoomInButton || this.zoomOutButton ||
|
|
this.homeButton || this.fullPageButton ||
|
|
this.rotateLeftButton || this.rotateRightButton ||
|
|
this.flipButton ) {
|
|
//if we are binding to custom buttons then layout and
|
|
//grouping is the responsibility of the page author
|
|
useGroup = false;
|
|
}
|
|
|
|
if ( this.showZoomControl ) {
|
|
buttons.push( this.zoomInButton = new $.Button({
|
|
element: this.zoomInButton ? $.getElement( this.zoomInButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.ZoomIn" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.zoomIn.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.zoomIn.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.zoomIn.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.zoomIn.DOWN ),
|
|
onPress: beginZoomingInHandler,
|
|
onRelease: endZoomingHandler,
|
|
onClick: doSingleZoomInHandler,
|
|
onEnter: beginZoomingInHandler,
|
|
onExit: endZoomingHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
|
|
buttons.push( this.zoomOutButton = new $.Button({
|
|
element: this.zoomOutButton ? $.getElement( this.zoomOutButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.ZoomOut" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.zoomOut.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.zoomOut.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.zoomOut.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.zoomOut.DOWN ),
|
|
onPress: beginZoomingOutHandler,
|
|
onRelease: endZoomingHandler,
|
|
onClick: doSingleZoomOutHandler,
|
|
onEnter: beginZoomingOutHandler,
|
|
onExit: endZoomingHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
}
|
|
|
|
if ( this.showHomeControl ) {
|
|
buttons.push( this.homeButton = new $.Button({
|
|
element: this.homeButton ? $.getElement( this.homeButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.Home" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.home.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.home.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.home.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.home.DOWN ),
|
|
onRelease: onHomeHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
}
|
|
|
|
if ( this.showFullPageControl ) {
|
|
buttons.push( this.fullPageButton = new $.Button({
|
|
element: this.fullPageButton ? $.getElement( this.fullPageButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.FullPage" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.fullpage.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.fullpage.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.fullpage.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.fullpage.DOWN ),
|
|
onRelease: onFullScreenHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
}
|
|
|
|
if ( this.showRotationControl ) {
|
|
buttons.push( this.rotateLeftButton = new $.Button({
|
|
element: this.rotateLeftButton ? $.getElement( this.rotateLeftButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.RotateLeft" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.rotateleft.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.rotateleft.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.rotateleft.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.rotateleft.DOWN ),
|
|
onRelease: onRotateLeftHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
|
|
buttons.push( this.rotateRightButton = new $.Button({
|
|
element: this.rotateRightButton ? $.getElement( this.rotateRightButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.RotateRight" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.rotateright.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.rotateright.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.rotateright.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.rotateright.DOWN ),
|
|
onRelease: onRotateRightHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
}
|
|
|
|
if ( this.showFlipControl ) {
|
|
buttons.push( this.flipButton = new $.Button({
|
|
element: this.flipButton ? $.getElement( this.flipButton ) : null,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold,
|
|
tooltip: $.getString( "Tooltips.Flip" ),
|
|
srcRest: resolveUrl( this.prefixUrl, navImages.flip.REST ),
|
|
srcGroup: resolveUrl( this.prefixUrl, navImages.flip.GROUP ),
|
|
srcHover: resolveUrl( this.prefixUrl, navImages.flip.HOVER ),
|
|
srcDown: resolveUrl( this.prefixUrl, navImages.flip.DOWN ),
|
|
onRelease: onFlipHandler,
|
|
onFocus: onFocusHandler,
|
|
onBlur: onBlurHandler
|
|
}));
|
|
}
|
|
|
|
if ( useGroup ) {
|
|
this.buttonGroup = new $.ButtonGroup({
|
|
buttons: buttons,
|
|
clickTimeThreshold: this.clickTimeThreshold,
|
|
clickDistThreshold: this.clickDistThreshold
|
|
});
|
|
|
|
this.navControl = this.buttonGroup.element;
|
|
this.addHandler( 'open', $.delegate( this, lightUp ) );
|
|
|
|
if( this.toolbar ){
|
|
this.toolbar.addControl(
|
|
this.navControl,
|
|
{anchor: this.navigationControlAnchor || $.ControlAnchor.TOP_LEFT}
|
|
);
|
|
} else {
|
|
this.addControl(
|
|
this.navControl,
|
|
{anchor: this.navigationControlAnchor || $.ControlAnchor.TOP_LEFT}
|
|
);
|
|
}
|
|
} else {
|
|
this.customButtons = buttons;
|
|
}
|
|
|
|
}
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Gets the active page of a sequence
|
|
* @function
|
|
* @returns {Number}
|
|
*/
|
|
currentPage: function() {
|
|
return this._sequenceIndex;
|
|
},
|
|
|
|
/**
|
|
* @function
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:page
|
|
*/
|
|
goToPage: function( page ){
|
|
if( this.tileSources && page >= 0 && page < this.tileSources.length ){
|
|
this._sequenceIndex = page;
|
|
|
|
this._updateSequenceButtons( page );
|
|
|
|
this.open( this.tileSources[ page ] );
|
|
|
|
if( this.referenceStrip ){
|
|
this.referenceStrip.setFocus( page );
|
|
}
|
|
|
|
/**
|
|
* Raised when the page is changed on a viewer configured with multiple image sources (see {@link OpenSeadragon.Viewer#goToPage}).
|
|
*
|
|
* @event page
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {Object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Number} page - The page index.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'page', { page: page } );
|
|
}
|
|
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Adds an html element as an overlay to the current viewport. Useful for
|
|
* highlighting words or areas of interest on an image or other zoomable
|
|
* interface. The overlays added via this method are removed when the viewport
|
|
* is closed which include when changing page.
|
|
* @method
|
|
* @param {Element|String|Object} element - A reference to an element or an id for
|
|
* the element which will be overlaid. Or an Object specifying the configuration for the overlay.
|
|
* If using an object, see {@link OpenSeadragon.Overlay} for a list of
|
|
* all available options.
|
|
* @param {OpenSeadragon.Point|OpenSeadragon.Rect} location - The point or
|
|
* rectangle which will be overlaid. This is a viewport relative location.
|
|
* @param {OpenSeadragon.Placement} [placement=OpenSeadragon.Placement.TOP_LEFT] - The position of the
|
|
* viewport which the location coordinates will be treated as relative
|
|
* to.
|
|
* @param {function} [onDraw] - If supplied the callback is called when the overlay
|
|
* needs to be drawn. It it the responsibility of the callback to do any drawing/positioning.
|
|
* It is passed position, size and element.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:add-overlay
|
|
*/
|
|
addOverlay: function( element, location, placement, onDraw ) {
|
|
var options;
|
|
if( $.isPlainObject( element ) ){
|
|
options = element;
|
|
} else {
|
|
options = {
|
|
element: element,
|
|
location: location,
|
|
placement: placement,
|
|
onDraw: onDraw
|
|
};
|
|
}
|
|
|
|
element = $.getElement( options.element );
|
|
|
|
if ( getOverlayIndex( this.currentOverlays, element ) >= 0 ) {
|
|
// they're trying to add a duplicate overlay
|
|
return this;
|
|
}
|
|
|
|
var overlay = getOverlayObject( this, options);
|
|
this.currentOverlays.push(overlay);
|
|
overlay.drawHTML( this.overlaysContainer, this.viewport );
|
|
|
|
/**
|
|
* Raised when an overlay is added to the viewer (see {@link OpenSeadragon.Viewer#addOverlay}).
|
|
*
|
|
* @event add-overlay
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {Element} element - The overlay element.
|
|
* @property {OpenSeadragon.Point|OpenSeadragon.Rect} location
|
|
* @property {OpenSeadragon.Placement} placement
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'add-overlay', {
|
|
element: element,
|
|
location: options.location,
|
|
placement: options.placement
|
|
});
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Updates the overlay represented by the reference to the element or
|
|
* element id moving it to the new location, relative to the new placement.
|
|
* @method
|
|
* @param {Element|String} element - A reference to an element or an id for
|
|
* the element which is overlaid.
|
|
* @param {OpenSeadragon.Point|OpenSeadragon.Rect} location - The point or
|
|
* rectangle which will be overlaid. This is a viewport relative location.
|
|
* @param {OpenSeadragon.Placement} [placement=OpenSeadragon.Placement.TOP_LEFT] - The position of the
|
|
* viewport which the location coordinates will be treated as relative
|
|
* to.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:update-overlay
|
|
*/
|
|
updateOverlay: function( element, location, placement ) {
|
|
var i;
|
|
|
|
element = $.getElement( element );
|
|
i = getOverlayIndex( this.currentOverlays, element );
|
|
|
|
if ( i >= 0 ) {
|
|
this.currentOverlays[ i ].update( location, placement );
|
|
THIS[ this.hash ].forceRedraw = true;
|
|
/**
|
|
* Raised when an overlay's location or placement changes
|
|
* (see {@link OpenSeadragon.Viewer#updateOverlay}).
|
|
*
|
|
* @event update-overlay
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the
|
|
* Viewer which raised the event.
|
|
* @property {Element} element
|
|
* @property {OpenSeadragon.Point|OpenSeadragon.Rect} location
|
|
* @property {OpenSeadragon.Placement} placement
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'update-overlay', {
|
|
element: element,
|
|
location: location,
|
|
placement: placement
|
|
});
|
|
}
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Removes an overlay identified by the reference element or element id
|
|
* and schedules an update.
|
|
* @method
|
|
* @param {Element|String} element - A reference to the element or an
|
|
* element id which represent the ovelay content to be removed.
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:remove-overlay
|
|
*/
|
|
removeOverlay: function( element ) {
|
|
var i;
|
|
|
|
element = $.getElement( element );
|
|
i = getOverlayIndex( this.currentOverlays, element );
|
|
|
|
if ( i >= 0 ) {
|
|
this.currentOverlays[ i ].destroy();
|
|
this.currentOverlays.splice( i, 1 );
|
|
THIS[ this.hash ].forceRedraw = true;
|
|
/**
|
|
* Raised when an overlay is removed from the viewer
|
|
* (see {@link OpenSeadragon.Viewer#removeOverlay}).
|
|
*
|
|
* @event remove-overlay
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the
|
|
* Viewer which raised the event.
|
|
* @property {Element} element - The overlay element.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'remove-overlay', {
|
|
element: element
|
|
});
|
|
}
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Removes all currently configured Overlays from this Viewer and schedules
|
|
* an update.
|
|
* @method
|
|
* @returns {OpenSeadragon.Viewer} Chainable.
|
|
* @fires OpenSeadragon.Viewer.event:clear-overlay
|
|
*/
|
|
clearOverlays: function() {
|
|
while ( this.currentOverlays.length > 0 ) {
|
|
this.currentOverlays.pop().destroy();
|
|
}
|
|
THIS[ this.hash ].forceRedraw = true;
|
|
/**
|
|
* Raised when all overlays are removed from the viewer (see {@link OpenSeadragon.Drawer#clearOverlays}).
|
|
*
|
|
* @event clear-overlay
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'clear-overlay', {} );
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Finds an overlay identified by the reference element or element id
|
|
* and returns it as an object, return null if not found.
|
|
* @method
|
|
* @param {Element|String} element - A reference to the element or an
|
|
* element id which represents the overlay content.
|
|
* @returns {OpenSeadragon.Overlay} the matching overlay or null if none found.
|
|
*/
|
|
getOverlayById: function( element ) {
|
|
var i;
|
|
|
|
element = $.getElement( element );
|
|
i = getOverlayIndex( this.currentOverlays, element );
|
|
|
|
if (i >= 0) {
|
|
return this.currentOverlays[i];
|
|
} else {
|
|
return null;
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Updates the sequence buttons.
|
|
* @function OpenSeadragon.Viewer.prototype._updateSequenceButtons
|
|
* @private
|
|
* @param {Number} Sequence Value
|
|
*/
|
|
_updateSequenceButtons: function( page ) {
|
|
|
|
if ( this.nextButton ) {
|
|
if(!this.tileSources || this.tileSources.length - 1 === page) {
|
|
//Disable next button
|
|
if ( !this.navPrevNextWrap ) {
|
|
this.nextButton.disable();
|
|
}
|
|
} else {
|
|
this.nextButton.enable();
|
|
}
|
|
}
|
|
if ( this.previousButton ) {
|
|
if ( page > 0 ) {
|
|
//Enable previous button
|
|
this.previousButton.enable();
|
|
} else {
|
|
if ( !this.navPrevNextWrap ) {
|
|
this.previousButton.disable();
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Display a message in the viewport
|
|
* @function OpenSeadragon.Viewer.prototype._showMessage
|
|
* @private
|
|
* @param {String} text message
|
|
*/
|
|
_showMessage: function ( message ) {
|
|
this._hideMessage();
|
|
|
|
var div = $.makeNeutralElement( "div" );
|
|
div.appendChild( document.createTextNode( message ) );
|
|
|
|
this.messageDiv = $.makeCenteredNode( div );
|
|
|
|
$.addClass(this.messageDiv, "openseadragon-message");
|
|
|
|
this.container.appendChild( this.messageDiv );
|
|
},
|
|
|
|
/**
|
|
* Hide any currently displayed viewport message
|
|
* @function OpenSeadragon.Viewer.prototype._hideMessage
|
|
* @private
|
|
*/
|
|
_hideMessage: function () {
|
|
var div = this.messageDiv;
|
|
if (div) {
|
|
div.parentNode.removeChild(div);
|
|
delete this.messageDiv;
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Gets this viewer's gesture settings for the given pointer device type.
|
|
* @method
|
|
* @param {String} type - The pointer device type to get the gesture settings for ("mouse", "touch", "pen", etc.).
|
|
* @returns {OpenSeadragon.GestureSettings}
|
|
*/
|
|
gestureSettingsByDeviceType: function ( type ) {
|
|
switch ( type ) {
|
|
case 'mouse':
|
|
return this.gestureSettingsMouse;
|
|
case 'touch':
|
|
return this.gestureSettingsTouch;
|
|
case 'pen':
|
|
return this.gestureSettingsPen;
|
|
default:
|
|
return this.gestureSettingsUnknown;
|
|
}
|
|
},
|
|
|
|
// private
|
|
_drawOverlays: function() {
|
|
var i,
|
|
length = this.currentOverlays.length;
|
|
for ( i = 0; i < length; i++ ) {
|
|
this.currentOverlays[ i ].drawHTML( this.overlaysContainer, this.viewport );
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Cancel the "in flight" images.
|
|
*/
|
|
_cancelPendingImages: function() {
|
|
this._loadQueue = [];
|
|
},
|
|
|
|
/**
|
|
* Removes the reference strip and disables displaying it.
|
|
* @function
|
|
*/
|
|
removeReferenceStrip: function() {
|
|
this.showReferenceStrip = false;
|
|
|
|
if (this.referenceStrip) {
|
|
this.referenceStrip.destroy();
|
|
this.referenceStrip = null;
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Enables and displays the reference strip based on the currently set tileSources.
|
|
* Works only when the Viewer has sequenceMode set to true.
|
|
* @function
|
|
*/
|
|
addReferenceStrip: function() {
|
|
this.showReferenceStrip = true;
|
|
|
|
if (this.sequenceMode) {
|
|
if (this.referenceStrip) {
|
|
return;
|
|
}
|
|
|
|
if (this.tileSources.length && this.tileSources.length > 1) {
|
|
this.referenceStrip = new $.ReferenceStrip({
|
|
id: this.referenceStripElement,
|
|
position: this.referenceStripPosition,
|
|
sizeRatio: this.referenceStripSizeRatio,
|
|
scroll: this.referenceStripScroll,
|
|
height: this.referenceStripHeight,
|
|
width: this.referenceStripWidth,
|
|
tileSources: this.tileSources,
|
|
prefixUrl: this.prefixUrl,
|
|
useCanvas: this.useCanvas,
|
|
viewer: this
|
|
});
|
|
|
|
this.referenceStrip.setFocus( this._sequenceIndex );
|
|
}
|
|
} else {
|
|
$.console.warn('Attempting to display a reference strip while "sequenceMode" is off.');
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Adds _updatePixelDensityRatio to the window resize event.
|
|
* @private
|
|
*/
|
|
_addUpdatePixelDensityRatioEvent: function() {
|
|
this._updatePixelDensityRatioBind = this._updatePixelDensityRatio.bind(this);
|
|
$.addEvent( window, 'resize', this._updatePixelDensityRatioBind );
|
|
},
|
|
|
|
/**
|
|
* Removes _updatePixelDensityRatio from the window resize event.
|
|
* @private
|
|
*/
|
|
_removeUpdatePixelDensityRatioEvent: function() {
|
|
$.removeEvent( window, 'resize', this._updatePixelDensityRatioBind );
|
|
},
|
|
|
|
/**
|
|
* Update pixel density ratio, clears all tiles and triggers updates for
|
|
* all items if the ratio has changed.
|
|
* @private
|
|
*/
|
|
_updatePixelDensityRatio: function() {
|
|
var previusPixelDensityRatio = $.pixelDensityRatio;
|
|
var currentPixelDensityRatio = $.getCurrentPixelDensityRatio();
|
|
if (previusPixelDensityRatio !== currentPixelDensityRatio) {
|
|
$.pixelDensityRatio = currentPixelDensityRatio;
|
|
this.world.resetItems();
|
|
this.forceRedraw();
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Sets the image source to the source with index equal to
|
|
* currentIndex - 1. Changes current image in sequence mode.
|
|
* If specified, wraps around (see navPrevNextWrap in
|
|
* {@link OpenSeadragon.Options})
|
|
*
|
|
* @method
|
|
*/
|
|
|
|
goToPreviousPage: function () {
|
|
var previous = this._sequenceIndex - 1;
|
|
if(this.navPrevNextWrap && previous < 0){
|
|
previous += this.tileSources.length;
|
|
}
|
|
this.goToPage( previous );
|
|
},
|
|
|
|
/**
|
|
* Sets the image source to the source with index equal to
|
|
* currentIndex + 1. Changes current image in sequence mode.
|
|
* If specified, wraps around (see navPrevNextWrap in
|
|
* {@link OpenSeadragon.Options})
|
|
*
|
|
* @method
|
|
*/
|
|
goToNextPage: function () {
|
|
var next = this._sequenceIndex + 1;
|
|
if(this.navPrevNextWrap && next >= this.tileSources.length){
|
|
next = 0;
|
|
}
|
|
this.goToPage( next );
|
|
},
|
|
|
|
isAnimating: function () {
|
|
return THIS[ this.hash ].animating;
|
|
},
|
|
});
|
|
|
|
|
|
/**
|
|
* _getSafeElemSize is like getElementSize(), but refuses to return 0 for x or y,
|
|
* which was causing some calling operations to return NaN.
|
|
* @returns {Point}
|
|
* @private
|
|
*/
|
|
function _getSafeElemSize (oElement) {
|
|
oElement = $.getElement( oElement );
|
|
|
|
return new $.Point(
|
|
(oElement.clientWidth === 0 ? 1 : oElement.clientWidth),
|
|
(oElement.clientHeight === 0 ? 1 : oElement.clientHeight)
|
|
);
|
|
}
|
|
|
|
|
|
/**
|
|
* @function
|
|
* @private
|
|
*/
|
|
function getTileSourceImplementation( viewer, tileSource, imgOptions, successCallback,
|
|
failCallback ) {
|
|
var _this = viewer;
|
|
|
|
//allow plain xml strings or json strings to be parsed here
|
|
if ( $.type( tileSource ) === 'string' ) {
|
|
//xml should start with "<" and end with ">"
|
|
if ( tileSource.match( /^\s*<.*>\s*$/ ) ) {
|
|
tileSource = $.parseXml( tileSource );
|
|
//json should start with "{" or "[" and end with "}" or "]"
|
|
} else if ( tileSource.match(/^\s*[{[].*[}\]]\s*$/ ) ) {
|
|
try {
|
|
var tileSourceJ = $.parseJSON(tileSource);
|
|
tileSource = tileSourceJ;
|
|
} catch (e) {
|
|
//tileSource = tileSource;
|
|
}
|
|
}
|
|
}
|
|
|
|
function waitUntilReady(tileSource, originalTileSource) {
|
|
if (tileSource.ready) {
|
|
successCallback(tileSource);
|
|
} else {
|
|
tileSource.addHandler('ready', function () {
|
|
successCallback(tileSource);
|
|
});
|
|
tileSource.addHandler('open-failed', function (event) {
|
|
failCallback({
|
|
message: event.message,
|
|
source: originalTileSource
|
|
});
|
|
});
|
|
}
|
|
}
|
|
|
|
setTimeout( function() {
|
|
if ( $.type( tileSource ) === 'string' ) {
|
|
//If its still a string it means it must be a url at this point
|
|
tileSource = new $.TileSource({
|
|
url: tileSource,
|
|
crossOriginPolicy: imgOptions.crossOriginPolicy !== undefined ?
|
|
imgOptions.crossOriginPolicy : viewer.crossOriginPolicy,
|
|
ajaxWithCredentials: viewer.ajaxWithCredentials,
|
|
ajaxHeaders: imgOptions.ajaxHeaders ?
|
|
imgOptions.ajaxHeaders : viewer.ajaxHeaders,
|
|
splitHashDataForPost: viewer.splitHashDataForPost,
|
|
useCanvas: viewer.useCanvas,
|
|
success: function( event ) {
|
|
successCallback( event.tileSource );
|
|
}
|
|
});
|
|
tileSource.addHandler( 'open-failed', function( event ) {
|
|
failCallback( event );
|
|
} );
|
|
|
|
} else if ($.isPlainObject(tileSource) || tileSource.nodeType) {
|
|
if (tileSource.crossOriginPolicy === undefined &&
|
|
(imgOptions.crossOriginPolicy !== undefined || viewer.crossOriginPolicy !== undefined)) {
|
|
tileSource.crossOriginPolicy = imgOptions.crossOriginPolicy !== undefined ?
|
|
imgOptions.crossOriginPolicy : viewer.crossOriginPolicy;
|
|
}
|
|
if (tileSource.ajaxWithCredentials === undefined) {
|
|
tileSource.ajaxWithCredentials = viewer.ajaxWithCredentials;
|
|
}
|
|
if (tileSource.useCanvas === undefined) {
|
|
tileSource.useCanvas = viewer.useCanvas;
|
|
}
|
|
|
|
if ( $.isFunction( tileSource.getTileUrl ) ) {
|
|
//Custom tile source
|
|
var customTileSource = new $.TileSource( tileSource );
|
|
customTileSource.getTileUrl = tileSource.getTileUrl;
|
|
successCallback( customTileSource );
|
|
} else {
|
|
//inline configuration
|
|
var $TileSource = $.TileSource.determineType( _this, tileSource );
|
|
if ( !$TileSource ) {
|
|
failCallback( {
|
|
message: "Unable to load TileSource",
|
|
source: tileSource
|
|
});
|
|
return;
|
|
}
|
|
var options = $TileSource.prototype.configure.apply( _this, [ tileSource ] );
|
|
waitUntilReady(new $TileSource(options), tileSource);
|
|
}
|
|
} else {
|
|
//can assume it's already a tile source implementation
|
|
waitUntilReady(tileSource, tileSource);
|
|
}
|
|
});
|
|
}
|
|
|
|
function getOverlayObject( viewer, overlay ) {
|
|
if ( overlay instanceof $.Overlay ) {
|
|
return overlay;
|
|
}
|
|
|
|
var element = null;
|
|
if ( overlay.element ) {
|
|
element = $.getElement( overlay.element );
|
|
} else {
|
|
var id = overlay.id ?
|
|
overlay.id :
|
|
"openseadragon-overlay-" + Math.floor( Math.random() * 10000000 );
|
|
|
|
element = $.getElement( overlay.id );
|
|
if ( !element ) {
|
|
element = document.createElement( "a" );
|
|
element.href = "#/overlay/" + id;
|
|
}
|
|
element.id = id;
|
|
$.addClass( element, overlay.className ?
|
|
overlay.className :
|
|
"openseadragon-overlay"
|
|
);
|
|
}
|
|
|
|
var location = overlay.location;
|
|
var width = overlay.width;
|
|
var height = overlay.height;
|
|
if (!location) {
|
|
var x = overlay.x;
|
|
var y = overlay.y;
|
|
if (overlay.px !== undefined) {
|
|
var rect = viewer.viewport.imageToViewportRectangle(new $.Rect(
|
|
overlay.px,
|
|
overlay.py,
|
|
width || 0,
|
|
height || 0));
|
|
x = rect.x;
|
|
y = rect.y;
|
|
width = width !== undefined ? rect.width : undefined;
|
|
height = height !== undefined ? rect.height : undefined;
|
|
}
|
|
location = new $.Point(x, y);
|
|
}
|
|
|
|
var placement = overlay.placement;
|
|
if (placement && $.type(placement) === "string") {
|
|
placement = $.Placement[overlay.placement.toUpperCase()];
|
|
}
|
|
|
|
return new $.Overlay({
|
|
element: element,
|
|
location: location,
|
|
placement: placement,
|
|
onDraw: overlay.onDraw,
|
|
checkResize: overlay.checkResize,
|
|
width: width,
|
|
height: height,
|
|
rotationMode: overlay.rotationMode
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
* @inner
|
|
* Determines the index of the given overlay in the given overlays array.
|
|
*/
|
|
function getOverlayIndex( overlays, element ) {
|
|
var i;
|
|
for ( i = overlays.length - 1; i >= 0; i-- ) {
|
|
if ( overlays[ i ].element === element ) {
|
|
return i;
|
|
}
|
|
}
|
|
|
|
return -1;
|
|
}
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// Schedulers provide the general engine for animation
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
function scheduleUpdate( viewer, updateFunc ){
|
|
return $.requestAnimationFrame( function(){
|
|
updateFunc( viewer );
|
|
} );
|
|
}
|
|
|
|
|
|
//provides a sequence in the fade animation
|
|
function scheduleControlsFade( viewer ) {
|
|
$.requestAnimationFrame( function(){
|
|
updateControlsFade( viewer );
|
|
});
|
|
}
|
|
|
|
|
|
//initiates an animation to hide the controls
|
|
function beginControlsAutoHide( viewer ) {
|
|
if ( !viewer.autoHideControls ) {
|
|
return;
|
|
}
|
|
viewer.controlsShouldFade = true;
|
|
viewer.controlsFadeBeginTime =
|
|
$.now() +
|
|
viewer.controlsFadeDelay;
|
|
|
|
window.setTimeout( function(){
|
|
scheduleControlsFade( viewer );
|
|
}, viewer.controlsFadeDelay );
|
|
}
|
|
|
|
|
|
//determines if fade animation is done or continues the animation
|
|
function updateControlsFade( viewer ) {
|
|
var currentTime,
|
|
deltaTime,
|
|
opacity,
|
|
i;
|
|
if ( viewer.controlsShouldFade ) {
|
|
currentTime = $.now();
|
|
deltaTime = currentTime - viewer.controlsFadeBeginTime;
|
|
opacity = 1.0 - deltaTime / viewer.controlsFadeLength;
|
|
|
|
opacity = Math.min( 1.0, opacity );
|
|
opacity = Math.max( 0.0, opacity );
|
|
|
|
for ( i = viewer.controls.length - 1; i >= 0; i--) {
|
|
if (viewer.controls[ i ].autoFade) {
|
|
viewer.controls[ i ].setOpacity( opacity );
|
|
}
|
|
}
|
|
|
|
if ( opacity > 0 ) {
|
|
// fade again
|
|
scheduleControlsFade( viewer );
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
//stop the fade animation on the controls and show them
|
|
function abortControlsAutoHide( viewer ) {
|
|
var i;
|
|
viewer.controlsShouldFade = false;
|
|
for ( i = viewer.controls.length - 1; i >= 0; i-- ) {
|
|
viewer.controls[ i ].setOpacity( 1.0 );
|
|
}
|
|
}
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// Default view event handlers.
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
function onFocus(){
|
|
abortControlsAutoHide( this );
|
|
}
|
|
|
|
function onBlur(){
|
|
beginControlsAutoHide( this );
|
|
|
|
}
|
|
|
|
function onCanvasContextMenu( event ) {
|
|
var eventArgs = {
|
|
tracker: event.eventSource,
|
|
position: event.position,
|
|
originalEvent: event.originalEvent,
|
|
preventDefault: event.preventDefault
|
|
};
|
|
|
|
/**
|
|
* Raised when a contextmenu event occurs in the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-contextmenu
|
|
* @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 {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Boolean} preventDefault - Set to true to prevent the default user-agent's handling of the contextmenu event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-contextmenu', eventArgs );
|
|
|
|
event.preventDefault = eventArgs.preventDefault;
|
|
}
|
|
|
|
function onCanvasKeyDown( event ) {
|
|
var canvasKeyDownEventArgs = {
|
|
originalEvent: event.originalEvent,
|
|
preventDefaultAction: false,
|
|
preventVerticalPan: event.preventVerticalPan || !this.panVertical,
|
|
preventHorizontalPan: event.preventHorizontalPan || !this.panHorizontal
|
|
};
|
|
|
|
/**
|
|
* Raised when a keyboard key is pressed and the focus is on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-key
|
|
* @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 {Boolean} preventDefaultAction - Set to true to prevent default keyboard behaviour. Default: false.
|
|
* @property {Boolean} preventVerticalPan - Set to true to prevent keyboard vertical panning. Default: false.
|
|
* @property {Boolean} preventHorizontalPan - Set to true to prevent keyboard horizontal panning. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
|
|
this.raiseEvent('canvas-key', canvasKeyDownEventArgs);
|
|
|
|
if ( !canvasKeyDownEventArgs.preventDefaultAction && !event.ctrl && !event.alt && !event.meta ) {
|
|
switch( event.keyCode ){
|
|
case 38://up arrow/shift uparrow
|
|
if (!canvasKeyDownEventArgs.preventVerticalPan) {
|
|
if ( event.shift ) {
|
|
this.viewport.zoomBy(1.1);
|
|
} else {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(0, -this.pixelsPerArrowPress)));
|
|
}
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
case 40://down arrow/shift downarrow
|
|
if (!canvasKeyDownEventArgs.preventVerticalPan) {
|
|
if ( event.shift ) {
|
|
this.viewport.zoomBy(0.9);
|
|
} else {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(0, this.pixelsPerArrowPress)));
|
|
}
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
case 37://left arrow
|
|
if (!canvasKeyDownEventArgs.preventHorizontalPan) {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(-this.pixelsPerArrowPress, 0)));
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
case 39://right arrow
|
|
if (!canvasKeyDownEventArgs.preventHorizontalPan) {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(this.pixelsPerArrowPress, 0)));
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
case 187://=|+
|
|
this.viewport.zoomBy(1.1);
|
|
this.viewport.applyConstraints();
|
|
event.preventDefault = true;
|
|
break;
|
|
case 189://-|_
|
|
this.viewport.zoomBy(0.9);
|
|
this.viewport.applyConstraints();
|
|
event.preventDefault = true;
|
|
break;
|
|
case 48://0|)
|
|
this.viewport.goHome();
|
|
this.viewport.applyConstraints();
|
|
event.preventDefault = true;
|
|
break;
|
|
case 87://W/w
|
|
if (!canvasKeyDownEventArgs.preventVerticalPan) {
|
|
if ( event.shift ) {
|
|
this.viewport.zoomBy(1.1);
|
|
} else {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(0, -40)));
|
|
}
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
case 83://S/s
|
|
if (!canvasKeyDownEventArgs.preventVerticalPan) {
|
|
if ( event.shift ) {
|
|
this.viewport.zoomBy(0.9);
|
|
} else {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(0, 40)));
|
|
}
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
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 68://d/D
|
|
if (!canvasKeyDownEventArgs.preventHorizontalPan) {
|
|
this.viewport.panBy(this.viewport.deltaPointsFromPixels(new $.Point(40, 0)));
|
|
this.viewport.applyConstraints();
|
|
}
|
|
event.preventDefault = true;
|
|
break;
|
|
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{
|
|
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 70: //f/F
|
|
this.viewport.toggleFlip();
|
|
event.preventDefault = true;
|
|
break;
|
|
case 74: //j - previous image source
|
|
this.goToPreviousPage();
|
|
break;
|
|
case 75: //k - next image source
|
|
this.goToNextPage();
|
|
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,
|
|
};
|
|
|
|
/**
|
|
* 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;
|
|
|
|
var haveKeyboardFocus = document.activeElement === this.canvas;
|
|
|
|
// If we don't have keyboard focus, request it.
|
|
if ( !haveKeyboardFocus ) {
|
|
this.canvas.focus();
|
|
}
|
|
if(this.viewport.flipped){
|
|
event.position.x = this.viewport.getContainerSize().x - event.position.x;
|
|
}
|
|
|
|
var canvasClickEventArgs = {
|
|
tracker: event.eventSource,
|
|
position: event.position,
|
|
quick: event.quick,
|
|
shift: event.shift,
|
|
originalEvent: event.originalEvent,
|
|
originalTarget: event.originalTarget,
|
|
preventDefaultAction: false
|
|
};
|
|
|
|
/**
|
|
* Raised when a mouse press/release or touch/remove occurs on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-click
|
|
* @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 {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Boolean} quick - True only if the clickDistThreshold and clickTimeThreshold are both passed. Useful for differentiating between clicks and drags.
|
|
* @property {Boolean} shift - True if the shift key was pressed during this event.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Element} originalTarget - The DOM element clicked on.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent default click to zoom behaviour. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
|
|
this.raiseEvent( 'canvas-click', canvasClickEventArgs);
|
|
|
|
|
|
if ( !canvasClickEventArgs.preventDefaultAction && this.viewport && event.quick ) {
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
|
|
if (gestureSettings.clickToZoom === true){
|
|
this.viewport.zoomBy(
|
|
event.shift ? 1.0 / this.zoomPerClick : this.zoomPerClick,
|
|
gestureSettings.zoomToRefPoint ? this.viewport.pointFromPixel( event.position, true ) : null
|
|
);
|
|
this.viewport.applyConstraints();
|
|
}
|
|
|
|
if( gestureSettings.dblClickDragToZoom){
|
|
if(THIS[ this.hash ].draggingToZoom === true){
|
|
THIS[ this.hash ].lastClickTime = null;
|
|
THIS[ this.hash ].draggingToZoom = false;
|
|
}
|
|
else{
|
|
THIS[ this.hash ].lastClickTime = $.now();
|
|
}
|
|
}
|
|
|
|
}
|
|
}
|
|
|
|
function onCanvasDblClick( event ) {
|
|
var gestureSettings;
|
|
|
|
var canvasDblClickEventArgs = {
|
|
tracker: event.eventSource,
|
|
position: event.position,
|
|
shift: event.shift,
|
|
originalEvent: event.originalEvent,
|
|
preventDefaultAction: false
|
|
};
|
|
|
|
/**
|
|
* Raised when a double mouse press/release or touch/remove occurs on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-double-click
|
|
* @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 {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Boolean} shift - True if the shift key was pressed during this event.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent default double tap to zoom behaviour. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-double-click', canvasDblClickEventArgs);
|
|
|
|
if ( !canvasDblClickEventArgs.preventDefaultAction && this.viewport ) {
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
if ( gestureSettings.dblClickToZoom ) {
|
|
this.viewport.zoomBy(
|
|
event.shift ? 1.0 / this.zoomPerClick : this.zoomPerClick,
|
|
gestureSettings.zoomToRefPoint ? this.viewport.pointFromPixel( event.position, true ) : null
|
|
);
|
|
this.viewport.applyConstraints();
|
|
}
|
|
}
|
|
}
|
|
|
|
function onCanvasDrag( event ) {
|
|
var gestureSettings;
|
|
|
|
var canvasDragEventArgs = {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
delta: event.delta,
|
|
speed: event.speed,
|
|
direction: event.direction,
|
|
shift: event.shift,
|
|
originalEvent: event.originalEvent,
|
|
preventDefaultAction: false
|
|
};
|
|
|
|
/**
|
|
* Raised when a mouse or touch drag operation occurs on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-drag
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {OpenSeadragon.Point} delta - The x,y components of the difference between start drag and end drag.
|
|
* @property {Number} speed - Current computed speed, in pixels per second.
|
|
* @property {Number} direction - Current computed direction, expressed as an angle counterclockwise relative to the positive X axis (-pi to pi, in radians). Only valid if speed > 0.
|
|
* @property {Boolean} shift - True if the shift key was pressed during this event.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent default drag to pan behaviour. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-drag', canvasDragEventArgs);
|
|
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
|
|
if(!canvasDragEventArgs.preventDefaultAction && this.viewport){
|
|
|
|
if (gestureSettings.dblClickDragToZoom && THIS[ this.hash ].draggingToZoom){
|
|
var factor = Math.pow( this.zoomPerDblClickDrag, event.delta.y / 50);
|
|
this.viewport.zoomBy(factor);
|
|
}
|
|
else if (gestureSettings.dragToPan && !THIS[ this.hash ].draggingToZoom) {
|
|
if( !this.panHorizontal ){
|
|
event.delta.x = 0;
|
|
}
|
|
if( !this.panVertical ){
|
|
event.delta.y = 0;
|
|
}
|
|
if(this.viewport.flipped){
|
|
event.delta.x = -event.delta.x;
|
|
}
|
|
|
|
if( this.constrainDuringPan ){
|
|
var delta = this.viewport.deltaPointsFromPixels( event.delta.negate() );
|
|
|
|
this.viewport.centerSpringX.target.value += delta.x;
|
|
this.viewport.centerSpringY.target.value += delta.y;
|
|
|
|
var constrainedBounds = this.viewport.getConstrainedBounds();
|
|
|
|
this.viewport.centerSpringX.target.value -= delta.x;
|
|
this.viewport.centerSpringY.target.value -= delta.y;
|
|
|
|
if (constrainedBounds.xConstrained) {
|
|
event.delta.x = 0;
|
|
}
|
|
|
|
if (constrainedBounds.yConstrained) {
|
|
event.delta.y = 0;
|
|
}
|
|
}
|
|
this.viewport.panBy( this.viewport.deltaPointsFromPixels( event.delta.negate() ), gestureSettings.flickEnabled && !this.constrainDuringPan);
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
function onCanvasDragEnd( event ) {
|
|
var gestureSettings;
|
|
var canvasDragEndEventArgs = {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
speed: event.speed,
|
|
direction: event.direction,
|
|
shift: event.shift,
|
|
originalEvent: event.originalEvent,
|
|
preventDefaultAction: false
|
|
};
|
|
|
|
/**
|
|
* Raised when a mouse or touch drag operation ends on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-drag-end
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Number} speed - Speed at the end of a drag gesture, in pixels per second.
|
|
* @property {Number} direction - Direction at the end of a drag gesture, expressed as an angle counterclockwise relative to the positive X axis (-pi to pi, in radians). Only valid if speed > 0.
|
|
* @property {Boolean} shift - True if the shift key was pressed during this event.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent default drag-end flick behaviour. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent('canvas-drag-end', canvasDragEndEventArgs);
|
|
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
|
|
if (!canvasDragEndEventArgs.preventDefaultAction && this.viewport) {
|
|
if ( !THIS[ this.hash ].draggingToZoom &&
|
|
gestureSettings.flickEnabled &&
|
|
event.speed >= gestureSettings.flickMinSpeed) {
|
|
var amplitudeX = 0;
|
|
if (this.panHorizontal) {
|
|
amplitudeX = gestureSettings.flickMomentum * event.speed *
|
|
Math.cos(event.direction);
|
|
}
|
|
var amplitudeY = 0;
|
|
if (this.panVertical) {
|
|
amplitudeY = gestureSettings.flickMomentum * event.speed *
|
|
Math.sin(event.direction);
|
|
}
|
|
var center = this.viewport.pixelFromPoint(
|
|
this.viewport.getCenter(true));
|
|
var target = this.viewport.pointFromPixel(
|
|
new $.Point(center.x - amplitudeX, center.y - amplitudeY));
|
|
this.viewport.panTo(target, false);
|
|
}
|
|
this.viewport.applyConstraints();
|
|
}
|
|
|
|
|
|
if( gestureSettings.dblClickDragToZoom && THIS[ this.hash ].draggingToZoom === true ){
|
|
THIS[ this.hash ].draggingToZoom = false;
|
|
}
|
|
|
|
|
|
}
|
|
|
|
function onCanvasEnter( event ) {
|
|
/**
|
|
* Raised when a pointer enters the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-enter
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Number} buttons - Current buttons pressed. A combination of bit flags 0: none, 1: primary (or touch contact), 2: secondary, 4: aux (often middle), 8: X1 (often back), 16: X2 (often forward), 32: pen eraser.
|
|
* @property {Number} pointers - Number of pointers (all types) active in the tracked element.
|
|
* @property {Boolean} insideElementPressed - True if the left mouse button is currently being pressed and was initiated inside the tracked element, otherwise false.
|
|
* @property {Boolean} buttonDownAny - Was the button down anywhere in the screen during the event. <span style="color:red;">Deprecated. Use buttons instead.</span>
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-enter', {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
buttons: event.buttons,
|
|
pointers: event.pointers,
|
|
insideElementPressed: event.insideElementPressed,
|
|
buttonDownAny: event.buttonDownAny,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
function onCanvasLeave( event ) {
|
|
/**
|
|
* Raised when a pointer leaves the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-exit
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Number} buttons - Current buttons pressed. A combination of bit flags 0: none, 1: primary (or touch contact), 2: secondary, 4: aux (often middle), 8: X1 (often back), 16: X2 (often forward), 32: pen eraser.
|
|
* @property {Number} pointers - Number of pointers (all types) active in the tracked element.
|
|
* @property {Boolean} insideElementPressed - True if the left mouse button is currently being pressed and was initiated inside the tracked element, otherwise false.
|
|
* @property {Boolean} buttonDownAny - Was the button down anywhere in the screen during the event. <span style="color:red;">Deprecated. Use buttons instead.</span>
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-exit', {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
buttons: event.buttons,
|
|
pointers: event.pointers,
|
|
insideElementPressed: event.insideElementPressed,
|
|
buttonDownAny: event.buttonDownAny,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
function onCanvasPress( event ) {
|
|
var gestureSettings;
|
|
|
|
/**
|
|
* Raised when the primary mouse button is pressed or touch starts on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-press
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Boolean} insideElementPressed - True if the left mouse button is currently being pressed and was initiated inside the tracked element, otherwise false.
|
|
* @property {Boolean} insideElementReleased - True if the cursor still inside the tracked element when the button was released.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-press', {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
insideElementPressed: event.insideElementPressed,
|
|
insideElementReleased: event.insideElementReleased,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
|
|
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
if ( gestureSettings.dblClickDragToZoom ){
|
|
var lastClickTime = THIS[ this.hash ].lastClickTime;
|
|
var currClickTime = $.now();
|
|
|
|
if ( lastClickTime === null) {
|
|
return;
|
|
}
|
|
|
|
if ((currClickTime - lastClickTime) < this.dblClickTimeThreshold) {
|
|
THIS[ this.hash ].draggingToZoom = true;
|
|
}
|
|
|
|
THIS[ this.hash ].lastClickTime = null;
|
|
}
|
|
|
|
}
|
|
|
|
function onCanvasRelease( event ) {
|
|
/**
|
|
* Raised when the primary mouse button is released or touch ends on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-release
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Boolean} insideElementPressed - True if the left mouse button is currently being pressed and was initiated inside the tracked element, otherwise false.
|
|
* @property {Boolean} insideElementReleased - True if the cursor still inside the tracked element when the button was released.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-release', {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
insideElementPressed: event.insideElementPressed,
|
|
insideElementReleased: event.insideElementReleased,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
function onCanvasNonPrimaryPress( event ) {
|
|
/**
|
|
* Raised when any non-primary pointer button is pressed on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-nonprimary-press
|
|
* @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 {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {Number} button - Button which caused the event.
|
|
* -1: none, 0: primary/left, 1: aux/middle, 2: secondary/right, 3: X1/back, 4: X2/forward, 5: pen eraser.
|
|
* @property {Number} buttons - Current buttons pressed.
|
|
* Combination of bit flags 0: none, 1: primary (or touch contact), 2: secondary, 4: aux (often middle), 8: X1 (often back), 16: X2 (often forward), 32: pen eraser.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-nonprimary-press', {
|
|
tracker: event.eventSource,
|
|
position: event.position,
|
|
pointerType: event.pointerType,
|
|
button: event.button,
|
|
buttons: event.buttons,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
function onCanvasNonPrimaryRelease( event ) {
|
|
/**
|
|
* Raised when any non-primary pointer button is released on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-nonprimary-release
|
|
* @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 {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {Number} button - Button which caused the event.
|
|
* -1: none, 0: primary/left, 1: aux/middle, 2: secondary/right, 3: X1/back, 4: X2/forward, 5: pen eraser.
|
|
* @property {Number} buttons - Current buttons pressed.
|
|
* Combination of bit flags 0: none, 1: primary (or touch contact), 2: secondary, 4: aux (often middle), 8: X1 (often back), 16: X2 (often forward), 32: pen eraser.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'canvas-nonprimary-release', {
|
|
tracker: event.eventSource,
|
|
position: event.position,
|
|
pointerType: event.pointerType,
|
|
button: event.button,
|
|
buttons: event.buttons,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
function onCanvasPinch( event ) {
|
|
var gestureSettings,
|
|
centerPt,
|
|
lastCenterPt,
|
|
panByPt;
|
|
|
|
var canvasPinchEventArgs = {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
gesturePoints: event.gesturePoints,
|
|
lastCenter: event.lastCenter,
|
|
center: event.center,
|
|
lastDistance: event.lastDistance,
|
|
distance: event.distance,
|
|
shift: event.shift,
|
|
originalEvent: event.originalEvent,
|
|
preventDefaultPanAction: false,
|
|
preventDefaultZoomAction: false,
|
|
preventDefaultRotateAction: false
|
|
};
|
|
|
|
/**
|
|
* Raised when a pinch event occurs on the {@link OpenSeadragon.Viewer#canvas} element.
|
|
*
|
|
* @event canvas-pinch
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {Array.<OpenSeadragon.MouseTracker.GesturePoint>} gesturePoints - Gesture points associated with the gesture. Velocity data can be found here.
|
|
* @property {OpenSeadragon.Point} lastCenter - The previous center point of the two pinch contact points relative to the tracked element.
|
|
* @property {OpenSeadragon.Point} center - The center point of the two pinch contact points relative to the tracked element.
|
|
* @property {Number} lastDistance - The previous distance between the two pinch contact points in CSS pixels.
|
|
* @property {Number} distance - The distance between the two pinch contact points in CSS pixels.
|
|
* @property {Boolean} shift - True if the shift key was pressed during this event.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Boolean} preventDefaultPanAction - Set to true to prevent default pinch to pan behaviour. Default: false.
|
|
* @property {Boolean} preventDefaultZoomAction - Set to true to prevent default pinch to zoom behaviour. Default: false.
|
|
* @property {Boolean} preventDefaultRotateAction - Set to true to prevent default pinch to rotate behaviour. Default: false.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent('canvas-pinch', canvasPinchEventArgs);
|
|
|
|
if ( this.viewport ) {
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
if ( gestureSettings.pinchToZoom &&
|
|
(!canvasPinchEventArgs.preventDefaultPanAction || !canvasPinchEventArgs.preventDefaultZoomAction) ) {
|
|
centerPt = this.viewport.pointFromPixel( event.center, true );
|
|
if ( gestureSettings.zoomToRefPoint && !canvasPinchEventArgs.preventDefaultPanAction ) {
|
|
lastCenterPt = this.viewport.pointFromPixel( event.lastCenter, true );
|
|
panByPt = lastCenterPt.minus( centerPt );
|
|
if( !this.panHorizontal ) {
|
|
panByPt.x = 0;
|
|
}
|
|
if( !this.panVertical ) {
|
|
panByPt.y = 0;
|
|
}
|
|
this.viewport.panBy(panByPt, true);
|
|
}
|
|
if ( !canvasPinchEventArgs.preventDefaultZoomAction ) {
|
|
this.viewport.zoomBy( event.distance / event.lastDistance, centerPt, true );
|
|
}
|
|
this.viewport.applyConstraints();
|
|
}
|
|
if ( gestureSettings.pinchRotate && !canvasPinchEventArgs.preventDefaultRotateAction ) {
|
|
// Pinch rotate
|
|
var angle1 = Math.atan2(event.gesturePoints[0].currentPos.y - event.gesturePoints[1].currentPos.y,
|
|
event.gesturePoints[0].currentPos.x - event.gesturePoints[1].currentPos.x);
|
|
var angle2 = Math.atan2(event.gesturePoints[0].lastPos.y - event.gesturePoints[1].lastPos.y,
|
|
event.gesturePoints[0].lastPos.x - event.gesturePoints[1].lastPos.x);
|
|
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,
|
|
factor,
|
|
thisScrollTime,
|
|
deltaScrollTime;
|
|
|
|
/* Certain scroll devices fire the scroll event way too fast so we are injecting a simple adjustment to keep things
|
|
* partially normalized. If we have already fired an event within the last 'minScrollDelta' milliseconds we skip
|
|
* this one and wait for the next event. */
|
|
thisScrollTime = $.now();
|
|
deltaScrollTime = thisScrollTime - this._lastScrollTime;
|
|
if (deltaScrollTime > this.minScrollDeltaTime) {
|
|
this._lastScrollTime = thisScrollTime;
|
|
|
|
canvasScrollEventArgs = {
|
|
tracker: event.eventSource,
|
|
position: event.position,
|
|
scroll: event.scroll,
|
|
shift: event.shift,
|
|
originalEvent: event.originalEvent,
|
|
preventDefaultAction: false,
|
|
preventDefault: true
|
|
};
|
|
|
|
/**
|
|
* Raised when a scroll event occurs on the {@link OpenSeadragon.Viewer#canvas} element (mouse wheel).
|
|
*
|
|
* @event canvas-scroll
|
|
* @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 {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Number} scroll - The scroll delta for the event.
|
|
* @property {Boolean} shift - True if the shift key was pressed during this event.
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {Boolean} preventDefaultAction - Set to true to prevent default scroll to zoom behaviour. Default: false.
|
|
* @property {Boolean} preventDefault - Set to true to prevent the default user-agent's handling of the wheel event. Default: true.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent('canvas-scroll', canvasScrollEventArgs );
|
|
|
|
if ( !canvasScrollEventArgs.preventDefaultAction && this.viewport ) {
|
|
if(this.viewport.flipped){
|
|
event.position.x = this.viewport.getContainerSize().x - event.position.x;
|
|
}
|
|
|
|
gestureSettings = this.gestureSettingsByDeviceType( event.pointerType );
|
|
if ( gestureSettings.scrollToZoom ) {
|
|
factor = Math.pow( this.zoomPerScroll, event.scroll );
|
|
this.viewport.zoomBy(
|
|
factor,
|
|
gestureSettings.zoomToRefPoint ? this.viewport.pointFromPixel( event.position, true ) : null
|
|
);
|
|
this.viewport.applyConstraints();
|
|
}
|
|
}
|
|
|
|
event.preventDefault = canvasScrollEventArgs.preventDefault;
|
|
} else {
|
|
event.preventDefault = true;
|
|
}
|
|
}
|
|
|
|
function onContainerEnter( event ) {
|
|
THIS[ this.hash ].mouseInside = true;
|
|
abortControlsAutoHide( this );
|
|
/**
|
|
* Raised when the cursor enters the {@link OpenSeadragon.Viewer#container} element.
|
|
*
|
|
* @event container-enter
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Number} buttons - Current buttons pressed. A combination of bit flags 0: none, 1: primary (or touch contact), 2: secondary, 4: aux (often middle), 8: X1 (often back), 16: X2 (often forward), 32: pen eraser.
|
|
* @property {Number} pointers - Number of pointers (all types) active in the tracked element.
|
|
* @property {Boolean} insideElementPressed - True if the left mouse button is currently being pressed and was initiated inside the tracked element, otherwise false.
|
|
* @property {Boolean} buttonDownAny - Was the button down anywhere in the screen during the event. <span style="color:red;">Deprecated. Use buttons instead.</span>
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'container-enter', {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
buttons: event.buttons,
|
|
pointers: event.pointers,
|
|
insideElementPressed: event.insideElementPressed,
|
|
buttonDownAny: event.buttonDownAny,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
function onContainerLeave( event ) {
|
|
if ( event.pointers < 1 ) {
|
|
THIS[ this.hash ].mouseInside = false;
|
|
if ( !THIS[ this.hash ].animating ) {
|
|
beginControlsAutoHide( this );
|
|
}
|
|
}
|
|
/**
|
|
* Raised when the cursor leaves the {@link OpenSeadragon.Viewer#container} element.
|
|
*
|
|
* @event container-exit
|
|
* @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 {String} pointerType - "mouse", "touch", "pen", etc.
|
|
* @property {OpenSeadragon.Point} position - The position of the event relative to the tracked element.
|
|
* @property {Number} buttons - Current buttons pressed. A combination of bit flags 0: none, 1: primary (or touch contact), 2: secondary, 4: aux (often middle), 8: X1 (often back), 16: X2 (often forward), 32: pen eraser.
|
|
* @property {Number} pointers - Number of pointers (all types) active in the tracked element.
|
|
* @property {Boolean} insideElementPressed - True if the left mouse button is currently being pressed and was initiated inside the tracked element, otherwise false.
|
|
* @property {Boolean} buttonDownAny - Was the button down anywhere in the screen during the event. <span style="color:red;">Deprecated. Use buttons instead.</span>
|
|
* @property {Object} originalEvent - The original DOM event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
this.raiseEvent( 'container-exit', {
|
|
tracker: event.eventSource,
|
|
pointerType: event.pointerType,
|
|
position: event.position,
|
|
buttons: event.buttons,
|
|
pointers: event.pointers,
|
|
insideElementPressed: event.insideElementPressed,
|
|
buttonDownAny: event.buttonDownAny,
|
|
originalEvent: event.originalEvent
|
|
});
|
|
}
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// Page update routines ( aka Views - for future reference )
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
function updateMulti( viewer ) {
|
|
updateOnce( viewer );
|
|
|
|
// Request the next frame, unless we've been closed
|
|
if ( viewer.isOpen() ) {
|
|
viewer._updateRequestId = scheduleUpdate( viewer, updateMulti );
|
|
} else {
|
|
viewer._updateRequestId = false;
|
|
}
|
|
}
|
|
|
|
function doViewerResize(viewer, containerSize){
|
|
var viewport = viewer.viewport;
|
|
var zoom = viewport.getZoom();
|
|
var center = viewport.getCenter();
|
|
viewport.resize(containerSize, viewer.preserveImageSizeOnResize);
|
|
viewport.panTo(center, true);
|
|
var resizeRatio;
|
|
if (viewer.preserveImageSizeOnResize) {
|
|
resizeRatio = THIS[viewer.hash].prevContainerSize.x / containerSize.x;
|
|
} else {
|
|
var origin = new $.Point(0, 0);
|
|
var prevDiag = new $.Point(THIS[viewer.hash].prevContainerSize.x, THIS[viewer.hash].prevContainerSize.y).distanceTo(origin);
|
|
var newDiag = new $.Point(containerSize.x, containerSize.y).distanceTo(origin);
|
|
resizeRatio = newDiag / prevDiag * THIS[viewer.hash].prevContainerSize.x / containerSize.x;
|
|
}
|
|
viewport.zoomTo(zoom * resizeRatio, null, true);
|
|
THIS[viewer.hash].prevContainerSize = containerSize;
|
|
THIS[viewer.hash].forceRedraw = true;
|
|
THIS[viewer.hash].needsResize = false;
|
|
THIS[viewer.hash].forceResize = false;
|
|
}
|
|
function updateOnce( viewer ) {
|
|
|
|
//viewer.profiler.beginUpdate();
|
|
|
|
if (viewer._opening || !THIS[viewer.hash]) {
|
|
return;
|
|
}
|
|
if (viewer.autoResize || THIS[viewer.hash].forceResize){
|
|
var containerSize;
|
|
if(viewer._autoResizePolling){
|
|
containerSize = _getSafeElemSize(viewer.container);
|
|
var prevContainerSize = THIS[viewer.hash].prevContainerSize;
|
|
if (!containerSize.equals(prevContainerSize)) {
|
|
THIS[viewer.hash].needsResize = true;
|
|
}
|
|
}
|
|
if(THIS[viewer.hash].needsResize){
|
|
doViewerResize(viewer, containerSize || _getSafeElemSize(viewer.container));
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
var viewportChange = viewer.viewport.update();
|
|
var animated = viewer.world.update() || viewportChange;
|
|
|
|
if (viewportChange) {
|
|
/**
|
|
* Raised when any spring animation update occurs (zoom, pan, etc.),
|
|
* before the viewer has drawn the new location.
|
|
*
|
|
* @event viewport-change
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
viewer.raiseEvent('viewport-change');
|
|
}
|
|
|
|
if( viewer.referenceStrip ){
|
|
animated = viewer.referenceStrip.update( viewer.viewport ) || animated;
|
|
}
|
|
|
|
var currentAnimating = THIS[ viewer.hash ].animating;
|
|
|
|
if ( !currentAnimating && animated ) {
|
|
/**
|
|
* Raised when any spring animation starts (zoom, pan, etc.).
|
|
*
|
|
* @event animation-start
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
viewer.raiseEvent( "animation-start" );
|
|
abortControlsAutoHide( viewer );
|
|
}
|
|
|
|
var isAnimationFinished = currentAnimating && !animated;
|
|
|
|
if ( isAnimationFinished ) {
|
|
THIS[ viewer.hash ].animating = false;
|
|
}
|
|
|
|
if ( animated || isAnimationFinished || THIS[ viewer.hash ].forceRedraw || viewer.world.needsDraw() ) {
|
|
drawWorld( viewer );
|
|
viewer._drawOverlays();
|
|
if( viewer.navigator ){
|
|
viewer.navigator.update( viewer.viewport );
|
|
}
|
|
|
|
THIS[ viewer.hash ].forceRedraw = false;
|
|
|
|
if (animated) {
|
|
/**
|
|
* Raised when any spring animation update occurs (zoom, pan, etc.),
|
|
* after the viewer has drawn the new location.
|
|
*
|
|
* @event animation
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
viewer.raiseEvent( "animation" );
|
|
}
|
|
}
|
|
|
|
if ( isAnimationFinished ) {
|
|
/**
|
|
* Raised when any spring animation ends (zoom, pan, etc.).
|
|
*
|
|
* @event animation-finish
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised this event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
viewer.raiseEvent( "animation-finish" );
|
|
|
|
if ( !THIS[ viewer.hash ].mouseInside ) {
|
|
beginControlsAutoHide( viewer );
|
|
}
|
|
}
|
|
|
|
THIS[ viewer.hash ].animating = animated;
|
|
|
|
//viewer.profiler.endUpdate();
|
|
}
|
|
|
|
function drawWorld( viewer ) {
|
|
viewer.imageLoader.clear();
|
|
viewer.drawer.clear();
|
|
viewer.world.draw();
|
|
|
|
/**
|
|
* <em>- Needs documentation -</em>
|
|
*
|
|
* @event update-viewport
|
|
* @memberof OpenSeadragon.Viewer
|
|
* @type {object}
|
|
* @property {OpenSeadragon.Viewer} eventSource - A reference to the Viewer which raised the event.
|
|
* @property {?Object} userData - Arbitrary subscriber-defined object.
|
|
*/
|
|
viewer.raiseEvent( 'update-viewport', {} );
|
|
}
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// Navigation Controls
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
function resolveUrl( prefix, url ) {
|
|
return prefix ? prefix + url : url;
|
|
}
|
|
|
|
|
|
|
|
function beginZoomingIn() {
|
|
THIS[ this.hash ].lastZoomTime = $.now();
|
|
THIS[ this.hash ].zoomFactor = this.zoomPerSecond;
|
|
THIS[ this.hash ].zooming = true;
|
|
scheduleZoom( this );
|
|
}
|
|
|
|
|
|
function beginZoomingOut() {
|
|
THIS[ this.hash ].lastZoomTime = $.now();
|
|
THIS[ this.hash ].zoomFactor = 1.0 / this.zoomPerSecond;
|
|
THIS[ this.hash ].zooming = true;
|
|
scheduleZoom( this );
|
|
}
|
|
|
|
|
|
function endZooming() {
|
|
THIS[ this.hash ].zooming = false;
|
|
}
|
|
|
|
|
|
function scheduleZoom( viewer ) {
|
|
$.requestAnimationFrame( $.delegate( viewer, doZoom ) );
|
|
}
|
|
|
|
|
|
function doZoom() {
|
|
var currentTime,
|
|
deltaTime,
|
|
adjustedFactor;
|
|
|
|
if ( THIS[ this.hash ].zooming && this.viewport) {
|
|
currentTime = $.now();
|
|
deltaTime = currentTime - THIS[ this.hash ].lastZoomTime;
|
|
adjustedFactor = Math.pow( THIS[ this.hash ].zoomFactor, deltaTime / 1000 );
|
|
|
|
this.viewport.zoomBy( adjustedFactor );
|
|
this.viewport.applyConstraints();
|
|
THIS[ this.hash ].lastZoomTime = currentTime;
|
|
scheduleZoom( this );
|
|
}
|
|
}
|
|
|
|
|
|
function doSingleZoomIn() {
|
|
if ( this.viewport ) {
|
|
THIS[ this.hash ].zooming = false;
|
|
this.viewport.zoomBy(
|
|
this.zoomPerClick / 1.0
|
|
);
|
|
this.viewport.applyConstraints();
|
|
}
|
|
}
|
|
|
|
|
|
function doSingleZoomOut() {
|
|
if ( this.viewport ) {
|
|
THIS[ this.hash ].zooming = false;
|
|
this.viewport.zoomBy(
|
|
1.0 / this.zoomPerClick
|
|
);
|
|
this.viewport.applyConstraints();
|
|
}
|
|
}
|
|
|
|
|
|
function lightUp() {
|
|
if (this.buttonGroup) {
|
|
this.buttonGroup.emulateEnter();
|
|
this.buttonGroup.emulateLeave();
|
|
}
|
|
}
|
|
|
|
|
|
function onHome() {
|
|
if ( this.viewport ) {
|
|
this.viewport.goHome();
|
|
}
|
|
}
|
|
|
|
|
|
function onFullScreen() {
|
|
if ( this.isFullPage() && !$.isFullScreen() ) {
|
|
// Is fullPage but not fullScreen
|
|
this.setFullPage( false );
|
|
} else {
|
|
this.setFullScreen( !this.isFullPage() );
|
|
}
|
|
// correct for no mouseout event on change
|
|
if ( this.buttonGroup ) {
|
|
this.buttonGroup.emulateLeave();
|
|
}
|
|
this.fullPageButton.element.focus();
|
|
if ( this.viewport ) {
|
|
this.viewport.applyConstraints();
|
|
}
|
|
}
|
|
|
|
function onRotateLeft() {
|
|
if ( this.viewport ) {
|
|
var currRotation = this.viewport.getRotation();
|
|
|
|
if ( this.viewport.flipped ){
|
|
currRotation += this.rotationIncrement;
|
|
} else {
|
|
currRotation -= this.rotationIncrement;
|
|
}
|
|
this.viewport.setRotation(currRotation);
|
|
}
|
|
}
|
|
|
|
function onRotateRight() {
|
|
if ( this.viewport ) {
|
|
var currRotation = this.viewport.getRotation();
|
|
|
|
if ( this.viewport.flipped ){
|
|
currRotation -= this.rotationIncrement;
|
|
} else {
|
|
currRotation += this.rotationIncrement;
|
|
}
|
|
this.viewport.setRotation(currRotation);
|
|
}
|
|
}
|
|
/**
|
|
* Note: When pressed flip control button
|
|
*/
|
|
function onFlip() {
|
|
this.viewport.toggleFlip();
|
|
}
|
|
|
|
}( OpenSeadragon ));
|