metro-ld25 0.3.3

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.rvmrc

@@ -0,0 +1 @@
+rvm gemset use gaming

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+before_install:
+ - sudo apt-get install build-essential freeglut3-dev libfreeimage-dev libgl1-mesa-dev libopenal-dev libpango1.0-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev libsndfile-dev libxinerama-dev

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in metro.gemspec
+gemspec
+
+gem 'rake'
+
+group 'development' do
+  gem 'guard'
+  gem 'guard-rspec'
+  gem 'rb-fsevent', '~> 0.9.1'
+end

data/Guardfile

@@ -0,0 +1,4 @@
+guard 'rspec', version: 2, cli: "-c -f d" do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Franklin Webber
+
+MIT License
+
+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,189 @@
+```
+  ______  ___      _____
+  ___   |/  /_____ __  /_______________
+  __  /|_/ / _  _ \_  __/__  ___/_  __ \
+  _  /  / /  /  __// /_  _  /    / /_/ /
+  /_/  /_/   \___/ \__/  /_/     \____/
+
+```
+
+Metro is a framework built around [gosu](https://github.com/jlnr/gosu) (the 2D
+game development library in Ruby). The goal of Metro is to enforce common
+conceptual structures and conventions making it easier to quickly generate a
+game.
+
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/burtlo/metro)
+
+[![Build Status](https://travis-ci.org/burtlo/metro.png)](https://travis-ci.org/burtlo/metro)
+
+[![Dependency Status](https://gemnasium.com/burtlo/metro.png)](https://gemnasium.com/burtlo/metro)
+
+## Why Use Metro?
+
+You want to develop games in Ruby.
+
+### Why not just use Gosu?
+
+Gosu does a lot of great work bringing OpenGL to Ruby. However, when you finish
+the [initial tutorial](https://github.com/jlnr/gosu/wiki/Ruby-Tutorial) you are
+left with a brittle game that is very resistant to changes or new features.
+
+* Metro provides the concept of a
+  [Scene](https://github.com/burtlo/metro/wiki/Scenes) which is the first
+  abstraction you would likely build after completing the tutorial.
+
+> Developing your game in individual scenes will make it easier to logically
+layout your game.
+
+* Sane management of images, animations, fonts, songs, and samples through
+  [model properties](https://github.com/burtlo/metro/wiki/Model-properties).
+
+> Having to load and cache fonts and images in every one of your models is
+tedious. It is also is wasteful as several of the same fonts are being used all
+over the place.
+
+* [Key-frame animations](https://github.com/burtlo/metro/wiki/Animations)
+
+> Metro makes it simple to move an actor from one position to another position.
+So simple movements, fades, color changes, and really any property change over
+time is defined very simply.
+
+* [Event Handling](https://github.com/burtlo/metro/wiki/Events)
+
+> Delete those huge `if ... elsif ... else` input checking structures for
+keyboard, gamepad, and mouse button presses (down,up, and held). Metro makes it
+easy to define them and an attach a course of action to take when the event
+happens.
+
+### Why not use Chingu or Gamebox?
+
+Both [Gamebox](https://github.com/shawn42/gamebox) and
+[Chingu](https://github.com/ippa/chingu) are more mature libraries with a
+larger set of features. I encourage you to check out those libraries.
+
+Metro's primary goal is to be a framework of features that make game development
+joyful.
+
+* Active Reloading while building your scenes.
+
+> Adjustments to your game code while working on a scene will automatically
+reload your game code. The template game sets up a shortcut key (**Ctrl+R**)
+that allows you to explicitly reload the game and the current scene.
+
+* Scene Edit Support
+
+> Scenes can enter an edit mode which allows you to re-position actors within
+the scene. The changes can then be saved back to the view. This allows you to
+fine tune the layout of those scene elements, making it easier to get things
+pixel perfect.
+
+Metro's secondary goal is to make it easier for individuals familiar with Rails
+get into game development. That is the reason for some of the design choices,
+the opinionated structure, and generators that come with Metro.
+
+### Why you shouldn't use Metro?
+
+Metro has some the following limitations:
+
+* Limited to the gems defined within Metro
+
+> At this point in time you are not able to define and package additional
+dependencies with your game. This means if you are using a gem that is not
+already defined by Metro you will run into trouble when running it on alternate
+systems. This will likely be addressed in the future when more demand arises.
+
+* Difficult Deployment
+
+> For individuals to play your game, they will also have to install Metro.
+However, work is being made to bring some simple packaging to Metro games to
+make them stand-along executables.
+
+## Installation
+
+```bash
+$ gem install metro
+```
+
+## Usage
+
+### Running a Game
+
+By default `metro` will look for a file named 'metro' within the current working
+directory if no *gamefilename* has been provided.
+
+```bash
+$ metro GAMEFILENAME
+```
+
+Please take a look at the [example game project](https://github.com/burtlo/starry-knight) that is being built alongside of 'metro'. It currently showcases all the current features available to the game.
+
+```bash
+$ git clone git://github.com/burtlo/starry-knight.git
+$ cd starry-knight
+$ metro
+```
+
+### Creating a Game
+
+Metro contains content generators to assist you.
+
+Creating a Game can be done with a single command.
+
+```bash
+$ metro new GAMENAME
+```
+
+This should generate for you a starting game with a branding scene and a title
+scene. The game allows the player to start the game.
+
+The game is missing the `first` scene of the game. This can be created with the
+scene generator:
+
+```bash
+$ metro generate scene first
+```
+
+This should generate a scene in the scenes directory. The scene file contains a lot of examples of how to draw, animate and have your scene listen to events.
+
+## Resources
+
+### Programming
+
+* [YAML for Ruby](http://www.yaml.org/YAML_for_ruby.html) reference which can help you define views in the game.
+* [JSONLint](http://jsonlint.com/) is a JSON Validator
+
+### Art
+
+* [Lost Garden](http://www.lostgarden.com/2007/05/dancs-miraculously-flexible-game.html)
+* [Text to ASCII Art Generator](http://patorjk.com/software/taag)
+* [Icons](http://css-tricks.com/flat-icons-icon-fonts/)
+* [Subtle Patterns](http://subtlepatterns.com/) various backgrounds and textures.
+
+### Drawing
+
+* [Tiled Map Editor](http://www.mapeditor.org/) generates tile maps.
+* [Pixen](http://pixenapp.com/) generates sprites and animations.
+* [Zwoptex](http://www.zwopple.com/zwoptex/) generates sprite sheets.
+
+### Animation
+
+* [TimelieFX](http://www.rigzsoft.co.uk/) particle editor allows you to export animations.
+
+### Sound
+
+* [as3sfxr](http://www.superflashbros.net/as3sfxr/) generates unique sounds.
+* [bfxr](http://www.bfxr.net/) generates unique sounds.
+* [Audacity](http://audacity.sourceforge.net/) for recording and editing.
+* [Ableton](https://www.ableton.com/en/) music generation tool.
+
+### Books
+
+* [Rules of Play](http://www.amazon.com/dp/0262240459)
+* [Game Programming Gems 8](http://www.amazon.com/dp/1584507020)
+* [Game Feel](http://www.amazon.com/dp/0123743281)
+* [Game Coding Complete](http://www.amazon.com/dp/1584506806)
+* [Game Design Workshop](http://www.amazon.com/dp/0240809742)
+* [Challenges For Game Designers](http://www.amazon.com/dp/158450580X)
+* [The Art of Game Design: A book of lenses](http://www.amazon.com/dp/0123694965)
+* [A Theory of Fun](http://www.theoryoffun.com)
+* [Andrew Rollings and Ernest Adams on Game Design](http://www.amazon.com/dp/1592730019)

data/Rakefile

@@ -0,0 +1,18 @@
+require "bundler/gem_tasks"
+
+begin
+
+  require 'rspec/core/rake_task'
+
+  desc "Run all rspecs"
+  RSpec::Core::RakeTask.new(:spec) do |t|
+    t.pattern = 'spec/**/*_spec.rb'
+    t.rspec_opts = '-c'
+  end
+
+  task :default => :spec
+
+rescue LoadError
+  puts "please install rspec to run tests"
+  puts "install with gem install rspec"
+end

data/bin/metro

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+path = __FILE__
+while File.symlink?(path)
+  path = File.expand_path(File.readlink(__FILE__), File.dirname(__FILE__))
+end
+$:.unshift(File.join(File.dirname(File.expand_path(path)), '..', 'lib'))
+
+require 'metro'
+require 'commands/thor'
+
+if Metro::Thor.tasks.keys.include? ARGV.first
+  Metro::Thor.start
+else
+  Metro.run(*ARGV)
+end

data/changelog.md

@@ -0,0 +1,157 @@
+# Metro
+
+## 0.3.4 / 2012-12-02
+
+* 'Metro::UI::Sprite' and 'Metro::UI::AnimatedSprite' are now available
+  for defining models that have visual representation, positions, locations
+  dimensions, bounds, scale, and angle.
+* 'Metro::UI::TimeMap' is now available. This is a mapping of the Tile
+	Editor output (JSON only export)
+* More informative error message when a model is not found and you
+  get stuck with a Generic.
+* Positions can now be defined as strings
+
+## 0.3.3 / 2012-11-28
+
+* Edit Mode - actors within a scene can have their position edited
+  and saved. Actors within the scene that have a valid bounds
+  specified will appear within the scene with name and bounding box.
+* Dimensions can now be defined as strings
+* Game bounds and Game dimensions return objects of that type
+* `metr::ui::fps` added and has some shortcut placements settings
+
+## 0.3.2 / 2012-11-26
+
+* Debug Mode will now automatically reload the game and scene on source
+  file changes.
+* Reloading the game will no longer take down the app for syntax errors
+  and other errors that are easily detected by simply loading the code.
+* Template game is now automatically has debug mode enabled by default
+
+## 0.3.1 / 2012-11-25
+
+* FIX issue with some Gosu example code left in the oven
+
+## 0.3.0 / 2012-11-25
+
+* FIX lots of typos in the documentation
+* Removed `up_action_missing` and `down_ation_missing` event handling
+* Notification events now have block support for 0, 1 and 2 parameters
+* FIX Registration of custom defined custom view parsers
+* FIX Grid Layer layout for Edit Mode
+
+
+## 0.2.7 / 2012/11-20
+
+* FIX to the new game template
+* Updated the game template to give more movement to the hero in the first scene
+* Added the fade-in, fade-out helper to show all the instructions
+
+## 0.2.6 / 2012/11-20
+
+* Menus now support vertical and horizontal layout
+* Menus now support movement and selection noises
+* Menus can now have a default selection
+* Menus can be enabled/disabled
+* Added Array Property, Boolean Property, and Menu Options Property
+* FIX label horizontal center and right alignments
+* Generic Models will now show a warning instead of raising an exception
+* Removed event chain debug messaging
+
+## 0.2.5 / 2012-11-18
+
+* FIX metro::ui::rectangle calculation
+* FIX remaining references to metro::models::* to metro::ui::*
+* FIX Models will use their setters over setting raw properties
+* Metro::UI::Label now supports horizontal alignment, vertical alignment, and multiple lines
+
+## 0.2.4 / 2012-11-15
+
+* All retrieved models from properties are now cached for better performance
+* Animations were re-vamped to accept more parameters
+* Metro models names in code are now referred to as "metro::models::*" to "metro::ui::*"
+
+## 0.2.3 / 2012-11-11
+
+* FIX metro generators and templates generating out-of-date formats
+* FIX YAML views will now return an empty hash instead of false on empty files
+* Added first scene and model to template.
+* FIX better error message when a directory is specified
+* Added the `g` generator shortcut: `metro g scene NAME`
+
+## 0.2.2 / 2012-11-10
+
+* Song support added (scene methods and model properties)
+* Sample support added (model properties)
+* Added a missing sample/song
+* Implicit Animation easings can now be more easily created and registered.
+* Properties can now be defined with a block
+* FIX Dimensions parse creation called wrong method
+* Removed support for specifying a color in animation
+
+## 0.2.1 / 2012-11-08
+
+* FIX Scene fade transition color changing and implicit animations
+  for colors
+* Games creating custom properties will appear in the property list
+* Properties now correctly default to numeric properties
+* Point objects can be added to other point objects.
+
+## 0.2.0 / 2012-11-07
+
+* Views now use position instead of `x`, `y`, and `z-order`
+* Point, Scale, and Dimensions is available in model and scenes.
+* Events are shared from superclasses to subclasses.
+* Templates updated to use GameScene and GameModel for each game.
+* Models are automatically added to the update loop
+* Model properties now make it easier to store/retrieve various
+  common numeric, position font, image, and animation properties.
+
+
+## 0.1.6 / 2012-11-07
+
+* Events are shared from superclasses to subclasses.
+* Templates updated to use GameScene and GameModel for each game.
+* Models are automatically added to the update loop
+* Model properties now make it easier to store/retrieve various
+  common numeric, position font, image, and animation properties.
+
+## 0.1.5 / 2012-11-01
+
+* Metro.reload! will reload all game classes
+* Scenes can now an editable state where the position of items can be
+  updated and saved.
+* Event blocks can optionally receive an event object. The event object
+  includes modifier key information.
+
+
+## 0.1.4 / 2012-10-28
+
+* Removed dependency on the sender gem so metro is playable on Windows
+
+## 0.1.3 / 2012-10-28
+
+* Fade Scene Transition support added
+* Numeric#seconds and Numeric#ticks helpers added
+* Scenes can now define delayed events `after 2.seconds do ; end`
+* Labels have more defaults and more font options and size
+* Labels and images will default to center of screen
+* Able to define game controls within your metro file
+* Implicit animations support color change.
+
+## 0.1.2 / 2012-10-26
+
+* Generators for games, scenes, models, and views
+
+## 0.1.1 / 2012-10-25
+
+* FIX: Requiring the sender gem
+
+## 0.1.0 / 2012-10-25
+
+* Better error handling for missing metro file and missing scene
+* FIX: Scenes without Scene suffix will work again
+* Gosu::Color supports creation with various formats: rgb, rgba, and hex
+* Animations can be defined with class level helpers
+* Removed Scene#events as Events can be defined at the class level
+* Scenes and Models can generate custom notification events