gosu 0.15.2 → 1.0.0.pre1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (234) hide show
  1. checksums.yaml +4 -4
  2. data/dependencies/SDL/include/SDL.h +138 -0
  3. data/dependencies/SDL/include/SDL_assert.h +293 -0
  4. data/dependencies/SDL/include/SDL_atomic.h +295 -0
  5. data/dependencies/SDL/include/SDL_audio.h +859 -0
  6. data/dependencies/SDL/include/SDL_bits.h +121 -0
  7. data/dependencies/SDL/include/SDL_blendmode.h +123 -0
  8. data/dependencies/SDL/include/SDL_clipboard.h +71 -0
  9. data/dependencies/SDL/include/SDL_config.h +55 -0
  10. data/dependencies/SDL/include/SDL_config_android.h +182 -0
  11. data/dependencies/SDL/include/SDL_config_iphoneos.h +207 -0
  12. data/dependencies/SDL/include/SDL_config_macosx.h +266 -0
  13. data/dependencies/SDL/include/SDL_config_minimal.h +85 -0
  14. data/dependencies/SDL/include/SDL_config_os2.h +188 -0
  15. data/dependencies/SDL/include/SDL_config_pandora.h +135 -0
  16. data/dependencies/SDL/include/SDL_config_psp.h +165 -0
  17. data/dependencies/SDL/include/SDL_config_windows.h +288 -0
  18. data/dependencies/SDL/include/SDL_config_winrt.h +243 -0
  19. data/dependencies/SDL/include/SDL_config_wiz.h +149 -0
  20. data/dependencies/SDL/include/SDL_copying.h +20 -0
  21. data/dependencies/SDL/include/SDL_cpuinfo.h +299 -0
  22. data/dependencies/SDL/include/SDL_egl.h +1676 -0
  23. data/dependencies/SDL/include/SDL_endian.h +263 -0
  24. data/dependencies/SDL/include/SDL_error.h +112 -0
  25. data/dependencies/SDL/include/SDL_events.h +827 -0
  26. data/dependencies/SDL/include/SDL_filesystem.h +136 -0
  27. data/dependencies/SDL/include/SDL_gamecontroller.h +541 -0
  28. data/dependencies/SDL/include/SDL_gesture.h +87 -0
  29. data/dependencies/SDL/include/SDL_haptic.h +1247 -0
  30. data/dependencies/SDL/include/SDL_hints.h +1578 -0
  31. data/dependencies/SDL/include/SDL_joystick.h +499 -0
  32. data/dependencies/SDL/include/SDL_keyboard.h +217 -0
  33. data/dependencies/SDL/include/SDL_keycode.h +351 -0
  34. data/dependencies/SDL/include/SDL_loadso.h +81 -0
  35. data/dependencies/SDL/include/SDL_locale.h +101 -0
  36. data/dependencies/SDL/include/SDL_log.h +211 -0
  37. data/dependencies/SDL/include/SDL_main.h +180 -0
  38. data/dependencies/SDL/include/SDL_messagebox.h +146 -0
  39. data/dependencies/SDL/include/SDL_metal.h +117 -0
  40. data/dependencies/SDL/include/SDL_misc.h +75 -0
  41. data/dependencies/SDL/include/SDL_mouse.h +302 -0
  42. data/dependencies/SDL/include/SDL_mutex.h +251 -0
  43. data/dependencies/SDL/include/SDL_name.h +33 -0
  44. data/dependencies/SDL/include/SDL_opengl.h +2183 -0
  45. data/dependencies/SDL/include/SDL_opengl_glext.h +11180 -0
  46. data/dependencies/SDL/include/SDL_opengles.h +39 -0
  47. data/dependencies/SDL/include/SDL_opengles2.h +52 -0
  48. data/dependencies/SDL/include/SDL_opengles2_gl2.h +621 -0
  49. data/dependencies/SDL/include/SDL_opengles2_gl2ext.h +2050 -0
  50. data/dependencies/SDL/include/SDL_opengles2_gl2platform.h +30 -0
  51. data/dependencies/SDL/include/SDL_opengles2_khrplatform.h +282 -0
  52. data/dependencies/SDL/include/SDL_pixels.h +479 -0
  53. data/dependencies/SDL/include/SDL_platform.h +198 -0
  54. data/dependencies/SDL/include/SDL_power.h +75 -0
  55. data/dependencies/SDL/include/SDL_quit.h +58 -0
  56. data/dependencies/SDL/include/SDL_rect.h +174 -0
  57. data/dependencies/SDL/include/SDL_render.h +1158 -0
  58. data/dependencies/SDL/include/SDL_revision.h +2 -0
  59. data/dependencies/SDL/include/SDL_rwops.h +283 -0
  60. data/dependencies/SDL/include/SDL_scancode.h +413 -0
  61. data/dependencies/SDL/include/SDL_sensor.h +267 -0
  62. data/dependencies/SDL/include/SDL_shape.h +144 -0
  63. data/dependencies/SDL/include/SDL_stdinc.h +647 -0
  64. data/dependencies/SDL/include/SDL_surface.h +563 -0
  65. data/dependencies/SDL/include/SDL_system.h +325 -0
  66. data/dependencies/SDL/include/SDL_syswm.h +354 -0
  67. data/dependencies/SDL/include/SDL_test.h +69 -0
  68. data/dependencies/SDL/include/SDL_test_assert.h +105 -0
  69. data/dependencies/SDL/include/SDL_test_common.h +218 -0
  70. data/dependencies/SDL/include/SDL_test_compare.h +69 -0
  71. data/dependencies/SDL/include/SDL_test_crc32.h +124 -0
  72. data/dependencies/SDL/include/SDL_test_font.h +81 -0
  73. data/dependencies/SDL/include/SDL_test_fuzzer.h +384 -0
  74. data/dependencies/SDL/include/SDL_test_harness.h +134 -0
  75. data/dependencies/SDL/include/SDL_test_images.h +78 -0
  76. data/dependencies/SDL/include/SDL_test_log.h +67 -0
  77. data/dependencies/SDL/include/SDL_test_md5.h +129 -0
  78. data/dependencies/SDL/include/SDL_test_memory.h +63 -0
  79. data/dependencies/SDL/include/SDL_test_random.h +115 -0
  80. data/dependencies/SDL/include/SDL_thread.h +366 -0
  81. data/dependencies/SDL/include/SDL_timer.h +115 -0
  82. data/dependencies/SDL/include/SDL_touch.h +102 -0
  83. data/dependencies/SDL/include/SDL_types.h +29 -0
  84. data/dependencies/SDL/include/SDL_version.h +162 -0
  85. data/dependencies/SDL/include/SDL_video.h +1282 -0
  86. data/dependencies/SDL/include/SDL_vulkan.h +276 -0
  87. data/dependencies/SDL/include/begin_code.h +166 -0
  88. data/dependencies/SDL/include/close_code.h +40 -0
  89. data/dependencies/SDL/lib/x64/libSDL2.dll.a +0 -0
  90. data/dependencies/SDL/lib/x86/libSDL2.dll.a +0 -0
  91. data/dependencies/SDL_sound/SDL_sound.c +795 -0
  92. data/dependencies/SDL_sound/SDL_sound.h +725 -0
  93. data/dependencies/SDL_sound/SDL_sound_aiff.c +537 -0
  94. data/dependencies/SDL_sound/SDL_sound_au.c +352 -0
  95. data/dependencies/SDL_sound/SDL_sound_coreaudio.c +747 -0
  96. data/dependencies/SDL_sound/SDL_sound_flac.c +182 -0
  97. data/dependencies/SDL_sound/SDL_sound_internal.h +304 -0
  98. data/dependencies/SDL_sound/SDL_sound_modplug.c +228 -0
  99. data/dependencies/SDL_sound/SDL_sound_mp3.c +184 -0
  100. data/dependencies/SDL_sound/SDL_sound_raw.c +164 -0
  101. data/dependencies/SDL_sound/SDL_sound_shn.c +1309 -0
  102. data/dependencies/SDL_sound/SDL_sound_voc.c +550 -0
  103. data/dependencies/SDL_sound/SDL_sound_vorbis.c +223 -0
  104. data/dependencies/SDL_sound/SDL_sound_wav.c +783 -0
  105. data/dependencies/SDL_sound/dr_flac.h +5906 -0
  106. data/dependencies/SDL_sound/dr_mp3.h +2832 -0
  107. data/dependencies/SDL_sound/libmodplug/fastmix.c +1748 -0
  108. data/dependencies/SDL_sound/libmodplug/libmodplug.h +1001 -0
  109. data/dependencies/SDL_sound/libmodplug/load_669.c +188 -0
  110. data/dependencies/SDL_sound/libmodplug/load_abc.c +4725 -0
  111. data/dependencies/SDL_sound/libmodplug/load_amf.c +403 -0
  112. data/dependencies/SDL_sound/libmodplug/load_ams.c +587 -0
  113. data/dependencies/SDL_sound/libmodplug/load_dbm.c +357 -0
  114. data/dependencies/SDL_sound/libmodplug/load_dmf.c +531 -0
  115. data/dependencies/SDL_sound/libmodplug/load_dsm.c +232 -0
  116. data/dependencies/SDL_sound/libmodplug/load_far.c +253 -0
  117. data/dependencies/SDL_sound/libmodplug/load_it.c +796 -0
  118. data/dependencies/SDL_sound/libmodplug/load_mdl.c +488 -0
  119. data/dependencies/SDL_sound/libmodplug/load_med.c +757 -0
  120. data/dependencies/SDL_sound/libmodplug/load_mid.c +1405 -0
  121. data/dependencies/SDL_sound/libmodplug/load_mod.c +269 -0
  122. data/dependencies/SDL_sound/libmodplug/load_mt2.c +546 -0
  123. data/dependencies/SDL_sound/libmodplug/load_mtm.c +142 -0
  124. data/dependencies/SDL_sound/libmodplug/load_okt.c +192 -0
  125. data/dependencies/SDL_sound/libmodplug/load_pat.c +1143 -0
  126. data/dependencies/SDL_sound/libmodplug/load_pat.h +25 -0
  127. data/dependencies/SDL_sound/libmodplug/load_psm.c +350 -0
  128. data/dependencies/SDL_sound/libmodplug/load_ptm.c +204 -0
  129. data/dependencies/SDL_sound/libmodplug/load_s3m.c +325 -0
  130. data/dependencies/SDL_sound/libmodplug/load_stm.c +180 -0
  131. data/dependencies/SDL_sound/libmodplug/load_ult.c +206 -0
  132. data/dependencies/SDL_sound/libmodplug/load_umx.c +51 -0
  133. data/dependencies/SDL_sound/libmodplug/load_xm.c +554 -0
  134. data/dependencies/SDL_sound/libmodplug/mmcmp.c +382 -0
  135. data/dependencies/SDL_sound/libmodplug/modplug.c +170 -0
  136. data/dependencies/SDL_sound/libmodplug/modplug.h +90 -0
  137. data/dependencies/SDL_sound/libmodplug/snd_dsp.c +301 -0
  138. data/dependencies/SDL_sound/libmodplug/snd_flt.c +63 -0
  139. data/dependencies/SDL_sound/libmodplug/snd_fx.c +2350 -0
  140. data/dependencies/SDL_sound/libmodplug/sndfile.c +1169 -0
  141. data/dependencies/SDL_sound/libmodplug/sndmix.c +1034 -0
  142. data/dependencies/SDL_sound/libmodplug/tables.h +371 -0
  143. data/{src/stb_vorbis.c → dependencies/SDL_sound/stb_vorbis.h} +143 -78
  144. data/dependencies/al_soft/AL/al.h +655 -0
  145. data/dependencies/al_soft/AL/alc.h +270 -0
  146. data/dependencies/al_soft/AL/alext.h +585 -0
  147. data/dependencies/al_soft/AL/efx-creative.h +3 -0
  148. data/dependencies/al_soft/AL/efx-presets.h +402 -0
  149. data/dependencies/al_soft/AL/efx.h +762 -0
  150. data/dependencies/al_soft/x64/libOpenAL32.dll.a +0 -0
  151. data/dependencies/al_soft/x86/libOpenAL32.dll.a +0 -0
  152. data/{src → dependencies/stb}/stb_image.h +330 -127
  153. data/{src → dependencies/stb}/stb_image_write.h +156 -85
  154. data/{src → dependencies/stb}/stb_truetype.h +192 -69
  155. data/{src → dependencies/utf8proc}/utf8proc.c +0 -0
  156. data/{src → dependencies/utf8proc}/utf8proc.h +0 -0
  157. data/{src → dependencies/utf8proc}/utf8proc_data.h +0 -0
  158. data/ext/gosu/extconf.rb +56 -22
  159. data/{Gosu → include/Gosu}/Audio.hpp +6 -8
  160. data/{Gosu → include/Gosu}/AutoLink.hpp +0 -0
  161. data/include/Gosu/Bitmap.hpp +100 -0
  162. data/{Gosu → include/Gosu}/Buttons.hpp +94 -35
  163. data/{Gosu → include/Gosu}/Channel.h +0 -0
  164. data/{Gosu → include/Gosu}/Color.h +0 -0
  165. data/{Gosu → include/Gosu}/Color.hpp +0 -0
  166. data/{Gosu → include/Gosu}/Directories.hpp +0 -0
  167. data/{Gosu → include/Gosu}/Font.h +0 -0
  168. data/{Gosu → include/Gosu}/Font.hpp +0 -0
  169. data/{Gosu → include/Gosu}/Fwd.hpp +0 -0
  170. data/{Gosu → include/Gosu}/Gosu.h +3 -0
  171. data/{Gosu → include/Gosu}/Gosu.hpp +0 -0
  172. data/{Gosu → include/Gosu}/Graphics.hpp +0 -0
  173. data/{Gosu → include/Gosu}/GraphicsBase.hpp +0 -0
  174. data/{Gosu → include/Gosu}/IO.hpp +0 -0
  175. data/{Gosu → include/Gosu}/Image.h +0 -0
  176. data/{Gosu → include/Gosu}/Image.hpp +7 -6
  177. data/{Gosu → include/Gosu}/ImageData.hpp +0 -0
  178. data/{Gosu → include/Gosu}/Input.hpp +30 -15
  179. data/{Gosu → include/Gosu}/Inspection.hpp +0 -0
  180. data/{Gosu → include/Gosu}/Math.hpp +0 -0
  181. data/{Gosu → include/Gosu}/Platform.hpp +0 -0
  182. data/{Gosu → include/Gosu}/Sample.h +0 -0
  183. data/{Gosu → include/Gosu}/Song.h +0 -0
  184. data/{Gosu → include/Gosu}/Text.hpp +0 -0
  185. data/{Gosu → include/Gosu}/TextInput.h +0 -0
  186. data/{Gosu → include/Gosu}/TextInput.hpp +0 -0
  187. data/{Gosu → include/Gosu}/Timing.hpp +0 -0
  188. data/{Gosu → include/Gosu}/Utility.hpp +1 -1
  189. data/{Gosu → include/Gosu}/Version.hpp +0 -0
  190. data/{Gosu → include/Gosu}/Window.h +2 -0
  191. data/{Gosu → include/Gosu}/Window.hpp +21 -13
  192. data/lib/OpenAL32.dll +0 -0
  193. data/lib/SDL2.dll +0 -0
  194. data/lib/gosu.rb +0 -3
  195. data/lib/gosu/patches.rb +0 -9
  196. data/lib/gosu/swig_patches.rb +3 -2
  197. data/lib/libmpg123.dll +0 -0
  198. data/lib/libsndfile.dll +0 -0
  199. data/lib64/OpenAL32.dll +0 -0
  200. data/lib64/SDL2.dll +0 -0
  201. data/lib64/libmpg123.dll +0 -0
  202. data/lib64/libsndfile.dll +0 -0
  203. data/rdoc/gosu.rb +95 -20
  204. data/src/Audio.cpp +50 -224
  205. data/src/AudioFile.hpp +17 -37
  206. data/src/AudioFileAudioToolbox.cpp +237 -0
  207. data/src/AudioFileSDLSound.cpp +147 -0
  208. data/src/AudioImpl.cpp +3 -12
  209. data/src/AudioImpl.hpp +3 -1
  210. data/src/Bitmap.cpp +85 -83
  211. data/src/BitmapIO.cpp +52 -58
  212. data/src/Constants.cpp +80 -33
  213. data/src/Font.cpp +3 -1
  214. data/src/GosuWrapper.cpp +19 -0
  215. data/src/Graphics.cpp +7 -4
  216. data/src/Image.cpp +13 -16
  217. data/src/Input.cpp +408 -159
  218. data/src/LargeImageData.cpp +1 -1
  219. data/src/MarkupParser.cpp +2 -1
  220. data/src/RubyGosu.cxx +349 -83
  221. data/src/RubyGosu.h +4 -2
  222. data/src/TexChunk.cpp +1 -1
  223. data/src/TextBuilder.cpp +3 -1
  224. data/src/Texture.cpp +1 -1
  225. data/src/TrueTypeFont.cpp +1 -1
  226. data/src/Utility.cpp +11 -7
  227. data/src/Window.cpp +30 -39
  228. data/src/WindowWrapper.cpp +28 -0
  229. metadata +207 -52
  230. data/Gosu/Bitmap.hpp +0 -113
  231. data/src/AudioToolboxFile.hpp +0 -210
  232. data/src/OggFile.hpp +0 -92
  233. data/src/SndFile.hpp +0 -174
  234. data/src/WinMain.cpp +0 -64
@@ -0,0 +1,563 @@
1
+ /*
2
+ Simple DirectMedia Layer
3
+ Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
4
+
5
+ This software is provided 'as-is', without any express or implied
6
+ warranty. In no event will the authors be held liable for any damages
7
+ arising from the use of this software.
8
+
9
+ Permission is granted to anyone to use this software for any purpose,
10
+ including commercial applications, and to alter it and redistribute it
11
+ freely, subject to the following restrictions:
12
+
13
+ 1. The origin of this software must not be misrepresented; you must not
14
+ claim that you wrote the original software. If you use this software
15
+ in a product, an acknowledgment in the product documentation would be
16
+ appreciated but is not required.
17
+ 2. Altered source versions must be plainly marked as such, and must not be
18
+ misrepresented as being the original software.
19
+ 3. This notice may not be removed or altered from any source distribution.
20
+ */
21
+
22
+ /**
23
+ * \file SDL_surface.h
24
+ *
25
+ * Header file for ::SDL_Surface definition and management functions.
26
+ */
27
+
28
+ #ifndef SDL_surface_h_
29
+ #define SDL_surface_h_
30
+
31
+ #include "SDL_stdinc.h"
32
+ #include "SDL_pixels.h"
33
+ #include "SDL_rect.h"
34
+ #include "SDL_blendmode.h"
35
+ #include "SDL_rwops.h"
36
+
37
+ #include "begin_code.h"
38
+ /* Set up for C function definitions, even when using C++ */
39
+ #ifdef __cplusplus
40
+ extern "C" {
41
+ #endif
42
+
43
+ /**
44
+ * \name Surface flags
45
+ *
46
+ * These are the currently supported flags for the ::SDL_Surface.
47
+ *
48
+ * \internal
49
+ * Used internally (read-only).
50
+ */
51
+ /* @{ */
52
+ #define SDL_SWSURFACE 0 /**< Just here for compatibility */
53
+ #define SDL_PREALLOC 0x00000001 /**< Surface uses preallocated memory */
54
+ #define SDL_RLEACCEL 0x00000002 /**< Surface is RLE encoded */
55
+ #define SDL_DONTFREE 0x00000004 /**< Surface is referenced internally */
56
+ #define SDL_SIMD_ALIGNED 0x00000008 /**< Surface uses aligned memory */
57
+ /* @} *//* Surface flags */
58
+
59
+ /**
60
+ * Evaluates to true if the surface needs to be locked before access.
61
+ */
62
+ #define SDL_MUSTLOCK(S) (((S)->flags & SDL_RLEACCEL) != 0)
63
+
64
+ /**
65
+ * \brief A collection of pixels used in software blitting.
66
+ *
67
+ * \note This structure should be treated as read-only, except for \c pixels,
68
+ * which, if not NULL, contains the raw pixel data for the surface.
69
+ */
70
+ typedef struct SDL_Surface
71
+ {
72
+ Uint32 flags; /**< Read-only */
73
+ SDL_PixelFormat *format; /**< Read-only */
74
+ int w, h; /**< Read-only */
75
+ int pitch; /**< Read-only */
76
+ void *pixels; /**< Read-write */
77
+
78
+ /** Application data associated with the surface */
79
+ void *userdata; /**< Read-write */
80
+
81
+ /** information needed for surfaces requiring locks */
82
+ int locked; /**< Read-only */
83
+
84
+ /** list of BlitMap that hold a reference to this surface */
85
+ void *list_blitmap; /**< Private */
86
+
87
+ /** clipping information */
88
+ SDL_Rect clip_rect; /**< Read-only */
89
+
90
+ /** info for fast blit mapping to other surfaces */
91
+ struct SDL_BlitMap *map; /**< Private */
92
+
93
+ /** Reference count -- used when freeing surface */
94
+ int refcount; /**< Read-mostly */
95
+ } SDL_Surface;
96
+
97
+ /**
98
+ * \brief The type of function used for surface blitting functions.
99
+ */
100
+ typedef int (SDLCALL *SDL_blit) (struct SDL_Surface * src, SDL_Rect * srcrect,
101
+ struct SDL_Surface * dst, SDL_Rect * dstrect);
102
+
103
+ /**
104
+ * \brief The formula used for converting between YUV and RGB
105
+ */
106
+ typedef enum
107
+ {
108
+ SDL_YUV_CONVERSION_JPEG, /**< Full range JPEG */
109
+ SDL_YUV_CONVERSION_BT601, /**< BT.601 (the default) */
110
+ SDL_YUV_CONVERSION_BT709, /**< BT.709 */
111
+ SDL_YUV_CONVERSION_AUTOMATIC /**< BT.601 for SD content, BT.709 for HD content */
112
+ } SDL_YUV_CONVERSION_MODE;
113
+
114
+ /**
115
+ * Allocate and free an RGB surface.
116
+ *
117
+ * If the depth is 4 or 8 bits, an empty palette is allocated for the surface.
118
+ * If the depth is greater than 8 bits, the pixel format is set using the
119
+ * flags '[RGB]mask'.
120
+ *
121
+ * If the function runs out of memory, it will return NULL.
122
+ *
123
+ * \param flags The \c flags are obsolete and should be set to 0.
124
+ * \param width The width in pixels of the surface to create.
125
+ * \param height The height in pixels of the surface to create.
126
+ * \param depth The depth in bits of the surface to create.
127
+ * \param Rmask The red mask of the surface to create.
128
+ * \param Gmask The green mask of the surface to create.
129
+ * \param Bmask The blue mask of the surface to create.
130
+ * \param Amask The alpha mask of the surface to create.
131
+ */
132
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_CreateRGBSurface
133
+ (Uint32 flags, int width, int height, int depth,
134
+ Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 Amask);
135
+
136
+ /* !!! FIXME for 2.1: why does this ask for depth? Format provides that. */
137
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_CreateRGBSurfaceWithFormat
138
+ (Uint32 flags, int width, int height, int depth, Uint32 format);
139
+
140
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_CreateRGBSurfaceFrom(void *pixels,
141
+ int width,
142
+ int height,
143
+ int depth,
144
+ int pitch,
145
+ Uint32 Rmask,
146
+ Uint32 Gmask,
147
+ Uint32 Bmask,
148
+ Uint32 Amask);
149
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_CreateRGBSurfaceWithFormatFrom
150
+ (void *pixels, int width, int height, int depth, int pitch, Uint32 format);
151
+ extern DECLSPEC void SDLCALL SDL_FreeSurface(SDL_Surface * surface);
152
+
153
+ /**
154
+ * \brief Set the palette used by a surface.
155
+ *
156
+ * \return 0, or -1 if the surface format doesn't use a palette.
157
+ *
158
+ * \note A single palette can be shared with many surfaces.
159
+ */
160
+ extern DECLSPEC int SDLCALL SDL_SetSurfacePalette(SDL_Surface * surface,
161
+ SDL_Palette * palette);
162
+
163
+ /**
164
+ * \brief Sets up a surface for directly accessing the pixels.
165
+ *
166
+ * Between calls to SDL_LockSurface() / SDL_UnlockSurface(), you can write
167
+ * to and read from \c surface->pixels, using the pixel format stored in
168
+ * \c surface->format. Once you are done accessing the surface, you should
169
+ * use SDL_UnlockSurface() to release it.
170
+ *
171
+ * Not all surfaces require locking. If SDL_MUSTLOCK(surface) evaluates
172
+ * to 0, then you can read and write to the surface at any time, and the
173
+ * pixel format of the surface will not change.
174
+ *
175
+ * No operating system or library calls should be made between lock/unlock
176
+ * pairs, as critical system locks may be held during this time.
177
+ *
178
+ * SDL_LockSurface() returns 0, or -1 if the surface couldn't be locked.
179
+ *
180
+ * \sa SDL_UnlockSurface()
181
+ */
182
+ extern DECLSPEC int SDLCALL SDL_LockSurface(SDL_Surface * surface);
183
+ /** \sa SDL_LockSurface() */
184
+ extern DECLSPEC void SDLCALL SDL_UnlockSurface(SDL_Surface * surface);
185
+
186
+ /**
187
+ * Load a surface from a seekable SDL data stream (memory or file).
188
+ *
189
+ * If \c freesrc is non-zero, the stream will be closed after being read.
190
+ *
191
+ * The new surface should be freed with SDL_FreeSurface().
192
+ *
193
+ * \return the new surface, or NULL if there was an error.
194
+ */
195
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_LoadBMP_RW(SDL_RWops * src,
196
+ int freesrc);
197
+
198
+ /**
199
+ * Load a surface from a file.
200
+ *
201
+ * Convenience macro.
202
+ */
203
+ #define SDL_LoadBMP(file) SDL_LoadBMP_RW(SDL_RWFromFile(file, "rb"), 1)
204
+
205
+ /**
206
+ * Save a surface to a seekable SDL data stream (memory or file).
207
+ *
208
+ * Surfaces with a 24-bit, 32-bit and paletted 8-bit format get saved in the
209
+ * BMP directly. Other RGB formats with 8-bit or higher get converted to a
210
+ * 24-bit surface or, if they have an alpha mask or a colorkey, to a 32-bit
211
+ * surface before they are saved. YUV and paletted 1-bit and 4-bit formats are
212
+ * not supported.
213
+ *
214
+ * If \c freedst is non-zero, the stream will be closed after being written.
215
+ *
216
+ * \return 0 if successful or -1 if there was an error.
217
+ */
218
+ extern DECLSPEC int SDLCALL SDL_SaveBMP_RW
219
+ (SDL_Surface * surface, SDL_RWops * dst, int freedst);
220
+
221
+ /**
222
+ * Save a surface to a file.
223
+ *
224
+ * Convenience macro.
225
+ */
226
+ #define SDL_SaveBMP(surface, file) \
227
+ SDL_SaveBMP_RW(surface, SDL_RWFromFile(file, "wb"), 1)
228
+
229
+ /**
230
+ * \brief Sets the RLE acceleration hint for a surface.
231
+ *
232
+ * \return 0 on success, or -1 if the surface is not valid
233
+ *
234
+ * \note If RLE is enabled, colorkey and alpha blending blits are much faster,
235
+ * but the surface must be locked before directly accessing the pixels.
236
+ */
237
+ extern DECLSPEC int SDLCALL SDL_SetSurfaceRLE(SDL_Surface * surface,
238
+ int flag);
239
+
240
+ /**
241
+ * \brief Returns whether the surface is RLE enabled
242
+ *
243
+ * \return SDL_TRUE if the surface is RLE enabled, or SDL_FALSE if the surface is NULL or not RLE enabled
244
+ */
245
+ extern DECLSPEC SDL_bool SDLCALL SDL_HasSurfaceRLE(SDL_Surface * surface);
246
+
247
+ /**
248
+ * \brief Sets the color key (transparent pixel) in a blittable surface.
249
+ *
250
+ * \param surface The surface to update
251
+ * \param flag Non-zero to enable colorkey and 0 to disable colorkey
252
+ * \param key The transparent pixel in the native surface format
253
+ *
254
+ * \return 0 on success, or -1 if the surface is not valid
255
+ *
256
+ * You can pass SDL_RLEACCEL to enable RLE accelerated blits.
257
+ */
258
+ extern DECLSPEC int SDLCALL SDL_SetColorKey(SDL_Surface * surface,
259
+ int flag, Uint32 key);
260
+
261
+ /**
262
+ * \brief Returns whether the surface has a color key
263
+ *
264
+ * \return SDL_TRUE if the surface has a color key, or SDL_FALSE if the surface is NULL or has no color key
265
+ */
266
+ extern DECLSPEC SDL_bool SDLCALL SDL_HasColorKey(SDL_Surface * surface);
267
+
268
+ /**
269
+ * \brief Gets the color key (transparent pixel) in a blittable surface.
270
+ *
271
+ * \param surface The surface to update
272
+ * \param key A pointer filled in with the transparent pixel in the native
273
+ * surface format
274
+ *
275
+ * \return 0 on success, or -1 if the surface is not valid or colorkey is not
276
+ * enabled.
277
+ */
278
+ extern DECLSPEC int SDLCALL SDL_GetColorKey(SDL_Surface * surface,
279
+ Uint32 * key);
280
+
281
+ /**
282
+ * \brief Set an additional color value used in blit operations.
283
+ *
284
+ * \param surface The surface to update.
285
+ * \param r The red color value multiplied into blit operations.
286
+ * \param g The green color value multiplied into blit operations.
287
+ * \param b The blue color value multiplied into blit operations.
288
+ *
289
+ * \return 0 on success, or -1 if the surface is not valid.
290
+ *
291
+ * \sa SDL_GetSurfaceColorMod()
292
+ */
293
+ extern DECLSPEC int SDLCALL SDL_SetSurfaceColorMod(SDL_Surface * surface,
294
+ Uint8 r, Uint8 g, Uint8 b);
295
+
296
+
297
+ /**
298
+ * \brief Get the additional color value used in blit operations.
299
+ *
300
+ * \param surface The surface to query.
301
+ * \param r A pointer filled in with the current red color value.
302
+ * \param g A pointer filled in with the current green color value.
303
+ * \param b A pointer filled in with the current blue color value.
304
+ *
305
+ * \return 0 on success, or -1 if the surface is not valid.
306
+ *
307
+ * \sa SDL_SetSurfaceColorMod()
308
+ */
309
+ extern DECLSPEC int SDLCALL SDL_GetSurfaceColorMod(SDL_Surface * surface,
310
+ Uint8 * r, Uint8 * g,
311
+ Uint8 * b);
312
+
313
+ /**
314
+ * \brief Set an additional alpha value used in blit operations.
315
+ *
316
+ * \param surface The surface to update.
317
+ * \param alpha The alpha value multiplied into blit operations.
318
+ *
319
+ * \return 0 on success, or -1 if the surface is not valid.
320
+ *
321
+ * \sa SDL_GetSurfaceAlphaMod()
322
+ */
323
+ extern DECLSPEC int SDLCALL SDL_SetSurfaceAlphaMod(SDL_Surface * surface,
324
+ Uint8 alpha);
325
+
326
+ /**
327
+ * \brief Get the additional alpha value used in blit operations.
328
+ *
329
+ * \param surface The surface to query.
330
+ * \param alpha A pointer filled in with the current alpha value.
331
+ *
332
+ * \return 0 on success, or -1 if the surface is not valid.
333
+ *
334
+ * \sa SDL_SetSurfaceAlphaMod()
335
+ */
336
+ extern DECLSPEC int SDLCALL SDL_GetSurfaceAlphaMod(SDL_Surface * surface,
337
+ Uint8 * alpha);
338
+
339
+ /**
340
+ * \brief Set the blend mode used for blit operations.
341
+ *
342
+ * \param surface The surface to update.
343
+ * \param blendMode ::SDL_BlendMode to use for blit blending.
344
+ *
345
+ * \return 0 on success, or -1 if the parameters are not valid.
346
+ *
347
+ * \sa SDL_GetSurfaceBlendMode()
348
+ */
349
+ extern DECLSPEC int SDLCALL SDL_SetSurfaceBlendMode(SDL_Surface * surface,
350
+ SDL_BlendMode blendMode);
351
+
352
+ /**
353
+ * \brief Get the blend mode used for blit operations.
354
+ *
355
+ * \param surface The surface to query.
356
+ * \param blendMode A pointer filled in with the current blend mode.
357
+ *
358
+ * \return 0 on success, or -1 if the surface is not valid.
359
+ *
360
+ * \sa SDL_SetSurfaceBlendMode()
361
+ */
362
+ extern DECLSPEC int SDLCALL SDL_GetSurfaceBlendMode(SDL_Surface * surface,
363
+ SDL_BlendMode *blendMode);
364
+
365
+ /**
366
+ * Sets the clipping rectangle for the destination surface in a blit.
367
+ *
368
+ * If the clip rectangle is NULL, clipping will be disabled.
369
+ *
370
+ * If the clip rectangle doesn't intersect the surface, the function will
371
+ * return SDL_FALSE and blits will be completely clipped. Otherwise the
372
+ * function returns SDL_TRUE and blits to the surface will be clipped to
373
+ * the intersection of the surface area and the clipping rectangle.
374
+ *
375
+ * Note that blits are automatically clipped to the edges of the source
376
+ * and destination surfaces.
377
+ */
378
+ extern DECLSPEC SDL_bool SDLCALL SDL_SetClipRect(SDL_Surface * surface,
379
+ const SDL_Rect * rect);
380
+
381
+ /**
382
+ * Gets the clipping rectangle for the destination surface in a blit.
383
+ *
384
+ * \c rect must be a pointer to a valid rectangle which will be filled
385
+ * with the correct values.
386
+ */
387
+ extern DECLSPEC void SDLCALL SDL_GetClipRect(SDL_Surface * surface,
388
+ SDL_Rect * rect);
389
+
390
+ /*
391
+ * Creates a new surface identical to the existing surface
392
+ */
393
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_DuplicateSurface(SDL_Surface * surface);
394
+
395
+ /**
396
+ * Creates a new surface of the specified format, and then copies and maps
397
+ * the given surface to it so the blit of the converted surface will be as
398
+ * fast as possible. If this function fails, it returns NULL.
399
+ *
400
+ * The \c flags parameter is passed to SDL_CreateRGBSurface() and has those
401
+ * semantics. You can also pass ::SDL_RLEACCEL in the flags parameter and
402
+ * SDL will try to RLE accelerate colorkey and alpha blits in the resulting
403
+ * surface.
404
+ */
405
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_ConvertSurface
406
+ (SDL_Surface * src, const SDL_PixelFormat * fmt, Uint32 flags);
407
+ extern DECLSPEC SDL_Surface *SDLCALL SDL_ConvertSurfaceFormat
408
+ (SDL_Surface * src, Uint32 pixel_format, Uint32 flags);
409
+
410
+ /**
411
+ * \brief Copy a block of pixels of one format to another format
412
+ *
413
+ * \return 0 on success, or -1 if there was an error
414
+ */
415
+ extern DECLSPEC int SDLCALL SDL_ConvertPixels(int width, int height,
416
+ Uint32 src_format,
417
+ const void * src, int src_pitch,
418
+ Uint32 dst_format,
419
+ void * dst, int dst_pitch);
420
+
421
+ /**
422
+ * Performs a fast fill of the given rectangle with \c color.
423
+ *
424
+ * If \c rect is NULL, the whole surface will be filled with \c color.
425
+ *
426
+ * The color should be a pixel of the format used by the surface, and
427
+ * can be generated by the SDL_MapRGB() function.
428
+ *
429
+ * \return 0 on success, or -1 on error.
430
+ */
431
+ extern DECLSPEC int SDLCALL SDL_FillRect
432
+ (SDL_Surface * dst, const SDL_Rect * rect, Uint32 color);
433
+ extern DECLSPEC int SDLCALL SDL_FillRects
434
+ (SDL_Surface * dst, const SDL_Rect * rects, int count, Uint32 color);
435
+
436
+ /**
437
+ * Performs a fast blit from the source surface to the destination surface.
438
+ *
439
+ * This assumes that the source and destination rectangles are
440
+ * the same size. If either \c srcrect or \c dstrect are NULL, the entire
441
+ * surface (\c src or \c dst) is copied. The final blit rectangles are saved
442
+ * in \c srcrect and \c dstrect after all clipping is performed.
443
+ *
444
+ * \return If the blit is successful, it returns 0, otherwise it returns -1.
445
+ *
446
+ * The blit function should not be called on a locked surface.
447
+ *
448
+ * The blit semantics for surfaces with and without blending and colorkey
449
+ * are defined as follows:
450
+ * \verbatim
451
+ RGBA->RGB:
452
+ Source surface blend mode set to SDL_BLENDMODE_BLEND:
453
+ alpha-blend (using the source alpha-channel and per-surface alpha)
454
+ SDL_SRCCOLORKEY ignored.
455
+ Source surface blend mode set to SDL_BLENDMODE_NONE:
456
+ copy RGB.
457
+ if SDL_SRCCOLORKEY set, only copy the pixels matching the
458
+ RGB values of the source color key, ignoring alpha in the
459
+ comparison.
460
+
461
+ RGB->RGBA:
462
+ Source surface blend mode set to SDL_BLENDMODE_BLEND:
463
+ alpha-blend (using the source per-surface alpha)
464
+ Source surface blend mode set to SDL_BLENDMODE_NONE:
465
+ copy RGB, set destination alpha to source per-surface alpha value.
466
+ both:
467
+ if SDL_SRCCOLORKEY set, only copy the pixels matching the
468
+ source color key.
469
+
470
+ RGBA->RGBA:
471
+ Source surface blend mode set to SDL_BLENDMODE_BLEND:
472
+ alpha-blend (using the source alpha-channel and per-surface alpha)
473
+ SDL_SRCCOLORKEY ignored.
474
+ Source surface blend mode set to SDL_BLENDMODE_NONE:
475
+ copy all of RGBA to the destination.
476
+ if SDL_SRCCOLORKEY set, only copy the pixels matching the
477
+ RGB values of the source color key, ignoring alpha in the
478
+ comparison.
479
+
480
+ RGB->RGB:
481
+ Source surface blend mode set to SDL_BLENDMODE_BLEND:
482
+ alpha-blend (using the source per-surface alpha)
483
+ Source surface blend mode set to SDL_BLENDMODE_NONE:
484
+ copy RGB.
485
+ both:
486
+ if SDL_SRCCOLORKEY set, only copy the pixels matching the
487
+ source color key.
488
+ \endverbatim
489
+ *
490
+ * You should call SDL_BlitSurface() unless you know exactly how SDL
491
+ * blitting works internally and how to use the other blit functions.
492
+ */
493
+ #define SDL_BlitSurface SDL_UpperBlit
494
+
495
+ /**
496
+ * This is the public blit function, SDL_BlitSurface(), and it performs
497
+ * rectangle validation and clipping before passing it to SDL_LowerBlit()
498
+ */
499
+ extern DECLSPEC int SDLCALL SDL_UpperBlit
500
+ (SDL_Surface * src, const SDL_Rect * srcrect,
501
+ SDL_Surface * dst, SDL_Rect * dstrect);
502
+
503
+ /**
504
+ * This is a semi-private blit function and it performs low-level surface
505
+ * blitting only.
506
+ */
507
+ extern DECLSPEC int SDLCALL SDL_LowerBlit
508
+ (SDL_Surface * src, SDL_Rect * srcrect,
509
+ SDL_Surface * dst, SDL_Rect * dstrect);
510
+
511
+ /**
512
+ * \brief Perform a fast, low quality, stretch blit between two surfaces of the
513
+ * same pixel format.
514
+ *
515
+ * \note This function uses a static buffer, and is not thread-safe.
516
+ */
517
+ extern DECLSPEC int SDLCALL SDL_SoftStretch(SDL_Surface * src,
518
+ const SDL_Rect * srcrect,
519
+ SDL_Surface * dst,
520
+ const SDL_Rect * dstrect);
521
+
522
+ #define SDL_BlitScaled SDL_UpperBlitScaled
523
+
524
+ /**
525
+ * This is the public scaled blit function, SDL_BlitScaled(), and it performs
526
+ * rectangle validation and clipping before passing it to SDL_LowerBlitScaled()
527
+ */
528
+ extern DECLSPEC int SDLCALL SDL_UpperBlitScaled
529
+ (SDL_Surface * src, const SDL_Rect * srcrect,
530
+ SDL_Surface * dst, SDL_Rect * dstrect);
531
+
532
+ /**
533
+ * This is a semi-private blit function and it performs low-level surface
534
+ * scaled blitting only.
535
+ */
536
+ extern DECLSPEC int SDLCALL SDL_LowerBlitScaled
537
+ (SDL_Surface * src, SDL_Rect * srcrect,
538
+ SDL_Surface * dst, SDL_Rect * dstrect);
539
+
540
+ /**
541
+ * \brief Set the YUV conversion mode
542
+ */
543
+ extern DECLSPEC void SDLCALL SDL_SetYUVConversionMode(SDL_YUV_CONVERSION_MODE mode);
544
+
545
+ /**
546
+ * \brief Get the YUV conversion mode
547
+ */
548
+ extern DECLSPEC SDL_YUV_CONVERSION_MODE SDLCALL SDL_GetYUVConversionMode(void);
549
+
550
+ /**
551
+ * \brief Get the YUV conversion mode, returning the correct mode for the resolution when the current conversion mode is SDL_YUV_CONVERSION_AUTOMATIC
552
+ */
553
+ extern DECLSPEC SDL_YUV_CONVERSION_MODE SDLCALL SDL_GetYUVConversionModeForResolution(int width, int height);
554
+
555
+ /* Ends C function definitions when using C++ */
556
+ #ifdef __cplusplus
557
+ }
558
+ #endif
559
+ #include "close_code.h"
560
+
561
+ #endif /* SDL_surface_h_ */
562
+
563
+ /* vi: set ts=4 sw=4 expandtab: */