Home > CBM > BASIC > Keywords > Sprcolor
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, 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

Keyword
AbbreviationToken (hex)Version(s)Classification
SPRCOLORSPR{Shift+C}FE 087.0Command and Statement

Syntax  
SPRCOLOR [ mcColor1 ] [ , mcColor2 ]

ParametersTypeLegal Value(s)Default ValueNote(s)
mcColor1Integer 
1 to 16
old value
Same values as COLOR
mcColor2Integer1 to 16old valueSame values as COLOR

 
Purpose  
Sprite state management; Set the color(s) shared by all multi-color sprites.

 
Remarks  
SPRCOLOR allows you to set either or both of the two colors which are shared by all multi-color sprites.  Neither of these are used by high-resolution sprites.  Each sprite also has a unique (no-shared) color (see SPRITE).

The mcColor1 sets the chipColor (see table below) used by bit-pairs which are set to %01.  BASIC never initializes this value!  On power-up (or when STOP + Restore is pressed), the KERNAL I/O initialize routine will set it to 2 (white).

The mcColor2 sets the chipColor used by bit-pairs which are set to %11.  BASIC never initializes this value!  On power-up (or when STOP + Restore is pressed), the KERNAL I/O initialize routine will set it to 3 (red).

The unique sprite color is used by bit-pairs with a value of %10.  Transparent sprite pixels use bit-pair %00.

chipColorVIC-II
Name
VIC-II
appearance
1black 
2white 
3red 
4cyan 
5purple 
6green 
7blue 
8yellow 
9orange 
10brown 
11light red 
12dark gray 
13medium gray 
14light green 
15light blue 
16light gray 

Although each parameter is optional, by itself, omitting both will cause SYNTAX ERROR.  If any parameter is an invalid expression, or additional parameters are given, SYNTAX ERROR will occur as well.  If either parameter is a string, TYPE MISMATCH ERROR occurs; you may manually convert a string with VAL.  Any floating-point parameter will automatically be converted with INT.  If the result is not a Legal Value (see table above), then ILLEGAL QUANTITY ERROR is generated.


Examples:
SPRCOLOR 1    : REM set %01 bit-pairs to Black
SPRCOLOR ,6   : REM set %11 bit-pairs to Green
SPRCOLOR 11,4 : REM set %01 bit-pairs to Light Red and %11 bit-pairs to Cyan

  Compare With  
COLOR, SPRITE

  Contrast With  
RCLR, RDOT, RLUM,  RSPCOLOR, RSPRITE


© H2Obsession, 2014