rubygoo 0.0.3

data/History.txt

@@ -0,0 +1,10 @@
+=== 0.0.3 / 2008-09-16
+
+* Rubygoo hits useable state
+  * added modal dialogs
+  * added named css colors
+  * changed default colorscheme
+  * refactored rubygame input/rendering into adapters
+  * started adding support for gosu applications
+
+

data/Manifest.txt

@@ -0,0 +1,37 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+TODO
+docs/.DS_Store
+docs/Picture 1.png
+docs/ui/.DS_Store
+docs/ui/UI.hpp
+docs/ui/abutton.png
+docs/ui/background.png
+docs/ui/button.png
+docs/ui/moveable.png
+docs/ui/textbutton.png
+lib/code_statistics.rb
+lib/platform.rb
+lib/rubygoo.rb
+lib/rubygoo/adapters/adapter_factory.rb
+lib/rubygoo/adapters/gosu_app_adapter.rb
+lib/rubygoo/adapters/gosu_render_adapter.rb
+lib/rubygoo/adapters/rubygame_app_adapter.rb
+lib/rubygoo/adapters/rubygame_render_adapter.rb
+lib/rubygoo/app.rb
+lib/rubygoo/button.rb
+lib/rubygoo/check_box.rb
+lib/rubygoo/container.rb
+lib/rubygoo/css_colors.rb
+lib/rubygoo/dialog.rb
+lib/rubygoo/goo_color.rb
+lib/rubygoo/goo_event.rb
+lib/rubygoo/label.rb
+lib/rubygoo/text_field.rb
+lib/rubygoo/widget.rb
+samples/gosu_app.rb
+samples/rubygame_app.rb
+themes/default/Vera.ttf
+themes/default/config.yml

data/README.txt

@@ -0,0 +1,81 @@
+= 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, gosu support on its way
+* containers, labels, buttons, checkboxes
+* tabbing focus of widgets
+* modal dialogs
+
+== SYNOPSIS:
+
+def build_gui(renderer)
+  app = App.new :renderer => renderer
+
+  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
+  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
+
+  text_field.on_key K_RETURN, K_KP_ENTER do |evt|
+    puts "BOO-YAH"
+  end
+  
+  # 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
+  app.add check
+end
+
+screen = Screen.new [600,480]
+
+factory = AdapterFactory.new
+render_adapter = factory.renderer_for :rubygame, screen
+app = create_gui(render_adapter)
+app_adapter = factory.app_for :rubygame, app
+
+# <standard rubygame setup stuff here>
+
+# rubygame loop do ..
+
+  # each event in our queue do ..
+    # pass on our events to the GUI
+    app_adapter.on_event event
+  end
+
+  app_adapter.update clock.tick
+  app_adapter.draw render_adapter
+end
+
+== REQUIREMENTS:
+
+* publisher gem
+* constructor gem
+* rubygame gem (for now)
+
+== INSTALL:
+
+* sudo gem install rubygoo
+
+== LICENSE:
+
+  GPLv2

data/Rakefile

@@ -0,0 +1,35 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/rubygoo.rb'
+
+Hoe.new('rubygoo', Rubygoo::VERSION) do |p|
+  p.developer('Shawn Anderson', 'shawn42@gmail.com')
+  p.author = "Shawn Anderson"
+  p.description = "GUI library for use with Gosu or Rubygame"
+  p.email = 'boss@topfunky.com'
+  p.summary = "Beautiful graphs for one or multiple datasets."
+  p.url = "http://rubygoo.googlecode.com"
+  p.changes = p.paragraphs_of('History.txt', 0..2).join("\n\n")
+  p.remote_rdoc_dir = '' # Release to root
+  p.extra_deps = ['constructor','publisher']
+end
+
+# run rubygame_app
+task :run do
+  # this is for convenience on os x
+  sh "rsdl samples/rubygame_app.rb"
+end
+
+STATS_DIRECTORIES = [
+  %w(Source         lib/)
+].collect { |name, dir| [ name, "#{dir}" ] }.select { |name, dir| File.directory?(dir) }
+
+desc "Report code statistics (KLOCs, etc) from the application"
+task :stats do
+  require 'code_statistics'
+  CodeStatistics.new(*STATS_DIRECTORIES).to_s
+end
+
+# vim: syntax=Ruby

