compass-sourcemaps 0.12.2.sourcemaps.57a186c

data/lib/compass/sass_extensions/sprites/image.rb

@@ -0,0 +1,151 @@
+module Compass
+  module SassExtensions
+    module Sprites
+      class Image
+        ACTIVE = %r{[_-]active$}
+        TARGET = %r{[_-]target$}
+        HOVER = %r{[_-]hover$}
+        PARENT = %r{(.+)[-_](.+)$}
+
+        REPEAT_X = 'repeat-x'
+        NO_REPEAT = 'no-repeat'
+
+        VALID_REPEATS = [REPEAT_X, NO_REPEAT]
+        
+        attr_reader :relative_file, :options, :base
+        attr_accessor :top, :left
+
+        def initialize(base, relative_file, options)
+          @base, @relative_file, @options = base, relative_file, options
+          @left = @top = 0
+        end
+        
+        # The Full path to the image
+        def file
+          @file ||= find_file
+        end
+        
+        def find_file
+          Compass.configuration.sprite_load_path.compact.each do |path|
+            f = File.join(path, relative_file)
+            if File.exists?(f)
+              return f
+            end
+          end
+        end
+        
+        # Width of the image
+        def width
+          dimensions.first
+        end
+        
+        def size
+          @size ||= File.size(file)
+        end
+        
+        # Height of the image
+        def height
+          dimensions.last
+        end
+        
+        # Basename of the image
+        def name
+          File.basename(relative_file, '.png')
+        end
+
+        def get_var_file(var)
+          options.get_var "#{base.name}_#{name}_#{var}"
+        end
+
+        # Value of <tt> $#{name}-repeat </tt> or <tt> $repeat </tt>
+        def repeat 
+          @repeat ||= begin 
+            rep = (get_var_file("repeat") || options.get_var("repeat") || Sass::Script::String.new(NO_REPEAT)).value
+            unless VALID_REPEATS.include? rep
+              raise SpriteException, "Invalid option for repeat \"#{rep}\" - valid options are #{VALID_REPEATS.join(', ')}"
+            end
+
+            rep
+          end
+        end
+
+        def repeat_x?
+          repeat == REPEAT_X
+        end
+
+        def no_repeat?
+          repeat == NO_REPEAT
+        end
+
+        # Value of <tt> $#{name}-position </tt> or <tt> $position </tt> defaults to <tt>0px</tt>
+        def position
+          @position||= get_var_file("position") || options.get_var("position") || Sass::Script::Number.new(0, ["px"])
+        end
+        
+        # Offset within the sprite
+        def offset
+          @offset ||= (position.unitless? || position.unit_str == "px") ? position.value : 0
+        end
+               
+        # Spacing between this image and the next
+        def spacing
+          @spacing ||= (get_var_file("spacing") || options.get_var("spacing") || Sass::Script::Number.new(0, ['px'])).value
+        end
+
+        # MD5 hash of this file
+        def digest
+          Digest::MD5.file(file).hexdigest
+        end
+        
+        # mtime of this file
+        def mtime
+          File.mtime(file)
+        end
+        
+        # Is hover selector
+        def hover?
+          name =~ HOVER
+        end
+        
+        # Hover selector Image object if exsists
+        def hover
+          base.image_for("#{name}_hover")
+        end
+        
+        # Is target selector
+        def target?
+          name =~ TARGET
+        end
+        
+        # Target selector Image object if exsists
+        def target
+          base.image_for("#{name}_target")
+        end
+        
+        # Is active selector
+        def active?
+          name =~ ACTIVE
+        end
+        
+        # Active selector Image object if exsists
+        def active
+          base.image_for("#{name}_active")
+        end
+        
+        
+        def parent
+          if [hover?, target?, active?].any?
+            PARENT.match name
+            base.image_for($1)
+          end
+        end
+        
+                
+        private
+          def dimensions
+            @dimensions ||= Compass::SassExtensions::Functions::ImageSize::ImageProperties.new(file).size
+          end
+      end
+    end
+  end
+end

data/lib/compass/sass_extensions/sprites/image_methods.rb

