- initial import

Author: m0r13

.gitignore

@@ -0,0 +1,6 @@
+.cproject
+.project
+.settings
+
+*.o
+gmon.out

COPYING

@@ -0,0 +1,108 @@
+# mapcrafter #
+
+mapcrafter is a fast minecraft world renderer written in C++. It renders minecraft
+worlds to a bunch of images which are viewable in any webbrowser using the Google Maps API.
+
+mapcrafter runs on linux (maybe also Mac OS or w****** with cygwin) and needs libpng, 
+libpthread, libboost-iostreams,libboost-system, libboost-filesystem, and 
+libboost-program-options (and libboost-test if you want to use the tests). 
+You can build it with g++ and the supplied makefile.
+
+mapcrafter is not yet finished. At the moment not all blocks are supported, but the
+basic rendering routines (also incremental rendering, multithreading) are implemented.
+The renderer works with the 'new' minecraft anvil worlds.
+
+mapcrafter is free software and available under the GPL license.
+You can access the latest source of mapcrafter at: http://github.com/...
+
+Please feel free to report bugs and errors you find when using mapcrafter.
+
+Thanks to pigmap and Minecraft Overviewer, whose documentations and source code were 
+very helpful.
+
+## How to use the renderer ##
+
+Here is a list of available command line options:
+
+-h [--help]
+
+This shows a help about the command line options.
+
+-i [--input-dir=] (directory)
+
+This is the directory of the minecraft world to render. The directory should contain a 
+directory 'region' with the *.mca region files.
+
+
+-o [--output-dir=] (directory)
+
+This is the directory, where mapcrafter saves the rendered map. Every time you render your
+map, the renderer copies the template files into this directory and overwrites them, if 
+they already exist. The renderer creates an 'index.html' file you can open with your 
+webbrowser. If you want to customize this html file, you should do this directly in the 
+template (see data dir).
+
+-d [--data-dir=] (directory)
+
+This is the directory with a template directory and the minecraft images needed for the 
+rendering. 
+
+You need here the terrain.png, chest.png, enderchest.png and largechest.png (probably 
+from your minecraft.jar). You can use the python script in the data directory to extract 
+the images from your minecraft.jar. 
+
+The web templates are stored inside the data directory in the directory 'template'. You 
+can make a copy of the data directory and customize the templates.
+
+-j [--jobs=] (number)
+
+This is the count of threads to use (default 1), when rendering the highest zoom level 
+tiles (the tiles which are directly rendered from the world data). The rendering 
+performance also depends heavily on your disk. You can render the map to a solid state 
+disk or a ramdisk to improve the performance. 
+
+At the moment the other tiles (composite tiles), which are composed of the top level 
+tiles and other composite tiles, are rendered by a single thread.
+
+-u [--incremental]
+
+When you specify this, the renderer checks, which chunks were changed since the last 
+rendering of the world. It calculates then the tiles, which need to get rendered. You can 
+use this, if you already rendered your map completely. Incremental rendering is much 
+faster than a full rendering, if there are only a few changes in your minecraft world.
+
+
+
+**Here are some settings you can only specifiy, if you do a full rendering. In case of 
+incremental rendering, the renderer reads this settings from the file 'map.settings' in 
+the output directory.**
+
+
+--texture-size=(a number)
+
+This is the size (in pixels) of the block textures. The default texture 
+size is 12px (16px is the size of the default minecraft textures). The size (width and 
+height) of your terrain.png must be a multiple of 16 and width and height must be equal.
+
+The size of a tile is 32*texturesize, so the higher the texture size, the more image data 
+the renderer has to process. If you want a high detail, use texture size 16, but texture
+size 12 looks still good and is faster to render.
+
+--render-unknown-blocks
+
+With this setting the renderer renders unknown blocks as red blocks (for debugging 
+purposes). Per default the renderer just ignores unknown blocks and doesn't render them.
+
+--render-leaves-transparent
+
+You can specifiy this to use the transparent leaves textures instead of the opaque
+textures. This option can make the renderer a bit slower, because the renderer has to scan
+the blocks after the leaves to the ground also.
+
+## Version history ##
+
+**v.0.1 (December 2012)**
+
+* first version on github, features:
+* rendering minecraft worlds to tiles and an html file to view them like a Google Map
+* incremental rendering, multithreading

README

@@ -0,0 +1,15 @@
+Important things:
+	- add all blocks
+	- better documentation
+	
+Blocks:
+#	- a lot of blocks (grass, torches, transparent leaves,...) have some transparency on 
+#	  their edges after resizing, could be a performance problem
+#	  - maybe use simple nearest neighbor resizing for transparent blocks
+	- fix east ascending stairs texture bug
+	
+Other things:
+	- performance and ram improvements are always good
+	- composite tile rendering also multithreaded
+	- biome depend grass/leaves/water color?
+	- maybe more rendermodes?

