colstrom-fidgit 0.2.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9dd17a6c5e84546fb12662c82d919b58c6751226
+  data.tar.gz: f91e8608ab6f8d8059316b55765edb344cf43d5f
+SHA512:
+  metadata.gz: 438e4f11f305c800e8b89232854a159c79aca51232562751a349f083e276e122fe29f0dac724747892423ea144b571d114619a99d90689a7ea5eed2ea77eec60
+  data.tar.gz: 3ec73dba5f84c5d7d6ec66ef976df41ae9a494d8c6548ab96bee154384579fab1675a141f6235cc35bfa0d3cafa05f7bb5765a0e6c94991b012740e4fb29c21b

data/.gitignore

@@ -0,0 +1,8 @@
+pkg/*
+*.gem
+.bundle
+Gemfile.lock
+doc/
+.yardoc
+README.html
+.idea/

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format documentation

data/CHANGELOG.md

@@ -0,0 +1,31 @@
+Fidgit changelog
+================
+
+v0.2.3
+------
+
+* Exposed #handle accessor for Slider.
+* Made Slider accept being disabled.
+* Made Slider handle show tip.
+
+v0.2.2
+------
+
+* Prevented ToggleButton border colour changing.
+* More careful about stripping out html tags in TextArea.
+
+v0.2.1
+------
+
+* Added: Click in ScrollBar gutter to scroll window by height/width of view window.
+* Added: Click and drag to select text in enabled TextArea.
+* Fixed: Color changes on disabling buttons.
+
+v0.2.0
+------
+
+* Added editable attribute to TextArea (Allows selection, but not alteration).
+* Added Element#font= and :font option.
+* Added Gosu::Color#colorize to use when using in-line text styling.
+* Managed layout of entities and XML tags (Used by Gosu) in TextArea text better (tags still don't like newlines inside them).
+* Changed license from LGPL to MIT.

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in fidgit.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Bil Bas (Spooner)
+
+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/README.md

@@ -0,0 +1,154 @@
+Fidgit
+======
+
+Fidgit is a GUI framework built on [Gosu](http://libgosu.org/) and [Chingu](http://ippa.se/chingu)
+
+
+Description
+-----------
+
+The API is inspired by [Shoes](http://shoesrb.com/), but since Shoes is very simplistic, the level of functionality is
+based around [FXRuby](http://www.fxruby.org/) and other GUI APIs.
+Fidgit was originally developed as a part of the Sidney game, but as it got more complex, it was obvious it would be
+useful to separate them.
+
+_WARNING: THIS PROJECT IS IN EARLY ALPHA DEVELOPMENT AND THE API IS LIABLE TO CONTINUOUS CHANGE AND IT IS QUITE UNSTABLE!_
+
+Read the Yard documentation at [rubydoc.info](http://rubydoc.info/github/Spooner/fidgit/master)
+
+
+Aim
+---
+
+Fidgit aims to be a toolkit which will provide the building blocks to quickly create a GUI either for a GUI-based game
+or for options screens and menus within a regular Gosu game.
+
+
+License
+-------
+
+MIT (see COPYING.txt)
+
+
+Requirements
+------------
+
+* Ruby 1.9.2 or higher.
+* Gosu gem 0.7.27.1
+  * [Installing Gosu dependencies on Linux](http://code.google.com/p/gosu/wiki/GettingStartedOnLinux) (On Win32 and OS X there are binary gems available)
+* Chingu gem 0.9rc4.
+* Clipboard gem
+
+
+Example
+-------
+
+```ruby
+# examples/readme_example.rb
+require 'fidgit'
+
+class MyGame < Chingu::Window
+  def initialize
+    super(640, 480, false)
+
+    # To use the Fidgit features, a Fidgit::GuiState must be active.
+    push_game_state MyGuiState
+  end
+end
+
+class MyGuiState < Fidgit::GuiState
+  def initialize
+    super
+
+    # Create a vertically packed section, centred in the window.
+    vertical align: :center do
+      # Create a label with a dark green background.
+      my_label = label "Hello world!", background_color: Gosu::Color.rgb(0, 100, 0)
+
+      # Create a button that, when clicked, changes the label.
+      button("Goodbye", align_h: :center, tip: "Press me and be done with it!") do
+        my_label.text = "Goodbye cruel world!"
+      end
+    end
+  end
+end
+
+MyGame.new.show
+```
+
+
+API
+---
+
+As well as a cursor and tool-tips that are managed by the GuiState for you, there are several elements you can use inside your GuiState.
+
+Elements are best added by using simple methods (listed below). Most of these method accept a block, some offering access to public methods of the element and others being default event handlers.
+
+The GuiState itself only accepts #vertical/#horizontal/#grid, but any packer or group accepts any other element method.
+
+
+GuiState methods
+----------------
+
+* `pack([:vertical|:horizontal|:grid], ...)` - Add a packer to the state (Block has access to public methods).
+* `clear()` - remove any packers added to the state.
+* `menu(...)` - Show a context menu (Block has access to public methods).
+  * `item(text, value, ...)` - Item in a menu (Block handles :clicked_left_mouse_button event).
+  * `separator(...)` - A horizontal separator between menu items.
+* `message(text, ...)` - Show a message box with button(s) (Block subscribes to a button getting clicked).
+* `file_dialog([:open, :save], ...)` - Open a file dialog to load or save a file (Block is passed the button pressed and the file path set).
+
+### Container methods
+
+#### Arrangement managers
+
+Fidgit uses automatic packers to manage layout.
+
+* `pack([:vertical|:horizontal|:grid], ...)` - Packer that packs its component elements (Block has access to public methods).
+* `group(...)` - Manages any groupable elements put inside it, such as radio-buttons (Block has access to public methods). Best to subscribe to :changed event handler.
+* `scroll_window(...)` - A window having content larger than what is shown, scrolled with scroll-bars (Block has access to public methods of the contents packer)
+
+#### Elements
+
+Elements can be placed inside a packer or group.
+
+* `button(text, ...)` - Button with text and/or icon (Block handles :clicked_left_mouse_button event).
+* `color_picker(...)` - Red, green and blue sliders and colour indicator (Block handles :changed event).
+* `image_frame(image, ...)` - Wrapper around a Gosu::Image to embed it in the GUI.
+* `label(text, ...)` - Label with text and, optionally, an icon (No block accepted).
+* `slider(...)` - Horizontal slider with handle (Block handles :changed event).
+* `text_area(...)` - An multi-line element, containing editable text (Block handles :changed event).
+* `toggle_button(text, ...)` - Button that can be toggled on/off (Block handles :changed event).
+
+##### Groupable elements
+
+These should be placed within a group (directly or indirectly) and only one of them will be selected. The group manages which one is selected.
+
+* `color_well(color, ...)` - A radio-button used to pick a colour (Block handles :clicked_left_mouse_button event).
+* `radio_button(text, value, ...)` - Button that is part of a group (Block handles :clicked_left_mouse_button event).
+
+##### Compound elements
+
+These elements contain items, which can easily be added from within a block passed to them. One can subscribe to the :changed event, which is usually easier than managing each item separately.
+
+* `combo_box(...)` - Button that has a drop-down menu attached (Block has access to public methods).
+  * `item(text, value, ...)` - Add an item to a combo box (Block handles :clicked_left_mouse_button event).
+* `list(...)` - A vertical list of items to select from (Block has access to public methods).
+  * `item(text, value, ...)` - Add an item to a combo box (Block handles :clicked_left_mouse_button event).
+
+
+##### Alternative GUI frameworks
+
+There are two other GUI tool-kits that work with Gosu:
+
+* [Rubygoo](http://code.google.com/p/rubygoo/)
+  * Additionally supports [Rubygame](http://rubygame.org/) (as well as Gosu).
+  * Only simple widgets are implemented.
+  * No longer supported.
+
+* [GGLib](http://code.google.com/p/gglib/) (Gosu GUI Library)
+  * Pretty graphical themes.
+  * Only simple widgets are implemented.
+  * No longer supported (though author has commented that they would like to pick it up again).
+
+Remember that if you primarily want a GUI for your GUI application, not just a GUI in your Gosu game, consider using a dedicated GUI tool-kit, such as [Shoes](http://shoesrb.com/) or [wxruby-ruby19](http://wxruby.rubyforge.org/)

data/Rakefile

@@ -0,0 +1,38 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'yard'
+require 'redcloth'
+
+README_HTML = "README.html"
+README_TEXTILE = "README.textile"
+
+class EventHandlesHandler < YARD::Handlers::Ruby::Base
+  handles method_call(:handles)
+
+  def process
+    klass = statement.parent.parent.jump(:const)[0]
+    name = statement.method_name(true)
+    params = statement.parameters(false).dup
+    puts "Processing Event method: #{klass}.#{name} :#{params[0].jump(:ident)[0]}"
+  end
+end
+
+
+YARD::Rake::YardocTask.new
+task :yard => README_HTML
+
+desc "Convert readme to HTML"
+file README_HTML => :readme
+task :readme => README_TEXTILE do
+  puts "Converting readme to HTML"
+  File.open(README_HTML, "w") do |file|
+    file.write RedCloth.new(File.read(README_TEXTILE)).to_html
+  end
+end
+
+# Specs
+desc "Run rspec 2.0"
+task :rspec do
+  system "rspec spec"
+end

data/config/default_schema.yml

@@ -0,0 +1,216 @@
+# Default schema for Fidgit
+---
+
+# Define all constant values here. For colours, use [R, G, B] or [R, G, B, A].
+# Reference constants with ?constant_name
+:constants:
+  # General constants (strings and numbers).
+  :scroll_bar_thickness: 12
+
+  # Gosu::Color constants
+  :none: [0, 0, 0, 0]
+
+  :black: [0, 0, 0]
+  :white: [255, 255, 255]
+
+  :very_dark_gray: [50, 50, 50]
+  :dark_gray: [100, 100, 100]
+  :gray: [150, 150, 150]
+  :light_gray: [200, 200, 200]
+
+  :red: [255, 0, 0]
+  :green: [0, 0, 255]
+  :blue: [0, 0, 255]
+
+  :dark_red: [100, 0, 0]
+  :dark_green: [0, 100, 0]
+  :dark_blue: [0, 0, 100]
+
+# Default element attributes.
+:elements:
+  :Button: # < Label
+    :background_color: ?dark_gray
+    :border_color: ?light_gray
+    :border_thickness: 2
+    :shortcut_color: ?red
+    :padding_top: 2
+    :padding_right: 4
+    :padding_bottom: 2
+    :padding_left: 4
+
+    :disabled:
+      :background_color: ?very_dark_gray
+      :border_color: ?gray
+
+    :hover:
+      :background_color: ?gray
+
+  :ColorPicker:
+    :indicator_height: 30
+
+  :ColorWell: # < RadioButton
+    :height: 32
+    :outline_color: ?gray
+    :width: 32
+
+    :checked:
+      :border_color: ?very_dark_gray
+
+  :ComboBox: # < Button
+    :background_color: ?dark_gray
+    :border_color: ?white
+
+  :Composite: # < Container
+    :padding_top: 0
+    :padding_right: 0
+    :padding_bottom: 0
+    :padding_left: 0
+
+  :Container: # < Element
+    {}
+
+  :Element:
+    :align_h: :left
+    :align_v: :top
+    :background_color: ?none
+    :background_image: nil
+    :border_color: ?none
+    :border_thickness: 0
+    :color: ?white
+    :font_height: 30
+    :font_name: :default
+    :padding_top: 2
+    :padding_right: 4
+    :padding_bottom: 2
+    :padding_left: 4
+
+
+  :FileBrowser: # < Composite
+    :pattern: "*.*"
+    :show_extension: true
+
+  :Grid: # < Packer
+    :cell_background_color: ?none
+    :cell_border_color: ?none
+    :cell_border_thickness: 0
+
+  :Group: # < Packer
+    :padding_top: 0
+    :padding_right: 0
+    :padding_bottom: 0
+    :padding_left: 0
+
+  :Horizontal: # < Grid
+    {}
+
+  :HorizontalScrollBar: # < ScrollBar
+    :height: ?scroll_bar_thickness
+
+  :ImageFrame: # <Element
+    :padding_top: 0
+    :padding_right: 0
+    :padding_bottom: 0
+    :padding_left: 0
+
+  :Label: # < Element
+    :justify: :left
+    :icon_position: :left
+
+    :disabled:
+      :color: ?gray
+
+  :List:
+    :background_color: ?light_gray
+    :border_color: ?white
+
+  :List::Item:
+    :border_thickness: 0
+
+  :MainPacker: # < Packer
+    :border_thickness: 0
+    :padding_top: 0
+    :padding_right: 0
+    :padding_bottom: 0
+    :padding_left: 0
+    :spacing_h: 0
+    :spacing_v: 0
+
+  :MenuPane:
+    :background_color: ?very_dark_gray
+
+  :MenuPane::Item: # < Button
+    :border_color: ?none
+    :border_thickness: 0
+
+  :MenuPane::Separator: # < Label
+     :line_height: 2
+     :background_color: ?black
+
+  :Packer: # < Container
+    :spacing_h: 4
+    :spacing_v: 4
+
+  :RadioButton: # < Button
+    :checked:
+      :border_color: ?blue
+
+  :ScrollArea: # < Composite
+    {}
+
+  :ScrollBar: # < Composite
+    :background_color: ?none
+    :border_color: ?none
+    :handle_color: ?dark_red
+    :rail_color: ?very_dark_gray
+    :rail_width: ?scroll_bar_thickness
+
+  :ScrollWindow: # < Composite
+    :scroll_bar_thickness: ?scroll_bar_thickness
+    :border_color: ?light_gray
+    :border_thickness: 1
+
+  :Slider: # < Element
+    :background_color: ?none
+    :border_color: ?dark_gray
+    :groove_color: ?light_gray
+    :handle_color: ?dark_green
+
+  :Slider::Handle: # < Element
+    :background_color: ?dark_blue
+
+  :TextArea: # < Composite
+    :background_color: ?very_dark_gray
+    :border_color: ?light_gray
+    :caret_color: ?red
+    :caret_period: 500 # In milliseconds
+    :line_spacing: 0
+    :selection_color: ?dark_gray
+
+    :focused:
+      :border_color: ?green
+
+  :TextLine: # < Element
+    :justify: :left
+    :padding_top: 0
+    :padding_right: 0
+    :padding_bottom: 0
+    :padding_left: 0
+
+  :ToggleButton: # < Button
+    :toggled:
+      :border_color: ?red
+
+  :ToolTip: # < Label
+    :background_color: ?very_dark_gray
+    :font_height: 20
+    :border_color: ?white
+    :padding_top: 2
+    :padding_right: 4
+    :padding_bottom: 2
+    :padding_left: 4
+
+  :Vertical: # < Grid
+    {}
+
+  :VerticalScrollBar: # < ScrollBar
+    :width: ?scroll_bar_thickness