gosu 0.7.43 → 0.7.44

data/Gosu/Text.hpp

@@ -53,14 +53,14 @@ namespace Gosu
     //! \param fontHeight Height of the font in pixels.
     //! \param lineSpacing Spacing between two lines of text in pixels. Can be negative to make
     //! text stick together more closely.
-    //! \param maxWidth Width of the bitmap that will be returned. Text
+    //! \param width Width of the bitmap that will be returned. Text
     //! will be split into multiple lines to avoid drawing over the right
     //! border. When a single word is too long, it will be truncated.
     //! \param fontFlags Binary combination of members of the FontFlags
     //! enum.
     Bitmap createText(const std::wstring& text,
         const std::wstring& fontName, unsigned fontHeight, 
-        int lineSpacing, unsigned maxWidth, TextAlign align,
+        int lineSpacing, unsigned width, TextAlign align,
         unsigned fontFlags = 0);
     
     //! Registers a new HTML-style entity that can subsequently be used

data/Gosu/Version.hpp

@@ -3,8 +3,8 @@
 
 #define GOSU_MAJOR_VERSION 0
 #define GOSU_MINOR_VERSION 7
-#define GOSU_POINT_VERSION 43
-#define GOSU_VERSION "0.7.43"
+#define GOSU_POINT_VERSION 44
+#define GOSU_VERSION "0.7.44"
 
 #define GOSU_COPYRIGHT_NOTICE \
   " " \

data/GosuImpl/Audio/ALChannelManagement.hpp

@@ -21,7 +21,12 @@ namespace Gosu
         static ALCdevice* alDevice;
         static ALCcontext* alContext;
 
-        enum { NUM_SOURCES = 32 }; // This is what the iPhone supports, I hear.
+	#ifdef GOSU_IS_IPHONE
+        // iOS system limit (possibly not for newer devices)
+        enum { NUM_SOURCES = 32 };
+	#else
+        enum { NUM_SOURCES = 255 };
+	#endif
         static ALuint alSources[NUM_SOURCES];
         static ALuint currentToken;
         static ALuint currentTokens[NUM_SOURCES];
@@ -91,4 +96,9 @@ namespace Gosu
     ALuint ALChannelManagement::currentTokens[NUM_SOURCES];
 
     std::auto_ptr<ALChannelManagement> alChannelManagement;
+    
+    void releaseAllOpenALResources()
+    {
+        alChannelManagement.reset();
+    }
 }

data/GosuImpl/Graphics/BitmapApple.mm

@@ -96,6 +96,7 @@ namespace Gosu { bool isExtension(const wchar_t* str, const wchar_t* ext); }
 
 void Gosu::loadImageFile(Bitmap& bitmap, const std::wstring& filename)
 {
+    ObjRef<NSAutoreleasePool> pool([NSAutoreleasePool new]);
     ObjRef<NSString> filenameRef([[NSString alloc] initWithUTF8String: wstringToUTF8(filename).c_str()]);
     ObjRef<APPLE_IMAGE> image([[APPLE_IMAGE alloc] initWithContentsOfFile: filenameRef.obj()]);
     if (!image.get())

data/GosuImpl/Graphics/Common.hpp

@@ -48,8 +48,6 @@ namespace Gosu
     };
 }
 
-#include <GosuImpl/Graphics/RenderState.hpp>
-
 namespace Gosu
 {
     class Texture;
@@ -66,12 +64,6 @@ namespace Gosu
         GLuint color;
         GLfloat vertices[3];
     };
