rubygame 2.1.0

data/ext/rubygame/rubygame_ttf.h

@@ -0,0 +1,69 @@
+/*
+ * Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+ * Copyright (C) 2004-2007  John Croisant
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ */
+
+#ifndef _RUBYGAME_TTF_H
+#define _RUBYGAME_TTF_H
+
+#include "SDL_ttf.h"
+
+#ifndef SDL_TTF_MAJOR_VERSION
+#define SDL_TTF_MAJOR_VERSION 0
+#endif
+
+#ifndef SDL_TTF_MINOR_VERSION
+#define SDL_TTF_MINOR_VERSION 0
+#endif
+
+#ifndef SDL_TTF_PATCHLEVEL
+#define SDL_TTF_PATCHLEVEL 0
+#endif
+
+extern void Init_rubygame_ttf();
+
+extern VALUE cTTF;
+
+extern VALUE rbgm_ttf_setup(VALUE);
+extern VALUE rbgm_ttf_quit(VALUE);
+extern VALUE rbgm_ttf_new(VALUE, VALUE, VALUE);
+extern VALUE rbgm_ttf_initialize(int, VALUE*, VALUE);
+
+extern VALUE rbgm_ttf_getbold(VALUE);
+extern VALUE rbgm_ttf_setbold(VALUE, VALUE);
+
+extern VALUE rbgm_ttf_getitalic(VALUE);
+extern VALUE rbgm_ttf_setitalic(VALUE, VALUE);
+
+extern VALUE rbgm_ttf_getunderline(VALUE);
+extern VALUE rbgm_ttf_setunderline(VALUE, VALUE);
+
+extern VALUE rbgm_ttf_height(VALUE);
+extern VALUE rbgm_ttf_ascent(VALUE);
+extern VALUE rbgm_ttf_descent(VALUE);
+extern VALUE rbgm_ttf_lineskip(VALUE);
+
+extern VALUE rbgm_ttf_sizetext(VALUE, VALUE);
+extern VALUE rbgm_ttf_size_utf8(VALUE, VALUE);
+extern VALUE rbgm_ttf_size_unicode(VALUE, VALUE);
+
+extern VALUE rbgm_ttf_render(int, VALUE*, VALUE);
+extern VALUE rbgm_ttf_render_utf8(int , VALUE*, VALUE);
+extern VALUE rbgm_ttf_render_unicode(int , VALUE*, VALUE);
+ 
+#endif

data/lib/rubygame.rb

@@ -0,0 +1,40 @@
+#--
+#  Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+#  Copyright (C) 2004-2007  John Croisant
+#
+#  This library is free software; you can redistribute it and/or
+#  modify it under the terms of the GNU Lesser General Public
+#  License as published by the Free Software Foundation; either
+#  version 2.1 of the License, or (at your option) any later version.
+#
+#  This library is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#  Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public
+#  License along with this library; if not, write to the Free Software
+#  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#++
+
+# This is the file that should be imported, it in turn imports rubygame.so
+# (which has all of the C code for rubygame) and all the other rubygame modules
+
+require "rbconfig"
+
+require "rubygame_core"
+
+%W{ rubygame_gfx rubygame_image rubygame_ttf rubygame_mixer }.each do |mod|
+  begin
+    require mod
+  rescue LoadError
+    warn( "Warning: Unable to require optional module: #{mod}.") if $VERBOSE
+  end
+end
+
+require "rubygame/constants"
+require "rubygame/event"
+require "rubygame/queue"
+require "rubygame/rect"
+require "rubygame/sprite"
+require "rubygame/clock"

data/lib/rubygame/MANIFEST

@@ -0,0 +1,12 @@
+clock.rb
+constants.rb
+event.rb
+ftor.rb
+hotspot.rb
+keyconstants.rb
+MANIFEST
+mediabag.rb
+queue.rb
+rect.rb
+sfont.rb
+sprite.rb

data/lib/rubygame/clock.rb

