Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/misterhat/tyler
pack and unpack level maps with tilesheets
https://github.com/misterhat/tyler
Last synced: 1 day ago
JSON representation
pack and unpack level maps with tilesheets
- Host: GitHub
- URL: https://github.com/misterhat/tyler
- Owner: misterhat
- License: gpl-3.0
- Created: 2015-12-27T00:21:32.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-01-01T16:05:31.000Z (almost 9 years ago)
- Last Synced: 2023-08-05T04:04:58.396Z (over 1 year ago)
- Language: Python
- Size: 30.3 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# tyler
Pack and unpack level maps with tilesheets. Maps consists of a 2
dimensional array, with each tile being specified as `[x, y]`, a position on
the tilesheet (*tilesheet.png* by default). tyler can receive maps and a
tilesheet to pack into level images, as well as accept level images to unpack
into maps and a tilesheet.
## Requirements
* Python 3
* NumPy
* PIL
```
# apt-get install python3{,-numpy,-pil}
```
## Usage
```
usage: tyler.py [-h] [-t TILESHEET] [-o OUTPUT] [-s SIZE] [-n]
sources [sources ...]
pack and unpack level maps with tilesheets
positional arguments:
sources png files to unpack or json files to pack
optional arguments:
-h, --help show this help message and exit
-t TILESHEET, --tilesheet TILESHEET
tilesheet png file (default: ./tilesheet.png)
-o OUTPUT, --output OUTPUT
output directory for images or maps (default: .)
-s SIZE, --size SIZE size of each tile in pixels (default: 16)
-n, --no-compress don't compress output tilesheet columns in unpacking
(default: False)
```
## Example
Use tyler to turn tiled images into a JSON matrix and tilesheet image.
*level.png:*
$ ./tyler.py level.png
$ sed 's/]],/]],\n/g' level.json
**Outputs:**
```
[[[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0]...
[[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0...
[[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0...
[[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0...
[[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0...
...
[[0,0],[0,0],[2,9],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0...
[[0,0],[1,10],[2,10],[3,10],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[...
[[1,10],[2,10],[2,11],[3,11],[3,10],[0,0],[0,0],[0,0],[0,0],[0,0],[0,0],[4,11...
[[0,12],[0,12],[0,12],[0,12],[0,12],[0,12],[0,12],[0,12],[0,12],[0,12],[0,12]...
```
*tilesheet.png:*
You can then turn *level.json* back into an image using a different tilesheet:
$ ./tyler.py -t new-tilesheet.png level.json
**Outputs:**
*level.png:*
## License
Copyright (C) 2015 Mister Hat
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .