https://github.com/markwinter/tmxjson
C++14 Library for reading json formatted Tiled maps
https://github.com/markwinter/tmxjson
tiled-map-editor
Last synced: 3 months ago
JSON representation
C++14 Library for reading json formatted Tiled maps
- Host: GitHub
- URL: https://github.com/markwinter/tmxjson
- Owner: markwinter
- License: mit
- Created: 2018-02-15T10:37:35.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-19T13:52:52.000Z (almost 7 years ago)
- Last Synced: 2025-02-10T14:42:46.079Z (5 months ago)
- Topics: tiled-map-editor
- Language: C++
- Size: 218 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.MIT
Awesome Lists containing this project
README
# tmxjson
tmxjson is a library for reading json formatted maps exported from the [Tiled Map Editor](http://www.mapeditor.org/).
Supported Tiled version: 1.1
### Using Tiled and tmxjson
- Available formats: `CSV` `Base64 (Uncompressed)` `Base64 (zlib compressed)`
- You must also embed your tilesets into the map.
- Export your map as json to be used by this library (File > Export As)
### How to use this library
You can either include the source in your project, or you can build it and link against it.
Then you will want to use an instance of the Map class to load and render your map.
```CPP
#include
tmxjson::Map map("mymap.json");
auto layers = map.GetLayers();
auto tile_sets = map.GetTileSets();
for (const auto& layer : layers)
ParseLayer(layer);
void ParseLayer(tmxjson::Layer& layer) {
if (layer.GetType() == tmxjson::LayerType::kGroup) {
// Groups contain more embedded layers
for (const auto& child_layer : layer.GetLayers())
ParseLayer(child_layer);
} else if (layer.GetType() == tmxjson::LayerType::kTileLayer) {
for (const auto& tile : layer.GetData()) {
... // Render your tiles
}
} else if (layer.GetType() == tmxjson::LayerType::kObjectGroup) {
for (const auto& object : layer.GetObjects()) {
... // Render your objects
}
} else if (layer.GetType() == tmxjson::LayerType::kImageLayer) {
... // Render your image
}
}
```
### Working with custom properties
You must cast to `tmxjson::TypedProperty` in order to use the method `GetValue()`
```CPP
for (auto property : map.GetProperties()) {
if (property->GetType() == tmxjson::PropertyType::kString)
std::cout << "Property (" << property->GetName() << "): " <<
dynamic_cast*>(property.get())->GetValue() << std::endl;
}
```
### Currently Not Supported
- Tilesets: `terrains`, `tiles`
- Wang sets
### Current work
- Finish implementing tmx 1.1 spec