You are here: Reference for Processing Blocks and Controls > DSP Processing Blocks > Filters > Shelf

Block Reference

Shelf Filter

Functionality

The Shelf block includes one low-shelf and one high-shelf filter. The shelving filters are similar to bass and treble controls found on hi-fi audio gear. Use these filters for boost or cut effects over a broad range of low or high frequencies.

How to Use
Adding the Block to Your System
  1. Click the Processing tab to open the Processing Workspace.
  2. In the palette area, click the DSP tab.
  3. Expand the Filters category of blocks.
  4. Click and drag the Shelf block into your Processing Map.
  5. Wire it into your system in the appropriate location.
  6. (Optional) Customize the names of the block and the input and output node by clicking their current name and then typing the custom name in the text box that appears. Click the X to save the name.
Configuring the Block
  • Open the Shelf block's properties by double-clicking the block or hovering and clicking the properties icon that appears in the upper right of the block's title bar. From here, you can do the following:
    • Select a filter. The Shelf block contains one Low-shelf and one High-shelf filter. To select a filter, you can either click its gain/frequency handle in the graph or select it in the table view (at the bottom of the properties dialog box).
    • After selecting a filter, use the Frequency, Gain, and Bypass controls to configure the frequency response of the filter.
      • You can use the green/brown gain/frequency handles on the graph to control a filter's gain/frequency at any time.
      • You can bypass either filter by selecting its Bypass checkbox. Bypassing a filter effectively turns that filter into a wire.
      • note: A bypassed filter’s magnitude/phase response and gain/frequency handle are hidden in the graph. By default the graph only displays the composite magnitude response (the total result of every filter in the block).

    • To view the individual contribution of a selected filter, check the Individual button in the View box in the upper right corner of the dialog box. You can also display the individual and composite phase response by checking the Phase checkbox.

 

User Interface Elements
Shelf Filter Block

Shelf Filter Block

UI Element Purpose
Input node Connection point for wiring input to the Shelf filter block
Output node Connection point for wiring the Shelf filter output to another block

 

Shelf Filter Block Properties

(Hover over the thumbnail below to view the properties dialog box.)

Shelf Filter Block Properties

 
UI Element Purpose

Response graph

Graphical representation of filters. Shows Magnitude vs. Frequency by default. Use the green/brown handles to adjust a filter's gain and frequency. Use View options to change graph content.
View options Selecting Magnitude (selected by default) displays the filters' Magnitude on the graph. Selecting Phase (deselected by default) displays the filters' phase response on the graph. Selecting Composite (selected by default) displays gain/frequency handles for both filters on the graph. Selecting Individual (deselected by default) displays the individual contribution of the selected filter.
Frequency control Displays the current frequency of the selected filter. Change the frequency by moving the slider or editing the frequency value in the edit box.
Gain control Displays the current gain of the selected filter. Change the gain by moving the slider or editing the gain value in the edit box.
Bypass (above Table View) Selecting this checkbox bypasses the selected filter, which effectively turns the filter into a wire.
Filter Table View Displays the Frequency and Gain for each filter. To select a filter, click its row in the table. You can also bypass a filter by selecting its associated Bypass checkbox.
Bypass All Selecting this checkbox bypasses both filters.