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/CachedVolatileMirage.java

@@ -0,0 +1,78 @@
+//
+// $Id: CachedVolatileMirage.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;
+import com.samskivert.util.StringUtil;
+
+/**
+ * A mirage implementation which allows the image to be maintained in
+ * video memory and refetched from the image manager in the event that our
+ * target screen resolution changes or we are flushed from video memory
+ * for some other reason.
+ *
+ * <p> These objects are never created directly, but always obtained from
+ * the {@link ImageManager}.
+ */
+public class CachedVolatileMirage extends VolatileMirage
+{
+    /**
+     * Creates a mirage with the supplied regeneration informoation and
+     * prepared image.
+     */
+    protected CachedVolatileMirage (
+        ImageManager imgr, ImageManager.ImageKey source,
+        Rectangle bounds, Colorization[] zations)
+    {
+        super(imgr, bounds);
+
+        _source = source;
+        _zations = zations;
+
+        // create our volatile image for the first time
+        createVolatileImage();
+    }
+
+    /**
+     * Rerenders our volatile image from the its source image data.
+     */
+    protected void refreshVolatileImage ()
+    {
+        Graphics gfx = null;
+        try {
+            BufferedImage source = _imgr.getImage(_source, _zations);
+            gfx = _image.getGraphics();
+            gfx.drawImage(source, -_bounds.x, -_bounds.y, null);
+
+        } catch (Exception e) {
+            Log.warning("Failure refreshing mirage " + this + ".");
+            Log.logStackTrace(e);
+
+        } finally {
+            if (gfx != null) {
+                gfx.dispose();
+            }
+        }
+    }
+
+    // documentation inherited
+    protected void toString (StringBuffer buf)
+    {
+        super.toString(buf);
+        buf.append(", key=").append(_source);
+        buf.append(", zations=").append(_zations);
+    }
+
+    /** The key that identifies the image data used to create our volatile
+     * image. */
+    protected ImageManager.ImageKey _source;
+
+    /** Optional colorizations that are applied to our source image when
+     * creating our mirage. */
+    protected Colorization[] _zations;
+}