puzzlize 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional.
+environment_id="ruby-1.9.3-p0"
+
+#
+# Uncomment following line if you want options to be set only for given project.
+#
+# PROJECT_JRUBY_OPTS=( --1.9 )
+
+#
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+#
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+
+  if [[ -s "${rvm_path:-$HOME/.rvm}/hooks/after_use" ]]
+  then
+    . "${rvm_path:-$HOME/.rvm}/hooks/after_use"
+  fi
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  if ! rvm --create  "$environment_id"
+  then
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  fi
+fi
+
+#
+# If you use an RVM gemset file to install a list of gems (*.gems), you can have
+# it be automatically loaded. Uncomment the following and adjust the filename if
+# necessary.
+#
+# filename=".gems"
+# if [[ -s "$filename" ]]
+# then
+#   rvm gemset import "$filename" | grep -v already | grep -v listed | grep -v complete | sed '/^$/d'
+# fi
+
+# If you use bundler, this might be useful to you:
+# if command -v bundle && [[ -s Gemfile ]]
+# then
+#   bundle install
+# fi
+
+if [[ $- == *i* ]] # check for interactive shells
+then
+    echo "Using: $(tput setaf 2)$GEM_HOME$(tput sgr0)" # show the user the ruby and gemset they are using in green
+else 
+	echo "Using: $GEM_HOME" # don't use colors in interactive shells
+fi
+

data/CHANGELOG

@@ -0,0 +1,3 @@
+## v0.0.1
+
+* Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in puzzlize.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2012 Ziemek Wolski
+
+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,76 @@
+# Puzzlizer
+
+## 	Description
+
+Puzzlizer allows you to create a puzzle from an upload image. It uses RMagic to cut up the image and provides helper function to allows the user to move the pieces around to solve the puzzle. 
+
+##	Installation
+
+Edit you gem file add puzzlize to it.
+
+```ruby
+gem "puzzlize"
+```
+	
+Alternatively you could install the gem yourself:
+
+```ruby
+console:
+gem install puzzlize
+```
+
+##	Usage
+
+Before you start you will need to add a migration on the model that you want to use:
+
+```ruby
+console:
+rails g migration add_puzzle_columns
+```
+  
+Inside the migration you will need (assuming that your model is Painting):
+
+```ruby
+def self.up
+  change_table :paintings do |t|
+    t.add_puzzlize_columns
+  end
+end
+
+def self.down
+  remove_puzzlize_columns :paintings
+end
+```
+  
+Inside your model you will need:
+
+```ruby
+class Painting < ActiveRecord::Base
+  has_attached_file :image, {:styles => { :medium => "800x800>" }}.merge(PAPERCLIP_STORAGE_OPTIONS) <-- after paperclip
+  puzzlize :image
+end
+```
+
+If you are not using paperclip and your image object does not have access to `image.path(:medium)` and `image.url(:medium)` you must overwritte these two methods in your model.
+
+```ruby
+class Painting < ActiveRecord::Base
+
+	def default_puzzle_image_url
+	  // Replacement code for --- image.url(:medium) ---
+	end
+
+	def default_puzzle_image_path
+	  // Replacement code for --- image.path(:medium) ---
+	end
+end
+```
+
+in the show/view:
+
+```ruby
+  puzzlize_javascript_and_css(@painting)
+  puzzlize_show_puzzle(@painting)
+```
+  
+where @painting is model object.

data/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task default: :spec

data/lib/puzzlize.rb

@@ -0,0 +1,6 @@
+require "puzzlize/model_additions"
+require "puzzlize/version"
+require "puzzlize/cutter"
+require "puzzlize/action_view_helpers"
+require "puzzlize/schema"
+require "puzzlize/railtie" if defined? Rails

data/lib/puzzlize/action_view_helpers.rb

