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

@@ -0,0 +1,43 @@
+//
+// $Id: Mirage.java,v 1.1 2003/01/13 22:49:46 mdb Exp $
+
+package com.threerings.media.image;
+
+import java.awt.Graphics2D;
+import java.awt.image.BufferedImage;
+
+/**
+ * Provides an interface via which images can be accessed in a way that
+ * allows them to optionally be located in video memory where that affords
+ * performance improvements.
+ */
+public interface Mirage
+{
+    /**
+     * Renders this mirage at the specified position in the supplied
+     * graphics context.
+     */
+    public void paint (Graphics2D gfx, int x, int y);
+
+    /**
+     * Returns the width of this mirage.
+     */
+    public int getWidth ();
+
+    /**
+     * Returns the height of this mirage.
+     */
+    public int getHeight ();
+
+    /**
+     * Returns true if this mirage contains a non-transparent pixel at the
+     * specified coordinate.
+     */
+    public boolean hitTest (int x, int y);
+
+    /**
+     * Returns a snapshot of this mirage as a buffered image. The snapshot
+     * should <em>not</em> be modified by the caller.
+     */
+    public BufferedImage getSnapshot ();
+}