/ HALion Developer Resource / HALion Macro Page / Templates /

Preset Browser

On this page:

Path

Description

PresetBrowser Module is a preconfigured template that can be used to manage subpresets, such as the presets of a MIDI script module or an audio effect, for example. The Scope parameter determines for which module or effect the preset management applies. The look of the controls can be adapted freely by changing the components inside the template. The template contains switches for Load, Save, and Delete which open the corresponding dialogs.

The PresetBrowser Module template uses the default file path for loading and saving subpresets. User subpresets will be saved to the Documents folder of your OS in the folder of the module or effect you specify with the Scope parameter. You can see the full file path by opening the Save dialog. If you want to deliver your own subpresets as part of your library, the location of your subpresets inside the VST Sound must match this path, otherwise the preset selector cannot access them.

To explore the functionality and connections:

  1. Load the Init Basic Controls.vstpreset from the Basic Controls library.
  2. Open the Macro Page Designer, go to the GUI Tree and navigate to "Pages > Path & Preset Page".
  3. Select "Subpresets Delay - Module" or "Subpresets FlexPhraser - Module" and click Edit Element Edit Element to examine the template.

Template Properties

PopertyDescription
NameThe name of the element. This name will be displayed in the GUI Tree.
Position/SizePosition X, Position Y, Width, Height: Position and size of the element in pixels. Position X/Y defines the position of the upper left corner.
AttachDefines how an element behaves when its parent element is resized. You can set the following parameters:
  • Left: If the parent element is resized, the element remains attached to left edge, with the specified ratio.
  • Right: If the parent element is resized, the element moves relatively to the right edge, with the specified ratio.
  • Top: If the parent element is resized, the element remains attached to top edge, with the specified ratio.
  • Bottom: If the parent element is resized, the element moves relatively to the bottom edge, with the specified ratio.
  • Left + Right: If the parent element is resized, the element is resized horizontally relatively to the left and right edges, with the specified ratio.
TooltipText that appears as a tooltip when the mouse hovers over the element.
TemplateDetermines the template to be referenced.

Template Parameters

ParametersDescription
ScopeThe Scope parameter determines for which module or effect the preset management applies. For example, by setting Scope to @bus:0/@0:Tube Compressor the preset management applies to the first effect named Tube Compressor in the first bus.

Components inside the Template

PresetBrowser Module Template

Controls and Subtemplates

ItemDescription
PrevA Switch control to load the previous preset. Its Value must be set to @SubPresetPrev.
NextA Switch control to load the next preset. Its Value must be set to @SubPresetPrev.
SelectorA Switch control to open the preset selector. Its Value must be set to @SubPresetSelectPopup.
NameA Text control to display the name of the preset. Its Value must be set to @SubPresetName.
SaveA Switch control to open the save dialog. Its Value must be set to @SubPresetSave.
SelectA Switch control to open the preset selector. Its Value must be set to @SubPresetSelectPopup.
DeleteA Switch control to open the delete dialog. Its Value must be set to @SubPresetDelete.
BackAn Image control that provides the background bitmap for the preset name.