gosu 0.7.10.1

data/COPYING.txt

@@ -0,0 +1,29 @@
+Copyright (C) 2004-2007 Julian Raschke, Jan Lücker and all contributors.
+
+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.
+
+Julian Raschke julian@raschke.de
+Jan Lücker jan.luecker@gmx.de
+http://code.google.com/p/gosu/
+
+***
+
+Does NOT apply to fmod.dll shipped with the Windows version of Gosu,
+or the bytecode of FMOD contained in Gosu.framework and gosu.bundle on OS X.
+FMOD is a property of Firelight Technologies Pty, Ltd., see www.fmod.org.

data/Gosu/Async.hpp

@@ -0,0 +1,48 @@
+// Undocumented for the first few iterations. Interface may change rapidly.
+// This is mainly a proof of concept. Stability will be the highest on OS X.
+
+#ifndef GOSU_ASYNC_HPP
+#define GOSU_ASYNC_HPP
+
+#include <Gosu/Fwd.hpp>
+#include <boost/shared_ptr.hpp>
+#include <boost/thread.hpp>
+#include <memory>
+#include <string>
+
+namespace Gosu
+{
+    template<typename Result>
+    class AsyncResult
+    {
+        boost::shared_ptr<boost::try_mutex> mutex;
+        boost::shared_ptr<std::auto_ptr<Result> > result;
+        
+    public:
+        AsyncResult(const boost::shared_ptr<boost::try_mutex>& mutex,
+                    const boost::shared_ptr<std::auto_ptr<Result> >& result)
+        : mutex(mutex), result(result)
+        {
+        }
+        
+        bool hasValue() const
+        {
+            boost::try_mutex::scoped_try_lock lock(*mutex);
+            return lock && result->get();
+        }
+        
+        std::auto_ptr<Result> takeValue()
+        {
+            boost::try_mutex::scoped_lock lock(*mutex);
+            return *result;
+        }
+    };
+    
+	// TODO: Will only work if the window doesn't die inbetween.
+	// TODO: More functions to come; or a general interface?
+
+	AsyncResult<Image>
+		asyncNewImage(Window& window, const std::wstring& filename);
+}
+
+#endif

data/Gosu/Audio.hpp

@@ -0,0 +1,145 @@
+//! \file Audio.hpp
+//! Contains all the classes of Gosu's audio system.
+
+// REDESIGN: Rename all changeXXX() member functions to setXXX().
+// REDESIGN: Don't require window argument, is this possible?
+
+#ifndef GOSU_AUDIO_HPP
+#define GOSU_AUDIO_HPP
+
+#ifdef WIN32
+#include <windows.h>
+#endif
+#include <Gosu/Fwd.hpp>
+#include <Gosu/Platform.hpp>
+#include <boost/scoped_ptr.hpp>
+#include <boost/utility.hpp>
+#include <string>
+
+namespace Gosu
+{
+    //! Manages initialization and finalization of audio libraries. Must be
+    //! created before and destroyed after all samples and songs.
+    //! There can only be one instance of Gosu::Audio.
+    //! Usually created internally by Gosu::Window.
+    class Audio : boost::noncopyable
+    {
+    public:
+#ifdef GOSU_IS_WIN
+        explicit Audio(HWND window);
+#else
+        Audio();
+#endif
+        ~Audio();
+    };
+
+    //! 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 sounds played very long ago.
+	class SampleInstance
+	{
+		int handle, extra;
+		
+	public:
+        //! Called by Sample, do not use.
+		SampleInstance(int handle, int extra);
+
+		bool playing() const;
+		void stop();
+
+        //! \param volume Can be anything from 0.0 (silence) to 1.0 (full
+        //! volume).
+        void changeVolume(double volume);
+        //! \param pan Can be anything from -1.0 (left) to 1.0 (right).
+        void changePan(double pan);
+        //! \param speed Playback speed is only limited by FMOD's
+        //! capatibilities and can accept very high or low values. Use 1.0 for
+        //! normal playback speed.
+        void changeSpeed(double speed);
+	};
+
+    //! 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. In short, use samples for everything that's not music.
+    class Sample
+    {
+        struct SampleData;
+        boost::scoped_ptr<SampleData> data;
+
+    public:
+        //! Constructs a sample that can be played on the specified audio
+        //! system and loads the sample from a file.
+        Sample(Audio& audio, const std::wstring& filename);
+        
+        //! Constructs a sample that can be played on the specified audio
+        //! system and loads the sample data from a stream.
+        Sample(Audio& audio, Reader reader);
+        
+        ~Sample();
+
+        //! Plays the sample without panning.
+        //! \param volume Can be anything from 0.0 (silence) to 1.0 (full
+        //! volume).
+        //! \param speed Playback speed is only limited by FMOD's
+        //! capatibilities and can accept very high or low values. Use 1.0 for
+        //! normal playback speed.
+        SampleInstance play(double volume = 1, double speed = 1) const;
+
+        //! 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 FMOD's panning works.
+        //! \param pan Can be anything from -1.0 (left) to 1.0 (right).
+        //! \param volume Can be anything from 0.0 (silence) to 1.0 (full
+        //! volume).
+        //! \param speed Playback speed is only limited by FMOD's
+        //! capatibilities and can accept very high or low values. Use 1.0 for
+        //! normal playback speed.
+        SampleInstance playPan(double pan, double volume = 1, double speed = 1) const;
+    };
+
+    //! 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
+    {
+        class BaseData;
+        class ModuleData;
+        class StreamData;
+        boost::scoped_ptr<BaseData> data;
+
+    public:
+        //! There are two types of songs that can be loaded as a Song: Streamed
+        //! songs (like OGG) and modules (like MOD or XM).
+        enum Type
+        {
+            stStream,
+            stModule
+        };
+
+        //! Constructs a song that can be played on the provided audio system
+        //! and loads the song from a file. The type is determined from the
+        //! filename.
+        Song(Audio&, const std::wstring& filename);
+        
+        //! Constructs a song of the specified type that can be played on the
+        //! provided audio system and loads the song data from a stream.
+        Song(Audio&, Type type, Reader reader);
+        
+        ~Song();
+
+        //! Starts playback of the song. This will stop all other songs and
+        //! cause the currently played song to restart if called on the
+        //! current song.
+        void play();
+        //! Stops playback of this song if it is currently played.
+        void stop();
+        //! Returns if the song is currently playing.
+        bool playing() const;
+        //! Returns the current volume of the song.
+        double volume() const;
+        //! Changes the volume of the song.
+        void changeVolume(double volume);
+    };
+}
+
+#endif

