Basics of iTileMaps

Creating new map

Available at launch or by tapping Tools -> New…

New Map

Name is your map filename, if it exists you will be promted to overwrite, for HD maps add -hd suffix at the end.

Map width and height are how much tiles map will be in width and height.

Tile width and height are how much pixels every tile will be. Even for HD maps it is in pixels not points.

When you are ready tap Done at the top.

General interface

UI

Click to enlarge.

Tools list in the left-bottom:

Pan will make pan and zoom gestures active in the working area.

Draw will place current tile on the current layer in the position where you tap in the working area if its in map bounds.

Clear will remove tile from current layer in the position where you tap in the working area if its in map bounds.

Clone will change current tile to one from current layer in the position where you tap in the working area if its in map bounds after it will change current tool to Draw. Empty tile is treated as Clear.

Tiles will open Tiles window.

Layers will open Layers list.

Layers

Each map must have at least one layer. Layers can hold tiles or objects, each tile layer can hold one tileset. Layer ordering show higher layers on top of others it is usefull for transperent tiles. To access layer interface tap Layers button in the left-bottom corner.

Layers

Layers window show ordered layer list. Before each layer is a checkbox to control its visibility fast next comes its type icon – tiles or object. To select some layer just tap on it and it will highlight.

At the bottom you will find some buttons:

Add Tiles will create new layer that will be used to show tiles.

Add Object will create new layer that will be used to hold objects.

Remove will delete selected layer.

Move up and down will change selected layer ordering by moving it higher or lower in the list.

More will open layer options.

Creating and editing tile layer

Edit Layer

When creating or editing tile layer you can change more parameters of it:

Name is the name of layer it can be used to get this layer data in your code or just can have some meaning for designer.

Tileset shows which tileset this layer is using it can be changed only when creating new layer. To change it tap arrow on the right.

Opacity adjustment slider will help you see layers below this one by changing alpha channel of every tile in this layer.

Visible checkbox will toggle visibility of current layer.

Properties button at the bottom will open properties editor for current layer.

Tilesets

Tileset is image description for using it as collection of tiles. Each tile layer should have one tileset but each tileset can be used by many layers. You can access tilesets by creating new tile layer and tapping choose tileset, but you will not be able to remove tileset only add new one. Or you can tap Tools -> Tilesets.

Tilesets

As layers list tilesets work similar, you have a list of tilesets in the window and few buttons at the bottom:

Add to create new tileset.

Remove to delete selected tileset you can select it only when accessed through Tools menu and it can be removed only if its not in use by any layer, just remove layers first and then tileset.

Creating new tileset

New Tileset

You can cancel creation by tapping Close button and save your changes by tapping Done button on the top.

Creating tileset have many options:

Name is name of the tileset, also it affects image file name when importing from Photo Library, usually it’s same as image name.

Next textbox is image filename but you can skip it by tapping one of the buttons below to fill it.

Browse button opens list of all images in Documents of the application just tap on some to choose it.

Import button opens your device Photo Library to choose tileset from there. It will try to name imported file same as tileset name.

Margin is how much pixels from borders are empty and does not hold tiles. All borders are counting top, bottom, right and left.

Spacing is how much pixels are empty between each tile. You might want to have a grid drawn in the image for more easy editing or you might want to extrude last pixel of each tile to avoid artifacts when zooming in your game.

Tile width and height is how big in pixels each tile will be. Usually will be same as your map tile width and height, but in some games that use pseudo 3D it will vary.

All values are in pixels even for HD maps, not points.

Tiles

When selected layer is tile type you will have Tiles button in the left-bottom corner. Tapping it will open Tiles window with current layer’s tileset’s tiles.

Tiles are primary element of every tile map. It is small piece of image that can be placed somewhere on the layer.

Tiles

At the top of Tiles window you will find Close window to close this window and Properties button to change properties of the selected tile.

Inside window you will find your tileset image divided to actual tiles, tapping on tile will select it and make it currently active. You can pan or zoom image with standard gestures. When tapping on tile it will add it to the recent tiles list you can find it at the right bottom corner.

Recent Tiles

Tapping on tile in recent tiles will make it current tile and switch to drawing mode.