## On this page

  

 

 # sound:apply gain to a signal

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Apply gain on each channel of a signal (fields\_container). Note: The gain is applied to every channel of the signal.

## Inputs

InputNameExpected type(s)Description**Pin 0**   
Requiredinput\_signal[`fields_container`](../../core-concepts/dpf-types.md#fields-container), [`field`](../../core-concepts/dpf-types.md#field)The input signal.**Pin 1**   
Requiredgain[`double`](../../core-concepts/dpf-types.md#standard-types)Gain value in decibels (dB) or linear unit. By default, gain is specified in decibels. If gain is given in a linear unit, set is\_gain\_dB to false.**Pin 2**   
Requiredis\_gain\_dB[`bool`](../../core-concepts/dpf-types.md#standard-types)If value is true, the gain is specified in dB. If value is false, the gain is in a linear unit.## Outputs

OutputNameExpected type(s)Description**Pin 0**output\_signal[`fields_container`](../../core-concepts/dpf-types.md#fields-container), [`field`](../../core-concepts/dpf-types.md#field)Signal(s) with the gain applied. The type of the output will be the same as the input on pin 0. For example, a Field as an input will result in a Field for the output.## Configurations

NameExpected type(s)Default valueDescription**mutex**[`bool`](../../core-concepts/dpf-types.md#standard-types)falseIf this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads.## Scripting

**Category**: sound

**Plugin**: sound

**Scripting name**: None

**Full name**: None

**Internal name**: apply\_gain

**License**: avrxp\_snd\_level1

## Changelog

- Version 0.0.0: Initial release.