sprite-factory-custom 1.6.0

data/test/layout/horizontal_test.rb

@@ -0,0 +1,156 @@
+require File.expand_path('test_case', File.dirname(__FILE__))
+
+module SpriteFactory
+  module Layout
+    class HorizontalTest < SpriteFactory::Layout::TestCase
+
+      #==========================================================================
+      # test REGULAR images
+      #==========================================================================
+
+      def test_horizontal_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :x =>  0, :y => 0 },
+          { :x => 20, :y => 0 },
+          { :x => 40, :y => 0 },
+          { :x => 60, :y => 0 },
+          { :x => 80, :y => 0 }
+        ]
+        verify_layout(100, 10, expected, images, :layout => :horizontal)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_horizontal_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx =>   0, :cssy => 0, :cssw => 40, :cssh => 50, :x =>  10, :y => 20 },
+          { :cssx =>  40, :cssy => 0, :cssw => 40, :cssh => 50, :x =>  50, :y => 20 },
+          { :cssx =>  80, :cssy => 0, :cssw => 40, :cssh => 50, :x =>  90, :y => 20 },
+          { :cssx => 120, :cssy => 0, :cssw => 40, :cssh => 50, :x => 130, :y => 20 },
+          { :cssx => 160, :cssy => 0, :cssw => 40, :cssh => 50, :x => 170, :y => 20 }
+        ]
+        verify_layout(200, 50, expected, images, :layout => :horizontal, :hpadding => 10, :vpadding => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_margin_horizontal_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx =>  10, :cssy => 20, :cssw => 20, :cssh => 10, :x =>  10, :y => 20 },
+          { :cssx =>  50, :cssy => 20, :cssw => 20, :cssh => 10, :x =>  50, :y => 20 },
+          { :cssx =>  90, :cssy => 20, :cssw => 20, :cssh => 10, :x =>  90, :y => 20 },
+          { :cssx => 130, :cssy => 20, :cssw => 20, :cssh => 10, :x => 130, :y => 20 },
+          { :cssx => 170, :cssy => 20, :cssw => 20, :cssh => 10, :x => 170, :y => 20 }
+        ]
+        verify_layout(200, 50, expected, images, :layout => :horizontal, :hmargin => 10, :vmargin => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_and_margin_horizontal_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx =>  10, :cssy => 20, :cssw => 24, :cssh => 18, :x =>  12, :y => 24 },
+          { :cssx =>  54, :cssy => 20, :cssw => 24, :cssh => 18, :x =>  56, :y => 24 },
+          { :cssx =>  98, :cssy => 20, :cssw => 24, :cssh => 18, :x => 100, :y => 24 },
+          { :cssx => 142, :cssy => 20, :cssw => 24, :cssh => 18, :x => 144, :y => 24 },
+          { :cssx => 186, :cssy => 20, :cssw => 24, :cssh => 18, :x => 188, :y => 24 }
+        ]
+        verify_layout(220, 58, expected, images, :layout => :horizontal, :hmargin => 10, :vmargin => 20, :hpadding => 2, :vpadding => 4)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_fixed_horizontal_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx =>   0, :cssy => 0, :cssw => 50, :cssh => 50, :x =>  15, :y => 20 },
+          { :cssx =>  50, :cssy => 0, :cssw => 50, :cssh => 50, :x =>  65, :y => 20 },
+          { :cssx => 100, :cssy => 0, :cssw => 50, :cssh => 50, :x => 115, :y => 20 },
+          { :cssx => 150, :cssy => 0, :cssw => 50, :cssh => 50, :x => 165, :y => 20 },
+          { :cssx => 200, :cssy => 0, :cssw => 50, :cssh => 50, :x => 215, :y => 20 }
+        ]
+        verify_layout(250, 50, expected, images, :layout => :horizontal, :width => 50, :height => 50)
+      end
+
+      #==========================================================================
+      # test IRREGULAR images
+      #==========================================================================
+
+      def test_horizontal_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :x =>   0, :y =>  0 },
+          { :x =>  20, :y =>  5 },
+          { :x =>  60, :y => 10 },
+          { :x => 120, :y => 15 },
+          { :x => 200, :y => 20 }
+        ]
+        verify_layout(300, 50, expected, images, :layout => :horizontal)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_horizontal_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx =>   0, :cssy =>  0, :cssw =>  40, :cssh => 90, :x =>  10, :y => 20 },
+          { :cssx =>  40, :cssy =>  5, :cssw =>  60, :cssh => 80, :x =>  50, :y => 25 },
+          { :cssx => 100, :cssy => 10, :cssw =>  80, :cssh => 70, :x => 110, :y => 30 },
+          { :cssx => 180, :cssy => 15, :cssw => 100, :cssh => 60, :x => 190, :y => 35 },
+          { :cssx => 280, :cssy => 20, :cssw => 120, :cssh => 50, :x => 290, :y => 40 }
+        ]
+        verify_layout(400, 90, expected, images, :layout => :horizontal, :hpadding => 10, :vpadding => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_margin_horizontal_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx =>  10, :cssy => 20, :cssw =>  20, :cssh => 50, :x =>  10, :y => 20 },
+          { :cssx =>  50, :cssy => 25, :cssw =>  40, :cssh => 40, :x =>  50, :y => 25 },
+          { :cssx => 110, :cssy => 30, :cssw =>  60, :cssh => 30, :x => 110, :y => 30 },
+          { :cssx => 190, :cssy => 35, :cssw =>  80, :cssh => 20, :x => 190, :y => 35 },
+          { :cssx => 290, :cssy => 40, :cssw => 100, :cssh => 10, :x => 290, :y => 40 }
+        ]
+        verify_layout(400, 90, expected, images, :layout => :horizontal, :hmargin => 10, :vmargin => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_and_margin_horizontal_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx =>  10, :cssy => 20, :cssw =>  24, :cssh => 58, :x =>  12, :y => 24 },
+          { :cssx =>  54, :cssy => 25, :cssw =>  44, :cssh => 48, :x =>  56, :y => 29 },
+          { :cssx => 118, :cssy => 30, :cssw =>  64, :cssh => 38, :x => 120, :y => 34 },
+          { :cssx => 202, :cssy => 35, :cssw =>  84, :cssh => 28, :x => 204, :y => 39 },
+          { :cssx => 306, :cssy => 40, :cssw => 104, :cssh => 18, :x => 308, :y => 44 }
+        ]
+        verify_layout(420, 98, expected, images, :layout => :horizontal, :hmargin => 10, :vmargin => 20, :hpadding => 2, :vpadding => 4)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_fixed_horizontal_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx =>   0, :cssy => 0, :cssw => 100, :cssh => 100, :x =>  40, :y => 25 },
+          { :cssx => 100, :cssy => 0, :cssw => 100, :cssh => 100, :x => 130, :y => 30 },
+          { :cssx => 200, :cssy => 0, :cssw => 100, :cssh => 100, :x => 220, :y => 35 },
+          { :cssx => 300, :cssy => 0, :cssw => 100, :cssh => 100, :x => 310, :y => 40 },
+          { :cssx => 400, :cssy => 0, :cssw => 100, :cssh => 100, :x => 400, :y => 45 }
+        ]
+        verify_layout(500, 100, expected, images, :layout => :horizontal, :width => 100, :height => 100)
+      end
+
+      #--------------------------------------------------------------------------
+
+    end # class HorizontalTest
+  end # module Layout
+end # module SpriteFactory
+

