Merge branch 'master' of github.com:openseadragon/openseadragon

changelog.txt

@@ -7,6 +7,7 @@ OPENSEADRAGON CHANGELOG
 * Fixed: LegacyTileSource doesn't fail gracefully when no supported file formats are found (#202)
 * Added an optional userData argument to EventHandler.addHandler() which is passed unchanged to the handler method (#203)
 * Fixed AJAX error reporting on IE8 (#208)
+* Added viewportToImageRectangle method, and updated imageToViewportRectangle, imageToViewportCoordinates, and viewportToImageCoordinates to be more flexible with params (#212)
 
 0.9.130:
 

src/viewport.js

@@ -722,25 +722,54 @@ $.Viewport.prototype = {
     },
 
     /**
-     * Translates from Seajax viewer coordinate
+     * Translates from OpenSeadragon viewer coordinate system to image coordinate system.
-     * system to image coordinate system
+     * This method can be called either by passing X,Y coordinates or an
+     * OpenSeadragon.Point
+     * @function
+     * @param {OpenSeadragon.Point} viewerX the point in viewport coordinate system.
+     * @param {Number} viewerX X coordinate in viewport coordinate system.
+     * @param {Number} viewerY Y coordinate in viewport coordinate system.
+     * @return {OpenSeadragon.Point} a point representing the coordinates in the image.
      */
     viewportToImageCoordinates: function( viewerX, viewerY ) {
+        if ( arguments.length == 1 ) {
+            //they passed a point instead of individual components
+            return this.viewportToImageCoordinates( viewerX.x, viewerX.y );
+        }
         return new $.Point( viewerX * this.contentSize.x, viewerY * this.contentSize.y * this.contentAspectX );
     },
 
     /**
-     * Translates from image coordinate system to
+     * Translates from image coordinate system to OpenSeadragon viewer coordinate system
-     * Seajax viewer coordinate system
+     * This method can be called either by passing X,Y coordinates or an
+     * OpenSeadragon.Point
+     * @function
+     * @param {OpenSeadragon.Point} imageX the point in image coordinate system.
+     * @param {Number} imageX X coordinate in image coordinate system.
+     * @param {Number} imageY Y coordinate in image coordinate system.
+     * @return {OpenSeadragon.Point} a point representing the coordinates in the viewport.
      */
     imageToViewportCoordinates: function( imageX, imageY ) {
+        if ( arguments.length == 1 ) {
+            //they passed a point instead of individual components
+            return this.imageToViewportCoordinates( imageX.x, imageX.y );
+        }
         return new $.Point( imageX / this.contentSize.x, imageY / this.contentSize.y / this.contentAspectX );
     },
 
     /**
-     * Translates from a rectangle which describes a portion of
+     * Translates from a rectangle which describes a portion of the image in
-     * the image in pixel coordinates to OpenSeadragon viewport
+     * pixel coordinates to OpenSeadragon viewport rectangle coordinates.
-     * rectangle coordinates.
+     * This method can be called either by passing X,Y,width,height or an
+     * OpenSeadragon.Rect
+     * @function
+     * @param {OpenSeadragon.Rect} imageX the rectangle in image coordinate system.
+     * @param {Number} imageX the X coordinate of the top left corner of the rectangle
+     * in image coordinate system.
+     * @param {Number} imageY the Y coordinate of the top left corner of the rectangle
+     * in image coordinate system.
+     * @param {Number} pixelWidth the width in pixel of the rectangle.
+     * @param {Number} pixelHeight the height in pixel of the rectangle.
      */
     imageToViewportRectangle: function( imageX, imageY, pixelWidth, pixelHeight ) {
         var coordA,
@@ -749,7 +778,9 @@ $.Viewport.prototype = {
         if( arguments.length == 1 ) {
             //they passed a rectangle instead of individual components
             rect = imageX;
-            return this.imageToViewportRectangle(rect.x, rect.y, rect.width, rect.height);
+            return this.imageToViewportRectangle(
+                rect.x, rect.y, rect.width, rect.height
+            );
         }
         coordA = this.imageToViewportCoordinates(
             imageX, imageY
@@ -763,6 +794,41 @@ $.Viewport.prototype = {
             coordB.x,
             coordB.y
         );
+    },
+
+    /**
+     * Translates from a rectangle which describes a portion of
+     * the viewport in point coordinates to image rectangle coordinates.
+     * This method can be called either by passing X,Y,width,height or an
+     * OpenSeadragon.Rect
+     * @function
+     * @param {OpenSeadragon.Rect} viewerX the rectangle in viewport coordinate system.
+     * @param {Number} viewerX the X coordinate of the top left corner of the rectangle
+     * in viewport coordinate system.
+     * @param {Number} imageY the Y coordinate of the top left corner of the rectangle
+     * in viewport coordinate system.
+     * @param {Number} pointWidth the width of the rectangle in viewport coordinate system.
+     * @param {Number} pointHeight the height of the rectangle in viewport coordinate system.
+     */
+    viewportToImageRectangle: function( viewerX, viewerY, pointWidth, pointHeight ) {
+        var coordA,
+            coordB,
+            rect;
+        if ( arguments.length == 1 ) {
+            //they passed a rectangle instead of individual components
+            rect = viewerX;
+            return this.viewportToImageRectangle(
+                rect.x, rect.y, rect.width, rect.height
+            );
+        }
+        coordA = this.viewportToImageCoordinates( viewerX, viewerY );
+        coordB = this.viewportToImageCoordinates( pointWidth, pointHeight );
+        return new $.Rect(
+            coordA.x,
+            coordA.y,
+            coordB.x,
+            coordB.y
+        );
     }
 };
 

test/basic.js

@@ -160,7 +160,14 @@
             };
 
             viewer.addHandler('animationfinish', clickHandler);
-            Util.simulateViewerClick(viewer, 0.25, 0.25);
+            Util.simulateViewerClickWithDrag( {
+                viewer: viewer,
+                widthFactor: 0.25,
+                heightFactor: 0.25,
+                dragCount: 0,
+                dragDx: 0,
+                dragDy: 0
+            } );
         } );
 
         viewer.open('/test/data/testpattern.dzi');

test/events.js

@@ -5,12 +5,12 @@
 
     module( 'Events', {
         setup: function () {
-            var example = $( '<div id="example"></div>' ).appendTo( "#qunit-fixture" );
+            var example = $( '<div id="eventsexample"></div>' ).appendTo( "#qunit-fixture" );
 
             testLog.reset();
 
             viewer = OpenSeadragon( {
-                id: 'example',
+                id: 'eventsexample',
                 prefixUrl: '/build/openseadragon/images/',
                 springStiffness: 100 // Faster animation = faster tests
             } );
@@ -42,8 +42,8 @@
 
     // ----------
     asyncTest( 'addHandler with userData', function () {
-        var userData = { item1: 'Test user data', item2: Math.random() };
+        var userData = { item1: 'Test user data', item2: Math.random() },
-        var originalUserData = { item1: userData.item1, item2: userData.item2 };
+            originalUserData = { item1: userData.item1, item2: userData.item2 };
 
         var openHandler = function ( eventSender, eventData ) {
             viewer.removeHandler( 'open', openHandler );
@@ -60,4 +60,50 @@
         viewer.open( '/test/data/testpattern.dzi' );
     } );
 
+    // ----------
+    asyncTest( 'canvas-drag canvas-release canvas-click', function () {
+        var dragCount = 10,
+            dragMovesHandled = 0,
+            releasesHandled = 0,
+            releasesExpected = 1;
+
+        var openHandler = function ( eventSender, eventData ) {
+            viewer.removeHandler( 'open', openHandler );
+
+            viewer.addHandler( 'canvas-drag', canvasDragHandler );
+            viewer.addHandler( 'canvas-release', canvasReleaseHandler );
+            viewer.addHandler( 'canvas-click', canvasClickHandler );
+
+            Util.simulateViewerClickWithDrag( {
+                viewer: viewer,
+                widthFactor: 0.25,
+                heightFactor: 0.25,
+                dragCount: dragCount,
+                dragDx: 1,
+                dragDy: 1
+            } );
+        };
+
+        var canvasDragHandler = function ( eventSender, eventData ) {
+            dragMovesHandled++;
+        };
+
+        var canvasReleaseHandler = function ( eventSender, eventData ) {
+            releasesHandled++;
+        };
+
+        var canvasClickHandler = function ( eventSender, eventData ) {
+            viewer.removeHandler( 'canvas-drag', canvasDragHandler );
+            viewer.removeHandler( 'canvas-release', canvasReleaseHandler );
+            viewer.removeHandler( 'canvas-click', canvasClickHandler );
+            equal( dragMovesHandled, dragCount, "'canvas-drag' event count matches 'mousemove' event count (" + dragCount + ")" );
+            equal( releasesHandled, releasesExpected, "'canvas-release' event count matches expected (" + releasesExpected + ")" );
+            viewer.close();
+            start();
+        };
+
+        viewer.addHandler( 'open', openHandler );
+        viewer.open( '/test/data/testpattern.dzi' );
+    } );
+
 } )();

test/test.js

@@ -5,30 +5,47 @@
     // ----------
     window.Util = {
         // ----------
-        simulateViewerClick: function(viewer, widthFactor, heightFactor) {
+        simulateViewerClickWithDrag: function ( args ) {
-            if (widthFactor === undefined) {
+            // args = { viewer, widthFactor, heightFactor, dragCount, dragDx, dragDy }
-                widthFactor = 0.5;
+
+            if ( args.hasOwnProperty( 'dragCount' ) ) {
+                args.dragDx = args.dragDx || 1;
+                args.dragDy = args.dragDy || 1;
+            }
+            else {
+                args.dragCount = 0;
+            }
+
+            if ( args.widthFactor === undefined ) {
+                args.widthFactor = 0.5;
             }
 
             //TODO Redefine to be the middle by default
-            if (heightFactor === undefined) {
+            if ( args.heightFactor === undefined ) {
-                heightFactor = 0.5;
+                args.heightFactor = 0.5;
             }
 
-            widthFactor = Math.min(1, Math.max(0, widthFactor));
+            args.widthFactor = Math.min( 1, Math.max( 0, args.widthFactor ) );
             //TODO Fix this.  The max height should be 1/AR
-            heightFactor = Math.min(1, Math.max(0, heightFactor));
+            args.heightFactor = Math.min( 1, Math.max( 0, args.heightFactor ) );
 
-            var $canvas = $(viewer.element).find('.openseadragon-canvas').not('.navigator .openseadragon-canvas');
+            var $canvas = $( args.viewer.element ).find( '.openseadragon-canvas' ).not( '.navigator .openseadragon-canvas' );
             var offset = $canvas.offset();
             var event = {
-                clientX: offset.left + Math.floor($canvas.width() * widthFactor),
+                clientX: offset.left + Math.floor( $canvas.width() * args.widthFactor ),
-                clientY: offset.top + Math.floor($canvas.height() * heightFactor)
+                clientY: offset.top + Math.floor( $canvas.height() * args.heightFactor )
             };
 
             $canvas
                 .simulate( 'mouseover', event )
-                .simulate('mousedown', event)
+                .simulate( 'mousedown', event );
+            for ( var i = 0; i < args.dragCount; i++ ) {
+                event.clientX += args.dragDx;
+                event.clientY += args.dragDy;
+                $canvas
+                    .simulate( "mousemove", event );
+            }
+            $canvas
                 .simulate( 'mouseup', event );
         },