/ HALion Developer Resource / HALion Macro Page / Templates /

FX Meter


On this page:


Deco/VU

Description

The FX Meter template allows you to display input, output, and reduction meters for effects like Compressor, Expander, Limiter, etc. It also contains text controls for peak values and switches for resetting them. The controls are connected by corresponding UI variables. To ensure the operation of the controls, the preconfigured properties must not be modified. The look and the size of the controls can be modified freely including their ressources. Controls that are not needed for your instrument can be omitted on your macro page. For example, if an effect does not need a reduction meter, you can remove it and save this configuration in another template.

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 > Deco and Meter Page".
  3. Select "FX Meter" 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
FXTypeSpecifies the effect type the controls should connect to. See Effect Types for a list of the supported types.
ScopeDetermines to which effect the controls should connect. For example, @bus:0/@0:Tube Compressor connects the controls to the first effect named Tube Compressor in the first bus.

Effect Types

ModuleFX TypeComment
CompressorCompressor-
ExpanderExpander-
LimterLimiter-
MaximizerOptimiser-
Brickwall LimiterBrickwallLimiter-
Tube CompressorTubeCompressor-
Vintage CompressorVintageCompressor-
GateGateNo reduction meter.
Graph EQGraphicEQ10Only output meter.
Morph FilterMorphFilterOnly output meter.
DJ EQHiFiEqOnly output meter.

❕ The Studio EQ effect requires the specialized template Studio EQ Meter.

Components inside the Template

FX Meter Template

Controls and Subtemplates

ItemDescription
In_Meter_LeftA Meter control connected with the left input channel of the effect. Its Value must be set to @VUInL .
In_Meter_RightA Meter control connected with the right input channel of the effect. Its Value must be set to @VUInR .
Reduction_MeterA Meter control connected with the gain reduction output of the effect. Its Value must be set to @GainReduction .
Out_Meter_LeftA Meter control connected with the left output channel of the effect. Its Value must be set to @VUOutL .
Out_Meter_RightA Meter control connected with the right output channel of the effect. Its Value must be set to @VUOutR .
Peak_InputA Group with two elements:
  • Peak_In_Reset: A switch that resets the peak value of the input meter. Its Value must be set to @ResetInputVU.
  • Peak_In_Text: A text control that displays the peak value of the input meter. Its Value must be set to @VUInMax.
Peak_OutputA Group with two elements:
  • Peak_Out_Reset: A switch that resets the peak value of the output meter. Its Value must be set to @ResetOutputVU.
  • Peak_Out_Text: A text control that displays the peak value of the ouput meter. Its Value must be set to @VUOutMax.
Peak_ReductionA Group with two elements:
  • Peak_Reduction_Reset: A switch that resets the peak value of the reduction meter. Its Value must be set to @ResetReduction.
  • Peak_Reduction_Text: A text control that displays the peak value of the reduction meter. Its Value must be set to @maxgainreduction.
BackAn Image control that provides the background bitmap for the meters.