Behold, Nenya, Ring of Water and repository for our media and animation related

goodies, both Java 2D and LWJGL/JME 3D.


git-svn-id: svn+ssh://src.earth.threerings.net/nenya/trunk@1 ed5b42cb-e716-0410-a449-f6a68f950b19

docs/media/design.txt

@@ -0,0 +1,44 @@
+Media Design Notes -*- mode: outline -*-
+
+* Tile system
+** Classes
+Tile
+TileSet
+
+TileManager
+TileSetRepository
+
+TileSetIDBroker
+
+XMLTileSetParser
+
+TileSetBundle
+BundledTileSetRepository
+TileSetBundler
+
+** Tile management
+Managing tilesets by id involves creating tileset bundles from XML tileset
+descriptions.
+
+Tileset bundles contain both the tileset images and the tileset metadata
+(in the form of serialized tileset classes?)
+
+Tileset bundle creation maintains a stable tileset name to tileset id
+mapping through the use of a TileSetIDBroker which maintains the name to
+id mapping (in a database or however it likes)
+
+Sample tileset XML description (for uniform tiles):
+
+<tileset type="uniform" name="Tileset name">
+  <imagepath>foo/bar/tiles.png</imagepath>
+  <width>64</width>
+  <height>48</height>
+  <tileCount>16</tileCount>
+</tileset>
+
+* 01/07/2003
+** Image management refactor
+x TileSet:ImageProvider needs to provide colorized images
+! Probably give tilesets the ImageManager since they have to give the
+  ImageManager reference to the Tile so that it can lock its colorized
+  source image

docs/media/notes.txt

@@ -0,0 +1,14 @@
+Media Notes -*- mode: outline -*-
+
+* Old notes
+- Possibly modify TileSet to load images via image manager (move image
+  provider up to media so that image manager can use tileset's image
+  provider to load the image data) so that they can be cached (and more
+  importantly, flushed from the cache). Presently tilesets are loaded into
+  memory when tileset bundles are loaded and remain loaded forever.
+
+* 07/19/2002
+** Virtual media panel
+- Make sure doLayout() is getting called soon enough to ensure that we
+  don't improperly scroll the wrong thing if we're hijacked while in the
+  middle of scrolling