data/Gosu/AutoLink.hpp

@@ -0,0 +1,16 @@
+//! \file AutoLink.hpp
+//! Contains pragmas that make MSVC link against all the necessary libraries
+//! automatically.
+
+#ifdef _MSC_VER
+#ifndef GOSU_AUTOLINK_HPP
+#define GOSU_AUTOLINK_HPP
+
+#ifdef NDEBUG
+#pragma comment(lib, "Gosu.lib")
+#else
+#pragma comment(lib, "GosuDebug.lib")
+#endif
+
+#endif
+#endif

data/Gosu/Bitmap.hpp

@@ -0,0 +1,85 @@
+//! \file Bitmap.hpp
+//! Interface of the Bitmap class.
+
+#ifndef GOSU_BITMAP_HPP
+#define GOSU_BITMAP_HPP
+
+#include <Gosu/Color.hpp>
+#include <Gosu/Fwd.hpp>
+#include <Gosu/GraphicsBase.hpp>
+#include <boost/scoped_ptr.hpp>
+#include <string>
+#include <vector>
+
+namespace Gosu
+{
+    //! Rectangular area of pixels, each represented by a Color value. Provides
+    //! minimal drawing functionality and serves as a temporary holder for
+    //! graphical resources which are usually turned into Images later.
+    //! Has (expensive) value semantics.
+    class Bitmap
+    {
+        unsigned w, h;
+        std::vector<Color> pixels;
+
+    public:
+        Bitmap();
+
+        unsigned width() const { return w; }
+        unsigned height() const { return h; }
+
+        void swap(Bitmap& other);
+
+        void resize(unsigned width, unsigned height, Color c = Colors::none);
+
+        void fill(Color c);
+        void replace(Color oldColor, Color newColor);
+
+        //! Returns the color at the specified position. x and y must be on the
+        //! bitmap.
+        Color getPixel(unsigned x, unsigned y) const { return pixels[y * w + x]; }
+
+        //! Sets the pixel at the specified position to a color. x and y must
+        //! be on the bitmap.
+        void setPixel(unsigned x, unsigned y, Color c) { pixels[y * w + x] = c; }
+
+        //! Inserts a bitmap at the given position. Parts of the inserted
+        //! bitmap that would be outside of the target bitmap will be
+        //! clipped away.
+        void insert(const Bitmap& source, int x, int y);
+
+        //! Inserts a portion of a bitmap at the given position. Parts of the
+        //! inserted bitmap that would be outside of the target bitmap will be
+        //! clipped away.
+        void insert(const Bitmap& source, int x, int y, unsigned srcX,
+            unsigned srcY, unsigned srcWidth, unsigned srcHeight);
+		
+		#ifndef __BIG_ENDIAN__
+		//! Undocumented optimization for Image creation; to be changed.
+        const unsigned* glCompatibleData() const { return reinterpret_cast<const unsigned*>(&pixels[0]); }
+		#endif
+    };
+
+    //! Loads a Windows or OS/2 BMP file into the given bitmap.
+    Reader loadFromBMP(Bitmap& bmp, Reader reader);
+    //! Saves the contents of the given bitmap into windows BMP file data.
+    Writer saveToBMP(const Bitmap& bmp, Writer writer);
+    //! Loads a PNG file into the given bitmap.
+    Reader loadFromPNG(Bitmap& bmp, Reader reader);
+    //! Saves the contents of the given bitmap into PNG file data, 24 bits.
+    Writer saveToPNG(const Bitmap& bmp, Writer writer);
+
+    //! Set the alpha value of all pixels which are equal to the color key
+    //! to zero. Color values are adjusted so that no borders show up when
+    //! the image is stretched or rotated.
+    void applyColorKey(Bitmap& bitmap, Color key);
+
+    void applyBorderFlags(Bitmap& dest, const Bitmap& source,
+        unsigned srcX, unsigned srcY, unsigned srcWidth, unsigned srcHeight,
+        unsigned borderFlags);	
+
+	// Still to be moved around & undocumented, beware! (TODO)
+	Bitmap quickLoadBitmap(const std::wstring& filename);
+}
+
+#endif

