Click here to Skip to main content
14,696,502 members
Articles » Web Development » HTML / CSS » General
Posted 11 Jan 2011


58 bookmarked

Image Sprites and CSS Classes Creator

Rate me:
Please Sign up or sign in to vote.
4.94/5 (22 votes)
17 Feb 2013CPOL
Create image sprites and its CSS classes on the fly

Although no one actually complained about it, I'm adding a download option without the compiled executable for those who may have trouble with the AntiVirus or other security policies

New v2.0  

I  decided to increment the major version of this tool as it implements new core features and actually brakes background compatibility with the previous command line commands.

So... what's new?

  • 3 Bin Packing algorithms to choose from that optimize the sprite image size
  • New and refactored command line commands to let you automate the generation process
  • Support for inner folders
  • Allow setting the output file names


Image Sprites are a very good way to feed your application some images. Basically, it consists of combining a set of images in a larger one and then just caching it. When you need one of the small images, all you have to know are the coordinates of it on the large one. With this technique, you just need to load one image for the entire application and reuse it, instead of loading each image at a time.

Here, I'll be covering the implementation with CSS used on WebSites, but you can use this technique wherever you want.

Why This?

Sure you can Google it and find a lot of matches telling you how to use sprites and CSS but where's the "no pain" way of building them and their CSS? All of them will tell you to use Photoshop of any other photo editing tool but this will always take a lot of time. That's when this cute little application comes in. It will generate the sprite image and its CSS in no time, and you can add images later and regenerate it without having to worry about breaking your code!

Using the Code

On the package, you'll find a compiled version and its source code.

Just drop the SpriteCreator.exe file on the folder that has the images to be included on the sprite and run it. DONE!

Assumptions, Limitations and Functionality

  • All image files on the folder will be added to the sprite no matter the size.
  • All the images on the folder will be included on the sprite.  
  • Only jpg, jpeg, png & bmp extensions are supported.
  • The name of the images is used on the CSS class name.
  • The spaces on images file name will be replaced with -
  • The result 3 files, one *.png (the sprite), *.css and *.html (the demo usage page) where * is the name you specified or a random GUID. 
  • CSS file includes a class that applies the background image to the element
  • Images are ordered using 3 different algorithms (more about them bellow).

Bin Packing Algorithms

To optimize the distribution of the images on the sprite I used the code from here:  Nuclex Game 

 The Bin packing algorithms are very well documented on their page.

All Bin Packing Algorithm credits must be given to these guys that saved me a lot of time by perfectly implementing these three good bin packing algorithms in C#. On my side I only removed the XNA dependencies and replaced them by pure System.Drawing objects.


This is a console application so you can pass some customization arguments.

  1. /h, /?, /help :: Help 
  2. /s :: Specify the images source directory path
  3. /d :: Destination dir path 
  4. /D :: Same as /d but creates the directory if it doesn't exist
  5. /f :: Destination file name 
  6. /F :: Same as /f but overrides the files if they already exist
  7. /cp :: CSS class name prefix
  8. /pl :: Specify the Bin Packaging Level (1, 2 (default) or 3)

Ex: SpriteCreator.exe /s Images /F SiteImages /cp "app-ui-"


  • v1.0 - The very beginning 
  • v1.1 - Support for images of different sizes and small improvements. 
  • v2.0 - Arguments refactoring and Bin Packing Algorithm usage. 


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Switzerland Switzerland
Senior IT Consultant working in Switzerland as Senior Software Engineer.

Find more at on my blog.

Comments and Discussions

QuestionThanks Pin
Murtaza Makda8-Dec-16 11:01
MemberMurtaza Makda8-Dec-16 11:01 
AnswerRe: Thanks Pin
AlexCode10-Dec-16 13:18
professionalAlexCode10-Dec-16 13:18 
QuestionRe my vote of 5 Pin
Bill Hardwick5-Sep-15 5:32
MemberBill Hardwick5-Sep-15 5:32 
AnswerRe: Re my vote of 5 Pin
AlexCode5-Sep-15 14:42
professionalAlexCode5-Sep-15 14:42 
QuestionPerfect except for not being able to specify the sprite class name Pin
PatrickDaniel5-Dec-13 9:40
MemberPatrickDaniel5-Dec-13 9:40 
AnswerRe: Perfect except for not being able to specify the sprite class name Pin
AlexCode5-Dec-13 22:00
professionalAlexCode5-Dec-13 22:00 
GeneralMy vote of 5 Pin
Kornel Regius26-Sep-13 11:06
professionalKornel Regius26-Sep-13 11:06 
Thank you for this great project.
GeneralRe: My vote of 5 Pin
Kornel Regius6-Oct-13 0:34
professionalKornel Regius6-Oct-13 0:34 
GeneralRe: My vote of 5 Pin
AlexCode7-Oct-13 8:15
professionalAlexCode7-Oct-13 8:15 
GeneralMy vote of 5 Pin
Prasad Khandekar31-Jul-13 3:15
professionalPrasad Khandekar31-Jul-13 3:15 
QuestionMy vote of 5 Pin
babydragoner2-Jul-13 0:04
Memberbabydragoner2-Jul-13 0:04 
GeneralMy vote of 5 Pin
gibmp_64@hotmail.com25-Feb-13 9:05
Membergibmp_64@hotmail.com25-Feb-13 9:05 
GeneralMy vote of 5 Pin
Industria Virtual23-Oct-12 13:17
professionalIndustria Virtual23-Oct-12 13:17 
GeneralRe: My vote of 5 Pin
AlexCode23-Oct-12 22:06
professionalAlexCode23-Oct-12 22:06 
GeneralGreat tool Pin
BeeWayDev18-Oct-12 3:44
MemberBeeWayDev18-Oct-12 3:44 
GeneralRe: Great tool Pin
AlexCode18-Oct-12 5:21
professionalAlexCode18-Oct-12 5:21 
Generalgood job Pin
windtear18-Oct-12 1:32
Memberwindtear18-Oct-12 1:32 
GeneralRe: good job Pin
AlexCode18-Oct-12 2:31
professionalAlexCode18-Oct-12 2:31 
GeneralMy vote of 5 Pin
Frederico Barbosa17-Oct-12 23:58
MemberFrederico Barbosa17-Oct-12 23:58 
GeneralRe: My vote of 5 Pin
AlexCode18-Oct-12 0:12
professionalAlexCode18-Oct-12 0:12 
BugImages overlapping Pin
David Latimer12-Oct-12 9:45
MemberDavid Latimer12-Oct-12 9:45 
GeneralRe: Images overlapping Pin
AlexCode14-Oct-12 3:35
professionalAlexCode14-Oct-12 3:35 
GeneralRe: Images overlapping Pin
David Latimer15-Oct-12 8:41
MemberDavid Latimer15-Oct-12 8:41 
GeneralRe: Images overlapping Pin
AlexCode17-Oct-12 21:16
professionalAlexCode17-Oct-12 21:16 
GeneralMy vote of 5 Pin
Bernd Degen26-Sep-12 3:02
MemberBernd Degen26-Sep-12 3:02 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.