Difference between revisions of "Physical colour numbers"

From BeebWiki
Jump to: navigation, search
(Rewritten layout.)
m (Tweeked.)
Line 59: Line 59:
 
b4=flash. For visual compatibility, programs could use 0-7 for non-flashing
 
b4=flash. For visual compatibility, programs could use 0-7 for non-flashing
 
colours and 24-31 for flashing colours. On the BBC these will be flashing
 
colours and 24-31 for flashing colours. On the BBC these will be flashing
colours, on other platforms these will be bright flashing colours.
+
colours, on other platforms these will be bright flashing colours where
 +
supported.
  
 
==Implementation details==
 
==Implementation details==
Line 115: Line 116:
 
   39 &27  167 &A7          White, without changing flash/bright
 
   39 &27  167 &A7          White, without changing flash/bright
 
    
 
    
   64 &40                    Bright off      96 &60                   Flash off
+
   64 &40                    Bright off      96 &60           Flash off
   72 &48                    Bright on      112 &70                   Flash on
+
   72 &48                    Bright on      112 &70           Flash on
  
 
===Commodore===
 
===Commodore===
Line 191: Line 192:
 
   64+n  &40+n      Inverse text
 
   64+n  &40+n      Inverse text
  
<!--
+
[[User:Jgharston|Jgharston]] ([[User talk:Jgharston|talk]]) 23:06, 16 June 2016 (UTC)
DOS:
 
COLOUR 0
 
COLOUR 128 
 
Black
 
COLOUR 1
 
COLOUR 129
 
Red
 
COLOUR 2
 
COLOUR 130
 
Green
 
COLOUR 3
 
COLOUR 131
 
Yellow
 
COLOUR 4
 
COLOUR 132
 
Blue
 
COLOUR 5
 
COLOUR 133
 
Magenta
 
COLOUR 6
 
COLOUR 134
 
Cyan
 
COLOUR 7
 
COLOUR 135
 
White
 
COLOUR 8
 
COLOUR 136
 
Intensified Black
 
COLOUR 9
 
COLOUR 137
 
Intensified Red
 
COLOUR 10
 
COLOUR 138
 
Intensified Green
 
COLOUR 11
 
COLOUR 139
 
Intensified Yellow
 
COLOUR 12
 
COLOUR 140
 
Intensified Blue
 
COLOUR 13
 
COLOUR 141
 
Intensified Magenta
 
COLOUR 14
 
COLOUR 142
 
Intensified Cyan
 
COLOUR 15 
 
COLOUR 143
 
Intensified White
 
 
The border is specified by using -1 as the logical colour number.
 
 
The following example sets the border colour to green.
 
 
    VDU 19,-1,2,0,0,0
 
 
 
The alternative mode provides an 'analogue' palette by allowing you to set
 
the Red, Green and Blue intensities to any value between 0 and 63. The
 
format of the VGA 'analogue' colour palette command is shown below.
 
 
    VDU 19,logical,-1,red,green,blue
 
 
 
If bit 7 of the logical colour number is set (values 128 to 143), then the
 
enhanced palette is used and the physical colour is taken to be the IBM
 
colour value.
 
 
For example, the following command will set logical colour 1 to green.
 
 
    VDU 19,129,2,0,0,0
 
 
The text enhanced palette is the same as the graphics enhanced palette.
 
 
6-bit RGB colours
 
In the 6-bit RGB mode you set the physical colour by specifying the values
 
of the individual red, green and blue components as numbers in the range 0
 
(minimum) to 63 (maximum). Hence the value 0,0,0 corresponds to black and
 
the value 63,63,63 corresponds to peak (intensified) white.
 
 
To select a logical colour to one of these physical colours you must use the
 
VDU 19 command:
 
 
    VDU 19,logical,-1,red,green,blue
 
 
This mode is provided for compatibility with BBC BASIC (86).
 
 
8-bit RGB colours
 
In the 8-bit RGB mode you set the physical colour by specifying the values
 
of the individual red, green and blue components as numbers in the range 0
 
