view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN

OCBNET-WebSprite
================

Perl Package to generate spritesets from annotated css.

PREREQUISITE
============

You need GD, Image::Magick or Graphics::Magick installed!

INSTALL
=======

[![Build Status](https://travis-ci.org/mgreter/OCBNET-WebSprite.svg?branch=master)](https://travis-ci.org/mgreter/OCBNET-WebSprite)
[![Coverage Status](https://img.shields.io/coveralls/mgreter/OCBNET-WebSprite.svg)](https://coveralls.io/r/mgreter/OCBNET-WebSprite?branch=master)

Standard process for building & installing modules:

```
perl Build.PL
./Build
./Build test
./Build install
```

If you're on a platform (Windows) that doesn't require the "./" notation:

```
perl Build.PL
Build
Build test
Build install
```

Or, if [cpanminus](http://search.cpan.org/~miyagawa/App-cpanminus/) is available:

```
cpanm git://github.com/mgreter/OCBNET-CSS3.git
cpanm git://github.com/mgreter/OCBNET-WebSprite.git
```

You need [Strawberry Perl](http://strawberryperl.com/) and
[GraphicsMagick](http://www.graphicsmagick.org/download.html) on
Windows.

Preface
-------

In early 2013 I had the pleasure to replace the manual process of creating
spritesets with a better solution. It was pretty fast decided to go with
http://csssprites.org/. The feature that convinced us, was the comment
annotation syntax. Most spriteset generators take a bunch of images and
force a certain way on the developer how to use them. This is a perl
implementation that goes (IMHO) a little further than smartsprites.

Features
--------

 - Add WebSprite to already existing css files (postprocessor).
 - Configuration is embeded inside the css file (as comments).
 - Supports all combinations of fixed and flexible dimension, background
 sizing (scaling for retina) and background repeat.

Command Line Tool
-----------------

```
websprite [options] [source]
```