Home > CBM > BASIC > Keywords > Vol
180 Subpages: (divide), (equal), (less), (minus), (more), (multiply), (plus), (power), Abs, And, Append, Asc, Atn, Auto, Backup, Bank, Begin, Bend, Bload, Boot, Box, Bsave, Bump, Catalog, Char, Chr, Circle, Close, Clr, Cmd, Collect, Collision, Color, Concat, Cont, Copy, Cos, Data, Dclear, Dclose, Dec, Def, Delete, Dim, Directory, Dispose, Dload, Do, Dopen, Draw, Ds, Ds string, Dsave, Dverify, El, Else, End, Envelope, Er, Err, Exit, Exp, Fast, Fetch, Filter, Fn, For, Fre, Get, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Left, Len, Let, List, Load, Locate, Log, Loop, Mid, Monitor, Movspr, New, Next, Not, Off, On, Open, Or, Paint, Peek, Pen, Pi, Play, Pointer, Poke, Pos, Pot, Print, Print num, Pudef, Quit, Rclr, Rdot, Read, Record, Rem, Rename, Renumber, Restore, Resume, Return, Rgr, Right, Rlum, Rnd, Rreg, Rspcolor, Rsppos, Rsprite, Run, Rwindow, Save, Scale, Scnclr, Scratch, Sgn, Sin, Sleep, Slow, Sound, Spc, Sprcolor, Sprdef, Sprite, Sprsav, Sqr, Sshape, St, Stash, Step, Stop, Str, Swap, Sys, Tab, Tan, Tempo, Then, Ti, Ti string, To, Trap, Troff, Tron, Until, Using, Usr, Val, Verify, Wait, While, Width, Window, Xor

KeywordAbbreviationToken (hex)Version(s)Classification
VOLV{Shift+O}DB3.5, 7.0Command and Statement
DCLEARDC{Shift+L}DB4.7Command and Statement

  Syntax  
VOL amplitude

ParametersTypeLegal Value(s)Default ValueNote(s)
amplitudeUnsigned Byte0 ~ max0 (v3.5)
15 (v7.0)
max is 8 in v3.5
max is 15 in v7.0

  Purpose  
Audio management.  Set the audio chip's master volume level.

  Remarks  
VOL sets the master volume for the audio generated by the computer.  An amplitude greater than zero must be used in order to hear anything from the ASCII Bell, CHR$(7) [a.k.a., Control-G ], or the PLAY and SOUND statements.

If the amplitude is omitted or is an invalid expression, SYNTAX ERROR occurs.  If amplitude is not numeric, TYPE MISMATCH ERROR occurs; VAL may be used to convert a string value.  A floating-point amplitude will be converted with INT.  If the result is not a Legal Value (see table above), ILLEGAL QUANTITY ERROR occurs.

BASIC provides no function to read the current amplitude.  If you need to determine the value, you will have to PEEK a secret variable.


Example:
VOL "8"

?TYPE MISMATCH ERROR
READY.
VOL 8

READY.

  Compare With  
COLOR, ENVELOPE, TEMPO

  Contrast With  
POT, RCLR, RLUM

  See Also  
CHR$, PLAY, SOUND


© H2Obsession, 2014