data/Gosu/ButtonsMac.hpp

@@ -0,0 +1,114 @@
+#ifndef GOSU_BUTTONSMAC_HPP
+#define GOSU_BUTTONSMAC_HPP
+
+namespace Gosu
+{
+    //! List of all the button ids that can be used with Gosu::Input.
+    //! This enumeration contains ids for non-character keyboard keys (kb*),
+    //! mouse buttons and mouse wheel (ms*) and gamepad buttons (gp*).
+    enum ButtonName
+    {
+        kbRangeBegin = 0x01,
+        kbEscape = 0x35,
+        kbF1 = 0x7a,
+        kbF2 = 0x78,
+        kbF3 = 0x63,
+        kbF4 = 0x76,
+        kbF5 = 0x60,
+        kbF6 = 0x61,
+        kbF7 = 0x62,
+        kbF8 = 0x64,
+        kbF9 = 0x65,
+        kbF10 = 0x6d,
+        kbF11 = 0x67,
+        kbF12 = 0x6f,
+        kb1 = 0x12,
+        kb2 = 0x13,
+        kb3 = 0x14,
+        kb4 = 0x15,
+        kb5 = 0x17,
+        kb6 = 0x16,
+        kb7 = 0x1a,
+        kb8 = 0x1c,
+        kb9 = 0x19,
+        kb0 = 0x1d,
+        kbTab = 0x30,
+        kbReturn = 0x24,
+        kbSpace = 0x31,
+        kbLeftShift = 0x38,
+        kbRightShift = 0x3c,
+        kbLeftControl = 0x3b,
+        kbRightControl = 0x3e,
+        kbLeftAlt = 0x3a,
+        kbRightAlt = 0x3d,
+        kbLeftMeta = 0x37,
+        kbRightMeta = 0x36,
+        kbBackspace = 0x33,
+        kbLeft = 0x7b,
+        kbRight = 0x7c,
+        kbUp = 0x7e,
+        kbDown = 0x7d,
+        kbHome = 0x73,
+        kbEnd = 0x77,
+        kbInsert = 0x72,
+        kbDelete = 0x75,
+        kbPageUp = 0x74,
+        kbPageDown = 0x79,
+        kbEnter = 0x4c,
+        kbNumpad1 = 0x53,
+        kbNumpad2 = 0x54,
+        kbNumpad3 = 0x55,
+        kbNumpad4 = 0x56,
+        kbNumpad5 = 0x57,
+        kbNumpad6 = 0x58,
+        kbNumpad7 = 0x59,
+        kbNumpad8 = 0x5b,
+        kbNumpad9 = 0x5c,
+        kbNumpad0 = 0x52,
+        kbNumpadAdd = 0x45,
+        kbNumpadSubtract = 0x4e,
+        kbNumpadMultiply = 0x43,
+        kbNumpadDivide = 0x4b,
+        kbRangeEnd = 0xffff,
+        
+        msRangeBegin,
+        msLeft = msRangeBegin,
+        msRight,
+        msMiddle,
+        msWheelUp,
+        msWheelDown,
+        msRangeEnd,
+        
+        gpRangeBegin,
+        gpLeft = gpRangeBegin,
+        gpRight,
+        gpUp,
+        gpDown,
+        gpButton0,
+        gpButton1,
+        gpButton2,
+        gpButton3,
+        gpButton4,
+        gpButton5,
+        gpButton6,
+        gpButton7,
+        gpButton8,
+        gpButton9,
+        gpButton10,
+        gpButton11,
+        gpButton12,
+        gpButton13,
+        gpButton14,
+        gpButton15,
+        gpRangeEnd = gpButton15,
+        
+        kbNum = kbRangeEnd - kbRangeBegin + 1,
+        msNum = msRangeEnd - msRangeBegin + 1,
+        gpNum = gpRangeEnd - gpRangeBegin + 1,
+        
+        numButtons = gpRangeEnd + 1,
+		noButton = 0xffffffff
+    };
+}
+    
+#endif

