How to set-up the VST wrapper
(using the built-in skin-builder):
(naming convention: the plugin
to be wrapped if called myvst.dll)
- if myvst.dll contains an internal preset/bank, then save this to .FXP/.FXB
- copy myvst.dll to asData\plugins
- add then line copy mGUI.dll myvst_GUI.dll to copy-dlls.bat and run copy-dlls.bat, (you
might need to download "mgui-update.zip")
- now, load myvst_GUI.dll and
- load the corresponding child plugin
- load a template .SKN skin, e.g. Template-asGrey.skn, these are specially prepared .SKN files
- now, unload and then reload the plugin and test if all paramaters and controls
correspond with the original Child-plugin
- (optional) click on the little LED above the "Design"-button, this LED will now light up, when
unloading the plugin, the parameter-numbers in the .SKN file will now be replaced with the parameter-names,
this is only needed once after using the skin-builder
- DONE, now you can modify the skin to your own taste ... (see the advanced section)
NOTE: the skin-builder can only place the first 180 parameters on the skin ...
BTW, it is possible to build/rebuild just the skin by loading e.g. Template-asCream.skn from the "Options
Panel" ...
How to set-up the VST wrapper
(advanced):
(naming convention: the plugin to be wrapped if
called myvst.dll)
- if myvst.dll contains an internal preset/bank, then save this to .FXP/.FXB
- copy myvst.dll to asData\plugins
- add copy mGUI.dll myvst_GUI.dll to copy-dlls.bat and run copy-dlls.bat, (you
might need to download "mgui-update.zip")
- copy a .INI-file that closely matches myvst.dll, and rename to e.g. myvst_GUI.ini
- in e.g. myvst_GUI.ini setup the following:
- in the [GUI]-section, set to e.g. Skin=skins\myvst_asGrey.skn
- using VB-Audio's VST-Scanner > "Test Plugin", set the following in the [Vst]-section:
- copy the "Product Name" value to "ProdName=", don't include the version info here
- copy the "Plug-in Name" value to "Name="
- copy the "VST Uniq ID" value to "ID=", you may enter either a hex value e.g. "ID=$54537353" or
a 4 character string e.g. "TSsS"
- copy the "Product Name"-version value to "Version=", (this is optional for 100%
compatibility)
- copy the "Vendor Name" value to "Vendor="
- copy the "PRG" value to "NumPrograms=", (this is only needed for 100% compatibility)
- set IsSynth=1 for an instrument VSTi, and IsSynth=0 for a effects VST
- copy the "I/O"-input value to "AudioIn=", if myvst.dll only contains 1 input,
you may enter 2 inputs here, mGUI then sums the stereo input to a mono input for myvst.dll
- copy the "I/O"-output value to "AudioOut=", if myvst.dll only contains 1
output, you may enter 2 outputs here, mGUI then sends the mono output of myvst.dll as
a stereo output to the VST-host
- set VST-1=plugins\myvst.dll
- set useChunks=0 if myvst.dll does not handle preset/bank chunk format and you
need 100% FXP/FXB compatibility, otherwise set to useChunks=1 if you want to save e.g.
MIDI-CC settings per preset ... You may need to use Seib's VstHost to find out the original "Program
Data" chunks-handling
- in the [Prms]-section, setup the needed parameters, Seib's VstHost lets you find
the exact min/max range of each parameter
try to use the exact parameter and units name for the "caption" and "units" entries
each line should end with something like this: R50808000FF0080 or this: R50808000FF09,
this can be fine-tuned later on using mGUI's Properties panel in Global-mode
- copy a corresponging .SKN-file, and rename to e.g. myvst_asGrey.skn
- set the following in e.g. skin\myvst_asGrey.skn:
- in then [Vst]-section, set DLLname=myvst_GUI.dll
- in the [GUI]-section, set Skin= to the correct folder containing the bitmap
images
- in the [Cmps]-section, edit/add lines so that the "Prm" entries corresponds to the parameters
in the myvst_GUI.ini [Prms]-section. e.g. 'FB matrix' should be p-FB
matrix