Click here to Skip to main content
Click here to Skip to main content
Go to top

Image Sprites and CSS Classes Creator

, 17 Feb 2013
Rate this:
Please Sign up or sign in to vote.
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

QuestionPerfect except for not being able to specify the sprite class name PinmemberPatrickDaniel5-Dec-13 8:40 
AnswerRe: Perfect except for not being able to specify the sprite class name PinprofessionalAlexCode5-Dec-13 21:00 
GeneralMy vote of 5 PinmemberKornel Regius26-Sep-13 10:06 
GeneralRe: My vote of 5 PinmemberKornel Regius5-Oct-13 23:34 
GeneralRe: My vote of 5 PinprofessionalAlexCode7-Oct-13 7:15 
GeneralMy vote of 5 PinprofessionalPrasad Khandekar31-Jul-13 2:15 
QuestionMy vote of 5 Pinmemberbabydragoner1-Jul-13 23:04 
GeneralMy vote of 5 PinmemberXabring25-Feb-13 8:05 
GeneralMy vote of 5 PinmemberIndustria Virtual23-Oct-12 12:17 
GeneralRe: My vote of 5 PinmemberAlexCode23-Oct-12 21:06 
GeneralGreat tool PinmemberBeeWayDev18-Oct-12 2:44 
GeneralRe: Great tool PinmemberAlexCode18-Oct-12 4:21 
Generalgood job Pinmemberwindtear18-Oct-12 0:32 
GeneralRe: good job PinmemberAlexCode18-Oct-12 1:31 
GeneralMy vote of 5 PinmemberFrederico Barbosa17-Oct-12 22:58 
GeneralRe: My vote of 5 PinmemberAlexCode17-Oct-12 23:12 
BugImages overlapping PinmemberDavid Latimer12-Oct-12 8:45 
GeneralRe: Images overlapping PinmemberAlexCode14-Oct-12 2:35 
GeneralRe: Images overlapping PinmemberDavid Latimer15-Oct-12 7:41 
GeneralRe: Images overlapping PinmemberAlexCode17-Oct-12 20:16 
GeneralMy vote of 5 PinmemberBernd Degen26-Sep-12 2:02 
QuestionThank you PinmemberBernd Degen25-Sep-12 21:35 
AnswerRe: Thank you PinmemberAlexCode25-Sep-12 22:28 
GeneralRe: Thank you PinmemberBernd Degen25-Sep-12 22:43 
GeneralRe: Thank you PinmemberAlexCode26-Sep-12 2:13 

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

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

| Advertise | Privacy | Mobile
Web04 | 2.8.140926.1 | Last Updated 18 Feb 2013
Article Copyright 2011 by AlexCode
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid