sproutcore 1.4.5-java → 1.5.0-java

data/lib/frameworks/sproutcore/frameworks/foundation/system/exception_handler.js

@@ -1,11 +1,13 @@
 // ==========================================================================
 // Project:   SproutCore - JavaScript Application Framework
 // Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
 // License:   Licensed under MIT license (see license.js)
 // ==========================================================================
 
 /**
+  @namespace
+
   If an exception is thrown during execution of your SproutCore app, this
   object will be given the opportunity to handle it.
 
@@ -20,8 +22,11 @@
 
   @since SproutCore 1.5
 */
-
 SC.ExceptionHandler = {
+
+  /** @private */
+  enabled: (SC.buildMode !== 'debug'),
+
   /**
     Called when an exception is encountered by code executed using SC.run().
 
@@ -79,7 +84,8 @@ SC.ExceptionHandler = {
   /**
     YES if an exception was thrown and the error dialog is visible.
 
-    @property {Boolean}
+    @type Boolean
+    @default NO
   */
   isShowingErrorDialog: NO
 };

data/lib/frameworks/sproutcore/frameworks/foundation/system/gesture.js

@@ -0,0 +1,363 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+
+/**
+  @class
+  
+  An SC.Gesture analyzes SC.Touch objects and determines if they are part
+  of a gesture. If they are, SC.Gestures keep the views that own them up-to-date
+  as that gesture progresses, informing it when it starts, when some aspect of
+  it changes, when it ends, and—for convenience—when it is considered to have
+  been "triggered".
+  
+  Gestures can call the following methods on their views:
+  
+  - [gestureName](gesture, args...): called when the gesture has occurred. This is 
+    useful for event-style gestures, where you aren't interested in when it starts or
+    ends, but just that it has occurred. SC.SwipeGesture triggers this after the
+    swipe has moved a minimum amount—40px by default.
+
+  - [gestureName]Start(gesture, args...): called when the gesture is first recognized. 
+    For instance, a swipe gesture may be recognized after the finger has moved a 
+    minimum distance in a horizontal.
+    
+  - [gestureName]Changed(gesture, args...): called when some property of the gesture 
+    has changed. For instance, this may be called continuously as the user swipes as 
+    the swipe's distance changes.
+  
+  - [gestureName]Cancelled(gesture, args...): called when a gesture, for one reason 
+    or another, is no longer recognized. For instance, a horizontal swipe gesture 
+    could cancel if the user moves too far in a vertical direction.
+  
+  - [gestureName]End(gesture, args...): called when a gesture ends. A swipe would end
+    when the user lifts their finger.
+  
+  Gesture Lifecycle
+  ------------------------
+  Gestures start receiving events when their view—usually mixing in SC.Gesturable—tells it
+  about activities with "unassigned" touches. "Unassigned" touches are touches that have
+  not _yet_ been assigned to a gesture.
+  
+  The touch becomes "assigned" when the gesture's touchIsInGesture method returns YES.
+  When a tocuh is assigned to a gesture, the gesture becomes the touch's touch responder;
+  this means that it will receive a touchStart event (to which it must return YES), and
+  then, all further touch events will be sent _directly_ to the gesture—the gesture's view
+  will not receive them at all.
+  
+  At any point, the gesture may tell the view that it has started, ended, or changed. In
+  addition, the gesture may tell the view it has been "triggered." A gesture is not
+  necessarily "triggered" when it starts and ends; for instance, a swipe gesture might
+  only be triggered if the swipe moves more than a specified amount. The ability to track
+  when the gesture has been triggered allows views to easily handle the gesture as its own
+  event, rather than as the individual events that are part of it.
+  
+  If, at some point, the gesture must release the touch back (perhaps the gesture had _thought_
+  the touch was a part of it, but turned out to be incorrect), the release(touch) method releases
+  it back to the view.
+  
+  Exclusivity
+  ---------------------------------
+  The concept described above gives the gestures a way to be either exclusive or inclusive as-needed:
+  they can choose to take exclusive control of a touch if they think it is theirs, but if they are
+  not sure, they can wait and see.
+  
+  Status Object
+  ---------------------------------
+  It is a common need to track some data related to the touch, but without modifying the touch itself.
+  SC.Gesture is able to keep track of simple hashes for you, mapping them to the SC.Touch object,
+  so that you can maintain some state related to the touch.
+  
+  For instance, you could set status.failed in touchesDragged, if a touch that you previously
+  thought may have been part of the gesture turned out not to be, and then check for 
+  status.failed in touchIsInGesture, returning NO if present. This would cause the touch
+  to never be considered for your gesture again.
+  
+  touchIsInGesture is called with the status hash provided in the second argument. You may look
+  up the status hash for a touch at any time by calling this.statusForTouch(touch).
+  
+  
+  Implementing a Gesture
+  ---------------------------------
+  To write a gesture, you would generally implement the following methods:
+  
+  - touchIsInGesture: Return YES when the touch is—or is likely enough to be that you
+    want your gesture to have exclusive control over the touch. You usually do not
+    perform much gesture logic here—instead, you save it for touchStart, which will
+    get called after you return YES from this method.
+  
+  - touchStart: Return YES to accept control of the touch. If you do not return YES,
+    your gesture will not receive touchesDragged nor touchEnd events. At this point,
+    you may (or may not) wish to tell the view that the gesture has started by using the
+    start(args...) method.
+    
+  - touchesDragged: Use this as you would use it in an SC.View to track the touches
+    assigned to the gesture. At this point, you might want to tell the view that the
+    gesture has updated by using the change(args...) method.
+  
+  - touchEnd: Again, use this like you would in an SC.View to track when touches
+    assigned to the gesture have ended. This is also a potential time to alert the view
+    that the gesture has ended, by using the end(args...) method. Further, this may
+    also be the time to "trigger" the gesture.
+  
+*/
+SC.Gesture = SC.Object.extend({
+  /**
+    The gesture's name. When calling events on the owning SC.View, this name will
+    be prefixed to the methods. For instance, if the method to be called is
+    'Start', and the gesture's name is 'swipe', SC.Gesture will call 'swipeStart'.
+  */
+  name: "gesture",
+
+  /**
+    Return YES to take exclusive control over the touch. In addition to the
+    SC.Touch object you may take control of, you are also provided a "status"
+    hash, which is unique for both the gesture instance and the touch instance,
+    which you may use for your own purposes. 
+  */
+  touchIsInGesture: function(touch, status) {
+    return NO;
+  },
+  
+  /**
+    After you return YES from touchIsInGesture (or otherwise 'take' a touch, perhaps
+    using the 'take' method), touchStart will be called.
+    
+    This is where you do any logic needed now that the touch is part of the gesture.
+    For instance, you could inform the view that the gesture has started by calling
+    this.start().
+    
+    NOTE: SC.Gesture is just like SC.View in that it has an acceptsMultitouch property.
+    If NO (the default), the gesture will only receive touchStart for the first touch
+    assigned to it, and only receive touchEnd for the last touch that ends.
+  */
+  touchStart: function(touch) {
+    
+  },
+  
+  /**
+    Called when touches assigned to the gesture have moved.
+    
+    This is where you update the gesture's state, potentially calling change() to
+    notify the view.
+  */
+  touchesDragged: function(evt, touches) {
+    
+  },
+  
+  /**
+    Called when a touch assigned to the gesture ends.
+    
+    If there are no remaining touches on the gesture, you may want to call end() to
+    notify the view that the gesture has ended (if you haven't ended the gesture
+    already).
+    
+    NOTE: SC.Gesture is just like SC.View in that it has an acceptsMultitouch property.
+    If NO (the default), the gesture will only receive touchStart for the first touch
+    assigned to it, and only receive touchEnd for the last touch that ends.
+  */
+  touchEnd: function(touch) {
+    
+  },
+  
+  /**
+    Starts the gesture (marking it as "active"), and notifies the view.
+    
+    You can pass any number of arguments to start. They will, along with
+    the gesture instance itself, will be passed to the appropriate gesture 
+    event on the SC.View.
+  */
+  start: function() {
+    if (!this.get("isActive")) {
+      this.set("isActive", YES);
+      
+      var args = SC.$A(arguments);
+      args.unshift(this);
+      
+      var act = this.name + "Start";
+      if (this.view[act]) this.view[act].apply(this.view, args);
+    }
+  },
+  
+  /**
+    Ends the gesture, if it is active (marking it as not active), and notifies
+    the view.
+    
+    You may pass any number of arguments to end(). They, along with your gesture
+    instance itself, will be passed to the appropriate gesture event on the SC.View.
+  */
+  end: function() {
+    if (this.get("isActive")) {
+      this.set("isActive", NO);
+
+      var args = SC.$A(arguments);
+      args.unshift(this);
+      
+      var act = this.name + "End";
+      if (this.view[act]) this.view[act].apply(this.view, args);
+    }
+  },
+  
+  /**
+    If the gesture is active, notifies the view that the gesture has
+    changed.
+    
+    The gesture, along with any arguments to change(), will be passed to
+    the appropriate method on the SC.View.
+  */
+  change: function() {
+    if (this.get('isActive')) {
+      var args = SC.$A(arguments);
+      args.unshift(this);
+
+      var act = this.name + "Changed";
+      if (this.view[act]) this.view[act].apply(this.view, args);
+    }
+  },
+
+  /**
+    Cancels the gesture, if it is active, and notifies the view that the
+    gesture has been cancelled.
+    
+    Gestures are cancelled when they have ended, but any action that would
+    normally be appropriate due to their ending should not be performed.
+    
+    The gesture, along with any arguments to cancel(), will be passed to the
+    appropriate method on the SC.View.
+  */
+  cancel: function(){
+    if (this.get('isActive')) {
+      this.set('isActive', NO);
+
+      var args = SC.$A(arguments);
+      args.unshift(this);
+
+      var act = this.name + "Cancelled";
+      if (this.view[act]) this.view[act].apply(this.view, args);
+    }
+  },
+  
+  /**
+    Triggers the gesture, notifying the view that the gesture has happened.
+    
+    You should trigger a gesture where it would be natural to say it has "happened";
+    for instance, if a touch moves a couple of pixels, you probably wouldn't say
+    a swipe has occurred—though you might say it has "begun." And you wouldn't necessarily
+    wait until the touch has ended either. Once the touch has moved a certain amount,
+    there has definitely been a swipe. By calling trigger() at this point, you will
+    tell the view that it has occurred.
+    
+    For SC.SwipeGesture, this allows a view to implement only swipe(), and then be 
+    automatically notified whenever any swipe has occurred.
+  */
+  trigger: function() {
+    var args = SC.$A(arguments);
+    args.unshift(this);
+    
+    var act = this.name;
+    if (this.view[act]) this.view[act].apply(this.view, args);
+  },
+
+  /**
+    Takes possession of a touch. This does not take effect immediately; it takes effect after
+    the run loop finishes to prevent it from being called during another makeTouchResponder.
+    
+    This is called automatically when you return YES from touchIsInGesture.
+  */
+  take: function(touch) {
+    touch.isTaken = YES; // because even changing responder won't prevent it from being used this cycle.
+    if (SC.none(touch.touchResponder) || touch.touchResponder !== this) touch.makeTouchResponder(this, YES);
+  },
+  
+  /**
+    Releases a touch back to its previous owner, which is usually the view. This allows
+    you to give back control of a touch that it turns out is not part of the gesture. 
+    
+    This takes effect immediately, because you would usually call this from
+    touchesDragged or such.
+  */
+  release: function(touch) {
+    touch.isTaken = NO;
+    if (touch.nextTouchResponder) touch.makeTouchResponder(touch.nextTouchResponder);
+  },
+  
+  /**
+    Discards a touch, making its responder null. This makes the touch go away and never
+    come back—not to this gesture, nor to any other, nor to the view, nor to any other
+    view.
+  */
+  discardTouch: function(touch) {
+    touch.isTaken = YES; // because even changing responder won't prevent it from being used this cycle.
+    touch.makeTouchResponder(null);
+  },
+  
+  /**
+    Returns a status hash (which gestures may and should modify) for a given touch, for tracking
+    whether it is a potential match, etc.
+  */
+  statusForTouch: function(touch) {
+    var key = SC.guidFor(touch.view) + this.name;
+    var status = touch[key];
+    if (!status) status = touch[key] = {};
+    return status;
+  },
+  
+  /**
+    Called when an unassigned touch has started. By default, this calls touchIsInGesture, and,
+    if it returns YES, takes possesion of the touch (causing touchStart to  be called).
+  */
+  unassignedTouchDidStart: function(touch) {
+    if (touch.isTaken) return;
+    if (this.touchIsInGesture(touch, this.statusForTouch(touch))) {
+      this.take(touch);
+    }
+  },
+  
+  /**
+    This is called when the unassigned touches (touches not in a gesture) change or move
+    in some way. By default, this calls touchIsInGesture(touch, status) for each touch.
+  */
+  unassignedTouchesDidChange: function(evt, touches) {
+    touches.forEach(function(touch) {
+      if (touch.isTaken) return;
+      if (this.touchIsInGesture(touch, this.statusForTouch(touch))) {
+        this.take(touch);
+      }
+    }, this);
+  },
+  
+  /**
+    This is called when the unassigned touches (touches not in the gesture) have ended.
+    Default does nothing. Some gestures may want to implement this even if they don't implement
+    unassignedTouchesDidChange.
+  */
+  unassignedTouchDidEnd: function(touch) {
+    
+  },
+  
+  /**
+    Marks the touch as "interesting" to this gesture. A view could then check the 'isInteresting'
+    property of the touch to see if any gestures are interested in it, potentially delaying any
+    action of releasing the touch to another view.
+  */
+  interestedInTouch: function(touch) {
+    var status = this.statusForTouch(touch);
+    if (status.isInterested) return;
+    status.isInterested = YES;
+    touch.isInteresting++;
+  },
+  
+  /**
+    Marks the touch as "uninteresting" to this gesture.
+  */
+  uninterestedInTouch: function(touch) {
+    var status = this.statusForTouch(touch);
+    if (!status.isInterested) return;
+    status.isInterested = NO;
+    touch.isInteresting--;
+  }
+});

