gglib 1.1.0 → 1.2.1

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2007-2009 Praneeth Sadda
+
+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/NEWS

@@ -0,0 +1,75 @@
+1.2.1 (Apr 5, 2009)
+ADDITIONS:
+ * New example files: 
+   * Added CheckBox and RadioGroup example.
+CHANGES:
+ None.
+BUGS FIXED:
+ * Fixed errors with CheckBox and RadioGroup.
+ * Fixed the FadeIn Widget.
+ * Fixed default (blank) themeing.
+NEW BUGS:
+ None.
+
+1.2 (Mar 30, 2009)
+ADDITIONS:
+ * New widgets added:
+   * CheckBox
+   * RadioGroup
+CHANGES:
+ * Blue Steel, Shade, Windows themes updated to support CheckBox and RadioGroup
+ * The Windows now supports button down states for most widgets
+ * Example files updated: 
+   * BasicExample.rb (Minor updates)
+ * .tar.gz and .gem distributions now contain files with unix (lf) line endings.
+BUGS FIXED:
+ None.
+NEW BUGS:
+ * Impossible to change themes for a RadioGroup after construction
+ * Labels overlap when using RadioGroup::Layour::Horixontal with multiple labled buttons
+ * Rubygoo does not support CheckBox and RadioGroup widgets
+
+1.1 (Feb 13, 2009)
+ADDITIONS:
+ * New widgets added: 
+   * Label 
+ * Themeing added. 
+   * New themes added: 
+     * BlueSteel 
+     * Rubygoo 
+     * Shade 
+     * Windows 
+CHANGES:
+ * Example files updated: 
+   * BasicExample.rb 
+   * ConsoleDemo.rb 
+BUGS FIXED:
+ * Broken DebugConsole commands removed.
+ * DebugConsole prompt can no longer be deleted.
+NEW BUGS:
+ None.
+
+Version 1.0 (Jan 28, 2009)
+First Release
+ADDITIONS:
+ * Widgets: 
+   * DebugConsole 
+   * GenericButton 
+   * SelectionBox 
+   * TextBox 
+   * ThemeButton 
+   * TracePanel 
+ * Other Classes: Animation 
+   * Button 
+   * FadeIn 
+   * FadeScreen 
+   * GUIWindow 
+   * Image 
+   * Menu 
+   * SplashScreen 
+   * StateObject 
+   * Tile 
+   * Widget 
+NEW BUGS:
+ * Some DebugConsole commands are half-implemented
+ * DebugConsole prompt can sometimes be deleted, causing parsing errors.

data/TODO

@@ -0,0 +1,5 @@
+* Fix labels on RadioGroup::Layout::Horizontal
+* Fix post-construction themeing on RadioGroups
+* Add better radio button graphics for Blue Steel
+* Add Rubygoo theme support for CheckBox and RadioGroup
+* Add containers/layouts

data/{lib/examples → examples}/BasicExample.rb

