nfq-alpha/sprite-bundle

Generate sprites with PHP and twig templates

Nfq Sprite Generator Bundle

Generate sprite images and stylesheets with plain PHP and GD2 (no 3rd party dependencies), _(*1)

Installation

Dependancies

PHP extension GD2, _(*2)

Get the bundle

Add this in your composer.json, _(*3)

{
    "require": {
        "nfq-alpha/sprite-bundle": "dev-master@dev"
    }
}

and then run, _(*4)

php composer.phar update

Add the classes to your Kernel

new SpriteGenerator\SpriteGeneratorBundle(),

Configuration

You have to configure your sprites by adding lines to config.yml:, _(*5)

sprite_generator:
    sprites:
        spritename:
            inDir: %kernel.root_dir%/../src/Resources/public/img/sprites/
            outImage: %kernel.root_dir%/../src/Resources/public/img/sprite2.png
            outCss: %kernel.root_dir%/../src/Resources/public/scss/_sprites2.scss
            relativeImagePath: ../bundles/img/
            padding: 5
            spriteClass: sprite
            cssFormat: sass
            imagePositioning: one-column
            imageGenerator: gd2
        another_spritename:
            inDir: %kernel.root_dir%/../src/Resources/public/img/sprites/
            outImage: %kernel.root_dir%/../src/Resources/public/img/sprite2.png
            outCss: %kernel.root_dir%/../src/Resources/public/scss/_sprites2.scss
            relativeImagePath: ../bundles/img/
            padding: 5
            spriteClass: sprite_another
            cssFormat: sass
            imagePositioning: one-column
            imageGenerator: gd2

Generate sprites

Generate all your sprites :, _(*6)

$ php app/console nfq:sprite:generate

Generate one sprite :, _(*7)

$ php app/console nfq:sprite:generate spritename