Open the tutorial.

The patcher C1mPeakLimiting illustrates the use of the omx.peaklim~ object. You can see it in action by applying any signal with varying levels. Most pop music is heavily compressed, and won't do much here. Try raw drum recordings if you have any, or classical music or recordings of spoken word

The meters show the level of the input, the action of the amplifier, and the output level. If you increase the input gain, you will see the level increase to a point, but then the gain slams down so that the output won't be allowed to reach the distortion point. You can then lower the output gain to get the original signal level with the peaks removed, as shown in the figure below.

If you raise the threshold, distortion can occur and will be very audible. If you lower the threshold, the gain indicator will be mostly in the low position, and the overall effect will be a lot quieter. Raising the output gain will restore the original signal level, but you will find quiet spots in the input contain things you didn't notice before. The overall impression of loudness should be much stronger than before. This is heavy limiting.

Figure 2 shows the before and after of heavy limiting on a drum track. You can see how the pop of the drums is stretched into a nearly continuous sound.

The omx.peaklim~ object has two modes that switch response times. Mode 0 is very fast and will suppress the shortest of transients. However, if the limiting is kicking in and out a lot, you will hear the signal get chopped up. Mode 1 is a bit more leisurely. This will allow peaks through in percussion tracks, but will sound nicer with vocal or instrumental material. The change is too subtle to show on the meters, but you should be able to hear it.

Peak limiting is often used as a safety net when recording unpredictable musicians. Many recorders have peak limiting built in. Heavy limiting gives a very full sound, but the increase in between-the-notes grunge makes the mix muddy. Generally, for sweetening sounds you will want to use a compressor that has more finesse.