Revision Difference
Tilesets#545960
<cat>Dev.Map</cat>
<title>Tilesets</title>
<upload src="aafdb/8d98e8c27189686.png" size="564968" name="tileset.png" />
# What is a Tileset
Tilesets allow for the quick replacement of basic geometry for more complex models/geo. The Tiles selected are determined by the characteristics of the tilemesh and through tile properties selected by the user.
#Creating a basic tileset
##Step 1:
When creating the vmap file it is important that it ends with **`_tileset`**. This allows the vmap to show up when selecting the tileset in the tilemeshs object properties.
##Step 2:
To create a tileset hover over the **Tiles** tab and select the **Create tile set** .
<upload src="aafdb/8d98e8cb4f72b64.png" size="55875" name="create tile set.png" />
##Step 3:
Select the tileset in the **Outliner** and rename the tileset in **Object Properties** to **`Base`**.
<upload src="aafdb/8d98e8d08006226.png" size="9386" name="rename.png" />
##Step 4:
To create a tile first create a mesh, while in **Mesh** ( <key>4</key> ) mode go to the **Tiles** tab and select **Create Single Tile** ( <key>Ctrl</key>+<key>Shift</key>+<key>O</key> ) *`Note: The tile will be created separately in the outliner so it needs to be dragged into the Base-Tileset`*
<upload src="aafdb/8d98e8e93fcd34b.png" size="205531" name="create tile.png" />
##Step 5:
The default width and height of the tile is 256. To change this so it matches the mesh first select the tile then go to the **Object Properties**. From there the **Base Width** and **Base Height** can be adjusted.
<upload src="aafdb/8d98e8f47b1ddb8.png" size="74921" name="tile size.png" />
##Step 6:
After all that you should be able to create a tilemesh from an existing mesh, select the tileset from within **Object Properties** and see your mesh be replaced with tiles from the tileset.
<upload src="aafdb/8d98e915b3835a9.mp4" size="19747868" name="2021-10-13 22-33-53.mp4" />
#Tile Object Properties
| Property | Description |
| ------------- |-------------|⤶
| Name | The name of the tile |
| Base Width | Width of the tile |
| Base Height | Height of the tile |
| Use Best Size Match | |
| Minimum Size Scale | The minimum scale at which the tile can be selected |
| Maximum Size Scale | The maximum scale at which the tile can be selected |
| Probability Weight | Determines the chance of the tile being selected from multiple tiles of the same size |
| Display Base Face | Toggle to show the base geometry |
| Align To Axis | |
| Rotation Snapping | |
| Variation Id | |
| Property | Description |
| ------------------------ |-----------------------------------------------------------------------------------------|⤶
| Name | The name of the tile |
| Base Width | Width of the tile |
| Base Height | Height of the tile |
| Use Best Size Match | |
| Minimum Size Scale | The minimum scale at which the tile can be selected |
| Maximum Size Scale | The maximum scale at which the tile can be selected |
| Probability Weight | Determines the chance of the tile being selected from multiple tiles of the same size |
| Display Base Face | Toggle to show the base geometry |
| Align To Axis | |
| Rotation Snapping | |
| Variation Id | |
⤶
#Tileset Properties⤶
Tileset properties can be found by selecting the **`Base - tileset`** in outliner and pressing <key>Alt</key><key>Enter</key>⤶
<upload src="aafdb/8d99061a3c8f036.png" size="21933" name="tileset properties.png" />⤶
Once a property is added it shall appear in the tiles **Object Properties**⤶
##Mesh Properties⤶
###mesh_edge_convexity⤶
<upload src="aafdb/8d99067057ff564.png" size="5273" name="mesh_edge_convexity.png" />⤶
This property can define what tiles can connect together depending on their edge characteristics.⤶
<upload src="aafdb/8d9905e4d8c7ce5.png" size="39381" name="test.png" />⤶
If 180 degrees is treated as flat then **concave is < 180** and **convex is > 180**⤶
⤶
Drop-down options are as follows⤶
- **open**⤶
- **flat**⤶
- **convex**⤶
- **concave**⤶
⤶
Included are also their negated versions and a ***-Match Any** option⤶
⤶
##Example⤶
Here thee setting for mesh_edge_convexity is shown for 2 tiles and how in practice these 2 tiles can be used⤶
<upload src="aafdb/8d9909043f1a950.png" size="200431" name="example.png" />⤶
<upload src="aafdb/8d990914958c046.mp4" size="27956660" name="2021-10-16 11-38-34.mp4" />⤶
##To-do
1. Tileset properties
> - Mesh properties⤶
> - Custom properties
2. Group Proxies