@@ -1,71 +1,71 @@
-begin
-  # In case you use Gosu via RubyGems.
-  require 'rubygems'
-rescue LoadError
-  # In case you don't.
-end
-
-#Load Gosu
-require "gosu"
-#Load GGLib
-require "../gglib"
-#Load some extra widgets for us to play with
-require "../ext/widgets"
-#And themes to make them look cool
-require "../ext/themes"
-
-class MyGUIWindow < GGLib::GUIWindow
-  def initialize
-    super(640, 480, false, 20)
-    self.caption = "GGLib Tutorial"
-    #Rather than override methods such as update, button_down,
-    #and draw, as we would with plain Gosu code, we will override
-    #these methods in state objects. This allows the user to switch
-    #between various game states, such as between menus and the
-    #actual game, without having to litter their functions with
-    #switch statements or if-else statements.
-    self.state = MyStateObj.new
-  end
-end
-
-#Now for our state object:
-class MyStateObj < GGLib::StateObject
-  #We can override the constructor as normal, but be careful not
-  #to mess around with the window here! The window does not belong
-  #to this state object yet: another state object is using it.
-  def initialize
-    super
-    @myvar = 42
-  end
-  #This method is called right after our state object gains ownership
-  #over the window. Now we can perform operations that modify the
-  #window.
-  def onStart
-    puts "MyStateObj activated."
-    #Since Gosu only allows one window instance at a time, the current
-    #window is automatically sotred in the global $window.
-    $window.setBackground("img/bggray.png")
-    #Whats a GUI Library without widgets?
-    #A textbox:
-    $textbox = GGLib::TextBox.new("textbox1", 242, 100, 12, GGLib::Themes::Windows)
-    #Some buttons:
-    GGLib::Button.new("button1", "Click Me", 270, 50, Proc.new{ |widget| $textbox.text = "Thank you" }, GGLib::Themes::Windows)
-    GGLib::Button.new("button2", "Exit", 270, 200, Proc.new{ |widget| $window.close; exit }, GGLib::Themes::Windows)
-  end
-  #This method is called right after our state object looses
-  #ownership of the window. The window is automatically reset, but
-  #if you modified anything other than the window, this is where you
-  #should clean it up.
-  def onEnd
-    puts "MyStateObj terminated."
-  end
-end
-
-#Create and launch the window.
-MyGUIWindow.new.show
-
-#To see how easy it is to customize your GUI with themeing, try 
-#replacing all of the instances of GGLib::Themes::BlueSteel in
-#this file to GGLib::Themes::Rubygoo for a Rubygoo like theme,
-#GGLib::Themes::Shade for a dark theme, and GGLib::Themes::Windows
+begin
+  # In case you use Gosu via RubyGems.
+  require 'rubygems'
+rescue LoadError
+  # In case you don't.
+end
+
+#Load Gosu
+require "gosu"
+#Load GGLib
+require "../gglib"
+#Load some extra widgets for us to play with
+require "../ext/widgets"
+#And themes to make them look cool
+require "../ext/themes"
+
+class MyGUIWindow < GGLib::GUIWindow
+  def initialize
+    super(640, 480, false, 20)
+    self.caption = "GGLib Tutorial"
+    #Rather than override methods such as update, button_down,
+    #and draw, as we would with plain Gosu code, we will override
+    #these methods in state objects. This allows the user to switch
+    #between various game states, such as between menus and the
+    #actual game, without having to litter their functions with
+    #switch statements or if-else statements.
+    self.state = MyStateObj.new
+  end
+end
+
+#Now for our state object:
+class MyStateObj < GGLib::StateObject
+  #We can override the constructor as normal, but be careful not
+  #to mess around with the window here! The window does not belong
+  #to this state object yet: another state object is using it.
+  def initialize
+    super
+    @myvar = 42
+  end
+  #This method is called right after our state object gains ownership
+  #over the window. Now we can perform operations that modify the
+  #window.
+  def onStart
+    puts "MyStateObj activated."
+    #Since Gosu only allows one window instance at a time, the current
+    #window is automatically sotred in the global $window.
+    $window.setBackground("img/bgblue.png")
+    #Whats a GUI Library without widgets?
+    #A textbox:
+    $textbox = GGLib::TextBox.new("textbox1", 220, 100, 12, GGLib::Themes::BlueSteel)
+    #Some buttons:
+    GGLib::Button.new(:button1, "Click Me", 270, 50, Proc.new{ |widget| $textbox.text = "Thank you" }, GGLib::Themes::BlueSteel)
+    GGLib::Button.new(:button2, "Exit", 270, 200, Proc.new{ |widget| $window.close; exit }, GGLib::Themes::BlueSteel)
+  end
+  #This method is called right after our state object looses
+  #ownership of the window. The window is automatically reset, but
+  #if you modified anything other than the window, this is where you
+  #should clean it up.
+  def onEnd
+    puts "MyStateObj terminated."
+  end
+end
+
+#Create and launch the window.
+MyGUIWindow.new.show
+
+#To see how easy it is to customize your GUI with themeing, try 
+#replacing all of the instances of GGLib::Themes::BlueSteel in
+#this file to GGLib::Themes::Rubygoo for a Rubygoo like theme,
+#GGLib::Themes::Shade for a dark theme, and GGLib::Themes::Windows
 #for a Windows Vista like theme.

