mapkit 0.0.1 → 0.0.2

data/lib/mapkit.rb

@@ -25,7 +25,7 @@ module MapKit
   RESOLUTION = 2 * Math::PI * EARTH_RADIUS / TILE_SIZE
   
   # version of MapKit
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
   
   # The class represents an lat/lng point
   class Point

data/lib/tilekit.rb

@@ -1,17 +1,27 @@
 require File.dirname(__FILE__) + "/mapkit"
 require "gd2"
 
+# this module helps drawing icons on tile images
 module TileKit
+  # this class represents an icon that can be drawn on an Image
   class Icon
     attr_reader :image, :size
     
+    # initializes the icon with a path, image size [width, height], the peak#
+    # position (where the pointer should be placed) [x, y] and a bounding box
+    # that represents a clickable area
+    # path:: the path of the image (test.png)
+    # size:: the size of the immage as array [width, height]
+    # peak_position:: the peak position as array [x, y]
+    # clickable_area:: the clickable area of the icon as array [top, left, bottom, right]
     def initialize(path, size, peak_position, clickable_area)
-      @image = GD2::Image.import("images/gas.png")
+      @image = GD2::Image.import(path)
       @size_x, @size_y = size
       @peak_x, @peak_y = peak_position
       @shift_x, @shift_y, @width, @height = clickable_area
     end
     
+    # draws the icon on the canvas at passed position (x, y)
     def draw(canvas, x, y)
       # position icon at peak point
       x, y = x - @peak_x, y - @peak_y
@@ -20,6 +30,8 @@ module TileKit
       canvas.copy_from(@image, x, y, 0, 0, @size_x, @size_y)
     end
     
+    # returns a boundingbox (with lat/lng) that contains the bounds of the
+    # image for the passed position
     def bounding_box(lat, lng, zoom)
       top, left = MapKit.shift_latlng(lat, lng, @shift_x - @peak_x, @shift_y - @peak_y, zoom)
       bottom, right = MapKit.shift_latlng(top, left, @width, @height, zoom)
@@ -27,9 +39,12 @@ module TileKit
     end
   end
   
+  # this image class represents a tile in the google maps
   class Image
     attr_reader :canvas, :bounding_box
     
+    # initialize the image with a (lat/lng) bounding box of the tile it
+    # represents
     def initialize(bounding_box)
       @bounding_box = bounding_box
       
@@ -44,12 +59,13 @@ module TileKit
       end
     end
     
-    # draw icon at position
+    # draws passed icon at passed position
     def draw_icon(point, icon)
       x, y = point.pixel(@bounding_box)
       icon.draw(@canvas, x, y)
     end
-    
+
+    # returns the png binary string of the image
     def png
       @canvas.png
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mapkit
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Vincent Landgraf
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-10 00:00:00 +01:00
+date: 2010-02-11 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency