modified Viewer constructor to accept idiomatic options argument while still supporting backward compatible positional args. documented positional args and options arg. Remove Config function allowing all configuration to occur via Viewer options (which is the only place Config was called directly). removed several pointless get_x set_x function in place of direct property access.

openseadragon.js

@@ -40,7 +40,85 @@
  *
  **/
 
-OpenSeadragon = window.OpenSeadragon || function(){};
+OpenSeadragon = window.OpenSeadragon || (function(){
+    
+    //Taken from jquery 1.6.1
+    // [[Class]] -> type pairs
+    var class2type = {
+        '[object Boolean]':     'boolean',
+        '[object Number]':      'number',
+        '[object String]':      'string',
+        '[object Function]':    'function',
+        '[object Array]':       'array',
+        '[object Date]':        'date',
+        '[object RegExp]':      'regexp',
+        '[object Object]':      'object'
+    },
+    // Save a reference to some core methods
+    toString = Object.prototype.toString,
+    hasOwn = Object.prototype.hasOwnProperty,
+    push = Array.prototype.push,
+    slice = Array.prototype.slice,
+    trim = String.prototype.trim,
+    indexOf = Array.prototype.indexOf;
+
+    return {
+        // See test/unit/core.js for details concerning isFunction.
+        // Since version 1.3, DOM methods and functions like alert
+        // aren't supported. They return false on IE (#2968).
+        isFunction: function( obj ) {
+            return OpenSeadragon.type(obj) === "function";
+        },
+
+        isArray: Array.isArray || function( obj ) {
+            return OpenSeadragon.type(obj) === "array";
+        },
+
+        // A crude way of determining if an object is a window
+        isWindow: function( obj ) {
+            return obj && typeof obj === "object" && "setInterval" in obj;
+        },
+
+        type: function( obj ) {
+            return obj == null ?
+                String( obj ) :
+                class2type[ toString.call(obj) ] || "object";
+        },
+
+        isPlainObject: function( obj ) {
+            // Must be an Object.
+            // Because of IE, we also have to check the presence of the constructor property.
+            // Make sure that DOM nodes and window objects don't pass through, as well
+            if ( !obj || OpenSeadragon.type(obj) !== "object" || obj.nodeType || OpenSeadragon.isWindow( obj ) ) {
+                return false;
+            }
+
+            // Not own constructor property must be Object
+            if ( obj.constructor &&
+                !hasOwn.call(obj, "constructor") &&
+                !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) {
+                return false;
+            }
+
+            // Own properties are enumerated firstly, so to speed up,
+            // if last one is own, then all properties are own.
+
+            var key;
+            for ( key in obj ) {}
+
+            return key === undefined || hasOwn.call( obj, key );
+        },
+
+        isEmptyObject: function( obj ) {
+            for ( var name in obj ) {
+                return false;
+            }
+            return true;
+        }
+
+    };
+
+}());
 
 (function( $ ){
     
@@ -54,6 +132,71 @@ OpenSeadragon = window.OpenSeadragon || function(){};
         };
     };
 