data/test/layout/packed_test.rb

@@ -0,0 +1,283 @@
+require File.expand_path('test_case', File.dirname(__FILE__))
+
+module SpriteFactory
+  module Layout
+    class PackedTest < SpriteFactory::Layout::TestCase
+
+    #==========================================================================
+    # test REGULAR images
+    #==========================================================================
+
+    def test_packed_layout_of_regular_images
+      images = get_regular_images
+      expected = [                                                                  # expected:  -------
+        { :cssx =>  0, :cssy =>  0, :cssw => 20, :cssh => 10, :x =>  0, :y =>  0 }, #            |11|33|
+        { :cssx =>  0, :cssy => 10, :cssw => 20, :cssh => 10, :x =>  0, :y => 10 }, #            -------
+        { :cssx => 20, :cssy =>  0, :cssw => 20, :cssh => 10, :x => 20, :y =>  0 }, #            |22|44|
+        { :cssx => 20, :cssy => 10, :cssw => 20, :cssh => 10, :x => 20, :y => 10 }, #            -------
+        { :cssx =>  0, :cssy => 20, :cssw => 20, :cssh => 10, :x =>  0, :y => 20 }  #            |55|  |
+      ]                                                                             #            -------
+      verify_layout(40, 30, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_padded_packed_layout_of_regular_images                                  # expected:  ---------------
+                                                                                     #            |      |      |
+      images = get_regular_images                                                    #            |  11  |  33  |
+      expected = [                                                                   #            |      |      |
+        { :cssx =>  0, :cssy =>  0, :cssw => 60, :cssh => 30, :x => 20, :y => 10 },  #            ---------------
+        { :cssx =>  0, :cssy => 30, :cssw => 60, :cssh => 30, :x => 20, :y => 40 },  #            |      |      |
+        { :cssx => 60, :cssy =>  0, :cssw => 60, :cssh => 30, :x => 80, :y => 10 },  #            |  22  |  44  |
+        { :cssx => 60, :cssy => 30, :cssw => 60, :cssh => 30, :x => 80, :y => 40 },  #            |      |      |
+        { :cssx =>  0, :cssy => 60, :cssw => 60, :cssh => 30, :x => 20, :y => 70 }   #            ---------------
+      ]                                                                              #            |      |
+      verify_layout(120, 90, expected, images, :layout => :packed,                   #            |  55  |
+                                               :hpadding => 20,                      #            |      |
+                                               :vpadding => 10)                      #            --------
+    end
+                                          
+    #--------------------------------------------------------------------------
+
+    def test_margin_packed_layout_of_regular_images                                  # expected:  ---------------
+                                                                                     #            |      |      |
+      images = get_regular_images                                                    #            |  11  |  33  |
+      expected = [                                                                   #            |      |      |
+        { :cssx => 20, :cssy => 10, :cssw => 20, :cssh => 10, :x => 20, :y => 10 },  #            ---------------
+        { :cssx => 20, :cssy => 40, :cssw => 20, :cssh => 10, :x => 20, :y => 40 },  #            |      |      |
+        { :cssx => 80, :cssy => 10, :cssw => 20, :cssh => 10, :x => 80, :y => 10 },  #            |  22  |  44  |
+        { :cssx => 80, :cssy => 40, :cssw => 20, :cssh => 10, :x => 80, :y => 40 },  #            |      |      |
+        { :cssx => 20, :cssy => 70, :cssw => 20, :cssh => 10, :x => 20, :y => 70 }   #            ---------------
+      ]                                                                              #            |      |
+      verify_layout(120, 90, expected, images, :layout => :packed,                   #            |  55  |
+                                               :hmargin => 20,                       #            |      |
+                                               :vmargin => 10)                       #            --------
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_fixed_packed_layout_of_regular_images
+      assert_not_implemented ":packed layout does not support fixed :width/:height option" do
+        Layout::Packed.layout(get_regular_images, :width => 50, :height => 50)
+      end
+    end 
+
+    #==========================================================================
+    # test IRREGULAR images
+    #==========================================================================
+
+    def test_packed_layout_of_irregular_images
+      images = get_irregular_images
+                                                                                        # expected: ---------------
+      expected = [                                                                      #           |1111111111|44|
+        { :cssx =>   0, :cssy =>  0, :cssw => 100, :cssh => 10, :x =>    0, :y =>  0 }, #           -----------|44|
+        { :cssx =>   0, :cssy => 10, :cssw =>  80, :cssh => 20, :x =>    0, :y => 10 }, #           |22222222| |44|
+        { :cssx =>   0, :cssy => 30, :cssw =>  60, :cssh => 30, :x =>    0, :y => 30 }, #           -----------|44|
+        { :cssx => 100, :cssy =>  0, :cssw =>  20, :cssh => 50, :x =>  100, :y =>  0 }, #           |333333|   ----
+        { :cssx =>   0, :cssy => 60, :cssw =>  40, :cssh => 40, :x =>    0, :y => 60 }  #           ---------------
+      ]                                                                                 #           |5555|        |
+                                                                                        #           ---------------
+      verify_layout(120, 100, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_padded_packed_layout_of_irregular_images                                     # expected: (but with more vertical padding than shown here)
+      images = get_irregular_images                                                       #
+                                                                                          #  ------------------------- 
+      expected = [                                                                        #  |  1111111111  |  4444  | 
+        { :cssx =>   0, :cssy =>   0, :cssw => 140, :cssh => 30, :x =>   20, :y =>  10 }, #  ----------------  4444  | 
+        { :cssx =>   0, :cssy =>  30, :cssw => 120, :cssh => 40, :x =>   20, :y =>  40 }, #  |  22222222  | ---------- 
+        { :cssx =>   0, :cssy =>  70, :cssw => 100, :cssh => 50, :x =>   20, :y =>  80 }, #  --------------          | 
+        { :cssx => 140, :cssy =>   0, :cssw =>  80, :cssh => 60, :x =>  160, :y =>  10 }, #  |  333333  |            | 
+        { :cssx =>   0, :cssy => 120, :cssw =>  60, :cssh => 70, :x =>   20, :y => 130 }  #  |-----------            | 
+      ]                                                                                   #  |  55  |                | 
+                                                                                          #  ------------------------- 
+      verify_layout(220, 190, expected, images, :layout   => :packed,                     #
+                                                :hpadding => 20,                          #
+                                                :vpadding => 10)                          #
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_margin_packed_layout_of_irregular_images                                     # expected: (but with more vertical margin than shown here)
+      images = get_irregular_images                                                       #
+                                                                                          #  ------------------------- 
+      expected = [                                                                        #  |  1111111111  |  4444  | 
+        { :cssx =>  20, :cssy =>  10, :cssw => 100, :cssh => 10, :x =>   20, :y =>  10 }, #  ----------------  4444  | 
+        { :cssx =>  20, :cssy =>  40, :cssw =>  80, :cssh => 20, :x =>   20, :y =>  40 }, #  |  22222222  | ---------- 
+        { :cssx =>  20, :cssy =>  80, :cssw =>  60, :cssh => 30, :x =>   20, :y =>  80 }, #  --------------          | 
+        { :cssx => 160, :cssy =>  10, :cssw =>  40, :cssh => 40, :x =>  160, :y =>  10 }, #  |  333333  |            | 
+        { :cssx =>  20, :cssy => 130, :cssw =>  20, :cssh => 50, :x =>   20, :y => 130 }  #  |-----------            | 
+      ]                                                                                   #  |  55  |                | 
+                                                                                          #  ------------------------- 
+      verify_layout(220, 190, expected, images, :layout  => :packed,                      #
+                                                :hmargin => 20,                           #
+                                                :vmargin => 10)                           #
+    end
+
+    #==========================================================================
+    # other packed algorithm test
+    #==========================================================================
+
+    def test_single_image_is_100_percent_packed
+      images = [
+        { :width => 100, :height => 100 },
+        { :width => 100, :height =>  50 },
+        { :width =>  50, :height => 100 }
+      ]
+      images.each do |image|
+        verify_layout(image[:width], image[:height], [{:x => 0, :y => 0}], [image], :layout => :packed)
+      end
+    end
+
+    #==========================================================================
+    # some test cases from original bin packing demonstration
+    #   (see http://codeincomplete.com/posts/2011/5/7/bin_packing/example/)
+    #==========================================================================
+
+    def test_packed_simple
+      images = expanded_images([
+        { :width => 500, :height => 200             },
+        { :width => 250, :height => 200             },
+        { :width =>  50, :height =>  50, :num => 20 }
+      ])
+      expected = [
+        { :x => 0,   :y => 0   },
+        { :x => 0,   :y => 200 },
+        { :x => 250, :y => 200 },
+        { :x => 300, :y => 200 },
+        { :x => 350, :y => 200 },
+        { :x => 400, :y => 200 },
+        { :x => 450, :y => 200 },
+        { :x => 250, :y => 250 },
+        { :x => 300, :y => 250 },
+        { :x => 350, :y => 250 },
+        { :x => 400, :y => 250 },
+        { :x => 450, :y => 250 },
+        { :x => 250, :y => 300 },
+        { :x => 300, :y => 300 },
+        { :x => 350, :y => 300 },
+        { :x => 400, :y => 300 },
+        { :x => 450, :y => 300 },
+        { :x => 250, :y => 350 },
+        { :x => 300, :y => 350 },
+        { :x => 350, :y => 350 },
+        { :x => 400, :y => 350 },
+        { :x => 450, :y => 350 }
+      ]
+      verify_layout(500, 400, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_packed_square
+      images = expanded_images([{ :width => 50, :height => 50, :num => 16 }])
+      expected = [
+        { :x =>   0, :y =>   0 },
+        { :x =>  50, :y =>   0 },
+        { :x =>   0, :y =>  50 },
+        { :x =>  50, :y =>  50 },
+        { :x => 100, :y =>   0 },
+        { :x => 100, :y =>  50 },
+        { :x =>   0, :y => 100 },
+        { :x =>  50, :y => 100 },
+        { :x => 100, :y => 100 },
+        { :x => 150, :y =>   0 },
+        { :x => 150, :y =>  50 },
+        { :x => 150, :y => 100 },
+        { :x =>   0, :y => 150 },
+        { :x =>  50, :y => 150 },
+        { :x => 100, :y => 150 },
+        { :x => 150, :y => 150 }
+      ]
+      verify_layout(200, 200, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_packed_tall
+      images = expanded_images([{ :width => 50, :height => 500, :num => 5 }])
+      expected = [
+        { :x =>   0, :y => 0 },
+        { :x =>  50, :y => 0 },
+        { :x => 100, :y => 0 },
+        { :x => 150, :y => 0 },
+        { :x => 200, :y => 0 }
+      ]
+      verify_layout(250, 500, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_packed_wide
+      images = expanded_images([{ :width => 500, :height => 50, :num => 5 }])
+      expected = [
+        { :x => 0, :y =>   0 },
+        { :x => 0, :y =>  50 },
+        { :x => 0, :y => 100 },
+        { :x => 0, :y => 150 },
+        { :x => 0, :y => 200 }
+      ]
+      verify_layout(500, 250, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_packed_tall_and_wide
+      images = expanded_images([
+        { :width =>  50, :height => 500, :num => 3 },
+        { :width => 500, :height =>  50, :num => 3 }
+      ])
+      expected = [
+        { :x =>   0, :y =>   0 },
+        { :x =>  50, :y =>   0 },
+        { :x => 100, :y =>   0 },
+        { :x => 150, :y =>   0 },
+        { :x => 150, :y =>  50 },
+        { :x => 150, :y => 100 }
+      ]
+      verify_layout(650, 500, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    def test_packed_powers_of_2
+      images = expanded_images([
+        { :width => 64, :height => 64, :num => 2 },
+        { :width => 32, :height => 32, :num => 4 },
+        { :width => 16, :height => 16, :num => 8 }
+      ])
+      expected = [
+        { :x =>   0, :y =>   0 },
+        { :x =>  64, :y =>   0 },
+        { :x =>   0, :y =>  64 },
+        { :x =>  32, :y =>  64 },
+        { :x =>  64, :y =>  64 },
+        { :x =>  96, :y =>  64 },
+        { :x =>   0, :y =>  96 },
+        { :x =>  16, :y =>  96 },
+        { :x =>  32, :y =>  96 },
+        { :x =>  48, :y =>  96 },
+        { :x =>  64, :y =>  96 },
+        { :x =>  80, :y =>  96 },
+        { :x =>  96, :y =>  96 },
+        { :x => 112, :y =>  96 }
+      ]
+      verify_layout(128, 112, expected, images, :layout => :packed)
+    end
+
+    #--------------------------------------------------------------------------
+
+    protected
+
+    def expanded_images(images)
+      result = images.map do |i|
+        (1..(i[:num] || 1)).map{{:width => i[:width], :height => i[:height]}}
+      end.flatten
+    end
+
+    end # class PackedTest
+  end # module Layout
+end # module SpriteFactory
+

data/test/layout/test_case.rb

@@ -0,0 +1,56 @@
+require File.expand_path('../test_case', File.dirname(__FILE__))
+
+module SpriteFactory
+  module Layout
+    class TestCase < SpriteFactory::TestCase
+
+      #==========================================================================
+      # layout test helpers
+      #==========================================================================
+
+      protected
+
+      def get_regular_images
+        return [
+          {:width => 20, :height => 10},
+          {:width => 20, :height => 10},
+          {:width => 20, :height => 10},
+          {:width => 20, :height => 10},
+          {:width => 20, :height => 10}
+        ]
+      end
+
+      def get_irregular_images
+        return [
+          {:width => 20,  :height => 50},
+          {:width => 40,  :height => 40},
+          {:width => 60,  :height => 30},
+          {:width => 80,  :height => 20},
+          {:width => 100, :height => 10}
+        ]
+      end
+
+      #--------------------------------------------------------------------------
+
+      def verify_layout(expected_width, expected_height, expected_images, images, options = {})
+        max = Layout.send(options[:layout] || :horizontal).layout(images, options)
+        assert_equal(expected_width, max[:width])
+        assert_equal(expected_height, max[:height])
+        assert_equal(expected_images.length, images.length)
+        images.length.times.each do |n|
+          expected = expected_images[n]
+          actual   = images[n]
+          assert_equal(expected[:x],                       actual[:x],    "image #{n} - unexpected x")
+          assert_equal(expected[:y],                       actual[:y],    "image #{n} - unexpected y")
+          assert_equal(expected[:cssx] || expected[:x],    actual[:cssx], "image #{n} - unexpected cssx")
+          assert_equal(expected[:cssy] || expected[:y],    actual[:cssy], "image #{n} - unexpected cssy")
+          assert_equal(expected[:cssw] || actual[:width],  actual[:cssw], "image #{n} - unexpected cssw")
+          assert_equal(expected[:cssh] || actual[:height], actual[:cssh], "image #{n} - unexpected cssh")
+        end
+      end
+
+      #--------------------------------------------------------------------------
+
+    end # class TestCase
+  end # module Layout
+end # module SpriteFactory

data/test/layout/vertical_test.rb

@@ -0,0 +1,156 @@
+require File.expand_path('test_case', File.dirname(__FILE__))
+
+module SpriteFactory
+  module Layout
+    class VerticalTest < SpriteFactory::Layout::TestCase
+
+      #==========================================================================
+      # test REGULAR images
+      #==========================================================================
+
+      def test_vertical_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :x => 0, :y =>  0 },
+          { :x => 0, :y => 10 },
+          { :x => 0, :y => 20 },
+          { :x => 0, :y => 30 },
+          { :x => 0, :y => 40 }
+        ]
+        verify_layout(20, 50, expected, images, :layout => :vertical)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_vertical_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx => 0, :cssy =>   0, :cssw => 40, :cssh => 50, :x => 10, :y =>  20 },
+          { :cssx => 0, :cssy =>  50, :cssw => 40, :cssh => 50, :x => 10, :y =>  70 },
+          { :cssx => 0, :cssy => 100, :cssw => 40, :cssh => 50, :x => 10, :y => 120 },
+          { :cssx => 0, :cssy => 150, :cssw => 40, :cssh => 50, :x => 10, :y => 170 },
+          { :cssx => 0, :cssy => 200, :cssw => 40, :cssh => 50, :x => 10, :y => 220 }
+        ]
+        verify_layout(40, 250, expected, images, :layout => :vertical, :hpadding => 10, :vpadding => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_margin_vertical_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx => 10, :cssy =>  20, :cssw => 20, :cssh => 10, :x => 10, :y =>  20 },
+          { :cssx => 10, :cssy =>  70, :cssw => 20, :cssh => 10, :x => 10, :y =>  70 },
+          { :cssx => 10, :cssy => 120, :cssw => 20, :cssh => 10, :x => 10, :y => 120 },
+          { :cssx => 10, :cssy => 170, :cssw => 20, :cssh => 10, :x => 10, :y => 170 },
+          { :cssx => 10, :cssy => 220, :cssw => 20, :cssh => 10, :x => 10, :y => 220 }
+        ]
+        verify_layout(40, 250, expected, images, :layout => :vertical, :hmargin => 10, :vmargin => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_and_margin_vertical_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx => 10, :cssy =>  20, :cssw => 24, :cssh => 18, :x => 12, :y =>  24 },
+          { :cssx => 10, :cssy =>  78, :cssw => 24, :cssh => 18, :x => 12, :y =>  82 },
+          { :cssx => 10, :cssy => 136, :cssw => 24, :cssh => 18, :x => 12, :y => 140 },
+          { :cssx => 10, :cssy => 194, :cssw => 24, :cssh => 18, :x => 12, :y => 198 },
+          { :cssx => 10, :cssy => 252, :cssw => 24, :cssh => 18, :x => 12, :y => 256 }
+        ]
+        verify_layout(44, 290, expected, images, :layout => :vertical, :hmargin => 10, :vmargin => 20, :hpadding => 2, :vpadding => 4)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_fixed_vertical_layout_of_regular_images
+        images = get_regular_images
+        expected = [
+          { :cssx => 0, :cssy =>   0, :cssw => 50, :cssh => 50, :x =>  15, :y =>  20 },
+          { :cssx => 0, :cssy =>  50, :cssw => 50, :cssh => 50, :x =>  15, :y =>  70 },
+          { :cssx => 0, :cssy => 100, :cssw => 50, :cssh => 50, :x =>  15, :y => 120 },
+          { :cssx => 0, :cssy => 150, :cssw => 50, :cssh => 50, :x =>  15, :y => 170 },
+          { :cssx => 0, :cssy => 200, :cssw => 50, :cssh => 50, :x =>  15, :y => 220 }
+        ]
+        verify_layout(50, 250, expected, images, :layout => :vertical, :width => 50, :height => 50)
+      end
+
+      #==========================================================================
+      # test IRREGULAR images
+      #==========================================================================
+
+      def test_vertical_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :x => 40, :y =>   0 },
+          { :x => 30, :y =>  50 },
+          { :x => 20, :y =>  90 },
+          { :x => 10, :y => 120 },
+          { :x =>  0, :y => 140 }
+        ]
+        verify_layout(100, 150, expected, images, :layout => :vertical)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_vertical_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx => 40, :cssy =>   0, :cssw =>  40, :cssh => 90, :x => 50, :y =>  20 },
+          { :cssx => 30, :cssy =>  90, :cssw =>  60, :cssh => 80, :x => 40, :y => 110 },
+          { :cssx => 20, :cssy => 170, :cssw =>  80, :cssh => 70, :x => 30, :y => 190 },
+          { :cssx => 10, :cssy => 240, :cssw => 100, :cssh => 60, :x => 20, :y => 260 },
+          { :cssx =>  0, :cssy => 300, :cssw => 120, :cssh => 50, :x => 10, :y => 320 }
+        ]
+        verify_layout(120, 350, expected, images, :layout => :vertical, :hpadding => 10, :vpadding => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_margin_vertical_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx => 50, :cssy =>  20, :cssw =>  20, :cssh => 50, :x => 50, :y =>  20 },
+          { :cssx => 40, :cssy => 110, :cssw =>  40, :cssh => 40, :x => 40, :y => 110 },
+          { :cssx => 30, :cssy => 190, :cssw =>  60, :cssh => 30, :x => 30, :y => 190 },
+          { :cssx => 20, :cssy => 260, :cssw =>  80, :cssh => 20, :x => 20, :y => 260 },
+          { :cssx => 10, :cssy => 320, :cssw => 100, :cssh => 10, :x => 10, :y => 320 }
+        ]
+        verify_layout(120, 350, expected, images, :layout => :vertical, :hmargin => 10, :vmargin => 20)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_padded_and_margin_vertical_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx => 50, :cssy =>  20, :cssw =>  24, :cssh => 58, :x => 52, :y =>  24 },
+          { :cssx => 40, :cssy => 118, :cssw =>  44, :cssh => 48, :x => 42, :y => 122 },
+          { :cssx => 30, :cssy => 206, :cssw =>  64, :cssh => 38, :x => 32, :y => 210 },
+          { :cssx => 20, :cssy => 284, :cssw =>  84, :cssh => 28, :x => 22, :y => 288 },
+          { :cssx => 10, :cssy => 352, :cssw => 104, :cssh => 18, :x => 12, :y => 356 }
+        ]
+        verify_layout(124, 390, expected, images, :layout => :vertical, :hmargin => 10, :vmargin => 20, :hpadding => 2, :vpadding => 4)
+      end
+
+      #--------------------------------------------------------------------------
+
+      def test_fixed_vertical_layout_of_irregular_images
+        images = get_irregular_images
+        expected = [
+          { :cssx => 0, :cssy =>   0, :cssw => 100, :cssh => 100, :x => 40, :y =>  25 },
+          { :cssx => 0, :cssy => 100, :cssw => 100, :cssh => 100, :x => 30, :y => 130 },
+          { :cssx => 0, :cssy => 200, :cssw => 100, :cssh => 100, :x => 20, :y => 235 },
+          { :cssx => 0, :cssy => 300, :cssw => 100, :cssh => 100, :x => 10, :y => 340 },
+          { :cssx => 0, :cssy => 400, :cssw => 100, :cssh => 100, :x =>  0, :y => 445 }
+        ]
+        verify_layout(100, 500, expected, images, :layout => :vertical, :width => 100, :height => 100)
+      end
+
+      #--------------------------------------------------------------------------
+
+    end # class VerticalTest
+  end # module Layout
+end # module SpriteFactory
+