gosu 0.10.9.pre1 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9a8d2be430ae120903f4155a4b06567356fccc67
-  data.tar.gz: b2a0e682a342de8b463b041d2edb55675b4a454a
+  metadata.gz: 1ad2451369f43dadcb9f88a84fead3c5e3eb2dd3
+  data.tar.gz: 284ae60ac4f93bb14e3188c53652ed86bd439168
 SHA512:
-  metadata.gz: e7abb1410459e410c226ea129ecb82ddc453cadd468d969b676e5a4962b39380f5a7132d70847ec3eaabcf59d00d7f4f647189da3d4a9364c3c2258838285eac
-  data.tar.gz: c19fb65453733173aef1b99c3fcfaeaf1639745dbfdf8d8747a12adcd550cfc519be4761024de0be719e7dae953beb85765cdd0cddea33805c823818d8c19bb6
+  metadata.gz: b17636aa514351891d603b9dae3a5210e506f130ef8ced28094c2f2d94c66ee299c40bf25f3959dccf9813bd134b9127b7748553999731c9821d0b4af1bbd591
+  data.tar.gz: 6be1bb1c2228e69c25936ece224ce831c9f36fd25b12306ad91667439748186bd0d7b7fefdac51e99ad122042592714f49b60c7616873e75fb5967896fb417b3

data/Gosu/Audio.hpp

@@ -1,63 +1,50 @@
 //! \file Audio.hpp
 //! Contains all the classes of Gosu's audio system.
 
-#ifndef GOSU_AUDIO_HPP
-#define GOSU_AUDIO_HPP
+#pragma once
 
-#ifdef WIN32
-#ifndef NOMINMAX
-#define NOMINMAX
-#endif
-#include <windows.h>
-#endif
 #include <Gosu/Fwd.hpp>
 #include <Gosu/IO.hpp>
 #include <Gosu/Platform.hpp>