@@ -0,0 +1,32 @@
+module Compass
+  module SassExtensions
+    module Sprites
+      module ImageMethods
+        # Fetches the Sprite::Image object for the supplied name
+         def image_for(name)
+           @images.detect { |img| img.name == name}
+         end
+
+         # Returns true if the image name has a hover selector image
+         def has_hover?(name)
+           !image_for("#{name}_hover").nil?
+         end
+
+         # Returns true if the image name has a target selector image
+         def has_target?(name)
+           !image_for("#{name}_target").nil?
+         end
+
+         # Returns true if the image name has an active selector image
+         def has_active?(name)
+           !image_for("#{name}_active").nil?
+         end
+
+         # Return and array of image names that make up this sprite
+         def sprite_names
+           image_names.map { |f| File.basename(f, '.png') }
+         end
+      end
+    end
+  end
+end

data/lib/compass/sass_extensions/sprites/image_row.rb

@@ -0,0 +1,47 @@
+require 'forwardable'
+
+module Compass
+  module SassExtensions
+    module Sprites
+      class ImageRow
+        extend Forwardable
+
+        attr_reader :images, :max_width
+        def_delegators :@images, :last, :delete, :empty?, :length
+        
+        def initialize(max_width)
+          @images = []
+          @max_width = max_width
+        end
+        
+        def add(image)
+          return false if !will_fit?(image)
+          @images << image
+          true
+        end
+
+        alias :<< :add
+        
+        def height
+          images.map(&:height).max
+        end
+        
+        def width
+          images.map(&:width).max
+        end
+
+        def total_width
+          images.inject(0) {|sum, img| sum + img.width }
+        end
+        
+        def efficiency
+          1 - (total_width.to_f / max_width.to_f)
+        end
+
+        def will_fit?(image)
+          (total_width + image.width) <= max_width
+        end
+      end
+    end
+  end
+end

data/lib/compass/sass_extensions/sprites/layout_methods.rb

@@ -0,0 +1,159 @@
+module Compass
+  module SassExtensions
+    module Sprites
+      module LayoutMethods
+        HORIZONTAL = 'horizontal'
+        DIAGONAL = 'diagonal'
+        SMART = 'smart'
+        VERTICAL = 'vertical'
+        
+        def smart?
+          layout == SMART
+        end
+        
+        def horizontal?
+          layout == HORIZONTAL
+        end
+        
+        def diagonal?
+          layout == DIAGONAL
+        end
+
+        def vertical?
+          layout == VERTICAL
+        end
+        
+        def layout
+          @layout ||= @kwargs.get_var('layout').value
+        end
+        
+        # Calculates the overal image dimensions
+        # collects image sizes and input parameters for each sprite
+        def compute_image_positions!
+          case layout
+          when SMART
+            calculate_smart_positions
+          when DIAGONAL
+            calculate_diagonal_dimensions
+            calculate_diagonal_positions
+          when HORIZONTAL
+            @height = height_for_horizontal_layout
+            calculate_horizontal_positions
+            @width = width_for_horizontal_layout
+          else
+            @images.sort! do |a,b| 
+              if (b.size <=> a.size) === 0
+                a.name <=> b.name
+              else
+                b.size <=> a.size
+              end
+            end
+
+            @width = width_for_vertical_layout
+            calulate_vertical_postions
+            @height = height_for_vertical_layout
+            if @images.any?(&:repeat_x?)
+              calculate_repeat_extra_width!
+              tile_images_that_repeat
+             end
+          end
+        end
+
+        def tile_images_that_repeat
+          @images.map {|img| img if img.repeat_x?}.compact.each do |image|
+            x = image.left - (image.left / image.width).ceil * image.width
+              while x < @width do
+                begin
+                  img = image.dup
+                  img.top = image.top
+                  img.left = x.to_i
+                  @images << img
+                  x += image.width 
+                end
+              end
+            end
+        end
+
+        def calculate_repeat_extra_width!
+          require 'rational' #for ruby 1.8.7
+          m = @images.inject(1) {|m,img| img.repeat_x? ? m.lcm(img.width) : m}
+          remainder = @width % m
+          @width += (m - remainder) unless remainder.zero?
+        end
+        
+        def calculate_smart_positions
+          fitter = ::Compass::SassExtensions::Sprites::RowFitter.new(@images)
+          current_y = 0
+          fitter.fit!.each do |row|
+            current_x = 0
+            row.images.each_with_index do |image, index|
+              image.left = current_x
+              image.top = current_y
+              current_x += image.width
+            end
+            current_y += row.height
+          end
+          @width = fitter.width
+          @height = fitter.height
+        end
+        
+        
+        def calculate_diagonal_dimensions
+          @width = @images.inject(0) {|sum, img| sum + img.width}
+          @height = @images.inject(0) {|sum, img| sum + img.height}
+        end
+        
+        def calculate_diagonal_positions
+          previous = nil
+          @images.each_with_index do |image, index|
+            if previous.nil?
+              previous = image
+              image.top = @height - image.height
+              image.left = 0
+              next
+            end
+            image.top = previous.top - image.height
+            image.left = previous.left + previous.width
+            previous = image
+          end
+        end
+        
+        def calculate_horizontal_positions
+          @images.each_with_index do |image, index|
+            image.top = image.position.unit_str == '%' ? (@height - image.height) * (image.position.value / 100.0) : image.position.value
+            next if index == 0
+            last_image = @images[index-1]
+            image.left = last_image.left + last_image.width + [image.spacing, last_image.spacing].max
+          end
+        end
+        
+        def calulate_vertical_postions
+          @images.each_with_index do |image, index|
+            image.left = (image.position.unit_str == "%" ? (@width - image.width) * (image.position.value / 100.0) : image.position.value).to_i
+            next if index == 0
+            last_image = @images[index-1]
+            image.top = last_image.top + last_image.height + [image.spacing,  last_image.spacing].max
+          end
+        end
+        
+        def height_for_vertical_layout
+          last = @images.last
+          last.top + last.height
+        end
+        
+        def height_for_horizontal_layout
+          @height = @images.map {|image| image.height + image.offset}.max
+        end
+        
+        def width_for_horizontal_layout
+          @images.inject(0) { |sum, image| sum += (image.width + image.spacing) }
+        end
+        
+        def width_for_vertical_layout
+          @images.map { |image| image.width + image.offset }.max
+        end
+      end
+    end
+  end
+end
+  