@@ -0,0 +1,89 @@
+module Puzzlize
+  module ViewHelpers
+  	def puzzlize_javascript_and_css(puzzle)
+  	  droppable_function = puzzle.puzzle_pieces_names.collect do |name|
+
+  			  		"$('#i-#{name}').draggable({helper:'original', handle:'.drag'}); 
+  			  		$('#s-#{name} > .sensible').droppable({
+  			  		 accept: '#i-#{name}',
+  			  		 tolerance: 'intersect',
+  			  		 activeClass: 'droppable-active',
+  			  		 hoverClass: 'droppable-hover',
+  			  		 drop: function() { 
+  			  			$('#s-#{name}').addClass('s-#{name}');
+  			  		 	$('#s-#{name}').addClass('encastrada');
+  			  			$('#i-#{name}').remove();
+  			  		 }
+  			  		 });"
+      end.join(" ")
+
+      droppable_css = ""
+      image_urls = puzzle.puzzle_images_urls
+  		puzzle.puzzle_pieces_names.each_with_index do |name, index|
+    		droppable_css += ".s-#{name} {
+    			background-image:url(#{image_urls[index]});
+    			background-repeat:no-repeat;
+    			background-position:center center;
+    		}"
+    	end
+
+      "<script type='text/javascript'>
+  			  // Javascript library made by:
+  			  // Fernando.com.ar 
+  			  // http://www.fernando.com.ar/jquery-puzzle/index.php
+
+  				$(document).ready(function(){
+  				  #{droppable_function}
+            });
+
+  			</script>
+  			<style type='text/css'>
+        #{droppable_css}
+  			.drag{
+  				width:#{puzzle.horizontal_piece_size}px;
+  				height:#{puzzle.vertical_piece_size}px;
+  			}
+  			.sensible{
+  				width:#{puzzle.horizontal_piece_size}px;
+  				height:#{puzzle.vertical_piece_size}px;
+  				border:0px solid red;
+  			}
+  			#canvas{
+  				width:#{puzzle.image_width}px;
+  				height:#{puzzle.image_height}px;
+  				background-color:#A5A5A5;
+  				float:left;
+  			}
+  			#canvasFinal{
+  				width:#{puzzle.image_width}px;
+  				height:#{puzzle.image_height}px;
+  				background-image:url(#{ puzzle.default_puzzle_image_url});
+  				background-repeat:no-repeat;
+  				background-position:center center;
+  				float:left;
+  				position:absolute;
+  				display:none;
+  				z-index:9;
+  			}
+  			</style>".html_safe
+  	end
+
+  	def puzzlize_show_puzzle(puzzle)
+  	  puzzle_pieces_html = ""
+  		puzzle.puzzle_pieces_names.each do |name|
+    		puzzle_pieces_html += "
+    		<div class='s-#{name}' id='i-#{name}' style='width:#{puzzle.horizontal_piece_size}px; height:#{puzzle.vertical_piece_size}px; position:absolute; top:#{134 + rand(320)}px; left:#{rand(180)}px;' >
+    		  <div class='drag'></div>
+    		</div>"
+  		end
+
+     "<div>
+        <div class='puzzle' style='width:660px;'>
+          <div style='width:390px; height:450px; background-color:#FFF; float:left;'>
+            #{puzzle_pieces_html}
+          </div>
+        </div>
+      </div>".html_safe
+  	end
+  end
+end

data/lib/puzzlize/cutter.rb

