pmi 0.3.0

Map importer for PyxelEdit editor

Released 2016-01-09.

To install, run:

haxelib install pmi 0.3.0

See using Haxelib in Haxelib documentation for more information.

Maintainercaribou
Websitehttps://github.com/Dvergar/PyxelEdit-Map-Importer
Current version0.3.0
StatisticsInstalled 23 times
LicenseBSD
Tags editor, game, importer, map, pyxel, pyxeledit

README.md

PyxelEdit-Map-Importer

Haxe map importer for Pyxel Edit for the free & paid version. With OpenFL and Luxe helpers.

Pyxel Edit + flash version

Usage

  • Export your map File > Export tilemap as XML...
  • Export your tileset File > Export tileset...

Make use of the PyxelEdit-Map-Importer tools with import pmi.PyxelMapImporter

Loading the map

Assuming you're not necessarily using any graphical framework (server for example) :

var pyxelMap = new PyxelMapImporter(sys.io.File.getContent("map.xml")); will load the xml pyxel map. The argument is the xml content as String.

Extracting layer datas

Pyxel Edit layer view

var background = pyxelMap.getDatasFromLayer("background");

  • "background" is the name of the layer in PyxelEdit.
  • background (the variable) is an object of type Layer.

Layer.tiles is an Array<Tile> where you can access fields : x, y, index,rot & flipX as it is in the XML, those datas are exposed in an cleaner way than the XML file and let you use some of the parameters i'm not using in the other methods.

Make those layers a tile array

var backgroundArray = pyxelMap.getLayerArray(background) will return an map array of type Array<Array<Int>> allowing you to check the tile ID with backgroundArray[x][y].

You can also use it to get a collision map. If, for example, you name a PyxelEdit layer "collision" and dedicate a red tile for collisions, you can then extract that layer and check if there is a collision with a simple collisionArray[x][y].

IDs assignation

IDs are assigned in order of appearance in your Pyxel Edit tileset window :

Tileset IDs

So let's say your collision red tile is at the rank 5, to check a collision you'll have to check if collisionArray[x][y] == 5: This is not a 0/1 collision map.

-1 refers to "no tile".

Example

import pmi.PyxelMapImporter;

class Main extends Sprite
{
    public function new()
    {
        super();
        var pyxelMap = new PyxelMapImporter(sys.io.File.getContent("map.xml"));
        var background = pyxelMap.getDatasFromLayer("background");
        var backgroundArray = pyxelMap.getLayerArray(background);
    }
}

OpenFL helper

You can make use of pmi.OpenflHelper to get a tilesheet object and a tile array easily.

  • var tilemapBackground = OpenflHelper.getTilesheetArray(background); will return an Array<Float>.
  • var tilesheet = OpenflHelper.getTilesheet("assets/tileset.png"); will return a tilesheet object.

and that's all you need.

Note that to load an openFL asset (the pyxel xml map) you would need new PyxelMapImporter(Assets.getText("assets/map.xml")); here.

Example

It will load three different layers and will draw them on screen.

import flash.display.Sprite;
import openfl.Assets;
import openfl.display.Tilesheet;

import pmi.PyxelMapImporter;
import pmi.OpenflHelper;


class Main extends Sprite
{
    public function new ()
    {
        super();
        var pyxelMap = new PyxelMapImporter(Assets.getText("assets/map.xml"));
        var background = pyxelMap.getDatasFromLayer("background");
        var walls = pyxelMap.getDatasFromLayer("walls");
        var objects = pyxelMap.getDatasFromLayer("objects");
        var tilemapBackground = OpenflHelper.getTilesheetArray(background);
        var tilemapWalls = OpenflHelper.getTilesheetArray(walls);
        var tilemapObjects = OpenflHelper.getTilesheetArray(objects);
        var tilesheet = OpenflHelper.getTilesheet("assets/tileset.png");

        tilesheet.drawTiles(flash.Lib.current.graphics, tilemapBackground, false, Tilesheet.TILE_TRANS_2x2);
        tilesheet.drawTiles(flash.Lib.current.graphics, tilemapWalls, false, Tilesheet.TILE_TRANS_2x2);
        tilesheet.drawTiles(flash.Lib.current.graphics, tilemapObjects, false, Tilesheet.TILE_TRANS_2x2);
    }
}

Luxe helper

You can make use of pmi.LuxeHelper to get a tilemap object and and fill the tilelayers easily.

  • var tilemap = LuxeHelper.getTilemap('assets/tileset.png'); will return a Tilemap object.
  • LuxeHelper.fillLayer(tilemap, background); will add the appropriate tilelayer to the tilemap.

and that's all you need.

Note that to load a luxe asset (the pyxel xml map) you would need new PyxelMapImporter(Luxe.loadText("assets/map.xml", null, false).text); here.

Example

It will load three different layers and draw them on screen.

import pmi.PyxelMapImporter;
import pmi.LuxeHelper;


class Main extends luxe.Game
{
    override function ready()
    {
        var pyxelMap = new PyxelMapImporter(Luxe.loadText("assets/map.xml", null, false).text);
        var tilemap = LuxeHelper.getTilemap('assets/tileset.png');
        var background = pyxelMap.getDatasFromLayer("background");
        var walls = pyxelMap.getDatasFromLayer("walls");
        var objects = pyxelMap.getDatasFromLayer("objects");

        LuxeHelper.fillLayer(tilemap, background);
        LuxeHelper.fillLayer(tilemap, walls);
        LuxeHelper.fillLayer(tilemap, objects);

        tilemap.display({});
    }
}