data/lib/compass/sass_extensions/sprites/row_fitter.rb

@@ -0,0 +1,92 @@
+require 'forwardable'
+
+module Compass
+  module SassExtensions
+    module Sprites
+      class RowFitter
+        extend Forwardable
+
+        attr_reader :images, :rows
+        def_delegators :rows, :[]
+
+        def initialize(images)
+          @images = images.sort do |a,b|
+            if a.height == b.height
+              b.width <=> a.width
+            else
+              a.height <=> b.height
+            end
+          end
+          @rows = []
+        end
+
+        def fit!(style = :scan)
+          send("#{style}_fit")
+          @rows
+        end
+
+        def width
+          @width ||= @images.collect(&:width).max
+        end
+        
+        def height
+          @height ||= @rows.inject(0) {|sum, row| sum += row.height}
+        end
+
+        def efficiency
+          @rows.inject(0) { |sum, row| sum += row.efficiency } ** @rows.length
+        end
+
+        private
+        def new_row(image = nil)
+          row = Compass::SassExtensions::Sprites::ImageRow.new(width)
+          row.add(image) if image
+          row
+        end
+
+        def fast_fit
+          row = new_row
+          @images.each do |image|
+            if !row.add(image)
+              @rows << row
+              row = new_row(image)
+            end
+          end
+
+          @rows << row
+        end
+
+        def scan_fit
+          fast_fit
+
+          moved_images = []
+
+          begin
+            removed = false
+
+            catch :done do
+              @rows.each do |row|
+                (@rows - [ row ]).each do |other_row|
+                  other_row.images.each do |image|
+                    if !moved_images.include?(image)
+                      if row.will_fit?(image)
+                        other_row.delete(image)
+                        row << image
+
+                        @rows.delete(other_row) if other_row.empty?
+                        removed = true
+
+                        moved_images << image
+                        throw :done
+                      end
+                    end
+                  end
+                end
+              end
+            end
+          end while removed
+        end
+      end
+    end
+  end
+end