Commodore‎ > ‎BASIC‎ > ‎Keywords‎ > ‎

RSPCOLOR

Keyword Abbreviation Token (hex) Version(s) Classification
RSPCOLOR RSP{Shift+C} CE 07 7.0 Function

  Syntax  
RSPCOLOR ( mcNumber )
 
Parameters Type Legal Value(s) Note(s)
mcNumber Unsigned Byte
  1. get mcColor1
  2. get mcColor2
 
Returns Type Value(s) Note(s)
chipColor Integer
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  
 
  Contrast With  
 
  See Also  

© H2Obsession, 2014
Comments