Modules

What is a Module?

Modules are the building blocks of Sensory Percussion, so it's important to understand how they work in order to build your own sounds. This section will go over the different parts of a module, but to better understand the overall modular structure of the software, check out the software concepts section.

There are two kinds of modules used to build sounds in Sensory Percussion: Controllers and Generators

Controllers

Controller modules don't produce sound themselves; they just affect the relationship between other modules. There are six kinds of controllers, each of which performs a different action on all of the modules inside of it. Controllers can hold any other kind of module, whether it's a generator or another controller.

Generators

Generators, as you might guess from the name, generate sound. The most commonly found type of generator in our preset kits is the sampler. Unlike controllers, generators can't hold other modules, so they're always at the end of the modular chain.

Below is an example layer from the set Acedia. You can see how the leftmost controller (drum pads controller) contains another controller (note controller), which contains a generator (sampler). Since generators can't hold other modules, this sampler is the end of the chain:

Both controllers and generators can be found in the Build section of the library. You might also notice that this section includes Effects. Effects are not generators because they don't produce sound on their own, but they're also not controllers because they can't hold other modules. They're kindof in their own special category, which allows them to be placed on any module at any point in the chain. For more info on effects, check out the Effects page.

Panels

Modules are made up of panels. These are smaller sections that provide different settings and functionality to each module. There are some panels that are common to all modules, for example the mix, macros, and velocity i/o panels.

You can show or hide various panels by clicking on the panel button on the top-right of the module.

Each panel can also be expanded or collapsed by clicking on the "open/close" arrow button on the bottom-left of the panel.

Mix

This panel allows you to quickly adjust the volume and panning of the entire layer, meaning if you have multiple modules inside of this layer, they will all be affected. Some modules also have their own mix panels, so you can adjust them individually as well.

Macros

The Macros panel lets you add knobs, buttons, or sliders that can be assigned to pretty much any parameter further down the layer. To add a Macro, click the plus button in the Macros panel and feel free to name it.

There are four types of macros you can create: Knobs, Sliders, Toggles, and Triggers. A new Macro defaults to a knob, but you can easily change it by right-clicking the macro and choosing a new type from the macro type menu.

Knob

Knobs are the default Macro type and are used for controlling continuous parameters.

Slider

Sliders can also be used for controlling continuous parameters.

Toggle

Toggle macros are button with two states. You can use them to turn a parameter on/off or to switch between two states. For example, to defined levels of a reverb parameter.

Trigger

The trigger macro is like a button on a game controller. It sends a single trigger message that can be assigned to buttons like "next" on a sequencer or the stop button on a sampler.

Connecting Macros to parameters

There are two ways to connect a Macro:

1. After creating the Macro, you can simply drag and drop it onto the parameter you want to connect it to. If the drag target it a bit far away, you can achieve the same effect by right-clicking the Macro and finding your target under the assign menu.

2. You can connect the Macro from your target. Simply right-click the parameter you want to control and find your Macro under the assign -> macros menu.

Modulators

This is where you can add any combination of six different modulators, or modes of controlling parameters within Sensory Percussion with your playing. The six different kinds of modulators are: Velocity, Timbre, Speed, MIDI Control, Envelope, and LFO. For an explanation of how each of these works, check out the Assignments/Modulators page.

Velocity Input/Output

Here is where you can where you can adjust how the entire layer responds to your playing.

Want everything loud on pretty much every hit? Then drag the middle node up and to the left:

Want this layer to completely ignore all of the quiet hits? Then drag the left-low node up and to the right:

A velocity I/O panel exists on every Module and Controller, so it often would be overkill to use it all the way up here at the layer-level, but sometimes you do want the entire layer to respond in a certain way -- you do you.

Submodules

This is where you will see a list of all of the modules contained inside of the module you have selected. This panel is exclusive to controller modules, since generator modules can't hold other modules.

Effects

The Effects panel works slightly differently from other panels. The FX panel has a dedicated button ()to show/hide it rather than pinning/unpinning. This panel is where you will find all of your effects modules. To add an effect, simply drag an effect from the Effects library on the left and drop it anywhere on the layer, and it will automatically be added to the effects panel of the layer. Effects can be added to generators, controllers, or audio buses. For more information on how effects work, check out the How to Add Effects page.