(minimum) to 255 (maximum). Hence the value 0,0,0 corresponds to black and
 
the value 255,255,255 corresponds to peak (intensified) white.
 
 
To select a logical colour to one of these physical colours you use either
 
the VDU 19 command or the COLOUR statement:
 
 
    VDU 19,logical,16,Red,Green,Blue
 
    COLOUR logical,Red,Green,Blue
 
 
 
  0 1 x x x b g r -
 
  1 0 x x x b g r - background colour
 
  1 1 x x x b g r - border colour
 
 
 
-->
 
 
 
[[User:Jgharston|Jgharston]] ([[User talk:Jgharston|talk]]) 20:33, 13 June 2016 (UTC)
 

Revision as of 00:06, 17 June 2016

Physical colour numbers are used as the short physical colour in the VDU 19 command, and used in the COLOUR and GCOL commands on platforms without a palette. The colour number is a bitmap of the colour to select. When implementing an operating system interface on other platforms this mapping should be adhered to.

Colour bitmap

   7   6   5   4   3   2   1   0
 +---+---+---+---+---+---+---+---+
 | L | B | E | F | I | B | G | R |
 +---+---+---+---+---+---+---+---+
   |   |   |   |   |   |   |   |
   |   |   |   |   |   |   |   +---Red
   |   |   |   |   |   |   +-------Green
   |   |   |   |   |   +-----------Blue
   |   |   |   |   +---------------Intense
   |   |   |   +-------------------Flash
   |   |   +-----------------------Extension
   |   +---------------------------Border
   +-------------------------------0=Foreground, 1=Background
 
 This gives:
  0 0 e f i b g r - &00+n - foreground colour
  0 1 e f i b g r - &40+n - extension
  1 0 e f i b g r - &80+n - background colour
  1 1 e f i b g r - &C0+n - border colour
 
 The BBC implements:
  l x x x f b g r - colour
          +-------- flash
 
 The ZX Spectrum implements:
  l b e f i b g r - colour
    | | | +-------- bright
    | | +---------- flash
    | +------------ change only flash/bright
    +-------------- border
 
 The Commodore implements:
  l b x f i b g r - colour
    |   | +-------- bright
    |   +---------- flash
    +-------------- border
 
 DOS/Windows implements:
  l x x f i b g r - colour
        | +-------- bright
        +---------- flash
 
 ANSI terminal implements:
  l b e f i b g r - colour
    | | | +-------- bright
    | | +---------- flash
    | +------------ underline
    +-------------- inverse

The BBC uses b3=flash, whereas all platforms other than the BBC uses b4=flash. For visual compatibility, programs could use 0-7 for non-flashing colours and 24-31 for flashing colours. On the BBC these will be flashing colours, on other platforms these will be bright flashing colours where supported.

Implementation details

Electron/BBC/Master/etc

  0+n  &00+n - foreground colour
128+n  &80+n - background colour
 
  Fore    Back                      Fore    Back
 ground  ground   Colour           ground  ground   Colour
  0 &00  128 &80  Black             8 &08  136 &88  Flashing Black
  1 &01  129 &81  Red               9 &09  137 &89  Flashing Red
  2 &02  130 &82  Green            10 &0A  138 &8A  Flashing Green
  3 &03  131 &83  Yellow           11 &0B  139 &8B  Flashing Yellow
  4 &04  132 &84  Blue             12 &0C  140 &8C  Flashing Blue
  5 &05  133 &85  Magenta          13 &0D  141 &8D  Flashing Magenta
  6 &06  134 &86  Cyan             14 &0E  142 &8E  Flashing Cyan
  7 &07  135 &87  White            15 &0F  143 &8F  Flashing White

ZX Spectrum

  0+n  &00+n  %000FIBGR - foreground colour, bright and flash
 32+n  &20+n  %001xxBGR - foreground colour, without changing flash and bright
 64+n  &40+n  %010xIxxx - bright without changing current colour
 96+n  &60+n  %011Fxxxx - flash without changing current colour
