cheers 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.DS_Store
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Tom-Eric Gerritsen
+
+MIT License
+
+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,59 @@
+Cheers
+======
+
+Cheers randomly generates user avatars from a set of colors and image components.
+
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_1.png" alt="Example Avatar #1" width="100" height="100"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_2.png" alt="Example Avatar #2" width="100" height="100"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_3.png" alt="Example Avatar #3" width="100" height="100"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_4.png" alt="Example Avatar #4" width="100" height="100"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_5.png" alt="Example Avatar #5" width="100" height="100">
+
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_6.png" alt="Example Avatar #6" width="75" height="75"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_7.png" alt="Example Avatar #7" width="75" height="75"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_8.png" alt="Example Avatar #8" width="75" height="75"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_9.png" alt="Example Avatar #9" width="75" height="75"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_10.png" alt="Example Avatar #10" width="75" height="75">
+
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_11.png" alt="Example Avatar #11" width="50" height="50"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_12.png" alt="Example Avatar #12" width="50" height="50"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_13.png" alt="Example Avatar #13" width="50" height="50"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_14.png" alt="Example Avatar #14" width="50" height="50"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_15.png" alt="Example Avatar #15" width="50" height="50">
+
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_16.png" alt="Example Avatar #16" width="25" height="25"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_17.png" alt="Example Avatar #17" width="25" height="25"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_18.png" alt="Example Avatar #18" width="25" height="25"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_19.png" alt="Example Avatar #19" width="25" height="25"> 
+<img src="https://github.com/eet-nu/cheers/raw/master/doc/example_20.png" alt="Example Avatar #20" width="25" height="25">
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'cheers'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cheers
+
+## Usage
+
+````ruby
+require 'cheers'
+
+avatar = Cheers::Avatar.new("martins@eet.nu")
+avatar.avatar_file("avatar.png")
+````
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/cheers.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/cheers/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ['Mārtiņš Spilners']
+  gem.email         = ['martins@eet.nu']
+  gem.description   = %q{Cheers randomly generates user avatars from a set of colors and image components.}
+  gem.summary       = %q{Generate random user avatars.}
+  gem.homepage      = 'http://github.com/eet-nu/cheers'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = 'cheers'
+  gem.require_paths = ['lib']
+  gem.version       = Cheers::VERSION
+  
+  gem.add_dependency 'rmagick'
+end

data/lib/cheers.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH << File.expand_path('../', __FILE__)
+
+module Cheers
+  autoload :VERSION, 'cheers/version'
+  autoload :Color,   'cheers/color'
+  autoload :Avatar,  'cheers/avatar'
+end

data/lib/cheers/avatar.rb

