S&box Wiki

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