@@ -0,0 +1,128 @@
+#--
+#	Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+#	Copyright (C) 2004-2007  John Croisant
+#
+#	This library is free software; you can redistribute it and/or
+#	modify it under the terms of the GNU Lesser General Public
+#	License as published by the Free Software Foundation; either
+#	version 2.1 of the License, or (at your option) any later version.
+#
+#	This library is distributed in the hope that it will be useful,
+#	but WITHOUT ANY WARRANTY; without even the implied warranty of
+#	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#	Lesser General Public License for more details.
+#
+#	You should have received a copy of the GNU Lesser General Public
+#	License along with this library; if not, write to the Free Software
+#	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#++
+
+module Rubygame
+		#  Clock provides class methods for tracking running time and delaying
+		#  execution of the program for specified time periods. This is used to
+		#  provide a consistent framerate, prevent the program from using
+		#  all the processor time, etc.
+		# 
+		#  Clock also provides instance methods to make it convenient to
+		#  monitor and limit application framerate. See #tick.
+		class Clock
+			# The runtime when the Clock was initialized.
+			attr_reader :start        
+			# The number of times #tick has been called.
+			attr_reader :ticks        
+
+			# Create a new Clock instance.
+			def initialize()
+				@start = Clock.runtime()
+				@last_tick = @start
+				@ticks = 0
+				@target_frametime = nil
+				yield self if block_given?
+			end
+
+			# The target frametime (milliseconds/frame). See #tick
+			attr_accessor :target_frametime
+
+			# Returns the current target framerate (frames/second).
+			# This is an alternate way to access @target_frametime.
+			# Same as: 1000.0 / #target_frametime
+			def target_framerate
+				if @target_frametime
+					1000.0 / @target_frametime
+				else
+					nil
+				end
+			rescue ZeroDivisionError
+				return nil
+			end
+
+			# Sets the target number of frames per second to +framerate+.
+			# This is an alternate way to access @target_frametime.
+			# Same as: #target_frametime = 1000.0 / framerate
+			def target_framerate=( framerate )
+				if framerate
+					@target_frametime = 1000.0 / framerate
+				else
+					@target_frametime = nil
+				end
+			rescue ZeroDivisionError
+				@target_frametime = nil
+			end
+
+			# call-seq: lifetime()  ->  Numeric
+			# 
+			# Returns time in milliseconds since this Clock instance was created.
+			def lifetime
+				Clock.runtime() - @start
+			end
+
+			# call-seq: framerate()  ->  Numeric
+			# 
+			# Return the actual framerate (frames per second) recorded by the Clock.
+			# See #tick.
+			# 
+			# TODO: sample only a few seconds in the past, instead of the
+			# entire lifetime of the Clock. 
+			def framerate
+				# below is same as: return @ticks / (lifetime / 1000.0)
+				return 1000.0 * @ticks / lifetime()
+			rescue ZeroDivisionError
+				return 0
+			end
+
+			# Returns the number of milliseconds since you last called this method.
+			# 
+			# You must call this method once per frame (i.e. per iteration of
+			# your main loop) if you want to use the framerate monitoring and/or
+			# framerate limiting features.
+			# 
+			# Framerate monitoring allows you to check the framerate (frames per
+			# second) with the #framerate method.
+			# 
+			# Framerate limiting allows you to prevent the application from running
+			# too fast (and using 100% of processor time) by pausing the program
+			# very briefly each frame. The pause duration is calculated each frame
+			# to maintain a constant framerate.
+			# 
+			# Framerate limiting is only enabled if you have set the
+			# #target_framerate= or #target_frametime=.
+			# If you have done that, this method will automatically perform the
+			# delay each time you call it.
+			# 
+			# (Please note that no effort is made to correct a framerate
+			# which is *slower* than the target framerate. Clock can't
+			# make your code run faster, only slow it down if it is
+			# running too fast.)
+			def tick()
+				passed = Clock.runtime() - @last_tick  # how long since the last tick?
+				if @target_frametime
+					return Clock.delay(@target_frametime - passed) + passed
+				end
+				return passed
+			ensure
+				@last_tick = Clock.runtime()
+				@ticks += 1
+			end
+
+		end # class Clock
+end #module Rubygame