128+n  &80+n  %100FIBGR - background colour, bright and flash
160+n  &A0+n  %101xxBGR - background colour, without changing flash and bright
192+n  &C0+n  %11xxxBGR - border colour
 
  Fore    Back                               Fore    Back
 ground  ground   Border   Colour           ground  ground   Colour
  0 &00  128 &80  192 &C0  Black            16 &10  144 &90  Flashing Black
  1 &01  129 &81  193 &C1  Red              17 &11  145 &91  Flashing Red
  2 &02  130 &82  194 &C2  Green            18 &12  146 &92  Flashing Green
  3 &03  131 &83  195 &C3  Yellow           19 &13  147 &93  Flashing Yellow
  4 &04  132 &84  196 &C4  Blue             20 &14  148 &94  Flashing Blue
  5 &05  133 &85  197 &C5  Magenta          21 &15  149 &95  Flashing Magenta
  6 &06  134 &86  198 &C6  Cyan             22 &16  150 &96  Flashing Cyan
  7 &07  135 &87  199 &C7  White            23 &17  151 &97  Flashing White
  8 &08  136 &88           Bright Black     24 &18  152 &98  Flashing Bright Black
  9 &09  137 &89           Bright Red       25 &19  153 &99  Flashing Bright Red
 10 &0A  138 &8A           Bright Green     26 &1A  154 &9A  Flashing Bright Green
 11 &0B  139 &8B           Bright Yellow    27 &1B  155 &9B  Flashing Bright Yellow
 12 &0C  140 &8C           Bright Blue      28 &1C  156 &9C  Flashing Bright Blue
 13 &0D  141 &8D           Bright Magenta   29 &1D  157 &9D  Flashing Bright Magenta
 14 &0E  142 &8E           Bright Cyan      30 &1E  158 &9E  Flashing Bright Cyan
 15 &0F  143 &8F           Bright White     31 &1F  159 &9F  Flashing Bright White
 
 32 &20  160 &A0           Black, without changing flash/bright
 33 &21  161 &A1           Red, without changing flash/bright
 34 &22  162 &A2           Green, without changing flash/bright
 35 &23  163 &A3           Yellow, without changing flash/bright
 36 &24  164 &A4           Blue, without changing flash/bright
 37 &25  165 &A5           Magenta, without changing flash/bright
 38 &26  166 &A6           Cyan, without changing flash/bright
 39 &27  167 &A7           White, without changing flash/bright
 
 64 &40                    Bright off       96 &60           Flash off
 72 &48                    Bright on       112 &70           Flash on

Commodore

  0+n  &00+n - foreground colour
128+n  &80+n - background colour
192+n  &C0+n - border colour
 
  Fore    Back                               Fore    Back
 ground  ground   Border   Colour           ground  ground   Colour
  0 &00  128 &80  192 &C0  Black            16 &10  144 &90  Flashing Black
  1 &01  129 &81  193 &C1  Red              17 &11  145 &91  Flashing Red
  2 &02  130 &82  194 &C2  Green            18 &12  146 &92  Flashing Green
  3 &03  131 &83  195 &C3  Yellow           19 &13  147 &93  Flashing Yellow
  4 &04  132 &84  196 &C4  Blue             20 &14  148 &94  Flashing Blue
  5 &05  133 &85  197 &C5  Magenta          21 &15  149 &95  Flashing Magenta
  6 &06  134 &86  198 &C6  Cyan             22 &16  150 &96  Flashing Cyan
  7 &07  135 &87  199 &C7  White            23 &17  151 &97  Flashing White
  8 &08  136 &88  200 &C8  Orange           24 &18  152 &98  Flashing Orange
  9 &09  137 &89  201 &C9  Bright Red       25 &19  153 &99  Flashing Bright Red
 10 &0A  138 &8A  202 &CA  Bright Green     26 &1A  154 &9A  Flashing Bright Green
 11 &0B  139 &8B  203 &CB  Bright Grey      27 &1B  155 &9B  Flashing Bright Grey
 12 &0C  140 &8C  204 &CC  Bright Blue      28 &1C  156 &9C  Flashing Bright Blue
 13 &0D  141 &8D  205 &CD  Grey             29 &1D  157 &9D  Flashing Grey
 14 &0E  142 &8E  206 &CE  Dark Grey        30 &1E  158 &9E  Flashing Dark Grey
 15 &0F  143 &8F  207 &CF  Brown            31 &1F  159 &9F  Flashing Brown

