Skip to content

Commit

Permalink
Fix spelling errors README.txt
Browse files Browse the repository at this point in the history
  • Loading branch information
AranVink authored Jun 11, 2024
1 parent e7ceae4 commit 0bad11e
Showing 1 changed file with 20 additions and 20 deletions.
40 changes: 20 additions & 20 deletions README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ It works both for realmode & protected mode programs.

Supported sound blaster emulation: SB, SBpro, SBpro2 (SBpro with OPL3), SB16.

SBEMU gives sepcial thanks to DOSBox and MPXPlay.
SBEMU gives special thanks to DOSBox and MPXPlay.
The OPL emulation code is from DOSBox (https://www.dosbox.com/)
and the sound card drivers are from MPXPlay (https://mpxplay.sourceforge.net/)
Additional Linux drivers ported by jiyunomegami (https://github.com/jiyunomegami)
Expand Down Expand Up @@ -46,7 +46,7 @@ CONFIG.SYS:
`DEVICE=JEMMEX.EXE X2MAX=8192 NOEMS`

AUTOEXEX.BAT:
`REM laod the QEMM QPI's port trap emulation module of JEMMEX`
`REM load the QEMM QPI's port trap emulation module of JEMMEX`
`JLOAD.EXE QPIEMU.DLL`
`REM this will install HDPMI, the DPMI host. -x with memory limit, check for 'Memory problem' for more details`
`HDPMI32i -r -x`
Expand All @@ -69,7 +69,7 @@ NOTE: after SBEMU installs, you can change them by a another run of SBEMU with n
you may try to use another one. Default: 7

/D: DMA channel of SB used, valid value: 0,1,3. usually /D1 works fine.
To get maximum compatibility, /D2 is not recommended becuase
To get maximum compatibility, /D2 is not recommended because
DMA channel 2 is for legacy floppy disk controller, and should be avoided.

/H: 16 bit "high" DMA channel for SB16/AWE, usually 5, 6, or 7. default: /H5.
Expand All @@ -79,12 +79,12 @@ NOTE: after SBEMU installs, you can change them by a another run of SBEMU with n
one controller (channel 0-3) uses 8 bit transfer and another (channel 4-7) is 16 bit.
The 16 bit channels are so called "high" DMA channels.

/H4 (or /D4) is not vaid because DMA channel 4 is used for cascading the other DMA controller.
/H4 (or /D4) is not valid because DMA channel 4 is used for cascading the other DMA controller.

Some game will use, or be configured to use 16 bit DMA
transfer, on such case, this value is used.

SB16 also support 16 bit PCM via 8 bit low DMA channel, on such case, use /H1 /H3 may achieve the emualtion,
SB16 also support 16 bit PCM via 8 bit low DMA channel, on such case, use /H1 /H3 may achieve the emulation,
but it is no recommended for compatibility reason. And if H0 through H3 is set,
then both the /H and /D parameter will be forced to be the same value.

Expand All @@ -104,32 +104,32 @@ NOTE: after SBEMU installs, you can change them by a another run of SBEMU with n
/PM: Enable SB for protected mode programs, default: 1. /PM0 to turn it off.

/RM: Enable SB for real mode programs, default: 1. /RM0 to turn if off.
/RM require an EMM that support port trapping, if it doesn't loaded, /RM will be turnedd off automatically with a warning.
/RM require an EMM that support port trapping, if it doesn't loaded, /RM will be turned off automatically with a warning.

/O: This option is only for Intel HDA.
/O0: output to headphone.
/O1: output to speaker.
default: /O1.
Try changing it if SBEMU doesn't have any sounds for your HDA, or use /O0 if you're using a heaphone.
Try changing it if SBEMU doesn't have any sounds for your HDA, or use /O0 if you're using a headphone.

/VOL: Set the volume of sound card, it will set to the real sound card directly. Range: 0-9, default: /VOL7
NOTE: This is the volume for the real PCI sound card,
if you change the emulated SB volume via SB utility like SBMIX, this valume won't change, unless you run 'SBEMU /VOLx' again.
if you change the emulated SB volume via SB utility like SBMIX, this volume won't change, unless you run 'SBEMU /VOLx' again.

/K: Set the sample rate for the real sound card. Default: /K22050
It's not recommended to set value above 44100 for games, as most DOS games output 11025/22050 Hz.
But you may try to set it higher if your want, or for music players.

/FIXTC: Use fixed time constant. Default: /FIXTC0 (disabled)
Old SB hardwares don't set sample reate directly, but using a byte of 'time-constant' to calculate smaple rate indirectly,
Old SB hardware doesn't set sample rate directly, but using a byte of 'time-constant' to calculate sample rate indirectly,
when 'time-constant' is used, there's some inevitable PRECISION LOSS: if a game set sample rate to 22050 through time-constant,
the real sample rate caclulated back from the time constant is not exactly 22050, and SBEMU will try to fix it using
the real sample rate calculated back from the time constant is not exactly 22050, and SBEMU will try to fix it using
the most near and commonly used sample rates (11025/22050 etc.)

LONG STORY SHORT: 22050 => time constant => NEWVALUE where NEWVALUE is not essentially 22050,
It is designed this way and there's little can be done. SBEMU tries to fix it to 22050 with /FIXTC

With this switch on, it makes SBEMU works more effiently because the PCM resample will be skipped or simplified.
With this switch on, it makes SBEMU works more efficiently because the PCM resample will be skipped or simplified.
If you have faced any sound pops/noises/stuttering, you can try using /FIXTC

/SCL: List the PCI sound cards installed on your PC. Each will be shown with a number before it.
Expand All @@ -144,23 +144,23 @@ NOTE: after SBEMU installs, you can change them by a another run of SBEMU with n
'/SCL2' to select the 2nd card for SB emulation.

/SCFM: if a PCI sound card has hardware FM (like YMF 7x4 or some CMI cards), /SCFM is used to choose the card for hardware FM.
Example: like /SC above, because the 1st sound card 'Intel HDA' has no HW FM, but assmue the 2nd one (CMI) has HW FM,
then you can use /SCFM2 to use it for FM output, while keep /SC1 to use Intel HDA for the SB digital SFX emualtion.
Example: like /SC above, because the 1st sound card 'Intel HDA' has no HW FM, but assume the 2nd one (CMI) has HW FM,
then you can use /SCFM2 to use it for FM output, while keep /SC1 to use Intel HDA for the SB digital SFX emulation.
NOTE: for CMI cards, this option is not effective if it is not specified in command line,
i.e. you have only 1 CMI card, and by default hardware FM is not enabled unless you set /SCFM (or /SCFM1).
for YMF cards, hardware FM will be enabled by default.

/SCMPU: like /SCFM but for MPU401 General MIDI support.

/R: Reset sound card driver. Normally it's not needed but if your game sound is not working suddenly, due to
hardware/software compatibility reason, or bugs, you can try to reset/re-init the sound card drvier.
hardware/software compatibility reason, or bugs, you can try to reset/re-init the sound card driver.
SBEMU will try to reset the sound card to its initial states as when SBEMU installs.
This options is only usefull `AFTER` SBEMU installs.
This options is only useful `AFTER` SBEMU installs.


5. Trouble Shooting

a) VCPI iusses. Known games: NFS, FastDoom
a) VCPI issues. Known games: NFS, FastDoom

Some games/DOS Extenders (like DOS32A) won't get any sounds because it choose to use VCPI but not DPMI. Because VCPI mode cannot be io-trapped,
SBEMU cannot work on it. To force the games to use DPMI, turn off VPCI for JEMM386/JEMMEX `AFTER` SBEMU installs:
Expand All @@ -170,7 +170,7 @@ SBEMU cannot work on it. To force the games to use DPMI, turn off VPCI for JEMM3
b) Memory problem.