data/examples/CheckBoxAndRadio.rb

@@ -0,0 +1,54 @@
+begin
+  # In case you use Gosu via RubyGems.
+  require 'rubygems'
+rescue LoadError
+  # In case you don't.
+end
+
+#Load Gosu
+require "gosu"
+#Load GGLib
+require "../gglib"
+#Load extra widgets
+require "../ext/widgets"
+#Load extra themes
+require "../ext/themes"
+
+#Now for our state object:
+class MyGUIWindow < GGLib::GUIWindow
+  def initialize
+    super(640, 480, false, 20)
+    self.caption = "GGLib Tutorial"
+    self.state = MyStateObj.new
+  end
+end
+
+#Now for our state object:
+class MyStateObj < GGLib::StateObject
+  def onStart
+    $window.setBackground("img/bgblue.png")
+    #A CheckBox:
+    GGLib::CheckBox.new(
+      :checkbox1, #Widget name
+      200, #X position
+      200, #Y position
+      "Check this!", #label
+      false, #Set the CheckBox to be unchecked on creation
+      GGLib::Themes::BlueSteel #Use the BlueSteel theme
+    )
+    #A RadioGroup
+    GGLib::RadioGroup.new(
+      :radio1, #Widget name
+      200, #X position
+      225, #Y position
+      { "One" => 1, "Two" => 2, "Three" => 3}, #Each key in the hash is the option name and each value is the option value
+      GGLib::RadioGroup::Layout::Vertical, #Align the tadio buttons verticaly. The other option is Layout::Horizontal
+      GGLib::RadioGroup::Spacing::Automatic, #Set the spacing between radio buttons to be automatically sized. (You can supply your own spacing by passing an integer here.)
+      GGLib::Themes::BlueSteel #Use the BlueSteel theme
+    )
+
+  end
+end
+
+#Create and launch the window.
+MyGUIWindow.new.show

data/{lib/examples → examples}/ConsoleDemo.rb

@@ -1,26 +1,26 @@
-begin
-  require 'rubygems'
-rescue LoadError
-end
-
-require "gosu"
-require "../gglib"
-require "../ext/widgets"
-require "../ext/themes"
-
-class ConsoleDemoWindow < GGLib::GUIWindow
-  def initialize
-    super(640, 480, false, 20)
-    self.caption = "GGLib Console Demo"
-    self.state = ConsoleDemoState.new
-  end
-end
-
-class ConsoleDemoState < GGLib::StateObject
-  def onStart
-    $window.setBackground("img/bg.png")
-    GGLib::Button.new("button2", "Open Console", 270, 200, Proc.new{ |widget| GGLib::DebugConsole.new }, GGLib::Themes::BlueSteel)
-  end
-end
-
+begin
+  require 'rubygems'
+rescue LoadError
+end
+
+require "gosu"
+require "../gglib"
+require "../ext/widgets"
+require "../ext/themes"
+
+class ConsoleDemoWindow < GGLib::GUIWindow
+  def initialize
+    super(640, 480, false, 20)
+    self.caption = "GGLib Console Demo"
+    self.state = ConsoleDemoState.new
+  end
+end
+
+class ConsoleDemoState < GGLib::StateObject
+  def onStart
+    $window.setBackground("img/bg.png")
+    GGLib::Button.new("button2", "Open Console", 270, 200, Proc.new{ |widget| GGLib::DebugConsole.new }, GGLib::Themes::BlueSteel)
+  end
+end
+
 ConsoleDemoWindow.new.show

data/{lib/examples → examples}/FadeIn.rb