data/Gosu/ButtonsWin.hpp

@@ -0,0 +1,111 @@
+#ifndef GOSU_BUTTONSWIN_HPP
+#define GOSU_BUTTONSWIN_HPP
+
+namespace Gosu
+{
+	enum ButtonName
+	{
+        kbRangeBegin = 1,
+		kbEscape = 0x01,
+		kbF1 = 0x3b,
+		kbF2 = 0x3c,
+		kbF3 = 0x3d,
+		kbF4 = 0x3e,
+		kbF5 = 0x3f,
+		kbF6 = 0x40,
+		kbF7 = 0x41,
+		kbF8 = 0x42,
+		kbF9 = 0x43,
+		kbF10 = 0x44,
+		kbF11 = 0x57,
+		kbF12 = 0x58,
+		kb0 = 0x0b,
+		kb1 = 0x02,
+		kb2 = 0x03,
+		kb3 = 0x04,
+		kb4 = 0x05,
+		kb5 = 0x06,
+		kb6 = 0x07,
+		kb7 = 0x08,
+		kb8 = 0x09,
+		kb9 = 0x0a,
+		kbTab = 0x0f,
+		kbReturn = 0x1c,
+		kbSpace = 0x39,
+		kbLeftShift = 0x2a,
+		kbRightShift = 0x36,
+		kbLeftControl = 0x1d,
+		kbRightControl = 0x9d,
+		kbLeftAlt = 0x38,
+		kbRightAlt = 0xb8,
+		kbLeftMeta = 0xdb,
+		kbRightMeta = 0xdc,
+		kbBackspace = 0x0e,
+		kbLeft = 0xcb,
+		kbRight = 0xcd,
+		kbUp = 0xc8,
+		kbDown = 0xd0,
+		kbHome = 0xc7,
+		kbEnd = 0xcf,
+		kbInsert = 0xd2,
+		kbDelete = 0xd3,
+		kbPageUp = 0xc9,
+		kbPageDown = 0xd1,
+		kbEnter = 0x9c,
+		kbNumpad0 = 0x52,
+		kbNumpad1 = 0x4f,
+		kbNumpad2 = 0x50,
+		kbNumpad3 = 0x51,
+		kbNumpad4 = 0x4b,
+		kbNumpad5 = 0x4c,
+		kbNumpad6 = 0x4d,
+		kbNumpad7 = 0x47,
+		kbNumpad8 = 0x48,
+		kbNumpad9 = 0x49,
+		kbNumpadAdd = 0x4e,
+		kbNumpadSubtract = 0x4a,
+		kbNumpadMultiply = 0x37,
+		kbNumpadDivide = 0xb5,
+		kbRangeEnd = 0xff,
+
+        msRangeBegin,
+        msLeft = msRangeBegin,
+        msRight,
+        msMiddle,
+        msWheelUp,
+        msWheelDown,
+        msRangeEnd,
+        
+        gpRangeBegin,
+        gpLeft = gpRangeBegin,
+        gpRight,
+        gpUp,
+        gpDown,
+        gpButton0,
+        gpButton1,
+        gpButton2,
+        gpButton3,
+        gpButton4,
+        gpButton5,
+        gpButton6,
+        gpButton7,
+        gpButton8,
+        gpButton9,
+        gpButton10,
+        gpButton11,
+        gpButton12,
+        gpButton13,
+        gpButton14,
+        gpButton15,
+        gpRangeEnd = gpButton15,
+        
+        kbNum = kbRangeEnd - kbRangeBegin + 1,
+        msNum = msRangeEnd - msRangeBegin + 1,
+        gpNum = gpRangeEnd - gpRangeBegin + 1,
+        
+        numButtons = gpRangeEnd,
+		noButton = 0xffffffff
+	};
+}
+
+#endif