rubygame 2.2.0-i586-linux

data/lib/rubygame/color/palettes/palette.rb

@@ -0,0 +1,100 @@
+#--
+#	Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+#	Copyright (C) 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
+#++
+
+class Rubygame::Color::Palette
+
+	# Create a new Palette with the given name => color pairs.
+	def initialize( colors = {} )
+		@includes = []
+		
+		@colors = {}
+		colors.each_pair do |name, color|
+			@colors[sanitize_name(name)] = color
+		end
+	end
+
+	# Retrieve a color by name from this palette.
+	# 
+	# The name can be a Symbol or String. See #sanitize_name.
+	# 
+	# If the color cannot be found in this palette, search
+	# each of the #included palettes (recursively, depth-first,
+	# to a maximum depth of 5 levels).
+	# 
+	# If the color is not found in this palette or any included
+	# palettes, raise IndexError.
+	# 
+	def []( name )
+		c = lookup( sanitize_name( name ) )
+		raise IndexError, "unknown color #{name}" unless c
+		return c
+	end
+	
+	# Store a color by name in this palette. See #sanitize_name
+	def []=( name, color )
+		name = sanitize_name( name )
+		@colors[name] = color
+	end
+	
+	# Include another palette in this one. If a color cannot be
+	# found in this palette, the included palette(s) will be searched.
+	# See also #uninclude.
+	# 
+	# Has no effect if the palette is already included.
+	def include( palette )
+		@includes += [palette] unless @includes.include? palette
+	end
+	
+	# Remove the other palette from this one, so that it won't be
+	# searched for missing colors anymore. Has no effect if the
+	# other palette hasn't been #included.
+	def uninclude( palette )
+		@includes -= [palette]
+	end
+	
+	protected
+
+	# Recursive color lookup
+	def lookup( name, max_depth=5 ) # :nodoc:
+		return nil if max_depth < 0
+
+		color = @colors[name]
+
+		unless color
+			@includes.each { |palette|
+				c = palette.lookup(name, max_depth-1)
+				color = c if c
+			}
+		end
+
+		return color
+	end
+	
+	private
+
+	# Takes either a Symbol or a String, and converts it to a
+	# lowercase Symbol with spaces converted to underscores.
+	# 
+	# E.g. "Alice Blue" and :ALICE_BLUE both become :alice_blue.
+	# 
+	def sanitize_name( name )
+		name.to_s.gsub(' ','_').downcase.intern
+	end
+
+end

data/lib/rubygame/color/palettes/x11.rb