@@ -1,40 +1,42 @@
-begin
-  # In case you use Gosu via RubyGems.
-  require 'rubygems'
-rescue LoadError
-  # In case you don't.
-end
-
-#Load Gosu
-require "gosu"
-#Load GGLib
-require "../gglib"
-#Load extra widgets (for ThemeButton)
-require "../ext/widgets"
-
-class FadeExample < GGLib::GUIWindow
-  def initialize
-    super(640, 480, false, 20)
-    self.caption = "GGLib Tutorial"
-    self.state = StartMenu.new
-  end
-end
-
-#The menu we will fade from
-class StartMenu < GGLib::StateObject
-  def onStart
-    $window.setBackground("img/splash.png")
-    GGLib::ThemeButton.new("button1", "Fade", 270, 200, Proc.new{ |widget| $window.state = GGLib::FadeScreen.new(EndMenu.new, 2) })
-  end
-end
-
-#The menu we will fade to
-class  EndMenu < GGLib::StateObject
-  def onStart
-    $window.setBackground("img/bg.png")
-    GGLib::ThemeButton.new("button1", "Fade Back", 270, 200, Proc.new{ |widget| $window.state = GGLib::FadeScreen.new(StartMenu.new, 2) })
-  end
-end
-
-#Launch the window
+begin
+  # In case you use Gosu via RubyGems.
+  require 'rubygems'
+rescue LoadError
+  # In case you don't.
+end
+
+#Load Gosu
+require "gosu"
+#Load GGLib
+require "../gglib"
+#Load extra widgets
+require "../ext/widgets"
+#And themes to make them look cool
+require "../ext/themes"
+
+class FadeExample < GGLib::GUIWindow
+  def initialize
+    super(640, 480, false, 20)
+    self.caption = "GGLib Tutorial"
+    self.state = StartMenu.new
+  end
+end
+
+#The menu we will fade from
+class StartMenu < GGLib::StateObject
+  def onStart
+    $window.setBackground("img/splash.png")
+    GGLib::Button.new(:fade, "Fade", 270, 200, Proc.new{ |widget| $window.state = GGLib::FadeScreen.new(EndMenu.new, 2) }, GGLib::Themes::BlueSteel)
+  end
+end
+
+#The menu we will fade to
+class  EndMenu < GGLib::StateObject
+  def onStart
+    $window.setBackground("img/bg.png")
+    GGLib::Button.new(:fade_back, "Fade Back", 270, 200, Proc.new{ |widget| $window.state = GGLib::FadeScreen.new(StartMenu.new, 2) }, GGLib::Themes::BlueSteel)
+  end
+end
+
+#Launch the window
 FadeExample.new.show

data/examples/README

@@ -0,0 +1 @@
+Put gosu.so into this directory to run the examples. (Unless you use rubygems or gosu is in the system path)

data/{lib/examples → examples}/SplashScreen.rb

@@ -1,30 +1,30 @@
-begin
-  # In case you use Gosu via RubyGems.
-  require 'rubygems'
-rescue LoadError
-  # In case you don't.
-end
-
-require "gosu"
-require "../gglib"
-require "../ext/splash"
-
-class MySplashScreen < GGLib::SplashScreen
-  def initialize
-    super(640, 480, "img/splash.png")
-  end
-  def load
-    #Put initialization code here.
-    #This example doesn't actually have to initialize anything,
-    #so we will just use Thread#sleep to kill some time.
-    sleep(1) 
-  end
-  def createWindow
-    #Once the load method is finished, create window is called.
-    #This is where we should initialize and lauch our window.
-    #We'll just resuse the routines from BasicExample.rb.
-    require "BasicExample"
-  end
-end
-
+begin
+  # In case you use Gosu via RubyGems.
+  require 'rubygems'
+rescue LoadError
+  # In case you don't.
+end
+
+require "gosu"
+require "../gglib"
+require "../ext/splash"
+
+class MySplashScreen < GGLib::SplashScreen
+  def initialize
+    super(640, 480, "img/splash.png")
+  end
+  def load
+    #Put initialization code here.
+    #This example doesn't actually have to initialize anything,
+    #so we will just use Thread#sleep to kill some time.
+    sleep(1) 
+  end
+  def createWindow
+    #Once the load method is finished, create window is called.
+    #This is where we should initialize and lauch our window.
+    #We'll just resuse the routines from BasicExample.rb.
+    require "BasicExample"
+  end
+end
+
 MySplashScreen.new.show