Some protected mode games refuse to work if there're too much DPMI memory, so the command line parameter '-x' for HDPMI is
used to limit the DPMI memory. it is always recommeded to get max compatiblity for gaming.
used to limit the DPMI memory. it is always recommended to get max compatibility for gaming.
'HDPMI32i -r -x'
NOTE: -r will make HDPMI resident (TSR).
-x will limit the DPMI memory to 256M, -x1 will make it 128M, -x2 to 64M, and so on.
Expand All @@ -190,7 +190,7 @@ Some games require EMS to work (i.e. Aladdin), on such case the 'NOEMS' needs to

And some games may not work properly with EMS enabled on modern PC, you need check the manual to see if
there's option to disable EMS for the game.
i.e. WOLF3D won't work properly on Thinkapd T540p with EMS enabled, use
i.e. WOLF3D won't work properly on Thinkpad T540p with EMS enabled, use
'WOLF3D NOEMS' will work, or create a .BAT file for convenience.


Expand All @@ -207,7 +207,7 @@ Example1:
SET BLASTER=A220 I5 D1
SBEMU
`
is equavilent to `SBEMU /A220 /I5 /D1` without setting BLASTER.
is equivalent to `SBEMU /A220 /I5 /D1` without setting BLASTER.

Example2:
`
Expand All @@ -216,7 +216,7 @@ SBEMU /I7
`
There're IRQ in both BLASTER (I5) and commandline (/I7), then IRQ7 will be the working one.

NOTE: For compatibiliy reason, SBEMU won't set T in BLASTER unless /T6 is used, if you need T in BLASTER,
NOTE: For compatibility reasons, SBEMU won't set T in BLASTER unless /T6 is used, if you need T in BLASTER,
you can set it manually AFTER SBEMU installs.


Expand Down

0 comments on commit 0bad11e

Please sign in to comment.