home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / x128v05.zip / README.OS2 < prev    next >
Text File  |  1997-01-30  |  6KB  |  161 lines
  1. Additional notes on the OS/2 version of X128
  2. --------------------------------------------
  3. This is the true OS/2 port of X128 for Intel based machines running OS/2 Warp,
  4. it requires DIVE and supports AY emulation through DART or Adlib compatible
  5. soundcards. For running X128 OS/2 a 486DX4+ is recommended.
  6.  
  7. X128 uses the emx runtime package emxrt.zip, but this distribution contains the
  8. required DLL's. If you want the whole package or just want to upgrade to the
  9. newest emx distribution, you can get emxrt.zip via anonymous ftp from
  10.  
  11.   ftp.uni-stuttgart.de [129.69.18.15]: /pub/systems/os2/emx-0.9c
  12.   ftp-os2.cdrom.com:  [192.153.46.2]:  /pub/os2/unix/emx09c
  13.   src.doc.ic.ac.uk     [146.169.2.1]:  /packages/os2/unix/emx09c
  14.   ftp.leo.org        [131.159.0.198]:  /pub/comp/os/os2/leo/devtools/emx+gcc
  15.  
  16. x128 was compiled with emx09c + fix 02, which you also can get from the
  17. above ftp sites.
  18.  
  19. INSTALLATION:
  20. -------------
  21. Just run x128.exe from whereever you unzipped it.
  22. If you want a Workplace object, with associations, just run 'install.cmd'
  23.  
  24.  
  25. WHAT WORKS AND WHAT DOESN'T:
  26. ----------------------------
  27. As of version 0.5b5 you can now drag and drop snapshot and tap files on the
  28. emulator window. When dropping a .z80/.sna/.slt file on x128, it loads the
  29. snapshot and if you are dropping a .tap/.voc file, it's selected as the tape
  30. file to use for 'loading' operations.
  31.  
  32. The F1-F10 isn't fully implemented in the OS/2 version, instead there's menus
  33. and dialogs for most of the functions. Sadly it's hard to implement James'
  34. great file selector, so instead we'll just use the standard OS/2 file-dialog.
  35.  
  36. The Fx keys that works are:
  37.     F2  - NMI
  38.     F5  - Load Z80/SNA/SLT
  39.     F6  - Save Z80/SLT
  40.     F7  - Select TAP/VOC
  41.     F10 - Exit
  42.     SHIFT-F8 - Increment ULA delay
  43.     SHIFT-F9 - Decrement ULA delay
  44.  
  45. +-----------------------------------------------------------------------------+
  46. | DO NOT, and I repeat, DO NOT use F5//F6/F7 when running FSDive(full screen) |
  47. +-----------------------------------------------------------------------------+
  48.  
  49. All commando line options works on this version and in addition to the
  50. original, X128 OS/2 has a few new ones which are:
  51.  
  52. x128 /DART
  53. Use DART for the AY emulation
  54.  
  55. x128 /BUFFER <number>
  56. This sets the buffer size used by the DART routines, default is 512Kb
  57.  
  58. x128 /FREQ <number>
  59. This sets the sampling frequency used by DART, default is 11025Hz
  60.  
  61. x128 /ADLIB
  62. Use an Adlib card for AY emulation
  63.  
  64.  
  65. Sound Emulation:
  66. ----------------
  67.  
  68. By default X128 OS/2 only emulates the speaker (port 254) by using the
  69. PC-Speaker. X128 OS/2 can also emulate the AY-8910 soundchip found in all the 
  70. 128K Spectrum's this AY emulation can be done in two ways:
  71.     1) Via DART, should be the most realistic, but requires a lot of CPU
  72.            time.
  73.     2) Via Adlib, sounds o.k. and does not slow the emulator down so much.
  74.  
  75.  
  76. KEYBOARD MAPPING:
  77. -----------------
  78.  
  79. KEYBOARD MAPPING on a IBM PS/2 KEYBOARD:
  80. -----   ----------------- ----------------- ----------------- -------------
  81. |BRK|   |F1 |F2 |F3 |F4 | |F5 |F6 |F7 |F8 | |F9 |F10|F11|F12| |   |   |   |
  82. -----   ----------------- ----------------- ----------------- -------------
  83. ------------------------------------------------------------- ------------- -----------------
  84. |EXT| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 |EDT|CPS|DELETE | |TV |IV |GRP| |   |   |   |   |
  85. |-----------------------------------------------------------| |-----------| |---------------|
  86. |FIRE | Q | W | E | R | T | Y | U | I | O | P |   |   |  E  | |   |   |   | |   |   |   |   |
  87. |------------------------------------------------------| N  | ------------- |-----------|   |
  88. |      | A | S | D | F | G | H | J | K | L |   |   |   | T  |               |   |   |   |   |
  89. |-----------------------------------------------------------|     -----     |---------------|
  90. |CSFT|   | Z | X | C | V | B | N | M | , | . |   |CAPS SHIFT|     | ^ |     |   |   |   | E |
  91. |-----------------------------------------------------------| ------------- |-----------| N |
  92. |SSHFT|   |     |      S  P  A  C  E       |     |    |SSHFT| | < | v | > | |       |   | T |
  93. -------   ----------------------------------------    ------- ------------- -----------------
  94.  
  95. BRK=BREAK, EDT=EDIT, CPS=CAPS LOCK, TV=TRUE VIDEO, IV=INV VIDEO, GRP=GRAPHICS
  96. EXT=EXTENDED MODE
  97.  
  98.  
  99. PERFORMANCE:
  100. ------------
  101.  
  102. On my 486DX4-100 with a cheap S3 Trio 32 videocard, it runs at about 40fps on
  103. 1024x768x256. This is of course without AY sound.
  104.  
  105.  
  106. THE STATUSBAR:
  107. --------------
  108.  
  109. The statusbar at the bottom shows you:
  110. [Speccy Model:48K/128K] [ULA delay] [Frame skip] [AY emulation:Adlib|DART]
  111.  
  112.  
  113. PROBLEMS:
  114. ---------
  115.  
  116.  * Adlib sound doesn't stopped when the emulator is stopped.
  117.  
  118.  * If you get an error from X128, white on blue, you have to exit and restart
  119.    the emulator.
  120.  
  121.  
  122. CHANGES:
  123. --------
  124.  
  125. The following files are changed or rewritten in this port:
  126.  
  127.  * x128_def.c - changed for OS/2
  128.  * x128_tap.c - changed for OS/2
  129.  * x128_t.c   - rewritten for OS/2
  130.  
  131. and new files are:
  132.  
  133.  * OS2Warp.[ch]  - OS/2 DIVE part
  134.  * soundos2.[ch] - OS/2 DART part
  135.  
  136.  
  137. CHANGELOG:
  138. V0.5b4 - Implemented creation of PSG file
  139.          Optimized sound-os2.c
  140.  
  141. V0.5b5 - Reprogrammed and optimized the OS/2 Part - mainly because some people
  142.           was complaining about palette problems.
  143.          Function for update_line now in assembler. 
  144.          It's not any longer possible for the z80-engine to be in the middle
  145.           of executing a instruction, when saving and loading.
  146.          Now remembers the last used path of snaps, taps & scr's independently.
  147.          The screen is now updated, while using dialogs.
  148.          Made x128 more friendly to other applications, when it doesn't have
  149.           the focus.
  150.          Added Drag'n'Drop of snapshot and tap files.
  151.          Added an 'eject' tape option for TAP/VOC files.
  152.          Added loading of .SCR files.
  153.          Added a statusbar, just for fun :-)
  154.          Added some nice pictures.
  155.          Fixed a keyboard bug, so the MF128 now works.
  156.          Added changed keyboard mapping a bit. (look above)
  157.  
  158. (c) 1996-97 Thomas A. K. Kjaer
  159.     takjaer@daimi.aau.dk
  160.     http://www.daimi.aau.dk/~takjaer/
  161.