css-spriter 0.9.2

data/examples/sprites/words/.mtimes

@@ -0,0 +1,4 @@
+./words/set.png	1258120615
+./words/latitude.png	1258120615
+./words/specified.png	1258120615
+./words/of.png	1258120615

data/examples/sprites/words/fragment.css

@@ -0,0 +1,28 @@
+  .words_latitude {
+    background: transparent url(/words/sprite.png) 0px 0px no-repeat;
+    width:66;
+    height:21;
+    text-indent:-5000px;
+  }
+
+  .words_of {
+    background: transparent url(/words/sprite.png) -66px 0px no-repeat;
+    width:19;
+    height:21;
+    text-indent:-5000px;
+  }
+
+  .words_set {
+    background: transparent url(/words/sprite.png) -85px 0px no-repeat;
+    width:26;
+    height:21;
+    text-indent:-5000px;
+  }
+
+  .words_specified {
+    background: transparent url(/words/sprite.png) -111px 0px no-repeat;
+    width:70;
+    height:21;
+    text-indent:-5000px;
+  }
+

data/examples/sprites/words/sprite.css

@@ -0,0 +1,28 @@
+  .words_of {
+    background: transparent url(/examples/sprites/words/sprite.png) -66px 0px no-repeat;
+    width:19;
+    height:21;
+    text-indent:-5000px;
+  }
+
+  .words_set {
+    background: transparent url(/examples/sprites/words/sprite.png) -85px 0px no-repeat;
+    width:26;
+    height:21;
+    text-indent:-5000px;
+  }
+
+  .words_specified {
+    background: transparent url(/examples/sprites/words/sprite.png) -111px 0px no-repeat;
+    width:70;
+    height:21;
+    text-indent:-5000px;
+  }
+
+  .words_latitude {
+    background: transparent url(/examples/sprites/words/sprite.png) 0px 0px no-repeat;
+    width:66;
+    height:21;
+    text-indent:-5000px;
+  }
+

data/init.rb

@@ -0,0 +1 @@
+# Include hook code here

data/lib/css-spriter.rb

@@ -0,0 +1,16 @@
+require 'zlib'
+
+require 'css-spriter/png/file_header'
+require 'css-spriter/png/parser'
+require 'css-spriter/png/filters'
+require 'css-spriter/png/chunk'
+require 'css-spriter/png/ihdr'
+require 'css-spriter/png/idat'
+require 'css-spriter/png/iend'
+require 'css-spriter/png/image'
+require 'css-spriter/sprite'
+require 'css-spriter/directory_processor'
+require 'css-spriter/stylesheet_builder'
+require 'css-spriter/processor'
+require 'css-spriter/mtime_tracker'
+require 'css-spriter/image_data'

data/lib/css-spriter/directory_processor.rb

