public static LayoutGrid2D <int> Generate(int numberOfRooms, int roomMinWidth, int roomMaxWidth, int roomMinHeight, int roomMaxHeight)
{
try
{
var layout = LayoutGrid2D <int> .LoadFromJson(@"c:\temp\layout1.json");
return(layout);
}
catch
{
var levelGenerator = new LevelLayoutGenerator(numberOfRooms, roomMinWidth, roomMaxWidth, roomMinHeight, roomMaxHeight);
var layout = levelGenerator.Run();
layout.SaveToJson(@"c:\temp\layout.json");
return(layout);
}
}
public void Run()
{
#region hidden
var levelDescription = new BasicsExample().GetLevelDescription();
#endregion
//md In this tutorial, we will see how to save and load level descriptions and generated layouts.
//md ## Level descriptions (JSON)
//md To save a level description to a JSON file, we can call the [`SaveToJson()`][LevelDescriptionGrid2D.SaveToJson(String, Boolean)] method:
levelDescription.SaveToJson("levelDescription.json");
//md And to load a level description from a JSON file, we can use the [`LoadFromJson()`][LevelDescriptionGrid2D.LoadFromJson(String)] method:
levelDescription = LevelDescriptionGrid2D <int> .LoadFromJson("levelDescription.json");
//md By default, the JSON serializer is configured to preserve references to objects. That means that when it first encounters an object, it assigns a unique id to id and when it encounters the same object later, it only references that id and does not serialize the object itself. This is good for when we want load the level description back in C# later, but it may cause problems if we want to use the JSON outside C#. Therefore, it is possible to disable this feature:
levelDescription.SaveToJson("levelDescription.json", preserveReferences: false);
//md > **Note:**: API reference for the `LevelDescriptionGrid2D` class can be found [here][LevelDescriptionGrid2D].
//md ## Layouts (JSON)
#region hidden
levelDescription = new BasicsExample().GetLevelDescription();
var generator = new GraphBasedGeneratorGrid2D <int>(levelDescription);
var layout = generator.GenerateLayout();
#endregion
//md It is possible to save a generated layout to JSON and then load it back:
layout.SaveToJson("layout.json");
layout = LayoutGrid2D <int> .LoadFromJson("layout.json");
//md And it is also possible to disable the `preserveReferences` feature:
layout.SaveToJson("layout.json", preserveReferences: false);
//md > **Note:**: API reference for the `LayoutGrid2D` class can be found [here][LayoutGrid2D].
//md ## Layouts (PNG)
#region hidden
layout = generator.GenerateLayout();
#endregion
//md It is possible to save a generated layout as a PNG. To do that, we have to create an instance of the `DungeonDrawer` class:
var dungeonDrawer = new DungeonDrawer <int>();
//md Then we can save the layout as a PNG:
dungeonDrawer.DrawLayoutAndSave(layout, "dungeon.png", new DungeonDrawerOptions()
{
Width = 2000,
Height = 2000,
});
//md The dungeon drawer produces images that can be seen in all the examples in this documentation. The API reference of the `DungeonDrawerOptions` class can be found [here][DungeonDrawerOptions].
}
