Kiandra IT is hiring – looking for devs, UX, BA & system engineers

At Kiandra IT we are currently looking to hire .net devs, UX /designer developers, BA’s and system engineers.

Full job descriptions are available here:

But why would you want to work for Kiandra IT?

Well there are lots of benefits that the above link will tell you about but as a developer here are some of the things I like most about working at Kiandra:

  • Great culture supporting innovation & learning. We have had a lunch time developer book club & a new games programming group is starting up shortly. We run company sponsored hackathons (last topic was big data & before that touch). Melbourne is run in our office and we have a new user group called K-nights with shorter 15 min presentations. Most Fridays we have developer brown bag sessions to share the knowledge
  • We use the best tools – Git Enterprise, Team city, Visual Studio 2013 & Resharper, Selenium and work with the best technologies – AngularJS, MVC, Azure, AWS, NHibernate
  • Colleagues that are passionate about their work – I think most devs at Kiandra have some sort of side project on the go from games development to start up projects to Pluralsight authoring
  • Great working environment setup with a powerful desktop & 3 monitors for those who want them + an ergonomics guy to make sure this is adjusted just right..
  • A range of breakfast is available in the office & there are always snacks & beer/wine available
  • The work is predominantly based in the office unlike many consultancies (although you could have a more client facing role if you wish) & a central CBD location in new offices within easy reach of Southern Cross & Flagstaff stations

What you waiting for – don’t let the fact that you may work with me (or @larsklint for that matter) put you off & head over to and apply now!

Please note at this time Kiandra IT do not sponsor visas.

Developing a WebGL Game – Part 3 (Maps)

For my turn based strategy game I envisaged players moving pieces over a map that would look similar to the Game of thrones intro. Unfortunately this would require awesome 3D modelling & graphics skills that are a little beyond what I currently possess but its something to aim for!

I tried a few different ways to generate a map for my game. Initially I tried using a couple of array’s to define where to create ground and the height the ground should be.

