92 lines
3 KiB
Markdown
Executable file
92 lines
3 KiB
Markdown
Executable file
Simple DirectMedia Layer 2 for OS/2 & eComStation
|
|
================================================================================
|
|
SDL port for OS/2, authored by Andrey Vasilkin <digi@os2.snc.ru>, 2016
|
|
|
|
|
|
OpenGL and audio capture 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.
|