data/lib/frameworks/sproutcore/frameworks/foundation/system/image_queue.js

@@ -0,0 +1,433 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+SC.IMAGE_ABORTED_ERROR = SC.$error("SC.Image.AbortedError", "Image", -100) ;
+
+SC.IMAGE_FAILED_ERROR = SC.$error("SC.Image.FailedError", "Image", -101) ;
+
+/**
+  @class
+  
+  The image queue can be used to control the order of loading images.
+  
+  Images queues are necessary because browsers impose strict limits on the 
+  number of concurrent connections that can be open at any one time to any one 
+  host. By controlling the order and timing of your loads using this image 
+  queue, you can improve the percieved performance of your application by 
+  ensuring the images you need most load first.
+  
+  Note that if you use the SC.ImageView class, it will use this image queue 
+  for you automatically.
+  
+  h1. Loading Images
+  
+  When you need to display an image, simply call the loadImage() method with 
+  the URL of the image, along with a target/method callback. The signature of 
+  your callback should be:
+  
+  {{{
+    imageDidLoad: function(imageUrl, imageOrError) {
+      //...
+    }
+  }}}
+
+  The "imageOrError" parameter will contain either an image object or an error 
+  object if the image could not be loaded for some reason.  If you receive an 
+  error object, it will be one of SC.IMAGE_ABORTED_ERROR or 
+  SC.IMAGE_FAILED_ERROR.
+  
+  You can also optionally specify that the image should be loaded in the 
+  background.  Background images are loaded with a lower priority than 
+  foreground images.
+  
+  h1. Aborting Image Loads
+  
+  If you request an image load but then no longer require the image for some 
+  reason, you should notify the imageQueue by calling the releaseImage() 
+  method.  Pass the URL, target and method that you included in your original 
+  loadImage() request.  
+  
+  If you have requested an image before, you should always call releaseImage() 
+  when you are finished with it, even if the image has already loaded.  This 
+  will allow the imageQueue to properly manage its own internal resources.
+  
+  This method may remove the image from the queue of images that need or load 
+  or it may abort an image load in progress to make room for other images.  If 
+  the image is already loaded, this method will have no effect.
+  
+  h1. Reloading an Image
+  
+  If you have already loaded an image, the imageQueue will avoid loading the 
+  image again.  However, if you need to force the imageQueue to reload the 
+  image for some reason, you can do so by calling reloadImage(), passing the 
+  URL.
+  
+  This will cause the image queue to attempt to load the image again the next 
+  time you call loadImage on it.
+  
+  @extends SC.Object
+  @since SproutCore 1.0
+*/
+SC.imageQueue = SC.Object.create(/** @scope SC.imageQueue.prototype */ {
+
+  /**
+    The maximum number of images that can load from a single hostname at any
+    one time.  For most browsers 4 is a reasonable number, though you may 
+    tweak this on a browser-by-browser basis.
+  */
+  loadLimit: 4,
+  
+  /**
+    The number of currently active requests on the queue. 
+  */
+  activeRequests: 0,
+  
+  /**
+    Loads an image from the server, calling your target/method when complete.
+    
+    You should always pass at least a URL and optionally a target/method.  If 
+    you do not pass the target/method, the image will be loaded in background 
+    priority.  Usually, however, you will want to pass a callback to be 
+    notified when the image has loaded.  Your callback should have a signature 
+    like:
+
+    {{{
+      imageDidLoad: function(imageUrl, imageOrError) { .. }
+    }}}
+    
+    If you do pass a target/method you can optionally also choose to load the 
+    image either in the foreground or in the background.  The imageQueue 
+    prioritizes foreground images over background images.  This does not impact 
+    how many images load at one time.
+    
+    @param {String} url
+    @param {Object} target
+    @param {String|Function} method
+    @param {Boolean} isBackgroundFlag
+    @returns {SC.imageQueue} receiver
+  */
+  loadImage: function(url, target, method, isBackgroundFlag) {
+    // normalize params
+    var type = SC.typeOf(target);
+    if (SC.none(method) && SC.typeOf(target)===SC.T_FUNCTION) {
+      target = null; method = target ;
+    }
+    if (SC.typeOf(method) === SC.T_STRING) {
+      method = target[method];      
+    }
+    // if no callback is passed, assume background image.  otherwise, assume
+    // foreground image.
+    if (SC.none(isBackgroundFlag)) {
+      isBackgroundFlag = SC.none(target) && SC.none(method);
+    }
+    
+    // get image entry in queue.  If entry is loaded, just invoke callback
+    // and quit.
+    var entry = this._imageEntryFor(url) ;
+    if (entry.status === this.IMAGE_LOADED) {
+      if (method) method.call(target || entry.image, entry.url, entry.image);
+      
+    // otherwise, add to list of callbacks and queue image.
+    } else {
+      if (target || method) this._addCallback(entry, target, method);
+      entry.retainCount++; // increment retain count, regardless of callback
+      this._scheduleImageEntry(entry, isBackgroundFlag);
+    }
+  },
+  
+  /**
+    Invoke this method when you are finished with an image URL.  If you 
+    passed a target/method, you should also pass it here to remove it from
+    the list of callbacks.
+    
+    @param {String} url
+    @param {Object} target
+    @param {String|Function} method
+    @returns {SC.imageQueue} receiver
+  */
+  releaseImage: function(url, target, method) {
+    // get entry.  if there is no entry, just return as there is nothing to 
+    // do.
+    var entry = this._imageEntryFor(url, NO) ;
+    if (!entry) return this ;
+    
+    // there is an entry, decrement the retain count.  If <=0, delete!
+    if (--entry.retainCount <= 0) {
+      this._deleteEntry(entry); 
+    
+    // if >0, just remove target/method if passed
+    } else if (target || method) {
+      // normalize
+      var type = SC.typeOf(target);
+      if (SC.none(method) && SC.typeOf(target)===SC.T_FUNCTION) {
+        target = null; method = target ;
+      }
+      if (SC.typeOf(method) === SC.T_STRING) {
+        method = target[method];      
+      }
+
+      // and remove
+      this._removeCallback(entry, target, method) ;
+    }
+  },
+
+  /** 
+    Forces the image to reload the next time you try to load it.
+  */
+  reloadImage: function(url) {
+    var entry = this._imageEntryFor(url, NO); 
+    if (entry && entry.status===this.IMAGE_LOADED) {
+      entry.status = this.IMAGE_WAITING;
+    }
+  },
+  
+  /**
+    Initiates a load of the next image in the image queue.  Normally you will
+    not need to call this method yourself as it will be initiated 
+    automatically when the queue becomes active.
+  */
+  loadNextImage: function() {
+    var entry = null, queue;
+
+    // only run if we don't have too many active request...
+    if (this.get('activeRequests')>=this.get('loadLimit')) return; 
+    
+    // first look in foreground queue
+    queue = this._foregroundQueue ;
+    while(queue.length>0 && !entry) entry = queue.shift();
+    
+    // then look in background queue
+    if (!entry) {
+      queue = this._backgroundQueue ;
+      while(queue.length>0 && !entry) entry = queue.shift();
+    }
+    this.set('isLoading', !!entry); // update isLoading...
+    
+    // if we have an entry, then initiate an image load with the proper 
+    // callbacks.
+    if (entry) {
+      // var img = (entry.image = new Image()) ;
+      var img = entry.image ;
+      if(!img) return;
+
+      // Using bind here instead of setting onabort/onerror/onload directly
+      // fixes an issue with images having 0 width and height
+      $(img).bind('abort', this._imageDidAbort);
+      $(img).bind('error', this._imageDidError);
+      $(img).bind('load', this._imageDidLoad);
+      img.src = entry.url ;
+      
+      // add to loading queue.
+      this._loading.push(entry) ;
+    
+      // increment active requests and start next request until queue is empty
+      // or until load limit is reached.
+      this.incrementProperty('activeRequests');
+      this.loadNextImage();
+    } 
+  },
+  
+  // ..........................................................
+  // SUPPORT METHODS
+  // 
+
+  /** @private Find or create an entry for the URL. */
+  _imageEntryFor: function(url, createIfNeeded) {
+    if (createIfNeeded === undefined) createIfNeeded = YES;
+    var entry = this._images[url] ;
+    if (!entry && createIfNeeded) {
+      var img = new Image() ;
+      entry = this._images[url] = { 
+        url: url, status: this.IMAGE_WAITING, callbacks: [], retainCount: 0, image: img
+      };
+      img.entry = entry ; // provide a link back to the image
+    }
+    return entry ;
+  },
+  
+  /** @private deletes an entry from the image queue, descheduling also */
+  _deleteEntry: function(entry) {
+    this._unscheduleImageEntry(entry) ;
+    delete this._images[entry.url];    
+  },
+  
+  /** @private 
+    Add a callback to the image entry.  First search the callbacks to make
+    sure this is only added once.
+  */
+  _addCallback: function(entry, target, method) {
+    var callbacks = entry.callbacks;
+
+    // try to find in existing array
+    var handler = callbacks.find(function(x) {
+      return x[0]===target && x[1]===method;
+    }, this);
+    
+    // not found, add...
+    if (!handler) callbacks.push([target, method]);
+    callbacks = null; // avoid memory leaks
+    return this ;
+  },
+  
+  /** @private
+    Removes a callback from the image entry.  Removing a callback just nulls
+    out that position in the array.  It will be skipped when executing.
+  */
+  _removeCallback: function(entry, target, method) {
+    var callbacks = entry.callbacks ;
+    callbacks.forEach(function(x, idx) {
+      if (x[0]===target && x[1]===method) callbacks[idx] = null;
+    }, this);
+    callbacks = null; // avoid memory leaks
+    return this ;
+  },
+  
+  /** @private 
+    Adds an entry to the foreground or background queue to load.  If the 
+    loader is not already running, start it as well.  If the entry is in the
+    queue, but it is in the background queue, possibly move it to the
+    foreground queue.
+  */
+  _scheduleImageEntry: function(entry, isBackgroundFlag) {
+
+    var background = this._backgroundQueue ;
+    var foreground = this._foregroundQueue ;
+    
+    // if entry is loaded, nothing to do...
+    if (entry.status === this.IMAGE_LOADED) return this;
+
+    // if image is already in background queue, but now needs to be
+    // foreground, simply remove from background queue....
+    if ((entry.status===this.IMAGE_QUEUED) && !isBackgroundFlag && entry.isBackground) {
+      background[background.indexOf(entry)] = null ;
+      entry.status = this.IMAGE_WAITING ;
+    }
+    
+    // if image is not in queue already, add to queue.
+    if (entry.status!==this.IMAGE_QUEUED) {
+      var queue = (isBackgroundFlag) ? background : foreground ;
+      queue.push(entry);
+      entry.status = this.IMAGE_QUEUED ;
+      entry.isBackground = isBackgroundFlag ;
+    }
+    
+    // if the image loader is not already running, start it...
+    if (!this.isLoading) this.invokeLater(this.loadNextImage, 100);
+    this.set('isLoading', YES);
+    
+    return this ; // done!
+  },
+  
+  /** @private
+    Removes an entry from the foreground or background queue.  
+  */
+  _unscheduleImageEntry: function(entry) {
+    // if entry is not queued, do nothing
+    if (entry.status !== this.IMAGE_QUEUED) return this ;
+    
+    var queue = entry.isBackground ? this._backgroundQueue : this._foregroundQueue ;
+    queue[queue.indexOf(entry)] = null; 
+    
+    // if entry is loading, abort it also.  Call local abort method in-case
+    // browser decides not to follow up.
+    if (this._loading.indexOf(entry) >= 0) {
+      // In some cases queue.image is undefined. Is it ever defined?
+      if (queue.image) queue.image.abort();
+      this.imageStatusDidChange(entry, this.ABORTED);
+    }
+    
+    return this ;
+  },
+  
+  /** @private invoked by Image().  Note that this is the image instance */
+  _imageDidAbort: function() {
+    SC.run(function() {
+      SC.imageQueue.imageStatusDidChange(this.entry, SC.imageQueue.ABORTED);
+    }, this);
+  },
+  
+  _imageDidError: function() {
+    SC.run(function() {
+      SC.imageQueue.imageStatusDidChange(this.entry, SC.imageQueue.ERROR);
+    }, this);
+  },
+  
+  _imageDidLoad: function() {
+    SC.run(function() {
+      SC.imageQueue.imageStatusDidChange(this.entry, SC.imageQueue.LOADED);
+    }, this);
+  },
+
+  /** @private called whenever the image loading status changes.  Notifies
+    items in the queue and then cleans up the entry.
+  */
+  imageStatusDidChange: function(entry, status) {
+    if (!entry) return; // nothing to do...
+    
+    var url = entry.url ;
+    
+    // notify handlers.
+    var value ;
+    switch(status) {
+      case this.LOADED:
+        value = entry.image;
+        break;
+      case this.ABORTED:
+        value = SC.IMAGE_ABORTED_ERROR;
+        break;
+      case this.ERROR:
+        value = SC.IMAGE_FAILED_ERROR ;
+        break;
+      default:
+        value = SC.IMAGE_FAILED_ERROR ;
+        break;
+    }
+    entry.callbacks.forEach(function(x){
+      var target = x[0], method = x[1];
+      method.call(target, url, value);
+    },this);
+    
+    // now clear callbacks so they aren't called again.
+    entry.callbacks = [];
+    
+    // finally, if the image loaded OK, then set the status.  Otherwise
+    // set it to waiting so that further attempts will load again
+    entry.status = (status === this.LOADED) ? this.IMAGE_LOADED : this.IMAGE_WAITING ;
+    
+    // now cleanup image...
+    var image = entry.image ;
+    if (image) {
+      image.onload = image.onerror = image.onabort = null ; // no more notices
+      if (status !== this.LOADED) entry.image = null;
+    }
+
+    // remove from loading queue and periodically compact
+    this._loading[this._loading.indexOf(entry)]=null;
+    if (this._loading.length > this.loadLimit*2) {
+      this._loading = this._loading.compact();
+    }
+    
+    this.decrementProperty('activeRequests');
+    this.loadNextImage() ;
+  },
+  
+  init: function() {
+    sc_super();
+    this._images = {};
+    this._loading = [] ;
+    this._foregroundQueue = [];
+    this._backgroundQueue = [];
+  },
+  
+  IMAGE_LOADED: "loaded",
+  IMAGE_QUEUED: "queued",
+  IMAGE_WAITING: "waiting",
+  
+  ABORTED: 'aborted',
+  ERROR: 'error',
+  LOADED: 'loaded'
+});