DOS/Windows

  0+n  &00+n - foreground colour
128+n  &80+n - background colour
 
  Fore    Back                      Fore    Back
 ground  ground   Colour           ground  ground   Colour
  0 &00  128 &80  Black            16 &10  144 &90  Flashing Black
  1 &01  129 &81  Red              17 &11  145 &91  Flashing Red
  2 &02  130 &82  Green            18 &12  146 &92  Flashing Green
  3 &03  131 &83  Yellow           19 &13  147 &93  Flashing Yellow
  4 &04  132 &84  Blue             20 &14  148 &94  Flashing Blue
  5 &05  133 &85  Magenta          21 &15  149 &95  Flashing Magenta
  6 &06  134 &86  Cyan             22 &16  150 &96  Flashing Cyan
  7 &07  135 &87  White            23 &17  151 &97  Flashing White
  8 &08  136 &88  Bright Black     24 &18  152 &98  Flashing Bright Black
  9 &09  137 &89  Bright Red       25 &19  153 &99  Flashing Bright Red
 10 &0A  138 &8A  Bright Green     26 &1A  154 &9A  Flashing Bright Green
 11 &0B  139 &8B  Bright Yellow    27 &1B  155 &9B  Flashing Bright Yellow
 12 &0C  140 &8C  Bright Blue      28 &1C  156 &9C  Flashing Bright Blue
 13 &0D  141 &8D  Bright Magenta   29 &1D  157 &9D  Flashing Bright Magenta
 14 &0E  142 &8E  Bright Cyan      30 &1E  158 &9E  Flashing Bright Cyan
 15 &0F  143 &8F  Bright White     31 &1F  159 &9F  Flashing Bright White

ANSI Terminal

  0+n  &00+n - foreground colour
128+n  &80+n - background colour
 
  Fore    Back                      Fore    Back
 ground  ground   Colour           ground  ground   Colour
  0 &00  128 &80  Black            16 &10  144 &90  Flashing Black
  1 &01  129 &81  Red              17 &11  145 &91  Flashing Red
  2 &02  130 &82  Green            18 &12  146 &92  Flashing Green
  3 &03  131 &83  Yellow           19 &13  147 &93  Flashing Yellow
  4 &04  132 &84  Blue             20 &14  148 &94  Flashing Blue
  5 &05  133 &85  Magenta          21 &15  149 &95  Flashing Magenta
  6 &06  134 &86  Cyan             22 &16  150 &96  Flashing Cyan
  7 &07  135 &87  White            23 &17  151 &97  Flashing White
  8 &08  136 &88  Bright Black     24 &18  152 &98  Flashing Bright Black
  9 &09  137 &89  Bright Red       25 &19  153 &99  Flashing Bright Red
 10 &0A  138 &8A  Bright Green     26 &1A  154 &9A  Flashing Bright Green
 11 &0B  139 &8B  Bright Yellow    27 &1B  155 &9B  Flashing Bright Yellow
 12 &0C  140 &8C  Bright Blue      28 &1C  156 &9C  Flashing Bright Blue
 13 &0D  141 &8D  Bright Magenta   29 &1D  157 &9D  Flashing Bright Magenta
 14 &0E  142 &8E  Bright Cyan      30 &1E  158 &9E  Flashing Bright Cyan
 15 &0F  143 &8F  Bright White     31 &1F  159 &9F  Flashing Bright White
 
 32+n  &20+n      Underlined text
 64+n  &40+n      Inverse text

Jgharston (talk) 23:06, 16 June 2016 (UTC)