By creating an INI file for your Flash movie, you can customize how FlashVis interacts with your movie. You would want to do this for both aesthetic and performance reasons.
The INI file must be named the same as your movie. Thus, if your movie is named MyMovie.swf, then the INI file must be named MyMovie.ini.
The INI file must reside in the same directory as your movie. The section name in the file is [FlashVis]. If you don't know what that means, use the sample INI file below as a starting point.
Here is a sample of an INI file.
The following table lists INI file entries, their type, their default value, and their purpose. To use a default value, simply delete that line from the INI file. An entry's type is either text, a numeric value (#), or a boolean value (bool). For boolean values, 1 is true and 0 is false.
|
Name
|
Type
|
Description |
|---|---|---|
|
Title
|
text
|
Title of movie; used in FlashVis menus and windows. Default is the movie's filename. |
|
Loop
|
bool
|
Loop the movie? Default is true. |
|
CallFlashVisHandler
|
bool
|
Call the FlashVisHandler (TODO add link) command when new data arrives? Default is true. |
|
SendWaveform0
|
bool
|
Send waveform data from the 0 (left) channel? Default is true. |
|
SendWaveform1
|
bool
|
Send waveform data from the 1 (right) channel? Default is true. |
|
SendSpectrum0
|
bool
|
Send spectrum data from the 0 (left) channel? Default is true. |
|
SendSpectrum1
|
bool
|
Send spectrum data from the 1 (right) channel? Default is true. |
|
XPos
|
#
|
Starting X position of movie. Default is the Windows' default, which is generally a convenient spot. |
|
YPos
|
#
|
Starting Y position of movie. Default is the Windows' default, which is generally a convenient spot. |
Why would you want to not send waveform or spectrum data?
For performance reasons. Each chunk of data is 576 bytes long. Not only does this have to be moved from the FlashVis DLL world to the Flash movie world, but the performance of handling data in Flash Actionscript is low. The more time it takes to handle the data, the lower framerates you get in your Flash movie. If you don't need the data, then FlashVis can update your movie more frequently, giving your user a better experience.
For example, maybe you don't need stereo data. So, only send waveform 0 and spectrum 0 to get better performance. You disable sending the other waveforms by setting SendWaveform1 and SendSpectrum1 to 0. You should also set the respective Flash variables fvbConvertW1 and fvbConvertS1 to false, so that FlashVisConvert does not process them.
If you can think of other things that you would want customized, please tell me.