@@ -0,0 +1,177 @@
+#--
+#	Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+#	Copyright (C) 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
+#++
+
+require 'rubygame/color'
+require 'rubygame/color/palettes/palette'
+
+module Rubygame
+	module Color
+
+		# :enddoc:
+
+		# The X11 module contains all the colors in the X11 palette
+		# by symbol name, e.g. :alice_blue, :dark_olive_green, etc.
+		# 
+		# The list of colors is derived from
+		# http://en.wikipedia.org/wiki/X11_color_names
+		# as accessed on 2007-12-17.
+		X11 = Palette.new({
+			:alice_blue =>               ColorRGB.new( [0.94117, 0.97254, 1.00000] ),
+			:antique_white =>            ColorRGB.new( [0.98039, 0.92156, 0.84313] ),
+			:aqua =>                     ColorRGB.new( [0.00000, 1.00000, 1.00000] ),
+			:aquamarine =>               ColorRGB.new( [0.49803, 1.00000, 0.83137] ),
+			:azure =>                    ColorRGB.new( [0.94117, 1.00000, 1.00000] ),
+			:beige =>                    ColorRGB.new( [0.96078, 0.96078, 0.86274] ),
+			:bisque =>                   ColorRGB.new( [1.00000, 0.89411, 0.76862] ),
+			:black =>                    ColorRGB.new( [0.00000, 0.00000, 0.00000] ),
+			:blanched_almond =>          ColorRGB.new( [1.00000, 0.92156, 0.80392] ),
+			:blue =>                     ColorRGB.new( [0.00000, 0.00000, 1.00000] ),
+			:blue_violet =>              ColorRGB.new( [0.54117, 0.16862, 0.88627] ),
+			:brown =>                    ColorRGB.new( [0.64705, 0.16470, 0.16470] ),
+			:burly_wood =>               ColorRGB.new( [0.87058, 0.72156, 0.52941] ),
+			:cadet_blue =>               ColorRGB.new( [0.37254, 0.61960, 0.62745] ),
+			:chartreuse =>               ColorRGB.new( [0.49803, 1.00000, 0.00000] ),
+			:chocolate =>                ColorRGB.new( [0.82352, 0.41176, 0.11764] ),
+			:coral =>                    ColorRGB.new( [1.00000, 0.49803, 0.31372] ),
+			:cornflower_blue =>          ColorRGB.new( [0.39215, 0.58431, 0.92941] ),
+			:cornsilk =>                 ColorRGB.new( [1.00000, 0.97254, 0.86274] ),
+			:crimson =>                  ColorRGB.new( [0.86274, 0.07843, 0.23529] ),
+			:cyan =>                     ColorRGB.new( [0.00000, 1.00000, 1.00000] ),
+			:dark_blue =>                ColorRGB.new( [0.00000, 0.00000, 0.54509] ),
+			:dark_cyan =>                ColorRGB.new( [0.00000, 0.54509, 0.54509] ),
+			:dark_goldenrod =>           ColorRGB.new( [0.72156, 0.52549, 0.04313] ),
+			:dark_gray =>                ColorRGB.new( [0.66274, 0.66274, 0.66274] ),
+			:dark_green =>               ColorRGB.new( [0.00000, 0.39215, 0.00000] ),
+			:dark_khaki =>               ColorRGB.new( [0.74117, 0.71764, 0.41960] ),
+			:dark_magenta =>             ColorRGB.new( [0.54509, 0.00000, 0.54509] ),
+			:dark_olive_green =>         ColorRGB.new( [0.33333, 0.41960, 0.18431] ),
+			:dark_orange =>              ColorRGB.new( [1.00000, 0.54901, 0.00000] ),
+			:dark_orchid =>              ColorRGB.new( [0.60000, 0.19607, 0.80000] ),
+			:dark_red =>                 ColorRGB.new( [0.54509, 0.00000, 0.00000] ),
+			:dark_salmon =>              ColorRGB.new( [0.91372, 0.58823, 0.47843] ),
+			:dark_sea_green =>           ColorRGB.new( [0.56078, 0.73725, 0.56078] ),
+			:dark_slate_blue =>          ColorRGB.new( [0.28235, 0.23921, 0.54509] ),
+			:dark_slate_gray =>          ColorRGB.new( [0.18431, 0.30980, 0.30980] ),
+			:dark_turquoise =>           ColorRGB.new( [0.00000, 0.80784, 0.81960] ),
+			:dark_violet =>              ColorRGB.new( [0.58039, 0.00000, 0.82745] ),
+			:deep_pink =>                ColorRGB.new( [1.00000, 0.07843, 0.57647] ),
+			:deep_sky_blue =>            ColorRGB.new( [0.00000, 0.74901, 1.00000] ),
+			:dim_gray =>                 ColorRGB.new( [0.41176, 0.41176, 0.41176] ),
+			:dodger_blue =>              ColorRGB.new( [0.11764, 0.56470, 1.00000] ),
+			:fire_brick =>               ColorRGB.new( [0.69803, 0.13333, 0.13333] ),
+			:floral_white =>             ColorRGB.new( [1.00000, 0.98039, 0.94117] ),
+			:forest_green =>             ColorRGB.new( [0.13333, 0.54509, 0.13333] ),
+			:fuchsia =>                  ColorRGB.new( [1.00000, 0.00000, 1.00000] ),
+			:gainsboro =>                ColorRGB.new( [0.86274, 0.86274, 0.86274] ),
+			:ghost_white =>              ColorRGB.new( [0.97254, 0.97254, 1.00000] ),
+			:gold =>                     ColorRGB.new( [1.00000, 0.84313, 0.00000] ),
+			:goldenrod =>                ColorRGB.new( [0.85490, 0.64705, 0.12549] ),
+			:gray =>                     ColorRGB.new( [0.50196, 0.50196, 0.50196] ),
+			:green =>                    ColorRGB.new( [0.00000, 0.50196, 0.00000] ),
+			:green_yellow =>             ColorRGB.new( [0.67843, 1.00000, 0.18431] ),
+			:honeydew =>                 ColorRGB.new( [0.94117, 1.00000, 0.94117] ),
+			:hot_pink =>                 ColorRGB.new( [1.00000, 0.41176, 0.70588] ),
+			:indian_red =>               ColorRGB.new( [0.80392, 0.36078, 0.36078] ),
+			:indigo =>                   ColorRGB.new( [0.29411, 0.00000, 0.50980] ),
+			:ivory =>                    ColorRGB.new( [1.00000, 1.00000, 0.94117] ),
+			:khaki =>                    ColorRGB.new( [0.94117, 0.90196, 0.54901] ),
+			:lavender =>                 ColorRGB.new( [0.90196, 0.90196, 0.98039] ),
+			:lavender_blush =>           ColorRGB.new( [1.00000, 0.94117, 0.96078] ),
+			:lawn_green =>               ColorRGB.new( [0.48627, 0.98823, 0.00000] ),
+			:lemon_chiffon =>            ColorRGB.new( [1.00000, 0.98039, 0.80392] ),
+			:light_blue =>               ColorRGB.new( [0.67843, 0.84705, 0.90196] ),
+			:light_coral =>              ColorRGB.new( [0.94117, 0.50196, 0.50196] ),
+			:light_cyan =>               ColorRGB.new( [0.87843, 1.00000, 1.00000] ),
+			:light_goldenrod_yellow =>   ColorRGB.new( [0.98039, 0.98039, 0.82352] ),
+			:light_green =>              ColorRGB.new( [0.56470, 0.93333, 0.56470] ),
+			:light_grey =>               ColorRGB.new( [0.82745, 0.82745, 0.82745] ),
+			:light_pink =>               ColorRGB.new( [1.00000, 0.71372, 0.75686] ),
+			:light_salmon =>             ColorRGB.new( [1.00000, 0.62745, 0.47843] ),
+			:light_sea_green =>          ColorRGB.new( [0.12549, 0.69803, 0.66666] ),
+			:light_sky_blue =>           ColorRGB.new( [0.52941, 0.80784, 0.98039] ),
+			:light_slate_gray =>         ColorRGB.new( [0.46666, 0.53333, 0.60000] ),
+			:light_steel_blue =>         ColorRGB.new( [0.69019, 0.76862, 0.87058] ),
+			:light_yellow =>             ColorRGB.new( [1.00000, 1.00000, 0.87843] ),
+			:lime =>                     ColorRGB.new( [0.00000, 1.00000, 0.00000] ),
+			:lime_green =>               ColorRGB.new( [0.19607, 0.80392, 0.19607] ),
+			:linen =>                    ColorRGB.new( [0.98039, 0.94117, 0.90196] ),
+			:magenta =>                  ColorRGB.new( [1.00000, 0.00000, 1.00000] ),
+			:maroon =>                   ColorRGB.new( [0.50196, 0.00000, 0.00000] ),
+			:medium_aquamarine =>        ColorRGB.new( [0.40000, 0.80392, 0.66666] ),
+			:medium_blue =>              ColorRGB.new( [0.00000, 0.00000, 0.80392] ),
+			:medium_orchid =>            ColorRGB.new( [0.72941, 0.33333, 0.82745] ),
+			:medium_purple =>            ColorRGB.new( [0.57647, 0.43921, 0.85882] ),
+			:medium_sea_green =>         ColorRGB.new( [0.23529, 0.70196, 0.44313] ),
+			:medium_slate_blue =>        ColorRGB.new( [0.48235, 0.40784, 0.93333] ),
+			:medium_spring_green =>      ColorRGB.new( [0.00000, 0.98039, 0.60392] ),
+			:medium_turquoise =>         ColorRGB.new( [0.28235, 0.81960, 0.80000] ),
+			:medium_violet_red =>        ColorRGB.new( [0.78039, 0.08235, 0.52156] ),
+			:midnight_blue =>            ColorRGB.new( [0.09803, 0.09803, 0.43921] ),
+			:mint_cream =>               ColorRGB.new( [0.96078, 1.00000, 0.98039] ),
+			:misty_rose =>               ColorRGB.new( [1.00000, 0.89411, 0.88235] ),
+			:moccasin =>                 ColorRGB.new( [1.00000, 0.89411, 0.70980] ),
+			:navajo_white =>             ColorRGB.new( [1.00000, 0.87058, 0.67843] ),
+			:navy =>                     ColorRGB.new( [0.00000, 0.00000, 0.50196] ),
+			:old_lace =>                 ColorRGB.new( [0.99215, 0.96078, 0.90196] ),
+			:olive =>                    ColorRGB.new( [0.50196, 0.50196, 0.00000] ),
+			:olive_drab =>               ColorRGB.new( [0.41960, 0.55686, 0.13725] ),
+			:orange =>                   ColorRGB.new( [1.00000, 0.64705, 0.00000] ),
+			:orange_red =>               ColorRGB.new( [1.00000, 0.27058, 0.00000] ),
+			:orchid =>                   ColorRGB.new( [0.85490, 0.43921, 0.83921] ),
+			:pale_goldenrod =>           ColorRGB.new( [0.93333, 0.90980, 0.66666] ),
+			:pale_green =>               ColorRGB.new( [0.59607, 0.98431, 0.59607] ),
+			:pale_turquoise =>           ColorRGB.new( [0.68627, 0.93333, 0.93333] ),
+			:pale_violet_red =>          ColorRGB.new( [0.85882, 0.43921, 0.57647] ),
+			:papaya_whip =>              ColorRGB.new( [1.00000, 0.93725, 0.83529] ),
+			:peach_puff =>               ColorRGB.new( [1.00000, 0.85490, 0.72549] ),
+			:peru =>                     ColorRGB.new( [0.80392, 0.52156, 0.24705] ),
+			:pink =>                     ColorRGB.new( [1.00000, 0.75294, 0.79607] ),
+			:plum =>                     ColorRGB.new( [0.86666, 0.62745, 0.86666] ),
+			:powder_blue =>              ColorRGB.new( [0.69019, 0.87843, 0.90196] ),
+			:purple =>                   ColorRGB.new( [0.50196, 0.00000, 0.50196] ),
+			:red =>                      ColorRGB.new( [1.00000, 0.00000, 0.00000] ),
+			:rosy_brown =>               ColorRGB.new( [0.73725, 0.56078, 0.56078] ),
+			:royal_blue =>               ColorRGB.new( [0.25490, 0.41176, 0.88235] ),
+			:saddle_brown =>             ColorRGB.new( [0.54509, 0.27058, 0.07450] ),
+			:salmon =>                   ColorRGB.new( [0.98039, 0.50196, 0.44705] ),
+			:sandy_brown =>              ColorRGB.new( [0.95686, 0.64313, 0.37647] ),
+			:sea_green =>                ColorRGB.new( [0.18039, 0.54509, 0.34117] ),
+			:seashell =>                 ColorRGB.new( [1.00000, 0.96078, 0.93333] ),
+			:sienna =>                   ColorRGB.new( [0.62745, 0.32156, 0.17647] ),
+			:silver =>                   ColorRGB.new( [0.75294, 0.75294, 0.75294] ),
+			:sky_blue =>                 ColorRGB.new( [0.52941, 0.80784, 0.92156] ),
+			:slate_blue =>               ColorRGB.new( [0.41568, 0.35294, 0.80392] ),
+			:slate_gray =>               ColorRGB.new( [0.43921, 0.50196, 0.56470] ),
+			:snow =>                     ColorRGB.new( [1.00000, 0.98039, 0.98039] ),
+			:spring_green =>             ColorRGB.new( [0.00000, 1.00000, 0.49803] ),
+			:steel_blue =>               ColorRGB.new( [0.27450, 0.50980, 0.70588] ),
+			:tan =>                      ColorRGB.new( [0.82352, 0.70588, 0.54901] ),
+			:teal =>                     ColorRGB.new( [0.00000, 0.50196, 0.50196] ),
+			:thistle =>                  ColorRGB.new( [0.84705, 0.74901, 0.84705] ),
+			:tomato =>                   ColorRGB.new( [1.00000, 0.38823, 0.27843] ),
+			:turquoise =>                ColorRGB.new( [0.25098, 0.87843, 0.81568] ),
+			:violet =>                   ColorRGB.new( [0.93333, 0.50980, 0.93333] ),
+			:wheat =>                    ColorRGB.new( [0.96078, 0.87058, 0.70196] ),
+			:white =>                    ColorRGB.new( [1.00000, 1.00000, 1.00000] ),
+			:white_smoke =>              ColorRGB.new( [0.96078, 0.96078, 0.96078] ),
+			:yellow =>                   ColorRGB.new( [1.00000, 1.00000, 0.00000] ),
+			:yellow_green =>             ColorRGB.new( [0.60392, 0.80392, 0.19607] )
+		})
+	end
+end

