| Home CBM ASCII-X BASIC Disk Commands Enter RUN mode Program Format Secret Variables Variable Format Expressions Keywords (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 num Pudef Quit Rclr Rdot Read Record Rem Rename Renumber Restore Resume Return Rgr 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 Syntax Tokens C128 D64plus Disk Escape Codes Hardware PCxface PETSCII Pet2asc Futurama IBM PC-AT Contact Games Glossary Hall of fame Hall of shame Miscellaneous Privacy policy Programming Twisty puzzles |
RLUM ( colorSource )
Returns the chipLuminance assigned to a graphic screen element.
The RLUM function is a partial complement to COLOR. It returns the chipLuminance that has been assigned to a colorSource. The other (primary) partial complement to COLOR is RCLR. See COLOR for a list of colors and their assigned luminance values. The text color can be changed by printing special "control codes" with CHR$ (or some reverse-font characters in text strings). However, RLUM does not work with text colors, only bitmap colors and the screen background/border. You have to PEEK a secret variable, "Text Attribute" (?) to get the luminance of the text. In an act of incompatibility, BASIC v7.0 does not support RLUM of v3.5... the token $CE (or 206 decimal) is used as the first byte for new 2-byte extended functions. Any version 3.5 program using RLUM will cause SYNTAX ERROR in v7.0. Although I won't argue with the decision to use $CE for an extension (all tokens except $FE were in use, but $FE is used for extended commands/statements, not functions), it is not necessary to generate SYNTAX ERROR. A code of $CE $28 could have been used in version 7.0 to maintain compatibility... well limited compatibility! The reason they choose to sacrifice RLUM (I'm betting) is because neither video chip in the target machine (C128) has 8 levels of luminance per color. If colorSource is omitted or is not a valid expression, SYNTAX ERROR occurs. If colorSource is a string, TYPE MISMATCH ERROR occurs; you can use VAL to make a string numeric. Otherwise the colorSource is converted with INT. If the result is not a LegalValue (see table above) then ILLEGAL QUANTITY ERROR occurs. Examples (from Plus/4, default values):
© H2Obsession, 2014 |