Initial commit.

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 @@
+Simple DirectMedia Layer 2 for OS/2 & eComStation

+================================================================================

+SDL port for OS/2, authored by Andrey Vasilkin <digi@os2.snc.ru>, 2016

+

+

+OpenGL not supported by this port.

+

+Additional optional environment variables:

+

+SDL_AUDIO_SHARE

+  Values: 0 or 1, default is 0

+  Initializes the device as shareable or exclusively acquired.

+

+SDL_VIDEODRIVER

+  Values: DIVE or VMAN, default is DIVE

+  Use video subsystem: Direct interface video extensions (DIVE) or

+  Video Manager (VMAN).

+

+You may significantly increase video output speed with OS4 kernel and patched

+files vman.dll and dive.dll or with latest versions of ACPI support and video

+driver Panorama.

+

+Latest versions of OS/4 kernel:

+  http://gus.biysk.ru/os4/

+ (Info: https://www.os2world.com/wiki/index.php/Phoenix_OS/4)

+

+Patched files vman.dll and dive.dll:

+  http://gus.biysk.ru/os4/test/pached_dll/PATCHED_DLL.RAR

+

+

+Compiling:

+----------

+

+Open Watcom 1.9 or newer is tested. For the new Open Watcom V2 fork, see:

+https://github.com/open-watcom/ and https://open-watcom.github.io

+WATCOM environment variable must to be set to the Open Watcom install

+directory. To compile, run: wmake -f Makefile.os2

+

+

+Installing:

+-----------

+

+- eComStation:

+

+  If you have previously installed SDL2, make a Backup copy of SDL2.dll

+  located in D:\ecs\dll (where D: is disk on which installed eComStation).

+  Stop all programs running with SDL2. Copy SDL2.dll to D:\ecs\dll

+

+- OS/2:

+

+  Copy SDL2.dll to any directory on your LIBPATH.  If you have a previous

+  version installed, close all SDL2 applications before replacing the old

+  copy.  Also make sure that any other older versions of DLLs are removed

+  from your system.

+

+

+Joysticks in SDL2:

+------------------

+

+The joystick code in SDL2 is a direct forward-port from the SDL-1.2 version.

+Here is the original documentation from SDL-1.2:

+

+The Joystick detection only works for standard joysticks (2 buttons, 2 axes

+and the like). Therefore, if you use a non-standard joystick, you should

+specify its features in the SDL_OS2_JOYSTICK environment variable in a batch

+file or CONFIG.SYS, so SDL applications can provide full capability to your

+device. The syntax is:

+

+SET SDL_OS2_JOYSTICK=[JOYSTICK_NAME] [AXES] [BUTTONS] [HATS] [BALLS]

+

+So, it you have a Gravis GamePad with 4 axes, 2 buttons, 2 hats and 0 balls,

+the line should be:

+

+SET SDL_OS2_JOYSTICK=Gravis_GamePad 4 2 2 0

+

+If you want to add spaces in your joystick name, just surround it with

+quotes or double-quotes:

+

+SET SDL_OS2_JOYSTICK='Gravis GamePad' 4 2 2 0

+

+or

+

+SET SDL_OS2_JOYSTICK="Gravis GamePad" 4 2 2 0

+

+   Note however that Balls and Hats are not supported under OS/2, and the

+value will be ignored... but it is wise to define these correctly because

+in the future those can be supported.

+

+   Also the number of buttons is limited to 2 when using two joysticks,

+4 when using one joystick with 4 axes, 6 when using a joystick with 3 axes

+and 8 when using a joystick with 2 axes. Notice however these are limitations

+of the Joystick Port hardware, not OS/2.