-#include <Gosu/TR1.hpp>
 #include <memory>
 #include <string>
 
 namespace Gosu
 {
-    // Deprecated.
-    #ifndef SWIG
-    class Audio;
-    #endif
-
     //! 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
-	{
-		int handle, extra;
-        bool alive() const;		
+    class SampleInstance
+    {
+        int handle, extra;
+        bool alive() const;
 
-	public:
-        //! Called by Sample, do not use.
-        // TODO: See if we can use 'friend' here.
-		SampleInstance(int handle, int extra);
+    public:
+        //! Called internally by Sample, do not use.
+        SampleInstance(int handle, int extra);
 
-		bool playing() const;
-		bool paused() const;
-        //! Pauses this instance to be resumed afterwards. It will still keep a channel filled while paused.
+        bool playing() const;
+        bool paused() const;
+        //! Pauses this instance to be resumed afterwards. It will still keep a channel filled while
+        //! paused.
         void pause();
         void resume();
         //! Stops this instance of a sound being played.
         //! Calling this twice, or too late, does not do any harm.
-		void stop();
+        void stop();
 
         //! \param volume Can be anything from 0.0 (silence) to 1.0 (full
         //! volume).
-        void changeVolume(double volume);
+        void change_volume(double volume);
         //! \param pan Can be anything from -1.0 (left) to 1.0 (right).
-        void changePan(double pan);
+        void change_pan(double pan);
         //! \param speed Playback speed is only limited by FMOD's
         //! capabilities and can accept very high or low values. Use 1.0 for
         //! normal playback speed.
-        void changeSpeed(double speed);
-	};
+        void change_speed(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
@@ -65,12 +52,12 @@ namespace Gosu
     class Sample
     {
         struct SampleData;
-        std::tr1::shared_ptr<SampleData> data;
-    
+        std::shared_ptr<SampleData> data;
+
     public:
         //! Constructs a sample that can be played on the specified audio
         //! system and loads the sample from a file.
-        explicit Sample(const std::wstring& filename);
+        explicit Sample(const std::string& filename);
         
         //! Constructs a sample that can be played on the specified audio
         //! system and loads the sample data from a stream.
@@ -82,8 +69,7 @@ namespace Gosu
         //! \param 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.
-        SampleInstance play(double volume = 1, double speed = 1,
-            bool looping = false) const;
+        SampleInstance play(double volume = 1, double speed = 1, bool looping = false) 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
@@ -94,39 +80,29 @@ namespace Gosu
         //! \param speed Playback speed is only limited by by the underlying audio library,
         //! 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,
+        SampleInstance play_pan(double pan, double volume = 1, double speed = 1,
             bool looping = false) const;
-
-        #ifndef SWIG
-        GOSU_DEPRECATED Sample(Audio& audio, const std::wstring& filename);
-        GOSU_DEPRECATED Sample(Audio& audio, Reader reader);
-        #endif
     };
 
-    //! Songs are less flexible than samples in that they can only be played
-    //! one at a time and without panning or speed parameters.
+    //! Songs are less flexible than samples. Only Song can be played at any given time,
+    //! and there is no way to control its pan (stereo position) or speed.
     class Song
     {
         class BaseData;
         class ModuleData;
         class StreamData;
-        GOSU_UNIQUE_PTR<BaseData> data;
-
-#if defined(GOSU_CPP11_ENABLED)
+        std::unique_ptr<BaseData> data;
+        
+        // Non-movable to avoid dangling internal references.
         Song(Song&&) = delete;
+        // Non-movable to avoid dangling internal references.
         Song& operator=(Song&&) = delete;
-        Song(const Song&) = delete;
-        Song& operator=(const Song&) = delete;
-#else
-        Song(const Song&);
-        Song& operator=(const Song&);
-#endif
 
     public:
         //! 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.
-        explicit Song(const std::wstring& filename);
+        explicit Song(const std::string& 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.
@@ -137,36 +113,29 @@ namespace Gosu
         //! Returns the song currently being played or paused, or 0 if
         //! no song has been played yet or the last song has finished
         //! playing.
-        static Song* currentSong();
+        static Song* current_song();
         
         //! Starts or resumes playback of the song. This will stop all other
         //! songs and set the current song to this object.
         void play(bool looping = false);
         //! Pauses playback of the song. It is not considered being played.
-        //! currentSong will stay the same.
+        //! current_song will stay the same.
         void pause();
         //! Returns true if the song is the current song, but in paused
         //! mode.
         bool paused() const;
         //! Stops playback of this song if it is currently played or paused.
-        //! Afterwards, currentSong will return 0.
+        //! Afterwards, current_song will return nullptr.
         void stop();
         //! Returns true 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);
+        //! \param volume Can be anything from 0.0 (silence) to 1.0 (full
+        //! volume).
+        void change_volume(double volume);
         
         //! Called every tick by Window for management purposes.
         static void update();
-
-        #ifndef SWIG
-        enum Type { stStream, stModule };
-        GOSU_DEPRECATED Song(Audio&, const std::wstring& filename);
-        GOSU_DEPRECATED Song(Audio&, Type type, Reader reader);
-        #endif
     };
 }
-
-#endif

data/Gosu/AutoLink.hpp

@@ -1,16 +1,14 @@
-//! \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
+//! \file AutoLink.hpp
+//! Contains pragmas that make MSVC link against all the necessary libraries
+//! automatically.
+
+#ifdef _MSC_VER
+#pragma once
+
+#ifdef NDEBUG
+#pragma comment(lib, "Gosu.lib")
+#else
+#pragma comment(lib, "GosuDebug.lib")
+#endif
+
+#endif

data/Gosu/Bitmap.hpp

@@ -1,11 +1,10 @@
 //! \file Bitmap.hpp
 //! Interface of the Bitmap class.
 
-#ifndef GOSU_BITMAP_HPP
-#define GOSU_BITMAP_HPP
+#pragma once
 
-#include <Gosu/Color.hpp>
 #include <Gosu/Fwd.hpp>
+#include <Gosu/Color.hpp>
 #include <Gosu/GraphicsBase.hpp>
 #include <Gosu/Platform.hpp>
 #include <string>
@@ -23,11 +22,25 @@ namespace Gosu
         std::vector<Color> pixels;
 
     public:
-        Bitmap() : w(0), h(0) {}
-        Bitmap(unsigned w, unsigned h, Color c = Color::NONE) : w(w), h(h), pixels(w * h, c) {}
-
-        unsigned width()  const { return w; }
-        unsigned height() const { return h; }
+        Bitmap()
+        : w(0), h(0)
+        {
+        }
+        
+        Bitmap(unsigned w, unsigned h, Color c = Color::NONE)
+        : w(w), h(h), pixels(w * h, c)
+        {
+        }
+        
+        unsigned width() const
+        {
+            return w;
+        }
+        
+        unsigned height() const
+        {
+            return h;
+        }
 
         void swap(Bitmap& other);
 
@@ -35,11 +48,17 @@ namespace Gosu
         
         //! 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]; }
+        Color get_pixel(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; }
+        void set_pixel(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
@@ -49,48 +68,42 @@ namespace Gosu
         //! 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);
+        void insert(const Bitmap& source, int x, int y, unsigned src_x, unsigned src_y,
+            unsigned src_width, unsigned src_height);
 
         //! Direct access to the array of color values. May be useful for optimized
         //! OpenGL operations.
-        const Color* data() const { return &pixels[0]; }
-        Color* data() { return &pixels[0]; }
-
-        // Work with data() instead if you need fast operations.
-        GOSU_DEPRECATED void fill(Color c);
-        GOSU_DEPRECATED void replace(Color oldColor, Color newColor);
+        const Color* data() const
+        {
+            return &pixels[0];
+        }
+        
+        Color* data()
+        {
+            return &pixels[0];
+        }
     };
     
     //! Loads any supported image into a Bitmap.
-    void loadImageFile(Bitmap& bitmap, const std::wstring& filename);
+    void load_image_file(Bitmap& bitmap, const std::string& filename);
     //! Loads any supported image into a Bitmap.
-    void loadImageFile(Bitmap& bitmap, Reader input);
+    void load_image_file(Bitmap& bitmap, Reader input);
     
     //! Saves a Bitmap to a file.
-    void saveImageFile(const Bitmap& bitmap, const std::wstring& filename);
+    void save_image_file(const Bitmap& bitmap, const std::string& filename);
     //! Saves a Bitmap to an arbitrary resource.
-    void saveImageFile(const Bitmap& bitmap, Writer writer,
-        const std::wstring& formatHint = L"png");
+    void save_image_file(const Bitmap& bitmap, Writer writer,
+        const std::string& format_hint = "png");
 
     //! 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 apply_color_key(Bitmap& bitmap, Color key);
     
-    //! The reverse of applyColorKey. Resets all fully transparent pixels by
+    //! The reverse of apply_color_key. Resets all fully transparent pixels by
     //! a background color, makes all other pixels fully opaque.
-    void unapplyColorKey(Bitmap& bitmap, Color background);
+    void unapply_color_key(Bitmap& bitmap, Color background);
     
-    void applyBorderFlags(Bitmap& dest, const Bitmap& source,
-        unsigned srcX, unsigned srcY, unsigned srcWidth, unsigned srcHeight,
-        unsigned borderFlags);
-
-    // Use loadImageFile/saveImageFile instead.
-    GOSU_DEPRECATED Reader loadFromBMP(Bitmap& bmp, Reader reader);
-    GOSU_DEPRECATED Writer saveToBMP(const Bitmap& bmp, Writer writer);
-    GOSU_DEPRECATED Reader loadFromPNG(Bitmap& bmp, Reader reader);
-    GOSU_DEPRECATED Writer saveToPNG(const Bitmap& bmp, Writer writer);
+    void apply_border_flags(Bitmap& dest, const Bitmap& source, unsigned src_x, unsigned src_y,
+        unsigned src_width, unsigned src_height, unsigned border_flags);
 }
-
-#endif

data/Gosu/Buttons.hpp

@@ -1,265 +1,246 @@
-#ifndef GOSU_BUTTONS_HPP
-#define GOSU_BUTTONS_HPP
-
-#include <Gosu/Platform.hpp>
-
-#ifdef GOSU_IS_MAC
-    #define GOSU_SCANCODE(mac, windows_or_linux) mac
-    #define GOSU_SPECIAL_SCANCODE(mac, windows, linux) mac
-#else
-    #define GOSU_SCANCODE(mac, linux_or_windows) linux_or_windows
-    #ifdef GOSU_IS_WIN
-        #define GOSU_SPECIAL_SCANCODE(mac, windows, linux) windows
-    #else
-        #define GOSU_SPECIAL_SCANCODE(mac, windows, linux) linux
-    #endif
-#endif
-
-namespace Gosu
-{
-    //! List of button ids that can be used with Gosu::Input.
-    //! This enumeration contains ids for keyboard keys (kb*),
-    //! mouse buttons and mouse wheel (ms*) and gamepad buttons (gp*).
-    enum ButtonName
-	{
-        kbRangeBegin,
-        kbEscape = 41,
-        kbF1 = 58,
-        kbF2 = 59,
-        kbF3 = 60,
-        kbF4 = 61,
-        kbF5 = 62,
-        kbF6 = 63,
-        kbF7 = 64,
-        kbF8 = 65,
-        kbF9 = 66,
-        kbF10 = 67,
-        kbF11 = 68,
-        kbF12 = 69,
-        kb0 = 39,
-        kb1 = 30,
-        kb2 = 31,
-        kb3 = 32,
-        kb4 = 33,
-        kb5 = 34,
-        kb6 = 35,
-        kb7 = 36,
-        kb8 = 37,
-        kb9 = 38,
-        kbTab = 43,
-        kbReturn = 40,
-        kbSpace = 44,
-        kbLeftShift = 225,
-        kbRightShift = 229,
-        kbLeftControl = 224,
-        kbRightControl = 228,
-        kbLeftAlt = 226,
-        kbRightAlt = 230,
-        kbLeftMeta = 227,
-        kbRightMeta = 231,
-        kbBackspace = 42,
-        kbLeft = 80,
-        kbRight = 79,
-        kbUp = 82,
-        kbDown = 81,
-        kbHome = 74,
-        kbEnd = 77,
-        kbInsert = 73,
-        kbDelete = 76,
-        kbPageUp = 75,
-        kbPageDown = 78,
-        kbEnter = 88,
-        kbBacktick = 53,
-        kbMinus = 45,
-        kbEqual = 46,        // TODO: Rename ->kbEquals
-        kbBracketLeft = 47,  // TODO: Rename ->kbLeftBracket
-        kbBracketRight = 48, // TODO: Rename ->kbRightBracket
-        kbBackslash = 49,
-        kbSemicolon = 51,
-        kbApostrophe = 52,
-        kbComma = 54,
-        kbPeriod = 55,
-        kbSlash = 49,
-        kbA = 4,
-        kbB = 5,
-        kbC = 6,
-        kbD = 7,
-        kbE = 8,
-        kbF = 9,
-        kbG = 10,
-        kbH = 11,
-        kbI = 12, 
-        kbJ = 13,
-        kbK = 14,
-        kbL = 15,
-        kbM = 16,
-        kbN = 17,
-        kbO = 18,
-        kbP = 19,
-        kbQ = 20,
-        kbR = 21,
-        kbS = 22,
-        kbT = 23,
-        kbU = 24,
-        kbV = 25,
-        kbW = 26,
-        kbX = 27,
-        kbY = 28,
-        kbZ = 29,
-        // ` on US/UK Mac, < on EU Mac, \ in US/UK Windows
-        kbISO = 100,
-        kbNumpad0 = 98,
-        kbNumpad1 = 89,
-        kbNumpad2 = 90,
-        kbNumpad3 = 91,
-        kbNumpad4 = 92,
-        kbNumpad5 = 93,
-        kbNumpad6 = 94,
-        kbNumpad7 = 95,
-        kbNumpad8 = 96,
-        kbNumpad9 = 97,
-        kbNumpadAdd = 87,      // TODO: Rename ->kbNumpadPlus
-        kbNumpadSubtract = 86, // TODO: Rename ->kbNumpadMinus
-        kbNumpadMultiply = 85,
-        kbNumpadDivide = 84,
-		kbRangeEnd = 0xff,
-
-        msRangeBegin,
-        msLeft = msRangeBegin,
-        msMiddle,
-        msRight,
-        msWheelUp,
-        msWheelDown,
-        msOther0,
-        msOther1,
-        msOther2,
-        msOther3,
-        msOther4,
-        msOther5,
-        msOther6,
-        msOther7,
-        msRangeEnd = 0x110,
-        
-        gpRangeBegin,
-        gpLeft = gpRangeBegin,
-        gpRight,
-        gpUp,
-        gpDown,
-        gpButton0,
-        gpButton1,
-        gpButton2,
-        gpButton3,
-        gpButton4,
-        gpButton5,
-        gpButton6,
-        gpButton7,
-        gpButton8,
-        gpButton9,
-        gpButton10,
-        gpButton11,
-        gpButton12,
-        gpButton13,
-        gpButton14,
-        gpButton15,
-
-        gp0Left,
-        gp0Right,
-        gp0Up,
-        gp0Down,
-        gp0Button0,
-        gp0Button1,
-        gp0Button2,
-        gp0Button3,
-        gp0Button4,
-        gp0Button5,
-        gp0Button6,
-        gp0Button7,
-        gp0Button8,
-        gp0Button9,
-        gp0Button10,
-        gp0Button11,
-        gp0Button12,
-        gp0Button13,
-        gp0Button14,
-        gp0Button15,
-        
-        gp1Left,
-        gp1Right,
-        gp1Up,
-        gp1Down,
-        gp1Button0,
-        gp1Button1,
-        gp1Button2,
-        gp1Button3,
-        gp1Button4,
-        gp1Button5,
-        gp1Button6,
-        gp1Button7,
-        gp1Button8,
-        gp1Button9,
-        gp1Button10,
-        gp1Button11,
-        gp1Button12,
-        gp1Button13,
-        gp1Button14,
-        gp1Button15,
-        
-        gp2Left,
-        gp2Right,
-        gp2Up,
-        gp2Down,
-        gp2Button0,
-        gp2Button1,
-        gp2Button2,
-        gp2Button3,
-        gp2Button4,
-        gp2Button5,
-        gp2Button6,
-        gp2Button7,
-        gp2Button8,
-        gp2Button9,
-        gp2Button10,
-        gp2Button11,
-        gp2Button12,
-        gp2Button13,
-        gp2Button14,
-        gp2Button15,
-        
-        gp3Left,
-        gp3Right,
-        gp3Up,
-        gp3Down,
-        gp3Button0,
-        gp3Button1,
-        gp3Button2,
-        gp3Button3,
-        gp3Button4,
-        gp3Button5,
-        gp3Button6,
-        gp3Button7,
-        gp3Button8,
-        gp3Button9,
-        gp3Button10,
-        gp3Button11,
-        gp3Button12,
-        gp3Button13,
-        gp3Button14,
-        gp3Button15,
-        
-        gpRangeEnd = gp3Button15,
-        
-        numButtons = gpRangeEnd + 1,
-        numGamepads = 4,
-        noButton = 0xffffffff,
-        
-        kbNum = kbRangeEnd - kbRangeBegin + 1,
-        msNum = msRangeEnd - msRangeBegin + 1,
-        gpNum = gpRangeEnd - gpRangeBegin + 1,
-        gpNumPerGamepad = gpNum / (numGamepads + 1)
-	};
-}
-
-#undef GOSU_SCANCODE
-#undef GOSU_SPECIAL_SCANCODE
-
-#endif
+#pragma once
+
+#include <Gosu/Platform.hpp>
+
+namespace Gosu
+{
+    //! List of button ids that can be used with Gosu::Input.
+    //! This enumeration contains ids for keyboard keys (KB_*),
+    //! mouse buttons and mouse wheel (MS_*) and gamepad buttons (GP_*).
+    enum ButtonName
+    {
+        KB_RANGE_BEGIN,
+        KB_ESCAPE          = 41,
+        KB_F1              = 58,
+        KB_F2              = 59,
+        KB_F3              = 60,
+        KB_F4              = 61,
+        KB_F5              = 62,
+        KB_F6              = 63,
+        KB_F7              = 64,
+        KB_F8              = 65,
+        KB_F9              = 66,
+        KB_F10             = 67,
+        KB_F11             = 68,
+        KB_F12             = 69,
+        KB_0               = 39,
+        KB_1               = 30,
+        KB_2               = 31,
+        KB_3               = 32,
+        KB_4               = 33,
+        KB_5               = 34,
+        KB_6               = 35,
+        KB_7               = 36,
+        KB_8               = 37,
+        KB_9               = 38,
+        KB_TAB             = 43,
+        KB_RETURN          = 40,
+        KB_SPACE           = 44,
+        KB_LEFT_SHIFT      = 225,
+        KB_RIGHT_SHIFT     = 229,
+        KB_LEFT_CONTROL    = 224,
+        KB_RIGHT_CONTROL   = 228,
+        KB_LEFT_ALT        = 226,
+        KB_RIGHT_ALT       = 230,
+        KB_LEFT_META       = 227,
+        KB_RIGHT_META      = 231,
+        KB_BACKSPACE       = 42,
+        KB_LEFT            = 80,
+        KB_RIGHT           = 79,
+        KB_UP              = 82,
+        KB_DOWN            = 81,
+        KB_HOME            = 74,
+        KB_END             = 77,
+        KB_INSERT          = 73,
+        KB_DELETE          = 76,
+        KB_PAGE_UP         = 75,
+        KB_PAGE_DOWN       = 78,
+        KB_ENTER           = 88,
+        KB_BACKTICK        = 53,
+        KB_MINUS           = 45,
+        KB_EQUALS          = 46,
+        KB_LEFT_BRACKET    = 47,
+        KB_RIGHT_BRACKET   = 48,
+        KB_BACKSLASH       = 49,
+        KB_SEMICOLON       = 51,
+        KB_APOSTROPHE      = 52,
+        KB_COMMA           = 54,
+        KB_PERIOD          = 55,
+        KB_SLASH           = 49,
+        KB_A               = 4,
+        KB_B               = 5,
+        KB_C               = 6,
+        KB_D               = 7,
+        KB_E               = 8,
+        KB_F               = 9,
+        KB_G               = 10,
+        KB_H               = 11,
+        KB_I               = 12,
+        KB_J               = 13,
+        KB_K               = 14,
+        KB_L               = 15,
+        KB_M               = 16,
+        KB_N               = 17,
+        KB_O               = 18,
+        KB_P               = 19,
+        KB_Q               = 20,
+        KB_R               = 21,
+        KB_S               = 22,
+        KB_T               = 23,
+        KB_U               = 24,
+        KB_V               = 25,
+        KB_W               = 26,
+        KB_X               = 27,
+        KB_Y               = 28,
+        KB_Z               = 29,
+        KB_ISO             = 100, // ` on US/UK macOS, < ON EU macOS, \ in US/UK Windows
+        KB_NUMPAD_0        = 98,
+        KB_NUMPAD_1        = 89,
+        KB_NUMPAD_2        = 90,
+        KB_NUMPAD_3        = 91,
+        KB_NUMPAD_4        = 92,
+        KB_NUMPAD_5        = 93,
+        KB_NUMPAD_6        = 94,
+        KB_NUMPAD_7        = 95,
+        KB_NUMPAD_8        = 96,
+        KB_NUMPAD_9        = 97,
+        KB_NUMPAD_PLUS     = 87,
+        KB_NUMPAD_MINUS    = 86,
+        KB_NUMPAD_MULTIPLY = 85,
+        KB_NUMPAD_DIVIDE   = 84,
+        KB_RANGE_END       = 0xff,
+
+        MS_RANGE_BEGIN,
+        MS_LEFT = MS_RANGE_BEGIN,
+        MS_MIDDLE,
+        MS_RIGHT,
+        MS_WHEEL_UP,
+        MS_WHEEL_DOWN,
+        MS_OTHER_0,
+        MS_OTHER_1,
+        MS_OTHER_2,
+        MS_OTHER_3,
+        MS_OTHER_4,
+        MS_OTHER_5,
+        MS_OTHER_6,
+        MS_OTHER_7,
+        MS_RANGE_END = 0x110,
+        
+        GP_RANGE_BEGIN,
+        GP_LEFT = GP_RANGE_BEGIN,
+        GP_RIGHT,
+        GP_UP,
+        GP_DOWN,
+        GP_BUTTON_0,
+        GP_BUTTON_1,
+        GP_BUTTON_2,
+        GP_BUTTON_3,
+        GP_BUTTON_4,
+        GP_BUTTON_5,
+        GP_BUTTON_6,
+        GP_BUTTON_7,
+        GP_BUTTON_8,
+        GP_BUTTON_9,
+        GP_BUTTON_10,
+        GP_BUTTON_11,
+        GP_BUTTON_12,
+        GP_BUTTON_13,
+        GP_BUTTON_14,
+        GP_BUTTON_15,
+
+        GP_0_LEFT,
+        GP_0_RIGHT,
+        GP_0_UP,
+        GP_0_DOWN,
+        GP_0_BUTTON_0,
+        GP_0_BUTTON_1,
+        GP_0_BUTTON_2,
+        GP_0_BUTTON_3,
+        GP_0_BUTTON_4,
+        GP_0_BUTTON_5,
+        GP_0_BUTTON_6,
+        GP_0_BUTTON_7,
+        GP_0_BUTTON_8,
+        GP_0_BUTTON_9,
+        GP_0_BUTTON_10,
+        GP_0_BUTTON_11,
+        GP_0_BUTTON_12,
+        GP_0_BUTTON_13,
+        GP_0_BUTTON_14,
+        GP_0_BUTTON_15,
+        
+        GP_1_LEFT,
+        GP_1_RIGHT,
+        GP_1_UP,
+        GP_1_DOWN,
+        GP_1_BUTTON_0,
+        GP_1_BUTTON_1,
+        GP_1_BUTTON_2,
+        GP_1_BUTTON_3,
+        GP_1_BUTTON_4,
+        GP_1_BUTTON_5,
+        GP_1_BUTTON_6,
+        GP_1_BUTTON_7,
+        GP_1_BUTTON_8,
+        GP_1_BUTTON_9,
+        GP_1_BUTTON_10,
+        GP_1_BUTTON_11,
+        GP_1_BUTTON_12,
+        GP_1_BUTTON_13,
+        GP_1_BUTTON_14,
+        GP_1_BUTTON_15,
+        
+        GP_2_LEFT,
+        GP_2_RIGHT,
+        GP_2_UP,
+        GP_2_DOWN,
+        GP_2_BUTTON_0,
+        GP_2_BUTTON_1,
+        GP_2_BUTTON_2,
+        GP_2_BUTTON_3,
+        GP_2_BUTTON_4,
+        GP_2_BUTTON_5,
+        GP_2_BUTTON_6,
+        GP_2_BUTTON_7,
+        GP_2_BUTTON_8,
+        GP_2_BUTTON_9,
+        GP_2_BUTTON_10,
+        GP_2_BUTTON_11,
+        GP_2_BUTTON_12,
+        GP_2_BUTTON_13,
+        GP_2_BUTTON_14,
+        GP_2_BUTTON_15,
+        
+        GP_3_LEFT,
+        GP_3_RIGHT,
+        GP_3_UP,
+        GP_3_DOWN,
+        GP_3_BUTTON_0,
+        GP_3_BUTTON_1,
+        GP_3_BUTTON_2,
+        GP_3_BUTTON_3,
+        GP_3_BUTTON_4,
+        GP_3_BUTTON_5,
+        GP_3_BUTTON_6,
+        GP_3_BUTTON_7,
+        GP_3_BUTTON_8,
+        GP_3_BUTTON_9,
+        GP_3_BUTTON_10,
+        GP_3_BUTTON_11,
+        GP_3_BUTTON_12,
+        GP_3_BUTTON_13,
+        GP_3_BUTTON_14,
+        GP_3_BUTTON_15,
+        
+        GP_RANGE_END       = GP_3_BUTTON_15,
+        
+        NUM_BUTTONS        = GP_RANGE_END + 1,
+        NUM_GAMEPADS       = 4,
+        NO_BUTTON          = 0xffffffff,
+        
+        KB_NUM             = KB_RANGE_END - KB_RANGE_BEGIN + 1,
+        MS_NUM             = MS_RANGE_END - MS_RANGE_BEGIN + 1,
+        GP_NUM             = GP_RANGE_END - GP_RANGE_BEGIN + 1,
+        GP_NUM_PER_GAMEPAD = GP_NUM / (NUM_GAMEPADS + 1)
+    };
+}