flurin-buttonize 0.1.0 → 0.1.1

data/README

@@ -2,13 +2,12 @@ Buttonize, your favourite button generator.
 ===========================================
 
 Buttonize is a little tool to generate sets of buttons by creating simple image templates (a left side, a repeatable middle
-and a right side). You can use buttonize do create sets of buttons and sets of button styles. See the examples directory
-for more information (examples/buttons.rb is a buttonset file and examples/default/styles.rb is a styleset file)
+and a right side). You can use buttonize to create sets of buttons and sets of button styles. See the examples directory
+for more information (examples/buttons.rb is a buttonset file and examples/default/styles.rb is a styleset file).
 
 
 Installing
 ============
-
 Buttonize has the following dependencies:
 
 * Ruby 1.8.x (not tested in 1.9.x)
@@ -23,17 +22,15 @@ sudo gem install flurin-buttonize --source=http://gems.github.com
 
 Quickstart
 ==========
+For the impatient who just want to generate a blue button (and have all required stuff installed)
 
-For the impatient who just want to generate a blue button (and have all required stuff installed)!
-
-Run: 
+Run:
 buttonize button --style=big_blue "My first button"
 
-and open
+Open:
 my_first_button.gif
 
 
 Copyright & license
 ===================
-
 Copyright (c) 2009 Flurin Egger, DigitPaint, MIT Style License. (see MIT-LICENSE)

data/buttonize.gemspec

@@ -0,0 +1,73 @@
+Gem::Specification.new do |s|
+  s.name      = "buttonize"
+  s.version   = "0.1.1"
+  s.date      = "2009-01-25"
+                
+  s.authors   = ["Flurin Egger"]
+  s.email     = "f.p.egger@gmail.com"
+  s.summary   = "A button generation tool for web applications."
+  s.homepage  = "http://github.com/flurin/buttonize"
+  
+  s.files     = %w( bin/buttonize
+                    buttonize.gemspec
+                    examples/buttons.rb
+                    examples/default/big_blue_left.gif
+                    examples/default/big_blue_middle.gif
+                    examples/default/big_blue_right.gif
+                    examples/default/big_green_left.gif
+                    examples/default/big_green_middle.gif
+                    examples/default/big_green_right.gif
+                    examples/default/big_orange_left.gif
+                    examples/default/big_orange_middle.gif
+                    examples/default/big_orange_right.gif
+                    examples/default/big_red_left.gif
+                    examples/default/big_red_middle.gif
+                    examples/default/big_red_right.gif
+                    examples/default/fonts/Bitstream Vera License.txt
+                    examples/default/fonts/Vera-Bold-Italic.ttf
+                    examples/default/fonts/Vera-Bold.ttf
+                    examples/default/fonts/Vera-Italic.ttf
+                    examples/default/fonts/Vera.ttf
+                    examples/default/small_blue_left.gif
+                    examples/default/small_blue_middle.gif
+                    examples/default/small_blue_right.gif
+                    examples/default/small_green_left.gif
+                    examples/default/small_green_middle.gif
+                    examples/default/small_green_right.gif
+                    examples/default/small_orange_left.gif
+                    examples/default/small_orange_middle.gif
+                    examples/default/small_orange_right.gif
+                    examples/default/small_red_left.gif
+                    examples/default/small_red_middle.gif
+                    examples/default/small_red_right.gif
+                    examples/default/styles.rb
+                    examples/default/table_blue_left.gif
+                    examples/default/table_blue_middle.gif
+                    examples/default/table_blue_right.gif
+                    examples/default/table_green_left.gif
+                    examples/default/table_green_middle.gif
+                    examples/default/table_green_right.gif
+                    examples/default/table_orange_left.gif
+                    examples/default/table_orange_middle.gif
+                    examples/default/table_orange_right.gif
+                    examples/default/table_red_left.gif
+                    examples/default/table_red_middle.gif
+                    examples/default/table_red_right.gif
+                    lib/buttonize/button.rb
+                    lib/buttonize/button_set.rb
+                    lib/buttonize/cli.rb
+                    lib/buttonize/style_set.rb
+                    lib/buttonize.rb
+                    MIT-LICENSE
+                    README
+                  )
+  
+  s.bindir = "bin"
+  s.executables << "buttonize"
+  s.require_paths = ["lib"]
+  
+  s.has_rdoc = false
+  
+  s.add_dependency "rmagick", [">= 2.5.1"]
+  s.add_dependency "wycats-thor", ["~> 0.9.8"]
+end

