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 
 
 Contrast With 
 See Also 

© H2Obsession, 2014