Skip to content
This repository has been archived by the owner on Oct 3, 2022. It is now read-only.

maxb2/pytiler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pytiler

A python tool to create a bigger image out of image tiles. pytiler is especially useful for building RPG maps from tilesets using conventional photo editing software such as Photoshop or GIMP. pytiler makes arbitrarily sized rectangular images out of a tileset so that you don't have to manually place every tile in your photo editor.

Usage

The simplest way to make a 4x2 image with a single tile is:

python pytiler.py 4 2 tile.png

Resulting in an image like this:

Dungeon Room Builder

"Dungeon Room Builder" by 2-Minute Tabletop licensed under CC BY-NC

pytiler can also select from a group of tiles, and even randomly rotate them for a more natural look. See the usage for more details.

$python pytiler.py -h
usage: pytiler.py [-h] [-o OUT] [-t TILE_DIVS] [-r]
                  dims dims files [files ...]

positional arguments:
  dims                  number of tiles in each direction
  files                 input images to be tiled, randomly selected

optional arguments:
  -h, --help            show this help message and exit
  -o OUT, --out OUT     output image
  -t TILE_DIVS, --tile-divs TILE_DIVS
                        tile subdivisions, usually to take care of alpha
                        borders
  -r, --rotate          randomly rotate the tiles

Tile subdivisions

Some tilesets come with an alpha border, see 2-Minute Tabletop Dungeon Room Builder. pytiler handles these with the -t, --tile-divs option. For example, if you have a tile image that has an alpha border the same width as the width of the image, you would use -t 3 since the actual image is 1/3 of the total image length.

Releases

No releases published

Packages

No packages published

Languages