data/examples/default/styles.rb

@@ -1,18 +1,58 @@
 Buttonize::StyleSet.define(:template_path => File.dirname(__FILE__)) do |set|
+  
+  # Style definition with a block
   set.style(:big_blue) do |s|
-    s.font_size = 10
+    # The name of the template image files the images will be searched for
+    # in s.template_path and will be suffixed with "_left.gif", "_right.gif", "_middle.gif"
+    # (default = button)
     s.template_base = "big_blue"
-    s.paddings = [20,20]
+    
+    # Alternatively you can use template_images to specify the left/middle/right images
+    # with paths relative to the template_path.
+    # s.template_images = ["big_blue_left.gif","big_blue_middle.gif","big_blue_right.gif"]
+
+    # The font to use (can be all fonts RMagick can use), (default = Arial)
+    s.font = File.join(File.dirname(__FILE__),"fonts","Vera.ttf")
+    # Size of the font to use in pt (default = 9)
+    s.font_size = 10
+    # Antialias the font when rendering (default = true)
+    s.font_antialias = true
+    
+    # The color of the textrendering, can be anything RMagick sees as
+    # a color. (default = #fff)
+    s.text_color = "#fff"
+    # The text alignment within the final button, can be any of
+    # :left, :right or :center (default = :center)
+    s.text_align = :center
+    # The x and y offset the text should be rendered with. This
+    # is in relation to the alignment set and can be used to finetune the optical
+    # text placement.
+    s.text_offset = {:x => 0, :y => 0}
+    
+    
+    # If width is set (not nil) Buttonize will try to create a button of 
+    # the specified width, if the text will however not fit (including paddings)
+    # Buttonize falls back on rendering the text with the specified paddings (see below)
+    # (default = nil)
+    s.width = nil
+    # The padding to give the text to the left and right side of the button
+    # specified in an array of [left_padding,right_padding] in pixels. If width
+    # is set and the text width + padding fits into the width, these paddings
+    # will be ignored. (default = {:left => 10, :right => 10})
+    s.padding = {:left => 20, :right => 20}
+    
   end
 
   set.style(:big_orange, :based_on => :big_blue, :template_base => "big_orange")
   set.style(:big_red, :based_on => :big_blue, :template_base => "big_red")
   set.style(:big_green, :based_on => :big_blue, :template_base => "big_green")
-
-  set.style(:small_blue, :font_size => 9, :template_base => "small_blue", :width => 65)
+  
+  # Inline style definition with a Hash
+  set.style(:small_blue, :font => File.join(File.dirname(__FILE__),"fonts","Vera.ttf"), :font_size => 9, :template_base => "small_blue", :width => 65)
   set.style(:small_orange, :based_on => :small_blue, :template_base => "small_orange")
   set.style(:small_red, :based_on => :small_blue, :template_base => "small_red")
   set.style(:small_green, :based_on => :small_blue, :template_base => "small_green")
+  
 end
  
 # Styles = {   

data/lib/buttonize/button.rb

@@ -4,15 +4,17 @@ class Buttonize::Button
   
   def initialize(options)
     @options = {
-      :font_size => 9, 
-      :paddings => [10,10], 
       :width => nil, 
       :template_base => "button",
       :template_path => File.dirname(__FILE__) + "/../../examples/default",        
       :font => "Arial",#File.dirname(__FILE__) + "/fonts/verdanab.ttf", 
+      :font_size => 9,       
+      :font_antialias => true, 
+      :text_color => "#fff",
       :text_offset => {:x => 0, :y => 0},
-      :target_path => Dir.pwd,
-      :antialias => true
+      :text_align => :center,
+      :padding => {:left => 10, :right => 10},       
+      :target_path => Dir.pwd
     }.update(options)
     @options[:template_images] ||=  ["_left","_middle","_right"].map{|p| options[:template_base] + p + ".gif" }
     
