rhex 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4ac3d4d8d088a7768944a17333a84e919cccbe90
+  data.tar.gz: efe7f5882be4b63ab5d82f6a8c04c43412914700
+SHA512:
+  metadata.gz: e810250b0a6685019323ca1b531650a388ea24c78669709bda722b806f9842523d8919ceafa1512c8d48fde754221433832c8116e9c088aeaaa95707d0a4c83e
+  data.tar.gz: d08dc31236178532f633264c7963e717d8ec381f90b36ebc1a350451864c397cc75ae1377cf1b35c4a3efa3bc82c7eed3798556fb7fc37b375befcf3851c64df

data/lib/hex/axial.rb

@@ -0,0 +1,88 @@
+# -*- encoding : utf-8 -*-
+require 'hex/cube'
+
+module Hex
+  class Axial
+
+    attr_reader :q, :r
+
+    R = 16
+
+    # Directions around hex from top left clockwise
+    DIRECTIONS = [ [0,-1], [1,-1], [1,0], [0,1], [-1,+1], [-1,0] ]
+
+    # Create a new flat topped axial represented hexagon object
+    def initialize(q,r)
+      @q = q
+      @r = r
+    end
+
+    # Equality between two hexagones
+    def ==(h)
+      @q==h.q && @r==h.r
+    end
+
+    # Create an hexagon object from (x,y) coordinate
+    def self.hex_at_xy(x, y)
+      x-=R
+      y-=R
+      q = x * 2/3 / R
+      r = (-x / 3 + Math.sqrt(3)/3 * y) / R
+      Hex::Axial.new(q, r).round
+    end
+
+    # Give the position of an hexagone object in pixel
+    def to_xy
+      x = R * 3/2 * @q
+      y = ( ( R.to_f * Math.sqrt(3) ).round * (@r.to_f + @q.to_f/2.to_f) )
+      [ x, y ]
+    end
+
+    # Transform flat topped axial represented hexagon object to flat topped cube represented hexagon object
+    def to_cube
+      Hex::Cube.new(@q,-@q-@r,@r)
+    end
+
+    # From an array of hexagones, get the nearest
+    def nearest_hex( hex_array )
+      nearest_hex = nil
+      current_distance = nil
+      hex_array.each do |h|
+        unless nearest_hex
+          nearest_hex = h
+          current_distance = distance( h )
+        else
+          nearest_hex = h if distance( h ) < current_distance
+        end
+      end
+      nearest_hex
+    end
+
+    # Get the distance (in hex) between two hexagons
+    def distance( h )
+      to_cube.distance(h.to_cube)
+    end
+
+    # Get all hexagons surrounding the current hexagon
+    def get_surrounding_hexs
+      # puts self.inspect, self.q.inspect, self.r.inspect
+      DIRECTIONS.map{ |e| Hex::Axial.new( @q+e[0], @r+e[1] ) }
+    end
+
+    # Check if an hexagon is around another exagon
+    def hex_surrounding_hex?(hex)
+      distance(hex)==1
+    end
+
+    private
+
+    # Round an hexagone coordinates (useful after pixel to axial coordinate transformation)
+    def round
+      to_cube.round.to_axial
+    end
+
+  end
+end
+
+
+

data/lib/hex/cube.rb

@@ -0,0 +1,42 @@
+module Hex
+  class Cube
+
+    attr_reader :x,:y,:z
+
+    def initialize(x,y,z)
+      @x = x
+      @y = y
+      @z = z
+    end
+
+    # Transform a cube represented hexagon to an Hexagon::Axial represented hexagon
+    def to_axial
+      Hex::Axial.new(@x,@z)
+    end
+
+    # Round an float coordonate hexagon to an integer hexagon
+    def round
+      rx=@x.round(0)
+      ry=@y.round(0)
+      rz=@z.round(0)
+
+      x_diff=(rx-@x).abs
+      y_diff=(ry-@y).abs
+      z_diff=(rz-@z).abs
+
+      if x_diff > y_diff and x_diff > z_diff
+        rx = -ry-rz
+      elsif y_diff > z_diff
+        ry = -rx-rz
+      else
+        rz = -rx-ry
+      end
+      Hex::Cube.new(rx,ry,rz)
+    end
+
+    def distance(h)
+      [(@x - h.x).abs, (@y - h.y).abs, (@z - h.z).abs].max
+    end
+
+  end
+end

data/lib/hex/grid.rb

@@ -0,0 +1,42 @@
+require 'hex/axial'
+
+module Hex
+  class Grid
+    def initialize
+      @hexes={}
+    end
+
+    # Position aa value at hexagon coordinate
+    # You can use the form set( q, r, value )
+    # Or set( hex, value )
+    # In both case value can be nil.
+    def set( *args )
+      raise ArgumentError, 'Incorrect number of arguments' if args.length < 1 || args.length > 3
+      fa=args.shift
+      if fa.class == Hex::Axial
+        @hexes[ [ fa.q, fa.r ] ] = args.shift
+      else
+        q=fa
+        r=args.shift
+        @hexes[ [ q, r ] ] = args.shift
+      end
+    end
+
+    # Get the value of stored at hexagon coordinate
+    # You can use the form set( q, r, value )
+    # Or set( hex, value )
+    # In both case value can be nil.
+    def get( *args )
+      raise( ArgumentError, 'Incorrect number of arguments' ) if args.length < 1 || args.length > 2
+      fa=args.shift
+      if fa.class == Hex::Axial
+        @hexes[ [ fa.q, fa.r ] ]
+      else
+        q=fa
+        r=args.shift
+        @hexes[ [ q, r ] ]
+      end
+    end
+
+  end
+end

data/lib/rhex.rb

@@ -0,0 +1,3 @@
+require 'hex/axial'
+require 'hex/cube'
+require 'hex/grid'

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: rhex
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Cédric ZUGER
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-23 00:00:00.000000000 Z
+dependencies: []
+description: A library designed to provide hexagonal grids for ruby
+email: zuger.cedric@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/hex/axial.rb
+- lib/hex/cube.rb
+- lib/hex/grid.rb
+- lib/rhex.rb
+homepage: http://rubygems.org/gems/rhex
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.1
+signing_key: 
+specification_version: 4
+summary: Ruby HEXagonal grid
+test_files: []