Home > CBM > BASIC > Keywords > Rspcolor
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, 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, Vol, Wait, While, Width, Window, Xor

KeywordAbbreviationToken (hex)Version(s)Classification
RSPCOLORRSP{Shift+C}CE 077.0Function

  Syntax  
RSPCOLOR ( mcNumber )

ParametersTypeLegal Value(s)Note(s)
mcNumberUnsigned Byte1. get mcColor1
2. get mcColor2

ReturnsTypeValue(s)Note(s)
chipColorInteger
1 to 16
See SPRCOLOR

  Purpose  
Return one of the chipColors shared by all multi-color sprites.

  Remarks  
The RSPCOLOR function complements the SPRCOLOR command/statment.  RSPCOLOR will return the current value of mcColor1 or mcColor2 (the chipColor used by sprite pixels having values %01 and %11 respectively) when the given mcNumber is 1 or 2, respectively.  Neither is used by high-resolution sprites.  The color value(s) apply to all mult-color sprites; that is, these are shared colors.  Each sprite also has a unique (non-shared) color; see RSPRITE.

If mcNumber is omitted, is an invalid expression, or extra parameters are given, then SYNTAX ERROR occurs.  If mcNumber is not numeric, TYPE MISMATCH ERROR occurs; you may manually convert strings with VAL.  A floating-point mcNumber is automatically converted with INT.  If the result is not a Legal Value (1 or 2), then ILLEGAL QUANTITY ERROR occurs.


Examples:
PRINT RSPCOLOR("1")

?TYPE MISMATCH ERROR 
READY.
PRINT RSPCOLOR(1) :REM get multi-color value 1
 2                 white 

READY.
PRINT RSPCOLOR(2) :REM get multi-color value 2
 3                 red

READY.
PRINT RSPCOLOR(3)

?ILLEGAL QUANTITY ERROR
READY.

  Compare With  
RCLR, RDOT, RLUM,  RSPPOS, RSPRITE

  Contrast With  
COLOR, SPRCOLOR

  See Also  
SPRITE


© H2Obsession, 2014