Glue is a simple command line tool to generate sprites.


Keywords
glue, sprites, css, cocos2d
License
BSD-3-Clause
Install
pip install glue==0.11.1

Documentation

Glue

https://badge.fury.io/py/glue.png https://travis-ci.org/jorgebastida/glue.png?branch=master https://coveralls.io/repos/jorgebastida/glue/badge.png?branch=master https://pypip.in/d/glue/badge.png

Glue is a simple command line tool to generate sprites:

$ glue source output

Features

Example

Using the gorgeous famfamfam icons (4.2Mb) you will get the following icons.png (401Kb).

https://github.com/jorgebastida/glue/raw/master/docs/img/famfamfam1.png

And also an icons.css with all the necessary CSS classes for this sprite:

.sprite-icons-zoom_out{ background:url('icons.png'); top:0; left:0; no-repeat;}
.sprite-icons-zoom_in{ background:url('icons.png'); top:0; left:-16; no-repeat;}
.sprite-icons-zoom{ background:url('icons.png'); top:-16; left:0; no-repeat;}
.sprite-icons-xhtml_valid{ background:url('icons.png'); top:-16; left:-16; no-repeat;}
...

Do you want to know more? Visit the quickstart guide: http://glue.readthedocs.org/en/latest/quickstart.html

Contribute

  • Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
  • Write a test which shows that the bug was fixed or that the feature works as expected.
    • Use python setup.py test
  • Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS.

Is your company using glue?

We are creating a list of companies using glue in production. If your company use glue, please send me an email or send me a message to @jorgebastida . I would really appreciate it.

We need your help

There are several features that glue users would love to have... but they require a substancial amount of work and dedication, so we are looking for feature-sponsors! If you want to lead the development/testing of any of the following features, please contact Jorge Bastida.

Here you have some examples:

  • Windows support (I'm not a Windows user, glue needs somebody who care about how glue works on Windows and write down some installation instructions).
  • Cocos2d Format (Already exists, but we need somebody to give it some love).
  • New Formats (After 0.9, glue is ready to accept new output formats - If you want to create a new format, contact me).
  • Binary packaging for OSX and Windows (For some users it would be really cool if they were able to download an already packaged binary version).