@@ -0,0 +1,161 @@
+require 'RMagick'
+require 'digest/sha1'
+require 'tempfile'
+
+module Cheers
+  class Avatar
+    GEM_ROOT = File.expand_path('../../../', __FILE__)
+    
+    BACKGROUND_COLORS = ['#cccccc', '#dddddd', '#bbbbbb', '#F1A800', '#FEF0CC', '#fd4238', '#fff0f0', '#14899d', '#c3ecee', '#42991a', '#f0fff0']
+    # SMILE_COLORS = ['#333', '#666', '#9e005d', '#ef8200', '#d8a129', '#db4640', '#0e788b', '#239340']
+    SMILE_COLORS = ['#333333', '#666666', '#9e005d', '#ef8200', '#db4640', '#0e788b', '#239340']
+    IMAGES = {
+      
+      smiles: [
+        { smile:      'components/mouths/1-smile.png',
+          smile_glow: 'components/mouths/1-smile-glow.png',
+          bg_mask:    'components/mouths/1-bgmask.png',
+          texture:    'components/texture.png' },
+        { smile:      'components/mouths/2-smile.png',
+          smile_glow: 'components/mouths/2-smile-glow.png',
+          bg_mask:    'components/mouths/2-bgmask.png',
+          texture:    'components/texture.png' },
+        { smile:      'components/mouths/3-smile.png',
+          smile_glow: 'components/mouths/3-smile-glow.png',
+          bg_mask:    'components/mouths/3-bgmask.png',
+          texture:    'components/texture.png' }
+      ],
+      eyes: [
+        { eyes: 'components/eyes/1.png' },
+        { eyes: 'components/eyes/2.png' },
+        { eyes: 'components/eyes/3.png' },
+        { eyes: 'components/eyes/4.png' },
+        { eyes: 'components/eyes/5.png' }
+      ],
+      decorations: [
+        { id: 1, decoration: 'components/decorations/1.png' },
+        { id: 2, decoration: 'components/decorations/2.png' }
+      ]
+    }
+    
+    # Creates a new avatar from the seed string
+    def initialize(seed)
+      @seed = Digest::SHA1.hexdigest(seed).to_i(16)
+    end
+    
+    # Writes avatar image at the provided file path
+    def avatar_file(file_path)
+      compose_avatar
+      
+      @avatar.write(file_path)
+      
+      file_path
+    end
+    
+    private
+    
+    def compose_avatar #:nodoc:
+      random_generator = Random.new(@seed)
+      
+      # 0. Let's get some random colors
+      # We shoudn't change the order we call #rand to keep version changes minimal
+      avatar_bg_color  = BACKGROUND_COLORS.sample(random: random_generator)
+      smile_components = IMAGES[:smiles].sample(random: random_generator)
+      smile_bg_color   = BACKGROUND_COLORS.sample(random: random_generator)
+      # smile_color      = SMILE_COLORS.sample(random: random_generator)
+      # eyes_color       = SMILE_COLORS.sample(random: random_generator)
+      eyes_components  = IMAGES[:eyes].sample(random: random_generator)
+      smile_upper_glow_color = SMILE_COLORS.sample(random: random_generator)
+      smile_lower_glow_color = SMILE_COLORS.sample(random: random_generator)
+      has_decoration   = [true, true, false].sample(random: random_generator)
+      decoration_component = IMAGES[:decorations].sample(random: random_generator)
+      decoration_color = BACKGROUND_COLORS.sample(random: random_generator)
+      
+      # Lets test if the color behind eyes is very similar to the eye color.
+      # Generate a new eye color if that's the case.
+      eyes_contrasting_color = if has_decoration and decoration_component[:id] == 1
+        decoration_color
+      else
+        avatar_bg_color
+      end
+      
+      # Lets not use the same random generator for generating unknown amount of new colors
+      rng = Random.new(random_generator.rand(10000)) 
+      begin
+        eyes_color = SMILE_COLORS.sample(random: rng)
+      end while Color.new(eyes_color).similar?(eyes_contrasting_color, 0.2)
+      
+      # Lets test if the background colors are very similar to the smile color.
+      # Change the smile color if that's the case, right?
+      rng = Random.new(random_generator.rand(10000))
+      begin
+        smile_color = SMILE_COLORS.sample(random: rng)
+        the_smile_color = Color.new(smile_color)
+      end while the_smile_color.similar?(avatar_bg_color, 0.2) or the_smile_color.similar?(smile_bg_color, 0.2)
+      
+      
+      # 1. Lets create upper background
+      upper_background = Magick::Image.new(512, 512) { self.background_color = avatar_bg_color }
+      
+      # This is smile glow mask
+      smile_glow_image = Magick::Image.read(component_path(smile_components[:smile_glow]))[0]
+      
+      # Create smile glow layer and put it on upper background
+      smile_upper_glow = Magick::Image.new(512, 512) { self.background_color = smile_upper_glow_color }
+      upper_background.add_compose_mask(smile_glow_image)
+      upper_background.composite!(smile_upper_glow, 0, 0, Magick::OverCompositeOp)
+      upper_background.delete_compose_mask
+      
+      
+      # 2. Lets create lower background
+      lower_background = Magick::Image.new(512, 512) { self.background_color = smile_bg_color }
+      
+      # Create another smile glow layer but put it on lower background
+      smile_lower_glow = Magick::Image.new(512, 512) { self.background_color = smile_lower_glow_color }
+      lower_background.add_compose_mask(smile_glow_image)
+      lower_background.composite!(smile_lower_glow, 0, 0, Magick::OverCompositeOp)
+      lower_background.delete_compose_mask
+      
+      
+      # 3. Lets compose both backgrounds together
+      
+      # This will be the final avatar image.
+      # Because we will draw the lower background over the upper background,
+      # we can use the upper background as the starting image.
+      avatar = upper_background
+      
+      # Lets mask and put the lower background on top of the image
+      avatar.add_compose_mask(Magick::Image.read(component_path(smile_components[:bg_mask]))[0])
+      avatar.composite!(lower_background, 0, 0, Magick::OverCompositeOp)
+      avatar.delete_compose_mask
+      
+      # 4. Add decorations
+      if has_decoration
+        decoration = Magick::Image.new(512, 512) { self.background_color = decoration_color }
+        avatar.add_compose_mask(Magick::Image.read(component_path(decoration_component[:decoration]))[0])
+        avatar.composite!(decoration, 0, 0, Magick::OverCompositeOp)
+        avatar.delete_compose_mask
+      end
+      
+      # 5. Add the texture
+      texture = Magick::Image.read(component_path(smile_components[:texture]))[0]
+      avatar.composite!(texture, 0, 0, Magick::OverCompositeOp)
+      
+      smile = Magick::Image.new(512, 512) { self.background_color = smile_color }
+      avatar.add_compose_mask(Magick::Image.read(component_path(smile_components[:smile]))[0])
+      avatar.composite!(smile, 0, 0, Magick::OverCompositeOp)
+      avatar.delete_compose_mask
+      
+      eyes = Magick::Image.new(512, 512) { self.background_color = eyes_color }
+      avatar.add_compose_mask(Magick::Image.read(component_path(eyes_components[:eyes]))[0])
+      avatar.composite!(eyes, 0, 0, Magick::OverCompositeOp)
+      avatar.delete_compose_mask
+      
+      @avatar = avatar
+    end
+    
+    def component_path(asset) #:nodoc:
+      [GEM_ROOT, asset].join('/')
+    end
+  end
+end

