The scene id is omitted as the scene id is assigned when the
+ * scene template is actually loaded into a server. Similarly, exit
+ * points are specified by scene name rather than scene id.
*/
public class XMLSceneWriter extends DataWriter
{
@@ -43,27 +50,13 @@ public class XMLSceneWriter extends DataWriter
startElement("scene");
dataElement("name", scene.getName());
- dataElement("sid", "" + scene.getId());
- dataElement("version", "" + Scene.getVersion());
- dataElement("hotspots",
- StringUtil.toString(scene.getHotSpots()));
- dataElement("exits", StringUtil.toString(scene.getExits()));
+ dataElement("version", "" + Scene.VERSION);
+ dataElement("hotspots", getHotSpotData(scene));
+ dataElement("exits", getExitData(scene));
startElement("tiles");
- for (int jj = 0; jj < Scene.getNumLayers(); jj++) {
- AttributesImpl attrs = new AttributesImpl();
- attrs.addAttribute("", "lnum", "", "CDATA", "" + jj);
-
- startElement("", "layer", "", attrs);
- for (int yy = 0; yy < Scene.getTileHeight(); yy++) {
- attrs.clear();
- attrs.addAttribute("", "rownum", "", "CDATA", "" + yy);
-
- startElement("", "row", "", attrs);
- // TODO: write row data.
- endElement("row");
- }
- endElement("layer");
+ for (int lnum = 0; lnum < Scene.NUM_LAYERS; lnum++) {
+ writeLayer(scene, lnum);
}
endElement("tiles");
@@ -76,4 +69,215 @@ public class XMLSceneWriter extends DataWriter
", saxe=" + saxe + "].");
}
}
+
+ /**
+ * Output XML detailing the tiles at the specified layer in the
+ * given scene. The first layer is outputted in its entirety,
+ * whereas subsequent layers are outputted in a sparse notation
+ * that details each contiguous horizontal chunk of tiles in each
+ * row separately.
+ *
+ * @param scene the scene object.
+ * @param lnum the layer number.
+ */
+ protected void writeLayer (Scene scene, int lnum) throws SAXException
+ {
+ AttributesImpl attrs = new AttributesImpl();
+ attrs.addAttribute("", "lnum", "", "CDATA", "" + lnum);
+
+ startElement("", "layer", "", attrs);
+ for (int yy = 0; yy < Scene.TILE_HEIGHT; yy++) {
+ if (lnum == Scene.LAYER_BASE) {
+ writeTileRowData(scene, yy, lnum);
+ } else {
+ writeSparseTileRowData(scene, yy, lnum);
+ }
+ }
+ endElement("layer");
+ }
+
+ /**
+ * Return a string representation of the exit points in the
+ * scene. Each exit point is specified by a comma-delimited
+ * triplet of (x, y, scene name) values.
+ *
+ * @param scene the scene object.
+ *
+ * @return the exit points in String format.
+ */
+ protected String getExitData (Scene scene)
+ {
+ ExitPoint[] exits = scene.getExitPoints();
+
+ Object exitinfo[] = new Object[exits.length * 3];
+ StringBuffer buf = new StringBuffer();
+ for (int ii = 0; ii < exits.length; ii++) {
+ int idx = ii * 3;
+ buf.append(exits[ii].x).append(",");
+ buf.append(exits[ii].y).append(",");
+ buf.append(exits[ii].name);
+ if (ii < exits.length - 1) buf.append(",");
+ }
+
+ return buf.toString();
+ }
+
+ /**
+ * Return a string representation of the hotspot points in the
+ * scene. Each hotspot point is specified by a comma-delimited
+ * tuple of (x, y) values.
+ *
+ * @return the hotspot points in String format.
+ */
+ protected String getHotSpotData (Scene scene)
+ {
+ StringBuffer buf = new StringBuffer();
+
+ Point[] hotspots = scene.getHotSpots();
+ for (int ii = 0; ii < hotspots.length; ii++) {
+ buf.append(hotspots[ii].x).append(",");
+ buf.append(hotspots[ii].y);
+ if (ii < hotspots.length - 1) buf.append(",");
+ }
+
+ return buf.toString();
+ }
+
+ /**
+ * Return a string representation of the tiles at the specified
+ * row and layer in the given scene. Only len tiles
+ * starting at column colstart are included in the
+ * string.
+ *
+ * @param scene the scene object.
+ * @param rownum the row number.
+ * @param lnum the layer number.
+ * @param colstart the first column of data.
+ * @param len the number of columns of data.
+ *
+ * @return the tile data in String format.
+ */
+ protected String getTileData (Scene scene, int rownum, int lnum,
+ int colstart, int len)
+ {
+ StringBuffer buf = new StringBuffer();
+
+ int numtiles = colstart + len;
+ for (int ii = colstart; ii < numtiles; ii++) {
+ Tile tile = scene.tiles[ii][rownum][lnum];
+ if (tile == null) {
+ Log.warning("Null tile [x=" + ii + ", rownum=" + rownum +
+ ", lnum=" + lnum + "].");
+ continue;
+ }
+
+ buf.append(tile.tsid).append(",");
+ buf.append(tile.tid);
+ if (ii != numtiles - 1) buf.append(",");
+ }
+
+ return buf.toString();
+ }
+
+ /**
+ * Write the row data for a specified row in the scene tile array.
+ *
+ *
The row is written as a row element. Each
+ * tile is specified by a comma-delimited tuple of (tile set id,
+ * tile id) numbers, with the associated row number detailed in
+ * the rownum attribute of the row
+ * element.
+ *
+ * @param scene the scene object.
+ * @param rownum the row in the scene tile array.
+ * @param lnum the layer number in the scene tile array.
+ */
+ protected void writeTileRowData (Scene scene, int rownum, int lnum)
+ throws SAXException
+ {
+ // set up the attributes for this row
+ AttributesImpl attrs = new AttributesImpl();
+ attrs.addAttribute("", "rownum", "", "CDATA", "" + rownum);
+
+ // output the full row data element
+ String data = getTileData(scene, rownum, lnum, 0, Scene.TILE_WIDTH);
+ dataElement("", "row", "", attrs, data);
+ }
+
+ /**
+ * Utility routine used by writeSparseTileRowData to
+ * obtain the sets of contiguous tile sets in each row.
+ *
+ *
The search for contiguous tiles starts at the column
+ * specified in Sparse row format is identical to the format detailed in
+ * info[0] Results are returned in the info array as
+ * { colstart, len }. colstart is -1 if no
+ * tiles were found in the rest of the row.
+ *
+ * @param scene the scene object.
+ * @param rownum the row number.
+ * @param lnum the layer number.
+ * @param info the info array.
+ *
+ * @return true if any tiles were found, false if not.
+ */
+ protected boolean
+ getSparseColumn (Scene scene, int rownum, int lnum, int info[])
+ {
+ int start = -1, len = 0;
+ for (int xx = info[0]; xx < Scene.TILE_WIDTH; xx++) {
+ Tile tile = scene.tiles[xx][rownum][lnum];
+ if (tile == null) {
+ if (start == -1) continue;
+ else break;
+ }
+
+ if (start == -1) start = xx;
+ len++;
+ }
+
+ info[0] = start;
+ info[1] = len;
+
+ return (start != -1);
+ }
+
+ /**
+ * Write the row data for a specified row in the scene tile array
+ * in sparse row format.
+ *
+ * writeTileRowData() except that a separate
+ * row element is outputted for each contiguous set
+ * of tiles, with the starting column detailed in the
+ * colstart attribute of the row
+ * element.
+ *
+ * @param scene the scene object.
+ * @param rownum the row in the scene tile array.
+ * @param lnum the layer number in the scene tile array.
+ */
+ protected void
+ writeSparseTileRowData (Scene scene, int rownum, int lnum)
+ throws SAXException
+ {
+ // set up the attributes for this row
+ AttributesImpl attrs = new AttributesImpl();
+ attrs.addAttribute("", "rownum", "", "CDATA", "" + rownum);
+ attrs.addAttribute("", "colstart", "", "CDATA", "0");
+
+ int info[] = new int[] { 0, 0 };
+ while (getSparseColumn(scene, rownum, lnum, info)) {
+ // update the colstart attribute
+ attrs.setAttribute(1, "", "colstart", "", "CDATA", "" + info[0]);
+
+ // output the partial row data element
+ String data = getTileData(scene, rownum, lnum, info[0], info[1]);
+ dataElement("", "row", "", attrs, data);
+
+ // update the colstart value
+ info[0] = info[0] + info[1];
+ }
+ }
}