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

RGR

Keyword Abbreviation Token (hex) Version(s) Classification
RGR R{Shift+G} CC 3.5,7.0 Function
CONCAT CON{Shift+C} CC 4.x Command and Statement

  Syntax  
RGR dummy )
 
Parameters Type Legal Value(s) Note(s)
dummy Numeric
any
 
Returns Type Value(s) Note(s)
modeFlags Integer
0 ~ 4 (TED)
0 ~ 9 (C128)
C128 same as TED, except +5 if 80-column text editor is active.
 
  Purpose  
Return a value indicating the current graphic mode(s) of the video chip(s).
 
  Remarks  
The RGR function is the complement to GRAPHIC.  In principle, it returns the mode set by GRAPHIC.  On the TED series (C16 and Plus/4), the returned modeFlags is exactly the same as the "mode" value used with GRAPHIC.  On the C128, it is almost the same.  A returned modeFlag 0 to 4 represents the VIC-II mode and 5 is added to that value if the 80-column screen is the active text editor (the 80-column screen is always in text mode as far as BASIC knows).
 
modeFlags 40-Column Mode Text Editor
0 Text 40 columns
1 High-Res Bitmap 40 columns
2 High-Res Split-screen 40 columns
3 Multi-Color Bitmap 40 columns
4 Multi-Color Split-screen 40 columns
5 Text 80 columns
6 High-Res Bitmap 80 columns
7 High-Res Split-screen 80 columns
8 Multi-Color Bitmap 80 columns
9 Multi-Color Split-screen 80 columns
 
The TED doesn't have an 80-column video chip, so the returned modeFlag is always 0 to 4.
 
Unfortunately the dummy parameter is ignored.  It would be nice if you could use different values to get extra information, like the row of a split-screen might be useful to know.  On the TED series, the split-screen row is fixed at row 20.  On the C128 it is easy to set with GRAPHIC, but to read the value, you have to PEEK a secret variable "Split Raster" and do some math.
 
If dummy is omitted, or contains an invalid express, SYNTAX ERROR occurs.  If dummy is not numeric, TYPE MISMATCH ERROR occurs.
 
Examples:
PRINT RGR(100)
 0                   5 would also be common on a C128

READY.
PRINT RGR("100")
 
?TYPE MISMATCH ERROR 
READY.
 
  Compare With  
 
  Contrast With  
 
  See Also  

© H2Obsession, 2014
Comments