= rubygoo

http://rubygoo.googlecode.com

== DESCRIPTION:

Rubygoo is a theme-able gui framework for use with rubygame and soon gosu. It has a strong focus on nice syntax and ease of use.

== FEATURES:

* theme-able gui widgets
* named css colors
* works with rubygame and gosu
* containers, labels, buttons, checkboxes, radio buttons, radio groups, icons
* tabbing focus of widgets
* modal dialogs

== SYNOPSIS:

require 'rubygems'
$: << './lib'
$: << File.dirname(__FILE__)
require 'rubygoo'
require 'rubygame'
include Rubygame
include Rubygoo

if $0 == __FILE__

screen = Screen.new [600,480]
screen.show_cursor = false

factory = AdapterFactory.new
render_adapter = factory.renderer_for :rubygame, screen
icon = Surface.load File.dirname(__FILE__) + "/icon.png"

app = App.new :renderer => render_adapter

label = Label.new "click the button to set the time", :x=>20, :y=>30

button = Button.new "Click Me!", :x=>70, :y=>80, :x_pad=>20, :y_pad=>20, :icon => icon
button.on :pressed do |*opts|
label.set_text(Time.now.to_s)
end

check = CheckBox.new :x=>370, :y=>70, :w=>20, :h=>20
check.on :checked do
label.set_text("CHECKED [#checkcheck.checked?]")
end

text_field = TextField.new "initial text", :x => 70, :y => 170, :max_length => 20, :min_length => 6

text_field.on_key K_RETURN, K_KP_ENTER do |evt|
puts "BOO-YAH"
end

modal_button = Button.new "Modal dialogs", :x=>270, :y=>280, :x_pad=>20, :y_pad=>20
modal_button.on :pressed do |*opts|
modal = Dialog.new :modal => app, :x=>60, :y=>110, :w=>250, :h=>250

modal.add Label.new("Message Here", :x=>20, :y=>70, :x_pad=>20, :y_pad=>20, :relative=>true)

ok_butt = Button.new("OK", :x=>70, :y=>180, :x_pad=>20, :y_pad=>20,:relative=>true)
ok_butt.on :pressed do |*opts|
app.remove_modal(modal)
end
modal.add ok_butt

modal.display
end

grp = RadioGroup.new :x=>10, :y=>380, :x_pad=>20, :y_pad=>20, :w=> 500, :h=>80
grp_label = Label.new "RadioGroups are fun!", :x=>40, :y=>10, :w=>20, :h=>20, :relative=>true
grp_radio_one = RadioButton.new :x=>40, :y=>40, :w=>20, :h=>20, :relative=>true
grp_radio_two = RadioButton.new :x=>90, :y=>40, :w=>20, :h=>20, :relative=>true
grp_radio_three = RadioButton.new :x=>140, :y=>40, :w=>20, :h=>20, :relative=>true

grp.add grp_label, grp_radio_one, grp_radio_two, grp_radio_three

# implicit tab ordering based on order of addition, can
# specify if you want on widget creation

# can add many or one at a time
app.add text_field, label, button, modal_button, grp
app.add check

app_adapter = factory.app_for :rubygame, app

# rubygame standard stuff below here
queue = EventQueue.new
queue.ignore = [
ActiveEvent, JoyAxisEvent, JoyBallEvent, JoyDownEvent,
JoyHatEvent, JoyUpEvent, ResizeEvent
]
clock = Clock.new
clock.target_framerate = 20

catch(:rubygame_quit) do
loop do
queue.each do |event|
case event
when KeyDownEvent
case event.key
when K_ESCAPE
throw :rubygame_quit
end
when QuitEvent
throw :rubygame_quit
end

# pass on our events to the GUI
app_adapter.on_event event
end

app_adapter.update clock.tick
app_adapter.draw render_adapter
end
end
end

== REQUIREMENTS:

* publisher gem
* constructor gem
* rubygame gem or gosu

== INSTALL:

* sudo gem install rubygoo

== LICENSE:

GPLv2