sprite-factory-custom 1.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8a81c8fe6af96b06771bb7f78ab64aaa536e4e4b
+  data.tar.gz: 148fe646cc3d9c81518a5b029b9d2027fb795663
+SHA512:
+  metadata.gz: 60177384a302f97fa156797b768342a8897cb7c1e2f47b2745658d496fa46aa70d2c108f9f6038e08d33e0cd9286d103c122ef36a5540b98ce4a37e945a97672
+  data.tar.gz: 11daf41fed50c6e336c6ab4ba865d03684b8b9d0c56fce96abe653ec23135e0d033ed700a4d4a4d3d4b71ab2040d3f59888ec6921544617b2c02660a68032654

data/.gitignore

@@ -0,0 +1,11 @@
+*~
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.swp
+.sass-cache
+test/images/*.png
+test/images/*.css
+test/images/*.sass
+test/images/*.scss

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+#
+# NOTE: rmagick dependencies include:
+#
+#   $ sudo apt-get install imagemagick
+#   $ sudo apt-get install libmagickwand-dev
+
+group :development do
+  gem "chunky_png", "1.3.0"
+  gem "rmagick",    "2.13.2"
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011, 2012, 2013, 2014 Jake Gordon and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,351 @@
+Sprite Factory (v1.6.0)
+=======================
+
+The sprite factory is a ruby library that can be used to generate
+[CSS sprites](http://www.alistapart.com/articles/sprites). It combines
+individual image files from a directory into a single unified sprite image
+and creates an appropriate CSS stylesheet for use in your web application.
+
+The library provides:
+
+ * both a ruby API and a command line script
+ * many customizable options
+ * support for multiple layout algorithms - horizontal, vertical or [packed](http://codeincomplete.com/posts/2011/5/7/bin_packing/)
+ * support for any stylesheet syntax, including [CSS](http://www.w3.org/Style/CSS/) and [Sass](http://sass-lang.com/).
+ * support for any image library, including [RMagick](http://rmagick.rubyforge.org/) and [ChunkyPNG](https://github.com/wvanbergen/chunky_png).
+ * support for any css selector style, including :hover pseudo-class selectors
+ * support for pngcrush'n the generated image file
+ * compatible with Rails 3.1 asset pipeline
+
+
+Installation
+============
+
+    $ gem install sprite-factory
+
+An image library is also required. SpriteFactory comes with built in support for
+[RMagick](http://rmagick.rubyforge.org/) or [ChunkyPng](https://github.com/wvanbergen/chunky_png).
+
+RMagick is the most common image libary to use, installation instructions for ubuntu:
+
+    $ sudo aptitude install imageMagick libMagickWand-dev
+    $ sudo gem install rmagick
+
+ChunkyPng is lighter weight but only supports .png format:
+
+    $ gem install chunky_png
+
+SpriteFactory can also be easily extended to use the image library of your choice.
+
+Usage
+=====
+
+Use the `sf` command line script specifying the location of your images.
+
+    $ sf images/icons
+
+This will combine the individual image files within that directory and generate:
+
+ * images/icons.png
+ * images/icons.css
+
+You can also use the SpriteFactory class directly from your own code:
+
+    require 'sprite_factory'
+
+    SpriteFactory.run!('images/icons')
+
+The original image file name is used for the CSS class to show that image in HTML:
+
+    <img src='s.gif' class='high'>         # e.g. original image was high.png
+    <img src='s.gif' class='medium'>       # e.g. original image was medium.png
+    <img src='s.gif' class='low'>          # e.g. original image was low.png
+
+If original image files are included in sub-folders, the relative path
+name will be used for the CSS class to show that image in HTML:
+
+    <img src='s.gif' class='other_high'>   # e.g. original image was other/high.png
+    <img src='s.gif' class='other_medium'> # e.g. original image was other/medium.png
+    <img src='s.gif' class='other_low'>    # e.g. original image was other/low.png
+
+When using a framework such as Rails, you would usually DRY this up with a helper method:
+
+    def sprite_tag(name)
+      image_tag('s.gif', :class => name)
+    end
+
+>> NOTE: `s.gif` is the traditional name of a 1x1 pixel transparent .gif used as a
+dummy `src` when the true image comes from a css background attribute. Technically,
+for css sprites, you could just use a `div` with a class instead of an `img`, but
+to keep the markup semantic it is common to use an `img` tag with a dummy `src=s.gif`.
+
+Customization
+=============
+
+Much of the behavior can be customized by overriding the following options: 
+
+ - `:layout`       - specify layout algorithm (horizontal, vertical or packed)
+ - `:style`        - specify stylesheet syntax (css, scss or sass)
+ - `:library`      - specify image library to use (rmagick or chunkypng)
+ - `:selector`     - specify custom css selector (see below)
+ - `:cssurl`       - specify custom css url (see below)
+ - `:output_image` - specify output location for generated image (default: &lt;input folder&gt;.png)
+ - `:output_style` - specify output location for generated stylesheet (default: &lt;input folder&gt;.&lt;style&gt;)
+ - `:pngcrush`     - pngcrush the generated output image (if pngcrush is available)
+ - `:padding`      - add padding to each sprite
+ - `:margin`       - add margin to each sprite
+ - `:width`        - fix width of each sprite to a specific size
+ - `:height`       - fix height of each sprite to a specific size
+ - `:nocss`        - suppress generation of output stylesheet (`run!` returns css content as a string instead)
+ - `:nocomments`   - suppress generation of comments in output stylesheet
+
+Options can be passed as command line arguments to the `sf` script:
+
+    $ sf images/icons --style sass --layout packed
+
+Options can also be passed as the 2nd argument to the `#run!` method:
+
+    SpriteFactory.run!('images/icons', :style => :sass, :layout => :packed)
+
+You can see the results of many of these options by viewing the sample page that
+comes with the gem in `test/images/reference/index.html`.
+
+>> NOTE: only the common options are available via the command line script (to keep it simple). Specifically,
+the advanced `width`, `height`, and `nocss` options are only available via the Ruby interface.
+
+>> NOTE: the `width`, `height` and `padding` options are not particularly useful - you would be better off just
+making your source images have the correct dimensions by editing them appropriately in photoshop (or your editor of choice)
+
+>> NOTE: the `margin` option is used primarily to buffer each image in the generated sprite with > 1px margin to
+avoid images bleeding into each other when the browser needs to scale them (e.g. when user increases/decreases font size).
+
+Layout
+======
+
+The generated image can be laid out in a horizontal or a vertical strip by
+providing a `:layout` option (defaults to horizontal). A **new option in v1.2.0** is
+to use a  **:packed** layout which will attempt to generate an optimized packed
+square-ish layout.
+
+For more details on the bin-packing algorithm used:
+
+ * You can find a [description here](http://codeincomplete.com/posts/2011/5/7/bin_packing/)
+ * You can find a [demo here](http://codeincomplete.com/posts/2011/5/7/bin_packing/example/)
+
+Customizing the CSS Selector
+============================
+
+By default, the CSS generated is fairly simple. It assumes you will be using `<img>`
+elements for your sprites, and that the basename of each individual file is suitable for
+use as a CSS classname. For example, the following files:
+
+    images/icons/high.png
+    images/icons/medium.png
+    images/icons/low.png
+
+... when run with:
+
+    SpriteFactory.run!('images/icons')
+
+... will generate the following css:
+
+    img.high   { width: 16px; height: 16px; background: url(images/icons.png)   0px 0px no-repeat; }
+    img.medium { width: 16px; height: 16px; background: url(images/icons.png) -16px 0px no-repeat; }
+    img.low    { width: 16px; height: 16px; background: url(images/icons.png) -32px 0px no-repeat; }
+
+If you want to use different selectors for your rules, you can provide the `:selector` option. For
+example:
+
+    SpriteFactory.run!('images/icons', :selector => 'span.icon_')
+
+... will generate:
+
+    span.icon_high   { width: 16px; height: 16px; background: url(images/icons.png)   0px 0px no-repeat; }
+    span.icon_medium { width: 16px; height: 16px; background: url(images/icons.png) -16px 0px no-repeat; }
+    span.icon_low    { width: 16px; height: 16px; background: url(images/icons.png) -32px 0px no-repeat; }
+
+Customizing the CSS Selector Per Image
+======================================
+
+If you want to specify a custom selector for each individual image, then name the image files
+accordingly - the library will map '\_\_' (double underscore) to a single space ' ' in any source
+image filename. For example:
+
+    images/icons/div.foo__span.icon_alert.png
+    images/icons/div.bar__span.icon_alert.png
+
+... when run with:
+
+    SpriteFactory.run!('images/icons', :selector => 'div.example ')
+
+... will generate:
+
+    div.example div.foo span.icon_alert { ... first file   ... }
+    div.example div.bar span.icon_alert { ... second file  ... }
+    
+
+If you want to specify a psuedo class such as `:hover` for some of your images, the library will also
+map '--' (double dash) to a colon ':' in any source image filename. For example:
+
+    images/icons/alert.png
+    images/icons/alert--hover.png
+
+... when run with:
+
+    SpriteFactory.run!('images/icons', :selector => 'span.icon_')
+
+... will generate:
+
+    span.icon_alert       { ... first file  ... }
+    span.icon_alert:hover { ... second file ... }
+
+Customizing the CSS Image Url
+=============================
+
+Within the generated CSS file, it can be tricky to get the correct path to your unified
+sprite image. For example, you might be hosting your images on Amazon S3, or if you are
+building a Ruby on Rails application you might need to generate URL's using the `#image_path`
+helper method to ensure it gets the appropriate cache-busting query parameter.
+
+By default, the SpriteFactory generates simple url's that contain the basename of the
+unified sprite image, e.g:
+
+    SpriteFactory.run('icons')
+
+    # generates: url(icons.png)
+
+...but you can control the generation of these url's using the `:cssurl` option:
+
+For most CDN's, you can prepend a simple string to the image name:
+
+    SpriteFactory.run('icons',
+                      :cssurl => "http://s3.amazonaws.com/")
+
+    # generates:  url(http://s3.amazonaws.com/icons.png)
+
+For more control, a simple token replacement can be performed using the $IMAGE token. For example, to generate calls
+to custom Sass helper functions, such as those provided by [sass-rails](https://github.com/rails/sass-rails) plugin:
+
+    SpriteFactory.run('icons',
+                      :cssurl => "image-url('$IMAGE')")
+
+    # generates:  image-url('icons.png')
+
+
+For full control, you can provide a lambda function and generate your own values:
+
+    SpriteFactory.run('icons',
+                       :cssurl => lambda{|image| "url(#{image_path(image)})" })
+
+    # generates:   url(/path/to/my/images/icons.png?v123456)
+
+>> NOTE: the `:cssurl` option replaces `:csspath` from earlier versions. The previous option only let you
+customize the path inside of the generated `url(...)`, while this new option allows you to customize the
+entire value, including the outer `url(...)` itself.
+
+Customizing the entire CSS output 
+=================================
+
+If you want **complete** control over the generated styles, you can pass a block to the `run!` method.
+
+The block will be provided with information about each image, including the generated css attributes. 
+Whatever content the block returns will be inserted into the generated css file.
+
+    SpriteFactory.run!('images/timer') do |images|
+      rules = []
+      rules << "div.running img.button { cursor: pointer; #{images[:running][:style]} }"
+      rules << "div.stopped img.button { cursor: pointer; #{images[:stopped][:style]} }"
+      rules.join("\n")
+    end
+
+The `images` argument is a hash, where each key is the basename of an image file, and the
+value is a hash of image metadata that includes the following:
+
+ * `:style`  - the default generated style
+ * `:cssx`   - the css sprite x position
+ * `:cssy`   - the css sprite y position
+ * `:cssw`   - the css sprite width
+ * `:cssh`   - the css sprite height
+ * `:x`      - the image x position
+ * `:y`      - the image y position
+ * `:width`  - the image width
+ * `:height` - the image height
+
+>> NOTE: the image coords can differ form the css sprite coords when padding/margin or fixed width/height options are specified)
+
+Using sprite-factory with the Rails asset pipeline
+==================================================
+
+The sprite-factory gem plays nice with the Rails asset pipeline with a few simple steps:
+
+Add the sprite-factory to your Gemfile, including your chosen image library dependency:
+
+    group :assets do
+      gem 'sprite-factory', '>= 1.5.2'
+      gem 'rmagick'
+    end
+
+Store your images in Rails 3.1 `app/assets/images` sub-folders, e.g
+
+    app/assets/images/avatars/*.png
+    app/assets/images/icons/*.png
+    ...
+
+Create a Rake task for regenerating your sprites, e.g. in `lib/tasks/assets.rake`
+
+    require 'sprite_factory'
+
+    namespace :assets do
+      desc 'recreate sprite images and css'
+      task :resprite => :environment do 
+        SpriteFactory.cssurl = "image-url('$IMAGE')"    # use a sass-rails helper method to be evaluated by the rails asset pipeline
+        SpriteFactory.run!('app/assets/images/avatars', :output_style => 'app/assets/stylesheets/avatars.css.erb')
+        SpriteFactory.run!('app/assets/images/icons',   :output_style => 'app/assets/stylesheets/icons.css.erb')
+        # ... etc ...
+      end
+    end
+
+Run the rake task
+
+    bundle exec rake assets:resprite
+
+Generates
+
+ * sprite images in `app/assets/images`
+ * sprite styles in `app/assets/stylesheets` - automatically picked up by the asset pipeline and included in your generated application.css
+
+You can find out more here:
+
+ * [Sprite Factory and the Rails Asset Pipeline](http://codeincomplete.com/posts/2011/8/6/sprite_factory_1_4_1/)
+
+Extending the Library
+=====================
+
+The sprite factory library can be extended in a number of other ways.
+
+ * provide a custom layout algorithm in the `SpriteFactory::Layout` module.
+ * provide a custom style generator in the `SpriteFactory::Style` module.
+ * provide a custom image library in the `SpriteFactory::Library` module.
+
+_(see existing code for examples of each)._
+
+License
+=======
+
+See [LICENSE](https://github.com/jakesgordon/sprite-factory/blob/master/LICENSE) file.
+
+Credits
+=======
+
+Thanks to my employer, [LiquidPlanner](http://liquidplanner.com) for allowing me to take this idea from our
+online project management web application and release it into the wild.
+
+Contact
+=======
+
+If you have any ideas, feedback, requests or bug reports, you can reach me at
+[jake@codeincomplete.com](mailto:jake@codeincomplete.com), or via
+my website: [Code inComplete](http://codeincomplete.com).
+
+
+

data/RELEASE_NOTES.md

@@ -0,0 +1,60 @@
+March 16th 2014 - v1.6.0
+------------------------
+
+ * Added raw ImageMagick driver can be used without RMagick gem (courtesy of @willglynn - Cheers!)
+ * Exposed `padding` and `margin` support to the cli interface (courtesy of @miguelgonz - Cheers!)
+
+
+February 21st 2013 - v1.5.3
+---------------------------
+ * bugfix: added back `:selector` when providing attributes for custom style generators (it was accidentally removed in v1.5.2)
+
+January 13th 2013 - v1.5.2
+--------------------------
+ * replaced `:csspath` option with `:cssurl` [issue #21](https://github.com/jakesgordon/sprite-factory/issues/21)
+ * ordered css rules by pseudoclass importance [issue #20](https://github.com/jakesgordon/sprite-factory/pull/20)
+ * added support for .ico files when using rmagick [issue #18](https://github.com/jakesgordon/sprite-factory/pull/18)
+
+June 11th 2012 - v1.5.1
+-----------------------
+ * added a new `:return => :images` option for callers that want access to the detailed `images` hash instead of the generated css content
+
+May 10th 2012 - v1.5.0
+----------------------
+ * @halida added a new `margin` option to (optionally) separate images in generated spritesheet to avoid 'bleeding' when browser scales the sprite (e.g. when user increases text size)
+ * added `padding` support for `packed` layout
+ * added `margin` support for `packed` layout
+ * added support for using source image filename as automatic css selector [issue #12](https://github.com/jakesgordon/sprite-factory/issues/12)
+ * added support for `:hover` (and other pseudo-class) selectors [issue #14](https://github.com/jakesgordon/sprite-factory/issues/14)
+
+February 29th 2012 - v1.4.2
+---------------------------
+ * added support for `:nocomments => true` to suppress comments in generated output stylesheet
+ * added support for images in subfolders - fixes [github issue #11](https://github.com/jakesgordon/sprite-factory/issues/11)
+
+August 5th 2011 - v1.4.1
+------------------------
+ * added support for `:style => :scss` to generate .scss file (even though content will be almost exactly same as .css style)
+ * deprecated `:output` option and replaced it with 2 new explicit `:output_image` and `:output_style` options
+ * updated RELEASE NOTES to include setup for use with Rails 3.1 asset pipeline
+
+Auguest 5th 2011 - v1.4.0
+-------------------------
+ * (not available)
+
+July 9th 2011 - v1.3.0
+----------------------
+
+ * source image file extensions now treated in case INsensitive manner (e.g. we detect both .PNG, .png and .Png)
+ * added `:nocss => true` option to suppress generation of output css file (caller should use `run!` return value instead - it contains the generated css content as a string)
+
+May 8th 2011 - v1.2.0
+---------------------
+
+ * added new `:layout => :packed` option to use bin-packing algorithm for generating rectangular sprite sheet
+ * added pngcrush support
+
+April 29th 2011 - v1.0.0
+------------------------
+
+ * original version

data/Rakefile

@@ -0,0 +1,73 @@
+require 'rake/testtask'
+
+#------------------------------------------------------------------------------
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+
+#------------------------------------------------------------------------------
+
+desc "run a console with SpriteFactory loaded"
+task :console do
+  system "irb -r #{File.expand_path('lib/sprite_factory', File.dirname(__FILE__))}"
+end
+
+#------------------------------------------------------------------------------
+
+desc "regenerate test reference images"
+task :reference do
+
+  require File.expand_path('lib/sprite_factory', File.dirname(__FILE__))
+
+  regenerate = lambda do |input, options = {}, &block|
+    output = options[:output] || input
+    SpriteFactory.run!(input, {:report => true}.merge(options), &block)
+    FileUtils.mv(output + "." + (                   :png).to_s, 'test/images/reference')
+    FileUtils.mv(output + "." + (options[:style] || :css).to_s, 'test/images/reference')
+  end
+
+  regenerate.call('test/images/regular')
+  regenerate.call('test/images/regular', :output => 'test/images/regular.horizontal', :selector => 'img.horizontal_', :layout => :horizontal)
+  regenerate.call('test/images/regular', :output => 'test/images/regular.vertical',   :selector => 'img.vertical_',   :layout => :vertical)
+  regenerate.call('test/images/regular', :output => 'test/images/regular.packed',     :selector => 'img.packed_',     :layout => :packed, :padding => 10, :margin => 10)
+  regenerate.call('test/images/regular', :output => 'test/images/regular.padded',     :selector => 'img.padded_',     :padding => 10)
+  regenerate.call('test/images/regular', :output => 'test/images/regular.margin',     :selector => 'img.margin_',     :margin => 10)
+  regenerate.call('test/images/regular', :output => 'test/images/regular.fixed',      :selector => 'img.fixed_',      :width => 100, :height => 100)
+  regenerate.call('test/images/regular', :output => 'test/images/regular.sassy',      :selector => 'img.sassy_',      :style => :sass)
+
+  regenerate.call('test/images/irregular')
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.horizontal', :selector => 'img.horizontal_', :layout => :horizontal)
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.vertical',   :selector => 'img.vertical_',   :layout => :vertical)
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.packed',     :selector => 'img.packed_',     :layout => :packed, :padding => 10, :margin => 10)
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.padded',     :selector => 'img.padded_',     :padding => 10)
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.margin',     :selector => 'img.margin_',     :margin => 10)
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.fixed',      :selector => 'img.fixed_',      :width => 100, :height => 100)
+  regenerate.call('test/images/irregular', :output => 'test/images/irregular.sassy',      :selector => 'img.sassy_',      :style => :sass)
+
+  regenerate.call('test/images/hover', :output => 'test/images/hover', :selector => 'div.hover ', :style => :css)
+
+  regenerate.call('test/images/custom', :output => 'test/images/custom') do |images|
+    rules = []
+    rules << "div.running img.button { cursor: pointer; #{images[:running][:style]} }"
+    rules << "div.stopped img.button { cursor: pointer; #{images[:stopped][:style]} }"
+    rules.join("\n")
+  end
+
+  regenerate.call('test/images/formats', :library => :rmagick)
+
+end
+
+#------------------------------------------------------------------------------
+
+desc "convert reference test sass files to css"
+task :sass do
+
+  `sass 'test/images/reference/regular.sassy.sass'   'test/images/reference/regular.sassy.css'`
+  `sass 'test/images/reference/irregular.sassy.sass' 'test/images/reference/irregular.sassy.css'`
+
+end
+
+#------------------------------------------------------------------------------
+

data/bin/sf

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.push File.expand_path("../lib", File.dirname(__FILE__)) # add sprite factory library to load path
+
+require 'sprite_factory'
+require 'optparse'
+
+options   = { :report => true }
+op        = OptionParser.new
+op.banner = "#{SpriteFactory::DESCRIPTION}\nUsage: sprite <dir> [options]"
+
+op.on("-h", "--help") do
+  puts op.to_s
+  exit
+end
+
+op.on("-v", "--version") do
+  puts SpriteFactory::VERSION
+  exit
+end
+
+layout_help       = "specify layout orientation   ( horizontal, vertical, packed )"
+style_help        = "specify stylesheet syntax  ( css, scss, sass )"
+library_help      = "specify image library to use ( rmagic, chunkypng )"
+selector_help     = "specify custom selector to use for each css rule ( default: 'img.' )"
+cssurl_help       = "specify custom string to use for css image urls ( default: 'url(output image basename)' )"
+output_image_help = "specify output location for generated image ( default: <input folder>.png )"
+output_style_help = "specify output location for generated stylesheet ( default: <input folder>.<style>)"
+pngcrush_help     = "use pngcrush to optimize generated image"
+padding_help      = "add padding to each sprite"
+margin_help       = "add margin to each sprite"
+nocomments_help   = "suppress comments in generated stylesheet"
+custom_styles_help   = "Add custom styles for each sprites (E.g.: --custom-styles='display: inline-block;'"
+
+op.on("--layout       [ORIENTATION]", layout_help)       {|value| options[:layout]       = value }
+op.on("--style        [STYLE]",       style_help)        {|value| options[:style]        = value }
+op.on("--library      [LIBRARY]",     library_help)      {|value| options[:library]      = value }
+op.on("--selector     [SELECTOR]",    selector_help)     {|value| options[:selector]     = value }
+op.on("--cssurl       [CSSURL]",      cssurl_help)       {|value| options[:cssurl]       = value }
+op.on("--output-image [PATH]",        output_image_help) {|value| options[:output_image] = value }
+op.on("--output-style [PATH]",        output_style_help) {|value| options[:output_style] = value }
+op.on("--custom-styles [STYLES]",     custom_styles_help) {|value| options[:custom_style] = value }
+op.on("--pngcrush",                   pngcrush_help)     {|value| options[:pngcrush]     = value }
+op.on("--padding [PIXELS]",           padding_help)      {|value| options[:padding]      = value.to_i }
+op.on("--margin [PIXELS]",            margin_help)       {|value| options[:margin]       = value.to_i }
+op.on("--nocomments",                 nocomments_help)   {|value| options[:nocomments]   = true  }
+
+begin
+  op.parse!(ARGV)
+  raise "a single argument must be specified containing images to be sprited" if ARGV.empty?
+  SpriteFactory.run!(ARGV[0], options)
+rescue Exception => ex
+  puts ex.message
+  exit
+end
+
+

data/lib/sprite_factory/layout/horizontal.rb

@@ -0,0 +1,44 @@
+module SpriteFactory
+  module Layout
+    module Horizontal
+
+      def self.layout(images, options = {})
+        width      = options[:width]
+        height     = options[:height]
+        hpadding   = options[:hpadding] || 0
+        vpadding   = options[:vpadding] || 0
+        hmargin    = options[:hmargin]  || 0
+        vmargin    = options[:vmargin]  || 0
+        max_height = height || (2 *(vpadding + vmargin) + images.map{|i| i[:height]}.max)
+        x = 0
+        images.each do |i|
+
+          if width
+            i[:cssw] = width
+            i[:cssx] = x
+            i[:x]    = x + (width - i[:width]) / 2
+          else
+            i[:cssw] = i[:width]  + (2 * hpadding)   # image width plus padding
+            i[:cssx] = x + hmargin                   # anchored at x
+            i[:x]    = i[:cssx] + hpadding           # image drawn offset to account for padding
+          end
+
+          if height
+            i[:cssh] = height
+            i[:cssy] = 0
+            i[:y]    = 0 + (height - i[:height]) / 2
+          else
+            i[:cssh] = i[:height] + (2 * vpadding)   # image height plus padding
+            i[:cssy] = (max_height - i[:cssh]) / 2   # centered vertically
+            i[:y]    = i[:cssy] + vpadding           # image drawn offset to account for padding
+          end
+
+          x += i[:cssw] + 2 * hmargin
+
+        end 
+        { :width  => x, :height => max_height }
+      end
+
+    end
+  end
+end