Slippy Maps with Unity

A slippy map (sometimes also referred to as tiled web map, tile map, or simply interactive map) is a web-based map that can be zoomed in and out seamlessly. The most popular slippy map you might be familiar with is Google Maps, alongside many others like that.

This tutorial will show you how to create your own web-based slippy map with Unity. Such a technique can be used to create interactive maps for your own games, or to better explore complex phenomena such as fractals or even Mathematical functions. For clarity, the actual map will be created with Unity, but it will be served using a JavaScript library called LeafletJS. A link to download the full Unity package is also available at the end of the article.

The image used in the cover has been generated using Stamen.

Continue reading

Make Your Own Emoji Portrait

Emoji Portraits

This form allows to  create your very own emoji portrait from any picture. Use the sliders to customise the size and angle of the emojis. When you’re happy, right click on the image to save it.

The rest of this article explains how to replicate this effect using JavaScript.

How it’s done…

The inspiration from this tutorial comes from Yung Jake’s emoji portraits, cleverly crafter using a website called


The technique used in this tutorial is based on a more automatic approach. Emojifying a picture means replacing some of its pixels with emojis that have a similar colour. The steps requires are:

  1. Calculating the average colour of a block of pixels,
  2. Finding the closely matching emoji
  3. Drawing the selected emoji on top of the block

This is the bare minimum requires to create an emoji mosaic. The first step is achieved by resizing the original image to a smaller size. This scaling operation automatically merges colours together, so that one pixel of the thumbnail will correspond to one emoji. It’s fast and reliable, but creates very regular mosaics. To compensate for this, emojis are slightly rotated and moved around. You can see the difference this makes in the comparison box below.

The most expensive part of this technique is checking each pixels against every emoji. To speed up the emojification process, the average colour of each emoji is calculated and stored into a JSON file for fast retrieving.

The next pages of this tutorial will show how this has been done in JavaScript. This very technique can also be used to create emoji animations.

Star Wars: The Force Awakens

Extracting emojis

Reading the pixels of an image is possible using getImageData. This method is available only on a canvas, so it is necessary to draw the emoji map onto a canvas. The code below shows how this technique works.

var image = new Image();
image.src = 'emoji.png';
(	'load',
		// Creates a canvas
		var canvas = document.createElement('canvas');
		canvas.width = image.width;
		canvas.height = image.height;

		// Draws the image into the canvas
		var ctx = canvas.getContext('2d');

		// Gets the pixels
		var imageData = ctx.getImageData(0,0,canvas.width,canvas.height);

An image is loaded asynchronously; its load handler creates a hidden canvas, draws the image onto it and gets its data. The structure returned by getImagedata is an array which contains, for each pixel, its R, G, B and A colour components. Pixels can be retrieved using their position within the image:

function getPixel(imageData, x, y)
    var position = ( x + imageData.width * y ) * 4, data =;
    return [ data[ position ], data[ position + 1 ], data[ position + 2 ],  data[ position + 3 ]];

Extracting emojis

The following code loops over all the emojis within the image file and extract them, one by one. As the name suggests, the function averageColour is used to find the average colour of the current emoji. If null, it means the sampled rectangle was empty and it is not added to the list of emojis.

// Loops over all the emojis
var emojis = [];
for (var x = 0; x < image.width; x += size)
for (var y = 0; y < image.height; y += size)
	var emojiData = ctx.getImageData(x,y,size,size);
	var colour = averageColour(emojiData);
	if (colour != null)
		emojis.push(	{'xe':x,'ye':y,'colour':colour}	);

Averaging colours

Now that the pixels are available, we need to calculate their average colour. The following code calculates the average colour of an image, by independently averaging the R, G and B components of each pixel. Fully transparent pixels are discarded.

function averageColour (imageData)
	// Average colour
	var rgb = [ 0, 0, 0 ];
	var count = 0;
	for (var x = 0; x < image.width; x ++)
	for (var y = 0; y < image.height; y ++)
		var rgba = getPixel(imageData, x, y);
		var alpha = rgba[3] / 255.;
		if (alpha != 1)

		rgb[0] += rgba[0] * alpha;
		rgb[1] += rgba[1] * alpha;
		rgb[2] += rgba[2] * alpha;

		count ++;

	// All empty
	if (count == 0)
		return null;

	// Final colour
	rgb[0] = Math.round(rgb[0]/count);
	rgb[1] = Math.round(rgb[1]/count);
	rgb[2] = Math.round(rgb[2]/count);

	return rgbToHsl(rgb[0], rgb[1], rgb[2]);

The result of averageColour is represented in the HSL colour space. This function by Garry Tan has been used for the conversion, with some minor changes. Both RGB and HSL components are in the [0-255] range.

function rgbToHsl(r, g, b){
    r /= 255, g /= 255, b /= 255;
    var max = Math.max(r, g, b), min = Math.min(r, g, b);
    var h, s, l = (max + min) / 2;

    if(max == min){
        h = s = 0; // achromatic
        var d = max - min;
        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
            case r: h = (g - b) / d + (g < b ? 6 : 0); break;
            case g: h = (b - r) / d + 2; break;
            case b: h = (r - g) / d + 4; break;
        h /= 6;

    return [Math.round(h * 255), Math.round(s * 255), Math.round(l * 255)];

The distance between two colours is calculated using the euclidean distance between their HSL components.

function distance(a, b)
	var xd = a[0] - b[0];
	var yd = a[1] - b[1];
	var zd = a[2] - b[2];
	return Math.sqrt(xd*xd + yd*yd + zd*zd);

Comparing colours in the HSL space clusters them in a more natural way, as described in The Incredibly Challenging Task of Sorting Colours.

Image processing

To get better results, the original image is scaled down. This automatically smooths pixels together.

// The thumbnail canvas
var thumbnail = document.createElement('canvas');
thumbnail.width = image.width / emojiSize;
thumbnail.height = image.height / emojiSize;

// Get a scaled down version of the image
var tmb = thumbnail.getContext('2d');
var thumbData = tmb.getImageData(0,0,thumbnail.width,thumbnail.height);

Each pixel in the thumbnail version of the original image will be replace with the emoji with the closest colour.

// Loops over all the pixels of the thumbnail
for (var xi = 0; xi < thumbData.width; xi ++)
for (var yi = 0; yi < thumbData.height; yi ++)
	var rgb = getPixel(thumbData, xi, yi);
	var emoji = findClosestEmoji(rgb, emojis);

	// Position of the pixel (xi,yi) in the main canvas
	x = xi * emojiSize * offset;
	y = yi * emojiSize * offset;

	// Position of the closest emoji in the emojiMap
	(	emojiMap, emoji.xe,, emojiSizeMap, emojiSizeMap,
		x, y, emojiSize, emojiSize

The closest emoji is found by looping over the previously generated array.

function findClosestEmoji (rgb, emojis)
	var min_d = 10000;
	var min_i = 0;

	var hsl = rgbToHsl(rgb[0], rgb[1], rgb[2]);

	// Loops over all the emojis
	for (var i in emojis)
		var d = distance(hsl, emojis[i].colour);
		if (d < min_d)
			min_d = d;
			min_i = i;

	return emojis[min_i];