Home > CBM > BASIC > Keywords > Rgr
180 Subpages: (divide), (equal), (less), (minus), (more), (multiply), (plus), (power), Abs, And, Append, Asc, Atn, Auto, Backup, Bank, Begin, Bend, Bload, Boot, Box, Bsave, Bump, Catalog, Char, Chr, Circle, Close, Clr, Cmd, Collect, Collision, Color, Concat, Cont, Copy, Cos, Data, Dclear, Dclose, Dec, Def, Delete, Dim, Directory, Dispose, Dload, Do, Dopen, Draw, Ds, Ds string, Dsave, Dverify, El, Else, End, Envelope, Er, Err, Exit, Exp, Fast, Fetch, Filter, Fn, For, Fre, Get, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Left, Len, Let, List, Load, Locate, Log, Loop, Mid, Monitor, Movspr, New, Next, Not, Off, On, Open, Or, Paint, Peek, Pen, Pi, Play, Pointer, Poke, Pos, Pot, Print, Print num, Pudef, Quit, Rclr, Rdot, Read, Record, Rem, Rename, Renumber, Restore, Resume, Return, Right, Rlum, Rnd, Rreg, Rspcolor, Rsppos, Rsprite, Run, Rwindow, Save, Scale, Scnclr, Scratch, Sgn, Sin, Sleep, Slow, Sound, Spc, Sprcolor, Sprdef, Sprite, Sprsav, Sqr, Sshape, St, Stash, Step, Stop, Str, Swap, Sys, Tab, Tan, Tempo, Then, Ti, Ti string, To, Trap, Troff, Tron, Until, Using, Usr, Val, Verify, Vol, Wait, While, Width, Window, Xor |
| 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 |
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. |
Return a value indicating the current graphic mode(s) of the video chip(s).
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.
|
© H2Obsession, 2014 |