openPacker

A simplified open source version of Texture Packer.

It is used to combine many images into a single one so that the combined image does not have much empty space.

For more on the problem: see the packing problems (wikipedia), the Bin Packing Problem (wikipedia), this paper, or this article (codeproject).

How to run

python openPacker.py image1.png image2.png image3.png

Output

The output is two things:

1. An atlas (spritesheet) image named 'spritesheet.png'
2. A JSON file on how to read the 'spritesheet.png'

Example run on the images in the 'imgs' folder

python openPacker.py imgs/green.png imgs/dirt_green.png imgs/dirt.png imgs/cinema.png imgs/house_blue.png imgs/house_green.png imgs/house_red.png imgs/tilenew.png imgs/tree.png

1. Image (located at 'output/spritesheet.png'):

2. JSON (located at 'output/out.json'):

[
    {
        "frame": {
            "y": 0, 
            "x": 0, 
            "w": 256, 
            "h": 200
        }, 
        "filename": "imgs/cinema.png"
    }, 
    {
        "frame": {
            "y": 0, 
            "x": 256, 
            "w": 128, 
            "h": 110
        }, 
        "filename": "imgs/house_blue.png"
    }, 
    {
        "frame": {
            "y": 0, 
            "x": 384, 
            "w": 128, 
            "h": 110
        }, 
        "filename": "imgs/house_green.png"
    }, 
    {
        "frame": {
            "y": 0, 
            "x": 512, 
            "w": 128, 
            "h": 110
        }, 
        "filename": "imgs/house_red.png"
    }, 
    {
        "frame": {
            "y": 0, 
            "x": 640, 
            "w": 128, 
            "h": 110
        }, 
        "filename": "imgs/tree.png"
    }, 
    {
        "frame": {
            "y": 110, 
            "x": 256, 
            "w": 128, 
            "h": 64
        }, 
        "filename": "imgs/green.png"
    }, 
    {
        "frame": {
            "y": 110, 
            "x": 384, 
            "w": 128, 
            "h": 64
        }, 
        "filename": "imgs/dirt_green.png"
    }, 
    {
        "frame": {
            "y": 110, 
            "x": 512, 
            "w": 128, 
            "h": 64
        }, 
        "filename": "imgs/dirt.png"
    }, 
    {
        "frame": {
            "y": 110, 
            "x": 640, 
            "w": 128, 
            "h": 64
        }, 
        "filename": "imgs/tilenew.png"
    }
]

Further examples for the sake of testing

python openPacker.py imgs/left/left.0000.png imgs/left/left.0001.png imgs/left/left.0002.png imgs/left/left.0003.png imgs/left/left.0004.png imgs/left/left.0005.png imgs/left/left.0006.png imgs/left/left.0007.png imgs/left/left.0008.png imgs/left/left.0009.png imgs/left/left.0010.png imgs/left/left.0011.png imgs/left/left.0012.png imgs/left/left.0013.png imgs/left/left.0014.png imgs/left/left.0015.png imgs/left/left.0016.png imgs/left/left.0017.png imgs/left/left.0018.png imgs/left/left.0019.png imgs/left/left.0020.png imgs/left/left.0021.png imgs/left/left.0022.png imgs/left/left.0023.png imgs/left/left.0024.png imgs/right/running_right.0000.png imgs/right/running_right.0001.png imgs/right/running_right.0002.png imgs/right/running_right.0003.png imgs/right/running_right.0004.png imgs/right/running_right.0005.png imgs/right/running_right.0006.png imgs/right/running_right.0007.png imgs/right/running_right.0008.png imgs/right/running_right.0009.png imgs/right/running_right.0010.png imgs/right/running_right.0011.png imgs/right/running_right.0012.png imgs/right/running_right.0013.png imgs/right/running_right.0014.png imgs/right/running_right.0015.png imgs/right/running_right.0016.png imgs/right/running_right.0017.png imgs/right/running_right.0018.png imgs/right/running_right.0019.png imgs/right/running_right.0020.png imgs/right/running_right.0021.png imgs/right/running_right.0022.png imgs/right/running_right.0023.png imgs/right/running_right.0024.png
python openPacker.py imgs/green.png imgs/dirt_green.png imgs/dirt.png imgs/cinema.png imgs/house_blue.png imgs/house_green.png imgs/house_red.png imgs/tilenew.png imgs/tree.png imgs/left/left.0000.png imgs/left/left.0001.png imgs/left/left.0002.png imgs/left/left.0003.png imgs/left/left.0004.png imgs/left/left.0005.png imgs/left/left.0006.png imgs/left/left.0007.png imgs/left/left.0008.png imgs/left/left.0009.png imgs/left/left.0010.png imgs/left/left.0011.png imgs/left/left.0012.png imgs/left/left.0013.png imgs/left/left.0014.png imgs/left/left.0015.png imgs/left/left.0016.png imgs/left/left.0017.png imgs/left/left.0018.png imgs/left/left.0019.png imgs/left/left.0020.png imgs/left/left.0021.png imgs/left/left.0022.png imgs/left/left.0023.png imgs/left/left.0024.png imgs/right/running_right.0000.png imgs/right/running_right.0001.png imgs/right/running_right.0002.png imgs/right/running_right.0003.png imgs/right/running_right.0004.png imgs/right/running_right.0005.png imgs/right/running_right.0006.png imgs/right/running_right.0007.png imgs/right/running_right.0008.png imgs/right/running_right.0009.png imgs/right/running_right.0010.png imgs/right/running_right.0011.png imgs/right/running_right.0012.png imgs/right/running_right.0013.png imgs/right/running_right.0014.png imgs/right/running_right.0015.png imgs/right/running_right.0016.png imgs/right/running_right.0017.png imgs/right/running_right.0018.png imgs/right/running_right.0019.png imgs/right/running_right.0020.png imgs/right/running_right.0021.png imgs/right/running_right.0022.png imgs/right/running_right.0023.png imgs/right/running_right.0024.png