= 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 [#{check.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