RSPCOLOR ( mcNumber )

 

 

 

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

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.

 

RCLR, RDOT, RLUM, RSPPOS, RSPRITE

 

COLOR, SPRCOLOR