+    //Taken from jQuery 1.6.1:
+    $.extend = function() {
+        var options, name, src, copy, copyIsArray, clone,
+            target = arguments[0] || {},
+            i = 1,
+            length = arguments.length,
+            deep = false;
+
+        // Handle a deep copy situation
+        if ( typeof target === "boolean" ) {
+            deep = target;
+            target = arguments[1] || {};
+            // skip the boolean and the target
+            i = 2;
+        }
+
+        // Handle case when target is a string or something (possible in deep copy)
+        if ( typeof target !== "object" && !OpenSeadragon.isFunction(target) ) {
+            target = {};
+        }
+
+        // extend jQuery itself if only one argument is passed
+        if ( length === i ) {
+            target = this;
+            --i;
+        }
+
+        for ( ; i < length; i++ ) {
+            // Only deal with non-null/undefined values
+            if ( (options = arguments[ i ]) != null ) {
+                // Extend the base object
+                for ( name in options ) {
+                    src = target[ name ];
+                    copy = options[ name ];
+
+                    // Prevent never-ending loop
+                    if ( target === copy ) {
+                        continue;
+                    }
+
+                    // Recurse if we're merging plain objects or arrays
+                    if ( deep && copy && ( OpenSeadragon.isPlainObject(copy) || (copyIsArray = OpenSeadragon.isArray(copy)) ) ) {
+                        if ( copyIsArray ) {
+                            copyIsArray = false;
+                            clone = src && OpenSeadragon.isArray(src) ? src : [];
+
+                        } else {
+                            clone = src && OpenSeadragon.isPlainObject(src) ? src : {};
+                        }
+
+                        // Never move original objects, clone them
+                        target[ name ] = OpenSeadragon.extend( deep, clone, copy );
+
+                    // Don't bring in undefined values
+                    } else if ( copy !== undefined ) {
+                        target[ name ] = copy;
+                    }
+                }
+            }
+        }
+
+        // Return the modified object
+        return target;
+    };
+
 }( OpenSeadragon ));
 
 (function($){
@@ -1184,7 +1327,7 @@ $.NavControl.prototype = {
         this._events = value;
     },
     _resolveUrl: function(url) {
-        var prefix = this._viewer.get_prefixUrl();
+        var prefix = this._viewer.prefixUrl;
         return prefix ? prefix + url : url;
     },
     _beginZoomingIn: function() {
@@ -1297,17 +1440,107 @@ $.Control.prototype = {
 }( OpenSeadragon ));
 
 (function( $ ){
+/**
+ *  OpenSeadragon Viewer
+ *
+ *  The main point of entry into creating a zoomable image on the page.
+ *
+ *  We have provided an idiomatic javascript constructor which takes
+ *  a single object, but still support the legacy positional arguments.
+ *
+ *  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.
+ *
+ *  options:{
+ *      element:    String id of Element to attach to,
+ *      xmlPath:    String xpath ( TODO: not sure! ),
+ *      prefixUrl:  String url used to prepend to paths, eg button images,
+ *      controls:   Array of Seadragon.Controls,
+ *      overlays:   Array of Seadragon.Overlays,
+ *      overlayControls: An Array of ( TODO: not sure! )
+ *  }
+ *
+ *
+ **/    
+$.Viewer = function( options ) {
 
-$.Viewer = function(element, xmlPath, prefixUrl, controls, overlays, overlayControls) {
+    var args = arguments;
 
-    this.config = new $.Config();
+    if( typeof( options ) != 'object' ){
-    this._prefixUrl = prefixUrl ? prefixUrl : "";
+        options = {
-    this._element = document.getElementById(element);
+            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,
+            overlayControls:    args.length > 5 ? args[ 5 ] : undefined,
+            config:             {}
+        };
+    }
+    
+    //Allow the options object to override global defaults
+    $.extend( true, this, { 
+        id:                 options.id,
+        xmlPath:            options.xmlPath         || undefined,
+        prefixUrl:          options.prefixUrl       || '',
+        controls:           options.controls        || [],
+        overlays:           options.overlays        || [],
+        overlayControls:    options.overlayControls || [],
+        config: {
+            debugMode:          true,
+            animationTime:      1.5,
+            blendTime:          0.5,
+            alwaysBlend:        false,
+            autoHideControls:   true,
+            immediateRender:    false,
+            wrapHorizontal:     false,
+            wrapVertical:       false,
+            minZoomImageRatio:  0.8,
+            maxZoomPixelRatio:  2,
+            visibilityRatio:    0.5,
+            springStiffness:    5.0,
+            imageLoaderLimit:   2,
+            clickTimeThreshold: 200,
+            clickDistThreshold: 5,
+            zoomPerClick:       2.0,
+            zoomPerScroll:      1.2,
+            zoomPerSecond:      2.0,
+            showNavigationControl: true,
+            maxImageCacheCount: 100,
+            minPixelRatio:      0.5,
+            mouseNavEnabled:    true,
+            navImages: {
+                zoomIn: {
+                    REST:   '/images/zoomin_rest.png',
+                    GROUP:  '/images/zoomin_grouphover.png',
+                    HOVER:  '/images/zoomin_hover.png',
+                    DOWN:   '/images/zoomin_pressed.png'
+                },
+                zoomOut: {
+                    REST:   '/images/zoomout_rest.png',
+                    GROUP:  '/images/zoomout_grouphover.png',
+                    HOVER:  '/images/zoomout_hover.png',
+                    DOWN:   '/images/zoomout_pressed.png'
+                },
+                home: {
+                    REST:   '/images/home_rest.png',
+                    GROUP:  '/images/home_grouphover.png',
+                    HOVER:  '/images/home_hover.png',
+                    DOWN:   '/images/home_pressed.png'
+                },
+                fullpage: {
+                    REST:   '/images/fullpage_rest.png',
+                    GROUP:  '/images/fullpage_grouphover.png',
+                    HOVER:  '/images/fullpage_hover.png',
+                    DOWN:   '/images/fullpage_pressed.png'
+                }
+            }
+        }
+    }, options );
+
+    this._element = document.getElementById( options.id );
 
-    this._controls = controls ? controls : [];
     this._customControls = [];
-    this._overlays = overlays ? overlays : [];
-    this._overlayControls = overlayControls ? overlayControls : [];
     this._container = null;
     this._canvas = null;
     this._controlsTL = null;
@@ -1325,19 +1558,12 @@ $.Viewer = function(element, xmlPath, prefixUrl, controls, overlays, overlayCont
     this._animating = false;
     this._forceRedraw = false;
     this._mouseInside = false;
-    this._xmlPath = xmlPath ? xmlPath : undefined;
 
     this.source = null;
     this.drawer = null;
     this.viewport = null;
     this.profiler = null;
 
-    this.initialize();
-};
-
-$.Viewer.prototype = {
-    initialize: function () {
-
     this._events = new $.EventHandlerList();
 
     this._container = $.Utils.makeNeutralElement("div");
@@ -1417,9 +1643,12 @@ $.Viewer.prototype = {
     this._container.appendChild(this._controlsBL);
     this.get_element().appendChild(this._container);
 
-        if (this._xmlPath)
+    if (this.xmlPath){
-            this.openDzi(this._xmlPath);
+        this.openDzi( this.xmlPath );
-    },
+    }
+};
+
+$.Viewer.prototype = {
     get_events: function get_events() {
         return this._events;
     },
@@ -1455,8 +1684,8 @@ $.Viewer.prototype = {
             opacity = Math.min(1.0, opacity);
             opacity = Math.max(0.0, opacity);
 
-            for (var i = this._controls.length - 1; i >= 0; i--) {
+            for (var i = this.controls.length - 1; i >= 0; i--) {
-                this._controls[i].setOpacity(opacity);
+                this.controls[ i ].setOpacity(opacity);
             }
 
             if (opacity > 0) {
@@ -1506,8 +1735,8 @@ $.Viewer.prototype = {
         }
     },
     _getControlIndex: function (elmt) {
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for (var i = this.controls.length - 1; i >= 0; i--) {
-            if (this._controls[i].elmt == elmt) {
+            if (this.controls[ i ].elmt == elmt) {
                 return i;
             }
         }
@@ -1516,8 +1745,8 @@ $.Viewer.prototype = {
     },
     _abortControlsAutoHide: function () {
         this._controlsShouldFade = false;
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for (var i = this.controls.length - 1; i >= 0; i--) {
-            this._controls[i].setOpacity(1.0);
+            this.controls[ i ].setOpacity(1.0);
         }
     },
     _onContainerEnter: function (tracker, position, buttonDownElmt, buttonDownAny) {
@@ -1637,8 +1866,8 @@ $.Viewer.prototype = {
         this._forceRedraw = true;
         this._scheduleUpdate(this._updateMulti);
 
-        for (var i = 0; i < this._overlayControls.length; i++) {
+        for (var i = 0; i < this.overlayControls.length; i++) {
-            var overlay = this._overlayControls[i];
+            var overlay = this.overlayControls[ i ];
             if (overlay.point != null) {
                 this.drawer.addOverlay(overlay.id, new $.Point(overlay.point.X, overlay.point.Y), $.OverlayPlacement.TOP_LEFT);
             }
@@ -1721,12 +1950,6 @@ $.Viewer.prototype = {
     get_element: function () {
         return this._element;
     },
-    get_xmlPath: function () {
-        return this._xmlPath;
-    },
-    set_xmlPath: function (value) {
-        this._xmlPath = value;
-    },
     get_debugMode: function () {
         return this.config.debugMode;
     },
@@ -1865,18 +2088,6 @@ $.Viewer.prototype = {
     set_controls: function (value) {
         this._customControls = value;
     },
-    get_overlays: function () {
-        return this._overlayControls;
-    },
-    set_overlays: function (value) {
-        this._overlayControls = value;
-    },
-    get_prefixUrl: function () {
-        return this._prefixUrl;
-    },
-    set_prefixUrl: function (value) {
-        this._prefixUrl = value;
-    },
     add_open: function (handler) {
         this.get_events().addHandler("open", handler);
     },
@@ -1952,7 +2163,7 @@ $.Viewer.prototype = {
                 break;
         }
 
-        this._controls.push(new $.Control(elmt, anchor, div));
+        this.controls.push(new $.Control(elmt, anchor, div));
 
         elmt.style.display = "inline-block";
     },
@@ -1982,18 +2193,18 @@ $.Viewer.prototype = {
         var i = this._getControlIndex(elmt);
 
         if (i >= 0) {
-            this._controls[i].destroy();
+            this.controls[ i ].destroy();
-            this._controls.splice(i, 1);
+            this.controls.splice( i, 1 );
         }
     },
     clearControls: function () {
-        while (this._controls.length > 0) {
+        while ( this.controls.length > 0 ) {
-            this._controls.pop().destroy();
+            this.controls.pop().destroy();
         }
     },
     isDashboardEnabled: function () {
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for ( var i = this.controls.length - 1; i >= 0; i-- ) {
-            if (this._controls[i].isVisible()) {
+            if (this.controls[ i ].isVisible()) {
                 return true;
             }
         }
@@ -2014,8 +2225,8 @@ $.Viewer.prototype = {
     },
 
     setDashboardEnabled: function (enabled) {
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for ( var i = this.controls.length - 1; i >= 0; i-- ) {
-            this._controls[i].setVisible(enabled);
+            this.controls[ i ].setVisible( enabled );
         }
     },
 
@@ -3012,9 +3223,14 @@ $.Button.prototype = {
  *
  * Manages events on groups of buttons.
  *    
- * options {}
+ * options: {
- *      buttons - an array of buttons
+ *     buttons: Array of buttons * required,
- *      
+ *     group:   Element to use as the container,
+ *     config:  Object with Viewer settings ( TODO: is this actually used anywhere? )
+ *     enter:   Function callback for when the mouse enters group
+ *     exit:    Function callback for when mouse leaves the group
+ *     release: Function callback for when mouse is released
+ * }
  **/
 $.ButtonGroup = function( options ) {
 
@@ -3079,86 +3295,11 @@ $.ButtonGroup.prototype = {
     }
 };
 
-}( OpenSeadragon ));
-
-(function( $ ){
-    
-$.Config = function () {
-
-    this.debugMode = true;
-
-    this.animationTime = 1.5;
-
-    this.blendTime = 0.5;
-
-    this.alwaysBlend = false;
-
-    this.autoHideControls = true;
-
-    this.immediateRender = false;
-
-    this.wrapHorizontal = false;
-
-    this.wrapVertical = false;
-
-    this.minZoomImageRatio = 0.8;
-
-    this.maxZoomPixelRatio = 2;
-
-    this.visibilityRatio = 0.5;
-
-    this.springStiffness = 5.0;
-
-    this.imageLoaderLimit = 2;
-
-    this.clickTimeThreshold = 200;
-
-    this.clickDistThreshold = 5;
-
-    this.zoomPerClick = 2.0;
-
-    this.zoomPerScroll = 1.2;
-
-    this.zoomPerSecond = 2.0;
-
-    this.showNavigationControl = true;
-
-    this.maxImageCacheCount = 100;
-
-    this.minPixelRatio = 0.5;
-
-    this.mouseNavEnabled = true;
-
-    this.navImages = {
-        zoomIn: {
-            REST: '/images/zoomin_rest.png',
-            GROUP: '/images/zoomin_grouphover.png',
-            HOVER: '/images/zoomin_hover.png',
-            DOWN: '/images/zoomin_pressed.png'
-        },
-        zoomOut: {
-            REST: '/images/zoomout_rest.png',
-            GROUP: '/images/zoomout_grouphover.png',
-            HOVER: '/images/zoomout_hover.png',
-            DOWN: '/images/zoomout_pressed.png'
-        },
-        home: {
-            REST: '/images/home_rest.png',
-            GROUP: '/images/home_grouphover.png',
-            HOVER: '/images/home_hover.png',
-            DOWN: '/images/home_pressed.png'
-        },
-        fullpage: {
-            REST: '/images/fullpage_rest.png',
-            GROUP: '/images/fullpage_grouphover.png',
-            HOVER: '/images/fullpage_hover.png',
-            DOWN: '/images/fullpage_pressed.png'
-        }
-    }
-};
 
 }( OpenSeadragon ));
 
+
+
 (function( $ ){
     
 $.Rect = function(x, y, width, height) {

src/buttongroup.js

@@ -5,9 +5,14 @@
  *
  * Manages events on groups of buttons.
  *    
- * options {}
+ * options: {
- *      buttons - an array of buttons
+ *     buttons: Array of buttons * required,
- *      
+ *     group:   Element to use as the container,
+ *     config:  Object with Viewer settings ( TODO: is this actually used anywhere? )
+ *     enter:   Function callback for when the mouse enters group
+ *     exit:    Function callback for when mouse leaves the group
+ *     release: Function callback for when mouse is released
+ * }
  **/
 $.ButtonGroup = function( options ) {
 
@@ -72,4 +77,5 @@ $.ButtonGroup.prototype = {
     }
 };
 
+
 }( OpenSeadragon ));

src/config.js

@@ -1,78 +1,2 @@
 
-(function( $ ){
 
-$.Config = function () {
-
-    this.debugMode = true;
-
-    this.animationTime = 1.5;
-
-    this.blendTime = 0.5;
-
-    this.alwaysBlend = false;
-
-    this.autoHideControls = true;
-
-    this.immediateRender = false;
-
-    this.wrapHorizontal = false;
-
-    this.wrapVertical = false;
-
-    this.minZoomImageRatio = 0.8;
-
-    this.maxZoomPixelRatio = 2;
-
-    this.visibilityRatio = 0.5;
-
-    this.springStiffness = 5.0;
-
-    this.imageLoaderLimit = 2;
-
-    this.clickTimeThreshold = 200;
-
-    this.clickDistThreshold = 5;
-
-    this.zoomPerClick = 2.0;
-
-    this.zoomPerScroll = 1.2;
-
-    this.zoomPerSecond = 2.0;
-
-    this.showNavigationControl = true;
-
-    this.maxImageCacheCount = 100;
-
-    this.minPixelRatio = 0.5;
-
-    this.mouseNavEnabled = true;
-
-    this.navImages = {
-        zoomIn: {
-            REST: '/images/zoomin_rest.png',
-            GROUP: '/images/zoomin_grouphover.png',
-            HOVER: '/images/zoomin_hover.png',
-            DOWN: '/images/zoomin_pressed.png'
-        },
-        zoomOut: {
-            REST: '/images/zoomout_rest.png',
-            GROUP: '/images/zoomout_grouphover.png',
-            HOVER: '/images/zoomout_hover.png',
-            DOWN: '/images/zoomout_pressed.png'
-        },
-        home: {
-            REST: '/images/home_rest.png',
-            GROUP: '/images/home_grouphover.png',
-            HOVER: '/images/home_hover.png',
-            DOWN: '/images/home_pressed.png'
-        },
-        fullpage: {
-            REST: '/images/fullpage_rest.png',
-            GROUP: '/images/fullpage_grouphover.png',
-            HOVER: '/images/fullpage_hover.png',
-            DOWN: '/images/fullpage_pressed.png'
-        }
-    }
-};
-
-}( OpenSeadragon ));

src/navcontrol.js

@@ -90,7 +90,7 @@ $.NavControl.prototype = {
         this._events = value;
     },
     _resolveUrl: function(url) {
-        var prefix = this._viewer.get_prefixUrl();
+        var prefix = this._viewer.prefixUrl;
         return prefix ? prefix + url : url;
     },
     _beginZoomingIn: function() {

src/openseadragon.js

@@ -40,7 +40,85 @@
  *
  **/
 
-OpenSeadragon = window.OpenSeadragon || function(){};
+OpenSeadragon = window.OpenSeadragon || (function(){
+    
+    //Taken from jquery 1.6.1
+    // [[Class]] -> type pairs
+    var class2type = {
+        '[object Boolean]':     'boolean',
+        '[object Number]':      'number',
+        '[object String]':      'string',
+        '[object Function]':    'function',
+        '[object Array]':       'array',
+        '[object Date]':        'date',
+        '[object RegExp]':      'regexp',
+        '[object Object]':      'object'
+    },
+    // Save a reference to some core methods
+    toString = Object.prototype.toString,
+    hasOwn = Object.prototype.hasOwnProperty,
+    push = Array.prototype.push,
+    slice = Array.prototype.slice,
+    trim = String.prototype.trim,
+    indexOf = Array.prototype.indexOf;
+
+    return {
+        // See test/unit/core.js for details concerning isFunction.
+        // Since version 1.3, DOM methods and functions like alert
+        // aren't supported. They return false on IE (#2968).
+        isFunction: function( obj ) {
+            return OpenSeadragon.type(obj) === "function";
+        },
+
+        isArray: Array.isArray || function( obj ) {
+            return OpenSeadragon.type(obj) === "array";
+        },
+
+        // A crude way of determining if an object is a window
+        isWindow: function( obj ) {
+            return obj && typeof obj === "object" && "setInterval" in obj;
+        },
+
+        type: function( obj ) {
+            return obj == null ?
+                String( obj ) :
+                class2type[ toString.call(obj) ] || "object";
+        },
+
+        isPlainObject: function( obj ) {
+            // Must be an Object.
+            // Because of IE, we also have to check the presence of the constructor property.
+            // Make sure that DOM nodes and window objects don't pass through, as well
+            if ( !obj || OpenSeadragon.type(obj) !== "object" || obj.nodeType || OpenSeadragon.isWindow( obj ) ) {
+                return false;
+            }
+
+            // Not own constructor property must be Object
+            if ( obj.constructor &&
+                !hasOwn.call(obj, "constructor") &&
+                !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) {
+                return false;
+            }
+
+            // Own properties are enumerated firstly, so to speed up,
+            // if last one is own, then all properties are own.
+
+            var key;
+            for ( key in obj ) {}
+
+            return key === undefined || hasOwn.call( obj, key );
+        },
+
+        isEmptyObject: function( obj ) {
+            for ( var name in obj ) {
+                return false;
+            }
+            return true;
+        }
+
+    };
+
+}());
 
 (function( $ ){
     
@@ -54,4 +132,69 @@ OpenSeadragon = window.OpenSeadragon || function(){};
         };
     };
 
+    //Taken from jQuery 1.6.1:
+    $.extend = function() {
+        var options, name, src, copy, copyIsArray, clone,
+            target = arguments[0] || {},
+            i = 1,
+            length = arguments.length,
+            deep = false;
+
+        // Handle a deep copy situation
+        if ( typeof target === "boolean" ) {
+            deep = target;
+            target = arguments[1] || {};
+            // skip the boolean and the target
+            i = 2;
+        }
+
+        // Handle case when target is a string or something (possible in deep copy)
+        if ( typeof target !== "object" && !OpenSeadragon.isFunction(target) ) {
+            target = {};
+        }
+
+        // extend jQuery itself if only one argument is passed
+        if ( length === i ) {
+            target = this;
+            --i;
+        }
+
+        for ( ; i < length; i++ ) {
+            // Only deal with non-null/undefined values
+            if ( (options = arguments[ i ]) != null ) {
+                // Extend the base object
+                for ( name in options ) {
+                    src = target[ name ];
+                    copy = options[ name ];
+
+                    // Prevent never-ending loop
+                    if ( target === copy ) {
+                        continue;
+                    }
+
+                    // Recurse if we're merging plain objects or arrays
+                    if ( deep && copy && ( OpenSeadragon.isPlainObject(copy) || (copyIsArray = OpenSeadragon.isArray(copy)) ) ) {
+                        if ( copyIsArray ) {
+                            copyIsArray = false;
+                            clone = src && OpenSeadragon.isArray(src) ? src : [];
+
+                        } else {
+                            clone = src && OpenSeadragon.isPlainObject(src) ? src : {};
+                        }
+
+                        // Never move original objects, clone them
+                        target[ name ] = OpenSeadragon.extend( deep, clone, copy );
+
+                    // Don't bring in undefined values
+                    } else if ( copy !== undefined ) {
+                        target[ name ] = copy;
+                    }
+                }
+            }
+        }
+
+        // Return the modified object
+        return target;
+    };
+
 }( OpenSeadragon ));

src/viewer.js

@@ -1,16 +1,106 @@
 
 (function( $ ){
+/**
+ *  OpenSeadragon Viewer
+ *
+ *  The main point of entry into creating a zoomable image on the page.
+ *
+ *  We have provided an idiomatic javascript constructor which takes
+ *  a single object, but still support the legacy positional arguments.
+ *
+ *  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.
+ *
+ *  options:{
+ *      element:    String id of Element to attach to,
+ *      xmlPath:    String xpath ( TODO: not sure! ),
+ *      prefixUrl:  String url used to prepend to paths, eg button images,
+ *      controls:   Array of Seadragon.Controls,
+ *      overlays:   Array of Seadragon.Overlays,
+ *      overlayControls: An Array of ( TODO: not sure! )
+ *  }
+ *
+ *
+ **/    
+$.Viewer = function( options ) {
 
-$.Viewer = function(element, xmlPath, prefixUrl, controls, overlays, overlayControls) {
+    var args = arguments;
 
-    this.config = new $.Config();
+    if( typeof( options ) != 'object' ){
-    this._prefixUrl = prefixUrl ? prefixUrl : "";
+        options = {
-    this._element = document.getElementById(element);
+            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,
+            overlayControls:    args.length > 5 ? args[ 5 ] : undefined,
+            config:             {}
+        };
+    }
+    
+    //Allow the options object to override global defaults
+    $.extend( true, this, { 
+        id:                 options.id,
+        xmlPath:            options.xmlPath         || undefined,
+        prefixUrl:          options.prefixUrl       || '',
+        controls:           options.controls        || [],
+        overlays:           options.overlays        || [],
+        overlayControls:    options.overlayControls || [],
+        config: {
+            debugMode:          true,
+            animationTime:      1.5,
+            blendTime:          0.5,
+            alwaysBlend:        false,
+            autoHideControls:   true,
+            immediateRender:    false,
+            wrapHorizontal:     false,
+            wrapVertical:       false,
+            minZoomImageRatio:  0.8,
+            maxZoomPixelRatio:  2,
+            visibilityRatio:    0.5,
+            springStiffness:    5.0,
+            imageLoaderLimit:   2,
+            clickTimeThreshold: 200,
+            clickDistThreshold: 5,
+            zoomPerClick:       2.0,
+            zoomPerScroll:      1.2,
+            zoomPerSecond:      2.0,
+            showNavigationControl: true,
+            maxImageCacheCount: 100,
+            minPixelRatio:      0.5,
+            mouseNavEnabled:    true,
+            navImages: {
+                zoomIn: {
+                    REST:   '/images/zoomin_rest.png',
+                    GROUP:  '/images/zoomin_grouphover.png',
+                    HOVER:  '/images/zoomin_hover.png',
+                    DOWN:   '/images/zoomin_pressed.png'
+                },
+                zoomOut: {
+                    REST:   '/images/zoomout_rest.png',
+                    GROUP:  '/images/zoomout_grouphover.png',
+                    HOVER:  '/images/zoomout_hover.png',
+                    DOWN:   '/images/zoomout_pressed.png'
+                },
+                home: {
+                    REST:   '/images/home_rest.png',
+                    GROUP:  '/images/home_grouphover.png',
+                    HOVER:  '/images/home_hover.png',
+                    DOWN:   '/images/home_pressed.png'
+                },
+                fullpage: {
+                    REST:   '/images/fullpage_rest.png',
+                    GROUP:  '/images/fullpage_grouphover.png',
+                    HOVER:  '/images/fullpage_hover.png',
+                    DOWN:   '/images/fullpage_pressed.png'
+                }
+            }
+        }
+    }, options );
+
+    this._element = document.getElementById( options.id );
 
-    this._controls = controls ? controls : [];
     this._customControls = [];
-    this._overlays = overlays ? overlays : [];
-    this._overlayControls = overlayControls ? overlayControls : [];
     this._container = null;
     this._canvas = null;
     this._controlsTL = null;
@@ -28,19 +118,12 @@ $.Viewer = function(element, xmlPath, prefixUrl, controls, overlays, overlayCont
     this._animating = false;
     this._forceRedraw = false;
     this._mouseInside = false;
-    this._xmlPath = xmlPath ? xmlPath : undefined;
 
     this.source = null;
     this.drawer = null;
     this.viewport = null;
     this.profiler = null;
 
-    this.initialize();
-};
-
-$.Viewer.prototype = {
-    initialize: function () {
-
     this._events = new $.EventHandlerList();
 
     this._container = $.Utils.makeNeutralElement("div");
@@ -120,9 +203,12 @@ $.Viewer.prototype = {
     this._container.appendChild(this._controlsBL);
     this.get_element().appendChild(this._container);
 
-        if (this._xmlPath)
+    if (this.xmlPath){
-            this.openDzi(this._xmlPath);
+        this.openDzi( this.xmlPath );
-    },
+    }
+};
+
+$.Viewer.prototype = {
     get_events: function get_events() {
         return this._events;
     },
@@ -158,8 +244,8 @@ $.Viewer.prototype = {
             opacity = Math.min(1.0, opacity);
             opacity = Math.max(0.0, opacity);
 
-            for (var i = this._controls.length - 1; i >= 0; i--) {
+            for (var i = this.controls.length - 1; i >= 0; i--) {
-                this._controls[i].setOpacity(opacity);
+                this.controls[ i ].setOpacity(opacity);
             }
 
             if (opacity > 0) {
@@ -209,8 +295,8 @@ $.Viewer.prototype = {
         }
     },
     _getControlIndex: function (elmt) {
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for (var i = this.controls.length - 1; i >= 0; i--) {
-            if (this._controls[i].elmt == elmt) {
+            if (this.controls[ i ].elmt == elmt) {
                 return i;
             }
         }
@@ -219,8 +305,8 @@ $.Viewer.prototype = {
     },
     _abortControlsAutoHide: function () {
         this._controlsShouldFade = false;
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for (var i = this.controls.length - 1; i >= 0; i--) {
-            this._controls[i].setOpacity(1.0);
+            this.controls[ i ].setOpacity(1.0);
         }
     },
     _onContainerEnter: function (tracker, position, buttonDownElmt, buttonDownAny) {
@@ -340,8 +426,8 @@ $.Viewer.prototype = {
         this._forceRedraw = true;
         this._scheduleUpdate(this._updateMulti);
 
-        for (var i = 0; i < this._overlayControls.length; i++) {
+        for (var i = 0; i < this.overlayControls.length; i++) {
-            var overlay = this._overlayControls[i];
+            var overlay = this.overlayControls[ i ];
             if (overlay.point != null) {
                 this.drawer.addOverlay(overlay.id, new $.Point(overlay.point.X, overlay.point.Y), $.OverlayPlacement.TOP_LEFT);
             }
@@ -424,12 +510,6 @@ $.Viewer.prototype = {
     get_element: function () {
         return this._element;
     },
-    get_xmlPath: function () {
-        return this._xmlPath;
-    },
-    set_xmlPath: function (value) {
-        this._xmlPath = value;
-    },
     get_debugMode: function () {
         return this.config.debugMode;
     },
@@ -568,18 +648,6 @@ $.Viewer.prototype = {
     set_controls: function (value) {
         this._customControls = value;
     },
-    get_overlays: function () {
-        return this._overlayControls;
-    },
-    set_overlays: function (value) {
-        this._overlayControls = value;
-    },
-    get_prefixUrl: function () {
-        return this._prefixUrl;
-    },
-    set_prefixUrl: function (value) {
-        this._prefixUrl = value;
-    },
     add_open: function (handler) {
         this.get_events().addHandler("open", handler);
     },
@@ -655,7 +723,7 @@ $.Viewer.prototype = {
                 break;
         }
 
-        this._controls.push(new $.Control(elmt, anchor, div));
+        this.controls.push(new $.Control(elmt, anchor, div));
 
         elmt.style.display = "inline-block";
     },
@@ -685,18 +753,18 @@ $.Viewer.prototype = {
         var i = this._getControlIndex(elmt);
 
         if (i >= 0) {
-            this._controls[i].destroy();
+            this.controls[ i ].destroy();
-            this._controls.splice(i, 1);
+            this.controls.splice( i, 1 );
         }
     },
     clearControls: function () {
-        while (this._controls.length > 0) {
+        while ( this.controls.length > 0 ) {
-            this._controls.pop().destroy();
+            this.controls.pop().destroy();
         }
     },
     isDashboardEnabled: function () {
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for ( var i = this.controls.length - 1; i >= 0; i-- ) {
-            if (this._controls[i].isVisible()) {
+            if (this.controls[ i ].isVisible()) {
                 return true;
             }
         }
@@ -717,8 +785,8 @@ $.Viewer.prototype = {
     },
 
     setDashboardEnabled: function (enabled) {
-        for (var i = this._controls.length - 1; i >= 0; i--) {
+        for ( var i = this.controls.length - 1; i >= 0; i-- ) {
-            this._controls[i].setVisible(enabled);
+            this.controls[ i ].setVisible( enabled );
         }
     },