VST-plugins 
HOME   |   Software   |   energyXT       mGUI :: FIRST   -   PREV   -   NEXT

Global.ini file specification

The Global.ini file, which is used by all asseca vst-DLLs, contains the following sections:
[Main] debug settings and PC-key definitions
[pnlAbout] skin components for the "About" panel
[pnlProperties] skin components for the "Properties" panel
[pnlOptions] skin components for the "Options" panel
[pnlEntry] skin components for the "Entry" panel
[curHost] shows last used host and KB_MW value
[hostname x] VSThost section(s)


[Main] section:

This section contains debug settings, Midi output ports and PC-key definitions.
NOTE: these settings are used by ALL asseca VST-plugins.
Debug=0 0 = no debug info written (=Default)
1 = writes debug info to the asseca.log file
AutoUpdate=0 0 = saves plugin.ini and skin.ini as usual (=Default)
12 = auto-writes all Parts to seperate "[PartN-Prms]" sections, and auto-inserts "zN-" in front of all parameters and parameter-references to ease transition to v1.2 Parts, where "N" is Part number.
NOTE: copy/paste/import/export Part will only function correctly if parameter names are identical (except for the "zN-" prefix), and are found in [PartN-Prms] section
MAKE BACKUPS OF ALL YOUR PLUGIN.INI FILES BEFORE SETTING THIS VALUE TO "12"
protectGlobalIni=1 0 = changes will be written to Global.ini file, if allowIniWr=1
1 = Global.ini is protected, no changes will be written to Global.ini file (=Default)
protectThemeIni=1 0 = changes will be written to theme.thm file, if allowIniWr=1
1 = theme.thm is protected, no changes will be written to the theme.thm file (=Default)
protectPlugIni=1 0 = changes will be written to plugin.ini-file, if allowIniWr=1
1 = plugin.ini is protected, no changes will be written to plugin.ini file (=Default)
protectSkinIni=1 0 = changes will be written to skin.skn-file, if allowIniWr=1 AND protectPlugIni=0
1 = skin.skn is protected, no changes will be written to skin.skn file (=Default)
editGlobalPanels=1 0 = no Global-panels changes will be written to the Global.ini or theme.thm files (=Default)
1 = Global-panels changes will be written to Global.ini and/or theme.thm files, depending on the settings of allowIniWr= AND protectGlobalIni= AND protectThemeIni=
allowIniWr=1 0 = NO changes in plugin will be written to Global.ini, theme.thm, plugin.ini or skin.skn files
1 = changes in plugin can be written to Global.ini, theme.thm, plugin.ini, skin.skn files, depending on the settings of protectGlobalIni=, protectThemeIni=, protectPluginIni=, protectSkinIni= and editGlobalPanels= (=Default)
StickyKeys=0 0 = switches StickyKeys OFF (=Default)
1 = for PC-shortcut-keys: enables you to press a modifier key (CTRL and/or SHIFT), and have it remain active until another key is pressed.
UseNumPad=0 0 = switches UseNumPad OFF (=Default)
1 = when on a focused control, allows direct value-entry via the numeric keypad.
bufDraw=1 0 = direct drawing of graphics and text
1 = buffered drawing of graphics and text for full redraw, and direct drawing for single control updates (=Default)
JoyTmr=20 0 = Joy-stick/Game-paddle OFF (=Default)
1..200 = Joy-stick/Game-paddle timer interrupt in milliseconds
CC_Thru=64,65,67,68 allows global CCs to be routed through plugin
intMidiFB-1=BCR2000 [01] Midi feedback port for e.g. BCR2000/BCF2000, NOTE: spelling MUST be exact!
intMidiFB-1 will be overridden, if re-defined in the plugin.ini file
extMidiOut-1=MIDI Yoke NT: 1 Midi output port 1, NOTE: spelling MUST be exact!
extMidiOut-1 will be overridden, if re-defined in the plugin.ini file
extMidiOut-2=_ Midi output port 2, NOTE: spelling MUST be exact!
extMidiOut-2 will be overridden, if re-defined in the plugin.ini file
HelpFile=mGUI.chm Help file, if not defined Global.ini Path+'mGUI.chm' will be used, accessed via Shift+"Help"
CloseWindow=C D = remove skin images, fonts, components from memory when closing the GUI window (=default)
C = keep skin images, fonts, component in memory when closing the GUI window
MouseSpeed=1 mouse sensitivity when changing a knob/fader small step value (1=Default)
MouseLSpeed=10 mouse sensitivity when changing a knob/fader large step value (10=Default)
KnobMove=V H = Horizontal mouse movement to change knob value
V = Vertical mouse movement to change knob value
B = Both horz and vert mouse movement to change knob value (=Default)
AutoFocus=1 0 = Auto-Focus Off (=Default)
1 = Auto-Focus On
KnobMode=2 if the host sends a KnobMode it will override this setting
0 = circular
1 = circular relative
2 = linear (=default)
the following are PC shortcut-key definitions
movUp=Ctrl+Up PC-key to move a control position upward (in design mode)
movDwn=Ctrl+Down PC-key to move a control position downward (in design mode)
movLft=Ctrl+Left PC-key to move a control position left (in design mode)
movRgt=Ctrl+Right PC-key to move a control position right (in design mode)
tmovUp=Alt+Up PC-key to move a text position in control upward (in design mode)
tmovDwn=Alt+Down PC-key to move a text position in control downward (in design mode)
tmovLft=Alt+Left PC-key to move a text position in control left (in design mode)
tmovRgt=Alt+Right PC-key to move a text position in control right (in design mode)
gotoUp=Up PC-key to goto control above current control
gotoDwn=Down PC-key to goto control below current control
gotoLft=Left PC-key to goto control to the left of current control
gotoRgt=Right PC-key to goto control to the right of current control
refresh=Ctrl+F5 PC-key to refresh display contents
clrFocus=Ctrl+F9 PC-key to release VST-window input-focus
props=Ctrl+Enter PC-key to open Properties-panel
entry=Enter PC-key to open Entry-panel
options=Menu PC-key to open Options-panel
valDec=Shift+Num - PC-key to fine adjust a control value (decrease)
valInc=Shift+Num + PC-key to fine adjust a control value (increase)
valDecF=Num - PC-key to adjust a control value (decrease)
valIncF=Num + PC-key to adjust a control value (increase)
valMin=Home PC-key to adjust a control value to minimum
valMax=End PC-key to adjust a control value to maximim
valDef=Ins PC-key to adjust a control value to default
swOnOff=Space PC-key to switch a button On/Off
decOcc=Ctrl+Num - PC-key to decrease a control MIDI-out CC
incOcc=Ctrl+Num + PC-key to increase a control MIDI-out CC


