====== Color Codes ======

Beyond Synchronet's own [[Ctrl-A codes]] for colors, there is support in Synchronet for a number of other color/attribute code formats which may be used in messages and text files. Support for these extra color/attribute code formats may be individually enabled or disabled in [[util:SCFG]]->System->Extra Attribute Codes (for display files) [[util:SCFG]]->Message Areas ... Sub-boards->Toggle Options->Extra Attribute Codes (for message text):

  ╔═════════════════════════════════════╗
  ║  Extra Attribute Codes in Messages  ║
  ╠═════════════════════════════════════╣
  ║ │WWIV (Heart) Codes             No  ║
  ║ │PCBoard (@Xxx) Codes           No  ║
  ║ │Wildcat (@xx@) Codes           No  ║
  ║ │Celerity (¦x) Codes            No  ║
  ║ │Renegade (¦xx) Codes           Yes ║
  ╚═════════════════════════════════════╝

====WWIV Format====

Synchronet optionally supports color/attribute codes which are native to //WWIV// BBS software. These codes consist of a Control-C (ASCII 3) character followed by a single decimal digit (0 through 9):

^ Code ^ Color ^
| 0 | Normal |
| 1 | High Intensity Cyan |
| 2 | High Intensity Yellow |
| 3 | Normal Magenta |
| 4 | High Intensity White with Blue Background |
| 5 | Normal Green |
| 6 | High Intensity Blinking Red |
| 7 | High Intensity Blue |
| 8 | Low Intensity Blue |
| 9 | Low Intensity Cyan |


====Celerity Format====

Synchronet optionally supports color/attribute codes which are native to //Celerity// BBS software.
These codes consist of a pipe symbol (''|'') followed by a single alphabetic letter (case sensitive):

^ Code ^ Color (foreground) ^
| k | Normal Black |
| b | Normal Blue |
| g | Normal Green |
| c | Normal Cyan |
| r | Normal Red |
| m | Normal Magenta |
| y | Brown |
| w | Normal White |
| d | High Intensity Black |
| B | High Intensity Blue |
| G | High Intensity Green |
| C | High Intensity Cyan |
| R | High Intensity Red |
| M | High Intensity Magenta |
| Y | Yellow |
| W | High Intensity White |
| S | Swap foreground and background |

Example: "''|b|S|W''" would set the current color to high intensity white on a blue background.

Note: Due to conflicting escape sequences (namely, the pipe character), //Celerity// color/atribute codes are not supported when using RIP terminal mode.


====Renegade/Telegard Format====

Synchronet optionally supports color/attribute codes which are native to //Renegade// BBS software.  These codes consist of a pipe symbol (''|'') followed by a two-digit decimal number (00-31):

^ Code ^ Color ^
| 00 | Normal Black |
| 01 | Normal Blue |
| 02 | Normal Green |
| 03 | Normal Cyan |
| 04 | Normal Red |
| 05 | Normal Magenta |
| 06 | Brown |
| 07 | Normal White |
| 08 | High Intensity Black |
| 09 | High Intensity Blue |
| 10 | High Intensity Green |
| 11 | High Intensity Cyan |
| 12 | High Intensity Red |
| 13 | High Intensity Magenta |
| 14 | Yellow |
| 15 | High Intensity White |
| 16 | Background Black |
| 17 | Background Blue |
| 18 | Background Green |
| 19 | Background Cyan |
| 20 | Background Red |
| 21 | Background Magenta |
| 22 | Background Brown |
| 23 | Background White |
| 24 | High Intensity Black Background (or blinking foreground) |
| 25 | High Intensity Blue Background (or blinking foreground) |
| 26 | High Intensity Green Background (or blinking foreground) |
| 27 | High Intensity Cyan Background (or blinking foreground) |
| 28 | High Intensity Red Background (or blinking foreground) |
| 29 | High Intensity Magenta Background (or blinking foreground) |
| 30 | High Intensity Yellow Background (or blinking foreground) |
| 31 | High Intensity White Background (or blinking foreground) |

Example: "''|15|17''" would set the current color to high intensity white on a blue background.


====PCBoard / Wildcat Format====

Two of the color/attribute code formats which Synchronet optionally supports (//PCBoard// and //Wildcat!//) use similar, yet cryptic, methods of displaying colors.  The //PCBoard// method uses the format "@X<Background><Foreground>", and //Wildcat!// uses the format "@<Background><Foreground>@".  The following is a list of the Background and Foreground choices available:

^ <Background> ^ Color ^ Attribute ^ <Foreground> ^ Color ^ Attribute ^
| 0 | Black | Normal | 0 | Black | Normal |
| 1 | Blue | Normal | 1 | Blue | Normal |
| 2 | Green | Normal | 2 | Green | Normal |
| 3 | Cyan | Normal | 3 | Cyan | Normal |
| 4 | Red | Normal | 4 | Red | Normal |
| 5 | Magenta | Normal | 5 | Magenta | Normal |
| 6 | Brown | Normal | 6 | Brown | Normal |
| 7 | White | Normal | 7 | White | Normal |
| 8 | Black | Blinking Foreground | 8 | Black  | High Intensity | 
| 9 | Blue | Blinking Foreground  | 9 | Blue | High Intensity  |
| A | Green | Blinking Foreground  | A | Green | High Intensity  |
| B | Cyan | Blinking Foreground  | B | Cyan | High Intensity  |
| C | Red | Blinking Foreground  | C | Red | High Intensity  |
| D | Magenta | Blinking Foreground  | D | Magenta | High Intensity  |
| E | Brown | Blinking Foreground  | E | Yellow | High Intensity  |
| F | White | Blinking Foreground  | F | White | High Intensity  |

Example: ''@1F@'' in //Wildcat!// format and ''@X1F'' in //PCBoard// format would set the current color to high intensity white on a blue background.

Additionally, PCBoard supports ''@X00'' to save the current color and ''@XFF'' to restore the previously saved color.

===== Note =====
The "Blinking Foreground" attribute may be displayed as a "High Intensity Background" attribute in some terminals. This terminal mode is sometimes referred to as "ICE color" mode and may be enabled and subsequently disabled in [[http://syncterm.net|SyncTERM]] with specific ANSI terminal escape sequences.

===== See Also =====
  * [[:custom:|Customization]]
  * [[http://synchro.net/docs/customization.html#MessageColorCodes|Old documentation of this feature (stale)]]

{{tag>ansi colors}}