@@ -0,0 +1,94 @@
+class DirectoryProcessor
+
+  DEFAULT_TEMPLATE = <<-EOF
+  .<name>_<image_name> {
+    background: transparent url(<image_loc>) <offset>px 0px no-repeat;
+    width:<width>;
+    height:<height>;
+    text-indent:-5000px;
+  }
+
+  EOF
+
+  def initialize(dir, options = {})
+    @options = options
+    @dir = dir
+    @sprite = Sprite.new
+    @tracker = MtimeTracker.new(@dir,
+                                :exclude => ['sprite.css', 'fragment.css', 'sprite.png'])
+  end
+
+  def images
+    Dir.glob(@dir + "/*.png").reject{|i| i.match /sprite\.png/}
+  end
+
+  def write
+    return unless @tracker.has_changes?
+    images.each {|f| @sprite.append(PNG::Image.image_data(f))}
+    @sprite.write(sprite_file)
+    File.open(css_file, 'w') do |f|
+      f.write(css)
+    end
+    @tracker.update
+  end
+
+  def cleanup
+    File.delete(sprite_file) rescue nil
+    File.delete(css_file) rescue nil
+    @tracker.cleanup
+  end
+
+  def sprite_file
+    @dir + "/sprite.png"
+  end
+
+  def css_file
+    @dir + "/fragment.css"
+  end
+
+  def dir_name
+    @dir.split('/').last
+  end
+
+  def image_loc
+    #TODO: Lame!
+
+    dir = truncate_abs_path
+    base = ("/" + dir + "/sprite.png").gsub(/^\/.\//, "/").gsub("//", "/")
+    source = @options[:source]
+    base = base.gsub(source, "") if source && source != "."
+    base = @options[:path_prefix] + base if @options[:path_prefix]
+    base
+  end
+
+  def truncate_abs_path
+    return @dir unless @options[:source]
+    path_elements = @options[:source].split('/')
+    path_elements.pop #we want to remove everything above the root 
+    to_truncate = path_elements.join("/")
+    @dir.gsub(to_truncate, "")
+  end
+
+  def template_file
+    @dir + "/template.css"
+  end
+
+  def template
+    if File.exists?(template_file)
+      return File.read(template_file)
+    end
+    return DEFAULT_TEMPLATE
+  end
+
+  def css
+    @sprite.locations.inject("") do |out, image|
+      image_name, properties = image
+      out << template.gsub("<name>", dir_name).
+             gsub("<image_name>", image_name.to_s).
+             gsub("<width>", properties[:width].to_s).
+             gsub("<height>", properties[:height].to_s).
+             gsub("<offset>", properties[:x].to_s).
+             gsub("<image_loc>", image_loc)
+    end
+  end
+end

data/lib/css-spriter/image_data.rb

@@ -0,0 +1,128 @@
+require 'enumerator'
+
+module CssSpriter
+  class ImageData
+    RGB_WIDTH = 3
+    RGBA_WIDTH = 4
+
+    def initialize(options = {})
+      @data = (options.delete :data) || []
+      @properties = options
+    end
+
+    def name; @properties[:name] || "default"; end
+    def scanline_width; @properties[:scanline_width]; end
+    def width; scanline_width / pixel_width; end
+    def pixel_width; @properties[:pixel_width]; end
+
+    # need better checks, because currently compatible is
+    # similar color type, or depth.. maybe it doesn't matter...
+    def compatible?(image)
+      self.pixel_width == image.pixel_width
+    end
+
+    def to_s
+      "#{name} pixel width: #{pixel_width}"
+    end
+
+    def last_scanline(idx)
+      last_row_index = idx - 1
+      (last_row_index < 0 ? [] : @data[last_row_index])
+    end
+
+    def merge_left( other )
+      merged = ImageData.new(@properties.merge(:scanline_width => self.scanline_width + other.scanline_width,
+                                               :name => "#{self.name}_#{other.name}"))
+      other.each_with_index do |row, idx|
+        merged[idx] = row + self[idx]
+      end
+      merged
+    end
+
+    def fill_to_height( desired_height )
+      return self if desired_height == height
+
+      img = ImageData.new(@properties.merge(:data => @data.clone))
+      empty_row = [0] * ( scanline_width )
+
+      ( desired_height - height ).times do
+        img << empty_row
+      end
+      img
+    end
+
+    def to_rgba( alpha_value=255 )
+      # test that conversion updates pixel width, scanline width
+
+      return self if pixel_width == RGBA_WIDTH
+
+      # so ruby 1.9 has different ideas then 1.8 on how Enumerable should work
+      # 1.9 returns Enumerable object if no block given
+      # 1.8 complains if no block, unless using enum_x methods
+      slice_method = (RUBY_VERSION.include?( "1.9" )) ? :each_slice : :enum_slice
+
+      rgba_data = @data.map do |row|
+        pixels = row.send( slice_method, RGB_WIDTH )
+        pixels.inject([]){|result, pixel| result + pixel + [alpha_value] }
+      end
+
+      ImageData.new( :data => rgba_data,
+                     :pixel_width => 4,
+                     :scanline_width => (@properties[:scanline_width] / RGB_WIDTH) * RGBA_WIDTH,
+                     :name => name)
+    end
+
+    def [](row)
+      @data[row]
+    end
+
+    def []=(idx, row_data)
+      @data[idx] = row_data
+    end
+
+    def scanline(row)
+      self[row]
+    end
+
+    def empty?
+      @data.empty?
+    end
+
+    def height
+      size
+    end
+
+    def size
+      @data.size
+    end
+
+    def last
+      @data.last
+    end
+
+    def <<(row)
+      @data << row
+      self
+    end
+
+    def each(&block)
+      @data.each &block
+    end
+
+    def each_with_index(&block)
+      @data.each_with_index(&block)
+    end
+
+    def flatten!
+      @data.flatten!
+    end
+
+    def pack(*args)
+      @data.pack(*args)
+    end
+
+    def == (other)
+      @data == other
+    end
+  end
+end

data/lib/css-spriter/mtime_tracker.rb

@@ -0,0 +1,79 @@
+class MtimeTracker
+  def initialize(dir, options = {})
+    @dir = dir
+    @options = options
+  end
+
+  def cleanup
+    File.delete(mtime_file) rescue nil
+  end
+
+  def fresh?
+    not File.exists?(mtime_file)
+  end
+
+  def files
+    return @files if @files
+    @files = without_exclusions(Dir.glob(@dir + "/**/*"))
+  end
+
+  def without_exclusions(files)
+    return files unless @options[:exclude]
+    exclusions = [@options[:exclude]].flatten
+    files.select{|f| not exclusions.any?{|e| f.match e}}
+  end
+
+  def current_mtimes
+    @current ||= files.inject({}) do |map, f|
+      map[f] = File.mtime(f).to_i; map
+    end
+  end
+
+  def file_changed?(file)
+    mtimes[file] != current_mtimes[file]
+  end
+
+  def mtimes
+    return @mtimes if @mtimes
+    return {} unless File.exists?(mtime_file)
+    @mtimes = read_mtimes
+  end
+
+  def read_mtimes
+    mtimes = {}
+    File.open(mtime_file) do |f|
+      f.each do |line|
+        name, time = line.split("\t")
+        mtimes[name] = time.to_i
+      end
+    end
+    mtimes
+  end
+
+  def changeset
+    files.select{|f| file_changed?(f)}
+  end
+
+  def has_changes?
+    not changeset.empty?
+  end
+
+  def mtime_file
+    @dir + "/.mtimes"
+  end
+
+  def update
+    File.open(mtime_file, 'w') do |f|
+      current = current_mtimes
+      flat = current.map{|k, v| "#{k}\t#{v}\n"}.join
+      f.write flat
+    end
+    reset
+  end
+
+  def reset
+    @mtimes = nil
+    @current = nil
+    @files = nil
+  end
+end

data/lib/css-spriter/png/chunk.rb

@@ -0,0 +1,12 @@
+module PNG
+  class Chunk
+    def chunk_name
+      raise "looks like you havn't subclassed and defined a chunk_name"
+    end
+    
+    def to_chunk
+      to_check = chunk_name + encode
+      [encode.length].pack("N") + to_check + [Zlib.crc32(to_check)].pack("N")
+    end
+  end
+end

data/lib/css-spriter/png/file_header.rb

@@ -0,0 +1,7 @@
+module PNG
+  class FileHeader
+   def encode
+     [137, 80, 78, 71, 13, 10, 26, 10].pack("C*")
+   end
+  end
+end

data/lib/css-spriter/png/filters.rb

@@ -0,0 +1,80 @@
+module PNG
+  class Filters
+    class << self
+      def fetch_pixel(idx, row)
+        idx < 0 ? 0 : row[idx] || 0
+      end
+
+      #filter methods are inlined here for performance
+      def decode( filter_type, value, index, row, last_row, record_width )
+        case filter_type
+        when 0
+          #no filter
+          value
+        when 1
+          #left
+          (value + fetch_pixel(index - record_width, row)) % 256
+        when 2
+          #left
+          (value + fetch_pixel(index, last_row)) % 256
+        when 3
+          #avg
+          (value + ( (fetch_pixel(index - record_width, row) + fetch_pixel(index, last_row)) / 2 ).floor) % 256
+        when 4
+          #paeth
+          left = fetch_pixel(index - record_width, row)
+          above = fetch_pixel(index, last_row)
+          upper_left = fetch_pixel(index - record_width, last_row)
+
+          pr = paeth_predictor( left, above, upper_left )
+
+          (value + pr) % 256
+        else
+          raise "Invalid filter type (#{filter_type})"
+        end
+      end
+      def encode( filter_type, value, index, row, last_row, record_width )
+        case filter_type
+        when 0
+          value
+        when 1
+          #left
+          (value - fetch_pixel(index - record_width, row)) % 256
+        when 2
+          #up
+          (value - fetch_pixel(index, last_row)) % 256
+        when 3
+          #avg
+          (value - ( (fetch_pixel(index - record_width, row) + fetch_pixel(index, last_row)) / 2 ).floor) % 256
+        when 4
+          #paeth
+          left = fetch_pixel(index - record_width, row)
+          above = fetch_pixel(index, last_row)
+          upper_left = fetch_pixel(index - record_width, last_row)
+
+          pr = paeth_predictor( left, above, upper_left )
+          (value - pr) % 256
+        else
+          raise "Filter type (#{filter_type}) is not supported"
+        end
+      end
+
+    private
+
+      def paeth_predictor( left, above, upper_left )
+        p = left + above - upper_left
+        pa = (p - left).abs
+        pb = (p - above).abs
+        pc = (p - upper_left).abs
+
+        pr = upper_left
+        if ( pa <= pb and pa <= pc)
+          pr = left
+        elsif (pb <= pc)
+          pr = above
+        end
+        pr
+      end
+    end
+  end
+end