v0.99m.1

(1) Add tools that extract game levels from APPLE-II Lode Runner disk
    Add folder : tools

(2) Remove unused data from file: lodeRunner.wData.js

tools/LodeRunnerDiskParser.cpp

@@ -0,0 +1,178 @@
+/**********************************************************************************
+Read Lode Runner APPLE-II DISK IMAGE to extract all levels
+
+Each level is a 28x16 tiles, Lode Runner has 8 different tile types. 
+Two additional tiles are used to represent the player and guard start positions.
+(reference : http://baetzler.de/c64/games/loderunner/)
+
+APPLE-II DISK data format:
+
+Since there are less than 16 different tiles, it is both convenient and 
+efficient to store tiles as nibbles instead of bytes. 
+Thus the 448 tiles of a Lode Runner level can be represented in 224 (0xE0) bytes
+
+The tile data for each level use 256 bytes (0x00 ~ 0xFF), 
+level data starts at offset 0x00 to 0xDF, and reserved 0x20 bytes.
+(0x00 ~ 0xDF + 0x20 = 0x100 (256) bytes) 
+
+The tiles are stored in left-to-right, to-to-bottom order, 
+with a small twist: the low nibble of each byte encodes the left tile 
+and the high nibble encodes the right tile in each byte of data. 
+
+level start from disk offset 0x3000,
+
+Lode Runner Level value to map (10 different types):
+
+value | Character | Type
+------+-----------+-----------
+  0x0 |  <space>  | Empty space
+  0x1 |     #     | Normal Brick
+  0x2 |     @     | Solid Brick
+  0x3 |     H     | Ladder
+  0x4 |     -     | Hand-to-hand bar (Line of rope)
+  0x5 |     X     | False brick
+  0x6 |     S     | Ladder appears at end of level
+  0x7 |     $     | Gold chest
+  0x8 |     0     | Guard
+  0x9 |     &     | Player	
+
+
+**********************************************************************************/
+
+#include <stdio.h>
+
+#define MAX_TILE_TYPE (sizeof(tileType)/sizeof(char))
+#define MAX_LEVEL_ROW (16)
+#define MAX_LEVEL_COL (28)
+
+#define READ_LEVEL_DATA_SIZE (256)
+#define ONE_LEVEL_DATA_SIZE (224)
+
+#if 1
+
+#define FILE_NAME "Lode_Runner_Apple-II.dsk"
+#define MAX_LEVEL (150)
+#define TITLE_NAME "Lode Runner (Apple-II 1983)"
+#define DATA_VAR_NAME "baseLevelData"
+
+#else
+
+#define FILE_NAME "Lode_Runner_Championship _Apple-II.dsk"
+#define MAX_LEVEL (50)
+#define TITLE_NAME "Championship Lode Runner (Apple-II 1984)"
+#define DATA_VAR_NAME "champLevelData"
+
+#endif
+
+char tileType[] = {
+	' ', //0x00: Empty space
+	'#', //0x01:Normal Brick
+	'@', //0x02:Solid Brick
+	'H', //0x03:Ladder
+	'-', //0x04:Hand-to-hand bar (Line of rope)
+	'X', //0x05:False brick
+	'S', //0x06:Ladder appears at end of level
+	'$', //0x07:Gold chest
+	'0', //0x08:Guard
+	'&'  //0x09:Player	
+};
+
+
+int goodLevel(unsigned char *levelData)
+{
+	int i;
+	unsigned char leftTile, rightTile;
+		
+	for(i = 0; i < ONE_LEVEL_DATA_SIZE; i++) {
+		leftTile = levelData[i] & 0xF;
+		rightTile = levelData[i] >> 0x04;
+		if(leftTile >= MAX_TILE_TYPE || rightTile >= MAX_TILE_TYPE) {
+						return 0;
+		}
+	}
+	return 1; //OK
+}
+
+void dumpTitle(void)
+{
+	printf("//************************************************************\n");
+	printf("//* All levels extract from: \n");
+	printf("//* %s DISK IMAGE\n",TITLE_NAME );
+	printf("//* by Simon Hung 2014/02/20\n");
+	printf("//************************************************************\n\n");
+}
+
+void dumpLevel(int level, unsigned char *levelData)
+{
+	int row, col;
+	unsigned char leftTile, rightTile;
+	int offset = 0;
+	
+	printf("======<<< Level %03d >>>======\n\n", level);
+	for(row = 0; row < MAX_LEVEL_ROW; row++){
+		for(col = 0; col < MAX_LEVEL_COL; col+=2){ //one byte contains 2 tile
+			leftTile = levelData[offset] & 0xF;
+			rightTile = levelData[offset] >> 0x04;
+			printf("%c%c",tileType[leftTile],tileType[rightTile]);
+			offset++;			
+		}
+		printf("\n");
+	}
+	printf("\n");
+}
+
+void dumpLevel4JavaScript(int level, unsigned char *levelData)
+{
+	int row, col;
+	unsigned char leftTile, rightTile;
+	int offset = 0;
+	
+	printf("//======<<< Level %03d >>>======\n\n", level);
+	for(row = 0; row < MAX_LEVEL_ROW; row++){
+		printf("\"");
+		for(col = 0; col < MAX_LEVEL_COL; col+=2){ //one byte contains 2 tile
+			leftTile = levelData[offset] & 0xF;
+			rightTile = levelData[offset] >> 0x04;
+			printf("%c%c",tileType[leftTile],tileType[rightTile]);
+			offset++;			
+		}
+		if(row < MAX_LEVEL_ROW-1)printf("\" +\n");
+		else if (level < MAX_LEVEL)printf("\",\n");
+		     else printf("\"\n");
+	}
+	printf("\n");
+}
+
+
+
+int main(void)
+{
+	FILE *fp;
+	unsigned char levelData[READ_LEVEL_DATA_SIZE];
+	int curLevel = 0;
+	
+	if((fp = fopen(FILE_NAME, "r")) ==NULL) {
+		printf("Open file %d failed !\n", FILE_NAME);
+		return 1;
+	}
+	
+	if(fseek(fp, 0x3000L, SEEK_SET) != 0) {
+		printf("Fseek error ! @%d\n", __LINE__);
+		fclose(fp);
+		return 1;
+	}
+
+	dumpTitle();
+
+	printf("var %s = [\n", DATA_VAR_NAME);	
+	while(curLevel < MAX_LEVEL && 
+	      fread(levelData, sizeof(char), READ_LEVEL_DATA_SIZE, fp) ==  READ_LEVEL_DATA_SIZE &&
+	      goodLevel(levelData)
+	){
+		//dumpLevel(++curLevel, levelData);
+		dumpLevel4JavaScript(++curLevel, levelData);
+	}
+	printf("];\n");
+	
+	fclose(fp);	
+}