Major media subsystem revamp:

- All images are loaded through the image manager
- Architected to allow the use of prepared or unprepared images (and
  volatile images when the day comes that they support alpha)
- Tunable caches for images and tiles
- Resource manager caches unpacked resources on the filesystem
- Various and sundry other cleanups


git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@2116 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/java/com/threerings/media/image/BackedVolatileMirage.java

@@ -0,0 +1,58 @@
+//
+// $Id: BackedVolatileMirage.java,v 1.1 2003/01/13 22:49:46 mdb Exp $
+
+package com.threerings.media.image;
+
+import java.awt.Graphics;
+import java.awt.Rectangle;
+import java.awt.image.BufferedImage;
+
+import com.threerings.media.Log;
+
+/**
+ * Provides a volatile mirage that is backed by a buffered image that is
+ * not obtained from the image manager but is instead provided at
+ * construct time and completely circumvents the image manager's cache. As
+ * such, this should not be used unless you know what you're doing.
+ */
+public class BackedVolatileMirage extends VolatileMirage
+{
+    /**
+     * Creates a mirage with the supplied regeneration informoation and
+     * prepared image.
+     */
+    public BackedVolatileMirage (ImageManager imgr, BufferedImage source)
+    {
+        super(imgr, new Rectangle(0, 0, source.getWidth(), source.getHeight()));
+        _source = source;
+
+        // create our volatile image for the first time
+        createVolatileImage();
+    }
+
+    // documentation inherited
+    protected void refreshVolatileImage ()
+    {
+        Graphics gfx = null;
+        try {
+            gfx = _image.getGraphics();
+            gfx.drawImage(_source, -_bounds.x, -_bounds.y, null);
+
+        } catch (Exception e) {
+            Log.warning("Failure refreshing mirage " + this + ".");
+            Log.logStackTrace(e);
+
+        } finally {
+            gfx.dispose();
+        }
+    }
+
+    // documentation inherited
+    protected void toString (StringBuffer buf)
+    {
+        super.toString(buf);
+        buf.append(", src=").append(_source);
+    }
+
+    protected BufferedImage _source;
+}