User Tools

Site Tools


ugbasic:user:kw:color
Translations of this page:


ugBASIC User Manual

COLOR

SYNTAX

   COLOR index, shade
   COLOR border, background, foreground
   COLOR [border,][background] (if TSB is enabled)
   COLOR border
   COLOR ,foreground

PURPOSE

The COLOR command allows you to redefine the colors used by the graphics chipset, where this is possible. “Redefinition” means assigning one of the possible colors to specific registers called “palette registers”.

On some systems this is not possible at all, due to limitations of the chipset or the absence of registers: for this reason, in such cases the command is ignored. On other systems this corresponds to the modification of specific registers, to which one of the available colors is assigned. On others it is possible to assign certain shades, which therefore go beyond the number of available colors.

Where it is possible to assign a shade, the value can range from 0 to the constant SHADES. However, it may be more practical to use the RGB function, which allows you to calculate the shade starting from the color components (red, green and blue).

If compatibility with Tuned Simons' BASIC is active, the semantics of the command changes, to directly indicate some specific components through a series of syntax variants. With the three-parameter variant, you can directly set the colors of the border, background and text. With the two-parameter variant, it will be possible to indicate the border and the background. With a single parameter, it will be possible to indicate the color of the border only. There is also the format where the first parameter is omitted, in which case the second indicates the color of the text.

Note that the syntax with one or three parameters is automatically considered as pertaining to TSB.

EXAMPLE

  COLOR 0, $fff

ABBREVIATION

 Cr

AVAILABLE ON

  • Dragon 32
  • Commodore 128 (Zilog Z80)
  • Commodore 128 (MOS 8502)
  • Commodore 64
  • Commodore VIC-20
  • Atari (400/800)
  • Atari XL/XE
  • Commodore 64+REU
  • Commodore PLUS/4
  • Olivetti Prodest PC128
  • Dragon 64
  • Thomson MO5
  • Amstrad CPC 664
  • TRS-80 Color Computer 3
  • TRS-80 Color Computer

SEE ALSO

ALIAS FOR

ANY PROBLEM?

If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please open an issue for this keyword on GitHub. Thank you!

POWERED BY