data/lib/rubygame/constants.rb

@@ -0,0 +1,238 @@
+#--
+#	Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+#	Copyright (C) 2004-2007  John Croisant
+#
+#	This library is free software; you can redistribute it and/or
+#	modify it under the terms of the GNU Lesser General Public
+#	License as published by the Free Software Foundation; either
+#	version 2.1 of the License, or (at your option) any later version.
+#
+#	This library is distributed in the hope that it will be useful,
+#	but WITHOUT ANY WARRANTY; without even the implied warranty of
+#	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#	Lesser General Public License for more details.
+#
+#	You should have received a copy of the GNU Lesser General Public
+#	License along with this library; if not, write to the Free Software
+#	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+#++
+
+module Rubygame
+
+	module Mouse
+		# Hash to translate mouse button sym to string
+		MOUSE2STR = {
+			MOUSE_LEFT => "left",
+			MOUSE_MIDDLE => "middle",
+			MOUSE_RIGHT => "right"
+		}
+		# And to translate the other way...
+		STR2MOUSE = MOUSE2STR.invert()
+		# And allow numbers too (1 = left, so on)...
+		STR2MOUSE[1] = MOUSE_LEFT
+		STR2MOUSE[2] = MOUSE_MIDDLE
+		STR2MOUSE[3] = MOUSE_RIGHT
+	end # module Mouse
+
+	module Key
+		# All the keys which have ASCII print values
+		# It is 87 lines from here to the closing }, if you want to skip it...
+		KEY2ASCII = {
+			K_BACKSPACE => "\b",
+			K_TAB => "\t",
+			K_RETURN => "\n", #SDL docs: "\r". Win vs *nix? What about Mac?
+			K_ESCAPE => "^[",
+			K_SPACE => " ",
+			K_EXCLAIM => "!",
+			K_QUOTEDBL => "\"",
+			K_HASH => "#",
+			K_DOLLAR => "$",
+			K_AMPERSAND => "&",
+			K_QUOTE => "\'",
+			K_LEFTPAREN => "(",
+			K_RIGHTPAREN => ")",
+			K_ASTERISK => "*",
+			K_PLUS => "+",
+			K_COMMA => ",",
+			K_MINUS => "-",
+			K_PERIOD => ".",
+			K_SLASH => "/",
+			K_0 => "0",
+			K_1 => "1",
+			K_2 => "2",
+			K_3 => "3",
+			K_4 => "4",
+			K_5 => "5",
+			K_6 => "6",
+			K_7 => "7",
+			K_8 => "8",
+			K_9 => "9",
+			K_COLON => ":",
+			K_SEMICOLON => ";",
+			K_LESS => "<",
+			K_EQUALS => "=",
+			K_GREATER => ">",
+			K_QUESTION => "?",
+			K_AT => "@",
+			K_LEFTBRACKET => "[",
+			K_BACKSLASH => "\\",
+			K_RIGHTBRACKET => "]",
+			K_CARET => "^",
+			K_UNDERSCORE => "_",
+			K_BACKQUOTE => "`",
+			K_A => "a",
+			K_B => "b",
+			K_C => "c",
+			K_D => "d",
+			K_E => "e",
+			K_F => "f",
+			K_G => "g",
+			K_H => "h",
+			K_I => "i",
+			K_J => "j",
+			K_K => "k",
+			K_L => "l",
+			K_M => "m",
+			K_N => "n",
+			K_O => "o",
+			K_P => "p",
+			K_Q => "q",
+			K_R => "r",
+			K_S => "s",
+			K_T => "t",
+			K_U => "u",
+			K_V => "v",
+			K_W => "w",
+			K_X => "x",
+			K_Y => "y",
+			K_Z => "z",
+			K_KP0 => "0",
+			K_KP1 => "1",
+			K_KP2 => "2",
+			K_KP3 => "3",
+			K_KP4 => "4",
+			K_KP5 => "5",
+			K_KP6 => "6",
+			K_KP7 => "7",
+			K_KP8 => "8",
+			K_KP9 => "9",
+			K_KP_PERIOD => ".",
+			K_KP_DIVIDE => "/",
+			K_KP_MULTIPLY => "*",
+			K_KP_MINUS => "-",
+			K_KP_PLUS => "+",
+			K_KP_ENTER => "\n", #again, SDL docs say "\r"
+			K_KP_EQUALS => "=",
+		}
+
+		# And to translate the other way...
+		ASCII2KEY = KEY2ASCII.invert()
+		# accept uppercase letters too, return same as lowercase version:
+		("a".."z").each{ |letter| ASCII2KEY[letter.upcase] = ASCII2KEY[letter] }
+
+		# All the keys that are affected by the Shift key, in lower case
+		# 49 lines from here to the end of the hash
+		KEY2LOWER = {
+			K_QUOTE => "\'",
+			K_COMMA => ",",
+			K_MINUS => "-",
+			K_PERIOD => ".",
+			K_SLASH => "/",
+			K_0 => "0",
+			K_1 => "1",
+			K_2 => "2",
+			K_3 => "3",
+			K_4 => "4",
+			K_5 => "5",
+			K_6 => "6",
+			K_7 => "7",
+			K_8 => "8",
+			K_9 => "9",
+			K_SEMICOLON => ";",
+			K_EQUALS => "=",
+			K_LEFTBRACKET => "[",
+			K_BACKSLASH => "\\",
+			K_RIGHTBRACKET => "]",
+			K_BACKQUOTE => "`",
+			K_A => "a",
+			K_B => "b",
+			K_C => "c",
+			K_D => "d",
+			K_E => "e",
+			K_F => "f",
+			K_G => "g",
+			K_H => "h",
+			K_I => "i",
+			K_J => "j",
+			K_K => "k",
+			K_L => "l",
+			K_M => "m",
+			K_N => "n",
+			K_O => "o",
+			K_P => "p",
+			K_Q => "q",
+			K_R => "r",
+			K_S => "s",
+			K_T => "t",
+			K_U => "u",
+			K_V => "v",
+			K_W => "w",
+			K_X => "x",
+			K_Y => "y",
+			K_Z => "z",
+		}
+
+		# All the keys that are affected by the Shift key, in UPPER case
+		# 49 lines from here to the end of the hash
+		KEY2UPPER = {
+			K_QUOTE => "\"",
+			K_COMMA => "<",
+			K_MINUS => "_",
+			K_PERIOD => ">",
+			K_SLASH => "?",
+			K_0 => ")",
+			K_1 => "!",
+			K_2 => "@",
+			K_3 => "#",
+			K_4 => "$",
+			K_5 => "%",
+			K_6 => "^",
+			K_7 => "&",
+			K_8 => "*",
+			K_9 => "(",
+			K_SEMICOLON => ":",
+			K_EQUALS => "+",
+			K_LEFTBRACKET => "{",
+			K_BACKSLASH => "|",
+			K_RIGHTBRACKET => "}",
+			K_BACKQUOTE => "~",
+			K_A => "A",
+			K_B => "B",
+			K_C => "C",
+			K_D => "D",
+			K_E => "E",
+			K_F => "F",
+			K_G => "G",
+			K_H => "H",
+			K_I => "I",
+			K_J => "J",
+			K_K => "K",
+			K_L => "L",
+			K_M => "M",
+			K_N => "N",
+			K_O => "O",
+			K_P => "P",
+			K_Q => "Q",
+			K_R => "R",
+			K_S => "S",
+			K_T => "T",
+			K_U => "U",
+			K_V => "V",
+			K_W => "W",
+			K_X => "X",
+			K_Y => "Y",
+			K_Z => "Z",
+		}
+	end #module Key
+
+end # module Rubygame