[mw-devel] [Git][milliways/mw][master] Start a document describing the new colour mechanism

[Alice Mitchell]

Alice Mitchell pushed to branch master at milliways / mw


Commits:
4b8d96ef by Alice Mitchell at 2019-03-29T17:15:40Z
Start a document describing the new colour mechanism

- - - - -


1 changed file:

- + colours.rst


Changes:

=====================================
colours.rst
=====================================
@@ -0,0 +1,47 @@
+Milliways Colour reference
+==========================
+
+Description
+===========
+
+This document describes the text colouration options provided by Milliways
+client. The legacy system refers to ANSI-16 colouring, and the updated
+one to ANSI-256 support.
+
+Legacy
+======
+The existing colour scheme only permitted access to the 16 colour ANSI 
+system and is a little awkward to use.
+
+Each colour sequence is preceded by the Escape character, typically
+entered by pressing control-V followed by the ESC key, this is followed
+by two letters, the first setting the foreground colour, the second
+setting the background colour, lowercase letters being the normal brightness
+version, and uppercase being the brightly/intense coloured version.
+
+* -n : Reset / Default Colour
+* kK : Black
+* rR : Red
+* gG : Green
+* bB : Blue
+* cC : Cyan
+* mM : Magenta
+* yY : Yellow
+* wW : white
+
+ANSI 256
+========
+
+For the updated colour scheme sequences are now delimited by the ampersand &
+character and consist of a number of hex digits seperated by colons.
+
+Text modes are a single hex character, colours are pairs of hex characters,
+     the first colour pair being the foreground colour, the optional second
+     setting the background colour.
+
+Examples:  
+* &0& - reset all attributes
+* &36& - set foreground colour to purple
+* &11:E3& - dark blue text on yellow background
+
+For a full colour chart, run ~alice/ansi256.sh



View it on GitLab: https://projects.sucs.org/milliways/mw/commit/4b8d96efe9053f4785789ac73294ee67cb0d37b6

-- 
View it on GitLab: https://projects.sucs.org/milliways/mw/commit/4b8d96efe9053f4785789ac73294ee67cb0d37b6
You're receiving this email because of your account on projects.sucs.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.sucs.org/pipermail/mw-devel/attachments/20190329/3961c622/attachment-0001.html>