TYPE: plusBASIC v0.15 graphics statement

FORMAT: DEF RGBLIST var$ = rgb_list

Action: Creates an RGB color list.

• var$ is a simple string variable.
• rgb_list is a series of semi-colon separated rgb_specs

DEF RGBLIST R$ = 0,0,0;15,0,0;0,15,0;15,15,0;0,0,15;15,0,15;0,15,15;15,15,15

DEF RGBLIST G$="000";"111";"222";"333";"444";"555";"666";"777";"888";"999";"AAA";"BBB";"CCC";"DDD";"EEE";"FFF"

DEF RGBLIST C$ = "000000";"0000AA";"00AA00";"00AAAA";"AA0000";"AA00AA";"AA5500";"AAAAAA";"555555";"5555FF";"55FF55";"55FFFF";"FF5555";"FF55FF";"FFFFFF";"FFFF55"

An rgb_spec is used to specify an RGB value. It may take on of the following forms:

• An rgb triplet consisting of decimal red, green, and blue value separated with commas.
  • Illegal quantity error results if any of the values are not in the range
• A string containing red, green, and blue values in one of the following formats:
  • A two byte string containing a single RGB value as returned by the GETPALETTE function
  • Three hexadecimal digits, representing the red, green, and blue values, respectively.
  • Six decimal digits consisting of three two digit values for red, green, and blue.
    • Only the first digit of each two digit value is significant; the second is ignored.
  • Empty string error results if the string has a length of 0
  • Illegal quantity error results if the string contains characters that are not hexadecimal digits or its length is not 3 or 6/

TYPE: plusBASIC v0.27i graphics statement

FORMAT: Append RGBLIST var$ = rgb_list

Action: As DEF RGBLIAT but appends to the RGB color list.

TYPE: plusBASIC v0.19n disk statement

FORMAT: LOAD PALETTE palette , filespec

Action: Loads palette definition from a file and writes it to the specified palette.

• palette is the palette number to be loaded (see SET PALETTE).
• filespec is a string expression containing an optional path and the full file name.
• If the file is 32 bytes long, it is assumed to be a binary palette definition as returned by GET_PALLETE$().
• If the file is 64 bytes long. it is assumed to be hexadecimal representation of a binary palette definition.
• File not found error results if the specified file does not exist.
• Overflow error results if the file length is not exactly 32 or 64 bytes.

LOAD PALETTE 0,"grayscale.pal" 

TYPE: plusBASIC v0.19n disk statement

FORMAT: SAVE PALETTE palette , filespec

Action: Saves specified palette definition to a file.

• palette is the palette number to be saved (see SET PALETTE).
• filespec is a string expression containing an optional path and the full file name.
• The resulting file is 32 bytes long and contain the binary palette definition as returned by GET_PALLETE$().

SAVE PALETTE 2,"rgb.pal" 

TYPE: plusBASIC graphics statement

FORMAT: SET PALETTE palette TO rgb_list

Action: Sets one or more palette entries to the specified colors.

• palette is the palette to modify (0 through 3).
  • Screen 0 (text) always uses palette 0.
  • Screen 1 (bitmap) always uses palette 1.
  • Illegal quantity results if palette is not between 0 and 3.
• rgb_list is a string of RGB values created with the DEF RGBLIST statement.

DEF RGBLIST W$ = 15,15,15
SET PALETTE 0 TO W$ 

DEF RGBLIST B$ = 0,0,0
SET PALETTE 0 TO B$ 

DEF RGBLIST P$ = 0,0,0; 0,0,$F; 0,$F,0; 0,$F,$F; $F,0,0; $F,0,$F; $F,$F,0; $F,$F,$F
SET PALETTE 1 TO P$ 

DEF RGBLIST G$ = 0,0,0; 1,1,1; 2,2,2; 3,3,3; 4,4,4; 5,5,5; 6,6,6; 7,7,7; 8,8,8; 9,9,9; 10,10,10; 11,11,11; 12,12,12; 13,13,13; 14,14,14; 15,15,15
SET PALETTE 0 TO G$ 

FORMAT: SET PALETTE palette INDEX index TO rgb_values

Action: As above, but entries are set starting at the specified index.

SET PALETTE 0 INDEX 6 TO RGB$(15,15,15)

DEF RGBLIST P$ = 0,0,0; 0,0,$F; 0,$F,0; 0,$F,$F; $F,0,0; $F,0,$F; $F,$F,0; $F,$F,$F
SET PALETTE 1 INDEX 8 TO P$ 

TYPE: plusBASIC v0.19n graphics statement

FORMAT: RESET PALETTE palette

Action: Sets the specified palette to the default palette

