color-generator 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+.yardoc
+Gemfile.lock
+doc/*
+pkg/*

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Open North Inc.
+
+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,27 @@
+# Ruby Color Generator
+
+[![Dependency Status](https://gemnasium.com/opennorth/color-generator.png)](https://gemnasium.com/opennorth/color-generator)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/opennorth/color-generator)
+
+This gem randomly generates very distinct colors with consistent lightness and saturation.
+
+If you are using these colors as background colors, consistent lightness lets you use the same foreground color for each. Consistent saturation lets you avoid mixing pastels with vibrant colors, etc.
+
+## Usage
+
+    require 'color-generator'
+    generator = ColorGenerator.new 0.3, 1.0
+    color1 = generator.create
+    # => "f7b3ff"
+    color2 = generator.create
+    # => "b3ffe0"
+
+## Acknowledgements
+
+Thanks to Martin Ankerl for his [blog post](http://martin.ankerl.com/2009/12/09/how-to-create-random-colors-programmatically/) which inspired this gem.
+
+## Bugs? Questions?
+
+This gem's main repository is on GitHub: [http://github.com/opennorth/color-generator](http://github.com/opennorth/color-generator), where your contributions, forks, bug reports, feature requests, and feedback are greatly welcomed.
+
+Copyright (c) 2012 Open North Inc., released under the MIT license

data/Rakefile

@@ -0,0 +1,16 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yard do
+    abort 'YARD is not available. In order to run yard, you must: gem install yard'
+  end
+end

data/USAGE

@@ -0,0 +1 @@
+See README.md for full usage details.

data/color-generator.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "color-generator/version"
+
+Gem::Specification.new do |s|
+  s.name        = "color-generator"
+  s.version     = ColorGenerator::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Open North"]
+  s.email       = ["info@opennorth.ca"]
+  s.homepage    = "http://github.com/opennorth/color-generator"
+  s.summary     = %q{Randomly generate distinct colors with consistent lightness and saturation}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency('rspec', '~> 2.10')
+  s.add_development_dependency('rake')
+end

data/lib/color-generator.rb

@@ -0,0 +1,75 @@
+class ColorGenerator
+  GOLDEN_RATIO_CONJUGATE = 0.618033988749895
+
+  attr_reader :hue, :saturation, :value
+
+  # Initializes a color generator.
+  #
+  # @param [Float,Integer] saturation saturation in the interval [0, 1]
+  # @param [Float,Integer] value value in the interval [0, 1]
+  def initialize(saturation, value)
+    @hue        = rand
+    @saturation = saturation.to_f
+    @value      = value.to_f
+  end
+
+  # Generates a random color.
+  #
+  # @return [String] an RGB hex triplet
+  def create
+    @hue += GOLDEN_RATIO_CONJUGATE
+    @hue %= 1
+    '%02x%02x%02x' % self.class.rgb_from_hsv(hue, saturation, value)
+  end
+
+  # Converts a color from HSV to RGB.
+  #
+  # @param [Float] h hue in the interval [0, 1]
+  # @param [Float] s saturation in the interval [0, 1]
+  # @param [Float] v value in the interval [0, 1]
+  # @return [Array] an RGB decimal triplet
+  #
+  # @see http://en.wikipedia.org/wiki/HSL_and_HSV#Converting_to_RGB
+  def self.rgb_from_hsv(h, s, v)
+    c = v * s
+    m = v - c
+    h_prime = h * 6
+    x_prime = v - c * (h_prime % 2 - 1).abs
+
+    # Unlike the Wikipedia article, we add m right away. This reduces the
+    # number of operations to perform. For example, for H' < 1:
+    #
+    # R = R1 + m
+    # R = C + m
+    # R = C + V - C
+    # R = V
+    #
+    # G = G1 + m
+    # G = X + m
+    # G = C (1 - |H' mod 2 - 1|) + m
+    # G = C (1 - |H' mod 2 - 1|) + V - C
+    # G = C - C |H' mod 2 - 1| + V - C
+    # G = V - C |H' mod 2 - 1|
+    #
+    # B = B1 + m
+    # B = 0 + m
+    # B = m
+    #
+    # The blog post above calculates two X values, for when H' mod 2 is
+    # greater or less than 1.
+    case h_prime.to_i
+    when 0 # 0 <= H' < 1
+      [v, x_prime, m]
+    when 1 # 1 <= H' < 2
+      [x_prime, v, m]
+    when 2 # 2 <= H' < 3
+      [m, v, x_prime]
+    when 3 # 3 <= H' < 4
+      [m, x_prime, v]
+    when 4 # 4 <= H' < 5
+      [x_prime, m, v]
+    else # 5 <= H' < 6
+      [v, m, x_prime]
+    end.map{|value| (value * 255).round}
+  end
+end

data/lib/color-generator/version.rb

@@ -0,0 +1,3 @@
+module ColorGenerator
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: color-generator
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Open North
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- info@opennorth.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- USAGE
+- color-generator.gemspec
+- lib/color-generator.rb
+- lib/color-generator/version.rb
+homepage: http://github.com/opennorth/color-generator
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Randomly generate distinct colors with consistent lightness and saturation
+test_files: []
+has_rdoc: