Permalink
Browse files

added SDL development files for Windows

  • Loading branch information...
1 parent f252c70 commit 50ad45e334cfa8fe0cd205f838e7c18bde38d1c0 @ETLegacyTransifexRobot ETLegacyTransifexRobot committed Jun 19, 2012
Showing with 76,122 additions and 7 deletions.
  1. +38 −7 CMakeLists.txt
  2. +18 −0 sdl-windows/BUGS.txt
  3. +458 −0 sdl-windows/COPYING.txt
  4. +13 −0 sdl-windows/README-SDL.txt
  5. +49 −0 sdl-windows/README.txt
  6. +159 −0 sdl-windows/VisualC.html
  7. +727 −0 sdl-windows/WhatsNew.txt
  8. +698 −0 sdl-windows/docs.html
  9. +242 −0 sdl-windows/docs/html/audio.html
  10. +260 −0 sdl-windows/docs/html/cdrom.html
  11. +216 −0 sdl-windows/docs/html/event.html
  12. +481 −0 sdl-windows/docs/html/eventfunctions.html
  13. +233 −0 sdl-windows/docs/html/eventstructures.html
  14. +225 −0 sdl-windows/docs/html/general.html
  15. +174 −0 sdl-windows/docs/html/guide.html
  16. +148 −0 sdl-windows/docs/html/guideaboutsdldoc.html
  17. +228 −0 sdl-windows/docs/html/guideaudioexamples.html
  18. +240 −0 sdl-windows/docs/html/guidebasicsinit.html
  19. +275 −0 sdl-windows/docs/html/guidecdromexamples.html
  20. +195 −0 sdl-windows/docs/html/guidecredits.html
  21. +247 −0 sdl-windows/docs/html/guideeventexamples.html
  22. +188 −0 sdl-windows/docs/html/guideexamples.html
  23. +739 −0 sdl-windows/docs/html/guideinput.html
  24. +746 −0 sdl-windows/docs/html/guideinputkeyboard.html
  25. +178 −0 sdl-windows/docs/html/guidepreface.html
  26. +173 −0 sdl-windows/docs/html/guidethebasics.html
  27. +183 −0 sdl-windows/docs/html/guidetimeexamples.html
  28. +463 −0 sdl-windows/docs/html/guidevideo.html
  29. +730 −0 sdl-windows/docs/html/guidevideoopengl.html
  30. +1,156 −0 sdl-windows/docs/html/index.html
  31. +296 −0 sdl-windows/docs/html/joystick.html
  32. +194 −0 sdl-windows/docs/html/reference.html
  33. +335 −0 sdl-windows/docs/html/sdlactiveevent.html
  34. +296 −0 sdl-windows/docs/html/sdladdtimer.html
  35. +556 −0 sdl-windows/docs/html/sdlaudiocvt.html
  36. +589 −0 sdl-windows/docs/html/sdlaudiospec.html
  37. +339 −0 sdl-windows/docs/html/sdlblitsurface.html
  38. +291 −0 sdl-windows/docs/html/sdlbuildaudiocvt.html
  39. +359 −0 sdl-windows/docs/html/sdlcd.html
  40. +217 −0 sdl-windows/docs/html/sdlcdclose.html
  41. +226 −0 sdl-windows/docs/html/sdlcdeject.html
  42. +239 −0 sdl-windows/docs/html/sdlcdname.html
  43. +205 −0 sdl-windows/docs/html/sdlcdnumdrives.html
  44. +275 −0 sdl-windows/docs/html/sdlcdopen.html
  45. +233 −0 sdl-windows/docs/html/sdlcdpause.html
  46. +243 −0 sdl-windows/docs/html/sdlcdplay.html
  47. +325 −0 sdl-windows/docs/html/sdlcdplaytracks.html
  48. +233 −0 sdl-windows/docs/html/sdlcdresume.html
  49. +273 −0 sdl-windows/docs/html/sdlcdstatus.html
  50. +226 −0 sdl-windows/docs/html/sdlcdstop.html
  51. +313 −0 sdl-windows/docs/html/sdlcdtrack.html
  52. +205 −0 sdl-windows/docs/html/sdlcloseaudio.html
  53. +300 −0 sdl-windows/docs/html/sdlcolor.html
  54. +224 −0 sdl-windows/docs/html/sdlcondbroadcast.html
  55. +224 −0 sdl-windows/docs/html/sdlcondsignal.html
  56. +231 −0 sdl-windows/docs/html/sdlcondwait.html
  57. +230 −0 sdl-windows/docs/html/sdlcondwaittimeout.html
  58. +407 −0 sdl-windows/docs/html/sdlconvertaudio.html
  59. +271 −0 sdl-windows/docs/html/sdlconvertsurface.html
  60. +240 −0 sdl-windows/docs/html/sdlcreatecond.html
  61. +398 −0 sdl-windows/docs/html/sdlcreatecursor.html
  62. +249 −0 sdl-windows/docs/html/sdlcreatemutex.html
  63. +458 −0 sdl-windows/docs/html/sdlcreatergbsurface.html
  64. +256 −0 sdl-windows/docs/html/sdlcreatergbsurfacefrom.html
  65. +303 −0 sdl-windows/docs/html/sdlcreatesemaphore.html
  66. +223 −0 sdl-windows/docs/html/sdlcreatethread.html
  67. +256 −0 sdl-windows/docs/html/sdlcreateyuvoverlay.html
  68. +231 −0 sdl-windows/docs/html/sdldelay.html
  69. +206 −0 sdl-windows/docs/html/sdldestroycond.html
  70. +209 −0 sdl-windows/docs/html/sdldestroymutex.html
  71. +278 −0 sdl-windows/docs/html/sdldestroysemaphore.html
  72. +262 −0 sdl-windows/docs/html/sdldisplayformat.html
  73. +250 −0 sdl-windows/docs/html/sdldisplayformatalpha.html
  74. +246 −0 sdl-windows/docs/html/sdldisplayyuvoverlay.html
  75. +238 −0 sdl-windows/docs/html/sdlenablekeyrepeat.html
  76. +252 −0 sdl-windows/docs/html/sdlenableunicode.html
  77. +1,227 −0 sdl-windows/docs/html/sdlenvvars.html
  78. +994 −0 sdl-windows/docs/html/sdlevent.html
  79. +276 −0 sdl-windows/docs/html/sdleventstate.html
  80. +252 −0 sdl-windows/docs/html/sdlexposeevent.html
  81. +291 −0 sdl-windows/docs/html/sdlfillrect.html
  82. +259 −0 sdl-windows/docs/html/sdlflip.html
  83. +209 −0 sdl-windows/docs/html/sdlfreecursor.html
  84. +219 −0 sdl-windows/docs/html/sdlfreesurface.html
  85. +222 −0 sdl-windows/docs/html/sdlfreewav.html
  86. +233 −0 sdl-windows/docs/html/sdlfreeyuvoverlay.html
  87. +263 −0 sdl-windows/docs/html/sdlgetappstate.html
  88. +221 −0 sdl-windows/docs/html/sdlgetaudiostatus.html
  89. +229 −0 sdl-windows/docs/html/sdlgetcliprect.html
  90. +219 −0 sdl-windows/docs/html/sdlgetcursor.html
  91. +205 −0 sdl-windows/docs/html/sdlgeterror.html
  92. +235 −0 sdl-windows/docs/html/sdlgeteventfilter.html
  93. +219 −0 sdl-windows/docs/html/sdlgetgammaramp.html
  94. +216 −0 sdl-windows/docs/html/sdlgetkeyname.html
  95. +253 −0 sdl-windows/docs/html/sdlgetkeystate.html
  96. +257 −0 sdl-windows/docs/html/sdlgetmodstate.html
  97. +253 −0 sdl-windows/docs/html/sdlgetmousestate.html
  98. +235 −0 sdl-windows/docs/html/sdlgetrelativemousestate.html
  99. +231 −0 sdl-windows/docs/html/sdlgetrgb.html
  100. +222 −0 sdl-windows/docs/html/sdlgetrgba.html
  101. +209 −0 sdl-windows/docs/html/sdlgetthreadid.html
  102. +206 −0 sdl-windows/docs/html/sdlgetticks.html
  103. +226 −0 sdl-windows/docs/html/sdlgetvideoinfo.html
  104. +208 −0 sdl-windows/docs/html/sdlgetvideosurface.html
  105. +379 −0 sdl-windows/docs/html/sdlglattr.html
  106. +247 −0 sdl-windows/docs/html/sdlglgetattribute.html
  107. +262 −0 sdl-windows/docs/html/sdlglgetprocaddress.html
  108. +231 −0 sdl-windows/docs/html/sdlglloadlibrary.html
  109. +286 −0 sdl-windows/docs/html/sdlglsetattribute.html
  110. +212 −0 sdl-windows/docs/html/sdlglswapbuffers.html
  111. +368 −0 sdl-windows/docs/html/sdlinit.html
  112. +283 −0 sdl-windows/docs/html/sdlinitsubsystem.html
  113. +330 −0 sdl-windows/docs/html/sdljoyaxisevent.html
  114. +340 −0 sdl-windows/docs/html/sdljoyballevent.html
  115. +351 −0 sdl-windows/docs/html/sdljoybuttonevent.html
  116. +413 −0 sdl-windows/docs/html/sdljoyhatevent.html
  117. +223 −0 sdl-windows/docs/html/sdljoystickclose.html
  118. +290 −0 sdl-windows/docs/html/sdljoystickeventstate.html
  119. +271 −0 sdl-windows/docs/html/sdljoystickgetaxis.html
  120. +262 −0 sdl-windows/docs/html/sdljoystickgetball.html
  121. +231 −0 sdl-windows/docs/html/sdljoystickgetbutton.html
  122. +297 −0 sdl-windows/docs/html/sdljoystickgethat.html
  123. +218 −0 sdl-windows/docs/html/sdljoystickindex.html
  124. +238 −0 sdl-windows/docs/html/sdljoystickname.html
  125. +225 −0 sdl-windows/docs/html/sdljoysticknumaxes.html
  126. +225 −0 sdl-windows/docs/html/sdljoysticknumballs.html
  127. +225 −0 sdl-windows/docs/html/sdljoysticknumbuttons.html
  128. +225 −0 sdl-windows/docs/html/sdljoysticknumhats.html
  129. +259 −0 sdl-windows/docs/html/sdljoystickopen.html
  130. +233 −0 sdl-windows/docs/html/sdljoystickopened.html
  131. +211 −0 sdl-windows/docs/html/sdljoystickupdate.html
  132. +2,630 −0 sdl-windows/docs/html/sdlkey.html
  133. +375 −0 sdl-windows/docs/html/sdlkeyboardevent.html
  134. +355 −0 sdl-windows/docs/html/sdlkeysym.html
  135. +223 −0 sdl-windows/docs/html/sdlkillthread.html
  136. +310 −0 sdl-windows/docs/html/sdllistmodes.html
  137. +219 −0 sdl-windows/docs/html/sdlloadbmp.html
  138. +296 −0 sdl-windows/docs/html/sdlloadwav.html
  139. +208 −0 sdl-windows/docs/html/sdllockaudio.html
  140. +306 −0 sdl-windows/docs/html/sdllocksurface.html
  141. +252 −0 sdl-windows/docs/html/sdllockyuvoverlay.html
  142. +254 −0 sdl-windows/docs/html/sdlmaprgb.html
  143. +242 −0 sdl-windows/docs/html/sdlmaprgba.html
  144. +237 −0 sdl-windows/docs/html/sdlmixaudio.html
  145. +346 −0 sdl-windows/docs/html/sdlmousebuttonevent.html
  146. +365 −0 sdl-windows/docs/html/sdlmousemotionevent.html
  147. +241 −0 sdl-windows/docs/html/sdlmutexp.html
  148. +235 −0 sdl-windows/docs/html/sdlmutexv.html
  149. +222 −0 sdl-windows/docs/html/sdlnumjoysticks.html
  150. +578 −0 sdl-windows/docs/html/sdlopenaudio.html
  151. +362 −0 sdl-windows/docs/html/sdloverlay.html
  152. +301 −0 sdl-windows/docs/html/sdlpalette.html
  153. +221 −0 sdl-windows/docs/html/sdlpauseaudio.html
  154. +321 −0 sdl-windows/docs/html/sdlpeepevents.html
  155. +528 −0 sdl-windows/docs/html/sdlpixelformat.html
  156. +269 −0 sdl-windows/docs/html/sdlpollevent.html
  157. +244 −0 sdl-windows/docs/html/sdlpumpevents.html
  158. +266 −0 sdl-windows/docs/html/sdlpushevent.html
  159. +244 −0 sdl-windows/docs/html/sdlquit.html
  160. +263 −0 sdl-windows/docs/html/sdlquitevent.html
  161. +248 −0 sdl-windows/docs/html/sdlquitsubsystem.html
  162. +258 −0 sdl-windows/docs/html/sdlrect.html
  163. +236 −0 sdl-windows/docs/html/sdlremovetimer.html
  164. +307 −0 sdl-windows/docs/html/sdlresizeevent.html
  165. +236 −0 sdl-windows/docs/html/sdlsavebmp.html
  166. +299 −0 sdl-windows/docs/html/sdlsempost.html
  167. +319 −0 sdl-windows/docs/html/sdlsemtrywait.html
  168. +273 −0 sdl-windows/docs/html/sdlsemvalue.html
  169. +298 −0 sdl-windows/docs/html/sdlsemwait.html
  170. +322 −0 sdl-windows/docs/html/sdlsemwaittimeout.html
  171. +500 −0 sdl-windows/docs/html/sdlsetalpha.html
  172. +241 −0 sdl-windows/docs/html/sdlsetcliprect.html
  173. +321 −0 sdl-windows/docs/html/sdlsetcolorkey.html
  174. +358 −0 sdl-windows/docs/html/sdlsetcolors.html
  175. +222 −0 sdl-windows/docs/html/sdlsetcursor.html
  176. +284 −0 sdl-windows/docs/html/sdlseteventfilter.html
  177. +231 −0 sdl-windows/docs/html/sdlsetgamma.html
  178. +230 −0 sdl-windows/docs/html/sdlsetgammaramp.html
  179. +237 −0 sdl-windows/docs/html/sdlsetmodstate.html
  180. +352 −0 sdl-windows/docs/html/sdlsetpalette.html
  181. +267 −0 sdl-windows/docs/html/sdlsettimer.html
  182. +558 −0 sdl-windows/docs/html/sdlsetvideomode.html
  183. +239 −0 sdl-windows/docs/html/sdlshowcursor.html
  184. +597 −0 sdl-windows/docs/html/sdlsurface.html
  185. +233 −0 sdl-windows/docs/html/sdlsyswmevent.html
  186. +190 −0 sdl-windows/docs/html/sdlthreadid.html
  187. +211 −0 sdl-windows/docs/html/sdlunlockaudio.html
  188. +219 −0 sdl-windows/docs/html/sdlunlocksurface.html
  189. +225 −0 sdl-windows/docs/html/sdlunlockyuvoverlay.html
  190. +266 −0 sdl-windows/docs/html/sdlupdaterect.html
  191. +255 −0 sdl-windows/docs/html/sdlupdaterects.html
  192. +337 −0 sdl-windows/docs/html/sdluserevent.html
  193. +243 −0 sdl-windows/docs/html/sdlvideodrivername.html
  194. +408 −0 sdl-windows/docs/html/sdlvideoinfo.html
  195. +270 −0 sdl-windows/docs/html/sdlvideomodeok.html
  196. +231 −0 sdl-windows/docs/html/sdlwaitevent.html
  197. +231 −0 sdl-windows/docs/html/sdlwaitthread.html
  198. +205 −0 sdl-windows/docs/html/sdlwarpmouse.html
  199. +284 −0 sdl-windows/docs/html/sdlwasinit.html
  200. +222 −0 sdl-windows/docs/html/sdlwmgetcaption.html
  201. +224 −0 sdl-windows/docs/html/sdlwmgrabinput.html
  202. +211 −0 sdl-windows/docs/html/sdlwmiconifywindow.html
  203. +212 −0 sdl-windows/docs/html/sdlwmsetcaption.html
  204. +260 −0 sdl-windows/docs/html/sdlwmseticon.html
  205. +205 −0 sdl-windows/docs/html/sdlwmtogglefullscreen.html
  206. +313 −0 sdl-windows/docs/html/thread.html
  207. +206 −0 sdl-windows/docs/html/time.html
  208. +507 −0 sdl-windows/docs/html/video.html
  209. +188 −0 sdl-windows/docs/html/wm.html
  210. BIN sdl-windows/docs/images/rainbow.gif
  211. +55 −0 sdl-windows/docs/index.html
  212. +101 −0 sdl-windows/include/SDL.h
  213. +63 −0 sdl-windows/include/SDL_active.h
  214. +284 −0 sdl-windows/include/SDL_audio.h
  215. +29 −0 sdl-windows/include/SDL_byteorder.h
  216. +202 −0 sdl-windows/include/SDL_cdrom.h
  217. +45 −0 sdl-windows/include/SDL_config.h
  218. +106 −0 sdl-windows/include/SDL_config_dreamcast.h
  219. +112 −0 sdl-windows/include/SDL_config_macos.h
  220. +150 −0 sdl-windows/include/SDL_config_macosx.h
  221. +62 −0 sdl-windows/include/SDL_config_minimal.h
  222. +115 −0 sdl-windows/include/SDL_config_nds.h
  223. +141 −0 sdl-windows/include/SDL_config_os2.h
  224. +146 −0 sdl-windows/include/SDL_config_symbian.h
  225. +183 −0 sdl-windows/include/SDL_config_win32.h
  226. +22 −0 sdl-windows/include/SDL_copying.h
  227. +69 −0 sdl-windows/include/SDL_cpuinfo.h
  228. +214 −0 sdl-windows/include/SDL_endian.h
  229. +72 −0 sdl-windows/include/SDL_error.h
  230. +356 −0 sdl-windows/include/SDL_events.h
  231. +28 −0 sdl-windows/include/SDL_getenv.h
  232. +187 −0 sdl-windows/include/SDL_joystick.h
  233. +135 −0 sdl-windows/include/SDL_keyboard.h
  234. +326 −0 sdl-windows/include/SDL_keysym.h
  235. +78 −0 sdl-windows/include/SDL_loadso.h
  236. +106 −0 sdl-windows/include/SDL_main.h
  237. +143 −0 sdl-windows/include/SDL_mouse.h
  238. +177 −0 sdl-windows/include/SDL_mutex.h
  239. +11 −0 sdl-windows/include/SDL_name.h
  240. +6,570 −0 sdl-windows/include/SDL_opengl.h
  241. +110 −0 sdl-windows/include/SDL_platform.h
  242. +55 −0 sdl-windows/include/SDL_quit.h
  243. +155 −0 sdl-windows/include/SDL_rwops.h
  244. +620 −0 sdl-windows/include/SDL_stdinc.h
  245. +226 −0 sdl-windows/include/SDL_syswm.h
  246. +115 −0 sdl-windows/include/SDL_thread.h
  247. +125 −0 sdl-windows/include/SDL_timer.h
  248. +28 −0 sdl-windows/include/SDL_types.h
  249. +91 −0 sdl-windows/include/SDL_version.h
  250. +951 −0 sdl-windows/include/SDL_video.h
  251. +196 −0 sdl-windows/include/begin_code.h
  252. +46 −0 sdl-windows/include/close_code.h
  253. BIN sdl-windows/lib/x64/SDL.dll
  254. BIN sdl-windows/lib/x64/SDL.lib
  255. BIN sdl-windows/lib/x64/SDLmain.lib
  256. BIN sdl-windows/lib/x86/SDL.dll
  257. BIN sdl-windows/lib/x86/SDL.lib
  258. BIN sdl-windows/lib/x86/SDLmain.lib