-    struct VertexArray
-    {
-        RenderState renderState;
-        std::vector<ArrayVertex> vertices;
-    };
-    typedef std::list<VertexArray> VertexArrays;
     
     template<typename T>
     bool isPToTheLeftOfAB(T xa, T ya,

data/GosuImpl/Graphics/DrawOp.hpp

@@ -4,6 +4,7 @@
 #include <Gosu/GraphicsBase.hpp>
 #include <Gosu/Color.hpp>
 #include <GosuImpl/Graphics/Common.hpp>
+#include <GosuImpl/Graphics/RenderState.hpp>
 #include <GosuImpl/Graphics/TexChunk.hpp>
 #include <cassert>
 
@@ -63,7 +64,7 @@ namespace Gosu
             #endif
             
             #ifdef GOSU_IS_IPHONE
-            if (renderState.texName != NO_TEXTURE)
+            if (renderState.texture)
             {
                 spriteTexcoords[spriteCounter*12 + 0] = left;
                 spriteTexcoords[spriteCounter*12 + 1] = top;
@@ -92,7 +93,7 @@ namespace Gosu
             for (unsigned i = 0; i < verticesOrBlockIndex; i++)
             {
                 glColor4ubv(reinterpret_cast<const GLubyte*>(&vertices[i].c));
-                if (renderState.texName != NO_TEXTURE)
+                if (renderState.texture)
                     switch (i)
                     {
                     case 0:

data/GosuImpl/Graphics/Macro.hpp

@@ -111,7 +111,7 @@ class Gosu::Macro : public Gosu::ImageData
         // 0, 0, 0, 0, 0, 0, leftCell7, rightCell7 | origRightSide7
         // 0, 0, 0, 0, 0, 0,         0,   remCell8 | rightSide8
         
-        // Use the remainding value in row 8 to eliminate the right value in row 7.
+        // Use the remaining value in row 8 to eliminate the right value in row 7.
         // Row7 = Row7 - factor87 * Row8
         Float factor87 = rightCell7 / remCell8;
         Float remCell7 = leftCell7;
@@ -165,7 +165,7 @@ class Gosu::Macro : public Gosu::ImageData
     
     void drawVertexArrays(Float x1, Float y1, Float x2, Float y2, Float x3, Float y3, Float x4, Float y4) const
     {
-        // TODO: Macros should not be split up because they have different transforms! This is insane.
+        // TODO: Macros should not be split up just because they have different transforms! This is insane.
         // They should be premultiplied and have the same transform by definition. Then, the transformation
         // only had to be performed here once.
         

data/GosuImpl/Graphics/RenderState.hpp

@@ -2,37 +2,38 @@
 #define GOSUIMPL_GRAPHICS_RENDERSTATE_HPP
 
 #include <GosuImpl/Graphics/Common.hpp>
+#include <GosuImpl/Graphics/Texture.hpp>
 
 // Properties that potentially need to be changed between each draw operation.
 // This does not include the color or vertex data of the actual quads.
 struct Gosu::RenderState
 {
-    GLuint texName;
+    std::tr1::shared_ptr<Texture> texture;
     const Transform* transform;
     ClipRect clipRect;
     AlphaMode mode;
     
     RenderState()
-    : texName(NO_TEXTURE), transform(0), mode(amDefault)
+    : transform(0), mode(amDefault)
     {
         clipRect.width = NO_CLIPPING;
     }
     
     bool operator==(const RenderState& rhs) const
     {
-        return texName == rhs.texName && transform == rhs.transform &&
+        return texture == rhs.texture && transform == rhs.transform &&
             clipRect == rhs.clipRect && mode == rhs.mode;
     }
     
     void applyTexture() const
     {
-        if (texName == NO_TEXTURE)
-            glDisable(GL_TEXTURE_2D);
-        else
+        if (texture)
         {
             glEnable(GL_TEXTURE_2D);
-            glBindTexture(GL_TEXTURE_2D, texName);
+            glBindTexture(GL_TEXTURE_2D, texture->texName());
         }
+        else
+            glDisable(GL_TEXTURE_2D);
     }
     
     void applyAlphaMode() const
@@ -105,7 +106,7 @@ public:
         ClipRect noClipping;
         noClipping.width = NO_CLIPPING;
         setClipRect(noClipping);
-        setTexName(NO_TEXTURE);
+        setTexture(std::tr1::shared_ptr<Texture>());
         // Return to previous MV matrix
         glMatrixMode(GL_MODELVIEW);
         glPopMatrix();
@@ -113,29 +114,29 @@ public:
     
     void setRenderState(const RenderState& rs)
     {
-        setTexName(rs.texName);
+        setTexture(rs.texture);
         setTransform(rs.transform);
         setClipRect(rs.clipRect);
         setAlphaMode(rs.mode);
     }
     
-    void setTexName(GLuint newTexName)
+    void setTexture(std::tr1::shared_ptr<Texture> newTexture)
     {
-        if (newTexName == texName)
+        if (newTexture == texture)
             return;
     
-        if (newTexName != NO_TEXTURE)
+        if (newTexture)
         {
             // New texture *is* really a texture - change to it.
             
-            if (texName == NO_TEXTURE)
+            if (!texture)
                 glEnable(GL_TEXTURE_2D);
-            glBindTexture(GL_TEXTURE_2D, newTexName);
+            glBindTexture(GL_TEXTURE_2D, newTexture->texName());
         }
         else
             // New texture is NO_TEXTURE, disable texturing.
             glDisable(GL_TEXTURE_2D);
-        texName = newTexName;
+        texture = newTexture;
     }
     
     void setTransform(const Transform* newTransform)
@@ -195,5 +196,15 @@ public:
         applyAlphaMode();
     }
 };
+
+namespace Gosu
+{
+    struct VertexArray
+    {
+        RenderState renderState;
+        std::vector<ArrayVertex> vertices;
+    };
+    typedef std::list<VertexArray> VertexArrays;    
+}
     
 #endif

data/GosuImpl/Graphics/TexChunk.cpp

@@ -28,7 +28,7 @@ void Gosu::TexChunk::draw(double x1, double y1, Color c1,
     ZPos z, AlphaMode mode) const
 {
     DrawOp op;
-    op.renderState.texName = texName();
+    op.renderState.texture = texture;
     op.renderState.mode = mode;
     
     reorderCoordinatesIfNecessary(x1, y1, x2, y2, x3, y3, c3, x4, y4, c4);

data/GosuImpl/Graphics/Text.cpp

@@ -301,18 +301,18 @@ namespace Gosu
 
 Gosu::Bitmap Gosu::createText(const wstring& text,
     const wstring& fontName, unsigned fontHeight, int lineSpacing,
-    unsigned maxWidth, TextAlign align, unsigned fontFlags)
+    unsigned width, TextAlign align, unsigned fontFlags)
 {
     if (lineSpacing <= -static_cast<int>(fontHeight))
         throw logic_error("negative line spacing of more than line height impossible");
 
     FormattedString fs(text.c_str(), fontFlags);
     if (fs.length() == 0)
-        return Bitmap(maxWidth, fontHeight);
+        return Bitmap(width, fontHeight);
     
     // Set up the builder object which will manage all the drawing and
     // conversions for us.
-    TextBlockBuilder builder(fontName, fontHeight, lineSpacing, maxWidth, align);
+    TextBlockBuilder builder(fontName, fontHeight, lineSpacing, width, align);
     
     // Let the process* functions draw everything.
     processText(builder, fs);

data/GosuImpl/RubyGosu.swg

@@ -182,6 +182,7 @@
 
 namespace Gosu {
     void enableUndocumentedRetrofication() { extern bool undocumentedRetrofication; undocumentedRetrofication = true; }
+    void releaseAllOpenALResources();
     void register_entity(const std::wstring& name, Gosu::Image* image) { registerEntity(name, image->getData().toBitmap()); }
 }
 
@@ -364,9 +365,12 @@ namespace Gosu
 
 %constant unsigned MAX_TEXTURE_SIZE = Gosu::MAX_TEXTURE_SIZE;
 
+%rename("_release_all_openal_resources") releaseAllOpenALResources;
+
 namespace Gosu {
     std::string language();
     void enableUndocumentedRetrofication();
+    void releaseAllOpenALResources();
     void register_entity(const std::wstring& name, Gosu::Image* image);
 }
 
@@ -552,9 +556,9 @@ namespace Gosu {
     %newobject fromText7;
     static Gosu::Image* fromText7(Gosu::Window& window, const std::wstring& text,
             const std::wstring& fontName, unsigned fontHeight,
-            int lineSpacing, unsigned maxWidth, TextAlign align)
+            int lineSpacing, unsigned width, TextAlign align)
     {
-        Gosu::Bitmap bmp = Gosu::createText(text, fontName, fontHeight, lineSpacing, maxWidth, align);
+        Gosu::Bitmap bmp = Gosu::createText(text, fontName, fontHeight, lineSpacing, width, align);
         return new Gosu::Image(window.graphics(), bmp);
     }
     static std::vector<Gosu::Image*> loadTiles(Gosu::Window& window,

data/GosuImpl/RubyGosu_wrap.cxx

@@ -1,6 +1,6 @@
 /* ----------------------------------------------------------------------------
  * This file was automatically generated by SWIG (http://www.swig.org).
- * Version 2.0.4
+ * Version 2.0.7
  * 
  * This file is not intended to be easily readable and contains a number of 
  * coding conventions designed to improve portability and efficiency. Do not make
@@ -2191,7 +2191,7 @@ static VALUE mGosu;
 #define SWIG_RUBY_THREAD_END_BLOCK
 
 
-#define SWIGVERSION 0x020004 
+#define SWIGVERSION 0x020007 
 #define SWIG_VERSION SWIGVERSION
 
 
@@ -2232,6 +2232,7 @@ static VALUE mGosu;
 
 namespace Gosu {
     void enableUndocumentedRetrofication() { extern bool undocumentedRetrofication; undocumentedRetrofication = true; }
+    void releaseAllOpenALResources();
     void register_entity(const std::wstring& name, Gosu::Image* image) { registerEntity(name, image->getData().toBitmap()); }
 }
 
@@ -2431,7 +2432,7 @@ SWIG_ruby_failed(void)
 } 
 
 
-/*@SWIG:/usr/local/Cellar/swig/2.0.4/share/swig/2.0.4/ruby/rubyprimtypes.swg,19,%ruby_aux_method@*/
+/*@SWIG:/usr/local/Cellar/swig/2.0.7/share/swig/2.0.7/ruby/rubyprimtypes.swg,19,%ruby_aux_method@*/
 SWIGINTERN VALUE SWIG_AUX_NUM2DBL(VALUE *args)
 {
   VALUE obj = args[0];
@@ -2473,7 +2474,7 @@ SWIG_From_unsigned_SS_int  (unsigned int value)
 #include <string>
 
 
-/*@SWIG:/usr/local/Cellar/swig/2.0.4/share/swig/2.0.4/ruby/rubyprimtypes.swg,19,%ruby_aux_method@*/
+/*@SWIG:/usr/local/Cellar/swig/2.0.7/share/swig/2.0.7/ruby/rubyprimtypes.swg,19,%ruby_aux_method@*/
 SWIGINTERN VALUE SWIG_AUX_NUM2ULONG(VALUE *args)
 {
   VALUE obj = args[0];
@@ -2573,7 +2574,7 @@ SWIG_From_bool  (bool value)
 }
 
 
-/*@SWIG:/usr/local/Cellar/swig/2.0.4/share/swig/2.0.4/ruby/rubyprimtypes.swg,19,%ruby_aux_method@*/
+/*@SWIG:/usr/local/Cellar/swig/2.0.7/share/swig/2.0.7/ruby/rubyprimtypes.swg,19,%ruby_aux_method@*/
 SWIGINTERN VALUE SWIG_AUX_NUM2LONG(VALUE *args)
 {
   VALUE obj = args[0];
@@ -2699,8 +2700,8 @@ SWIGINTERN Gosu::Image *Gosu_Image_fromText4(Gosu::Window &window,std::wstring c
         Gosu::Bitmap bmp = Gosu::createText(text, fontName, fontHeight);
         return new Gosu::Image(window.graphics(), bmp);
     }
-SWIGINTERN Gosu::Image *Gosu_Image_fromText7(Gosu::Window &window,std::wstring const &text,std::wstring const &fontName,unsigned int fontHeight,int lineSpacing,unsigned int maxWidth,Gosu::TextAlign align){
-        Gosu::Bitmap bmp = Gosu::createText(text, fontName, fontHeight, lineSpacing, maxWidth, align);
+SWIGINTERN Gosu::Image *Gosu_Image_fromText7(Gosu::Window &window,std::wstring const &text,std::wstring const &fontName,unsigned int fontHeight,int lineSpacing,unsigned int width,Gosu::TextAlign align){
+        Gosu::Bitmap bmp = Gosu::createText(text, fontName, fontHeight, lineSpacing, width, align);
         return new Gosu::Image(window.graphics(), bmp);
     }
 SWIGINTERN std::vector< Gosu::Image * > Gosu_Image_loadTiles(Gosu::Window &window,VALUE source,int tileWidth,int tileHeight,bool tileable){
@@ -3723,6 +3724,24 @@ fail:
 }
 
 
+SWIGINTERN VALUE
+_wrap__release_all_openal_resources(int argc, VALUE *argv, VALUE self) {
+  if ((argc < 0) || (argc > 0)) {
+    rb_raise(rb_eArgError, "wrong # of arguments(%d for 0)",argc); SWIG_fail;
+  }
+  {
+    try {
+      Gosu::releaseAllOpenALResources();
+    } catch (const std::exception& e) {
+      SWIG_exception(SWIG_RuntimeError, e.what());
+    }
+  }
+  return Qnil;
+fail:
+  return Qnil;
+}
+
+
 SWIGINTERN VALUE
 _wrap_register_entity(int argc, VALUE *argv, VALUE self) {
   std::wstring *arg1 = 0 ;
@@ -3757,7 +3776,7 @@ fail:
 }
 
 
-swig_class SwigClassColor;
+static swig_class SwigClassColor;
 
 SWIGINTERN VALUE
 _wrap_new_Color__SWIG_0(int argc, VALUE *argv, VALUE self) {
@@ -5258,7 +5277,7 @@ _wrap_cyan_get(VALUE self) {
 }
 
 
-swig_class SwigClassFont;
+static swig_class SwigClassFont;
 
 SWIGINTERN VALUE
 _wrap_Font_name(int argc, VALUE *argv, VALUE self) {
@@ -5882,7 +5901,7 @@ free_Gosu_Font(Gosu::Font *arg1) {
     delete arg1;
 }
 
-swig_class SwigClassGLTexInfo;
+static swig_class SwigClassGLTexInfo;
 
 SWIGINTERN VALUE
 _wrap_GLTexInfo_tex_name_set(int argc, VALUE *argv, VALUE self) {
@@ -6195,7 +6214,7 @@ free_Gosu_GLTexInfo(Gosu::GLTexInfo *arg1) {
     delete arg1;
 }
 
-swig_class SwigClassImage;
+static swig_class SwigClassImage;
 
 SWIGINTERN VALUE
 _wrap_Image_width(int argc, VALUE *argv, VALUE self) {
@@ -7529,7 +7548,7 @@ fail:
 }
 
 
-swig_class SwigClassSampleInstance;
+static swig_class SwigClassSampleInstance;
 
 #ifdef HAVE_RB_DEFINE_ALLOC_FUNC
 SWIGINTERN VALUE
@@ -7839,7 +7858,7 @@ free_Gosu_SampleInstance(Gosu::SampleInstance *arg1) {
     delete arg1;
 }
 
-swig_class SwigClassSample;
+static swig_class SwigClassSample;
 
 #ifdef HAVE_RB_DEFINE_ALLOC_FUNC
 SWIGINTERN VALUE
@@ -8022,7 +8041,7 @@ free_Gosu_Sample(Gosu::Sample *arg1) {
     delete arg1;
 }
 
-swig_class SwigClassSong;
+static swig_class SwigClassSong;
 
 #ifdef HAVE_RB_DEFINE_ALLOC_FUNC
 SWIGINTERN VALUE
@@ -8333,7 +8352,7 @@ fail:
 }
 
 
-swig_class SwigClassTextInput;
+static swig_class SwigClassTextInput;
 
 #ifdef HAVE_RB_DEFINE_ALLOC_FUNC
 SWIGINTERN VALUE
@@ -8664,7 +8683,7 @@ fail:
 }
 
 
-swig_class SwigClassWindow;
+static swig_class SwigClassWindow;
 
 #ifdef HAVE_RB_DEFINE_ALLOC_FUNC
 SWIGINTERN VALUE
@@ -11228,8 +11247,8 @@ SWIGEXPORT void Init_gosu(void) {
   SWIG_RubyInitializeTrackings();
   rb_define_const(mGosu, "MAJOR_VERSION", SWIG_From_int(static_cast< int >(0)));
   rb_define_const(mGosu, "MINOR_VERSION", SWIG_From_int(static_cast< int >(7)));
-  rb_define_const(mGosu, "POINT_VERSION", SWIG_From_int(static_cast< int >(43)));
-  rb_define_const(mGosu, "VERSION", SWIG_FromCharPtr("0.7.43"));
+  rb_define_const(mGosu, "POINT_VERSION", SWIG_From_int(static_cast< int >(44)));
+  rb_define_const(mGosu, "VERSION", SWIG_FromCharPtr("0.7.44"));
   rb_define_module_function(mGosu, "milliseconds", VALUEFUNC(_wrap_milliseconds), -1);
   rb_define_module_function(mGosu, "random", VALUEFUNC(_wrap_random), -1);
   rb_define_module_function(mGosu, "degrees_to_radians", VALUEFUNC(_wrap_degrees_to_radians), -1);
@@ -11249,6 +11268,7 @@ SWIGEXPORT void Init_gosu(void) {
   rb_define_const(mGosu, "MAX_TEXTURE_SIZE", SWIG_From_unsigned_SS_int(static_cast< unsigned int >(Gosu::MAX_TEXTURE_SIZE)));
   rb_define_module_function(mGosu, "language", VALUEFUNC(_wrap_language), -1);
   rb_define_module_function(mGosu, "enable_undocumented_retrofication", VALUEFUNC(_wrap_enable_undocumented_retrofication), -1);
+  rb_define_module_function(mGosu, "_release_all_openal_resources", VALUEFUNC(_wrap__release_all_openal_resources), -1);
   rb_define_module_function(mGosu, "register_entity", VALUEFUNC(_wrap_register_entity), -1);
   
   SwigClassColor.klass = rb_define_class_under(mGosu, "Color", rb_cObject);

data/GosuImpl/RubyGosu_wrap.h

@@ -1,6 +1,6 @@
 /* ----------------------------------------------------------------------------
  * This file was automatically generated by SWIG (http://www.swig.org).
- * Version 2.0.4
+ * Version 2.0.7
  * 
  * This file is not intended to be easily readable and contains a number of 
  * coding conventions designed to improve portability and efficiency. Do not make

data/GosuImpl/Sockets/Sockets.hpp

@@ -9,6 +9,7 @@
     namespace Gosu { typedef SOCKET SocketHandle; }
     typedef int socklen_t;
 #else
+    #include <unistd.h>
     #include <sys/errno.h>
     #include <sys/socket.h>
     #include <netinet/in.h>

data/GosuImpl/TimingUnix.cpp

@@ -9,10 +9,16 @@ void Gosu::sleep(unsigned milliseconds)
 
 unsigned long Gosu::milliseconds()
 {
+		static unsigned long start = 0;
+
     timeval tp;
     gettimeofday(&tp, NULL);
+
+		if (!start)
+			start = tp.tv_usec / 1000UL + tp.tv_sec * 1000UL;
+		
     // Truncate to 2^30, C++ users shouldn't mind and Ruby users will
     // have a happy GC on 32-bit systems.
     // No, don't ask why this is an unsigned long then :)
-    return (tp.tv_usec / 1000UL + tp.tv_sec * 1000UL) & 0x1fffffff;
+    return (tp.tv_usec / 1000UL + tp.tv_sec * 1000UL - start) & 0x1fffffff;
 }

data/GosuImpl/TimingWin.cpp

@@ -17,15 +17,16 @@ namespace
 
 unsigned long Gosu::milliseconds()
 {
-    static bool init = false;
-    if (!init)
+		static unsigned long start = 0;
+
+    if (!start)
     {
         if (::timeBeginPeriod(1) != TIMERR_NOERROR)
             std::atexit(resetTGT);
-        init = true;
+				start = ::timeGetTime();
     }
     // Truncate to 2^30, C++ users shouldn't mind and Ruby users will
     // have a happy GC on 32-bit systems.
     // No, don't ask why this is an unsigned long then :)
-    return ::timeGetTime() & 0x1fffffff;
+    return (::timeGetTime() - start) & 0x1fffffff;
 }

data/lib/gosu/patches.rb

@@ -72,4 +72,7 @@ class Gosu::Window
   def char_to_button_id(ch)
     self.class.char_to_button_id(ch)
   end
-end
+end
+
+# Release OpenAL resources during Ruby's shutdown, not Gosu's.
+at_exit { Gosu::_release_all_openal_resources }

data/linux/extconf.rb

@@ -93,7 +93,6 @@ else
   pkg_config("vorbisfile")
   pkg_config("openal")
   pkg_config("sndfile")
-  pkg_config("xinerama")
   
   have_header('SDL_ttf.h')   if have_library('SDL_ttf', 'TTF_RenderUTF8_Blended')
   have_header('FreeImage.h') if have_library('freeimage', 'FreeImage_ConvertFromRawBits')

data/reference/Drawing_with_Colors.rdoc

@@ -0,0 +1,5 @@
+= Drawing with Colors
+
+Almost all image drawing functions accept modulation colors. The colors of all pixels on the source image will be multiplied with these colors, where a channel value of 255 corresponds to the maximum value of 1.0. This means modulation colors can be used only to reduce particular channels of an image.
+
+The most obvious use of this is to supply a color with an alpha value less than 255 so the image will drawn transparently, but you can also use this to darken images or to draw them in a different hue (which works best if the original image is mostly grayscale).

data/reference/Order_of_Corners.rdoc

@@ -0,0 +1,5 @@
+= Order of Corners
+
+In all functions that expect arguments for all four corners of a rectangle or quadrilateral, you can either pass clockwise coordinates, or coordinates in the following order (a Z shape):
+
+http://www.libgosu.org/wiki_images/corner_indices.png

data/reference/Tileability.rdoc

@@ -0,0 +1,11 @@
+= Tileability
+
+Functions related to image creation accept a boolean "tileable" argument. This is a consequence of using 3D hardware acceleration. Try to notice the subtle difference between these two, overstretched images:
+
+http://www.libgosu.org/wiki_images/hard_borders.png
+
+When you draw an image with stretching factors other than 1.0 (10.0 in this case) or at odd coordinates, it will become interpolated—which, in general, is much better than getting all pixel-y.
+
+But take a look at the image's borders. The image of the left girl was created with tileable set to 'false' (the default) and the borders fade out. The image of the right girl, which was created with tileable set to 'true, does not fade out at all, but just ends on its borders.
+
+While most images should not be tileable, you should always pass true for map tiles.

data/reference/Z_Ordering.rdoc

@@ -0,0 +1,5 @@
+= Z-Ordering
+
+All drawing operations in Gosu accept a floating-point value called "z" (technically, a double). Things drawn with a higher z position will be drawn over those with a lower one. If two things have the same z position, they will be drawn in the order the drawing functions were called.
+
+If you do not wish to use z ordering, just pass the same constant all the time.

data/reference/gosu.rb

@@ -0,0 +1,596 @@
+# Version string of the form "0.1.2" or "0.1.2.3".
+GOSU_VERSION = :a_string
+# First component of the version.
+GOSU_MAJOR_VERSION = :a_fixnum
+# Second component of the version.
+GOSU_MINOR_VERSION = :a_fixnum
+# Third component of the version.
+GOSU_POINT_VERSION = :a_fixnum
+# A long block of legal copy that your game is obliged to display somewhere.
+GOSU_COPYRIGHT_NOTICE = :a_string
+
+module Gosu
+  Kb0 = :implementation_defined
+  Kb1 = :implementation_defined
+  Kb2 = :implementation_defined
+  Kb3 = :implementation_defined
+  Kb4 = :implementation_defined
+  Kb5 = :implementation_defined
+  Kb6 = :implementation_defined
+  Kb7 = :implementation_defined
+  Kb8 = :implementation_defined
+  Kb9 = :implementation_defined
+  KbA = :implementation_defined
+  KbB = :implementation_defined
+  KbC = :implementation_defined
+  KbD = :implementation_defined
+  KbE = :implementation_defined
+  KbF = :implementation_defined
+  KbG = :implementation_defined
+  KbH = :implementation_defined
+  KbI = :implementation_defined
+  KbJ = :implementation_defined
+  KbK = :implementation_defined
+  KbL = :implementation_defined
+  KbM = :implementation_defined
+  KbN = :implementation_defined
+  KbO = :implementation_defined
+  KbP = :implementation_defined
+  KbQ = :implementation_defined
+  KbR = :implementation_defined
+  KbS = :implementation_defined
+  KbT = :implementation_defined
+  KbU = :implementation_defined
+  KbV = :implementation_defined
+  KbW = :implementation_defined
+  KbX = :implementation_defined
+  KbY = :implementation_defined
+  KbZ = :implementation_defined
+  KbBackspace = :implementation_defined
+  KbDelete = :implementation_defined
+  KbDown = :implementation_defined
+  KbEnd = :implementation_defined
+  # On Numpad
+  KbEnter = :implementation_defined
+  KbEscape = :implementation_defined
+  KbF1 = :implementation_defined
+  KbF10 = :implementation_defined
+  KbF11 = :implementation_defined
+  KbF12 = :implementation_defined
+  KbF2 = :implementation_defined
+  KbF3 = :implementation_defined
+  KbF4 = :implementation_defined
+  KbF5 = :implementation_defined
+  KbF6 = :implementation_defined
+  KbF7 = :implementation_defined
+  KbF8 = :implementation_defined
+  KbF9 = :implementation_defined
+  KbHome = :implementation_defined
+  KbInsert = :implementation_defined
+  KbLeft = :implementation_defined
+  KbLeftAlt = :implementation_defined
+  KbLeftControl = :implementation_defined
+  KbLeftShift = :implementation_defined
+  KbNumpad0 = :implementation_defined
+  KbNumpad1 = :implementation_defined
+  KbNumpad2 = :implementation_defined
+  KbNumpad3 = :implementation_defined
+  KbNumpad4 = :implementation_defined
+  KbNumpad5 = :implementation_defined
+  KbNumpad6 = :implementation_defined
+  KbNumpad7 = :implementation_defined
+  KbNumpad8 = :implementation_defined
+  KbNumpad9 = :implementation_defined
+  KbNumpadAdd = :implementation_defined
+  KbNumpadDivide = :implementation_defined
+  KbNumpadMultiply = :implementation_defined
+  KbNumpadSubtract = :implementation_defined
+  KbPageDown = :implementation_defined
+  KbPageUp = :implementation_defined
+  # Above the right shift key
+  KbReturn = :implementation_defined
+  KbRight = :implementation_defined
+  KbRightAlt = :implementation_defined
+  KbRightControl = :implementation_defined
+  KbRightShift = :implementation_defined
+  KbSpace = :implementation_defined
+  KbTab = :implementation_defined
+  KbUp = :implementation_defined
+  MsLeft = :implementation_defined
+  MsMiddle = :implementation_defined
+  MsRight = :implementation_defined
+  MsWheelDown = :implementation_defined
+  MsWheelUp = :implementation_defined
+  GpButton0 = :implementation_defined
+  GpButton1 = :implementation_defined
+  GpButton10 = :implementation_defined
+  GpButton11 = :implementation_defined
+  GpButton12 = :implementation_defined
+  GpButton13 = :implementation_defined
+  GpButton14 = :implementation_defined
+  GpButton15 = :implementation_defined
+  GpButton2 = :implementation_defined
+  GpButton3 = :implementation_defined
+  GpButton4 = :implementation_defined
+  GpButton5 = :implementation_defined
+  GpButton6 = :implementation_defined
+  GpButton7 = :implementation_defined
+  GpButton8 = :implementation_defined
+  GpButton9 = :implementation_defined
+  GpDown = :implementation_defined
+  GpLeft = :implementation_defined
+  GpRight = :implementation_defined
+  GpUp = :implementation_defined
+
+  # Represents an ARGB color value with 8 bits for each channel. Can be
+  # replaced by literals of the form 0xaarrggbb in all of Gosu.
+  class Color
+    attr_accessor :alpha, :red, :green, :blue, :hue, :saturation, :value
+    
+    # a:: Integer from 0..255
+    # r:: Integer from 0..255
+    # g:: Integer from 0..255
+    # b:: Integer from 0..255
+    def initialize(a, r, g, b); end
+    # Initializes a color from an 0xrrggbbaa integer.
+    def initialize(argb); end
+    
+    def dup; end
+    
+    # Same as the constructor, but with an explicit order.
+    def self.rgba(r, g, b, a); end    
+    
+    # Initializes a color from an 0xrrggbbaa integer.
+    def self.rgba(rgba); end    
+    
+    # Same as the constructor, but with an explicit order.
+    def self.argb(a, r, g, b); end    
+    
+    # Initializes a color from an 0xrrggbbaa integer.
+    def self.argb(argb); end    
+    
+    # Converts a HSV triple into a color. Same as from_ahsv with alpha set to 255.
+    # h:: Integer from 0..360
+    # s:: Float from 0..1
+    # v:: Float from 0..1.
+    def self.from_hsv(h, s, v); end
+    
+    # Converts a HSV triple into a color, with a given alpha.
+    # a:: Integer from 0..255
+    # h:: Integer from 0..360
+    # s:: Float from 0..1
+    # v:: Float from 0..1.
+    def self.from_ahsv(a, h, s, v); end
+    
+    # 32-bit unsigned value for use with OpenGL ('RGBA' octet in memory).
+    def gl; end
+    
+    # constant
+    NONE    = Gosu::Color.argb(0x00000000)
+    # constant
+    BLACK   = Gosu::Color.argb(0xff000000)
+    # constant
+    GRAY    = Gosu::Color.argb(0xff808080)
+    # constant
+    WHITE   = Gosu::Color.argb(0xffffffff)            
+    # constant
+    AQUA    = Gosu::Color.argb(0xff00ffff)
+    # constant
+    RED     = Gosu::Color.argb(0xffff0000)
+    # constant
+    GREEN   = Gosu::Color.argb(0xff00ff00)
+    # constant
+    BLUE    = Gosu::Color.argb(0xff0000ff)
+    # constant
+    YELLOW  = Gosu::Color.argb(0xffffff00)
+    # constant
+    FUCHSIA = Gosu::Color.argb(0xffff00ff)
+    # constant
+    CYAN    = Gosu::Color.argb(0xff00ffff)
+  end
+  
+  # A font can be used to draw text on a Window object very flexibly.
+  # Fonts are ideal for small texts that change regularly. For large,
+  # static texts you should use Image#from_text.
+  class Font
+    attr_reader :name, :height
+    
+    # font_name:: Name of a system font, or a filename to a TTF file (must contain '/').
+    # height:: Height of the font, in pixels.
+    def initialize(window, font_name, height); end
+    
+    # Sets the image to be used for a certain character. Must not be called twice for the same character, or after the character has been drawn already.
+    def []=(character, image); end
+    
+    # Draws text so the top left corner of the text is at (x; y).
+    #
+    # Characters are created internally as needed.
+    def draw(text, x, y, z, factor_x=1, factor_y=1, color=0xffffffff, mode=:default); end
+    
+    # Draws text at a position relative to (x; y).
+    # rel_x:: Determines where the text is drawn horizontally. If relX is 0.0, the text will be to the right of x, if it is 1.0, the text will be to the left of x, if it is 0.5, it will be centered on x. Of course, all real numbers are possible values.
+    # rel_y:: See rel_x.
+    def draw_rel(text, x, y, z, rel_x, rel_y, factor_x=1, factor_y=1, color=0xffffffff, mode=:default); end
+    
+    # Returns the width, in pixels, the given text would occupy if drawn.
+    def text_width(text, factor_x=1); end
+    
+    # Analogous to draw, but rotates the text by a given angle.
+    # @deprecated Use a combination of Window#rotate and Font#draw instead.
+    def draw_rot(text, x, y, z, angle, factor_x=1, factor_y=1, color=0xffffffff, mode=:default); end
+  end
+  
+  # Provides functionality for drawing rectangular images.
+  class Image
+    attr_reader :width, :height
+    
+    # Loads an image from a given filename that can be drawn onto the
+    # given window. See the Gosu wiki for a list of supported formats.
+    #
+    # A color key of #ff00ff is automatically applied to BMP type images.
+    def initialize(window, filename_or_rmagick_image, tileable); end
+    
+    # Loads an image from a given filename that can be drawn onto the
+    # given window. See the Gosu wiki for a list of supported formats.
+    #
+    # A color key of #ff00ff is automatically applied to BMP type images.
+    #
+    # This constructor only loads a sub-rectangle of the given file. Because
+    # every call of this constructor will open the image again, it is preferable
+    # to use Image#load_tiles when possible.
+    def initialize(window, filename_or_rmagick_image, tileable, src_x, src_y, src_width, src_height); end
+    
+    # Draws the image so its upper left corner is at (x; y).
+    def draw(x, y, z, factor_x=1, factor_y=1, color=0xffffffff, mode=:default); end
+    
+    # center_x:: Relative horizontal position of the rotation center on the image. 0 is the left border, 1 is the right border, 0.5 is the center (and default)
+    # center_y:: See center_x.
+    def draw_rot(x, y, z, angle, center_x=0.5, center_y=0.5, factor_x=1, factor_y=1, color=0xffffffff, mode=:default); end
+    
+    # Like Window#draw_quad, but with this texture instead of colors. Can be used to implement advanced, non-rectangular drawing techniques and takes four points and the modulation color at each of them.
+    # The points can be in clockwise order, or in a Z shape, starting at the top left.
+    def draw_as_quad(x1, y1, c1, x2, y2, c2, x3, y3, c3, x4, y4, c4, z, mode=:default); end
+    
+    # Creates an Image containing a line of text.
+    #
+    # The text is always rendered in white. If you want to draw it in a
+    # different color, just modulate it by the target color.
+    # font_name:: Name of a system font, or a filename to a TTF file (must contain '/').
+    # font_height:: Height of the font in pixels.
+    def self.from_text(window, text, font_name, font_height); end
+    
+    # Creates an Image that is filled with the text given to the function.
+    #
+    # The text may contain line breaks.
+    #
+    # The text is always rendered in white. If you want to draw it in a
+    # different color, just modulate it by the target color.
+    # font_name:: Name of a system font, or a filename to a TTF file (must contain '/').
+    # font_height:: Height of the font in pixels.
+    # line_spacing:: Spacing between two lines of text in pixels.
+    # max_width:: Width of the bitmap that will be returned. Text will be split into multiple lines to avoid drawing over the right border. When a single word is too long, it will be truncated.
+    # align:: One of :left, :right, :center or :justify.
+    def self.from_text(window, text, font_name, font_height, line_spacing, max_width, align); end
+    
+    # Convenience function that splits an image file into an array of small rectangles and
+    # creates images from these. Returns the Array containing Image instances.
+    #
+    # A color key of #ff00ff is automatically applied to BMP type images.
+    #
+    # tile_width:: If positive, specifies the width of one tile in pixels. If negative, the bitmap is divided into -tile_width rows.
+    # tile_height:: See tile_width.
+    def self.load_tiles(window, filename_or_rmagick_image, tile_width, tile_height, tileable); end
+    
+    # See examples/OpenGLIntegration.rb.
+    def gl_tex_info; end
+    
+    # Returns the associated texture contents as binary string of RGBA values.
+    # Useful for use with RMagick (Magick::Image.from_blob).
+    def to_blob; end
+    
+    # Overwrites all or parts of the Image. x and y can be negative or otherwise out of
+    # bounds, the incoming image data is clipped to the current image size.
+    # This can be used to e.g. overwrite parts of a landscape.
+    def insert(filename_or_rmagick_image, x, y); end
+    
+    # Saves the texture contents as an image file. Useful, for example, to
+    # pre-render text on a development machine with proper fonts installed.
+    # The file format is determined from the file extension. See the Gosu
+    # wiki for a list of portably supported formats.
+    def save(filename); end
+  end
+  
+  # A sample is a short sound that is completely loaded in memory, can be
+  # played multiple times at once and offers very flexible playback
+  # parameters. Use samples for everything that's not music.
+  class Sample
+    def initialize(window, filename); end
+    
+    # Plays the sample without panning.
+    #
+    # Returns a SampleInstance.
+    # volume:: Can be anything from 0.0 (silence) to 1.0 (full volume).
+    # speed:: Playback speed is only limited by the underlying audio library, and can accept very high or low values. Use 1.0 for normal playback speed.
+    def play(vol=1, speed=1, looping=false); end
+    
+    # Plays the sample with panning. Even if pan is 0.0, the sample will
+    # not be as loud as if it were played by calling play() due to the
+    # way the panning works.
+    #
+    # Returns a SampleInstance.
+    # volume:: Can be anything from 0.0 (silence) to 1.0 (full volume).
+    # speed:: Playback speed is only limited by the underlying audio library, and can accept very high or low values. Use 1.0 for normal playback speed.
+    def play_pan(pan=0, vol=1, speed=1, looping=false); end
+  end
+  
+  # An instance of a Sample playing. Can be used to stop sounds dynamically,
+  # or to check if they are finished.
+  # It is recommended that you throw away sample instances if possible,
+  # as they could accidentally refer to other sounds being played after
+  # a very long time has passed.
+  class SampleInstance
+    attr_writer :volume
+    attr_writer :speed
+    attr_writer :pan
+    
+    # Stops this instance of a sound being played. Calling this twice, or too late, does not do any harm. You can nil out the reference to the instance afterwards as it will be useless.
+    def stop; end
+    # Pauses this instance to be resumed afterwards. It will still keep a channel filled while paused.
+    def pause; end
+    def paused?; end
+    def resume; end
+    def playing?; end
+  end
+  
+  # Songs are less flexible than samples in that they can only be played
+  # one at a time and without panning or speed parameters.
+  class Song
+    # Returns the song currently being played or paused, or nil if
+    # no song has been played yet or the last song has finished
+    # playing.
+    def self.current_song; end
+    
+    attr_accessor :volume
+    
+    def initialize(window, filename); end
+    
+    # Starts or resumes playback of the song. This will stop all other
+    # songs and set the current song to this object.
+    def play(looping=false); end
+    
+    # Pauses playback of the song. It is not considered being played.
+    # current_song will stay the same.
+    def pause; end
+    
+    # Returns true if the song is the current song, but in paused
+    # mode.
+    def paused?; end
+    
+    # Stops playback of this song if it is currently played or paused.
+    # Afterwards, current_song will return 0.
+    def stop; end
+    
+    # Returns true if the song is currently playing.
+    def playing?; end
+  end
+  
+  # TextInput instances are invisible objects that build a text string from input,
+  # using the current operating system's keyboard layout.
+  #
+  # At its most basic form, you only need to create a new TextInput instance and
+  # pass it to your window via text_input=. Until you call this function again,
+  # passing nil, the TextInput object will build a text that can be accessed via
+  # TextInput#text.
+  #
+  # A TextInput object is purely abstract, though; drawing the input field is left
+  # to the user. As with most of Gosu, how this is handled is completely left open.
+  #
+  # TextInput only aims to provide enough code for your own GUIs to build upon.
+  class TextInput
+    attr_accessor :text
+    attr_accessor :caret_pos
+    attr_accessor :selection_start
+    
+    # Overridable filter that is applied to all new text that is entered.
+    # Allows for context-sensitive filtering/extending/... of the text.
+    # The text will be inserted at caretPos afterwards.
+    def filter text_in
+      text_in
+    end
+  end
+  
+  # Main class that serves as the foundation of a standard
+  # Gosu application. Manages initialization of all of Gosu's core components
+  # and provides timing functionality.
+  #
+  # Note that all coordinates, even the mouse position, are in client
+  # coordinates relative to the window. This means that the mouse position
+  # can be negative or larger than the window size.
+  #
+  # Note that you should really only use one instance of this class at the same time. This may or may not change later.
+  #
+  # Right now, having two or more windows and loading samples or songs on both of them will result in an exception.
+  class Window
+    attr_accessor :caption
+    attr_accessor :mouse_x
+    attr_accessor :mouse_y
+    attr_accessor :text_input
+    attr_reader :width, :height
+    attr_reader :fullscreen?
+    attr_reader :update_interval
+    
+    # update_interval:: Interval in milliseconds between two calls
+    # to the update member function. The default means the game will run
+    # at 60 FPS, which is ideal on standard 60 Hz TFT screens.
+    def initialize(width, height, fullscreen, update_interval=16.666666); end
+    
+    # Enters a modal loop where the Window is visible on screen and receives calls to draw, update etc.
+    def show; end
+    
+    # Tells the window to end the current show loop as soon as possible.
+    def close; end 
+    
+    # Called every update_interval milliseconds while the window is being
+    # shown. Your application's main game logic goes here.
+    def update; end
+    
+    # Called after every update and when the OS wants the window to
+    # repaint itself. Your application's rendering code goes here.
+    def draw; end
+    
+    # Can be overriden to give the game a chance to say no to being redrawn.
+    # This is not a definitive answer. The operating system can still cause
+    # redraws for one reason or another.
+    #
+    # By default, the window is redrawn all the time (i.e. Window#needs_redraw?
+    # always returns true.)
+    def needs_redraw?; end
+    
+    # Can be overriden to show the system cursor when necessary, e.g. in level
+    # editors or other situations where introducing a custom cursor is not
+    # desired.
+    def needs_cursor?; end
+    
+    # Called before update when the user pressed a button while the
+    # window had the focus.
+    def button_down(id); end
+    # Same as buttonDown. Called then the user released a button.
+    def button_up(id); end
+    
+    # Returns true if a button is currently pressed. Updated every tick.
+    def button_down?(id); end
+    
+    # Draws a line from one point to another (last pixel exclusive).
+    # Note: OpenGL lines are not reliable at all and may have a missing pixel at the start
+    # or end point. Please only use this for debugging purposes. Otherwise, use a quad or
+    # image to simulate lines, or contribute a better draw_line to Gosu.
+    def draw_line(x1, y1, c1, x2, y2, c2, z=0, mode=:default); end
+    
+    def draw_triangle(x1, y1, c1, x2, y2, c2, x3, y3, c3, z=0, mode=:default); end
+    
+    # Draws a rectangle (two triangles) with given corners and corresponding
+    # colors.
+    # The points can be in clockwise order, or in a Z shape.
+    def draw_quad(x1, y1, c1, x2, y2, c2, x3, y3, c3, x4, y4, c4, z=0, mode=:default); end
+    
+    # Flushes all drawing operations to OpenGL so that Z-ordering can start anew. This
+    # is useful when drawing several parts of code on top of each other that use conflicting
+    # z positions.
+    def flush; end
+    
+    # For custom OpenGL calls. Executes the given block in a clean OpenGL environment.
+    # Use the ruby-opengl gem to access OpenGL function (if you manage to get it to work).
+    # IF no z position is given, it will execute the given block immediately, otherwise,
+    # the code will be scheduled to be called between Gosu drawing operations.
+    #
+    # Note: You cannot call Gosu rendering functions within this block, and you can only
+    # call the gl function in the call tree of Window#draw.
+    #
+    # See examples/OpenGLIntegration.rb for an example.
+    def gl(z=nil, &custom_gl_code); end
+    
+    # Limits the drawing area to a given rectangle while evaluating the code inside of the block.
+    def clip_to(x, y, w, h, &rendering_code); end
+    
+    # Returns a Gosu::Image that containes everything rendered within the given block. It can be
+    # used to optimize rendering of many static images, e.g. the map. There are still several
+    # restrictions that you will be informed about via exceptions.
+    #
+    # The returned Gosu::Image will have the width and height you pass as arguments, regardless
+    # of how the area you draw on. It is important to pass accurate values if you plan on using
+    # Gosu::Image#draw_as_quad or Gosu::Image#draw_rot with the result later.
+    #
+    # @return [Gosu::Image]
+    def record(width, height, &rendering_code); end
+    
+    # Rotates everything drawn in the block around (around_x, around_y).
+    def rotate(angle, around_x=0, around_y=0, &rendering_code); end
+    
+    # Scales everything drawn in the block by a factor.
+    def scale(factor_x, factor_y=factor_x, &rendering_code); end
+    
+    # Scales everything drawn in the block by a factor for each dimension.
+    def scale(factor_x, factor_y, around_x, around_y, &rendering_code); end
+    
+    # Moves everything drawn in the block by an offset in each dimension.
+    def translate(x, y, &rendering_code); end
+    
+    # Applies a free-form matrix rotation to everything drawn in the block.
+    def transform(m0, m1, m2, m3, m4, m5, m6, m7, m8, m9, m10, m11, m12, m13, m14, m15, &rendering_code); end
+    
+    # Returns the character a button usually produces, or nil. To implement real text-input
+    # facilities, look at the TextInput class instead.
+    def self.button_id_to_char(id); end
+    
+    # Returns the button that has to be pressed to produce the given character, or nil.
+    def self.char_to_button_id(char); end
+    
+    # @deprecated Use Window#mouse_x= and Window#mouse_y= instead.
+    def set_mouse_position(x, y); end
+  end
+  
+  # Contains information about the underlying OpenGL texture and the u/v space used for image data.
+  #
+  # Can be retrieved from some images to use them in OpenGL operations. nil will be returned instead by images that are too large for a single texture.)
+  #
+  # See examples/OpenGLIntegration.rb.
+  class GLTexInfo
+    attr_reader :tex_name, :left, :right, :top, :bottom
+  end
+  
+  # Returns a random double between min (inclusive) and max (exclusive).
+  def random(min, max); end
+  
+  # Returns the horizontal distance between the origin and the point to which you would get if you moved radius pixels in the direction specified by angle.
+  def offset_x(angle, dist); end 
+  
+  # Returns the vertical distance between the origin and the point to which you would get if you moved radius pixels in the direction specified by angle.
+  def offset_y(angle, dist); end
+  
+  # Returns the angle from point 1 to point 2 in degrees, where 0.0 means upwards. Returns 0 if both points are equal.
+  def angle(x1, y1, x2, y2); end
+  
+  # Returns the smallest angle that can be added to angle1 to get to angle2 (can be negative if counter-clockwise movement is shorter).
+  def angle_diff(angle1, angle2); end
+  
+  # Returns the distance between two points.
+  def distance(x1, y1, x2, y2); end
+  
+  # Incrementing, possibly wrapping millisecond timer.
+  def milliseconds(); end
+  
+  # Returns the name of a neutral font that is available on the current
+  # platform.
+  def default_font_name(); end
+  
+  # Returns the width, in pixels, of the user's primary screen.
+  def screen_width(); end
+  
+  # Returns the height, in pixels, of the user's primary screen.
+  def screen_height(); end
+  
+  # Returns the user's preferred language, at the moment of calling the function. Expect return
+  # values such as 'en_US', 'de_DE.UTF-8', 'ja', 'zh-Hans'. You can rely only on the first two letters
+  # being a common language abbreviation.
+  def language(); end
+end
+
+# Small additions to Numeric to make it easier to integrate Gosu with
+# libraries that use radians, like Chipmunk.
+class ::Numeric
+  # Returns <tt>self * 180.0 / Math::PI + 90</tt>.
+  # Translates between Gosu's angle system (where 0° is at the top) and
+  # radians (where 0 is at the right).
+  def radians_to_gosu(); end
+
+  # Returns <tt>(self - 90) * Math::PI / 180.0</tt>
+  # Translates between Gosu's angle system (where 0° is at the top) and
+  # radians (where 0 is at the right).
+  def gosu_to_radians(); end
+  
+  # Scales a degree value to radians.
+  def degrees_to_radians(); end
+  
+  # Scales a radian value to degrees.
+  def radians_to_degrees(); end
+end

metadata

@@ -1,13 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: gosu
 version: !ruby/object:Gem::Version 
-  hash: 85
-  prerelease: 
-  segments: 
-  - 0
-  - 7
-  - 43
-  version: 0.7.43
+  version: 0.7.44
 platform: ruby
 authors: 
 - Julian Raschke
@@ -15,7 +9,8 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-03-18 00:00:00 Z
+date: 2012-07-16 00:00:00 +08:00
+default_executable: 
 dependencies: []
 
 description: "  2D game development library.\n\n  Gosu features easy to use and game-friendly interfaces to 2D graphics\n  and text (accelerated by 3D hardware), sound samples and music as well as\n  keyboard, mouse and gamepad/joystick input.\n\n  Also includes demos for integration with RMagick, Chipmunk and OpenGL.\n"
@@ -89,6 +84,11 @@ files:
 - examples/media/Space.png
 - examples/media/Star.png
 - examples/media/Starfighter.bmp
+- reference/gosu.rb
+- reference/Drawing_with_Colors.rdoc
+- reference/Order_of_Corners.rdoc
+- reference/Tileability.rdoc
+- reference/Z_Ordering.rdoc
 - GosuImpl/Async.cpp
 - GosuImpl/Audio/ALChannelManagement.hpp
 - GosuImpl/Audio/AudioFile.hpp
@@ -182,6 +182,7 @@ files:
 - GosuImpl/WinUtility.cpp
 - GosuImpl/X11vroot.h
 - linux/extconf.rb
+has_rdoc: true
 homepage: http://www.libgosu.org/
 licenses: []
 
@@ -198,29 +199,21 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 51
-      segments: 
-      - 1
-      - 8
-      - 2
       version: 1.8.2
+  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
+  version: 
 requirements: 
 - See https://github.com/jlnr/gosu/wiki/Getting-Started-on-Linux
 rubyforge_project: 
-rubygems_version: 1.8.16
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: 2D game development library.