Simple image atlas maker for SpriteBatch

[Azhukar]

Pass it a table with imageData, it will return a table with quads corresponding do the imagaData received and an image of the atlas to use in SpriteBatches. The table keys used in the quads table will be identical to those used in the passed imageData table. Images are automatically padded to prevent quad bleeding.

Use however you like. Download link.

Code: Select all

local newImageAtlas = require("newImageAtlas")
local atlasQuads,atlasImage = newImageAtlas(imageDataTable)
local spriteBatch = love.graphics.newSpriteBatch(atlasImage)
spriteBatch:add(atlasQuads[key],0,0)

Edit: made it fit the images a little bit more rationally.

[pedrosgali]

Pretty cool, I actually just wrote one of these last week. Where was this lib 2 weeks ago lol. Does it use any kind of sorting algorithm to maximize space usage on the atlas? If so what approach did you use?

[Azhukar]

Does it use any kind of sorting algorithm to maximize space usage on the atlas? If so what approach did you use?

It sorts all images as rectangles from largest surface area to smallest and adds them to the atlas in that order always next to an already added rectangle. The first free rectangle side it finds is used, it checks sides in order top->left->right>bottom. Atlas width is based on the square root of the total image surface area, height can vary.

[zorg]

Any reason why the attached example image has quads that don't have at least a 1px padding?

[Azhukar]

Any reason why the attached example image has quads that don't have at least a 1px padding?

The padding is the same color as the border pixels of the actual image, which is the whole point of the padding - to prevent or rather hide bleeding when scaled/rotated. Since the example is just single color images, it might seem as if there is none.

[zorg]

Yeah, that makes sense!