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
RCLR, RLUM, RSPRITE, RSPCOLOR

Contrast With
COLOR, GRAPHIC, SPRITE, SPRCOLOR

See Also
SCNCLR