TODO

@@ -0,0 +1,51 @@
+CXX=g++
+CXXFLAGS=-std=c++0x -Werror
+
+ifeq ($(mode),debug)
+	CXXFLAGS+= -g
+else ifeq ($(mode),profile)
+	CXXFLAGS+= -O3
+else
+	CXXFLAGS+= -O3
+endif
+
+LDFLAGS=-lpng -pthread -lboost_iostreams -lboost_system -lboost_filesystem -lboost_program_options
+
+OBJECTS=util.o $(addprefix mc/, cache.o chunk.o nbt.o pos.o region.o world.o) $(addprefix render/, image.o manager.o render.o textures.o tile.o)
+TEST_OBJECTS=$(addprefix test/, test_image.o test_nbt.o test_pos.o test_tile.o)
+
+all: $(OBJECTS) mapcrafter testtextures #test
+clean:
+	rm -rf mapcrafter mapcrafter.o testtextures testtextures.o $(OBJECTS)
+	
+mapcrafter: mapcrafter.o $(OBJECTS)
+	$(CXX) $(CXXFLAGS) -o mapcrafter mapcrafter.o $(OBJECTS) $(LDFLAGS)
+testtextures: testtextures.o $(OBJECTS)
+	$(CXX) $(CXXFLAGS) -o testtextures testtextures.o $(OBJECTS) $(LDFLAGS)
+
+test: test/test_all.cpp $(TEST_OBJECTS) $(OBJECTS)
+	$(CXX) $(CXXFLAGS) -o test/test_all -I. test/test_all.cpp $(TEST_OBJECTS) $(OBJECTS) $(LDFLAGS) -lboost_unit_test_framework
+
+runtest: test
+	cd test && ./test_all --log_level=test_suite
+	
+%.o: %.cpp
+	$(CXX) $(CXXFLAGS) -I. -c $< -o $@
+
+mc/cache.o: mc/cache.cpp mc/pos.h mc/chunk.h mc/region.h mc/world.h
+mc/chunk.o: mc/chunk.cpp mc/nbt.h mc/pos.h
+mc/nbt.o: mc/nbt.cpp
+mc/pos.o: mc/pos.cpp
+mc/region.o: mc/region.cpp mc/pos.h mc/chunk.h
+mc/world.o: mc/world.cpp mc/pos.h mc/chunk.h mc/region.h
+
+render/image.o: render/image.cpp
+render/manager.o: mc/cache.h mc/pos.h mc/chunk.h mc/region.h mc/world.h render/render.h
+render/render.o: render/render.cpp mc/pos.h mc/cache.h render/textures.h render/tile.h
+render/textures.o: render/image.o
+render/tile.o: render/tile.cpp mc/pos.h mc/chunk.h mc/cache.h
+
+test/test_image.o: render/image.h
+test/test_nbt.o: mc/nbt.h
+test/test_pos.o: mc/pos.h
+test/test_tile.o: render/tile.h

src/Makefile

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+
+import sys
+import os
+import zipfile
+
+files = {
+	"terrain.png" : "terrain.png",
+	"chest.png" : "item/chest.png",
+	"enderchest.png" : "item/enderchest.png",
+	"largechest.png" : "item/largechest.png",
+}
+
+if __name__ == "__main__":
+	if len(sys.argv) < 2:
+		print "Usage: ./find_images.py [-f] <minecraft.jar>"
+		sys.exit(1)
+		
+	force = False
+	path = sys.argv[1]
+	if len(sys.argv) >= 3:
+		force = sys.argv[1] == "-f"
+		path = sys.argv[2]
+		
+	jar = zipfile.ZipFile(path)
+	
+	for filename, path in files.items():
+		try:
+			info = jar.getinfo(path)
+			print filename, "found...",
+			if os.path.exists(filename) and not force:
+				print "skipping because it already exists (use -f to force)"
+			else:
+				fin = jar.open(info)
+				fout = open(filename, "w")
+				fout.write(fin.read())
+				fin.close()
+				fout.close()
+				print "ok"
+		except KeyError:
+			print filename, "not found!"
+			continue