• palette is the palette to modify (0 through 3).
  • Illegal quantity results if palette is not between 0 and 3.

plusBASIC v0.71i enhancement

FORMAT: RESET PALETTE *

Action: Sets all 4 palettes to the default palette

TYPE: plusBASIC v0.15n graphics function

FORMAT: GETPALETTE$ ( palette )

Action: Returns the RGB values in the specified palette.

• palette is a palette number in the range 0 through 3.
• Returns a 32 character binary string containing 16 RGB values.

P$ = GETPALETTE$(P)
PRINT HEX$({P$)

SET PALETTE 1 TO GETPALETT$(0)

plusBASIC v0.27i enhancement_

FORMAT: GETPALETTE$ ( palette , index )

Action: Returns the RGB value of the specified palette entry.

• palette is a palette number in the range 0 through 3.
• index is a palette index in the range 0 through 15.
• Returns a 2 character binary string containing the entry's RGB value.

E$=GETPALETTE$(0,1)
PRINT RGBDEC$(E$,' ')

TYPE: plusBASIC v0.22 graphics function

FORMAT: RGB ( rgb_spec )

Action: Returns an integer representing a single RGB value.

• _rgb_spec specifies the red, green, and blue values.

FORMAT: RGB ( rgb_string, delimiter )

Action: Returns an integer representing a single RGB value.

• rgb_string is a string containing decimal red, green, and blue values separated by a delimiter.
• delimiter is a string or byte value that specifies the delimiter character.
  • If the string is more than two characters long, the first character is used.
• The red, green, and blue values are each divided by 16 to create the entry.
• Illegal quantity error results if any value is not in the range 0 through 255, inclusive, rgb_string does not conform to the above format, or delimiter is a number not in the range 0 through 255, inclusive.

RGB("230,230,250",",")

RGB("250 240 230",32)

TYPE: plusBASIC v0.22 graphics function

FORMAT: RGB$ ( rgb_spec )

Action: Returns a two character binary string representing a single RGB value.

• _rgb_spec specifies the red, green, and blue values.

RGB$(7,15,0)

RGB$("FD0")

RGB$("4B0082")

FORMAT: RGB$ ( rgb_string, delimiter )

Action: As RGB ( rgb_string, delimiter ), but returns a two byte binary string.

10 P$=0
20 FOR I=0 TO 15
30 P$=P$+RGB$(A$[I],9)
40 NEXT I

TYPE: plusBASIC v0.71f graphics function

FORMAT: RGBR ( rgb_spec )

Action: Returns an integer representing the red component of an RGB value.

• _rgb_spec specifies the red, green, and blue values.

R$=RGB$(1,2,3)
PRINT GRBR(R$)

TYPE: plusBASIC v0.71f graphics function

FORMAT: RGBG ( rgb_spec )

Action: Returns an integer representing the green component of an RGB value.

• _rgb_spec specifies the red, green, and blue values.

R$=RGB$(1,2,3)
PRINT GRBG(R$)

TYPE: plusBASIC v0.71f graphics function

FORMAT: RGBG ( rgb_spec )

Action: Returns an integer representing the blue component of an RGB value.

• _rgb_spec specifies the red, green, and blue values.

R$=RGB$(1,2,3)
PRINT GRBB(R$)

TYPE: plusBASIC v0.27b graphics function

FORMAT: RGBDEC$ ( rgb_val )

Action: Returns a string of comma-separated decimal numbers representing a single RGB value.

• rgb_val is a two byte binary string containing the RGB value.
• The resulting string contains the red, green, and blue values, respectively.

R$ = RGB$(1,2,3)
PRINT RGBDEC$(R$)

PRINT RGBHEX$($"5604")

FORMAT: RGBDEC$ ( rgb_val , char )

Action: As above, but the specified character is used as the delimiter.

• char can be either
  • A number between 0 and 255
  • A string, the first character of which is used.

RGBDEC$($"8907",9)

PRINT RGBDEC$($"BC0A"," ")

TYPE: plusBASIC v0.27b graphics function

FORMAT: RGBHEX$ ( rgb_val )

Action: Returns a six digit string of hexadecimal numbers representing a single RGB value.

• rgb_val is a two byte binary string containing a single RGB value.
• The resulting string consists of the red, green, and blue values, each repeated twice.

R$ = RGB$(1,2,3)
PRINT RGBHEX$(R$)

PRINT RGBHEX$($"5604")

FORMAT: RGBHEX$ ( rgb_val , char )

Action: As above, but the specified character is prepended to the string.

• char can be either
  • A number between 0 and 255
  • A string, the first character of which is used.

PRINT RGBHEX$($"8907",64)

PRINT RGBHEX$($"BC0A","#")