@@ -27,22 +29,22 @@ class Buttonize::Button
   def generate(text, filename = nil)
     filename ||= self.text_to_filename(text)
     filename = add_extension(filename,"gif")
-    paddings = options[:paddings]
+    padding = options[:padding]
 
     # Load the images
     left,mid,right = options[:template_images].map{|p| Image.read(File.join(options[:template_path],p)).first }  
 
     draw = Draw.new
     draw.pointsize = options[:font_size]
-    draw.fill = "#fff"
-    draw.gravity = Magick::CenterGravity
+    draw.fill = options[:text_color]
+    draw.gravity = self.gravity_from_alignment(options[:text_align])
     draw.font = options[:font]
-    draw.font_weight = Magick::BoldWeight
-    draw.text_antialias = options[:antialias] || false
+    draw.font_weight = Magick::AnyWeight
+    draw.text_antialias = options[:font_antialias] || false
     
     # Measure the text first
     metrics = draw.get_type_metrics(text)
-    target_width = metrics.width + paddings[0] + paddings[1]
+    target_width = metrics.width + padding[:left] + padding[:right]
 
     target_width = options[:width] if options[:width] && options[:width] > target_width
 
@@ -68,7 +70,13 @@ class Buttonize::Button
 
     # Place right
     dst.composite!(right,pos,0,Magick::OverCompositeOp)
-    draw.annotate(dst,0,0,options[:text_offset][:x],options[:text_offset][:y],text)
+    
+    # Draw text
+    left = options[:text_offset][:x] || 0
+    left += padding[:left] unless options[:text_align] == :center
+    draw.annotate(dst,0,0,left,options[:text_offset][:y],text)
+    
+    # Write file
     dst.write(File.join(options[:target_path],filename))
     dst.destroy!
     
@@ -87,4 +95,12 @@ class Buttonize::Button
     end
   end
   
+  def gravity_from_alignment(alignment)
+    case alignment
+    when :left then Magick::WestGravity
+    when :right then Magick::EastGravity
+    else Magick::CenterGravity      
+    end
+  end
+  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: flurin-buttonize
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors: 
 - Flurin Egger
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-01-23 00:00:00 -08:00
+date: 2009-01-25 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -17,7 +17,7 @@ dependencies:
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 2.5.1
     version: 
@@ -40,8 +40,8 @@ extra_rdoc_files: []
 
 files: 
 - bin/buttonize
+- buttonize.gemspec
 - examples/buttons.rb
-- examples/default
 - examples/default/big_blue_left.gif
 - examples/default/big_blue_middle.gif
 - examples/default/big_blue_right.gif
@@ -54,6 +54,13 @@ files:
 - examples/default/big_red_left.gif
 - examples/default/big_red_middle.gif
 - examples/default/big_red_right.gif
+- examples/default/fonts/Bitstream
+- Vera
+- License.txt
+- examples/default/fonts/Vera-Bold-Italic.ttf
+- examples/default/fonts/Vera-Bold.ttf
+- examples/default/fonts/Vera-Italic.ttf
+- examples/default/fonts/Vera.ttf
 - examples/default/small_blue_left.gif
 - examples/default/small_blue_middle.gif
 - examples/default/small_blue_right.gif
@@ -79,7 +86,6 @@ files:
 - examples/default/table_red_left.gif
 - examples/default/table_red_middle.gif
 - examples/default/table_red_right.gif
-- lib/buttonize
 - lib/buttonize/button.rb
 - lib/buttonize/button_set.rb
 - lib/buttonize/cli.rb