data/lib/cheers/color.rb

@@ -0,0 +1,57 @@
+module Cheers
+  
+  # Represents a color and allows to compare to others (maybe)
+  class Color
+    attr_accessor :r, :g, :b
+    
+    # Create new color from a hex value
+    def initialize(color = '#000000')
+      hex_string = color[1..6]
+      self.r = hex_string[0..1].to_i(16)
+      self.g = hex_string[2..3].to_i(16)
+      self.b = hex_string[4..5].to_i(16)
+    end
+    
+    # 
+    def to_s
+      return '#' + r.to_s(16) + g.to_s(16) + b.to_s(16)
+    end
+    
+    def to_hsv
+      red, green, blue = [r, g, b].collect {|x| x / 255.0}
+      max = [red, green, blue].max
+      min = [red, green, blue].min
+    
+      if min == max
+        hue = 0
+      elsif max == red
+        hue = 60 * ((green - blue) / (max - min))
+      elsif max == green
+        hue = 60 * ((blue - red) / (max - min)) + 120
+      elsif max == blue
+        hue = 60 * ((red - green) / (max - min)) + 240
+      end
+    
+      saturation = (max == 0) ? 0 : (max - min) / max
+      [hue % 360, saturation, max]
+    end
+    
+    def similar?(other_color, threshold)
+      other_color = Color.new(other_color) unless other_color.is_a? Color
+      
+      color_hsv       = to_hsv
+      other_color_hsv = other_color.to_hsv
+      
+      d_hue        = (color_hsv[0] - other_color_hsv[0]).abs / 360
+      d_saturation = (color_hsv[1] - other_color_hsv[1]).abs
+      d_value      = (color_hsv[2] - other_color_hsv[2]).abs
+      
+      if d_hue <= threshold and d_saturation <= threshold and d_value <= threshold
+        true
+      else
+        false
+      end
+    end
+  end
+  
+end

data/lib/cheers/version.rb

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

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: cheers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Mārtiņš Spilners
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: &70319637709080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70319637709080
+description: Cheers randomly generates user avatars from a set of colors and image
+  components.
+email:
+- martins@eet.nu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- cheers.gemspec
+- components/decorations/1.png
+- components/decorations/2.png
+- components/eyes/1.png
+- components/eyes/2.png
+- components/eyes/3.png
+- components/eyes/4.png
+- components/eyes/5.png
+- components/mouths/1-bgmask.png
+- components/mouths/1-smile-glow.png
+- components/mouths/1-smile.png
+- components/mouths/2-bgmask.png
+- components/mouths/2-smile-glow.png
+- components/mouths/2-smile.png
+- components/mouths/3-bgmask.png
+- components/mouths/3-smile-glow.png
+- components/mouths/3-smile.png
+- components/texture.png
+- doc/example_1.png
+- doc/example_10.png
+- doc/example_11.png
+- doc/example_12.png
+- doc/example_13.png
+- doc/example_14.png
+- doc/example_15.png
+- doc/example_16.png
+- doc/example_17.png
+- doc/example_18.png
+- doc/example_19.png
+- doc/example_2.png
+- doc/example_20.png
+- doc/example_3.png
+- doc/example_4.png
+- doc/example_5.png
+- doc/example_6.png
+- doc/example_7.png
+- doc/example_8.png
+- doc/example_9.png
+- lib/cheers.rb
+- lib/cheers/avatar.rb
+- lib/cheers/color.rb
+- lib/cheers/version.rb
+homepage: http://github.com/eet-nu/cheers
+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.17
+signing_key: 
+specification_version: 3
+summary: Generate random user avatars.
+test_files: []