diff options
Diffstat (limited to 'src/contrib/SDL-2.30.2/docs/README-os2.md')
| -rw-r--r-- | src/contrib/SDL-2.30.2/docs/README-os2.md | 92 |
1 files changed, 92 insertions, 0 deletions
diff --git a/src/contrib/SDL-2.30.2/docs/README-os2.md b/src/contrib/SDL-2.30.2/docs/README-os2.md new file mode 100644 index 0000000..6870ee3 --- /dev/null +++ b/src/contrib/SDL-2.30.2/docs/README-os2.md | |||
| @@ -0,0 +1,92 @@ | |||
| 1 | Simple DirectMedia Layer 2 for OS/2 & eComStation | ||
| 2 | ================================================================================ | ||
| 3 | SDL port for OS/2, authored by Andrey Vasilkin <digi@os2.snc.ru>, 2016 | ||
| 4 | |||
| 5 | |||
| 6 | OpenGL not supported by this port. | ||
| 7 | |||
| 8 | Additional optional environment variables: | ||
| 9 | |||
| 10 | SDL_AUDIO_SHARE | ||
| 11 | Values: 0 or 1, default is 0 | ||
| 12 | Initializes the device as shareable or exclusively acquired. | ||
| 13 | |||
| 14 | SDL_VIDEODRIVER | ||
| 15 | Values: DIVE or VMAN, default is DIVE | ||
| 16 | Use video subsystem: Direct interface video extensions (DIVE) or | ||
| 17 | Video Manager (VMAN). | ||
| 18 | |||
| 19 | You may significantly increase video output speed with OS4 kernel and patched | ||
| 20 | files vman.dll and dive.dll or with latest versions of ACPI support and video | ||
| 21 | driver Panorama. | ||
| 22 | |||
| 23 | Latest versions of OS/4 kernel: | ||
| 24 | http://gus.biysk.ru/os4/ | ||
| 25 | (Info: https://www.os2world.com/wiki/index.php/Phoenix_OS/4) | ||
| 26 | |||
| 27 | Patched files vman.dll and dive.dll: | ||
| 28 | http://gus.biysk.ru/os4/test/pached_dll/PATCHED_DLL.RAR | ||
| 29 | |||
| 30 | |||
| 31 | Compiling: | ||
| 32 | ---------- | ||
| 33 | |||
| 34 | Open Watcom 1.9 or newer is tested. For the new Open Watcom V2 fork, see: | ||
| 35 | https://github.com/open-watcom/ and https://open-watcom.github.io | ||
| 36 | WATCOM environment variable must to be set to the Open Watcom install | ||
| 37 | directory. To compile, run: wmake -f Makefile.os2 | ||
| 38 | |||
| 39 | |||
| 40 | Installing: | ||
| 41 | ----------- | ||
| 42 | |||
| 43 | - eComStation: | ||
| 44 | |||
| 45 | If you have previously installed SDL2, make a Backup copy of SDL2.dll | ||
| 46 | located in D:\ecs\dll (where D: is disk on which installed eComStation). | ||
| 47 | Stop all programs running with SDL2. Copy SDL2.dll to D:\ecs\dll | ||
| 48 | |||
| 49 | - OS/2: | ||
| 50 | |||
| 51 | Copy SDL2.dll to any directory on your LIBPATH. If you have a previous | ||
| 52 | version installed, close all SDL2 applications before replacing the old | ||
| 53 | copy. Also make sure that any other older versions of DLLs are removed | ||
| 54 | from your system. | ||
| 55 | |||
| 56 | |||
| 57 | Joysticks in SDL2: | ||
| 58 | ------------------ | ||
| 59 | |||
| 60 | The joystick code in SDL2 is a direct forward-port from the SDL-1.2 version. | ||
| 61 | Here is the original documentation from SDL-1.2: | ||
| 62 | |||
| 63 | The Joystick detection only works for standard joysticks (2 buttons, 2 axes | ||
| 64 | and the like). Therefore, if you use a non-standard joystick, you should | ||
| 65 | specify its features in the SDL_OS2_JOYSTICK environment variable in a batch | ||
| 66 | file or CONFIG.SYS, so SDL applications can provide full capability to your | ||
| 67 | device. The syntax is: | ||
| 68 | |||
| 69 | SET SDL_OS2_JOYSTICK=[JOYSTICK_NAME] [AXES] [BUTTONS] [HATS] [BALLS] | ||
| 70 | |||
| 71 | So, it you have a Gravis GamePad with 4 axes, 2 buttons, 2 hats and 0 balls, | ||
| 72 | the line should be: | ||
| 73 | |||
| 74 | SET SDL_OS2_JOYSTICK=Gravis_GamePad 4 2 2 0 | ||
| 75 | |||
| 76 | If you want to add spaces in your joystick name, just surround it with | ||
| 77 | quotes or double-quotes: | ||
| 78 | |||
| 79 | SET SDL_OS2_JOYSTICK='Gravis GamePad' 4 2 2 0 | ||
| 80 | |||
| 81 | or | ||
| 82 | |||
| 83 | SET SDL_OS2_JOYSTICK="Gravis GamePad" 4 2 2 0 | ||
| 84 | |||
| 85 | Note however that Balls and Hats are not supported under OS/2, and the | ||
| 86 | value will be ignored... but it is wise to define these correctly because | ||
| 87 | in the future those can be supported. | ||
| 88 | |||
| 89 | Also the number of buttons is limited to 2 when using two joysticks, | ||
| 90 | 4 when using one joystick with 4 axes, 6 when using a joystick with 3 axes | ||
| 91 | and 8 when using a joystick with 2 axes. Notice however these are limitations | ||
| 92 | of the Joystick Port hardware, not OS/2. | ||