src/data/endportal.png

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html>
+	<head>
+		<title>Minecraft Map</title>
+		<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
+		<link rel="stylesheet" type="text/css" href="style.css" />
+		<script type="text/javascript" src="http://maps.google.com/maps/api/js?sensor=false"></script>
+		<script type="text/javascript" src="markers.js"></script>
+		<script type="text/javascript">
+		var MapConfig = {
+			textureSize: {textureSize},
+	   		tileSize: {tileSize},
+	   		
+	   		minZoom: 0,
+	   		defaultZoom: 0,
+	   		maxZoom: {maxZoom}
+	 	};
+		</script>
+		<script type="text/javascript" src="map.js"></script>
+	</head>
+	<body onload="init()">
+		<div id="mcmap"></div>
+	</body>
+</html>

src/data/find_images.py

@@ -0,0 +1,91 @@
+/**
+ * From Minecraft Overviewer.
+ */
+// our custom projection maps Latitude to Y, and Longitude to X as normal,
+// but it maps the range [0.0, 1.0] to [0, tileSize] in both directions
+// so it is easier to position markers, etc. based on their position
+// (find their position in the lowest-zoom image, and divide by tileSize)
+function MapProjection() {
+	this.inverseTileSize = 1.0 / MapConfig.tileSize;
+}
+
+MapProjection.prototype.fromLatLngToPoint = function(latLng) {
+	var x = latLng.lng() * MapConfig.tileSize;
+	var y = latLng.lat() * MapConfig.tileSize;
+	return new google.maps.Point(x, y);
+};
+
+MapProjection.prototype.fromPointToLatLng = function(point) {
+	var lng = point.x * this.inverseTileSize;
+	var lat = point.y * this.inverseTileSize;
+	return new google.maps.LatLng(lat, lng);
+};
+
+function convertMCtoLatLng(x, z, y) {
+	// the size of a 1/4 block image divided by the total size of all render tiles 
+	// on the highest zoom level
+	var block = (MapConfig.textureSize/2.0) / (MapConfig.tileSize * Math.pow(2, MapConfig.maxZoom));
+	
+	// at first calculate the row and the column of the block
+	// column is just x+z 
+	var col = x+z;
+	// row is z-x, and every y to bottom adds 2 rows
+	var row = z-x + (256-y)*2;
+
+	// midpoint of the map is in lat/lng 0.5|0.5
+	// we have to move the lng by the size of one tile
+	// lng is now 2*block size for every column
+	var lng = 0.5 - (1.0 / Math.pow(2, MapConfig.maxZoom + 1)) + col * 2*block;
+	// lat is now one block size for every row 
+	var lat = 0.5 + row * block;
+	
+	return new google.maps.LatLng(lat, lng);
+}
+
+
+var MCMapOptions = {
+	/**
+	 * From Minecraft Overviewer.
+	 */
+	getTileUrl: function(tile, zoom) {
+		var url = ".";
+		if(tile.x < 0 || tile.x >= Math.pow(2, zoom) || tile.y < 0 || tile.y >= Math.pow(2, zoom)) {
+			url += "/blank";
+		} else if(zoom == 0) {
+			url += "/base";
+		} else {
+			for(var z = zoom - 1; z >= 0; --z) {
+				var x = Math.floor(tile.x / Math.pow(2, z)) % 2;
+				var y = Math.floor(tile.y / Math.pow(2, z)) % 2;
+				url += "/" + (x + 2 * y + 1);
+			}
+		}
+		url = url + ".png";
+		return(url);
+	},
+	tileSize: new google.maps.Size(MapConfig.tileSize, MapConfig.tileSize),
+	maxZoom: MapConfig.maxZoom,
+	minZoom: MapConfig.minZoom,
+	isPng: true
+};
+
+function init() {
+	var MCMapType = new google.maps.ImageMapType(MCMapOptions);
+	MCMapType.name = "Minecraft Map";
+	MCMapType.alt = "Minecraft Map";
+	MCMapType.projection = new MapProjection();
+	
+	var mapOptions = {
+		zoom: MapConfig.defaultZoom,
+		center: new google.maps.LatLng(0.5, 0.5),
+		
+		navigationControl: true,
+		scaleControl: false,
+		mapTypeControl: false,
+		streetViewControl: false,
+	};
+	
+	var map = new google.maps.Map(document.getElementById("mcmap"), mapOptions);
+	map.mapTypes.set("mcmap", MCMapType);
+	map.setMapTypeId("mcmap");
+}

src/data/fire.png

@@ -0,0 +1,3 @@
+var MARKERS = [
+	{markers}
+];

src/data/template/index.html

@@ -0,0 +1,16 @@
+html {
+	width: 100%;
+	height: 100%
+}
+
+body {
+	width: 100%;
+	height: 100%;
+	margin: 0;
+	padding: 0;
+}
+
+#mcmap {
+	width: 100%;
+	height: 100%
+}