data/lib/rubygame/color.rb

@@ -0,0 +1,79 @@
+#--
+#	Rubygame -- Ruby code and bindings to SDL to facilitate game creation
+#	Copyright (C) 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
+#++
+
+require 'rubygame/color/models/base'
+require 'rubygame/color/models/rgb'
+require 'rubygame/color/models/hsv'
+require 'rubygame/color/models/hsl'
+
+require 'rubygame/color/palettes/palette'
+require 'rubygame/color/palettes/x11'
+require 'rubygame/color/palettes/css'
+
+module Rubygame
+
+	# The Color module contains classes related to colors.
+	# 
+	# Available color representations:
+	# 
+	# ColorRGB::  color class with red, green, and blue components.
+	# ColorHSV::  color class with hue, saturation, and value components.
+	# ColorHSL::  color class with hue, saturation, and luminosity components.
+	# 
+	# The Palette class allows you to conveniently store and access a
+	# collection of many different colors, with inheritance from
+	# included Palettes.
+	# 
+	# The available predefined palettes are:
+	# 
+	# X11::    palette with the default X11 colors
+	# CSS::    palette used with HTML and CSS, very similar to X11
+	# GLOBAL:: special palette used for automatic lookup (see below)
+	# 
+	# The GLOBAL palette is special; it is used for automatic color lookup
+	# in functions like Surface#draw_circle and TTF#render.It includes the
+	# CSS palette by default; you can include other palettes or define new
+	# custom colors in GLOBAL to make them available for automatic lookup.
+	# 
+	# For convenience, you can access the GLOBAL palette through the
+	# #[] and #[]= methods:
+	# 
+	#     include Rubygame
+	#     player_color = Color[:red]
+	#     Color[:favorite] = Color[:azure]
+	# 
+	module Color
+
+		(GLOBAL = Palette.new()).include(CSS) # :nodoc:
+		
+		# Retrieve a color from the GLOBAL palette.
+		# See Palette#[]
+		def self.[]( name )
+			GLOBAL[name]
+		end
+		
+		# Store a color in the GLOBAL palette.
+		# See Palette#[]=
+		def self.[]=( name, color )
+			GLOBAL[name] = color
+		end
+		
+	end
+end
+

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