Skip to content

Latest commit

 

History

History
93 lines (63 loc) · 5.18 KB

2-dimensional-euclidean.md

File metadata and controls

93 lines (63 loc) · 5.18 KB
Raw

2-dimensional euclidean grid example

Let's see how to use the wfc4j library to generate a planar pattern. These are the tiles we have available:

NE NW SE SW 
import java.util.HashSet;
import dev.irzinfante.wfc4j.model.Tile;

Tile<String> NE = new Tile<>("NE"), NW = new Tile<>("NW"), SE = new Tile<>("SE"), SW = new Tile<>("SW");

var tileSet = new HashSet<Tile<String>>();
tileSet.add(NE); tileSet.add(NW); tileSet.add(SE); tileSet.add(SW);

So, the logical adjacencies between tiles are the following:

Tile Left adjacent tiles Right adjacent tiles Bottom adjacent tiles Top adjacent tiles
$~~~~$ $~~~~$ $~~~~$ $~~~~$
$~~~~$ $~~~~$ $~~~~$ $~~~~$
$~~~~$ $~~~~$ $~~~~$ $~~~~$
$~~~~$ $~~~~$ $~~~~$ $~~~~$ 
import dev.irzinfante.wfc4j.model.TileMap2D;
import dev.irzinfante.wfc4j.enums.Side2D;

var adjacentNWSW = new HashSet<Tile<String>>();
adjacentNWSW.add(NW); adjacentNWSW.add(SW);

var adjacentSESW = new HashSet<Tile<String>>();
adjacentSESW.add(SE); adjacentSESW.add(SW);

var adjacentNESE = new HashSet<Tile<String>>();
adjacentNESE.add(NE); adjacentNESE.add(SE);

var adjacentNENW = new HashSet<Tile<String>>();
adjacentNENW.add(NE); adjacentNENW.add(NW);

var tileMap = new TileMap2D<>(tileSet);

tileMap.setAdjacents(NE, Side2D.Left, adjacentNWSW);	tileMap.setAdjacents(NE, Side2D.Right, adjacentNWSW);
tileMap.setAdjacents(NE, Side2D.Bottom, adjacentSESW);	tileMap.setAdjacents(NE, Side2D.Top, adjacentSESW);

tileMap.setAdjacents(NW, Side2D.Left, adjacentNESE);	tileMap.setAdjacents(NW, Side2D.Right, adjacentNESE);
tileMap.setAdjacents(NW, Side2D.Bottom, adjacentSESW);	tileMap.setAdjacents(NW, Side2D.Top, adjacentSESW);

tileMap.setAdjacents(SE, Side2D.Left, adjacentNWSW);	tileMap.setAdjacents(SE, Side2D.Right, adjacentNWSW);
tileMap.setAdjacents(SE, Side2D.Bottom, adjacentNENW);	tileMap.setAdjacents(SE, Side2D.Top, adjacentNENW);

tileMap.setAdjacents(SW, Side2D.Left, adjacentNESE);	tileMap.setAdjacents(SW, Side2D.Right, adjacentNESE);
tileMap.setAdjacents(SW, Side2D.Bottom, adjacentNENW);	tileMap.setAdjacents(SW, Side2D.Top, adjacentNENW);

Now we can instantiate the API class with an 6 by 8 grid:

import dev.irzinfante.wfc4j.api.EuclideanWFC2D;

int gridSizeX = 6, gridSizeY = 8;

We will run 2 examples:

  • For the first one we won't impose any restriction:

    var WFC_1 = new EuclideanWFC2D<String>(tileMap, gridSizeX, gridSizeY);
WFC_1.run();

  • For the second one we will impose some constraint on the center of the grid:

    import java.util.Set;
import java.util.Arrays;

var entropy = new HashMap<Integer[], Set<Tile<String>>>();
entropy.put(new Integer[]{2, 3}, new HashSet<>(Arrays.asList(NW)));
entropy.put(new Integer[]{3, 4}, new HashSet<>(Arrays.asList(SE)));

var WFC_2 = new EuclideanWFC2D<String>(tileMap, gridSizeX, gridSizeY, entropy);
WFC_2.run();