File README.3dse of Package xmms

3DSE patch release 11 for XMMS 1.2.5
------------------------------------

WHAT?
	This patch adds 3D Stereo Enhancement support to the XMMS
	player. This is an MP3-player available at http://www.xmms.org

SUPPORTED HARDWARE
	SoundBlaster 16 v4.16+	
	SoundBlaster 16 ViBRA PnP
	SoundBlaster AWE 32/64
	...

FEATURES
	Supports direct hardware access so it can be used with OSS 
	drivers (like the commercial OSS drivers) which don't
	support (software) 3DSE settings.
	Supports the environment variable BLASTER. This can be 
	useful when using direct hardware access.

INSTALL
	Make sure the source code of XMMS 1.2.5 is in your current
	directory. Also copy xmms-1.2.5-3dse-11.patch to this dir.
	Then do:
		patch -p0 < xmms-1.2.5-3dse-11.patch
		cd xmms-1.2.5
		./configure
		make
		make install
		xmms &
	That's all.

HELP & FEEDBACK
	When Murphy strikes don't hesitate and email me the 
	problem(s), maybe I can help.
	Comments are also welcome.

NOTES
	To use direct hardware access you need to be root.
	The direct hardware access also only gets enabled if the
	active sound drivers don't support 3DSE settings, else
	the direct hardware access gets greyed out.
	Currently only the OSS/Free sound drivers that come with
	the Linux kernel support 3DSE. This option gets enabled
	by using the ioctl SOUND_MIXER_3DSE.
	In some cases it can be necessary to delete the ~/.xmms
	directory in order to be able _not_ to use direct hardware
	access but the "normal ioctl"-way.

BINARY LIBRARY libOSS.so
	If you can't compile XMMS with the 3DSE patch you can
	just use the pre-compiled library libOSS.so.
	Platform: RedHat Linux 7.1 (i386)
	Just copy the file:
		cp bin/xmms-1.2.5/rh71-i386/libOSS.so /usr/lib/xmms/Output/
	And restart XMMS of course.
	I also tried to compile XMMS 1.2.3 on linux SuSE 6.4 but failed.
	Binary compiled libOSS.so for other platforms are always welcome.
	When sending them to me, please first strip the files with:
		strip libOSS.so

QUICK INSTALL
	When you've got XMMS 1.2.5 installed and hate to compile again:
		cp -f bin/xmms-1.2.5/rh71-i386/libOSS.so /usr/lib/xmms/Output/

COPYING
	This is GNU GPL software. See COPYING.
	Use at own risk.

AUTHOR
	Cornelis Frank <Frank.Cornelis@rug.ac.be>

HOMEPAGE & ONLINE USER MANUAL
	http://studwww.rug.ac.be/~fcorneli/xmms/

OTHER 3DSE SOFTWARE TOOLS
	http://studwww.rug.ac.be/~fcorneli/

Enjoy the 3D sound (and dEUS)!!!