@@ -0,0 +1,199 @@
+module Puzzlize
+  class Cutter
+    CONNECTOR_TOP_PATTERN = [-1, -1 ,1]
+    CONNECTOR_RIGHT_PATTERN = [1, 1, -1]
+    attr_accessor :piece_size, :image_width, :image_height
+    
+    #piece size including all connectors and white space
+    def real_piece_size
+      piece_size + connector_size
+    end
+    
+    def horizontal_pieces
+      (image_width / piece_size).to_i
+    end
+
+    def vertical_pieces
+      (image_height / piece_size).to_i
+    end
+    
+    def connector_size
+      @connector_size ||= (piece_size * 0.2).to_i
+    end
+    
+    def connector_radius
+      return connector_size / 2
+    end
+    
+    def get_piece_matrix
+      matrix = []
+      vertical_pieces.times do |y_axis|
+        horizontal_pieces.times do |x_axis|
+          matrix << piece_points(x_axis, y_axis)
+        end
+      end
+      matrix
+    end
+
+    def piece_points(row_x , row_y, include_connector_size = true)
+      # the pieces should overlap so we have a way to make the connector
+      start_point_x = row_x * piece_size
+      start_point_y = row_y * piece_size
+      # if by adding the connector buffer we have gone passed the edge of the image
+      # go back to the edge of the image.
+      piece_width = piece_size 
+      piece_height = piece_size
+      end_point_x = start_point_x + piece_width
+      end_point_y = start_point_y + piece_height
+      
+      #translating number of pieces to positions
+      horizontal_position = horizontal_pieces - 1
+      vertical_position = vertical_pieces - 1
+      
+      if include_connector_size
+        start_point_x -= connector_radius if row_x > 0
+        start_point_y -= connector_radius if row_y > 0
+
+        # if the piece are not on the edges, they are bigger by the radius of the connector.
+        piece_width += connector_radius if row_x < horizontal_position
+        piece_height += connector_radius if row_y < vertical_position
+        
+        piece_width += connector_radius if row_x > 0 
+        piece_height += connector_radius if row_y > 0
+      end
+
+      [start_point_x, start_point_y, piece_width, piece_height]
+    end
+    
+    def get_connector_locations_matrix
+      matrix = []
+      vertical_pieces.times do |y_axis|
+        horizontal_pieces.times do |x_axis|
+          matrix << connector_locations(x_axis, y_axis)
+        end
+      end
+      matrix
+    end
+    
+    def connector_locations(row_x, row_y)
+      points = []
+      mid = piece_size / 2
+      width = piece_size
+      height = piece_size
+      cr = connector_radius
+      vertical_position = vertical_pieces - 1
+      horizontal_position = horizontal_pieces - 1
+      
+      points << (row_y == 0 ? nil : [mid, 0])
+      points << (row_y == vertical_position ? nil : [mid, height])
+      points << (row_x == 0 ? nil : [0, mid])
+      points << (row_x == horizontal_position ? nil : [width, mid])
+      
+      if row_y > 0
+        points[0][1] += cr unless points[0].nil?
+        points[1][1] += cr unless points[1].nil?
+        points[2][1] += cr unless points[2].nil?
+        points[3][1] += cr unless points[3].nil?
+      end
+      
+      if row_x > 0 
+        #use loop
+        points[0][0] += cr unless points[0].nil?
+        points[1][0] += cr unless points[1].nil?
+        points[2][0] += cr unless points[2].nil?
+        points[3][0] += cr unless points[3].nil?
+      end
+      points
+    end
+    
+    def get_rectangle_matrix
+      matrix = []
+      vertical_pieces.times do |y_axis|
+        horizontal_pieces.times do |x_axis|
+          matrix << rectangle_locations(x_axis, y_axis)
+        end
+      end
+      matrix
+    end
+    
+    def rectangle_locations(row_x, row_y)
+      points = []
+      width = piece_size
+      height = piece_size
+      cr = connector_radius
+      vertical_position = vertical_pieces - 1
+      horizontal_position = horizontal_pieces - 1
+      
+      
+      points << (row_y == 0 ? nil : [0,0, width, cr])
+      points << (row_y == vertical_position ? nil : [0,height, width, height + cr])
+      points << (row_x == 0 ? nil : [0,0, cr, height])
+      points << (row_x == horizontal_position ? nil : [width, 0, width + cr, height])
+      
+      if row_x > 0
+        points[0][2] += cr unless points[0].nil?
+        points[1][2] += cr unless points[1].nil?
+        
+        points[3][0] += cr unless points[3].nil?
+        points[3][2] += cr unless points[3].nil?
+      end
+      
+      if row_x <  horizontal_position
+        points[0][2] += cr unless points[0].nil?
+        points[1][2] += cr unless points[1].nil?
+      end
+      
+      if row_y > 0
+        points[1][1] += cr unless points[1].nil?
+        points[1][3] += cr unless points[1].nil?
+        
+        points[2][3] += cr unless points[2].nil?
+        
+        points[3][3] += cr unless points[3].nil?
+      end
+      
+      if row_y < vertical_position
+        points[2][3] += cr unless points[2].nil?
+        points[3][3] += cr unless points[3].nil?
+      end
+      
+      points
+    end
+        
+    def connector_types(row_x, row_y)
+      # Pattern based connectors
+      # Top and right connector can be anything. We determine this based on a pattern.
+      top = connector_top(row_x, row_y)
+      right = connector_right(row_x, row_y)
+
+      # Fitter connectors
+      # left and bottom connectors need are fitters. Meaning they might fit to was on top and to the right.
+      # I determine this by shifting to that piece and looking at either the top or right piece and getting the
+      # opposite of that piece. If that piece is at the border we return nil.
+      left = row_x - 1 >= 0 ? (connector_right(row_x -1, row_y) * -1) : nil
+      bottom = row_y - 1 >= 0 ? (connector_top(row_x, row_y - 1) * -1) : nil
+      
+      [bottom, top , left, right]
+    end
+    
+    def connector_top(row_x, row_y)
+      # -1 because it's a count vs location starting at 0.
+      return nil if vertical_pieces - 1 == row_y
+      CONNECTOR_TOP_PATTERN[row_x % CONNECTOR_TOP_PATTERN.size]
+    end
+    
+    def connector_right(row_x, row_y)
+      # -1 because it's a count vs location starting at 0.
+      return nil if horizontal_pieces - 1 == row_x
+      CONNECTOR_RIGHT_PATTERN[row_x % CONNECTOR_RIGHT_PATTERN.size]
+    end
+    
+    def piece_fitting_diamentions
+      horizontal = horizontal_pieces * piece_size
+      vertical = vertical_pieces * piece_size
+      self.image_width = horizontal
+      self.image_height = vertical
+      [0, 0,horizontal ,vertical ]
+    end
+  end
+end