Lingo Dictionary > S > soundLevel |  |

soundLevel

Syntax

    the soundLevel

Description

System property; sets the volume level of the sound played through the computer's speaker. Possible values range from 0 (no sound) to 7 (the maximum, default).

In Windows, the system sound setting combines with the volume control of the external speakers. Thus, the actual volume that results from setting the sound level can vary. Avoid setting the `soundLevel` property unless you are sure that the result is acceptable to the user. It is better to set the individual volumes of the channels and sprites with `volume of sound, volume of member,` and `volume of sprite`.

These values correspond to the settings in the Macintosh Sound control panel. Using this property, Lingo can change the sound volume directly or perform some other action when the sound is at a specified level.

This property can be tested and set.

To see an example of `soundLevel` used in a completed movie, see the Sound Control movie in the Learning\Lingo Examples folder inside the Director application folder.

Example

This statement sets the variable `oldSound` equal to the current sound level:

    oldSound = the soundLevel

Example

This statement sets the sound level to 5:

    the soundLevel = 5

See also

`soundEnabled`, `volume (sound channel)`