From f8efb983ebee7dbca33c7acfed1c78c04ff37cf1 Mon Sep 17 00:00:00 2001
From: Justin Young <62815737+jyoung4242@users.noreply.github.com>
Date: Tue, 2 Jul 2024 19:58:43 -0400
Subject: [PATCH] Blogpost: autotiling (#3116)
---
site/blog/2024-07-02-autotiling/AT.mdx | 390 ++++++++++++++++++
site/blog/2024-07-02-autotiling/images/ex.png | Bin 0 -> 43399 bytes
.../2024-07-02-autotiling/images/image-1.png | Bin 0 -> 49936 bytes
.../2024-07-02-autotiling/images/image-10.png | Bin 0 -> 23935 bytes
.../2024-07-02-autotiling/images/image-11.png | Bin 0 -> 1445 bytes
.../2024-07-02-autotiling/images/image-12.png | Bin 0 -> 245568 bytes
.../2024-07-02-autotiling/images/image-14.png | Bin 0 -> 318861 bytes
.../2024-07-02-autotiling/images/image-15.png | Bin 0 -> 5767 bytes
.../2024-07-02-autotiling/images/image-16.png | Bin 0 -> 237747 bytes
.../2024-07-02-autotiling/images/image-3.png | Bin 0 -> 191 bytes
.../2024-07-02-autotiling/images/image-4.png | Bin 0 -> 190 bytes
.../2024-07-02-autotiling/images/image-5.png | Bin 0 -> 6401 bytes
.../2024-07-02-autotiling/images/image-7.png | Bin 0 -> 1808 bytes
.../2024-07-02-autotiling/images/image-8.png | Bin 0 -> 2299 bytes
.../2024-07-02-autotiling/images/image-9.png | Bin 0 -> 576562 bytes
.../2024-07-02-autotiling/images/wang.png | Bin 0 -> 76550 bytes
.../images/wang_example.png | Bin 0 -> 27977 bytes
.../images/wang_texture.png | Bin 0 -> 97553 bytes
18 files changed, 390 insertions(+)
create mode 100644 site/blog/2024-07-02-autotiling/AT.mdx
create mode 100644 site/blog/2024-07-02-autotiling/images/ex.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-1.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-10.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-11.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-12.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-14.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-15.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-16.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-3.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-4.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-5.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-7.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-8.png
create mode 100644 site/blog/2024-07-02-autotiling/images/image-9.png
create mode 100644 site/blog/2024-07-02-autotiling/images/wang.png
create mode 100644 site/blog/2024-07-02-autotiling/images/wang_example.png
create mode 100644 site/blog/2024-07-02-autotiling/images/wang_texture.png
diff --git a/site/blog/2024-07-02-autotiling/AT.mdx b/site/blog/2024-07-02-autotiling/AT.mdx
new file mode 100644
index 000000000..2be7ef821
--- /dev/null
+++ b/site/blog/2024-07-02-autotiling/AT.mdx
@@ -0,0 +1,390 @@
+---
+slug: Autotiling Technique
+title: Autotiling Technique
+authors: [justin]
+tags: [gamedev tilemap tiling autotiling tooling]
+---
+
+
+import expng from './images/ex.png';
+import img1 from './images/image-1.png';
+import img3 from './images/image-3.png';
+import img4 from './images/image-4.png';
+import img5 from './images/image-5.png';
+import img7 from './images/image-7.png';
+import img8 from './images/image-8.png';
+import img9 from './images/image-9.png';
+import img10 from './images/image-10.png';
+import img11 from './images/image-11.png';
+import img12 from './images/image-12.png';
+import img14 from './images/image-14.png';
+import img15 from './images/image-15.png';
+import img16 from './images/image-16.png';
+import wang from './images/wang.png';
+import wang1 from './images/wang_texture.png';
+import wang2 from './images/wang_example.png';
+
+
+
+As a game developer, if the thought of hand crafting a level does not appeal to you, then you may consider looking into procedural
+generation for your next project. Even using procedural generation, however, you still need to be able to turn your generated map
+arrays into a tilemap with clean, contiguous walls, and sprites that match up cleanly, as if it was drawn by hand. This is where a
+technique called auto-tiling can come into play to help determine which tiles should be drawn in which locations on your tilemap.
+
+In this article, I will explain the concept of auto-tiling, Wang Tiles, [binary](https://en.wikipedia.org/wiki/Binary) and
+[bitmasks](), and then walk through the process and algorithms associated with using
+this tool in a project.
+
+## What is auto-tiling
+
+Auto-tiling converts a [matrix](https://processing.org/tutorials/2darray) or [array](https://en.wikipedia.org/wiki/Array) of
+information about a map and assigns the corresponding tile texture to each tile in a manner that makes sense visually for the tilemap
+level. This uses a tile's position, relative to its neighbor tiles to determine which tile sprite should be used. Today we will focus
+on bitmask encoding neighbor data, although there are other techniques that can be used to accomplish this.
+
+One can get exposed to auto-tiling in different implementations. If you're using a game engine like [Unity](https://unity.com/) or
+[Godot](https://godotengine.org/), there are features automatically built into those packages to enabling auto-tiling as you draw and
+create your levels. Also, there are software tools like [Tiled](https://www.mapeditor.org/), [LDTK](https://ldtk.io/), and
+[Sprite Fusion](https://www.spritefusion.com/), that are a little more tilemap specific and give you native tools for auto-tiling.
+
+Auto-tiling has provided the most benefit when we think about how we can pivot from tilemap matrices or flat indexes representing the
+state of a tilemap, to a rendered map on the screen. Let us say you have a tilemap in the form of a 2d matrix with 1's and 0's in it
+representing the 'walkable' state of a tile. Let us assign a tile as a floor (0) piece or a wall (1) piece. Now, one can simply use two
+different tiles, for example:
+
+a grass tile 
and a dirt path tile 
+
+We could take a tilemap matrix like this:
+
+
+
+and use these two tiles to assign the grass to the 1's and the 0's to the path tile. It would look like this:
+
+
+
+This is technically a tile-map which has been auto-tiled, but we can do a little better.
+
+## What are Wang tiles?
+
+Wang tiles do not belong or associate with game development or tile-sets specifically, but come from mathematics. So, why are we
+talking about them? The purpose of the Wang tiles within the scope of game development is to have a series of tile edges that create
+matching patterns to other tiles. We control which tiles are used by assigning a unique set of bitmasks to each tile that allows us
+reference them later.
+
+Wang tiles themselves are a class of system which can be modeled visually by square tiles with a color on each side. The tiles can be
+copied and arranged side by side with matching edges to form a pattern. Wang tile-sets or Wang 'Blob' tiles are named after Hao Wang, a
+mathematician in the 1960's who theorized that a finite set of tiles, whose sides matched up with other tiles, would ultimately form a
+repeating or periodic pattern. This was later to be proven false by one of his students. This is a massive oversimplification of Wang's
+work, for more information on the backstory of Wang tiles you can be read here: [Wang Tiles](https://en.wikipedia.org/wiki/Wang_tile).
+
+This concept of matching tile edges to a pattern can be used for a game's tilemap. One way we can implement Wang tiles in game
+development is to create levels from the tiles. We start with a tile-set that represents all the possible edge outcomes for any tile.
+
+These tile assets can be found here: [Wang Tile Set](https://opengameart.org/content/wang-%E2%80%98blob%E2%80%99-tileset)
+
+
+
+The numbers on each tile represents the bitmask value for that particular permutation of tile design. We then can see how you can swap
+these tiles for a separate texture below. In the image above, there are a couple duplicate tile configurations, and they are shown in
+white font.
+
+
+
+The magic of Wang tiles is that it can be extended out and create unique patterns that visually work. For example:
+
+
+
+A bitmask is a binary representation of some pattern. In the scope of this conversation, we will use a bitmask to represent the 8
+neighbors tiles of an given tile on a tilemap.
+
+## What is a bitmask?
+
+A bitmask is a binary representation of some pattern. In the scope of this conversation, we will use a bitmask to represent the 8
+neighbors tiles of an given tile on a tilemap.
+
+### Quick crash course on Binary
+
+So our normal counting format is designed as base-10. This means that each digit in our number system represents digits 0-9 (10
+digits), and the value of each place value increases in power of base 10.
+
+So in the number '42', the 2 represents - (2 \* 100) which is added to the 4 in the 'tens' place, which is (4 \*
+101), which equals 42.
+
+```
+(2 * 1) + (4 * 10) = 42
+```
+
+T This in binary looks different, as binary is base-2, which means that each digit position has digits 0 and 1, (2 digits). This is the
+counting system and 'language' of computers and processors.
+
+Quickly, let's re-assess the previous example of '42'. 42 in binary is 101010. Let's break this down in similar fashion.
+
+Starting from the right placeholder and working our way left... The 0 in the right most digit represents 0 \* 20. The next
+digit represents 1 \* 21... and on for each digit and the exponent increases each placeholder.
+
+```
+ 0 1 0 1 0 1
+_________________________________________________________________
+(0 * 1) + (1 * 2) + (0 * 4) + (1 * 8) + (0 * 16) + (1 * 32) = 42
+
+2 + 8 + 32 = 42
+```
+
+### Bits, Bytes, and Bitmasks
+
+That is how information in computers is encoded. We can use this 'encoding' scheme to easily represent binary information, like 'on' or
+'off', or in this discussion, walkable tile or not walkable. This is why in the tile-set matrix example above, we can flag non-walkable
+tiles as '1', and walkable tiles as '0'. This is now binary encoded.
+
+A bit is one of these placeholders, or one digit. 8 of this bits together is a byte. Computers and processors, at a minimum, read at
+least a byte at a time.
+
+We can use this binary encoding for the auto-tiling by representing the state of each of a tile's neighbors into 8 bits, one for each
+neighbor. This means that the condition and status of each neighbor for a tile can be encoded into one byte of data (8 bits) and CAN be
+represented with a decimal value, see my earlier explanation about how the number 42 is represented in binary.
+
+So the whole point of this section is to get to this example: we are going to encode the neighbor's data for an example tile.
+
+### Quick Demonstration
+
+
+
+Now the tile we are assigning the bitmask to is the green, center tile. This tile has 8 neighbors. If I start reading the 1's and 0's
+from the top left and reading right, then down, I can get the value: 101 (top row) - 01 (middle row) - 101 (bottom row). Remember to
+skip the green tile.
+
+
+
+All together, this is 10101101, which can be stored as a binary value, which can be converted to a decimal value: 173. Remember to
+start at the rightmost bit when converting.
+
+```
+ 1 0 1 1 0 1 0 1
+__________________________________________________________________________________
+(1 * 1) + (0 * 2) + (1 * 4) + (1 * 8) + (0 * 16) + (1 * 32) + (0 * 64) + (1 * 128)
+
+1 + 4 + 8 + 32 + 128 = 173
+```
+
+Now we can use that decimal value of 173 to represent the neighbor pattern for that tile. Every tile in a tilemap, can be encoded with
+their 'neighbors' bitmasks.
+
+As you saw earlier, the wang tiles had bitmask values assigned to them. This is how we know which tile to substitute for each bitmask.
+
+## The Process
+
+We have already covered the hard part. In this section we are pulling it all together in a walkthrough of the overall high level
+process.
+
+Here are the steps we are covering:
+
+Find or create a tile-set spritesheet that you would like to use Create your tilemap data, however you like. Loop through each index of
+tile, and evaluate the neighbor tiles, and assign bitmask Map the bitmap values to the 'appropriate' tile in your tile-set (this is the
+long/boring part IMO) Iterate over each tile and assign the correct image that matches the bitmask value Draw your tilemap in your game
+Creating a tile-set Here is an example of a tile-set that I drew for the demo project.
+
+
+
+These 47 tiles represent all the different 'wall' formations that would be required. I kept my floor tiles separate in a different file
+so that it is easier to swap out. The floor is drawn as a separate tile underneath the wall. Each tile represented in the grid is
+designed to match up with a specific group of neighbor patterns. Let's take the top-left tile:
+
+
+
+This tile is intended to be mapped to a tile where there are walled neighbors on the right, below, and bottom right of the tile in
+question. There maybe a few neighbor combinations ultimately that may be mapped to this tile, in my project I found 7 combinations that
+this tile configuration would be mapped to.
+
+If you look through each tile you can see how it 'matches' up with another mating tile or tiles in the map. For my implementation, I
+spent time testing out each configuration visually to see which tile different bitmasks needed to be mapped to.
+
+### Create your tilemap data
+
+Now we will use either a 2d matrix or a flat array in your codebase, with each index representing a tile. I use a flat array, with a
+tilemap width and height parameter. It is simply preference.
+
+You can manually set these values in your array, or you can use a procedural generation algorithm to determine what your wall and floor
+tiles. I can recommend my [Cellular Automata](../2024-6-16-cellular-automata/cellularautonoma.mdx) aarticle that I wrote earlier if you
+are interested in generating the tilemap procedurally. When this is completed, you'll have a data set that will look something like
+this.
+
+
+
+### Loop through tilemap and assign bitmasks
+
+For each index of your array, you will need to capture all the states of the neighbor tiles for each tile, and record that value on
+each tile. I would refer to the previous section regarding how to calculate the bitmasks.
+
+```ts
+ // This loops through each tile in the tilemap
+ private createTileMapBitmasks(map: TileMap): number[] {
+ // create the array of bitmasks, the indexes of this array will match up to the index
+ // of the tilemap
+ let bitmask: number[] = new Array(map.columns * map.rows).fill(0);
+ let tileIndex = 0;
+
+ // for each tile in the map, add the bitmask to the array
+ for (let tile of map.tiles) {
+ bitmask[tileIndex] = this._getBitmask(map, tileIndex, 1);
+ tileIndex++;
+ }
+
+ return bitmask;
+ }
+
+ // setting up neighbor offsets indexes /
+ const neighborOffsets = [
+ [1, 1],
+ [0, 1],
+ [-1, 1],
+ [1, 0],
+ [-1, 0],
+ [1, -1],
+ [0, -1],
+ [-1, -1],
+ ];
+
+ // iterate through each neighbor tile and get the bitmask based on if the tile is solid
+ private _getBitmask(map: TileMap, index: number, outofbound: number): number {
+ let bitmask = 0;
+
+ // find the coordinates of current tile
+ const width = map.columns;
+ const height = map.rows;
+ let y = Math.floor(index / width);
+ let x = index % width;
+
+ // loop through each neighbor offset, and 'collect' their state
+ for (let i = 0; i < neighborOffsets.length; i++) {
+ const [dx, dy] = neighborOffsets[i];
+ const nx = x + dx;
+ const ny = y + dy;
+ //convert back to index
+ const altIndex = nx + ny * width;
+
+ // check if the neighbor tile is out of bounds, else if tile is a wall ('solid') shift in the bitmask
+ if (ny < 0 || ny >= height || nx < 0 || nx >= width) bitmask |= outofbound << i;
+ else if (map.tiles[altIndex].data.get("solid") === true) bitmask |= 1 << i;
+ }
+
+ return bitmask;
+ }
+```
+
+### Map bitmask values to each tile sprite in spritesheet
+
+Here is the monotonous part. For a byte, or an 8-bit word, the amount of permutations of tile patterns is 256. That's a lot of
+mappings. Now I did mine the hard way, manually, one by one. But there may be easier ways to do this. I use Typescript, so I will share
+a bit of what my mappings look like. Each number key in the object is the bitmask value, and its mapped to a coordinate array [x, y]
+for my spritesheet that I shared earlier in the article. Now, I could have put them in order, but that does not really serve any
+benefit.
+
+```ts
+export const tilebitmask: Record> = {
+ 0: [3, 3],
+ 1: [3, 3],
+ 4: [3, 3],
+ 128: [3, 3],
+ 32: [3, 3],
+ 11: [0, 0],
+ 175: [0, 0],
+ 15: [0, 0],
+ 47: [0, 0],
+ 207: [0, 5],
+ 203: [0, 5],
+ 124: [3, 5],
+ 43: [0, 0],
+ ...
+```
+
+### Iterate over the tiles and assign tile sprite
+
+The last two steps we'll do together. Now we simply need to iterate over our tilemap, assign the appropriate sprite tiles. I'm using
+Excalibur.js for my game engine, and the code is in Typescript, but you can use whichever tool you would prefer.
+
+```ts
+draw(): TileMap {
+ // call the method that loops through and configures all the bitmasks
+ let bitmask = this.createTileMapBitmasks(this.map);
+ let tileindex = 0;
+
+ for (const tile of this.map.tiles) {
+ tile.clearGraphics();
+
+ // if the tile is solid, draw the base tile first, THEN the foreground tile
+ if (tile.data.get("solid") === true) {
+ // add floor tile
+ tile.addGraphic(this.baseTile);
+
+ // using the tile's index grab the bitmask value
+ let thisTileBitmask = bitmask[tileindex];
+
+ // this is the magic... grab the coordinates of the tile sprite from tilebitmask, and provide that to Excalibur
+ let sprite: Sprite;
+ sprite = this.spriteSheet.getSprite(tilebitmask[thisTileBitmask][0], tilebitmask[thisTileBitmask][1]);
+
+ //add the wall sprite to the tile
+ tile.addGraphic(sprite);
+
+ } else {
+ // if the tile is not solid, just draw the base tile
+ tile.addGraphic(this.baseTile);
+ }
+ tileindex++;
+ }
+ return this.map;
+ }
+```
+
+## Demo Application
+
+
+
+[Link to Demo](https://mookie4242.itch.io/autotiling-demonstration)
+
+[Link to Repo](https://github.com/jyoung4242/CA-itchdemo)
+
+In this demo application, I'm using Excalibur.js engine to show how auto-tiling can work, and its benefits in game development. The
+user can click on the tilemap to draw walkable paths onto the canvas. As the walkable paths are drawn, the auto-tiling algorithm will
+automatically place the correct tile in its position based on the neighbor tile's walkable status.
+
+There are some controls at the top of this app, a button to reset the tilemap settings back to not walkable, so one can start over.
+Also, two drop downs that let the user swap out tile-sets for different styles. This shows the benefits of having standardized Wang
+tiles for your tile-sets. For example, in this demo, we have three Wang tile-sets. When you swap them out, it can automatically draw
+them correctly into your tilemap.
+
+Grass
+
+
+
+Snow
+
+
+
+and Rock
+
+
+
+# Why Excalibur
+
+
+
+Small Plug...
+
+[ExcaliburJS](https://excaliburjs.com/) is a friendly, TypeScript 2D game engine that can produce games for the web. It is free and
+open source (FOSS), well documented, and has a growing, healthy community of gamedevs working with it and supporting each other. There
+is a great discord channel for it [JOIN HERE](https://discord.gg/ScX52wD4eM), for questions and inquiries. Check it out!!!
+
+# Conclusions
+
+TThat was quite a bit, no? We covered the concept of Autotiling as a tool you can use in game developement. We discussed the benefits
+of Wang tiles for your projects and that they allow for the auto selection of the correct tile sprites to use based off of bitmask
+assignments. We dug into bitmask and base-2 binary encoding a little bit just to show how we were encoding the neighbor tile
+information into a decimal value so we could map the tile sprites appropriately. We finished this portion by doing an example tile
+encoding of neighbors to demonstrate the process.
+
+We went step by step throught he process of autotiling, looking at tilesets, looking at code snippets, and finishing at the demo
+application on itch. I hope you enjoyed this take on autotiling, as mentioned above, this is NOT the only way to do this, there are
+other ways of accomplishing the same effect. You also can tweak this to your own liking, for instance, you can introduce varying tiles
+so you can use different floor tiles, or adding decord on to walls to add additional variety and add a feeling of greater immersion
+into the worlds your building. Have fun!
diff --git a/site/blog/2024-07-02-autotiling/images/ex.png b/site/blog/2024-07-02-autotiling/images/ex.png
new file mode 100644
index 0000000000000000000000000000000000000000..774654460d2f60237932473ea78ebafa28c3f6a4
GIT binary patch
literal 43399
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
z
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