height: [
0, 0, 4, 1, 0, 0, 0, 0, 0, 0,
0, 0, 4, 1, 0, 0, 0, 0, 0, 0

groundType: [
0, 0, 1, 1, 0, 0, 0, 0, 0, 0,
0, 0, 1, 1, 0, 0, 0, 0, 0, 0

I then iterated through the arrays creating blocks dependent on the height & ground type. You need to do this backwards otherwise you get the inverse map relative to the array declaration:

var y = WorldData.initParams.startY,
colPosition = WorldData.initParams.rowSize,
rowPosition = 1;

for (var i = WorldData.initParams.groundType.length - 1; i > -1; i--) {

if (WorldData.initParams.groundType[i] > 0) {

arrayIndex: i,
colPosition: colPosition,
rowPosition: rowPosition,
y: y,
blockHeight: WorldData.initParams.height[i] * WorldData.initParams.blockHeight


//end of row
if (colPosition === 0) {
colPosition = WorldData.initParams.rowSize;

As I create each square of ground I assigned meta data to it to easily identify its location in the environment and type of terrain.

Below is a screenshot of a typical result (the white & red cubes represent creatures):


Although I think this would work OK and allow me to manipulate the environment very easily (e.g. destroy a block of ground) it seemed very inefficient having a lot of cubes for a flat area of ground with surfaces that are never viewed. It also looked a bit Minecraft esq & not in such a good way so I started looking at other options!

Height and texture maps
I came across a cool post by Bjorn Sandvik who utilized realworld GIS data & three.js to produce a height and textured map of parts of Norway. Bjorn did a lot of work manipulating real world data  to produce a detailed texture & height map. This produced an awesome result but I don’t need something quite so complex.

At a high level my plan for creating terrain is:

  • Create a bitmap to represent the games map (this has the added advantage that I dont need to create a level editor)
  • Iterate through the bitmap’s pixels and assign a height value for each color (e.g. grey might represent mountains which are higher than trees)
  • Output a JavaScript array of this data
  • Use the array three.js to manipulate a plane’s vertexes to produce a height effect

Here is my very simple game bitmap enlarged (the original is 20 x 20 pixels):

Terrain PNG

I wrote a small C# program to iterate through the bitmap generate a JavaScript array string (note this is a slow way to do this and there is a faster way using LockBits method):

private string ParseBitmap(Bitmap bmp)
            var sbHeightMap = new StringBuilder();

                for (var y = 0; y < bmp.Height; y++)
                    for (var x = 0; x < bmp.Width; x++)
                        var clr = bmp.GetPixel(x, y);
                        var height = GetHeight(clr);
                        sbHeightMap.Append("," + height);

            sbHeightMap.Remove(0, 1);

            return "[" + sbHeightMap + "]";

I can then take the generated array and use it to manipulate a plane and then map the terrain image on top of it:

function loadNewTerrain() {

var geometry = new THREE.PlaneGeometry(WorldData.boardScreenWidth, WorldData.boardScreenWidth, WorldData.boardCells - 1, WorldData.boardCells - 1);

for (var i = 0, l = geometry.vertices.length-2; i++) {
geometry.vertices[i].z = WorldData.heightData[i];

var plane = new THREE.Mesh(geometry, WorldData.terrainTexture);

plane.material.side = THREE.DoubleSide;
plane.rotation.x = GameMath.de2ra(-90);
Game.newTerrain = plane;

Game.addObjectToScene(plane, 'ground');

This simple approach gives quite a pleasing affect with even a very simple image:


I tried this approach with a more complex 800×800 satellite photograph. The color to height mappings are not setup but it still produced a reasonable effect that shows the promise of this technique with a more detailed texture:


One issue this experiment brought up is how quickly game assets can get quite large – for example the height map of the above image is nearly 2mb and that I will need a good way of loading them hmm…

Developing a WebGL Game – Part 2 (keeping JavaScript organized)

JavaScript has a tendency to get messy pretty quickly (and I’m pretty sure this isn’t just when I am writing it!).

This is due in my opinion to a number of factors:

  • People don’t understand the language and which can mean they get caught by a few traps (e.g. clobbering global scope)
  • Dev’s are unaware of some of the facilities available to them to write cleaner code (e.g. functional scope which I guess can also trip a few people up)
  • There is currently no inbuilt support for classes, modules/namespaces or script loaders. Of course there are a number of third party libraries to assist with this & some of these areas may well available in EcmaScript vNext
  • Having to cope with browser differences
  • Development & re-factoring tool’s probably aren’t quite as mature as those used in compiled languages
  • A lot of peoples JS experience is to add a pop up alert box when validation fails or to bring in a jQuery widget

In my WebGL game there is likely to be a fair amount of JavaScript so we will need to keep things organized otherwise it’s going to be as much fun working with as Sql Server Reporting Services – yes that bad my friend..

So how to organize our code?

Below is a screenshot of my current script setup (excluding external libraries).

Screenshot of scripts within game

In the beginning much of the code was in three or so files until it became obvious it needed to be pulled apart. As the game has developed I have constantly been re factoring and pulling the code out into separate files as needed and this has worked well allowing me to develop the game rapidly without getting caught up in architectural decisions.

The file Game.js contains a number of three.js specific concepts such as the game scene, camera, lighting and rendering loop.

Some of the scripts are pretty small but that’s the way I like them – much easier to maintain & anyway they will all be concatenated and bundled together before being served to the user.

Below is some code that sends a command (e.g. move creature from A to B) using SignalR proxy – it does one thing and it does it well (although er it prob should have some error handling but let’s move along):

var GameCommandSender = (function() {

"use strict";

function send(command) {



return {

send: send



Module pattern

This brings us to a common pattern in JavaScript for organizing code, the module pattern.

In its simplest state (and there are a number of variations each with their own advantages) the module pattern looks like this:

var myModule= (function () {

//just visible inside our function
var myPrivateValue=1;

//visible outside function

var myPublicValue=2;

function myFunction{

//lets export what we want people to use
return {
myFunction: myFunction,

myPublicValue: myPublicValue

The module pattern allows us to encapsulate functionality within the myModule variable & hide variables and functions we don’t want to expose.

Strict mode

The one addition I would suggest you be sure to make in your modules is to turn on JavaScript’s strict mode by adding the following declaration to the start of your function:

“use strict”

This will help catch all sorts of things you probably didn’t want to do anyway such as accidentally creating a new variable on global scope – if you want to know more about strict mode & other EcmaScript 5 features checkout my EcmaScript 5 presentation in the downloads section of my website.

You can if you wanted turn on strict mode everywhere by declaring it in global scope but weird things might happen if you are using 3rd party libraries that don’t expect Strict Mode to be on so I would keep to declaring it inside your functions for now.

Missing classes & inheritance

With game development I have really missed having OOP constructs such as classes & inheritance easily available.

You can to simulate classes and inheritance in JavaScript but it’s slightly different to what you may be used to.

For example for any command (a message that is sent from client to the server) whether it is a move creature or attack I always want to know the type of command, which game session a player belongs to and the player making the command.

For this common functionality it makes sense to have a base command “class”:

function command(type, gameGroupName, gamePlayerId) {

this.type = type;

this.gameGroupName = gameGroupName;

this.gamePlayerId = gamePlayerId;


command.prototype = {

send: function() {


type: this.type,


gameGroupName: this.gameGroupName,

gamePlayerId: this.gamePlayerId




We can then inherit the command “class” using prototypical inheritance and add on functionality specific to our move command:

function moveCommand(creatureInstanceId, gameColumn, gameRow) { = {

creatureInstanceId: creatureInstanceId,

gameColumn: gameColumn,

gameRow: gameRow



moveCommand.prototype = new command('Move', gameGroupName, gamePlayerId);

moveCommand.prototype.constructor = moveCommand;

I think in the future I’ll be re-writing some of this in TypeScript. TypeScript offers a neat shorthand for classes, inheritance & interfaces and can help catch stupid errors like typos & vartiable type assignments but for now it will do.

If you want to know more about the module pattern, inheritance and many other patterns Addy Osmani has a great list of patterns and Stoyan Stefanov has a very detailed book that is a good reference.

That’s all for now :)

Developing a WebGL Game – Part 1

I think many will agree that you cant really know or understand a framework or library until you actually build something with it (note I don’t count WCF in this – that framework is just a pain in the ass).

Over the last few months I have been building & prototyping games with the WebGL library three.js. 

During the games development have found numerous forum posts asking how to accomplish various (simple-ish) tasks in three.js such as selecting an object with the mouse, move it from one position to another and collision detection. I can tell you how to do all this & have come across a few tips and tricks that I thought others might find useful so have decided to blog about the games development. 

In this first post I will be covering the background to my game so if you are after technical details come back next time..

Beginning three.js

One of my earliest WebGL experiments involved creating a simple car game & integrating the physics engine Physijs. 

It looked like this:


Yeah Forza probably isn’t in any danger..

In this example you can use the cop car to ram the green column (don’t do this – the police would be very upset) which then topples over depending on the speed it is hit at.

Integrating the physics library was surprisingly easy and it took care of much of the complexity albeit with the caveat that the occasional odd thing would happen and the vehicle would take off spiraling off into space.

One of the interesting things creating this little example gave me was an appreciation of the subtleties that go into game development. Making a game feel right is surprisingly hard. E.g with a car game you don’t want to feel if the car is floating above the surface & you want to make the acceleration feel like you are shifting up through gears etc etc.

Anyway I tired of this and started a new project to create a new game, and preferably one that I would actually finish developing.

Developing a game also seemed to be a good excuse to play with some technologies that don’t generally come up in paid employment that I wanted to work with such as:

  • WebGL & shaders
  • Advanced JS constructs
  • Possibly Angular for the UI of the game although I remain undecided on this
  • Something to keep game sessions in sync (currently SignalR)
  • Web workers
  • Audio API

What type of game to create?

During my childhood my favorite games were “god” or turn based strategy games (hmm not sure what that says about me) and two of my favorite were a game called Populous and another Lords of Chaos.

Below is a screenshot of Populous:



In populous you are a god in charge of the blue tribe who has the aim of destroying the red tribe (not sure why they hatted the red guys). This was accomplished through flattening the terrain which led to your tribe being able to build better villages & casting spells to destroy your opponent & their tribe.

The other game I enjoyed was Lords of Chaos. The basic premise is simple – you have to destroy the other wizard/player. Each turn you have a certain number of action points you can spend to walk around the randomly generated environment & cast spells and then your turn is over.



So I decided I wanted to build a game with aspects of both Populous & Lords of Chaos although it is developing into something else as I go along.

If you have stayed with me this far you are probably wondering what my game looks like at the moment.

Well er its not the prettiest thing:


Yeah it doesn’t look like too much but there is actually a lot of functionality here that has taken months to develop.

One of the things I did was prototype the tricky areas of functionality before putting anything together. For example in a turn based strategy game I am pretty sure that I will need to select stuff, move it around and detect when objects collide.

In the game you can do the following so far:

  • Move stuff around the environment
  • Generate maps from terrain files (well a terrain file consists of 2 arrays storing tile type, height)
  • Objects can only move a configurable distance
  • When selecting an object it shows the range they can move to (that’s the light grey highlight square in the pic above)
  • The white cube can attack the red cube – but only when its adjacent to it
  • Syncing of environment between sessions – e.g. so 2 people can play the game on different machines
  • The ability to move the viewport around in all directions

Next up I will be discussing project organization – JavaScript can get unmanageable pretty quick unless you are careful..

DDD Mebourne coordinator Lars Klint releases Windows Phone Pluralsight Course!

My friend and fellow DDDMelbourne coordinator Lars Klint recently released his Windows Phone Pluralsight course – Building Windows Phone Apps That Stand Out.

I don’t think there are many people that are bigger Windows Phone fans than Lars and its great to see him sharing his knowledge. 

Congratulations Lars and I know how much work goes into putting together training content.

Windows Phone developers be sure to check it out!

Whats new in IE11?

With the Windows 8.1 update in addition to a whole heap of OS changes and the reappearance of the start button (well kind of) we get the latest version of Internet Explorer – Internet Explorer 11!

Internet Explorer 11 of course contains improved support for new standards and API’s and it’s great to see Microsoft really stepped up their release cadence with IE 10 released only a year ago – can you believe there was about 3 years between IE 8 & 9 being released and 5 whole years between IE 5 & 6!

IE11 contains a heap of new features but for those of you with a short attention span my top 5 are:

  • A long overdue refresh of the F12 developer tools bringing IE11’s dev tooling into line with other browsers and with the addition of a few treats not found elsewhere
  • Support for a number of new standards & APIs  – e.g. dataset, mutation observers
  • WebGL meaning from now on every major browser supports a way to render 3d content!
  • Tab, history & setting synchronization
  • Page asset/network prioritization changes

IE 11 supported platforms
IE11 is of course supported on Windows 8 as part of the Windows 8.1 update but if you are running Windows 7 sp1 (and who can blame you as Win 8 has some er irritating quirks) you will still be able to use IE11 (although it’s not yet released at the time of writing so you er can’t quite yet).

It’s also worth noting there are some features that are not supported in Windows 7 due to OS limitations around graphics, security & device orientation. For a full list please refer to:

IE 11 will also be supported on Windows Server 2008 R2 Sp1 & will come with Windows Server 2012 R2.

Completely overhauled F12 developer tools
The new F12 developer tools deserve an entire blog post(s) of their own so I will just summarize some of the main changes (you can go to to read in more detail about these):

  • New improved cleaner, more intuitive interface
  • Ability to right click to inspect an element
  • Intellisense auto completion for html, css & js
  • DOM drag & drop
  • No need to refresh page to enable debugging
  • Scrollbar shows breakpoints in code
  • See event handlers applied to node (and ill add that I found this better referenced the code than Chromes implementation)
  • Ability to move execution point backwards
  • Break on creation of new web worker
  • Performance profiling
  • Screen (size & resolution) & GPS emulation (for geolocation testing)
  • Ability to identify detached DOM nodes that can cause memory headaches

The below screenshot shows the new tools so you can see how different they are:


As long as you are using a Microsoft account (e.g. not just a local Windows account) then IE 11 will sync your browser history, typed URLs, favourites,  settings and credentials using Skydrive behind the scenes. The settings for this feature are a little hidden away under PC Settings, Skydrive, sync settings and enables fine tuning of just what’s synced.

Whilst we are discussing tabs IE 11 allows you to open unlimited numbers of tabs (you were limited to 10 in IE10) so you can have all your cat pictures open at once.

Standards & compatibility related changes
When IE 8 was released Microsoft introduced the concept of document modes to facilitate the rendering of older web pages. It is possible using a special http header or meta tag to tell IE to render a page using a particular document mode version. This feature would sometimes be useful when working with sites or CMS systems where you had little control over the html that was rendered and needed to ensure it worked with a particular browser version.

From IE 11 to help move things forward & provide the best user experience possible document mode should be considered deprecated (although will still currently work as of IE11). In IE11 edge mode is the preferred mode to render documents and contains the support for the standards. It’s very easy to tell IE11 that you want your page to be rendered using this mode simply add the html 5 doctype,

In the olden days some sites would use API’s such as navigator.appName & navigator.product to detect whether IE was accessing a page and serve a more basic version of a site (as older versions of IE had poorer standards support). The problem with this is that later versions of IE probably do support these features which can result in a poor experience  for users. IE 11 will now return “Netscape” when navigator.appName is called and “Gecko” for navigator.product. This also reflects whats specified in the HTML5 standard and what other browsers do so don’t think this is some Microsoft related hackary!

IE 11 removes support for a number of legacy api’s that you really shouldn’t be using anyway such as attachEvent, execScript & the most evil document.all. For a full list please refer to:

Change to user agent string
On Windows 8.1 IE 11 will identify itself as:

Mozilla/5.0 (Windows NT 6.3; Trident/7.0; rv:11.0) like Gecko

Microsoft say they changed the user agent string to reduce the possibility of IE being incorrectly identified as an earlier version e.g. IE 10 identified itself as:

Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0)

So I guess “compatible” & “MSIE” potentially caused some issues. MS say that if for some strange reason you want to detect just IE 11 (and you probably don’t really want to do this as you should be using feature detection)  then you can check for the presence of the string “Trident” (IE’s layout engine) and presumably should also use the version number once when IE12 is released.

API & JS Feature Support
IE now supports the following features & APIs:

  • Dataset for reading custom data attributes from an element
  • Mutation observers (a way of monitoring DOM changes e.g. changes to values or the addition & removal of nodes)
  • let (blockscoped variable)
  • const (block scoped constant variable)
  • Set’s (Set’s ensure uniqueness of key, value pairs in a collection)
  • Maps (work a bit like a C# dictionary)
  • WeakMap – like a Map object but the key must be an object. If the key object is destroyed the weak map removes the key/value pair automatically
  • Internationalization API (date & number formatting stuff)
  • __proto__ property
  • Better canvas support
  • Fullscreen API
  • Screen Orientation API
  • Device orientation events
  • Web Cryptography API
  • Clipboard support for images pasted into contenteditable regions
  • Input Method Editor (IME) accessibility support  – I’m not too clear what this is but apparently as an example enables you to “avoid user interface collisions”
  • Accessibility support for clear button in text input
  • Command identifiers – allow control over undo stack for editing

Graphical & Layout related changes
IE 11 has the following graphical & layout related changes:

  • WebGL (yay! – it’s worth noting that Microsoft classify IE11’s WebGL implementation as an “early preview” so not all the APIs are fully supported yet. There is full a list of what’s working at:
  • New devicePixelRatio property (devicePixelRatio is the ratio between device pixels & dpi adjusted css pixels)
  • Better support for scaling & zooming
  • Support for different DPI’s on different monitors (previously one DPI was supported)
  • Updated flexbox support
  • CSS3 Border-images
  • Support for SVG pointer events
  • Fix for a number of bugs in East Asian & bi directional text

IE 11 has improved performance with the SunSpider bench mark in July 2013 showing IE 11 is faster than Chrome 28, Firefox 22 & Opera 15 in the testing of some er fairly specific JavaScript scenarios. Of course in the real world browser performance is affected by a number of factors such as rendering, network requests and a number of other things so its tricky to say which is the quickest browser currently. The takeaway is that IE’s JS engine is very fast and at the least comparable with competitors offerings.

Other performance enhancements in IE 11 include:

  • Caching of pages already loaded as long as they meet certain conditions (e.g. must be served over http, contain no websocket usage or pending IndexDb transactions, ActiveX controls etc)
  • Page assets prioritized (layout stuff first all the way to audio, video & ActiveX components)
  • Prioritization by context (e.g. pages in background tabs have lower preference than one in the foreground)
  • Support for lazyload attribute to delay individual resources e.g. <img src=”unimportant.png” lazyload=”1” /> (0 indicates should be loaded with default priority)
  • Preload attribute support (tells the browser to render a page in the background )
  • Prefetch support (tell the browser to download something into the cache – can do up to 10 times per page)
  • Dns-prefetch – tells the browser to resolve a dns query in the background

It’s worth noting that using prerendered & prefetch could have some side effects with scripts & animations already having been run on page – you have been warned!

Microsoft quote that an independent study by NSS lab also showed that IE11 blocked 99.96% of malware based on a 754 examples of malicious software which was better than other browsers that were tested which is awesome news. In previous NSS tests other browsers performed better in some other areas e.g. preventing phishing attacks ( so read into this you will.

It’s quite clear however that Microsoft take security very seriously and IE 11 offers further features to increase protection:

  • In IE11 on Windows 8 Enhanced protection mode (EPM) & App container are turned on by default. This prevents unauthorized reading/writing to OS and was previously off by default
  • The ability to create Do Not Track (DNT) exceptions (DNT is a header to indicate that a site shouldn’t track a user)
  • Support for a number of new group policy settings e.g. control of page prediction, ms personalization of search results, phone number, SPDY/3 network protocol
  • Ability to block all 3rd party cookies (found under settings, privacy, cookies)

Windows 8 app related changes
I don’t have a Microsoft tablet related device so I can’t test some of these but apparently IE 11 supports:

  • Phone number detection (not desktop mode)
  • Ability to show 2 windows side by side
  • Browser will scale to fix content
  • Access to downloaded file list
  • Tab position improved
  • Hover states mapped to tap & hold
  • Drag & drop via touch
  • Live tiles with Pinned sites
  • Backswipe with smarter caching
  • Gyroscope input

Misc changes
Some other changes didn’t really fit in other sections but deserve a mention:

  • Mpeg dash support (high quality streaming of media content over http)
  • Better video captioning support for HTML 5 videos – support for dynamic TextTrack (add captions to HTML5 videos using JS,
  • SDP (simple delivery profile) captioning support
  • Ability to control whether video data fetched using XHR is written to disk or not
  • SPDY/3 support (a protocol that modifies the way HTTP is sent to be more efficient)
  • IE 11 will encode all url’s using UTF-8
  • IE 11 includes Adobe Flash out the box!

Potential issues
Of course every new release of software brings with it potential issues and IE is no exception. There has already been an issue with the rendering of Google’s search results that is now fixed but I think the following could potentially cause some headaches:

I really feel this release of Internet Explorer competes with offerings from competitors and will win some developers back with it’s much improved F12 developer tools. It’s also great to see support for the newer web technologies such as WebGL and Microsoft contributing to the community by proposing new standards such as IME.

It is frustrating to see that IE is often one step behind competitors offerings due to its slower release cycle. If anything I think this is due to Internet Explorer’s tight integration with Windows which only seems to be increasing with Windows 8 apps relying on IE components :(

I really don’t think it a good idea that a browser is tied to an operating system so closely (although this has its advantages as well) and it will be interesting to see the direction the Internet Explorer team take with this in the future. I found Aaron Powell’s suggestion that Microsoft fork IE to test new features that get fed back into the main Internet Explorer an interesting read.

My only real gripe with IE now is that I would really like to see a good way to extend the browser – this is currently far too hard & badly documented.

But in conclusion IE 11 is a great release and a massive improvement on IE 10 with its improved development tooling.

Further reading

IE 11 guide for developers

IE Blog

Overview of IE 11

IE test drive site


This is a series of tutorials on WebGL using the three.js library – you may also be interested in Part 1 

In my previous post we discussed the history of WebGL and looked at a number of libraries to make working with WebGL as easy as possible.

We will be working with the three.js library so the first thing you will want to do is head over to and download the latest version of three.js.

There is a little download link on the left hand side of the page you want to click on to which will give you a zip file containing the latest three.js library and a heap of examples.

Let me start by saying that Three.js is an awesome project, it has a team of very active developers, a big community and some great examples – there is a big but coming however..


Three.js’s documentation sucks. Really sucks – in fact it sucks more than White house down which is the worst movie I have seen this year. I’d love to help the three.js guys fix up the documentation but just don’t have enough knowledge to assist in this area yet so will just whinge (and warn you) about it right now..

It is worth mentioning that three.js does have an enormous number of examples available which is arguably better than documentation anyway. However I found that its not that obvious how some of them work as there is little in the way of explanation of some of the maths involved. This coupled with bad documentation can make for a frustrating process of trial and error to work out how to use the various features. I found a collection of some more readable examples at that you may want to check out.

So before we get any further I want to save you a lot of time & effort & recommend a book to you – Chris Storm’s 3D programming for kids.

Don’t worry I wont tell anyone you downloaded a programming book aimed at kids (I do have my doubts how many 10 year old’s will cope with matrix projections but I digress..).

Don’t let the title put you off – this is by far the best introduction I have read of three.js and contains a number of very useful examples that will save you heaps of time working out how to do common tasks such as animating a group of objects, move a character around & collision detection. This book also has a very readable explanation of some of the maths involved in 3D programming – its also apparently used as a university text in an introduction to 3D programming course so don’t feel too bad..

In our first example we will draw a wire frame sphere on the screen.

Why? – well why not and we’re not going to be coding GTA V in our first example.

The end product will look like this:


Start off by creating a new html page – note you don’t need jQuery but it will save some typing later on:

<!DOCTYPE html>
<title>Hello three.js</title>

<script src="three.js"></script>
<script src="jquery-2.0.2.js"></script>
<script src="helloExample.js"></script>



Now create a JavaScript file called helloExample.js and add the following code:

(function() {

"use strict";

var camera,
scene = new THREE.Scene(),
renderer = new THREE.WebGLRenderer(),
aspect = window.innerWidth / window.innerHeight,
camera = new THREE.PerspectiveCamera(75, aspect, 1, 1000);

camera.position.z = 300;

light = new THREE.PointLight(0xFFFFFF, 1);
light.position.set(0, 0, 200);

sphereMaterial = new THREE.MeshBasicMaterial({
color: 0x000000,
wireframe: true,
wireframeLinewidth: 2


sphere = new THREE.Mesh(new THREE.SphereGeometry(100, 16, 16), sphereMaterial);

container = document.createElement('div'); = "container";

renderer.setSize(window.innerWidth, window.innerHeight);
renderer.render(scene, camera);


So what’s going on here?

Well before we run through the code let’s recap on how coordinates work. We will need a way of telling three.js where we want objects on the screen.

Three.js’s coordinate system looks like this:


So there are 3 axis’s that allow you to position objects on the scene. Three.js also contains some scale methods to make working with different size objects easy that we will use later on.

I think this is fairly straight forward & familiar to most programmers but dont worry this will quickly become complex later on when we want to point the camera at a specific object for example :)

OK now we have this foundation stuff out the way let’s look at the code.

First up we create and initialize a number of objects we will make use of later:

var camera,
scene = new THREE.Scene(),
renderer = new THREE.WebGLRenderer(),
aspect = window.innerWidth / window.innerHeight,

We then create a new PerspectiveCamera (there is also another type of camera called OrphographicCamera which doesn’t render perspective but don’t worry about that for now) that tells three.js where we are looking at:

camera = new THREE.PerspectiveCamera(75, aspect, 1, 1000);

The first parameter (75) refers to the vertical field of view of the camera (FOV), the second represents the aspect ratio of the screen and the 3rd and 4th parameter tell three.js we want to see objects between 1 and 1000 z position – this can be important for performance (why render stuff really far away?) and certain effects. Hmm wtf does all that mean? Well Jeff Atwood (coding horror) has a good diagram & explanation of FOV & aspect ratios that you should check out.

Next up we move our camera nearer to us (e.g. back) by changing the z position. We then add it to our scene:

camera.position.z = 300;

It’s important with three.js to remember to add a light to a scene otherwise we won’t see anything so lets do that:

light = new THREE.PointLight(0xFFFFFF, 1);
light.position.set(0, 0, 200);

There are a number of other types of lights and you can also play with the colors to create some great effects.

Next up we create a material (kind of what we will paint our object with).

In this example we will indicate that we  want a wire frame version of the object as we are hipster like that:

sphereMaterial = new THREE.MeshBasicMaterial({
color: 0x000000,
wireframe: true,
wireframeLinewidth: 2

Now up lets create our sphere by creating a mesh (think of meshes as a scaffold for the object based on a collection of x,y & z points – called Vertices in 3D speak) based on one of three.js’s primitives – SphereGeometry:

sphere = new THREE.Mesh(new THREE.SphereGeometry(100, 16, 16), sphereMaterial);

The 100 specifies the size of the object and the 16’s how many parts or segments make up the sphere – more parts = smoother sphere but potentially more memory to store object & slower to render.

Finally we need a way of getting this onto the page itself so lets create a div & append our renderer we created earlier to it:

container = document.createElement('div'); = "container";
renderer.setSize(window.innerWidth, window.innerHeight);

This will all get rendered in a canvas element that three.js will create for us inside the container div.

Finally we need to tell three.js we want to render our content:

renderer.render(scene, camera);

And we are done!

Although there is a fair bit of code most of its around setup and you will need something similar each time so you will quickly get used to it.

Next time we will look at animation!