Hate 3d
A Ruby 3d OpenGL game library inspired by the Lua Love project, a fun little 2d game engine.
The project name hate
is a parody of the inspiration.
Other inspirational Ruby game projects worth checking out (and much, much more feature complete, albeit only 2d).
Installation
gem install hate
Usage
Your game requires a main.rb
file at the root of your game directory which hate
will execute. There is an example game located in the example folder which shows how the basic methods of the system work. At the moment you must wrap all the methods in a module like so.
module Hate
module Game
# methods
end
end
Core Methods
These are predefined and overridable methods which the engine implements. Any logic you write within them will get execute by the engine.
self.load
Anything defined in here is initially loaded at system startup.
self.update
Anything in here gets called every second draw call. In theory physics and non draw frame game updates would go in here.
self.draw
Draw logic for all of the objects in your scene.
self.keypressed(k)
Any keys which have been pressed by the user as a byte character.
self.mousepressed(x, y, button)
The x, y position and button pressed for the mouse.
self.mousemotion(x, y, xr, yr, state)
The x, y position, x, y position at click, and button state of the mouse.
self.quit
The quit callback.
Support
Currently this has only been tested on OSX using MRI 1.8.7 and MRI 1.9.2. Unfortunately ffi-opengl under Rubinius and jRuby doesn't seem to be operational.
Known Issues
- Quit doesn't exit cleanly.
- The framerate slows down when the mouse is moved.
- The framerate isn't locked to a constant rate.
- The full system isn't currently implemented, and the engine is a continual work in progress.
Authors
Brian 'bojo' Jones mojobojo@gmail.com
License
The MIT License
Copyright (c) 2011 Brian Jones
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.