INTRODUCTION


toxic audio is an implementation of OpenAL for LightWave,
wich has been designed as an directX alternative for spatial sound (main intention: games).
This plugin allows you to assign up to 4 sounds to objects and outputs stereo position + doppler effect.


This is more or less a preview ( proof of concept) version , if there are enough people who are
actually interested in wanting some features/ issues resolved.

So please don't hesitate to send a mail towards spatial@huf.org for bug reports / suggestions etc.

If stability and features richness allows it, I will create a 20-30$ version.

Installation
Because openAL is widely distributed and used, it might be worth to check if you really need to install openal,
so its a good thing to install the plugin first, and check if its already working

1

 First install openAL (OpenALwEAX.exe)

2

 Copy the openAL utility libraries, (alut.dll) either in your system, or into the lightwave program directory

3

Install the plugin, (master plugin, plugin name: tibe3_audiopro)

 

4

When you do launch the plugin interface the first time it will display you the following panel

These are the sound devices aviable for using the plugin. The last number is the (possible) maximum amount of sounds you could initialise.
(As said currently it is restricted by me to 4 channels)

After hitting ok or cancel (doesn't matter) the main toxic audio panel will popup.
If you want to come back to this menue later you have to delete the toxicaudio.cfg in your config directory.

ONLY IN CASE OF TROUBLE  (WIN98)
The last release had some some troubles with a lw8.5 install on a win98 machine, strangely enough an older version of the openal framework worked perfectly.

THIS SEEMS TO BE AN ERROR WITH THE OLDER OPENAL VERSION, AND SHOULD BE FIXED WITH THE NEW INSTALLER

Important Restrictions / Notices

Currently there are two restrictions wich are based on certain limitation of openAL.

   This version does not support LW7.5   

Instructions
After launching this master plugin you will see the following panel.

1

 Displays the currently loaded sound and settings.
The first collum also displays if the sound is active by a *
if the wav file is stereo it additionaly displays a ! to mark it wont affected by spatial information

 
Object settings

2

Allows you to activate/deactivate a sound

3

 Load the sound/ display the sound filename. When entered by keyboard, you can use 4 to load sound

4

 Assigns an object wich will emit the sound.

5

 The start frame on wich the wav file will be played

6

 The volume of the object / sound

7

 Loops the sound infinitely: (not 100% implemented yet)

7b

 Distance Falloff (not displayed here) how long the sound is propagated into space
not 100%

 
Microphone settings

8

 MicroCam is the Camera wich will be used as "Microphone"

9

 Doppler factor will rise/lower the doppler shift amount.

10

 How fast the sound will spread. This will be used for doppler calculation
Most of the times you certainly will decrease this level to values around 10-50 for a more noticeable doppler effect.

 
Preview settings

11

 Scratchmode: If unselected, LW will play sound until end when scratching through the timebar (instead of less than a second)

12

 Sets the preview range wich will be used for 13

13

 Plays a preview of the sound scene


Dopetrack

In this version I've implemented an experimental dopetrack support for the plugin, wich allows to set the rudimentary start time. of the current selected wav file,
and additionally load a file into one of the slots.
Its still very experimental, and has some diplay and update problems.


Credits / Notes

This plugin has been tested as best as I could, In no way should I made liable for any damage / misuse by the usage of the plugin
In short: Useit at your own risk.

version 0.3
LW9 audio filepath support, allows you to load and save a file depending if its inside the sounds folder or not.

toxic audio (c) 2006 by tischbein3, all right reserved.
uses openAL,and freealut helper libraries wich are licenced under LPGL. (www.openal.org)