Mercurial > sdl-ios-xcode
annotate README.Watcom @ 4773:590e680cc4e4
Fixed up new functions and files so that they build as part of SDL.
| author | Eli Gottlieb <eligottlieb@gmail.com> |
|---|---|
| date | Thu, 03 Jun 2010 17:21:40 -0400 |
| parents | 8c72321542f6 |
| children |
| rev | line source |
|---|---|
| 1773 | 1 |
| 3568 | 2 Using SDL 1.3 under Windows with the OpenWatcom compiler |
| 3 | |
| 1773 | 4 ==================================================== |
| 5 | |
| 6 Prerequisites | |
| 7 ------------- | |
| 8 | |
| 3568 | 9 I have done the port under Windows XP Professional with SP2 installed. |
| 10 Windows 2000 should also be working. I'm not so sure about ancient Windows NT, | |
| 1773 | 11 since only DirectX 3 is available there. Building should be possible, |
| 12 but running the compiled applications will probalbly fail with | |
| 13 SDL_VIDEODRIVER=directx. The windib driver should work, though. | |
| 14 | |
| 15 To compile and use the SDL with Open Watcom you will need the following: | |
| 3568 | 16 - Open Watcom compiler. I used version 1.8. The environment variables |
| 1773 | 17 PATH, WATCOM and INCLUDE need to be set appropriately - please consult |
| 18 the OpenWatcom documentation and instructions given during the | |
| 19 installation of the compiler. | |
| 20 My setup looks like this in owvars.bat: | |
| 3568 | 21 set WATCOM=C:\dev\ow18 |
| 1773 | 22 set INCLUDE=%WATCOM%\h;%WATCOM%\h\nt |
| 23 set PATH=%PATH%;%WATCOM%\binnt;%WATCOM%\binw | |
| 3568 | 24 - A recent DirectX SDK. The library needs D3d9.h so at leat the |
| 25 directx 9 sdk is to be used. I used DirectX 10 SDK from August 2009 | |
| 26 taken directly from the microsoft site. | |
| 27 - The SDL 1.3 sources from Subversion | |
| 1773 | 28 - The file Watcom-Win32.zip (now available in Subversion) |
| 29 | |
| 30 | |
| 31 Building the Library | |
| 32 -------------------- | |
| 33 | |
| 34 1) In the SDL base directory extract the archive Watcom-Win32.zip. This | |
| 35 creates a subdirectory named 'watcom'. | |
| 36 2) The makefile expects the environment variable DXDIR to be set to the | |
| 3568 | 37 base directory of a DirectX SDK. I have tried the August 2009 |
| 38 DirectX SDK from Microsoft | |
| 1773 | 39 You can also edit the makefile directly and hard code your path to |
| 40 the SDK on your system. | |
| 41 I have this in my setup: | |
| 3568 | 42 set DXDIR=..\dx10 |
| 1773 | 43 3) Enter the watcom directory and run |
| 44 wmake sdl | |
| 45 4) All tests from the test directory are working and can be built by | |
| 46 running | |
| 47 wmake tests | |
| 48 | |
| 49 Notes: | |
| 50 | |
| 51 The makefile offers some options to tweak the way the library is built. | |
| 52 You have at your disposal the option to build a static (default) | |
| 53 library, or a DLL (with tgt=dll). You can also choose whether to build | |
| 54 a Release (default) or a Debug version (with build=debug) of the tests | |
| 55 and library. Please consult the usage comment at the top of the | |
| 56 makefile for usage instructions. | |
| 57 | |
| 58 If you specify a test target (i.e. 'wmake tests' for all tests, or | |
| 59 selected targets like 'wmake testgl testvidinfo testoverlay2'), the | |
| 60 tests are always freshly compiled and linked. This is done to | |
| 61 minimise hassle when switching between library versions (static vs. | |
| 62 DLL), because they require subtly different options. | |
| 63 Also, the test executables are put directly into the test directory, | |
| 64 so they can find their data files. The clean target of the makefile | |
| 65 removes the test executables and the SDL.dll file from the test | |
| 66 directory. | |
| 67 | |
| 68 To use the library in your own projects with Open Watcom, you can use | |
| 69 the way the tests are built as base of your own build environment. | |
| 70 | |
|
1888
488eba319a25
------- Comment #5 From Marc Peter 2006-06-25 18:03 [reply] -------
Sam Lantinga <slouken@libsdl.org>
parents:
1773
diff
changeset
|
71 The library can also be built with the stack calling convention of the |
|
488eba319a25
------- Comment #5 From Marc Peter 2006-06-25 18:03 [reply] -------
Sam Lantinga <slouken@libsdl.org>
parents:
1773
diff
changeset
|
72 compiler (-6s instead of -6r). |
|
488eba319a25
------- Comment #5 From Marc Peter 2006-06-25 18:03 [reply] -------
Sam Lantinga <slouken@libsdl.org>
parents:
1773
diff
changeset
|
73 |
| 1773 | 74 Test applications |
| 75 ----------------- | |
| 3568 | 76 $FixME: which test works ? which one compiles ? |
| 1773 | 77 |
| 78 I've tried to make all tests work. The following table gives an overview | |
| 79 of the current status. | |
| 80 | |
| 81 Testname Status | |
| 82 ~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 83 checkkeys + | |
| 84 graywin + | |
| 85 loopwave + | |
| 86 testalpha + | |
| 87 testbitmap + | |
| 88 testdyngl + | |
| 89 testerror + | |
| 90 testfile + | |
| 91 testgamma + | |
| 92 testgl + | |
| 93 testhread + | |
| 94 testiconv - (all failed) | |
| 95 testkeys + | |
| 96 testlock + | |
| 97 testoverlay + (needs 'set SDL_VIDEODRIVER=directx') | |
| 98 testoverlay2 + (needs 'set SDL_VIDEODRIVER=directx') | |
| 99 testpalette + | |
| 100 testplatform + | |
| 101 testsem + | |
| 102 testsprite + | |
| 103 testtimer + | |
| 104 testver + | |
| 105 testvidinfo + | |
|
1888
488eba319a25
------- Comment #5 From Marc Peter 2006-06-25 18:03 [reply] -------
Sam Lantinga <slouken@libsdl.org>
parents:
1773
diff
changeset
|
106 testwin ? (fading doesn't seem right) |
| 1773 | 107 testwm + |
| 108 torturethread + | |
| 109 testcdrom + | |
| 110 testjoystick not tested | |
| 111 threadwin + | |
|
1888
488eba319a25
------- Comment #5 From Marc Peter 2006-06-25 18:03 [reply] -------
Sam Lantinga <slouken@libsdl.org>
parents:
1773
diff
changeset
|
112 testcursor + |
| 1773 | 113 |
| 114 | |
| 115 TODO | |
| 116 ---- | |
| 117 | |
| 118 There is room for further improvement: | |
| 119 - Test joystick functionality. | |
| 120 - Investigate fading issue in 'testwin' test. | |
| 121 - Fix the UTF-8 support. | |
| 122 - Adapt the makefile/object file list to support more target systems | |
| 123 - Use "#pragma aux" syntax for the CPU info functions. | |
| 124 | |
| 125 | |
| 126 Questions and Comments | |
| 127 ---------------------- | |
| 128 | |
| 3568 | 129 Please direct any questions or comments to me: |
| 130 | |
| 131 ow_sdl [at] digitalfantasy [dot] it | |
| 132 | |
| 133 The original porting to the open watcom compiler was made by | |
| 134 Marc Peter <mailto:macpete@gmx.de> | |
| 1773 | 135 |
| 136 Happy Coding! | |
| 137 | |
| 3568 | 138 Daniele Forghieri |
| 139 |