View
@@ -1,5 +1,36 @@
if(WIN32)
- message(FATAL_ERROR "Sorry, building bundled libs is not yet supported on Windows.")
+ # FIXME: incomplete windows build with bundled libs
+
+ #-----------------------------------------------------------------
+ # Build bundled JPEG library
+ #-----------------------------------------------------------------
+ add_custom_command(OUTPUT ${CMAKE_SOURCE_DIR}/libs/jpeg/libjpeg.lib
+ COMMAND NMAKE /f makefile.vc setup-v10 && NMAKE /f makefile.vc
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}/libs/jpeg
+ )
+
+ add_custom_target(bundled_jpeg
+ DEPENDS ${CMAKE_SOURCE_DIR}/libs/jpeg/libjpeg.lib
+ )
+
+ #-----------------------------------------------------------------
+ # Build bundled cURL library
+ #-----------------------------------------------------------------
+ add_custom_command(OUTPUT ${CMAKE_SOURCE_DIR}/libs/curl/builds/libcurl-release-static-ipv6/lib/libcurl_a.lib
+ COMMAND NMAKE /f Makefile.vc mode=static USE_SSPI=no USE_IDN=no
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}/libs/curl/winbuild
+ )
+
+ add_custom_target(bundled_curl
+ DEPENDS ${CMAKE_SOURCE_DIR}/libs/curl/builds/libcurl-release-static-ipv6/lib/libcurl_a.lib
+ )
+
+ # return compiled libs to the parent CMakeLists.txt
+ set(BUNDLED_LIBRARIES "${CMAKE_SOURCE_DIR}/libs/curl/builds/libcurl-release-static-ipv6/lib/libcurl_a.lib"
+ "${CMAKE_SOURCE_DIR}/libs/jpeg/libjpeg.lib"
+ "${CMAKE_SOURCE_DIR}/libs/sdl-windows/lib/x86/SDL.lib"
+ "${CMAKE_SOURCE_DIR}/libs/sdl-windows/lib/x86/SDLmain.lib"
+ PARENT_SCOPE)
elseif(UNIX)
if(CROSS_COMPILE32)
set(CROSS_COMPILE32_FLAGS "CFLAGS=-m32 LDFLAGS=-m32")
@@ -48,10 +79,10 @@ elseif(UNIX)
"${CMAKE_SOURCE_DIR}/libs/jpeg/.libs/libjpeg.a"
"${CMAKE_SOURCE_DIR}/libs/sdl/build/.libs/libSDL.a"
PARENT_SCOPE)
-
- # return include dirs to the parent CMakeLists.txt
- set(BUNDLED_INCLUDE_DIRS "${CMAKE_SOURCE_DIR}/libs/curl/include"
- "${CMAKE_SOURCE_DIR}/libs/jpeg"
- "${CMAKE_SOURCE_DIR}/libs/sdl/include"
- PARENT_SCOPE)
endif()
+
+# return include dirs to the parent CMakeLists.txt
+set(BUNDLED_INCLUDE_DIRS "${CMAKE_SOURCE_DIR}/libs/curl/include"
+ "${CMAKE_SOURCE_DIR}/libs/jpeg"
+ "${CMAKE_SOURCE_DIR}/libs/sdl/include"
+ PARENT_SCOPE)
View
@@ -0,0 +1,18 @@
+
+Bugs are now managed in the SDL bug tracker, here:
+
+ http://bugzilla.libsdl.org/
+
+You may report bugs there, and search to see if a given issue has already
+ been reported, discussed, and maybe even fixed.
+
+
+
+You may also find help at the SDL mailing list. Subscription information:
+
+ http://lists.libsdl.org/listinfo.cgi/sdl-libsdl.org
+
+Bug reports are welcome here, but we really appreciate if you use Bugzilla, as
+ bugs discussed on the mailing list may be forgotten or missed.
+
+
Oops, something went wrong.
@@ -0,0 +1,13 @@
+
+Please distribute this file with the SDL runtime environment:
+
+The Simple DirectMedia Layer (SDL for short) is a cross-platfrom library
+designed to make it easy to write multi-media software, such as games and
+emulators.
+
+The Simple DirectMedia Layer library source code is available from:
+http://www.libsdl.org/
+
+This library is distributed under the terms of the GNU LGPL license:
+http://www.gnu.org/copyleft/lesser.html
+
@@ -0,0 +1,49 @@
+
+ Simple DirectMedia Layer
+
+ (SDL)
+
+ Version 1.2
+
+---
+http://www.libsdl.org/
+
+This is the Simple DirectMedia Layer, a general API that provides low
+level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL,
+and 2D framebuffer across multiple platforms.
+
+The current version supports Linux, Windows CE/95/98/ME/XP/Vista, BeOS,
+MacOS Classic, Mac OS X, FreeBSD, NetBSD, OpenBSD, BSD/OS, Solaris, IRIX,
+and QNX. The code contains support for Dreamcast, Atari, AIX, OSF/Tru64,
+RISC OS, SymbianOS, Nintendo DS, and OS/2, but these are not officially
+supported.
+
+SDL is written in C, but works with C++ natively, and has bindings to
+several other languages, including Ada, C#, Eiffel, Erlang, Euphoria,
+Guile, Haskell, Java, Lisp, Lua, ML, Objective C, Pascal, Perl, PHP,
+Pike, Pliant, Python, Ruby, and Smalltalk.
+
+This library is distributed under GNU LGPL version 2, which can be
+found in the file "COPYING". This license allows you to use SDL
+freely in commercial programs as long as you link with the dynamic
+library.
+
+The best way to learn how to use SDL is to check out the header files in
+the "include" subdirectory and the programs in the "test" subdirectory.
+The header files and test programs are well commented and always up to date.
+More documentation is available in HTML format in "docs/index.html", and
+a documentation wiki is available online at:
+ http://www.libsdl.org/cgi/docwiki.cgi
+
+The test programs in the "test" subdirectory are in the public domain.
+
+Frequently asked questions are answered online:
+ http://www.libsdl.org/faq.php
+
+If you need help with the library, or just want to discuss SDL related
+issues, you can join the developers mailing list:
+ http://www.libsdl.org/mailing-list.php
+
+Enjoy!
+ Sam Lantinga (slouken@libsdl.org)
+
@@ -0,0 +1,159 @@
+<HTML>
+ <HEAD>
+ <TITLE>Using SDL with Microsoft Visual C++</TITLE>
+ </HEAD>
+ <BODY>
+ <H1>
+ Using SDL with Microsoft Visual C++ 5,6&nbsp;and 7
+ </H1>
+ <H3>
+ by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro </A>and additions by <A HREF="mailto:james@conceptofzero.net">
+ James Turk</A>
+ </H3>
+ <p>
+ You can either use the precompiled libraries from <A HREF="http://www.libsdl.org/download.php">
+ the SDL Download web site </A>, or you can build SDL yourself.
+ </p>
+ <H3>
+ Building SDL
+ </H3>
+ <P>
+ Go into the VisualC
+ directory that is created, and double-click on the VC++ file "<CODE>SDL.dsw</CODE>"<STRONG><FONT color="#009900">
+ ("<CODE>SDL.sln</CODE>").</FONT></STRONG> This should open up the IDE.
+ </P>
+ <P>
+ You may be prompted at this point to upgrade the workspace, should you be using
+ a more recent version of Visual C++. If so, allow the workspace to be upgraded.
+ </P>
+ <P>
+ Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files.
+ </P>
+ <P>
+ This is done by right clicking on each project in turn (Projects are listed in
+ the Workspace panel in the FileView tab), and selecting "Build".
+ </P>
+ <P>
+ If you get an error about SDL_config.h being missing, you should
+ copy include/SDL_config.h.default to include/SDL_config.h and try again.
+ </P>
+ <P>
+ You may get a few warnings, but you should not get any errors. You do have to
+ have at least the DirectX 5 SDK installed, however. The latest
+ version of DirectX can be downloaded or purchased on a cheap CD (my
+ recommendation) from <A HREF="http://www.microsoft.com">Microsoft </A>.
+ </P>
+ <P>
+ Later, we will refer to the following .lib and .dll files that have just been
+ generated:
+ </P>
+ <ul>
+ <li> SDL.dll</li>
+ <li> SDL.lib</li>
+ <li> SDLmain.lib</li>
+ </ul>
+ <P>
+ Search for these using the Windows Find (Windows-F) utility, if you don't
+ already know where they should be. For those of you with a clue, look inside
+ the Debug or Release directories of the subdirectories of the Project folder.
+ (It might be easier to just use Windows Find if this sounds confusing. And
+ don't worry about needing a clue; we all need visits from the clue fairy
+ frequently.)
+ </P>
+ <H3>
+ Creating a Project with SDL
+ </H3>
+ <P>
+ Create a project as a Win32 Application.
+ </P>
+ <P>
+ Create a C++ file for your project.
+ </P>
+ <P>
+ Set the C runtime to "Multi-threaded DLL" in the menu: <CODE>Project|Settings|C/C++
+ tab|Code Generation|Runtime Library </CODE>.
+ </P>
+ <P>
+ Add the SDL <CODE>include</CODE> directory to your list of includes in the
+ menu: <CODE>Project|Settings|C/C++ tab|Preprocessor|Additional include directories </CODE>
+ .
+ <br>
+ <STRONG><FONT color="#009900">VC7 Specific: Instead of doing this I find it easier to
+ add the include and library directories to the list that VC7 keeps. Do this by
+ selecting Tools|Options|Projects|VC++ Directories and under the "Show
+ Directories For:" dropbox select "Include Files", and click the "New Directory
+ Icon" and add the [SDLROOT]\include directory (ex. If you installed to
+ c:\SDL-1.2.5\ add c:\SDL-1.2.5\include).&nbsp;Proceed to&nbsp;change the
+ dropbox selection to "Library Files" and add [SDLROOT]\lib.</FONT></STRONG>
+ </P>
+ <P>
+ The "include directory" I am referring to is the <CODE>include</CODE> folder
+ within the main SDL directory (the one that this HTML file located within).
+ </P>
+ <P>
+ Now we're going to use the files that we had created earlier in the Build SDL
+ step.
+ </P>
+ <P>
+ Copy the following files into your Project directory:
+ </P>
+ <ul>
+ <li> SDL.dll</li>
+ </ul>
+ <P>
+ Add the following files to your project (It is not necessary to copy them to
+ your project directory):
+ </P>
+ <ul>
+ <li> SDL.lib </li>
+ <li> SDLmain.lib</li>
+ </ul>
+ <P>
+ (To add them to your project, right click on your project, and select "Add
+ files to project")
+ </P>
+ <P><STRONG><FONT color="#009900">Instead of adding the files to your project it is more
+ desireable to add them to the linker options: Project|Properties|Linker|Command
+ Line and type the names of the libraries to link with in the "Additional
+ Options:" box.&nbsp; Note: This must be done&nbsp;for&nbsp;each&nbsp;build
+ configuration (eg. Release,Debug).</FONT></STRONG></P>
+ <H3>
+ SDL 101, First Day of Class
+ </H3>
+ <P>
+ Now create the basic body of your project. The body of your program should take
+ the following form: <CODE>
+ <PRE>
+#include "SDL.h"
+
+int main( int argc, char* argv[] )
+{
+ // Body of the program goes here.
+ return 0;
+}
+</PRE>
+ </CODE>
+ <P></P>
+ <H3>
+ That's it!
+ </H3>
+ <P>
+ I hope that this document has helped you get through the most difficult part of
+ using the SDL: installing it. Suggestions for improvements to this document
+ should be sent to the writers of this document.
+ </P>
+ <P>
+ Thanks to Paulus Esterhazy (pesterhazy@gmx.net), for the work on VC++ port.
+ </P>
+ <P>
+ This document was originally called "VisualC.txt", and was written by <A HREF="mailto:slouken@libsdl.org">
+ Sam Lantinga</A>.
+ </P>
+ <P>
+ Later, it was converted to HTML and expanded into the document that you see
+ today by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro</A>.
+ </P>
+ <P>Minor Fixes and Visual C++ 7 Information (In Green) was added by <A HREF="mailto:james@conceptofzero.net">James Turk</A>
+ </P>
+ </BODY>
+</HTML>
Oops, something went wrong.

0 comments on commit 50ad45e

Please sign in to comment.