[pnlAbout] section:

This section contains the skin components for the "About" panel. This section will be overridden, if re-defined in the plugin.ini file
The build-up of this section is identical to that of a [Cmps] section in the Plugin.ini, except:


[pnlProperties] section:

This section contains the skin components for the "Properties" panel. This section will be overridden, if re-defined in the plugin.ini file
The build-up of this section is identical to that of a [Cmps] section in the Plugin.ini, except:


[pnlOptions] section:

This section contains the skin components for the "Options" panel. This section will be overridden, if re-defined in the plugin.ini file
The build-up of this section is identical to that of a [Cmps] section in the Plugin.ini, except:


[pnlEntry] section:

This section contains the skin components for the "Entry" panel. This section will be overridden, if re-defined in the plugin.ini file
The build-up of this section is identical to that of a [Cmps] section in the Plugin.ini, except:


[curHost] section:

This section shows last used VST Host Name and KB_MW value.
The last asseca-plugin used will rewrite this section.



[hostname x] section:

There should be a VST-host section for each VST host needed.
KB_MW=$11 defines how VST-plugin will use KeyBoard and MouseWheel
AudioIn=1 optional, number of Audio Input channels, needed by some VST-hosts to recognize a MIDI plugin
AudioOut=1 optional, number of Audio Output channels, needed by some VST-hosts to recognize a MIDI plugin
If both AudioIn=0 and AudioOut=0 in Plugin.ini, but a specific VST-host, according to Global.ini requires an Audio in/out, only then will the Global.ini AudioIn=n and AudioOut=n be used.
If the VST-host is not found, then defaultKB_MW=$nn of the section [curHost] will be used, if no defaultKB_MW=$nn is defined, then defaultKB_MW=$44 will be used.
The VST-plugin contains 3 methods to access the PC-keyboard and 3 methods to access the mousewheel.

Trick to create a new [hostname x] section:
-Open the VST-plugin in any host then close the VST-plugin. (then VST-plugin then writes the HostName in [curHost])
  [curHost]
  defaultKB_MW=$22
  Name=myHost
  KB_MW=$11

can be now copied to:
  [myHost]
  KB_MW=$44


KB_MW values: (KB=keyboard, MW=mousewheel)
KB_MW=$00 KB: off MW: off
KB_MW=$10 KB: VstHost MW: off
KB_MW=$01 KB: off MW: VstHost
KB_MW=$11 KB: VstHost MW: VstHost
KB_MW=$20 KB: WindowsMsg & SetFocus MW: off
KB_MW=$02 KB: off MW: WindowsMsg & SetFocus
KB_MW=$22 KB: WindowsMsg & SetFocus MW: WindowsMsg & SetFocus
KB_MW=$40 KB: KeyboardHook MW: off
KB_MW=$04 KB: off MW: MouseHook
KB_MW=$0C KB: off MW: MouseHook without window-focus
KB_MW=$44 KB: KeyboardHook MW: MouseHook
KB_MW=$4C KB: KeyboardHook MW: MouseHook without window-focus
NOTE: combinations like KB_MW=$1C (KB:VstHost & MW:MouseHook without window-focus) is possible:

FIRST   -   PREV   -   TOP   -   NEXT