Sound.setVolume( ) Method

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
Sound.setVolume( ) Method Flash 5

set the volume of sounds controlled by a Sound object
soundObject.setVolume(volume)

Arguments

volume

A number indicating the loudness of the sound controlled by soundObject, where 0 is no volume (mute). The larger volume's absolute value (regardless of whether volume is positive or negative), the louder the sounds controlled by soundObject will be. For example, -50 is the same volume as 50. The default value for volume is 100.

Description

The setVolume( ) method makes the sounds controlled by soundObject louder or softer. To entirely mute a sound, use a volume of 0. To make a sound louder, increase volume's absolute value. Values in the range of 100-200 are generally quite loud, but there is no predefined maximum.

Note that setVolume( ) affects all the sounds controlled by soundObject. If soundObject is a global sound, setVolume( ) affects all the sounds in a movie. If soundObject is tied to a clip or a main timeline, setVolume( ) affects all the sounds in that clip or timeline.

The volume set by setVolume( ) remains in effect until it is overridden by another setVolume( ) call. A setVolume( ) assignment affects all future sounds controlled by soundObject, even if soundObject is deleted.

Example

This first example simply sets the volume of a movie clip named theClip_mc:

var mySound = new Sound(theClip_mc); mySound.setVolume (65);

The following example shows how to make buttons that adjust a movie's volume level:

var globalSound = new Sound(); var maxVolume = 200; var minVolume = 0; var volumeIncrement = 20;     volumeUp_btn.onRelease = function () {   globalSound.setVolume(Math.min(globalSound.getVolume() + volumeIncrement,                                  maxVolume)); }     volumeDown_btn.onRelease = function () {   globalSound.setVolume(Math.max(globalSound.getVolume() - volumeIncrement,                                  minVolume)); }

See Also

Sound.getVolume( ), Sound.stop( ), Sound.stopAllSounds( )



    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net