Mercurial > sdl-ios-xcode
annotate README.Watcom @ 4853:f7cde99bf66a
Added last test shape. Because.
author | Eli Gottlieb <eligottlieb@gmail.com> |
---|---|
date | Sun, 15 Aug 2010 21:46:46 -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 |