data/TODO

@@ -0,0 +1,10 @@
+TODO
+ - should rubygoo take control of the screen & events?
+   - just provide callbacks?
+ - make clicking on a component focus it
+ - add more listener types (when mouse_enter, mouse_leave, mouse_click, focus, key_pressed...)
+ - image icons for buttons
+
+ - abstract the events that rubygoo takes and the renderer to allow for gosu-ness
+ - rework color scheme to not suck
+ - double-check the tab focus stuff on modal dialogs

data/docs/ui/UI.hpp

@@ -0,0 +1,425 @@
+#ifndef UI_HPP
+#define UI_HPP
+
+#include <boost/function.hpp>
+#include <Gosu/Input.hpp>
+#include <Gosu/Font.hpp>
+#include <Gosu/TextInput.hpp>
+#include <boost/bind.hpp>
+#include <Gosu/Utility.hpp>
+#include <Gosu/Graphics.hpp>
+#include <Gosu/Directories.hpp>
+
+// Comment out these lines if you're using the same thing anyway.
+typedef boost::shared_ptr<Gosu::Image> Image; // Ich brauch einen tollen Namen D:
+typedef std::vector<Image> Animation;
+enum ZOrder {
+	zBackground,
+	zSomething,
+	zOMG, // sorry about this.
+	zUI,
+	zUIButton,
+	zCursor;
+};
+// if you don't, you may want to uncomment these.
+/*
+void loadImage(std::wstring filename, Image &loadTo, Gosu::Graphics& graphics, bool hardBorder) {
+	loadTo.reset(new Gosu::Image(graphics, Gosu::sharedResourcePrefix() + L"media/" + filename, hardBorder));
+}
+
+void loadAnimation(std::wstring filename, Animation &loadTo, Gosu::Graphics& graphics, int width, int height, bool hardBorder) {
+	Gosu::imagesFromTiledBitmap(graphics, Gosu::sharedResourcePrefix() + L"media/" + filename, width, height, hardBorder, loadTo);
+}
+*/
+
+// Change this.
+#define WINDOW_WIDTH 800
+#define WINDOW_HEIGHT 600
+
+/*
+For the best usage you define a "Mother-Widget". Example code:
+
+class GameWindow : public Gosu::Window {
+protected:
+	Widget widgets, *background, *acontainer, *txtbtn;
+public:
+	GameWindow() 
+	: Gosu::Window(WINDOW_WIDTH, WINDOW_HEIGHT, false, 20) {
+		background = new Widget(L"background.png", graphics(), 0, 0, zBackground);
+		widgets->add(background);
+		Button* btn1 = new Button(L"button.png", graphics(), 20, 20, zUIButton);
+		background->add(btn1);
+		btn1->onLeftClick = boost::bind(&GameWindow::explode, this);
+		AdvButton* btn2 = new AdvButton(L"abutton.png", graphics(), 50, 50, 40, 40, zUIButton);
+		widgets->add(btn2);
+		acontainer = new Moveable(L"moveable.png", graphics(), 200, 200, zUI, 120, 40);
+		txtbtn = new AdvTextButton(L"textbutton.png", graphics(), 205, 250, 132, 22, Gosu::defaultFontName(), L"Hello World", true);
+		txtbtn->onLeftClick = boost::bind(&GameWindow::noWorld, this);
+		acontainer->addWidget(txtbtn);
+	}
+	
+	void buttonDown(Gosu::Button btn) {
+		if (btn == Gosu::kbF7) {
+			if (background->isVisible()) background->hide(),
+			else background->show();
+		} else if (btn == Gosu::kbF8) {
+			if (acointainer->isVisible()) acontainer->hide();
+			else acointainer->show();
+		} else if (btn == Gosu::kbF9) {
+			// force txtbtn to show >:[
+			txtbtn->show(true);
+		}
+		widgets.buttonDown(btn, input());
+	}
+	
+	void buttonUp(Gosu::Button btn) {
+		widgets.buttonUp(btn, input());
+	}
+	
+	void update() {
+		widgets.update(input());
+	}
+	
+	void draw() {
+		widgets.draw(input());
+	}
+	
+	void explode() {
+		exit(-42);
+	}
+	
+	void noWorld() {
+		txtbtn->setText(L":((");
+		background->deactivate();
+	}
+};
+
+int main(int argc, char* argv[]) {
+	GameWindow window;
+	window.show();
+}
+*/
+class Widget;
+typedef std::vector<Widget*> Widgets;
+
+enum AdvTxtBtnKeep {
+	tbkNone = -1,
+	tbkNormal = 0,
+	tbkHover = 1,
+	tbkPressed = 2,
+	tbkDisabled = 3
+};
+/**
+ * Mutter aller Grafikelemente! Kann abgeleitet werden und funktioniert rekursiv bis ~ewig!
+ * X/Y/Z: Selbsterkl�rend
+ * Widgets sind eigentlich nicht zum bewegen geeignet.
+ * Sie k�nnen zwar verschoben werden (setX, setY: nur dieses; move(ox,oy): rekursiv).
+ * widgets k�nnen sich X und Y wiederholen (festlegbar).
+ * Sie sind deaktivierbar und versteckbar. Ersters hat keine Funktion in Widget.
+*/
+
+class Widget {
+protected:
+	Widgets widgets, addQueue;
+	Image image;
+	int x, y;
+	ZOrder z;
+	bool active, visible, noAutoShow, locked;
+	WidgetType type;
+public:
+	Widget(int x = 0, int y = 0, ZOrder z = zBackground, bool noAutoShow = false) {
+		this->x = x;
+		this->y = y;
+		this->z = z;
+		active = visible = true;
+		locked = false;
+		this->noAutoShow = noAutoShow;
+		type = wtWidget;
+	}
+
+	Widget(Image& image, int x, int y, ZOrder z, bool noAutoShow = false) {
+		this->image = image;
+		this->x = x;
+		this->y = y;
+		this->z = z;
+		active = visible = true;
+		type = wtWidget;
+		this->noAutoShow = noAutoShow;
+	}
+	
+	Widget(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, bool noAutoShow = false) {
+		loadImage(name, image, graphics);
+		this->x = x;
+		this->y = y;
+		this->z = z;
+		active = visible = true;
+		type = wtWidget;
+		this->noAutoShow = noAutoShow;
+	}
+	// Gosu related
+	virtual void draw(Gosu::Input& input);
+	virtual void update(Gosu::Input& input);
+	virtual void buttonUp(Gosu::Button& btn, Gosu::Input& input); // Redirect call
+	virtual void buttonDown(Gosu::Button& btn, Gosu::Input& input); // Redirect call
+	virtual void move(int vx, int vy); // bewegt um vx/vy; alle untergeordneten auch.
+	int getX() { return x; } 
+	int getY() { return y; }
+	ZOrder getZ() { return z; }
+	virtual Image getImage() { return image; }
+	void setX(int x) { this->x = x; }
+	void setY(int y) { this->y = y; }
+	void setZ(ZOrder z) { this->z = z; }
+	WidgetType getType() { return type; }
+	void addWidget(Widget* widget); // unterwidget hinzuf�gen
+	void remWidget(Widget* widget); // unterwidget l�schen
+	// (De-)aktivieren
+	void activate();
+	void deactivate();
+	bool isActive() { return active; }
+	// verstecken/anzeigen
+	void hide();
+	void show(bool force = false); // force: erzwinge anzeigen. hat nur mit noAutoShow effekt.
+	bool isVisible() { return visible; }
+	virtual ~Widget();
+};
+
+/**
+* Movable. Sie (und alles untergeordnete) verschiebt sich. Lustige Sache.
+* 
+*/
+class Moveable : public Widget {
+	int omx, omy, wdt, hgt, twdt, thgt;
+	bool moving;
+public:
+	static std::vector<Moveable*> moveables;
+	boost::function<void(Moveable*)> onTitleLeftClick, onTitleRightClick;
+	Moveable(Image& image, int x, int y, ZOrder z, int titleWidth, int titleHeight)
+	:	Widget(image, x, y, z) {
+		moving = false;
+		omx = omy = 0;
+		wdt = image->width();
+		hgt = image->height();
+		twdt = titleWidth;
+		thgt = titleHeight;
+		type = wtMoveable;
+		Moveable::moveables.push_back(this);
+	}
+
+	Moveable(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, int titleWidth, int titleHeight)
+	 :Widget(name, graphics, x, y, z) {
+		moving = false;
+		omx = omy = 0;
+		wdt = image->width();
+		hgt = image->height();
+		twdt = titleWidth;
+		thgt = titleHeight;
+		type = wtMoveable;
+		Moveable::moveables.push_back(this);
+	}
+
+	void update(Gosu::Input& input);
+	void buttonDown(Gosu::Button& btn, Gosu::Input& input);
+	void buttonUp(Gosu::Button& btn, Gosu::Input& input);
+	void move(int vx, int vy);
+};
+
+/**
+ * Primitiver Button der nur f�r Mausklicks zust�ndig ist.
+ * 2 calls: onLeftClick, onRightClick. Param jeweils Button* btn
+*/
+class Button : public Widget {
+protected:
+	int width, height;
+	bool focus;
+	Button* next;
+public:
+	static Button* btnFocus;
+	boost::function<void (Button*)> onRightClick, onLeftClick;
+
+	Button(int x = 0, int y = 0, ZOrder z = zBackground, bool noAutoShow = false)
+	: Widget(x, y, z, noAutoShow) {
+		width = height = 0;
+		focus = false;
+		next = NULL;
+		type = wtButton;
+	}
+
+	Button(Image& image, int x, int y, ZOrder z, bool noAutoShow = false)
+	: Widget(image, x, y, z, noAutoShow) {
+		width = image->width();
+		height = image->height();
+		focus = false;
+		next = NULL;
+		type = wtButton;
+	}
+
+	Button(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, bool noAutoShow = false)
+	: Widget(name, graphics, x, y, z, noAutoShow) {
+		loadImage(name, image, graphics);
+		width = image->width();
+		height = image->height();
+		focus = false;
+		next = NULL;
+		type = wtButton;
+	}
+
+	virtual void update(Gosu::Input& input);
+	virtual void buttonUp(Gosu::Button& btn, Gosu::Input& input);
+	static	void buttonUpAll(Gosu::Button& btn, Gosu::Input& input);
+	virtual void setFocus(bool woot) { focus = woot; }
+	virtual void setNextFocus(Button* toFocus) { next = toFocus; }
+	virtual void onFocus(Button* from, Gosu::Input& input);
+	virtual void onDefocus(Button* from, Gosu::Input& input);
+};
+
+/**
+* Textbutton: Dynamischer erzeugte Buttons
+*/
+
+class TextButton : public Button {
+protected:
+	Gosu::Font* font;
+	std::wstring text;
+public:
+	TextButton(Image& image, int x, int y, ZOrder z, Gosu::Graphics& graphics, std::wstring fontName, std::wstring text, bool noAutoShow = false)
+		: Button(image, x, y, z, noAutoShow) {
+			font = new Gosu::Font(graphics, fontName, image->height()-5);
+			this->text = text;
+	}
+
+	TextButton(Image& image, int x, int y, ZOrder z, Gosu::Font* font, std::wstring text, bool noAutoShow = false)
+		: Button(image, x, y, z, noAutoShow) {
+			this->font = font;
+			this->text = text;
+	}
+
+	TextButton(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, std::wstring fontName, std::wstring text, bool noAutoShow = false)
+		: Button(name, graphics, x, y, z, noAutoShow) {
+			font = new Gosu::Font(graphics, fontName, image->height()-5);
+			this->text = text;
+	}
+	
+	TextButton(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, Gosu::Font* font, std::wstring text, bool noAutoShow = false)
+		: Button(name, graphics, x, y, z, noAutoShow) {
+			this->font = font;
+			this->text = text;
+	}
+
+	TextButton(int x, int y, ZOrder z, Gosu::Graphics& graphics, std::wstring fontname, std::wstring text, int height, bool noAutoShow = false)
+		: Button(x, y, z, noAutoShow) {
+			font = new Gosu::Font(graphics, fontname, height-5);
+			this->text = text;
+	}
+
+	TextButton(int x, int y, ZOrder z, Gosu::Font* font, std::wstring text, bool noAutoShow = false)
+		: Button(x, y, z, noAutoShow) {
+		this->font = font;
+		this->text = text;
+	}
+
+	std::wstring getText() { return text; }
+	Gosu::Font* getFont() { return font; }
+	void setText(std::wstring newText) { text = newText; }
+
+	void draw(Gosu::Input& input);
+};
+
+/**
+* Input Klasse. Abgeleitet von Button f�r width/height Zeug + FOKUS!
+*/
+
+class Input : public Button {
+protected:
+	Gosu::TextInput textInput;
+	Gosu::Font font;
+public:
+	Input(Image& image, int x, int y, ZOrder z, Gosu::Graphics& graphics, std::wstring fontName)
+		: Button(image, x, y, z), font(graphics, fontName, image->height()-5) {
+		type = wtInput;
+	}
+
+	Input(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, std::wstring fontName)
+	: Button(name, graphics, x, y, z), font(graphics, fontName, image->height()-5) {
+		type = wtInput;
+	}
+	void buttonUp(Gosu::Button& btn, Gosu::Input& input);
+	virtual void draw(Gosu::Input& input);
+	std::string text() { return Gosu::narrow(textInput.text()); }
+	void reset() { textInput.setText(L""); }
+	void onFocus(Button* from, Gosu::Input& input);
+	void onDefocus(Button* from, Gosu::Input& input);
+protected:
+	void ThereCanBeOnlyOne(Gosu::Input& input);
+};
+/**
+ * AdvButtons sind 4-tile-ige Buttons.
+ * die Reihenfolge dabei ist:
+ * - Normal
+ * - onHover
+ * - onClick
+ * - disabled
+ * Sie sind/sollten nicht weiter vererbt werden weil draw() das nicht weitergibt.
+ * wozu auch. mit 2 advbuttons arbeiten ist h�sslich.
+*/
+class AdvButton : public Button {
+	Animation* animation;
+public:
+	AdvButton(Animation* animation, int x, int y, ZOrder z, bool noAutoShow = false)
+	: Button(x, y, z, noAutoShow) { 
+		this->animation = animation;
+		width = animation->at(0)->width();
+		height = animation->at(0)->height();
+		assert(animation->size() == 4);
+		type = wtAdvButton;
+	}
+
+	AdvButton(std::wstring name, Gosu::Graphics& graphics, int x, int y, int width, int height, ZOrder z, bool noAutoShow = false)
+	: Button(x, y, z, noAutoShow) {
+		animation = new Animation();
+		loadAnimation(name, *animation, graphics, width, height);
+		assert(animation->size() == 4);
+		this->width = width;
+		this->height = height;
+		type = wtAdvButton;
+	}
+	virtual void draw(Gosu::Input& input);
+	Image getImage() { return animation->at(0); }
+	Animation* getAnimation() { return animation; }
+};
+
+/**
+* AdvButton + TextButton
+* 
+*/
+
+class AdvTextButton : public TextButton {
+protected:
+	Animation* animation;
+	AdvTxtBtnKeep keepState;
+public:
+	AdvTextButton(std::wstring name, Gosu::Graphics& graphics, int x, int y, ZOrder z, int width, int height, std::wstring fontname, std::wstring text, bool noAutoShow = false)
+		:TextButton(x, y, z, graphics, fontname, text, height, noAutoShow)
+	{
+			animation = new Animation();
+			loadAnimation(name, *animation, graphics, width, height);
+			keepState = tbkNone;
+			this->width = width;
+			this->height = height;
+	}
+
+	AdvTextButton(Animation* animation, int x, int y, ZOrder z, Gosu::Font* font, std::wstring text, bool noAutoShow = false)
+		:TextButton(x, y, z, font, text, noAutoShow) {
+			this->animation = animation;
+			keepState = tbkNone;
+			this->width = animation->at(0)->width();
+			this->height = animation->at(0)->height();
+	}
+
+	Image getImage() { return animation->at(0); }
+	void draw(Gosu::Input& input);
+	Animation* getAnimation() { return animation; }
+	AdvTxtBtnKeep getKeepState() { return keepState; }
+	void setKeepState(AdvTxtBtnKeep keep) { keepState = keep; }
+};
+#endif
+