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

RSPPOS

Keyword Abbreviation Token (hex) Version(s) Classification
RSPPOS R{Shift+S} CE 05 7.0 Function

  Syntax  
RSPPOS ( sprite , info )
 
Parameters Type Legal Value(s) Note(s)
sprite Unsigned Byte 1 ~ 8   
info Unsigned Byte
  1. get X ordinate
  2. get Y ordinate
  3. get speed
 
Returns Type Value(s) Note(s)
value Integer
0 to 511
 
  Purpose  
Return information about the position/movement of a sprite.
 
  Remarks  
The RSPPOS function (mostly) complements the MOVSPR command/statment.  RSPPOS can return a SPRITE's current X ordinate, Y ordinate, or speed.  Unfortunately, RSPPOS will not tell you a SPRITE's direction.  If you need the direction, then you will need to take a PEEK at some secret variables and perform a rectangular to polar conversion.
 
Programming note: if a sprite has been set in motion with a MOVSPR #speed statement, then by the time BASIC processes an X or Y ordinate, the sprite may have moved several pixels.
 
If sprite or info is omitted, either is an invalid expression, or extra parameters are given, then SYNTAX ERROR occurs.  If either parameter is not numeric, TYPE MISMATCH ERROR occurs; you may manually convert strings with VAL.  Any floating-point parameter is automatically converted with INT.  If the result is not a Legal Value (see table above), then ILLEGAL QUANTITY ERROR occurs.
 
Examples (after using SPRDEF):
PRINT RSPPOS("1",0)

?TYPE MISMATCH ERROR 
READY.
PRINT RSPPOS(1,0) :REM sprit 1 X ordinate
 264
 
READY.
PRINT RSPPOS(1,1) :REM sprite 1 Y ordinate
 74

READY.
PRINT RSPPOS(1,2) :REM sprite 1 speed
 0

READY.
 
  Compare With  
 
  Contrast With  
 
  See Also  

© H2Obsession, 2014
Comments