OPTIONS.INI File

Navigation:  Troubleshooting >

OPTIONS.INI File

Previous pageReturn to chapter overviewNext page

NOTE:  This section is for advanced users only and involves editing the options file manually

 

Forte options are stored in a text file call OPTIONS.INI using traditional Windows-style ".ini" formatting.  OPTIONS.INI is located in the user's application data folder.  This folder has been located in different places in different versions of Windows.  As of Windows 7, it is in the C:\Users\<username>\AppData\Roaming\brainspawn\forte 3 folder.  A handy way to access this folder is to start Forte and select the menu command "Tools|View INI Files and application data folder" which opens the folder for easy access.

 

OPTIONS.INI has several [sections].  Many of the settings are configured via the Options|Preferences Panel (see Configuring Options and Preferences.)  However, sometimes certain advanced troubleshooting options are settable by directly editing OPTIONS.INI.  This section defines some useful troubleshooting options.  Often the option does not exist in OPTIONS.INI by default, which means it takes its default state.  To enable an option, navigate OPTIONS.INI to the specified section (the text with the [brackets] around it) and add or edit the line of text containing the option name and the "=" sign.  After using a troubleshooting option, you may turn it back off by simply removing it or switching its 1 or 0 state. You must restart Forte after saving OPTIONS.INI for option changes to take effect.

 

[Troubleshooting]

SingleStepVSTPluginLoad = 0 (disabled, default) or 1 (enabled)

 

If SingleStepVSTPluginLoad = 1, Forte prompts you before each step of sending data to a VST plugin during scene load.  You may skip a step by selecting "No" on the dialog box.  The data to be loaded is logged to the log file before loading into the plugin and is also logged if skipped.  If a load operation causes the plugin to crash, the immediately preceding data item is probably to blame, and the raw content of the data is available in the log file.  The log file is called "Forte.log" in the same folder as OPTIONS.INI.  See Log File for more information.

 

Audio Options

[Audio]

StopAudioDuringSceneCapture = 0 (don't stop/restart audio, default) or 1 (stop/restart audio engine during scene capture or update)

 

If you encounter issues with plugins during scene capture or update, you may try setting this value to 1.  When set to 1, Forte will stop the audio engine during scene capture and restart it if needed when complete.

 

[Audio]

RestartAudioOnMIDIPanic = 0 (don't stop/restart audio, default) or 1 (stop/restart audio engine during MIDI Panic)

RestartMIDIOnMIDIPanic= 0 (don't stop and restart MIDI Ports, default) or 1 (stop and restart MIDI Ports during MIDI Panic)

 

MIDI Meter

The following MIDI Meter options allow for highly specialized uses of the MIDI meter:

 

[SceneView]

SceneViewFavorSceneNames = 0 (default) or 1.  if 0 when using single-scene songs, the song name will be displayed in SceneView2 if 1 when using single-scene songs, the scene name will be displayed in SceneView2

StretchBackgroundImage = 0 (default) or 1.  If 1, stretches background images to fit screen

 

 

SceneView2

The following options alter the appearance of SceneView 2:

 

[SceneView2]

SceneViewMIDIMeterCCMin = 0 (minimum scaled value of MIDI meter in SceneView)

SceneViewMIDIMeterCCMax = 127 (maximum scaled value of MIDI meter SceneView)

 

If missing the defaults are 0-127.  However if you set max = 20, the displayed MIDI meter range will be from 0-20.

 

Defaults

The following options allow customize behavior of Forte for specialized setups:

 

[Defaults]

Wait_For_Offline_Audio_Devices = 0 or 1 (default = 1)

 

If 0 when Forte starts without any audio devices it will present an audio configuration prompt.  If you press Cancel at this prompt Forte will start with no audio devices at all.  If you then load a rack file, you may use an offline configuration.  This is preferable if a missing audio device causes the audio driver to issue an error dialog box.

 

If missing or 1, then Forte will retry audio detection each second for 10 seconds before resorting to the audio configuration prompt.  This is preferable if the audio device is slow to be recognized by Windows.

 

Trim_Delay_Ms = number of ms to delay between scenes during Trim operation (default = 0)